@metaobjectsdev/metadata 1.0.13 → 1.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"report-shape.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/report-shape.ts"],"names":[],"mappings":"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"}

package/dist/core/reporting/report-shape.js

@@ -0,0 +1,398 @@
+// Table B of docs/superpowers/plans/2026-10-03-fr-044-plan-2-report-view-lowering.md:
+// a report's derived fields. The single definition; every port has a rule-for-rule copy,
+// gated by fixtures/persistence-conformance/report-shapes.json. `required` follows Table C
+// of docs/superpowers/plans/2026-10-09-fr-044-zero-rows-and-measure-defaults.md, which
+// amends Table B for a report with `@spine` and a measure with `@default`.
+import { isMetaObject } from "../../shared/node-guards.js";
+import { refTarget, resolveObjectRef } from "../../naming-refs.js";
+import { CHILD_REF_SEPARATOR, PACKAGE_SEPARATOR } from "../../shared/structural.js";
+import { FIELD_SUBTYPE_BOOLEAN, FIELD_SUBTYPE_CURRENCY, FIELD_SUBTYPE_DATE, FIELD_SUBTYPE_DECIMAL, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_TIMESTAMP, } from "../field/field-constants.js";
+import { TYPE_IDENTITY, TYPE_RELATIONSHIP } from "../../shared/base-types.js";
+import { IDENTITY_REFERENCE_ATTR_REFERENCES, IDENTITY_SUBTYPE_REFERENCE } from "../identity/identity-constants.js";
+import { RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_SOURCE_REF_FIELD } from "../relationship/relationship-constants.js";
+import { resolveRelationshipReference } from "../relationship/resolve-relationship-reference.js";
+import { MetaDimension } from "./meta-dimension.js";
+import { MetaMeasure } from "./meta-measure.js";
+import { identityEffectiveFields } from "../identity/validate-identity-passthrough.js";
+import { reportDerivedFieldName, reportDimensionItems, reportFrom, reportMeasureItemName, reportMeasureItemOwner, reportMeasureNames, reportSpine, } from "./report-accessors.js";
+import { AGG_ALL, AGG_ANY } from "../../persistence/origin/origin-constants.js";
+import { AGG_AVG, AGG_COUNT, AGG_SUM, GRAIN_HOUR, TIME_GRAINS, TYPE_DIMENSION, TYPE_MEASURE, } from "./reporting-constants.js";
+const SUM_LONG = new Set([FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG]);
+const FLOATING = new Set([FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT]);
+/** Effective package of a node, taken from its resolution key ("<pkg>::<Name>"). */
+function packageOfKey(key) {
+    const i = key.lastIndexOf(PACKAGE_SEPARATOR);
+    return i >= 0 ? key.slice(0, i) : "";
+}
+/** True when `candidate` is `entity` or an entity it extends (the super chain). */
+function isSelfOrAncestor(candidate, entity) {
+    const visited = new Set();
+    for (let n = entity; n !== undefined && !visited.has(n); n = n.superData) {
+        if (n === candidate)
+            return true;
+        visited.add(n);
+    }
+    return false;
+}
+/**
+ * The entity that DECLARES a dimension, measure or segment reached through `from`: the
+ * member's parent, which is `from` itself or an entity `from` extends. A bare entity name
+ * inside the member (`@of`, `@via`) resolves in THIS entity's package, exactly as the
+ * loader's `validateReporting` resolves it (`pkgOf(ctx.declaring)`), never in `from`'s
+ * package or the report's.
+ */
+export function reportingMemberOwner(member, from) {
+    return member.parent ?? from;
+}
+/**
+ * Resolve a dimension's or measure's `Entity.field` reference to the field node. The ONE
+ * rule, the same as the loader's (`validateReporting` D1 / M1):
+ *
+ *  1. The entity half resolves relative to the package of `declaring`, the entity that
+ *     declares the member ({@link reportingMemberOwner}).
+ *  2. With `host` (a measure, or a dimension without `@via`: the reference is about the
+ *     `@from` entity's own rows) the named entity must be `host` or an entity it extends,
+ *     and the field is read from `host`, so a field `host` redeclares wins.
+ *  3. Without `host` the field is read from the named entity. A dimension with `@via` passes
+ *     the entity its `@via` reaches as both `declaring` and `host`
+ *     ({@link resolveDimensionOf}).
+ *
+ * Undefined when any step fails.
+ */
+export function resolveReportingFieldRef(ref, declaring, root, host) {
+    return resolveReportingFieldRefNamed(ref, declaring, root, host)?.field;
+}
+/**
+ * A dimension's `@of` field, read as the loader's rule D1 reads it. Without `@via` it is
+ * {@link resolveReportingFieldRef} with `from` as the host. With `@via` the host is the
+ * entity the `@via` reaches, and a bare entity name in `@of` resolves in THAT entity's
+ * package: the path already fixes the entity, so `Realm.name` after a hop onto
+ * `world::Realm` names `world::Realm`. The field is read from the reached entity, so a field
+ * it redeclares wins. Undefined when the `@via` or the `@of` does not resolve.
+ */
+export function resolveDimensionOf(dim, from, root) {
+    const of = dim.of() ?? "";
+    const via = dim.via();
+    if (via === undefined)
+        return resolveReportingFieldRefNamed(of, reportingMemberOwner(dim, from), root, from);
+    const terminal = reportingViaTerminal(via, reportingMemberOwner(dim, from), from, root);
+    if (terminal === undefined)
+        return undefined;
+    return resolveReportingFieldRefNamed(of, terminal, root, terminal);
+}
+/**
+ * The entity at the end of a `@via` walked from `from` (hops as {@link reportingViaHops}
+ * reads them, each target as {@link resolveViaHop} resolves it). Undefined when any hop does
+ * not resolve.
+ */
+function reportingViaTerminal(via, declaring, from, root) {
+    const hops = reportingViaHops(via, declaring, from, root);
+    if (hops === undefined)
+        return undefined;
+    let current = from;
+    for (const hop of hops) {
+        const target = resolveViaHop(current, hop)?.target;
+        if (target === undefined)
+            return undefined;
+        current = target;
+    }
+    return current;
+}
+/**
+ * {@link resolveReportingFieldRef}, also returning `named`: the entity the reference's
+ * entity half names (which, with `host`, may be an ancestor of the entity `field` is read
+ * from). Table C reads `named`'s primary identity.
+ */
+function resolveReportingFieldRefNamed(ref, declaring, root, host) {
+    // `Entity.field`; a package qualifier uses `::`, so the member separator is the LAST dot.
+    const dot = ref.lastIndexOf(CHILD_REF_SEPARATOR);
+    if (dot <= 0)
+        return undefined;
+    const named = resolveObjectRef(root, ref.slice(0, dot), packageOfKey(declaring.resolutionKey())).node;
+    if (!isMetaObject(named))
+        return undefined;
+    if (host !== undefined && !isSelfOrAncestor(named, host))
+        return undefined;
+    // ADR-0039: resolving, so a field inherited through extends is found.
+    const field = (host ?? named).fields().find((f) => f.name === ref.slice(dot + 1));
+    return field === undefined ? undefined : { named, field };
+}
+/**
+ * The hop names of a dimension's `@via` (`Owner.hop[.hop...]`), read as the loader reads it
+ * (`validateReporting` rule D2): `Owner` resolves in the package of `declaring`
+ * ({@link reportingMemberOwner}) and must be `from` or an entity `from` extends. The walk
+ * itself then starts AT `from`, whichever of the two `Owner` named. Undefined when the
+ * reference has no owner, no hop, or an owner that is not `from` or an ancestor of it.
+ */
+export function reportingViaHops(via, declaring, from, root) {
+    // The owner ends at the first `.` after the last `::` (a package qualifier has no `.`).
+    const lastSep = via.lastIndexOf(PACKAGE_SEPARATOR);
+    const segStart = lastSep === -1 ? 0 : lastSep + PACKAGE_SEPARATOR.length;
+    const dot = via.indexOf(CHILD_REF_SEPARATOR, segStart);
+    if (dot <= segStart)
+        return undefined;
+    const hops = via.slice(dot + CHILD_REF_SEPARATOR.length).split(CHILD_REF_SEPARATOR);
+    if (hops.some((h) => h === ""))
+        return undefined;
+    const owner = resolveObjectRef(root, via.slice(0, dot), packageOfKey(declaring.resolutionKey())).node;
+    if (owner === undefined || !isSelfOrAncestor(owner, from))
+        return undefined;
+    return hops;
+}
+function unresolved(reportName, what) {
+    return new Error(`report '${reportName}': ${what} does not resolve.`);
+}
+/**
+ * The hop names of a report's `@spine` (`Owner.hop[.hop...]`), read as
+ * {@link reportingViaHops} reads a `@via`, the owner resolving in `from`'s package (loader
+ * rule R8): Owner must be `from` or an entity it extends, so a bare name means `from`'s
+ * package even when the report lives in another one. Undefined when the report declares no `@spine`. Throws a plain Error
+ * naming the report when a declared `@spine` does not resolve (a report that passed
+ * `validateReporting` always resolves): reading it as "no spine" would claim a column
+ * non-null that a spine row with no facts leaves null.
+ */
+export function reportSpineHops(report, from, root) {
+    const spine = reportSpine(report);
+    if (spine === undefined)
+        return undefined;
+    const hops = reportingViaHops(spine, from, from, root);
+    if (hops === undefined)
+        throw unresolved(report.name, `@spine '${spine}'`);
+    return hops;
+}
+/**
+ * One hop of a `@via`/`@spine` path, as the loader's rule R8 walks it: the `relationship.*`
+ * (read through its `@objectRef`) or `identity.reference` (through its `@references`) of
+ * `current` named `hopName`, with its target resolved in the package of the node that declares
+ * the hop's reference attribute (ADR-0059 R3). Returns
+ * `target: undefined` for an unresolvable hop or a ref attr that is not a string / does not
+ * reach a metadata object.
+ * ADR-0039: resolving children(), so a hop inherited through extends is found.
+ */
+function resolveViaHop(current, hopName) {
+    const rel = current.children().find((c) => c.type === TYPE_RELATIONSHIP && c.name === hopName);
+    const refNode = rel !== undefined
+        ? undefined
+        : current.children().find((c) => c.type === TYPE_IDENTITY && c.subType === IDENTITY_SUBTYPE_REFERENCE && c.name === hopName);
+    const hop = rel ?? refNode;
+    if (hop === undefined)
+        return undefined;
+    const isReference = rel === undefined;
+    const node = refTarget(hop, isReference ? IDENTITY_REFERENCE_ATTR_REFERENCES : RELATIONSHIP_ATTR_OBJECT_REF);
+    return { hop, isReference, target: isMetaObject(node) ? node : undefined };
+}
+/**
+ * The spine entity: the object at the end of a report's `@spine`, whose rows are the
+ * report's rows. Walked hop by hop from `from` as the loader's rule R8 walks it via
+ * {@link resolveViaHop}; an unresolved hop throws, as {@link reportSpineHops} does (a report
+ * that passed `validateReporting` always resolves). Undefined when the report declares no
+ * `@spine`.
+ */
+export function reportSpineEntity(report, from, root) {
+    const hops = reportSpineHops(report, from, root);
+    if (hops === undefined)
+        return undefined;
+    let current = from;
+    for (const hop of hops) {
+        const target = resolveViaHop(current, hop)?.target;
+        if (target === undefined)
+            throw unresolved(report.name, `@spine '${reportSpine(report) ?? ""}' hop '${hop}'`);
+        current = target;
+    }
+    return current;
+}
+/** True when `field` is one of the `@fields` of `entity`'s `identity.primary`. */
+function isPrimaryKeyField(entity, field) {
+    // ADR-0039: resolving — an identity.primary (and its @fields) inherited from an
+    // abstract base counts.
+    const pk = entity.primaryIdentity();
+    return pk !== undefined && (identityEffectiveFields(pk) ?? []).includes(field.name);
+}
+function declaredMember(from, type, name, cls) {
+    // ADR-0039: resolving children(), so a member declared on an abstract base is found.
+    return from.children().find((c) => c.type === type && c.name === name && c instanceof cls);
+}
+function isTimeGrain(grain) {
+    return grain !== undefined && TIME_GRAINS.includes(grain);
+}
+/**
+ * True when every hop of `hops`, walked from `from`, is a belongs-to hop over a required
+ * foreign key: the hops the view joins INNER, so every row of the report has a match. This
+ * is the join-type rule of the view lowering (codegen-ts `walkViaPath`, #209): the reference
+ * is held by the entity the hop leaves, its first FK field is required, and every earlier hop
+ * is INNER too. `@enforce: false` does not change it. A hop that does not resolve, an
+ * ambiguous reference or a has-many hop is not INNER.
+ */
+function viaJoinsInner(hops, from, root) {
+    let current = from;
+    for (const hopName of hops) {
+        const resolved = resolveViaHop(current, hopName);
+        if (resolved === undefined || resolved.target === undefined)
+            return false;
+        const { hop, isReference, target } = resolved;
+        // The reference the hop crosses, as the lowering resolves it. A has-many hop, whose FK
+        // sits on the child, matches none of the current entity's own references.
+        let reference;
+        if (isReference) {
+            reference = hop;
+        }
+        else {
+            const sourceRefField = hop.attr(RELATIONSHIP_ATTR_SOURCE_REF_FIELD);
+            reference = resolveRelationshipReference(current, hopName, target, typeof sourceRefField === "string" ? sourceRefField : undefined);
+        }
+        if (reference === undefined)
+            return false;
+        const fkName = reference.fields[0];
+        const fk = fkName === undefined ? undefined : current.findField(fkName);
+        if (fk === undefined || !fk.isRequired)
+            return false;
+        current = target;
+    }
+    return true;
+}
+/**
+ * Table C (`required` of a dimension). Without `@spine`: only a dimension over an `@of` field
+ * that is effectively required (`@required`, or a `validator.required` child), and, when it has a `@via`, only when every hop is a
+ * required belongs-to reference, the hops the view joins INNER ({@link viaJoinsInner}). With `@spine`: only a dimension
+ * whose `@via` hops equal the spine's (a column of the spine entity itself, whose rows are
+ * the report's rows) over an `@of` field that is `@required` or a primary-key column of the
+ * entity `@of` names. A dimension beyond the spine is reached by a LEFT OUTER join.
+ */
+function dimensionRequired(dim, named, of, from, root, spine, reportName) {
+    const via = dim.via();
+    if (spine === undefined) {
+        if (via === undefined)
+            return of.isRequired;
+        if (!of.isRequired)
+            return false;
+        const hops = reportingViaHops(via, reportingMemberOwner(dim, from), from, root);
+        if (hops === undefined)
+            throw unresolved(reportName, `dimension '${dim.name}' @via '${via}'`);
+        return viaJoinsInner(hops, from, root);
+    }
+    if (via === undefined)
+        return false; // a column of @from: null in a spine row with no facts
+    const hops = reportingViaHops(via, reportingMemberOwner(dim, from), from, root);
+    if (hops === undefined)
+        throw unresolved(reportName, `dimension '${dim.name}' @via '${via}'`);
+    const onSpine = hops.length === spine.length && hops.every((h, i) => h === spine[i]);
+    return onSpine && (of.isRequired || isPrimaryKeyField(named, of));
+}
+function dimensionField(item, from, root, reportName, spine) {
+    const dim = declaredMember(from, TYPE_DIMENSION, item.name, MetaDimension);
+    if (dim === undefined)
+        throw unresolved(reportName, `dimension '${item.name}' on '${from.name}'`);
+    const via = dim.via();
+    // A @via that does not walk is the @via's error, not the @of's (the @of resolves at its end).
+    if (via !== undefined && reportingViaTerminal(via, reportingMemberOwner(dim, from), from, root) === undefined) {
+        throw unresolved(reportName, `dimension '${dim.name}' @via '${via}'`);
+    }
+    const ref = resolveDimensionOf(dim, from, root);
+    if (ref === undefined)
+        throw unresolved(reportName, `dimension '${item.name}' @of`);
+    const of = ref.field;
+    const name = reportDerivedFieldName(item);
+    const required = dimensionRequired(dim, ref.named, of, from, root, spine, reportName);
+    if (dim.isTime()) {
+        // Loader rule R2 guarantees a grain from the closed set; a tree built in code does not.
+        const grain = item.grain;
+        if (!isTimeGrain(grain))
+            throw unresolved(reportName, `time dimension '${item.name}' grain '${grain ?? ""}'`);
+        if (grain === GRAIN_HOUR) {
+            return { name, role: "dimension", subType: FIELD_SUBTYPE_TIMESTAMP, required, typeSource: of, dimension: dim, grain };
+        }
+        return { name, role: "dimension", subType: FIELD_SUBTYPE_DATE, required, dimension: dim, grain };
+    }
+    return { name, role: "dimension", subType: of.subType, required, typeSource: of, dimension: dim };
+}
+/**
+ * One `@measures` item, bare (`total`) or dotted (`Sale.total`, loader rule R3). The measure
+ * is named by the item's last segment and looked up on `from`; a qualifier resolves in the
+ * REPORT's package and must be `from` or an entity `from` extends.
+ */
+function measureField(item, report, from, root) {
+    const reportName = report.name;
+    const name = reportMeasureItemName(item);
+    const qualifier = reportMeasureItemOwner(item);
+    if (qualifier !== undefined) {
+        const owner = resolveObjectRef(root, qualifier, packageOfKey(report.resolutionKey())).node;
+        if (owner === undefined || !isSelfOrAncestor(owner, from)) {
+            throw unresolved(reportName, `measure '${item}' on '${from.name}'`);
+        }
+    }
+    const m = declaredMember(from, TYPE_MEASURE, name, MetaMeasure);
+    if (m === undefined)
+        throw unresolved(reportName, `measure '${item}' on '${from.name}'`);
+    const derived = deriveMeasure(m, from, root);
+    if (derived === undefined)
+        throw unresolved(reportName, `measure '${name}' @of`);
+    // Table C: a count is never null; any other measure is not null when it has a @default.
+    const required = (!m.isRatio() && m.agg() === AGG_COUNT) || m.defaultValue() !== undefined;
+    const { subType, typeSource } = derived;
+    // The key set (no `typeSource` key when there is none) and its order are as before.
+    return typeSource === undefined
+        ? { name, role: "measure", subType, required, measure: m }
+        : { name, role: "measure", subType, required, typeSource, measure: m };
+}
+/** Table B for one measure. Undefined when its `@of` does not resolve. */
+function deriveMeasure(m, from, root) {
+    if (m.isRatio())
+        return { subType: FIELD_SUBTYPE_DECIMAL };
+    const agg = m.agg();
+    if (agg === AGG_COUNT)
+        return { subType: FIELD_SUBTYPE_LONG };
+    // any / all are boolean whatever the source (the loader's M4 refuses a non-boolean @of).
+    if (agg === AGG_ANY || agg === AGG_ALL)
+        return { subType: FIELD_SUBTYPE_BOOLEAN };
+    const of = resolveReportingFieldRef(m.ofColumns()[0] ?? "", reportingMemberOwner(m, from), root, from);
+    if (of === undefined)
+        return undefined;
+    const src = of.subType;
+    if (agg === AGG_SUM) {
+        if (src === FIELD_SUBTYPE_CURRENCY)
+            return { subType: FIELD_SUBTYPE_CURRENCY, typeSource: of };
+        return {
+            subType: SUM_LONG.has(src) ? FIELD_SUBTYPE_LONG : FLOATING.has(src) ? FIELD_SUBTYPE_DOUBLE : FIELD_SUBTYPE_DECIMAL,
+        };
+    }
+    if (agg === AGG_AVG)
+        return { subType: FLOATING.has(src) ? FIELD_SUBTYPE_DOUBLE : FIELD_SUBTYPE_DECIMAL };
+    // min / max keep the source field's type.
+    return { subType: src, typeSource: of };
+}
+/**
+ * Table B's subtype for one measure of `from`, whether or not a report lists it (a
+ * ratio's operands are measures a report need not list). The same rule `reportShape`
+ * applies to a listed measure. Undefined when its `@of` does not resolve, which the
+ * loader (rule M6) reads before the model is known to be valid.
+ */
+export function measureResultSubType(measure, from, root) {
+    return deriveMeasure(measure, from, root)?.subType;
+}
+/**
+ * {@link measureResultSubType} for a model that passed `validateReporting`. Throws a plain
+ * Error naming the measure when its `@of` does not resolve (a valid measure always resolves).
+ */
+export function measureDerivedSubType(measure, from, root) {
+    const subType = measureResultSubType(measure, from, root);
+    if (subType === undefined)
+        throw new Error(`measure '${measure.name}' on '${from.name}': @of does not resolve.`);
+    return subType;
+}
+/** Table B, with Table C's `required`. Throws a plain Error naming the report when a
+ *  reference does not resolve (a report that passed `validateReporting` always resolves). */
+export function reportShape(report, root) {
+    const fromName = reportFrom(report);
+    if (fromName === undefined)
+        throw unresolved(report.name, "@from");
+    const from = resolveObjectRef(root, fromName, packageOfKey(report.resolutionKey())).node;
+    if (!isMetaObject(from))
+        throw unresolved(report.name, `@from '${fromName}'`);
+    const spine = reportSpineHops(report, from, root);
+    const fields = [
+        ...reportDimensionItems(report).map((item) => dimensionField(item, from, root, report.name, spine)),
+        ...reportMeasureNames(report).map((item) => measureField(item, report, from, root)),
+    ];
+    return { report, from, fields };
+}
+//# sourceMappingURL=report-shape.js.map

package/dist/core/reporting/report-shape.js.map

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

package/dist/core/reporting/reporting-constants.d.ts

@@ -0,0 +1,65 @@
+import { TYPE_DIMENSION, TYPE_MEASURE, TYPE_SEGMENT } from "../../shared/base-types.js";
+export { TYPE_DIMENSION, TYPE_MEASURE, TYPE_SEGMENT };
+/** Groups by a column value as-is (no grain, no truncation). */
+export declare const DIMENSION_SUBTYPE_ATTRIBUTE = "attribute";
+/** Groups by a date/timestamp column truncated to a grain. */
+export declare const DIMENSION_SUBTYPE_TIME = "time";
+export declare const DIMENSION_SUBTYPES: readonly ["attribute", "time"];
+export type DimensionSubType = (typeof DIMENSION_SUBTYPES)[number];
+/** One aggregate over the declaring entity's own rows. */
+export declare const MEASURE_SUBTYPE_AGGREGATE = "aggregate";
+/** A quotient of two `measure.aggregate` siblings, `numerator / NULLIF(denominator, 0)`.
+ *  `measure.derived` is deliberately NOT registered: it waits for FR-037 R5. */
+export declare const MEASURE_SUBTYPE_RATIO = "ratio";
+export declare const MEASURE_SUBTYPES: readonly ["aggregate", "ratio"];
+export type MeasureSubType = (typeof MEASURE_SUBTYPES)[number];
+/** A named, reusable row filter. The only concrete segment subtype: every `*.base`
+ *  in the registry is an abstract anchor, so authors write `segment.filter`. */
+export declare const SEGMENT_SUBTYPE_FILTER = "filter";
+export declare const SEGMENT_SUBTYPES: readonly ["filter"];
+export type SegmentSubType = (typeof SEGMENT_SUBTYPES)[number];
+/** Dotted `Entity.field` reference(s) naming the grouped / aggregated column(s). */
+export declare const REPORTING_ATTR_OF = "of";
+/** Optional dotted to-one relationship path from the owning entity to the `@of` entity. */
+export declare const REPORTING_ATTR_VIA = "via";
+/** The grains a `dimension.time` supports. */
+export declare const REPORTING_ATTR_GRAINS = "grains";
+/** The aggregate function of a `measure.aggregate`. */
+export declare const REPORTING_ATTR_AGG = "agg";
+/** Count distinct values (legal only with `@agg: count`). */
+export declare const REPORTING_ATTR_DISTINCT = "distinct";
+/** Row scope (an attr.filter) on a `measure.aggregate` or `segment.filter`. */
+export declare const REPORTING_ATTR_FILTER = "filter";
+/** Name of a segment declared on the same entity. */
+export declare const REPORTING_ATTR_SEGMENT = "segment";
+/** `measure.ratio` operand names. */
+export declare const REPORTING_ATTR_NUMERATOR = "numerator";
+export declare const REPORTING_ATTR_DENOMINATOR = "denominator";
+/** Integer a measure reads when it would otherwise be null (`measure.aggregate` / `measure.ratio`). */
+export declare const REPORTING_ATTR_DEFAULT = "default";
+/** Weeks start on Monday (ISO-8601) in every lowering. */
+export declare const GRAIN_HOUR = "hour";
+export declare const GRAIN_DAY = "day";
+export declare const GRAIN_WEEK = "week";
+export declare const GRAIN_MONTH = "month";
+export declare const GRAIN_QUARTER = "quarter";
+export declare const GRAIN_YEAR = "year";
+export declare const TIME_GRAINS: readonly ["hour", "day", "week", "month", "quarter", "year"];
+export type TimeGrain = (typeof TIME_GRAINS)[number];
+export declare const AGG_COUNT = "count";
+export declare const AGG_SUM = "sum";
+export declare const AGG_AVG = "avg";
+export declare const AGG_MIN = "min";
+export declare const AGG_MAX = "max";
+export declare const MEASURE_AGGS: readonly ["count", "sum", "avg", "min", "max", "any", "all"];
+export type MeasureAgg = (typeof MEASURE_AGGS)[number];
+/** Separator in an `object.report` `@dimensions` item: `name` or `name:grain`. */
+export declare const REPORT_DIMENSION_GRAIN_SEPARATOR = ":";
+/** The single key of a relative-date filter value: `{ now: "<ISO-8601 duration>" }`
+ *  means "the current time plus that duration", evaluated when the view is queried.
+ *  Legal only in the `@filter` of a `segment`, `measure.aggregate` or `object.report`. */
+export declare const FILTER_RELATIVE_NOW = "now";
+/** A signed ISO-8601 duration (`-P7D`, `P1Y2M`, `-PT12H`). The lookaheads refuse the
+ *  degenerate `P` and `PT` forms (a designator with no component). */
+export declare const ISO_DURATION_RE: RegExp;
+//# sourceMappingURL=reporting-constants.d.ts.map

package/dist/core/reporting/reporting-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-constants.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/reporting-constants.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAMtD,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,cAAc,CAAC;AACvD,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAC7C,eAAO,MAAM,kBAAkB,gCAAiE,CAAC;AACjG,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD;gFACgF;AAChF,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,gBAAgB,iCAA8D,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;gFACgF;AAChF,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAC/C,eAAO,MAAM,gBAAgB,qBAAoC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM/D,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAChD,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,cAAc,CAAC;AACpD,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,uGAAuG;AACvG,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAOhD,0DAA0D;AAC1D,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,SAAS,QAAQ,CAAC;AAC/B,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,WAAW,8DAAuF,CAAC;AAChH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,OAAO,QAAQ,CAAC;AAG7B,eAAO,MAAM,YAAY,8DAA6E,CAAC;AACvG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,kFAAkF;AAClF,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAMpD;;0FAE0F;AAC1F,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC;sEACsE;AACtE,eAAO,MAAM,eAAe,QACgD,CAAC"}

package/dist/core/reporting/reporting-constants.js

@@ -0,0 +1,84 @@
+// Reporting concern constants (FR-044) — type names, subtypes, attr keys and
+// the closed sets the registry enforces through `allowedValues`.
+//
+// `dimension`, `measure` and `segment` are children of `object.entity` only
+// (never root-level), and `object.report` (see object-constants.ts) references
+// them by name. The type-name constants live in shared/base-types.ts beside
+// every other base type and are re-exported here so a reporting consumer has
+// one import site.
+import { AGG_ALL, AGG_ANY } from "../../persistence/origin/origin-constants.js";
+import { TYPE_DIMENSION, TYPE_MEASURE, TYPE_SEGMENT } from "../../shared/base-types.js";
+export { TYPE_DIMENSION, TYPE_MEASURE, TYPE_SEGMENT };
+// ---------------------------------------------------------------------------
+// Subtypes
+// ---------------------------------------------------------------------------
+/** Groups by a column value as-is (no grain, no truncation). */
+export const DIMENSION_SUBTYPE_ATTRIBUTE = "attribute";
+/** Groups by a date/timestamp column truncated to a grain. */
+export const DIMENSION_SUBTYPE_TIME = "time";
+export const DIMENSION_SUBTYPES = [DIMENSION_SUBTYPE_ATTRIBUTE, DIMENSION_SUBTYPE_TIME];
+/** One aggregate over the declaring entity's own rows. */
+export const MEASURE_SUBTYPE_AGGREGATE = "aggregate";
+/** A quotient of two `measure.aggregate` siblings, `numerator / NULLIF(denominator, 0)`.
+ *  `measure.derived` is deliberately NOT registered: it waits for FR-037 R5. */
+export const MEASURE_SUBTYPE_RATIO = "ratio";
+export const MEASURE_SUBTYPES = [MEASURE_SUBTYPE_AGGREGATE, MEASURE_SUBTYPE_RATIO];
+/** A named, reusable row filter. The only concrete segment subtype: every `*.base`
+ *  in the registry is an abstract anchor, so authors write `segment.filter`. */
+export const SEGMENT_SUBTYPE_FILTER = "filter";
+export const SEGMENT_SUBTYPES = [SEGMENT_SUBTYPE_FILTER];
+// ---------------------------------------------------------------------------
+// Attrs (on dimension / measure / segment nodes)
+// ---------------------------------------------------------------------------
+/** Dotted `Entity.field` reference(s) naming the grouped / aggregated column(s). */
+export const REPORTING_ATTR_OF = "of";
+/** Optional dotted to-one relationship path from the owning entity to the `@of` entity. */
+export const REPORTING_ATTR_VIA = "via";
+/** The grains a `dimension.time` supports. */
+export const REPORTING_ATTR_GRAINS = "grains";
+/** The aggregate function of a `measure.aggregate`. */
+export const REPORTING_ATTR_AGG = "agg";
+/** Count distinct values (legal only with `@agg: count`). */
+export const REPORTING_ATTR_DISTINCT = "distinct";
+/** Row scope (an attr.filter) on a `measure.aggregate` or `segment.filter`. */
+export const REPORTING_ATTR_FILTER = "filter";
+/** Name of a segment declared on the same entity. */
+export const REPORTING_ATTR_SEGMENT = "segment";
+/** `measure.ratio` operand names. */
+export const REPORTING_ATTR_NUMERATOR = "numerator";
+export const REPORTING_ATTR_DENOMINATOR = "denominator";
+/** Integer a measure reads when it would otherwise be null (`measure.aggregate` / `measure.ratio`). */
+export const REPORTING_ATTR_DEFAULT = "default";
+// ---------------------------------------------------------------------------
+// Closed sets — mirrored by `allowedValues` in spec/metamodel/reporting.json.
+// Order is part of the contract (it is the order the registry manifest records).
+// ---------------------------------------------------------------------------
+/** Weeks start on Monday (ISO-8601) in every lowering. */
+export const GRAIN_HOUR = "hour";
+export const GRAIN_DAY = "day";
+export const GRAIN_WEEK = "week";
+export const GRAIN_MONTH = "month";
+export const GRAIN_QUARTER = "quarter";
+export const GRAIN_YEAR = "year";
+export const TIME_GRAINS = [GRAIN_HOUR, GRAIN_DAY, GRAIN_WEEK, GRAIN_MONTH, GRAIN_QUARTER, GRAIN_YEAR];
+export const AGG_COUNT = "count";
+export const AGG_SUM = "sum";
+export const AGG_AVG = "avg";
+export const AGG_MIN = "min";
+export const AGG_MAX = "max";
+// `any` / `all`: boolean OR / AND over a `field.boolean` (Postgres `bool_or` / `bool_and`); the
+// measure is boolean. The names, and their constants, are `origin.aggregate`'s own.
+export const MEASURE_AGGS = [AGG_COUNT, AGG_SUM, AGG_AVG, AGG_MIN, AGG_MAX, AGG_ANY, AGG_ALL];
+/** Separator in an `object.report` `@dimensions` item: `name` or `name:grain`. */
+export const REPORT_DIMENSION_GRAIN_SEPARATOR = ":";
+// ---------------------------------------------------------------------------
+// Relative-date filter values (spec §4 R4; rules F1/F2)
+// ---------------------------------------------------------------------------
+/** The single key of a relative-date filter value: `{ now: "<ISO-8601 duration>" }`
+ *  means "the current time plus that duration", evaluated when the view is queried.
+ *  Legal only in the `@filter` of a `segment`, `measure.aggregate` or `object.report`. */
+export const FILTER_RELATIVE_NOW = "now";
+/** A signed ISO-8601 duration (`-P7D`, `P1Y2M`, `-PT12H`). The lookaheads refuse the
+ *  degenerate `P` and `PT` forms (a designator with no component). */
+export const ISO_DURATION_RE = /^[+-]?P(?!$)(\d+Y)?(\d+M)?(\d+W)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+S)?)?$/;
+//# sourceMappingURL=reporting-constants.js.map

package/dist/core/reporting/reporting-constants.js.map

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

package/dist/core/reporting/reporting-definition.embedded.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDefinition } from "../../provider-data.js";
+export declare const REPORTING_DEFINITION: ProviderDefinition;
+//# sourceMappingURL=reporting-definition.embedded.d.ts.map

package/dist/core/reporting/reporting-definition.embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/core/reporting/reporting-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,oBAAoB,EAAE,kBAuLlC,CAAC"}