@metaobjectsdev/metadata 0.9.0-rc.1 → 0.10.0

package/dist/metamodel-docs/provider-definitions.js

@@ -0,0 +1,48 @@
+// FR-033 S3 — the full set of embedded ProviderDefinitions, in one place.
+//
+// Provenance (which of the concern providers owns/contributes each type/attr)
+// is NOT carried on the composed registry — it is flattened away when providers
+// register. The embedded definition modules ARE the source of that fact: each
+// `ProviderDefinition.provider` says who declared it, its `types[]` say which
+// `type.subType`s it registers (owns), and its `extends[]` say which attrs it
+// contributes to types another provider owns. This module re-exports every
+// embedded definition as one list so the provenance builder can walk them
+// without each consumer re-importing all fifteen.
+import { FIELD_DEFINITION } from "../core/field/field-definition.embedded.js";
+import { OBJECT_DEFINITION } from "../core/object/object-definition.embedded.js";
+import { ATTR_DEFINITION } from "../core/attr/attr-definition.embedded.js";
+import { VALIDATOR_DEFINITION } from "../core/validator/validator-definition.embedded.js";
+import { IDENTITY_DEFINITION } from "../core/identity/identity-definition.embedded.js";
+import { RELATIONSHIP_DEFINITION } from "../core/relationship/relationship-definition.embedded.js";
+import { DOCUMENTATION_DEFINITION } from "../core/documentation/documentation-definition.embedded.js";
+import { ORIGIN_DEFINITION } from "../persistence/origin/origin-definition.embedded.js";
+import { SOURCE_DEFINITION } from "../persistence/source/source-definition.embedded.js";
+import { DB_DEFINITION } from "../persistence/db/db-definition.embedded.js";
+import { VIEW_DEFINITION } from "../presentation/view/view-definition.embedded.js";
+import { LAYOUT_DEFINITION } from "../presentation/layout/layout-definition.embedded.js";
+import { UI_DEFINITION } from "../presentation/ui/ui-definition.embedded.js";
+import { TEMPLATE_DEFINITION } from "../template/template-definition.embedded.js";
+import { PROMPT_DEFINITION } from "../template/prompt-definition.embedded.js";
+/**
+ * Every embedded provider definition the core metamodel composes from. The
+ * order is irrelevant — the provenance builder keys by `(type.subType, attr)`,
+ * and the registry is the authority on what is actually registered.
+ */
+export const ALL_PROVIDER_DEFINITIONS = [
+    FIELD_DEFINITION,
+    OBJECT_DEFINITION,
+    ATTR_DEFINITION,
+    VALIDATOR_DEFINITION,
+    IDENTITY_DEFINITION,
+    RELATIONSHIP_DEFINITION,
+    DOCUMENTATION_DEFINITION,
+    ORIGIN_DEFINITION,
+    SOURCE_DEFINITION,
+    DB_DEFINITION,
+    VIEW_DEFINITION,
+    LAYOUT_DEFINITION,
+    UI_DEFINITION,
+    TEMPLATE_DEFINITION,
+    PROMPT_DEFINITION,
+];
+//# sourceMappingURL=provider-definitions.js.map

package/dist/metamodel-docs/provider-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-definitions.js","sourceRoot":"","sources":["../../src/metamodel-docs/provider-definitions.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,kDAAkD;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0DAA0D,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAkC;IACrE,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,mBAAmB;IACnB,uBAAuB;IACvB,wBAAwB;IACxB,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,iBAAiB;IACjB,aAAa;IACb,mBAAmB;IACnB,iBAAiB;CAClB,CAAC"}

package/dist/metamodel-docs/render.d.ts

@@ -0,0 +1,12 @@
+import type { TypeRegistry } from "../registry.js";
+import type { MetamodelProvenance } from "./provenance.js";
+/**
+ * Render the full metamodel doc tree (pure + deterministic). Returns a
+ * `Map<relativePath, markdown>` keyed by:
+ *   `INDEX.md`, `providers.md`, `types/<family>.md`.
+ *
+ * The registry must already be composed (`composeRegistry(coreProviders)`); the
+ * provenance lens is built once (`buildMetamodelProvenance`) and threaded in.
+ */
+export declare function renderMetamodelDocs(registry: TypeRegistry, provenance: MetamodelProvenance): Map<string, string>;
+//# sourceMappingURL=render.d.ts.map

package/dist/metamodel-docs/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/metamodel-docs/render.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAyC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAgQ3D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,mBAAmB,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBrB"}

package/dist/metamodel-docs/render.js

@@ -0,0 +1,252 @@
+// FR-033 S3 — the metamodel doc renderer (pure, deterministic, byte-stable).
+//
+// Documents the METAMODEL ITSELF — the type/subtype/attr vocabulary of the
+// strict registry — for an LLM (and humans). This is distinct from `meta docs
+// --model`, which documents a USER's entities. The output is a tiered markdown
+// tree:
+//
+//   INDEX.md          every type.subType + one-liner + link  (always-on map)
+//   types/<type>.md   per family: each subtype's full composed attrs (provider-
+//                     tagged) + allowed children + cardinality + parents
+//   providers.md      the 5-concern ownership index (the provider lens)
+//
+// Rendering is plain deterministic TS string-building: the metadata package
+// owns no codegen-ts / Mustache dependency, and the output is small + fully
+// structural, so a self-contained string builder is simpler and keeps the
+// byte-stability contract trivially auditable. Everything is sorted by ASCII
+// codepoint for cross-run / cross-port determinism.
+import { isExcludedTypeSubType } from "../registry-manifest-exclusions.js";
+import { ATTR_SUBTYPE_STRINGARRAY, ATTR_SUBTYPE_STRING } from "../core/attr/attr-constants.js";
+import { CHILD_RULE_WILDCARD } from "../shared/structural.js";
+import { SUBTYPE_BASE } from "../shared/base-types.js";
+/** The regeneration command, named in every file's DO-NOT-EDIT header. */
+const REGEN_COMMAND = "meta docs --metamodel";
+/** ASCII codepoint compare — locale-independent, byte-stable. */
+function compare(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** The DO-NOT-EDIT header prepended to every emitted file. */
+function header(what) {
+    return (`<!-- @generated — DO NOT EDIT.\n` +
+        `     ${what}\n` +
+        `     Regenerate with: ${REGEN_COMMAND} -->\n`);
+}
+/** Escape a markdown table cell: collapse newlines, escape pipes. */
+function cell(s) {
+    return s.replace(/\r?\n/g, " ").replace(/\|/g, "\\|").trim();
+}
+/** The anchor GitHub assigns to a `### field.currency` heading: `fieldcurrency`. */
+function anchor(type, subType) {
+    return `${type}${subType}`.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+/** The scalar value-type + array suffix the docs show for an attr. */
+function attrTypeLabel(attr) {
+    const isLegacyStringArray = attr.valueType === ATTR_SUBTYPE_STRINGARRAY;
+    const isArray = attr.isArray === true || isLegacyStringArray;
+    const scalar = isLegacyStringArray
+        ? ATTR_SUBTYPE_STRING
+        : (attr.valueType ?? "any");
+    return isArray ? `${scalar}[]` : scalar;
+}
+/** Render one attr value (default / an allowed value) as an inline-code token. */
+function valueToken(v) {
+    if (v === null || v === undefined)
+        return "";
+    return `\`${String(v)}\``;
+}
+/** The childSubType cell: a single subtype, a `*`, or a comma-joined list. */
+function childSubTypeLabel(childSubType) {
+    return Array.isArray(childSubType) ? childSubType.join(", ") : childSubType;
+}
+/** A cardinality range `min..max` (`*` for unbounded / undefined upper). */
+function cardinality(rule) {
+    const min = rule.min ?? 0;
+    const max = rule.max === null || rule.max === undefined ? "*" : String(rule.max);
+    return `${min}..${max}`;
+}
+/** Whether a child rule is a STRUCTURAL child (not an attr — attrs live in the table). */
+function isStructuralChild(rule) {
+    return rule.childType !== "attr";
+}
+/**
+ * Render the per-subtype Attributes table. Columns:
+ *   Attribute | Type | Required | Default | Allowed values | Provider | Description
+ * Sorted by attr name; common (universal documentation) attrs are excluded
+ * (mentioned once on the providers page) to keep per-type pages lean.
+ */
+function attrsTable(def, provenance, commonAttrNames) {
+    const rows = def.attributes
+        .filter((a) => !commonAttrNames.has(a.name))
+        .slice()
+        .sort((a, b) => compare(a.name, b.name));
+    if (rows.length === 0)
+        return "_No subtype-specific attributes._\n";
+    const lines = [
+        "| Attribute | Type | Required | Default | Allowed values | Provider | Description |",
+        "| --- | --- | --- | --- | --- | --- | --- |",
+    ];
+    for (const a of rows) {
+        // Resolve the contributing provider. An attr inherited from `<type>.base`
+        // (FR-033 `extendsBase`) is recorded against the BASE in the embedded data,
+        // not the concrete subtype — so fall back to the base owner when the
+        // subtype-specific lookup misses. (`base` itself has no further fallback.)
+        const provider = provenance.ownerOfAttr(def.typeId.type, def.typeId.subType, a.name) ??
+            provenance.ownerOfAttr(def.typeId.type, SUBTYPE_BASE, a.name) ??
+            "—";
+        const allowed = (a.allowedValues ?? []).map(valueToken).join(", ");
+        lines.push(`| \`@${a.name}\` | ${attrTypeLabel(a)} | ${a.required ? "yes" : "no"} | ` +
+            `${valueToken(a.default)} | ${allowed} | ${provider} | ${cell(a.description)} |`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** Render the Allowed children list (structural child rules), sorted. */
+function childrenList(def) {
+    const structural = def.childRules
+        .filter(isStructuralChild)
+        .slice()
+        .sort((a, b) => compare(a.childType, b.childType) ||
+        compare(childSubTypeLabel(a.childSubType), childSubTypeLabel(b.childSubType)) ||
+        compare(a.childName, b.childName));
+    if (structural.length === 0)
+        return "_No structural children._\n";
+    const lines = structural.map((r) => {
+        const nameSuffix = r.childName === CHILD_RULE_WILDCARD ? "" : ` (name \`${r.childName}\`)`;
+        return `- \`${r.childType}.${childSubTypeLabel(r.childSubType)}\`${nameSuffix} — ${cardinality(r)}`;
+    });
+    return `${lines.join("\n")}\n`;
+}
+/** Render one subtype section on a type-family page. */
+function subtypeSection(def, provenance, commonAttrNames) {
+    const { type, subType } = def.typeId;
+    const owner = provenance.ownerOfType(type, subType);
+    const parts = [`### ${type}.${subType}\n`];
+    parts.push(`${def.description}\n`);
+    if (owner !== undefined)
+        parts.push(`**Owning provider:** ${owner}\n`);
+    if (def.rules !== undefined)
+        parts.push(`**Rules:** ${def.rules}\n`);
+    if (def.whenToUse !== undefined)
+        parts.push(`**When to use:** ${def.whenToUse}\n`);
+    if (def.example !== undefined)
+        parts.push(`**Example:**\n\n\`\`\`\n${def.example}\n\`\`\`\n`);
+    parts.push(`**Attributes**\n`);
+    parts.push(attrsTable(def, provenance, commonAttrNames));
+    parts.push(`**Allowed children**\n`);
+    parts.push(childrenList(def));
+    if (def.parents !== undefined && def.parents.length > 0) {
+        const ps = [...def.parents].sort(compare).map((p) => `\`${p}\``).join(", ");
+        parts.push(`**Parents:** ${ps}\n`);
+    }
+    return parts.join("\n");
+}
+/**
+ * The registered (type, subType) definitions the metamodel docs cover — every
+ * registered pair EXCEPT the ones the registry-conformance manifest carves out
+ * (TS-web-presentation `view.*` controls + the `metadata.base` inheritance
+ * anchor) so the docs describe exactly the agreed cross-port vocabulary.
+ */
+function coveredDefs(registry) {
+    return registry
+        .allTypes()
+        .filter((id) => !isExcludedTypeSubType(id.type, id.subType))
+        .map((id) => registry.find(id.type, id.subType))
+        .sort((a, b) => compare(`${a.typeId.type}.${a.typeId.subType}`, `${b.typeId.type}.${b.typeId.subType}`));
+}
+/** Render INDEX.md — the always-on map: every type.subType + one-liner + link. */
+function renderIndex(defs) {
+    const lines = [
+        header("Metamodel vocabulary index — every type.subType, its one-line description, and a link to its type page."),
+        "# MetaObjects Metamodel — Index\n",
+        "This documents the **metamodel itself** — the type / subtype / attribute",
+        "vocabulary the loader accepts — generated from the strict registry. It is",
+        "NOT documentation of a user's entities (that is `meta docs --model`).\n",
+        "Follow a link into `types/<family>.md` for the full attribute table, allowed",
+        "children, and cardinality of a subtype. Universal documentation attributes",
+        "(`@description`/`@title`/…) apply to every node and are listed once in",
+        "[providers.md](providers.md) under `metaobjects-documentation`.\n",
+        "| Type.subType | Description | Page |",
+        "| --- | --- | --- |",
+    ];
+    for (const def of defs) {
+        const { type, subType } = def.typeId;
+        const link = `[types/${type}.md#${anchor(type, subType)}](types/${type}.md#${anchor(type, subType)})`;
+        lines.push(`| \`${type}.${subType}\` | ${cell(def.description)} | ${link} |`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** Render one types/<family>.md page from that family's subtype definitions. */
+function renderTypePage(family, defs, provenance, commonAttrNames) {
+    const parts = [
+        header(`Metamodel reference for the \`${family}\` type family — each subtype's composed attributes, allowed children, and cardinality.`),
+        `# Metamodel — \`${family}\` types\n`,
+        `Each section below is one \`${family}.<subType>\`. The **Attributes** table lists`,
+        `the subtype's own + concern-contributed attributes (provider-tagged); universal`,
+        `documentation attributes are omitted here (see [providers.md](../providers.md)).`,
+        `**Allowed children** lists the structural child rules with their cardinality`,
+        `(\`min..max\`, \`*\` = unbounded).\n`,
+    ];
+    for (const def of defs) {
+        parts.push(subtypeSection(def, provenance, commonAttrNames));
+    }
+    return `${parts.join("\n")}\n`;
+}
+/** Render providers.md — the 5-concern ownership index (the provider lens). */
+function renderProviders(provenance) {
+    const parts = [
+        header("Concern-provider ownership index — which provider owns each type and contributes each attribute."),
+        "# MetaObjects Metamodel — Providers\n",
+        "The metamodel is composed from concern providers. Each **owns** the",
+        "type/subtypes it registers and may **contribute** attributes to types another",
+        "provider owns. This is the ownership lens over the same vocabulary",
+        "[INDEX.md](INDEX.md) lists by type.\n",
+    ];
+    for (const id of provenance.providerIds()) {
+        parts.push(`## ${id}\n`);
+        const desc = provenance.providerDescription(id);
+        if (desc !== undefined)
+            parts.push(`${desc}\n`);
+        const owned = provenance.typesOwnedBy(id);
+        if (owned.length > 0) {
+            parts.push(`**Owns (registers):** ${owned.map((t) => `\`${t}\``).join(", ")}\n`);
+        }
+        const common = provenance.commonAttrsBy(id);
+        if (common.length > 0) {
+            parts.push(`**Universal attributes (every node):** ${common.map((a) => `\`@${a}\``).join(", ")}\n`);
+        }
+        const contributed = provenance.attrsContributedBy(id);
+        if (contributed.length > 0) {
+            parts.push(`**Contributes attributes:**\n`);
+            const lines = contributed.map((c) => `- \`${c.typeSubType}\`: ${c.attrs.map((a) => `\`@${a}\``).join(", ")}`);
+            parts.push(`${lines.join("\n")}\n`);
+        }
+    }
+    return `${parts.join("\n")}\n`;
+}
+/**
+ * Render the full metamodel doc tree (pure + deterministic). Returns a
+ * `Map<relativePath, markdown>` keyed by:
+ *   `INDEX.md`, `providers.md`, `types/<family>.md`.
+ *
+ * The registry must already be composed (`composeRegistry(coreProviders)`); the
+ * provenance lens is built once (`buildMetamodelProvenance`) and threaded in.
+ */
+export function renderMetamodelDocs(registry, provenance) {
+    const defs = coveredDefs(registry);
+    const commonAttrNames = new Set(registry.getCommonAttrs().map((a) => a.name));
+    const out = new Map();
+    out.set("INDEX.md", renderIndex(defs));
+    out.set("providers.md", renderProviders(provenance));
+    // Group by type family, sorted within + across.
+    const byFamily = new Map();
+    for (const def of defs) {
+        const fam = def.typeId.type;
+        if (!byFamily.has(fam))
+            byFamily.set(fam, []);
+        byFamily.get(fam).push(def);
+    }
+    for (const fam of [...byFamily.keys()].sort(compare)) {
+        out.set(`types/${fam}.md`, renderTypePage(fam, byFamily.get(fam), provenance, commonAttrNames));
+    }
+    return out;
+}
+//# sourceMappingURL=render.js.map

package/dist/metamodel-docs/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/metamodel-docs/render.ts"],"names":[],"mappings":"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"}

package/dist/naming-refs.d.ts

@@ -0,0 +1,41 @@
+import type { MetaData } from "./shared/meta-data.js";
+/**
+ * The inline (`@`-prefixed) attribute names whose VALUE is a metadata reference
+ * subject to FR-032 expansion/guarding (ADR-0032 §3). The structural `extends`
+ * key is handled separately (it is not `@`-prefixed). `@objectRef`/`@references`
+ * are pure object refs; `@from`/`@of`/`@via` carry an entity HEAD (possibly with
+ * a dotted relationship/field tail — expandRef preserves the tail);
+ * `@parameterRef`/`@payloadRef`/`@responseRef` reference value-objects. These are
+ * expanded by the YAML desugar and rejected (when still relative) by the
+ * canonical-JSON guard. `@sourceRefField` (a FK FIELD name, not an object ref)
+ * and `@through` are intentionally NOT in this set (out of scope for FR-032 T-slice).
+ */
+export declare const REF_BEARING_ATTR_NAMES: ReadonlySet<string>;
+/**
+ * True when `raw` is a relative reference form (`::Rest` or `..::Rest`) that the
+ * YAML desugar must expand before canonical JSON. Canonical JSON must be FQN; a
+ * relative ref surviving into it is `ERR_RELATIVE_REF_IN_CANONICAL`.
+ */
+export declare function isRelativeRef(raw: string): boolean;
+/**
+ * Expand an authored reference to its fully-qualified canonical form per
+ * ADR-0032 §2.1, preserving any FR-024 dotted child suffix. The package context
+ * `P` is the declaring node's effective package (its own `package` or the
+ * file-default). Throws on parent-relative over-drop — the caller emits an error.
+ */
+export declare function expandRef(raw: string, packageContext: string): string;
+/**
+ * FR-032 — does a root-level object `node` satisfy an (already-expanded)
+ * object reference `ref`? After the YAML desugar + corpus sweep every ref is
+ * fully qualified, so resolution is a pure FQN match. Objects keep a BARE
+ * `fqn()` per the FR5d cross-port contract, so the canonical FQN accessor is
+ * `resolutionKey()` (`<package | fileDefaultPackage>::<name>`) — this mirrors
+ * `super-resolve`'s `findInTree`. The bare `name`/`fqn()` arms cover legacy
+ * same-tree refs and root-level (empty-package) objects.
+ *
+ * This is the single matcher the non-super resolvers (origin `@from`/`@of`/
+ * `@via` heads, template `@payloadRef`/`@responseRef`, source `@parameterRef`)
+ * share, so FQN matching behaves identically everywhere a ref resolves.
+ */
+export declare function refMatchesObject(node: MetaData, ref: string): boolean;
+//# sourceMappingURL=naming-refs.d.ts.map

package/dist/naming-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-refs.d.ts","sourceRoot":"","sources":["../src/naming-refs.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAiBtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAYrD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AA0DD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/naming-refs.js

@@ -0,0 +1,144 @@
+// FR-032 (ADR-0032) — canonical reference expansion.
+//
+// `expandRef(raw, packageContext)` is the SINGLE ref-expansion primitive. It
+// lowers an authored metadata reference to its fully-qualified canonical form
+// per ADR-0032 §2.1 — deterministically, with NO root fallback:
+//
+//   bare `Name` (no `::`, no leading `.`)  → `<P>::Name` (current package only;
+//                                            stays bare when P is empty/root).
+//   qualified `pkg::Name` (contains `::`,  → unchanged (absolute from root).
+//     NOT leading `::`)
+//   `::Rest` (leading `::`)                → strip the leading `::`; the
+//                                            remainder is absolute from root
+//                                            (so `::a::b::C` ≡ `a::b::C`,
+//                                            `::Apple` = root-level Apple).
+//   `..::Rest` (one or more leading `..::`) → drop one package segment from P
+//                                            per `..::`, then resolve Rest
+//                                            (itself bare/qualified) against the
+//                                            reduced package. Over-drop (more
+//                                            `..::` than P has segments) throws.
+//
+// The trailing FR-024 DOTTED CHILD suffix (`.child` / `.child.grandchild`) is
+// PRESERVED verbatim: only the OWNER part (everything before the first `.` in
+// the final `::`-segment) is expanded; the `.child...` tail is reattached.
+//
+// The desugar runs this on every ref-bearing attr so canonical JSON is FQN-only
+// (ADR-0032 §2.2/§2.3); the resolution layer then does pure FQN matching. The
+// `package` attribute is NEVER expanded — it is the node's identity.
+import { PACKAGE_SEPARATOR, PACKAGE_PARENT, CHILD_REF_SEPARATOR } from "./shared/structural.js";
+import { RELATIONSHIP_ATTR_OBJECT_REF } from "./core/relationship/relationship-constants.js";
+import { FIELD_ATTR_OBJECT_REF } from "./core/field/field-constants.js";
+import { IDENTITY_REFERENCE_ATTR_REFERENCES } from "./core/identity/identity-constants.js";
+import { ORIGIN_PASSTHROUGH_ATTR_FROM, ORIGIN_PASSTHROUGH_ATTR_VIA, ORIGIN_AGGREGATE_ATTR_OF, ORIGIN_AGGREGATE_ATTR_VIA, ORIGIN_COLLECTION_ATTR_VIA, } from "./persistence/origin/origin-constants.js";
+import { SOURCE_ATTR_PARAMETER_REF } from "./persistence/source/source-constants.js";
+import { TEMPLATE_ATTR_PAYLOAD_REF, TEMPLATE_ATTR_RESPONSE_REF } from "./template/template-constants.js";
+const PARENT_PREFIX = PACKAGE_PARENT + PACKAGE_SEPARATOR; // "..::"
+/**
+ * The inline (`@`-prefixed) attribute names whose VALUE is a metadata reference
+ * subject to FR-032 expansion/guarding (ADR-0032 §3). The structural `extends`
+ * key is handled separately (it is not `@`-prefixed). `@objectRef`/`@references`
+ * are pure object refs; `@from`/`@of`/`@via` carry an entity HEAD (possibly with
+ * a dotted relationship/field tail — expandRef preserves the tail);
+ * `@parameterRef`/`@payloadRef`/`@responseRef` reference value-objects. These are
+ * expanded by the YAML desugar and rejected (when still relative) by the
+ * canonical-JSON guard. `@sourceRefField` (a FK FIELD name, not an object ref)
+ * and `@through` are intentionally NOT in this set (out of scope for FR-032 T-slice).
+ */
+export const REF_BEARING_ATTR_NAMES = new Set([
+    RELATIONSHIP_ATTR_OBJECT_REF, // = FIELD_ATTR_OBJECT_REF (same spelling "objectRef")
+    FIELD_ATTR_OBJECT_REF,
+    IDENTITY_REFERENCE_ATTR_REFERENCES,
+    ORIGIN_PASSTHROUGH_ATTR_FROM,
+    ORIGIN_PASSTHROUGH_ATTR_VIA, // = ORIGIN_AGGREGATE_ATTR_VIA = ORIGIN_COLLECTION_ATTR_VIA ("via")
+    ORIGIN_AGGREGATE_ATTR_OF,
+    ORIGIN_AGGREGATE_ATTR_VIA,
+    ORIGIN_COLLECTION_ATTR_VIA,
+    SOURCE_ATTR_PARAMETER_REF,
+    TEMPLATE_ATTR_PAYLOAD_REF,
+    TEMPLATE_ATTR_RESPONSE_REF,
+]);
+/**
+ * True when `raw` is a relative reference form (`::Rest` or `..::Rest`) that the
+ * YAML desugar must expand before canonical JSON. Canonical JSON must be FQN; a
+ * relative ref surviving into it is `ERR_RELATIVE_REF_IN_CANONICAL`.
+ */
+export function isRelativeRef(raw) {
+    return raw.startsWith(PACKAGE_SEPARATOR) || raw.startsWith(PARENT_PREFIX);
+}
+/**
+ * Split a ref into its owner part (the object reference) and any FR-024 dotted
+ * child tail. The `.` that marks a child can only appear in the FINAL
+ * `::`-segment (package separators never follow a child dot), so the owner ends
+ * at the first `.` AFTER the last `::`. Returns `{ owner, tail }` where `tail`
+ * includes the leading `.` (or is "" when there is no child suffix).
+ */
+function splitChildTail(raw) {
+    const lastSep = raw.lastIndexOf(PACKAGE_SEPARATOR);
+    const segStart = lastSep === -1 ? 0 : lastSep + PACKAGE_SEPARATOR.length;
+    const dotInSeg = raw.indexOf(CHILD_REF_SEPARATOR, segStart);
+    if (dotInSeg === -1)
+        return { owner: raw, tail: "" };
+    return { owner: raw.slice(0, dotInSeg), tail: raw.slice(dotInSeg) };
+}
+/**
+ * Expand an authored reference's OWNER part (no child tail) to its FQN per
+ * ADR-0032 §2.1. Throws on parent-relative over-drop.
+ */
+function expandOwner(owner, packageContext) {
+    // root-absolute: leading "::" → strip; the remainder is absolute from root.
+    if (owner.startsWith(PACKAGE_SEPARATOR)) {
+        return owner.slice(PACKAGE_SEPARATOR.length);
+    }
+    // parent-relative: one or more leading "..::".
+    if (owner.startsWith(PARENT_PREFIX)) {
+        let rest = owner;
+        let levels = 0;
+        while (rest.startsWith(PARENT_PREFIX)) {
+            levels++;
+            rest = rest.slice(PARENT_PREFIX.length);
+        }
+        const pkgParts = packageContext !== "" ? packageContext.split(PACKAGE_SEPARATOR) : [];
+        if (levels > pkgParts.length) {
+            throw new Error(`Relative reference '${owner}' over-drops: ${levels} parent level(s) ` +
+                `but the package context '${packageContext}' has only ${pkgParts.length} segment(s)`);
+        }
+        const reducedPkg = pkgParts.slice(0, pkgParts.length - levels).join(PACKAGE_SEPARATOR);
+        // `rest` is itself bare/qualified — resolve it against the reduced package.
+        // (A qualified remainder still resolves bare-in-the-reduced-package per the
+        // §2.1 example `..::veg::Carrot` → `acme::veg::Carrot`.)
+        return reducedPkg !== "" ? `${reducedPkg}${PACKAGE_SEPARATOR}${rest}` : rest;
+    }
+    // qualified: contains "::" (not leading) → absolute, unchanged.
+    if (owner.includes(PACKAGE_SEPARATOR)) {
+        return owner;
+    }
+    // bare name → current package (only). Stays bare when context is empty/root.
+    return packageContext !== "" ? `${packageContext}${PACKAGE_SEPARATOR}${owner}` : owner;
+}
+/**
+ * Expand an authored reference to its fully-qualified canonical form per
+ * ADR-0032 §2.1, preserving any FR-024 dotted child suffix. The package context
+ * `P` is the declaring node's effective package (its own `package` or the
+ * file-default). Throws on parent-relative over-drop — the caller emits an error.
+ */
+export function expandRef(raw, packageContext) {
+    const { owner, tail } = splitChildTail(raw);
+    return expandOwner(owner, packageContext) + tail;
+}
+/**
+ * FR-032 — does a root-level object `node` satisfy an (already-expanded)
+ * object reference `ref`? After the YAML desugar + corpus sweep every ref is
+ * fully qualified, so resolution is a pure FQN match. Objects keep a BARE
+ * `fqn()` per the FR5d cross-port contract, so the canonical FQN accessor is
+ * `resolutionKey()` (`<package | fileDefaultPackage>::<name>`) — this mirrors
+ * `super-resolve`'s `findInTree`. The bare `name`/`fqn()` arms cover legacy
+ * same-tree refs and root-level (empty-package) objects.
+ *
+ * This is the single matcher the non-super resolvers (origin `@from`/`@of`/
+ * `@via` heads, template `@payloadRef`/`@responseRef`, source `@parameterRef`)
+ * share, so FQN matching behaves identically everywhere a ref resolves.
+ */
+export function refMatchesObject(node, ref) {
+    return node.resolutionKey() === ref || node.fqn() === ref || node.name === ref;
+}
+//# sourceMappingURL=naming-refs.js.map

package/dist/naming-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-refs.js","sourceRoot":"","sources":["../src/naming-refs.ts"],"names":[],"mappings":"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"}

package/dist/naming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAUtD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3E,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,EAAE,oBAAmC,CAAC;AAEjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAM9F;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAWzD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,oBAAqD,GAC9D,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CASvE;AAED,2GAA2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAChB,QAAQ,GAAE,oBAAqD,GAC9D,aAAa,CAUf"}
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAUtD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3E,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,EAAE,oBAAmC,CAAC;AAEjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAM9F;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAiBzD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,oBAAqD,GAC9D,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CASvE;AAED,2GAA2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAChB,QAAQ,GAAE,oBAAqD,GAC9D,aAAa,CAYf"}

package/dist/naming.js

@@ -47,7 +47,13 @@ export function resolveTableName(entity) {
     // so this helper now just delegates. Writability (table vs view/storedProc/
     // tableFunction) only affects write-routing — for SELECT-side name resolution,
     // a read-only primary source is the right answer.
-    const source = entity.ownChildren().find((c) => c instanceof MetaSource && c.role === SOURCE_ROLE_PRIMARY);
+    //
+    // Effective children (own + inherited via the super chain) so a TPH SUBTYPE
+    // — which declares no source of its own and inherits the discriminator base's
+    // single table (FR-017) — resolves to that base table rather than the
+    // entity-name fallback. For an entity declaring its own source, own shadows
+    // inherited, so the result is unchanged.
+    const source = entity.children().find((c) => c instanceof MetaSource && c.role === SOURCE_ROLE_PRIMARY);
     if (source !== undefined)
         return source.physicalName;
     return pluralize(toSnakeCase(entity.name));
@@ -77,7 +83,9 @@ export function resolveTableSchema(entity) {
 export function buildNameMap(entity, strategy = DEFAULT_COLUMN_NAMING_STRATEGY) {
     const jsToDb = new Map();
     const dbToJs = new Map();
-    for (const child of entity.ownChildren()) {
+    // Effective children so a TPH subtype's name map covers inherited base
+    // fields + its own (FR-017); own shadows inherited on a name conflict.
+    for (const child of entity.children()) {
         if (child.type !== TYPE_FIELD)
             continue;
         const dbCol = resolveColumnName(child, strategy);

package/dist/naming.js.map

@@ -1 +1 @@
-{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"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"}

package/dist/parser-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser-core.d.ts","sourceRoot":"","sources":["../src/parser-core.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAU,YAAY,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,aAAa,EAAoB,MAAM,aAAa,CAAC;AAkCrG,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB;;;;;;OAMG;IACH,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAYD,wBAAgB,SAAS,IAAI,WAAW,CAuBvC;AA6ID;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CA8I1E"}
+{"version":3,"file":"parser-core.d.ts","sourceRoot":"","sources":["../src/parser-core.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAU,YAAY,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,aAAa,EAAoB,MAAM,aAAa,CAAC;AAoCrG,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB;;;;;;OAMG;IACH,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAYD,wBAAgB,SAAS,IAAI,WAAW,CAuBvC;AAmLD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CA8I1E"}