@metaobjectsdev/metadata 0.9.0-rc.1 → 0.10.0

package/src/core/field/field-schema.ts

@@ -1,228 +0,0 @@
-// Field attribute schemas — attrs common to every field subtype, plus the
-// @currency attr specific to field.currency. Consumed by registerCoreTypes().
-
-import type { AttrSchema } from "../../registry.js";
-import {
-  ATTR_SUBTYPE_STRING,
-  ATTR_SUBTYPE_INT,
-  ATTR_SUBTYPE_BOOLEAN,
-  ATTR_SUBTYPE_STRINGARRAY,
-  ATTR_SUBTYPE_PROPERTIES,
-} from "../attr/attr-constants.js";
-import { SORT_ORDER_VALUES } from "../query/query-constants.js";
-import {
-  FIELD_ATTR_OBJECT_REF,
-  FIELD_ATTR_STORAGE,
-  STORAGE_VALUES,
-  FIELD_ATTR_REQUIRED,
-  FIELD_ATTR_READ_ONLY,
-  FIELD_ATTR_UNIQUE,
-  FIELD_ATTR_DEFAULT,
-  FIELD_ATTR_MAX_LENGTH,
-  FIELD_ATTR_PRECISION,
-  FIELD_ATTR_SCALE,
-  FIELD_ATTR_FILTERABLE,
-  FIELD_ATTR_SORTABLE,
-  FIELD_ATTR_SORTABLE_DEFAULT_ORDER,
-  FIELD_ATTR_CURRENCY,
-  FIELD_ATTR_CURRENCY_DEFAULT,
-  FIELD_ATTR_AUTO_SET,
-  AUTO_SET_VALUES,
-  FIELD_ATTR_VALUES,
-  FIELD_ATTR_ENUM_ALIAS,
-  FIELD_ATTR_ENUM_DOC,
-  FIELD_ATTR_EXAMPLE,
-  FIELD_ATTR_INSTRUCTION,
-  FIELD_ATTR_COERCE_DEFAULT,
-  FIELD_ATTR_NORMALIZE,
-  NORMALIZE_MODES,
-  NORMALIZE_DEFAULT,
-} from "./field-constants.js";
-
-/** Attrs common to every field subtype (codegen-ts column mapper + Project D filter/sort). */
-export const commonFieldAttrs: AttrSchema[] = [
-  {
-    name: FIELD_ATTR_OBJECT_REF,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "Name (or FQN) of the target object an object-typed field nests — drives nested-object (de)serialization.",
-  },
-  {
-    name: FIELD_ATTR_STORAGE,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    allowedValues: [...STORAGE_VALUES],
-    description:
-      "Storage strategy for an object-typed field (set with @objectRef). " +
-      "\"flattened\" expands the nested value into prefixed columns on the parent " +
-      "table. \"jsonb\" stores the structured value in a single jsonb column " +
-      "(supports isArray=true for arrays of values). \"subdocument\" is a hint for " +
-      "document-store codegen targets and emits no Postgres column.",
-  },
-  {
-    name: FIELD_ATTR_REQUIRED,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description:
-      "When true, the field is NOT NULL. Equivalent to attaching a validator.required child.",
-  },
-  {
-    name: FIELD_ATTR_READ_ONLY,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description:
-      "FR-013: when true, the field is read-only — codegen emits no setter / " +
-      "writable property, the persistence layer skips the column on INSERT/UPDATE, " +
-      "and Zod/Pydantic/class-validator schemas mark it read-only on input variants. " +
-      "The value is populated by the database (computed column, default expression, " +
-      "trigger), by replication, or by another external owner.",
-  },
-  {
-    name: FIELD_ATTR_UNIQUE,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description: "When true, the field gets a column-level UNIQUE constraint.",
-  },
-  {
-    name: FIELD_ATTR_DEFAULT,
-    // @default is polymorphic: its value type follows the OWNING field's
-    // subtype — a boolean field defaults to a boolean, an int field to a
-    // number, a string field to a string. No single fixed valueType can
-    // capture that, so valueType is intentionally omitted (declared-but-untyped).
-    // The parser stores the raw JSON value type-preserved (no coercion).
-    // Typed conversion happens at consumption time via MetaField.defaultValue(),
-    // which applies the field's own DataType — Java parity with
-    // MetaField.getDefaultValue() / DataConverter.toTypeSafe(getDataType(), o).
-    required: false,
-    description:
-      "Default value applied to the column when no value is supplied. Its type follows the field's own subtype (string / boolean / number / ...). Converted at consumption time via MetaField.defaultValue().",
-  },
-  {
-    name: FIELD_ATTR_MAX_LENGTH,
-    valueType: ATTR_SUBTYPE_INT,
-    required: false,
-    description: "Maximum character length for string-typed fields (drives VARCHAR(n)).",
-  },
-  {
-    name: FIELD_ATTR_PRECISION,
-    valueType: ATTR_SUBTYPE_INT,
-    required: false,
-    description: "Total number of significant digits for decimal-typed fields.",
-  },
-  {
-    name: FIELD_ATTR_SCALE,
-    valueType: ATTR_SUBTYPE_INT,
-    required: false,
-    description: "Number of digits to the right of the decimal point for decimal-typed fields.",
-  },
-  {
-    name: FIELD_ATTR_FILTERABLE,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description:
-      "When true, the field is exposed in generated CRUD filter allowlists (Project D filter layer).",
-  },
-  {
-    name: FIELD_ATTR_SORTABLE,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description:
-      "When true, the field is exposed in generated CRUD sort allowlists. Inherits from @filterable by default; set false to opt out.",
-  },
-  {
-    name: FIELD_ATTR_SORTABLE_DEFAULT_ORDER,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    allowedValues: [...SORT_ORDER_VALUES],
-    description: "Default sort direction applied when this field is the default sort field.",
-  },
-  {
-    name: FIELD_ATTR_AUTO_SET,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    allowedValues: [...AUTO_SET_VALUES],
-    description:
-      "Auto-set semantics for timestamp-like fields: 'onCreate' stamps on insert, 'onUpdate' stamps on every write.",
-  },
-  // FR-010 field-teaching attrs (any field): free-text shown in the generated
-  // output-format prompt fragment. Never carried in comments.
-  {
-    name: FIELD_ATTR_EXAMPLE,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "FR-010: an example value for this field, shown in the generated output-format prompt fragment.",
-  },
-  {
-    name: FIELD_ATTR_INSTRUCTION,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "FR-010: a short instruction for this field, shown in the generated output-format prompt fragment.",
-  },
-];
-
-/** The @currency attr — only on field.currency. */
-export const currencyFieldAttr: AttrSchema = {
-  name: FIELD_ATTR_CURRENCY,
-  valueType: ATTR_SUBTYPE_STRING,
-  required: false,
-  default: FIELD_ATTR_CURRENCY_DEFAULT,
-  description:
-    "ISO 4217 currency code for a currency-subtype field. Storage is integer minor units; defaults to 'USD' when omitted.",
-};
-
-/** The @values attr — only on field.enum. Required string array. */
-export const enumFieldAttr: AttrSchema = {
-  name: FIELD_ATTR_VALUES,
-  valueType: ATTR_SUBTYPE_STRINGARRAY,
-  required: true,
-  description:
-    "Member symbols of an enum-subtype field. Declaration order is significant; each is a legal identifier and its own stored string.",
-};
-
-/** The @enumAlias attr — only on field.enum. Map of off-vocabulary token → canonical
- *  member, feeding the FR-010 tolerant extract alias-fold (runtime aliases win on conflict). */
-export const enumAliasAttr: AttrSchema = {
-  name: FIELD_ATTR_ENUM_ALIAS,
-  valueType: ATTR_SUBTYPE_PROPERTIES,
-  required: false,
-  description:
-    "Map of alternate/off-vocabulary tokens to canonical enum members; feeds the FR-010 tolerant extract alias-fold.",
-};
-
-/** The @enumDoc attr — only on field.enum. Map of member → human-readable description,
- *  shown per-member in the FR-010 'guide'-style output-format prompt fragment. */
-export const enumDocAttr: AttrSchema = {
-  name: FIELD_ATTR_ENUM_DOC,
-  valueType: ATTR_SUBTYPE_PROPERTIES,
-  required: false,
-  description:
-    "Map of enum member to a human-readable description; shown per-member in the FR-010 'guide'-style prompt fragment.",
-};
-
-/** FR-011: the @coerceDefault attr — only on field.enum. String member symbol used as
- *  the extract fallback when an LLM sends a present-but-uncoercible value. Loader-validated
- *  to be one of the field's @values (ERR_BAD_ATTR_VALUE otherwise). */
-export const coerceDefaultAttr: AttrSchema = {
-  name: FIELD_ATTR_COERCE_DEFAULT,
-  valueType: ATTR_SUBTYPE_STRING,
-  required: false,
-  description:
-    "Fallback enum member used by tolerant extract when a present value cannot be coerced; must be one of the field's @values.",
-};
-
-/** FR-011: the @normalize attr — on field.enum (per-field) and object.value (object default).
- *  Closed enum (none|collapse|strip); controls the ASCII normalization applied during tolerant
- *  enum extract. Resolved field → owning object.value → global default (strip). */
-export const normalizeAttr: AttrSchema = {
-  name: FIELD_ATTR_NORMALIZE,
-  valueType: ATTR_SUBTYPE_STRING,
-  required: false,
-  default: NORMALIZE_DEFAULT,
-  allowedValues: [...NORMALIZE_MODES],
-  description:
-    "ASCII normalization mode for tolerant enum extract (none|collapse|strip, default strip). " +
-    "On field.enum it is per-field; on object.value it is the default for the object's enum fields.",
-};

package/src/core/identity/identity-schema.ts

@@ -1,80 +0,0 @@
-// Identity attribute schemas — per-subtype attr inventories for identity types.
-// Consumed by registerCoreTypes().
-
-import type { AttrSchema } from "../../registry.js";
-import {
-  ATTR_SUBTYPE_STRING,
-  ATTR_SUBTYPE_BOOLEAN,
-  ATTR_SUBTYPE_STRINGARRAY,
-} from "../attr/attr-constants.js";
-import {
-  IDENTITY_SUBTYPE_PRIMARY,
-  IDENTITY_SUBTYPE_SECONDARY,
-  IDENTITY_SUBTYPE_REFERENCE,
-  IDENTITY_ATTR_FIELDS,
-  IDENTITY_ATTR_GENERATION,
-  IDENTITY_ATTR_UNIQUE,
-  IDENTITY_REFERENCE_ATTR_REFERENCES,
-  IDENTITY_REFERENCE_ATTR_ENFORCE,
-  GENERATION_VALUES,
-} from "./identity-constants.js";
-
-/** Attrs on identity.primary / identity.secondary — @fields is required. */
-export const identityFieldsAttr: AttrSchema = {
-  name: IDENTITY_ATTR_FIELDS,
-  valueType: ATTR_SUBTYPE_STRINGARRAY,
-  required: true,
-  description:
-    "The field name(s) composing this identity. Single-element for a simple PK/index, multiple for a composite.",
-};
-
-const primaryIdentityAttrs: AttrSchema[] = [
-  { ...identityFieldsAttr },
-  {
-    name: IDENTITY_ATTR_GENERATION,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    allowedValues: [...GENERATION_VALUES],
-    description:
-      "Primary-key value generation strategy: 'increment' (auto-increment), 'uuid', or 'assigned' (caller-supplied).",
-  },
-];
-
-const secondaryIdentityAttrs: AttrSchema[] = [
-  { ...identityFieldsAttr },
-  {
-    name: IDENTITY_ATTR_UNIQUE,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description:
-      "When true (default), the secondary identity is a UNIQUE index; false makes it a plain (non-unique) index.",
-  },
-];
-
-const referenceIdentityAttrs: AttrSchema[] = [
-  { ...identityFieldsAttr },
-  {
-    name: IDENTITY_REFERENCE_ATTR_REFERENCES,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: true,
-    description:
-      "Target of the reference. Bare entity name (e.g. 'Program') resolves to that entity's primary identity. " +
-      "Dotted forms ('Program.id' or 'Program.fieldA,fieldB') target an explicit field set on the entity.",
-  },
-  {
-    name: IDENTITY_REFERENCE_ATTR_ENFORCE,
-    valueType: ATTR_SUBTYPE_BOOLEAN,
-    required: false,
-    description:
-      "When true (default), the backend physically enforces the reference (SQL FK constraint, " +
-      "document validation rule, graph edge guarantee). Set false to declare a logical reference " +
-      "for navigation/typing/codegen only — the value may dangle at the backend level.",
-  },
-];
-
-/** Attrs per identity subtype. primary adds @generation; secondary adds @unique. */
-export const IDENTITY_ATTRS_MAP = new Map<string, AttrSchema[]>([
-  [IDENTITY_SUBTYPE_PRIMARY, [...primaryIdentityAttrs]],
-  [IDENTITY_SUBTYPE_SECONDARY, [...secondaryIdentityAttrs]],
-  [IDENTITY_SUBTYPE_REFERENCE, [...referenceIdentityAttrs]],
-]);

package/src/core/object/object-schema.ts

@@ -1,35 +0,0 @@
-// Object attribute schemas — attrs common to every object subtype.
-// Consumed by registerCoreTypes().
-
-import type { AttrSchema } from "../../registry.js";
-import { ATTR_SUBTYPE_STRING } from "../attr/attr-constants.js";
-import {
-  OBJECT_ATTR_DISCRIMINATOR,
-  OBJECT_ATTR_DISCRIMINATOR_VALUE,
-} from "./object-constants.js";
-
-/** Attrs common to every object subtype. */
-export const objectAttrs: AttrSchema[] = [
-  {
-    name: OBJECT_ATTR_DISCRIMINATOR,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "FR-014: names the field on this entity (resolvable via extends:) that " +
-      "holds the subtype-discriminator value. Subtypes of this entity declare " +
-      "@discriminatorValue to bind their rows to a discriminator value. The " +
-      "discriminator field itself is an ordinary field declaration (typically " +
-      "field.enum or field.int / field.string).",
-  },
-  {
-    name: OBJECT_ATTR_DISCRIMINATOR_VALUE,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "FR-014: on a subtype of an entity with @discriminator — the value that " +
-      "identifies rows of this subtype in the shared discriminator field. Wire " +
-      "form is always a string; the underlying field's subtype (enum / int / " +
-      "string) controls codegen + storage coercion. Required on every concrete " +
-      "subtype of a discriminated entity.",
-  },
-];

package/src/core/relationship/relationship-schema.ts

@@ -1,67 +0,0 @@
-// Relationship attribute schemas — attrs common to every relationship subtype.
-// Consumed by registerCoreTypes().
-
-import type { AttrSchema } from "../../registry.js";
-import {
-  ATTR_SUBTYPE_STRING,
-  ATTR_SUBTYPE_STRINGARRAY,
-} from "../attr/attr-constants.js";
-import {
-  RELATIONSHIP_ATTR_CARDINALITY,
-  RELATIONSHIP_ATTR_OBJECT_REF,
-  RELATIONSHIP_ATTR_JOIN_ENTITY,
-  RELATIONSHIP_ATTR_JOIN_FIELDS,
-  RELATIONSHIP_ATTR_ON_DELETE,
-  RELATIONSHIP_ATTR_ON_UPDATE,
-  REFERENTIAL_ACTIONS,
-} from "./relationship-constants.js";
-
-/** Attrs common to every relationship subtype. */
-export const relationshipAttrs: AttrSchema[] = [
-  {
-    name: RELATIONSHIP_ATTR_CARDINALITY,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    // No allowedValues: @cardinality is an open string at the metamodel level
-    // (MetaRelationship.cardinality returns `string | undefined`). The Java
-    // canonical fixtures use composite forms such as "many-to-one"; the
-    // CARDINALITY_VALUES ("one"/"many") constant is a TS codegen convenience,
-    // NOT a closed metamodel enum. A3 must not reject the Java-canonical values.
-    description:
-      "Cardinality of the relationship target (e.g. 'one', 'many', 'many-to-one').",
-  },
-  {
-    name: RELATIONSHIP_ATTR_OBJECT_REF,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "Name or fully-qualified name of the target object the relationship points to (e.g. 'Week' or 'acme::vehicle::Car').",
-  },
-  {
-    name: RELATIONSHIP_ATTR_JOIN_ENTITY,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description: "Join-table entity name for N:M relationships.",
-  },
-  {
-    name: RELATIONSHIP_ATTR_JOIN_FIELDS,
-    valueType: ATTR_SUBTYPE_STRINGARRAY,
-    required: false,
-    description: "Join-table column names for N:M relationships.",
-  },
-  {
-    name: RELATIONSHIP_ATTR_ON_DELETE,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    allowedValues: [...REFERENTIAL_ACTIONS],
-    description:
-      "Referential action on parent delete. Default derives from subtype (composition→cascade, aggregation→set-null, association→restrict).",
-  },
-  {
-    name: RELATIONSHIP_ATTR_ON_UPDATE,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    allowedValues: [...REFERENTIAL_ACTIONS],
-    description: "Referential action on key update. Default cascade.",
-  },
-];

package/src/core/validator/validator-schema.ts

@@ -1,50 +0,0 @@
-// Validator attribute schemas — per-subtype attr inventories for validator types.
-// Consumed by registerCoreTypes().
-
-import type { AttrSchema } from "../../registry.js";
-import { ATTR_SUBTYPE_INT, ATTR_SUBTYPE_STRING } from "../attr/attr-constants.js";
-import { SUBTYPE_BASE } from "../../shared/base-types.js";
-import {
-  VALIDATOR_SUBTYPE_REQUIRED,
-  VALIDATOR_SUBTYPE_LENGTH,
-  VALIDATOR_SUBTYPE_REGEX,
-  VALIDATOR_SUBTYPE_NUMERIC,
-  VALIDATOR_SUBTYPE_ARRAY,
-  VALIDATOR_ATTR_PATTERN,
-  VALIDATOR_ATTR_MIN,
-  VALIDATOR_ATTR_MAX,
-} from "./validator-constants.js";
-
-/** @min / @max shared by length, numeric, array, and the base validator. */
-const minMaxValidatorAttrs: AttrSchema[] = [
-  {
-    name: VALIDATOR_ATTR_MIN,
-    valueType: ATTR_SUBTYPE_INT,
-    required: false,
-    description: "Minimum allowed value (length, numeric value, or array element count depending on the validator subtype).",
-  },
-  {
-    name: VALIDATOR_ATTR_MAX,
-    valueType: ATTR_SUBTYPE_INT,
-    required: false,
-    description: "Maximum allowed value (length, numeric value, or array element count depending on the validator subtype).",
-  },
-];
-
-/** Attrs per validator subtype. Required uses none; regex adds @pattern. */
-export const VALIDATOR_ATTRS_MAP = new Map<string, AttrSchema[]>([
-  [SUBTYPE_BASE, [...minMaxValidatorAttrs]],
-  [VALIDATOR_SUBTYPE_REQUIRED, []],
-  [VALIDATOR_SUBTYPE_LENGTH, [...minMaxValidatorAttrs]],
-  [VALIDATOR_SUBTYPE_REGEX, [
-    ...minMaxValidatorAttrs,
-    {
-      name: VALIDATOR_ATTR_PATTERN,
-      valueType: ATTR_SUBTYPE_STRING,
-      required: false,
-      description: "Regular expression the value must match.",
-    },
-  ]],
-  [VALIDATOR_SUBTYPE_NUMERIC, [...minMaxValidatorAttrs]],
-  [VALIDATOR_SUBTYPE_ARRAY, [...minMaxValidatorAttrs]],
-]);

package/src/persistence/db/db-schema.ts

@@ -1,50 +0,0 @@
-// DB-domain attribute schemas — registered by dbProvider (db-provider.ts),
-// not the core metamodel.
-
-import type { AttrSchema } from "../../registry.js";
-import {
-  ATTR_SUBTYPE_STRING,
-  ATTR_SUBTYPE_BOOLEAN,
-} from "../../core/attr/attr-constants.js";
-import {
-  FIELD_ATTR_COLUMN,
-  FIELD_ATTR_DB_INDEXED,
-  FIELD_ATTR_DB_COLUMN_TYPE,
-  DB_COLUMN_TYPE_VALUES,
-} from "./db-constants.js";
-
-/** `@column` — column-name override on every field subtype (source.rdb). */
-export const columnSchema: AttrSchema = {
-  name: FIELD_ATTR_COLUMN,
-  valueType: ATTR_SUBTYPE_STRING,
-  required: false,
-  description:
-    "Physical column name for this field on an rdb source. Defaults to the field name via columnNamingStrategy.",
-};
-
-/** `@db.indexed` — suppress the @filterable-without-index warning; on every field subtype. */
-export const dbIndexedSchema: AttrSchema = {
-  name: FIELD_ATTR_DB_INDEXED,
-  valueType: ATTR_SUBTYPE_BOOLEAN,
-  required: false,
-  description:
-    "When true, suppress the @filterable-without-index Loader warning (the field is indexed by other means).",
-};
-
-/**
- * R6 Plan 2b: `@dbColumnType` — physical DB column-type override on every field
- * subtype. The legal value depends on the field's logical subtype, so the
- * subtype × value pairing is validated own-only by the loader
- * (validateAttrSchema → ERR_BAD_ATTR_VALUE), not by a flat `allowedValues` set.
- * The string valueType keeps the schema's type check intact.
- */
-export const dbColumnTypeSchema: AttrSchema = {
-  name: FIELD_ATTR_DB_COLUMN_TYPE,
-  valueType: ATTR_SUBTYPE_STRING,
-  required: false,
-  description:
-    "Physical DB column-type override (ADR-0013 escape hatch). Legal values are " +
-    `${DB_COLUMN_TYPE_VALUES.join(" | ")}, each legal only on a specific logical ` +
-    "field subtype (uuid/jsonb on field.string, timestamp_with_tz on field.timestamp). " +
-    "The logical field type and its native binding are unchanged.",
-};

package/src/persistence/origin/origin-schema.ts

@@ -1,80 +0,0 @@
-// Origin attribute schemas — per-subtype attr inventories for origin types.
-// Consumed by registerCoreTypes().
-
-import type { AttrSchema } from "../../registry.js";
-import { ATTR_SUBTYPE_STRING } from "../../core/attr/attr-constants.js";
-import { SUBTYPE_BASE } from "../../shared/base-types.js";
-import {
-  ORIGIN_SUBTYPE_PASSTHROUGH,
-  ORIGIN_SUBTYPE_AGGREGATE,
-  ORIGIN_SUBTYPE_COLLECTION,
-  ORIGIN_PASSTHROUGH_ATTR_FROM,
-  ORIGIN_PASSTHROUGH_ATTR_VIA,
-  ORIGIN_AGGREGATE_ATTR_AGG,
-  ORIGIN_AGGREGATE_ATTR_OF,
-  ORIGIN_AGGREGATE_ATTR_VIA,
-  ORIGIN_COLLECTION_ATTR_VIA,
-  AGGREGATE_FUNCTIONS,
-} from "./origin-constants.js";
-
-/** Attrs on origin.passthrough — @from is required. */
-const passthroughOriginAttrs: AttrSchema[] = [
-  {
-    name: ORIGIN_PASSTHROUGH_ATTR_FROM,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: true,
-    description:
-      "Dotted Entity.field reference identifying the source value this projection field passes through (e.g. 'Program.title').",
-  },
-  {
-    name: ORIGIN_PASSTHROUGH_ATTR_VIA,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: false,
-    description:
-      "Optional dotted relationship path used to reach the source entity (e.g. 'Program.weeks').",
-  },
-];
-
-/** Attrs on origin.aggregate — @agg, @of, @via all required. */
-const aggregateOriginAttrs: AttrSchema[] = [
-  {
-    name: ORIGIN_AGGREGATE_ATTR_AGG,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: true,
-    allowedValues: [...AGGREGATE_FUNCTIONS],
-    description: "Aggregate function applied over the relationship path: count, sum, avg, min, or max.",
-  },
-  {
-    name: ORIGIN_AGGREGATE_ATTR_OF,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: true,
-    description:
-      "Dotted Entity.field reference identifying the column being aggregated (e.g. 'Week.durationMinutes').",
-  },
-  {
-    name: ORIGIN_AGGREGATE_ATTR_VIA,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: true,
-    description:
-      "Dotted relationship path from the base entity to the aggregated rows (e.g. 'Program.weeks' or 'Program.weeks.workouts').",
-  },
-];
-
-/** Attrs on origin.collection — @via (the relationship path) is required. */
-const collectionOriginAttrs: AttrSchema[] = [
-  {
-    name: ORIGIN_COLLECTION_ATTR_VIA,
-    valueType: ATTR_SUBTYPE_STRING,
-    required: true,
-    description:
-      "Dotted relationship path the collection walks to produce an array of nested view-objects (e.g. 'Author.posts'), or a wildcard selector for a package-spanning collection (e.g. '*.User').",
-  },
-];
-
-/** Attrs per origin subtype. base has none; the others carry their respective attrs. */
-export const ORIGIN_ATTRS_MAP = new Map<string, AttrSchema[]>([
-  [SUBTYPE_BASE, []],
-  [ORIGIN_SUBTYPE_PASSTHROUGH, [...passthroughOriginAttrs]],
-  [ORIGIN_SUBTYPE_AGGREGATE, [...aggregateOriginAttrs]],
-  [ORIGIN_SUBTYPE_COLLECTION, [...collectionOriginAttrs]],
-]);