@metaobjectsdev/metadata 1.0.12 → 1.1.0

package/dist/core/object/object-definition.embedded.js

@@ -72,6 +72,27 @@ export const OBJECT_DEFINITION = {
                     "min": 0,
                     "max": null
                 },
+                {
+                    "type": "dimension",
+                    "subType": "*",
+                    "name": "*",
+                    "min": 0,
+                    "max": null
+                },
+                {
+                    "type": "measure",
+                    "subType": "*",
+                    "name": "*",
+                    "min": 0,
+                    "max": null
+                },
+                {
+                    "type": "segment",
+                    "subType": "*",
+                    "name": "*",
+                    "min": 0,
+                    "max": null
+                },
                 {
                     "type": "attr",
                     "subType": "string",
@@ -124,6 +145,65 @@ export const OBJECT_DEFINITION = {
                     "description": "Optional row-scope predicate (a portable attr.filter object: eq/ne/gt/gte/lt/lte/like/in/isNull with and/or, desugared to { field: { op: value } } at parse time) selecting which rows the view returns — lowered to an outer SQL WHERE. Resolves against the projection's own declared fields; an aggregate-derived field is not addressable (fail-closed)."
                 }
             ]
+        },
+        {
+            "type": "object",
+            "subType": "report",
+            "extendsBase": true,
+            "description": "A declared report (FR-044): a fixed combination of dimensions and measures of ONE entity (@from), compiled to a read-only view. One row per distinct dimension tuple; no dimensions means exactly one row. Fields are DERIVED, not declared: one per dimension (a time dimension's field is <dimension><Grain>, e.g. purchasedAtDay) and one per measure. Every measure must belong to @from (two fact tables are two reports). @filter and @segment scope rows before grouping and combine by AND. Read-only: no writes, no get-by-id.",
+            "whenToUse": "Dashboard totals, per-day series and per-group summaries that would otherwise be hand-written GROUP BY queries.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "from",
+                    "min": 1,
+                    "max": 1,
+                    "description": "The object.entity whose rows the report aggregates."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "dimensions",
+                    "isArray": true,
+                    "min": 0,
+                    "max": 1,
+                    "description": "Dimension names of @from; a time dimension is written 'name:grain'. Absent means one global row."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "measures",
+                    "isArray": true,
+                    "min": 1,
+                    "max": 1,
+                    "description": "Measure names of @from."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "segment",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Optional segment of @from scoping the rows."
+                },
+                {
+                    "type": "attr",
+                    "subType": "filter",
+                    "name": "filter",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Optional row scope over @from's fields; may use relative-date values."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "spine",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Optional to-one path from @from to the entity whose rows supply the report's rows (e.g. 'Purchase.program'), written like a dimension's @via. With it the report has one row per distinct dimension tuple among THAT entity's rows, including the ones no row of @from refers to: a count there is 0 and any other measure is null unless it declares @default. Every listed dimension must be reached through this path. @segment and @filter still scope the rows of @from and never remove a row. A row of @from whose reference is null or matches nothing is in no row of the report."
+                }
+            ]
         }
     ]
 };

package/dist/core/object/object-definition.embedded.js.map

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

package/dist/core/relationship/derive-m2m-fields.d.ts

@@ -20,7 +20,7 @@ export interface M2MFields {
  * @param source  the entity the caller is navigating from. Accepted alongside
  *                `rel.parent` as a name for the relationship's subject, and used
  *                as the declaring entity when `rel` has no entity parent.
- * @param root    the loaded model root (to find the junction entity)
+ * @param root    the loaded model root
  * @throws M2MDerivationError when the junction is missing/malformed or the
  *         self-join is ambiguous.
  */

package/dist/core/relationship/derive-m2m-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derive-m2m-fields.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/derive-m2m-fields.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO/D,6EAA6E;AAC7E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAsCD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,QAAQ,GACb,SAAS,CAkKX"}
+{"version":3,"file":"derive-m2m-fields.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/derive-m2m-fields.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS/D,6EAA6E;AAC7E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,QAAQ,GACb,SAAS,CA8JX"}

package/dist/core/relationship/derive-m2m-fields.js

@@ -39,7 +39,9 @@
 // the subject read as a self-join and refused to derive. Scoped deliberately to
 // this one predicate — every other name comparison in this file is untouched.
 import { stripPackage } from "../../naming.js";
-import { resolveObjectRef } from "../../naming-refs.js";
+import { refTarget } from "../../naming-refs.js";
+import { IDENTITY_REFERENCE_ATTR_REFERENCES } from "../identity/identity-constants.js";
+import { RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_THROUGH } from "./relationship-constants.js";
 import { TYPE_OBJECT } from "../../shared/base-types.js";
 import { PACKAGE_SEPARATOR } from "../../shared/structural.js";
 /** Thrown when a M:N relationship's junction FK fields cannot be derived. */
@@ -54,33 +56,6 @@ export class M2MDerivationError extends Error {
 function refFkField(ref) {
     return ref.fields[0];
 }
-/**
- * The root entity a reference name denotes, or undefined — resolved by the ONE
- * matcher the loader uses (`resolveObjectRef`, ADR-0041/0042): a fully-qualified
- * name binds exactly on its resolution key, a bare name binds in the REFERRER's
- * package.
- *
- * This exists so the SUBJECT comparison below can be made on object IDENTITY.
- * A bare-name compare cannot tell `a::NodeBase` from `b::NodeBase`, which made a
- * genuine cross-package hetero M:N read as a self-join the moment the subject
- * set held two names — and the first-match-wins bare arm this used to carry
- * (Java's deferred #174) bound a bare name to whichever same-short-named entity
- * happened to load first, which is load-ORDER dependence, not a naming rule.
- */
-function findEntity(root, name, referrerPkg) {
-    if (name === undefined || name === "")
-        return undefined;
-    // ADR-0041/0042 through the single resolveObjectRef matcher — an FQN resolves
-    // exactly on its resolution key, a BARE name resolves in the REFERRER's
-    // package. The bare arm used to be `objects().find(o => o.name === bare)`,
-    // which took whichever same-short-named entity loaded first: a bare
-    // `@objectRef: "Tag"` on an abstract base in package `base` bound to
-    // `acme::Tag` merely because the acme source was read first. Callers pass the
-    // referrer that owns the name they are resolving — the DECLARING entity for
-    // the relationship's own @objectRef, the JUNCTION for its references' —
-    // because those are different packages whenever a base is inherited across one.
-    return resolveObjectRef(root, name, referrerPkg).node;
-}
 /**
  * Derive the source/target junction FK fields for a M:N relationship.
  *
@@ -89,7 +64,7 @@ function findEntity(root, name, referrerPkg) {
  * @param source  the entity the caller is navigating from. Accepted alongside
  *                `rel.parent` as a name for the relationship's subject, and used
  *                as the declaring entity when `rel` has no entity parent.
- * @param root    the loaded model root (to find the junction entity)
+ * @param root    the loaded model root
  * @throws M2MDerivationError when the junction is missing/malformed or the
  *         self-join is ambiguous.
  */
@@ -107,9 +82,10 @@ export function deriveM2MFields(rel, source, root) {
     if (throughName === undefined) {
         throw new M2MDerivationError(`relationship "${declaringEntity.name}.${rel.name}" is missing @through (required for M:N derivation)`);
     }
-    // ADR-0041/0042 — resolve @through through the SAME matcher the loader uses
-    // (resolveObjectRef, via validation-passes' _findObject): an FQN resolves
-    // exactly on its resolution key, a bare name resolves package-locally.
+    // ADR-0059 R7 — @through, @objectRef and the junction's @references are read
+    // as bound targets (refTarget), each resolved in the package of the node that
+    // declares it, so an inherited reference keeps the meaning it had where it was
+    // written.
     //
     // This used to be `root.findObject(fqn)` with a fall back to the bare suffix
     // after the last "::". findObject is keyed by BARE name, so the FQN lookup
@@ -120,12 +96,7 @@ export function deriveM2MFields(rel, source, root) {
     // nowhere near the navigating entity. The pairing then failed, so a valid
     // cross-package M:N emitted no traversal route in TS and C# and failed the
     // build in Java, Kotlin and Python.
-    //
-    // Note findEntity() below was ALREADY FQN-exact for the same reason (see its
-    // doc comment). The two halves of one function disagreed about how a
-    // package-qualified name resolves; only the junction half was wrong.
-    const referrerPkg = declaringEntity.package ?? declaringEntity.fileDefaultPackage ?? "";
-    const junction = resolveObjectRef(root, throughName, referrerPkg).node;
+    const junction = refTarget(rel, RELATIONSHIP_ATTR_THROUGH);
     if (junction === undefined) {
         throw new M2MDerivationError(`relationship "${declaringEntity.name}.${rel.name}" @through "${throughName}" does not resolve to an entity`);
     }
@@ -163,14 +134,14 @@ export function deriveM2MFields(rel, source, root) {
     const isSubject = (entity) => entity !== undefined && (entity === declaringEntity || entity === source);
     const isSubjectName = (name) => name !== undefined && subjectNames.includes(stripPackage(name));
     // The junction owns its references' @references names, so those resolve in the
-    // JUNCTION's package; the relationship's own @objectRef resolves in the
-    // DECLARING entity's. Under `extends` across packages these differ, and using
-    // one for both is what bound a bare @objectRef to the wrong same-named entity.
-    const junctionPkg = junction.package ?? junction.fileDefaultPackage ?? "";
-    const refEntity = (r) => findEntity(root, r.targetEntity, junctionPkg);
+    // package of the node that declares them; the relationship's own @objectRef in
+    // the package of the node that declares it. Under `extends` across packages these
+    // differ, and using one for both is what bound a bare @objectRef to the wrong
+    // same-named entity.
+    const refEntity = (r) => refTarget(r, IDENTITY_REFERENCE_ATTR_REFERENCES);
     // Defensive bare fallback when @objectRef does not resolve — loader validation
     // normally guarantees it does. Same carve-out the Java reference makes.
-    const targetEntityNode = findEntity(root, targetName, referrerPkg);
+    const targetEntityNode = refTarget(rel, RELATIONSHIP_ATTR_OBJECT_REF);
     const isSelfJoin = targetEntityNode !== undefined
         ? isSubject(targetEntityNode)
         : isSubjectName(targetName);

package/dist/core/relationship/derive-m2m-fields.js.map

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

package/dist/core/relationship/find-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-reference.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/find-reference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAG1E,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;CACnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,GACZ,eAAe,EAAE,CAUnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,GACZ,eAAe,GAAG,SAAS,CAE7B"}
+{"version":3,"file":"find-reference.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/find-reference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAI1E,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;CACnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,GACZ,eAAe,EAAE,CAWnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,GACZ,eAAe,GAAG,SAAS,CAE7B"}

package/dist/core/relationship/find-reference.js

@@ -5,7 +5,8 @@
 // holds the reference. This is the single source of truth for FK direction
 // across projection codegen, Drizzle schema emit, relations() blocks, and
 // migration schema comparison.
-import { stripPackage } from "../../naming.js";
+import { refTarget } from "../../naming-refs.js";
+import { IDENTITY_REFERENCE_ATTR_REFERENCES } from "../identity/identity-constants.js";
 /**
  * Every identity.reference on `a` or `b` whose @references targets the other
  * side, `a` walked first. Comparison is package-insensitive: `@references` may
@@ -23,7 +24,8 @@ export function findReferencesBetween(a, b) {
     const found = [];
     for (const [holder, other] of [[a, b], [b, a]]) {
         for (const ref of holder.referenceIdentities()) {
-            if (stripPackage(ref.targetEntity) === other.name) {
+            // ADR-0059 R7: compare the bound target, never a short name.
+            if (refTarget(ref, IDENTITY_REFERENCE_ATTR_REFERENCES) === other) {
                 found.push({ holder, other, referenceIdentity: ref });
             }
         }

package/dist/core/relationship/find-reference.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-reference.js","sourceRoot":"","sources":["../../../src/core/relationship/find-reference.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,2EAA2E;AAC3E,0EAA0E;AAC1E,+BAA+B;AAI/B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAW/C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,CAAa,EACb,CAAa;IAEb,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAU,EAAE,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,CAAa,EACb,CAAa;IAEb,OAAO,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"find-reference.js","sourceRoot":"","sources":["../../../src/core/relationship/find-reference.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,2EAA2E;AAC3E,0EAA0E;AAC1E,+BAA+B;AAI/B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAWvF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,CAAa,EACb,CAAa;IAEb,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAU,EAAE,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/C,6DAA6D;YAC7D,IAAI,SAAS,CAAC,GAAG,EAAE,kCAAkC,CAAC,KAAK,KAAK,EAAE,CAAC;gBACjE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,CAAa,EACb,CAAa;IAEb,OAAO,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/core/relationship/resolve-relationship-reference.d.ts

@@ -1,16 +1,17 @@
 import type { MetaObject } from "../object/meta-object.js";
 import type { MetaReferenceIdentity } from "../identity/meta-identity.js";
+import type { MetaData } from "../../shared/meta-data.js";
 /**
  * The set of lowercased names a candidate reference answers to: its own name
  * and its FK field, each with and without one stripped suffix.
  */
 export declare function referencePairingKeys(ref: MetaReferenceIdentity): Set<string>;
 /**
- * Every identity.reference on `holder` whose @references targets `targetEntity`.
- * Package-insensitive on both sides: @references and @objectRef may each be bare
- * or fully qualified.
+ * Every identity.reference on `holder` whose @references targets `targetEntity`: a
+ * reference matches when its @references is bound to that node (ADR-0059 R7: identity,
+ * never a short name). An unresolved target (undefined) matches nothing.
  */
-export declare function referenceCandidatesFor(holder: MetaObject, targetEntity: string): MetaReferenceIdentity[];
+export declare function referenceCandidatesFor(holder: MetaObject, targetEntity: MetaData | undefined): MetaReferenceIdentity[];
 /**
  * Which identity.reference does this `@cardinality: one` relationship navigate
  * through? The ladder, in order:
@@ -23,5 +24,5 @@ export declare function referenceCandidatesFor(holder: MetaObject, targetEntity:
  * Returns undefined for "no candidate" and "cannot choose" alike; callers that
  * need to tell them apart use referenceCandidatesFor().
  */
-export declare function resolveRelationshipReference(holder: MetaObject, relationshipName: string, targetEntity: string, sourceRefField?: string): MetaReferenceIdentity | undefined;
+export declare function resolveRelationshipReference(holder: MetaObject, relationshipName: string, targetEntity: MetaData | undefined, sourceRefField?: string): MetaReferenceIdentity | undefined;
 //# sourceMappingURL=resolve-relationship-reference.d.ts.map

package/dist/core/relationship/resolve-relationship-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-relationship-reference.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/resolve-relationship-reference.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAwB1E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAW5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,GACnB,qBAAqB,EAAE,CAOzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,EAClB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,qBAAqB,GAAG,SAAS,CAYnC"}
+{"version":3,"file":"resolve-relationship-reference.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/resolve-relationship-reference.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAyB1D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAW5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,QAAQ,GAAG,SAAS,GACjC,qBAAqB,EAAE,CAOzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,EAClB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,QAAQ,GAAG,SAAS,EAClC,cAAc,CAAC,EAAE,MAAM,GACtB,qBAAqB,GAAG,SAAS,CAYnC"}

package/dist/core/relationship/resolve-relationship-reference.js

@@ -7,7 +7,8 @@
 // Taking the first match emits a join on the wrong column that typechecks, has
 // correct DDL and passes verify — so the ladder below resolves it explicitly or
 // not at all. ADR-0029 §5: ambiguity is a load error naming the candidates.
-import { stripPackage } from "../../naming.js";
+import { refTarget } from "../../naming-refs.js";
+import { IDENTITY_REFERENCE_ATTR_REFERENCES } from "../identity/identity-constants.js";
 /**
  * Trailing suffixes stripped from a CANDIDATE's name/FK field when building its
  * pairing keys. Ordered — first match wins, so "reference" is tested before
@@ -44,17 +45,18 @@ export function referencePairingKeys(ref) {
     return keys;
 }
 /**
- * Every identity.reference on `holder` whose @references targets `targetEntity`.
- * Package-insensitive on both sides: @references and @objectRef may each be bare
- * or fully qualified.
+ * Every identity.reference on `holder` whose @references targets `targetEntity`: a
+ * reference matches when its @references is bound to that node (ADR-0059 R7: identity,
+ * never a short name). An unresolved target (undefined) matches nothing.
  */
 export function referenceCandidatesFor(holder, targetEntity) {
-    const target = stripPackage(targetEntity);
+    if (targetEntity === undefined)
+        return [];
     // ADR-0039: resolving — referenceIdentities() honors references inherited via extends.
     return holder
         .referenceIdentities()
-        .filter((ref) => stripPackage(ref.targetEntity ?? "") === target)
-        .filter((ref) => refFkField(ref) !== undefined);
+        .filter((ref) => refFkField(ref) !== undefined)
+        .filter((ref) => refTarget(ref, IDENTITY_REFERENCE_ATTR_REFERENCES) === targetEntity);
 }
 /**
  * Which identity.reference does this `@cardinality: one` relationship navigate

package/dist/core/relationship/resolve-relationship-reference.js.map

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

package/dist/core/reporting/meta-dimension.d.ts

@@ -0,0 +1,13 @@
+import { MetaData } from "../../shared/meta-data.js";
+import { type TimeGrain } from "./reporting-constants.js";
+export declare class MetaDimension extends MetaData {
+    /** True for `dimension.time` (grain truncation); false for `dimension.attribute`. */
+    isTime(): boolean;
+    /** Dotted `Entity.field` reference naming the grouped column. */
+    of(): string | undefined;
+    /** Optional dotted to-one relationship path from the owning entity to the `@of` entity. */
+    via(): string | undefined;
+    /** The grains a `dimension.time` supports (empty for `dimension.attribute`). */
+    grains(): TimeGrain[];
+}
+//# sourceMappingURL=meta-dimension.d.ts.map

package/dist/core/reporting/meta-dimension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-dimension.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/meta-dimension.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAML,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAC;AAElC,qBAAa,aAAc,SAAQ,QAAQ;IACzC,qFAAqF;IACrF,MAAM,IAAI,OAAO;IAIjB,iEAAiE;IACjE,EAAE,IAAI,MAAM,GAAG,SAAS;IAKxB,2FAA2F;IAC3F,GAAG,IAAI,MAAM,GAAG,SAAS;IAKzB,gFAAgF;IAChF,MAAM,IAAI,SAAS,EAAE;CAKtB"}

package/dist/core/reporting/meta-dimension.js

@@ -0,0 +1,30 @@
+// MetaDimension — concrete node class for type=dimension nodes (FR-044).
+//
+// Extends MetaData directly. Accessors are RESOLVING (ADR-0039): a dimension
+// declared on an abstract base entity is read through the same accessors as one
+// declared on the concrete entity.
+import { MetaData } from "../../shared/meta-data.js";
+import { DIMENSION_SUBTYPE_TIME, REPORTING_ATTR_GRAINS, REPORTING_ATTR_OF, REPORTING_ATTR_VIA, TIME_GRAINS, } from "./reporting-constants.js";
+export class MetaDimension extends MetaData {
+    /** True for `dimension.time` (grain truncation); false for `dimension.attribute`. */
+    isTime() {
+        return this.subType === DIMENSION_SUBTYPE_TIME;
+    }
+    /** Dotted `Entity.field` reference naming the grouped column. */
+    of() {
+        const v = this.attr(REPORTING_ATTR_OF);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Optional dotted to-one relationship path from the owning entity to the `@of` entity. */
+    via() {
+        const v = this.attr(REPORTING_ATTR_VIA);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** The grains a `dimension.time` supports (empty for `dimension.attribute`). */
+    grains() {
+        const v = this.attr(REPORTING_ATTR_GRAINS);
+        const items = Array.isArray(v) ? v : typeof v === "string" ? [v] : [];
+        return items.filter((g) => TIME_GRAINS.includes(g));
+    }
+}
+//# sourceMappingURL=meta-dimension.js.map

package/dist/core/reporting/meta-dimension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-dimension.js","sourceRoot":"","sources":["../../../src/core/reporting/meta-dimension.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,mCAAmC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GAEZ,MAAM,0BAA0B,CAAC;AAElC,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,qFAAqF;IACrF,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,KAAK,sBAAsB,CAAC;IACjD,CAAC;IAED,iEAAiE;IACjE,EAAE;QACA,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,2FAA2F;IAC3F,GAAG;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,gFAAgF;IAChF,MAAM;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAE,WAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/core/reporting/meta-measure.d.ts

@@ -0,0 +1,24 @@
+import { MetaData } from "../../shared/meta-data.js";
+import { type MeasureAgg } from "./reporting-constants.js";
+export declare class MetaMeasure extends MetaData {
+    /** True for `measure.ratio`; false for `measure.aggregate`. */
+    isRatio(): boolean;
+    /** The aggregate function (`measure.aggregate` only). */
+    agg(): MeasureAgg | undefined;
+    /** True when `@distinct` is set (legal only with `@agg: count`). */
+    distinct(): boolean;
+    /** The `Entity.field` references in `@of`: a bare string is one column, a list is the tuple form. */
+    ofColumns(): string[];
+    /** Name of a segment declared on the same entity; combines with `@filter` by AND. */
+    segmentName(): string | undefined;
+    /** The canonical row-scope filter, when one is declared. */
+    filter(): Record<string, unknown> | undefined;
+    /** `@default`: the integer this measure reads when it would otherwise be null (rule M7/M8
+     *  decide where it is legal). ADR-0039: resolving, so an inherited measure keeps it. */
+    defaultValue(): number | undefined;
+    /** Name of the `measure.aggregate` sibling used as the numerator (`measure.ratio` only). */
+    numerator(): string | undefined;
+    /** Name of the `measure.aggregate` sibling used as the denominator (`measure.ratio` only). */
+    denominator(): string | undefined;
+}
+//# sourceMappingURL=meta-measure.d.ts.map

package/dist/core/reporting/meta-measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-measure.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/meta-measure.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAWL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAMlC,qBAAa,WAAY,SAAQ,QAAQ;IACvC,+DAA+D;IAC/D,OAAO,IAAI,OAAO;IAIlB,yDAAyD;IACzD,GAAG,IAAI,UAAU,GAAG,SAAS;IAK7B,oEAAoE;IACpE,QAAQ,IAAI,OAAO;IAInB,qGAAqG;IACrG,SAAS,IAAI,MAAM,EAAE;IAMrB,qFAAqF;IACrF,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,4DAA4D;IAC5D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAK7C;4FACwF;IACxF,YAAY,IAAI,MAAM,GAAG,SAAS;IAKlC,4FAA4F;IAC5F,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B,8FAA8F;IAC9F,WAAW,IAAI,MAAM,GAAG,SAAS;CAGlC"}

package/dist/core/reporting/meta-measure.js

@@ -0,0 +1,54 @@
+// MetaMeasure — concrete node class for type=measure nodes (FR-044).
+//
+// Extends MetaData directly. Accessors are RESOLVING (ADR-0039).
+import { MetaData } from "../../shared/meta-data.js";
+import { MEASURE_AGGS, MEASURE_SUBTYPE_RATIO, REPORTING_ATTR_AGG, REPORTING_ATTR_DEFAULT, REPORTING_ATTR_DENOMINATOR, REPORTING_ATTR_DISTINCT, REPORTING_ATTR_FILTER, REPORTING_ATTR_NUMERATOR, REPORTING_ATTR_OF, REPORTING_ATTR_SEGMENT, } from "./reporting-constants.js";
+function optionalString(v) {
+    return typeof v === "string" ? v : undefined;
+}
+export class MetaMeasure extends MetaData {
+    /** True for `measure.ratio`; false for `measure.aggregate`. */
+    isRatio() {
+        return this.subType === MEASURE_SUBTYPE_RATIO;
+    }
+    /** The aggregate function (`measure.aggregate` only). */
+    agg() {
+        const v = this.attr(REPORTING_ATTR_AGG);
+        return MEASURE_AGGS.includes(v) ? v : undefined;
+    }
+    /** True when `@distinct` is set (legal only with `@agg: count`). */
+    distinct() {
+        return this.attr(REPORTING_ATTR_DISTINCT) === true;
+    }
+    /** The `Entity.field` references in `@of`: a bare string is one column, a list is the tuple form. */
+    ofColumns() {
+        const v = this.attr(REPORTING_ATTR_OF);
+        if (Array.isArray(v))
+            return v.filter((x) => typeof x === "string");
+        return typeof v === "string" ? [v] : [];
+    }
+    /** Name of a segment declared on the same entity; combines with `@filter` by AND. */
+    segmentName() {
+        return optionalString(this.attr(REPORTING_ATTR_SEGMENT));
+    }
+    /** The canonical row-scope filter, when one is declared. */
+    filter() {
+        const v = this.attr(REPORTING_ATTR_FILTER);
+        return typeof v === "object" && v !== null && !Array.isArray(v) ? v : undefined;
+    }
+    /** `@default`: the integer this measure reads when it would otherwise be null (rule M7/M8
+     *  decide where it is legal). ADR-0039: resolving, so an inherited measure keeps it. */
+    defaultValue() {
+        const v = this.attr(REPORTING_ATTR_DEFAULT);
+        return typeof v === "number" && Number.isInteger(v) ? v : undefined;
+    }
+    /** Name of the `measure.aggregate` sibling used as the numerator (`measure.ratio` only). */
+    numerator() {
+        return optionalString(this.attr(REPORTING_ATTR_NUMERATOR));
+    }
+    /** Name of the `measure.aggregate` sibling used as the denominator (`measure.ratio` only). */
+    denominator() {
+        return optionalString(this.attr(REPORTING_ATTR_DENOMINATOR));
+    }
+}
+//# sourceMappingURL=meta-measure.js.map

package/dist/core/reporting/meta-measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-measure.js","sourceRoot":"","sources":["../../../src/core/reporting/meta-measure.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,iEAAiE;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAElC,SAAS,cAAc,CAAC,CAAU;IAChC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,+DAA+D;IAC/D,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,KAAK,qBAAqB,CAAC;IAChD,CAAC;IAED,yDAAyD;IACzD,GAAG;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACxC,OAAQ,YAAmC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAED,oEAAoE;IACpE,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,IAAI,CAAC;IACrD,CAAC;IAED,qGAAqG;IACrG,SAAS;QACP,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QACjF,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IAED,qFAAqF;IACrF,WAAW;QACT,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,4DAA4D;IAC5D,MAAM;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,CAAC;IAED;4FACwF;IACxF,YAAY;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;IAED,4FAA4F;IAC5F,SAAS;QACP,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,8FAA8F;IAC9F,WAAW;QACT,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/core/reporting/meta-segment.d.ts

@@ -0,0 +1,6 @@
+import { MetaData } from "../../shared/meta-data.js";
+export declare class MetaSegment extends MetaData {
+    /** The named row scope: a canonical attr.filter over the declaring entity's fields. */
+    filter(): Record<string, unknown> | undefined;
+}
+//# sourceMappingURL=meta-segment.d.ts.map

package/dist/core/reporting/meta-segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-segment.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/meta-segment.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,qBAAa,WAAY,SAAQ,QAAQ;IACvC,uFAAuF;IACvF,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;CAI9C"}

package/dist/core/reporting/meta-segment.js

@@ -0,0 +1,13 @@
+// MetaSegment — concrete node class for type=segment nodes (FR-044).
+//
+// Extends MetaData directly. Accessors are RESOLVING (ADR-0039).
+import { MetaData } from "../../shared/meta-data.js";
+import { REPORTING_ATTR_FILTER } from "./reporting-constants.js";
+export class MetaSegment extends MetaData {
+    /** The named row scope: a canonical attr.filter over the declaring entity's fields. */
+    filter() {
+        const v = this.attr(REPORTING_ATTR_FILTER);
+        return typeof v === "object" && v !== null && !Array.isArray(v) ? v : undefined;
+    }
+}
+//# sourceMappingURL=meta-segment.js.map

package/dist/core/reporting/meta-segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-segment.js","sourceRoot":"","sources":["../../../src/core/reporting/meta-segment.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,iEAAiE;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,uFAAuF;IACvF,MAAM;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,CAAC;CACF"}

package/dist/core/reporting/report-accessors.d.ts

@@ -0,0 +1,27 @@
+import type { MetaData } from "../../shared/meta-data.js";
+export interface ReportDimensionItem {
+    readonly name: string;
+    readonly grain?: string;
+}
+/** The `@from` entity name of a report. */
+export declare function reportFrom(obj: MetaData): string | undefined;
+/** `@spine`: the to-one path to the entity whose rows supply the report's rows. */
+export declare function reportSpine(obj: MetaData): string | undefined;
+/** The `@dimensions` items, each `name` or `name:grain`. */
+export declare function reportDimensionItems(obj: MetaData): ReportDimensionItem[];
+/** The `@measures` items AS WRITTEN: each a bare measure `name`, or a dotted
+ *  `Entity.name` (loader rule R3). Use {@link reportMeasureItemName} for the measure name. */
+export declare function reportMeasureNames(obj: MetaData): string[];
+/**
+ * The measure a `@measures` item names: the segment after its LAST `.`
+ * (`total`, `Sale.total` and `acme::shop::Sale.total` all name `total`). It is also
+ * the derived report field's name. The part before that `.`, when present, is an
+ * entity qualifier, which {@link reportMeasureItemOwner} returns.
+ */
+export declare function reportMeasureItemName(item: string): string;
+/** The entity qualifier of a dotted `@measures` item (`Sale` in `Sale.total`), or
+ *  undefined for a bare item. Loader rule R3: it names `@from` or an entity `@from` extends. */
+export declare function reportMeasureItemOwner(item: string): string | undefined;
+/** The derived report field for a dimension item: `name` (attribute) or `name` + Capitalized(grain) (time). */
+export declare function reportDerivedFieldName(item: ReportDimensionItem): string;
+//# sourceMappingURL=report-accessors.d.ts.map

package/dist/core/reporting/report-accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-accessors.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/report-accessors.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAU1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAG5D;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAG7D;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,mBAAmB,EAAE,CAKzE;AAED;8FAC8F;AAC9F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;gGACgG;AAChG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED,+GAA+G;AAC/G,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAGxE"}