to family

src/database/object.rs

@@ -37,7 +37,7 @@ pub struct SchemaObject {
   #[serde(rename = "additionalProperties")]
   #[serde(skip_serializing_if = "Option::is_none")]
   pub additional_properties: Option<Arc<Schema>>,
-  #[serde(rename = "$family")]
+  #[serde(rename = "family")]
   #[serde(skip_serializing_if = "Option::is_none")]
   pub family: Option<String>,
 
@@ -154,12 +154,15 @@ pub struct SchemaObject {
   #[serde(skip_serializing_if = "Option::is_none")]
   pub extensible: Option<bool>,
 
+  // Contains ALL structural fields perfectly flattened from the ENTIRE Database inheritance tree (e.g. `entity` fields like `id`) as well as local fields hidden inside conditional `cases` blocks.
+  // This JSON exported array gives clients absolute deterministic visibility to O(1) validation and masking bounds without duplicating structural memory.
   #[serde(rename = "compiledPropertyNames")]
   #[serde(skip_deserializing)]
   #[serde(skip_serializing_if = "crate::database::object::is_once_lock_vec_empty")]
   #[serde(serialize_with = "crate::database::object::serialize_once_lock")]
   pub compiled_property_names: OnceLock<Vec<String>>,
 
+  // Internal structural representation caching active AST Node maps. Unlike the Go framework counterpart, the JSPG implementation DOES natively include ALL ancestral inheritance boundary schemas because it compiles locally against the raw database graph.
   #[serde(skip)]
   pub compiled_properties: OnceLock<BTreeMap<String, Arc<Schema>>>,
 
@@ -307,7 +310,7 @@ impl SchemaObject {
       return true;
     }
 
-    // 2. Implicit table-backed rule: Does its $family boundary map directly to the global database catalog?
+    // 2. Implicit table-backed rule: Does its family boundary map directly to the global database catalog?
     if let Some(family) = &self.family {
       let base = family.split('.').next_back().unwrap_or(family);
       if db.types.contains_key(base) {

src/database/schema.rs

@@ -522,7 +522,7 @@ impl Schema {
     }
 
     if let Some(family) = &schema_arc.obj.family {
-      Self::validate_identifier(family, "$family", root_id, &path, errors);
+      Self::validate_identifier(family, "family", root_id, &path, errors);
     }
 
     Self::collect_child_schemas(schema_arc, root_id, path, to_insert, errors);