@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/core-attr-schemas.js

@@ -0,0 +1,324 @@
+// Attribute schemas — Phase A2.
+//
+// Per (type, subType) attr inventories consumed by registerCoreTypes()
+// (core-types.ts) and the A3 validation pass (attr-schema-validate.ts).
+//
+// Sourced from constants.ts (attr names), the src/meta/* node accessors (which
+// attrs each subtype reads), the conformance fixtures (real usage + `required`
+// determination), and CLAUDE.md (descriptions, defaults, allowedValues).
+//
+// `required: true` is reserved for attrs that EVERY conformance fixture with
+// that subtype supplies AND that are semantically mandatory. Everything else
+// is `required: false` (Phase A3 validation depends on this being conservative).
+//
+// This module is pure declarative data — no logic, no registration. It is
+// split out of core-types.ts purely so the registration logic stays readable.
+import { SUBTYPE_BASE, VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_SUBTYPE_LENGTH, VALIDATOR_SUBTYPE_REGEX, VALIDATOR_SUBTYPE_NUMERIC, VALIDATOR_SUBTYPE_ARRAY, IDENTITY_SUBTYPE_PRIMARY, IDENTITY_SUBTYPE_SECONDARY, IDENTITY_SUBTYPE_REFERENCE, ORIGIN_SUBTYPE_PASSTHROUGH, ORIGIN_SUBTYPE_AGGREGATE, 
+// attr-subtype value-type constants
+ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_INT, ATTR_SUBTYPE_BOOLEAN, ATTR_SUBTYPE_STRINGARRAY, 
+// attr-name constants
+FIELD_ATTR_OBJECT_REF, FIELD_ATTR_REQUIRED, 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, IDENTITY_ATTR_FIELDS, IDENTITY_ATTR_GENERATION, IDENTITY_ATTR_UNIQUE, IDENTITY_REFERENCE_ATTR_REFERENCES, IDENTITY_REFERENCE_ATTR_ENFORCE, GENERATION_VALUES, RELATIONSHIP_ATTR_CARDINALITY, RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_JOIN_ENTITY, RELATIONSHIP_ATTR_JOIN_FIELDS, VALIDATOR_ATTR_PATTERN, VALIDATOR_ATTR_MIN, VALIDATOR_ATTR_MAX, AUTO_SET_VALUES, SORT_ORDER_VALUES, OBJECT_JAVA_RUNTIME_VALUES, OBJECT_ATTR_JAVA_RUNTIME, ORIGIN_PASSTHROUGH_ATTR_FROM, ORIGIN_PASSTHROUGH_ATTR_VIA, ORIGIN_AGGREGATE_ATTR_AGG, ORIGIN_AGGREGATE_ATTR_OF, ORIGIN_AGGREGATE_ATTR_VIA, AGGREGATE_FUNCTIONS, LAYOUT_DATA_GRID_ATTR_PAGE_SIZE, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER, LAYOUT_DATA_GRID_ATTR_FILTERABLE, LAYOUT_DATA_GRID_ATTR_FILTER, LAYOUT_DATA_GRID_ATTR_COLUMNS, VIEW_CURRENCY_ATTR_LOCALE, VIEW_CURRENCY_ATTR_LOCALE_DEFAULT, } from "./constants.js";
+/** Attrs common to every field subtype (codegen-ts column mapper + Project D filter/sort). */
+export const commonFieldAttrs = [
+    {
+        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_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_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.",
+    },
+];
+/** The @currency attr — only on field.currency. */
+export const currencyFieldAttr = {
+    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.",
+};
+/** Attrs on view.currency. */
+export const currencyViewAttrs = [
+    {
+        name: VIEW_CURRENCY_ATTR_LOCALE,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        default: VIEW_CURRENCY_ATTR_LOCALE_DEFAULT,
+        description: "BCP 47 locale code controlling currency display formatting. Defaults to 'en-US' when omitted.",
+    },
+];
+/** Attrs common to every object subtype. */
+export const objectAttrs = [
+    {
+        name: OBJECT_ATTR_JAVA_RUNTIME,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        allowedValues: [...OBJECT_JAVA_RUNTIME_VALUES],
+        description: "Java runtime materialization strategy for this object (pojo / map / proxy). Ignored by non-Java implementations.",
+    },
+];
+/** Attrs common to every relationship subtype. */
+export const relationshipAttrs = [
+    {
+        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.",
+    },
+];
+/** Attrs on identity.primary / identity.secondary — @fields is required. */
+export const identityFieldsAttr = {
+    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 = [
+    { ...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 = [
+    { ...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 = [
+    { ...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 on origin.passthrough — @from is required. */
+const passthroughOriginAttrs = [
+    {
+        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 = [
+    {
+        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 layout.dataGrid. */
+export const dataGridLayoutAttrs = [
+    {
+        name: LAYOUT_DATA_GRID_ATTR_PAGE_SIZE,
+        valueType: ATTR_SUBTYPE_INT,
+        required: false,
+        description: "Number of rows per page in the generated data grid.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        description: "Field name the grid is sorted by on initial render. Must reference an actual field on the entity.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        allowedValues: [...SORT_ORDER_VALUES],
+        description: "Initial sort direction for the default sort field: 'asc' or 'desc'.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_FILTERABLE,
+        valueType: ATTR_SUBTYPE_BOOLEAN,
+        required: false,
+        description: "When true, the generated grid exposes column filtering UI.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_FILTER,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        description: "JSON-encoded preset filter applied to the grid at the metadata level.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_COLUMNS,
+        valueType: ATTR_SUBTYPE_STRINGARRAY,
+        required: false,
+        description: "Flat ordered list of field names to display as grid columns.",
+    },
+];
+/** @min / @max shared by length, numeric, array, and the base validator. */
+const minMaxValidatorAttrs = [
+    {
+        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 origin subtype. base has none; passthrough and aggregate carry their respective attrs. */
+export const ORIGIN_ATTRS_MAP = new Map([
+    [SUBTYPE_BASE, []],
+    [ORIGIN_SUBTYPE_PASSTHROUGH, [...passthroughOriginAttrs]],
+    [ORIGIN_SUBTYPE_AGGREGATE, [...aggregateOriginAttrs]],
+]);
+/** Attrs per identity subtype. primary adds @generation; secondary adds @unique. */
+export const IDENTITY_ATTRS_MAP = new Map([
+    [IDENTITY_SUBTYPE_PRIMARY, [...primaryIdentityAttrs]],
+    [IDENTITY_SUBTYPE_SECONDARY, [...secondaryIdentityAttrs]],
+    [IDENTITY_SUBTYPE_REFERENCE, [...referenceIdentityAttrs]],
+]);
+/** Attrs per validator subtype. Required uses none; regex adds @pattern. */
+export const VALIDATOR_ATTRS_MAP = new Map([
+    [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]],
+]);
+//# sourceMappingURL=core-attr-schemas.js.map

package/dist/core-attr-schemas.js.map

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

package/dist/core-types.d.ts

@@ -0,0 +1,20 @@
+import { TypeRegistry } from "./registry.js";
+import type { MetaDataTypeProvider } from "./provider.js";
+import "./core/attr/meta-attr-stringarray.js";
+import "./core/attr/meta-attr-filter.js";
+import "./core/attr/meta-attr-properties.js";
+/**
+ * The core metaobjects metamodel — the seven base types (object, field, attr,
+ * validator, view, identity, relationship) plus layout / source / origin and
+ * the metadata root. One provider per package: this is `@metaobjectsdev/metadata`'s.
+ */
+export declare const coreTypesProvider: MetaDataTypeProvider;
+/** The default provider bundle — core metamodel types plus DB-domain attrs.
+ *  Spread it to add more: `[...coreProviders, mine]`. */
+export declare const coreProviders: readonly MetaDataTypeProvider[];
+/**
+ * Register the core metamodel into an existing registry. Thin convenience
+ * wrapper over `coreTypesProvider`; prefer `composeRegistry(coreProviders)`.
+ */
+export declare function registerCoreTypes(registry: TypeRegistry): void;
+//# sourceMappingURL=core-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-types.d.ts","sourceRoot":"","sources":["../src/core-types.ts"],"names":[],"mappings":"AACA,OAAO,EAAgE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAY1D,OAAO,sCAAsC,CAAC;AAC9C,OAAO,iCAAiC,CAAC;AACzC,OAAO,qCAAqC,CAAC;AAiS7C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,oBAM/B,CAAC;AAEF;yDACyD;AACzD,eAAO,MAAM,aAAa,EAAE,SAAS,oBAAoB,EAAoC,CAAC;AAE9F;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE9D"}

package/dist/core-types.js

@@ -0,0 +1,225 @@
+// registerCoreTypes() — Java's 7 base types (plus metadata wrapper) and their subtypes
+import { TypeId, TypeRegistry } from "./registry.js";
+import { dbProvider } from "./persistence/db/db-provider.js";
+import {} from "./data-type.js";
+import { MetaRoot } from "./shared/meta-root.js";
+import { MetaObject } from "./core/object/meta-object.js";
+import { MetaField } from "./core/field/meta-field.js";
+import { attrClassFor } from "./attr-class-map.js";
+// Import the attr subclasses for their self-registration side effect (each
+// registers its subtype → class into attr-class-map at module load), so
+// attrClassFor resolves the right class below. The base MetaAttr (the fallback)
+// registers itself; importing a subclass transitively loads meta-attr.ts.
+import "./core/attr/meta-attr-stringarray.js";
+import "./core/attr/meta-attr-filter.js";
+import "./core/attr/meta-attr-properties.js";
+import { MetaValidator, MetaRequiredValidator, MetaLengthValidator, MetaRegexValidator, MetaNumericValidator, MetaArrayValidator, } from "./core/validator/meta-validator.js";
+import { MetaView } from "./presentation/view/meta-view.js";
+import { MetaIdentity, MetaPrimaryIdentity, MetaSecondaryIdentity, MetaReferenceIdentity, } from "./core/identity/meta-identity.js";
+import { MetaRelationship } from "./core/relationship/meta-relationship.js";
+import { MetaLayout } from "./presentation/layout/meta-layout.js";
+import { MetaSource } from "./persistence/source/meta-source.js";
+import { MetaOrigin, MetaPassthroughOrigin, MetaAggregateOrigin } from "./persistence/origin/meta-origin.js";
+import { commonFieldAttrs, currencyFieldAttr } from "./core/field/field-schema.js";
+import { objectAttrs } from "./core/object/object-schema.js";
+import { relationshipAttrs } from "./core/relationship/relationship-schema.js";
+import { identityFieldsAttr, IDENTITY_ATTRS_MAP } from "./core/identity/identity-schema.js";
+import { VALIDATOR_ATTRS_MAP } from "./core/validator/validator-schema.js";
+import { currencyViewAttrs } from "./presentation/view/view-schema.js";
+import { dataGridLayoutAttrs } from "./presentation/layout/layout-schema.js";
+import { ORIGIN_ATTRS_MAP } from "./persistence/origin/origin-schema.js";
+import { TYPE_METADATA, TYPE_OBJECT, TYPE_FIELD, TYPE_ATTR, TYPE_VALIDATOR, TYPE_VIEW, TYPE_IDENTITY, TYPE_RELATIONSHIP, TYPE_LAYOUT, TYPE_SOURCE, TYPE_ORIGIN, SUBTYPE_ROOT, } from "./shared/base-types.js";
+import { CHILD_RULE_WILDCARD } from "./shared/structural.js";
+import { OBJECT_SUBTYPES, OBJECT_SUBTYPE_ENTITY } from "./core/object/object-constants.js";
+import { FIELD_SUBTYPES, FIELD_SUBTYPE_CURRENCY } from "./core/field/field-constants.js";
+import { ATTR_SUBTYPES } from "./core/attr/attr-constants.js";
+import { VALIDATOR_SUBTYPES, VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_SUBTYPE_LENGTH, VALIDATOR_SUBTYPE_REGEX, VALIDATOR_SUBTYPE_NUMERIC, VALIDATOR_SUBTYPE_ARRAY, } from "./core/validator/validator-constants.js";
+import { VIEW_SUBTYPES, VIEW_SUBTYPE_CURRENCY, } from "./presentation/view/view-constants.js";
+import { IDENTITY_SUBTYPES, IDENTITY_SUBTYPE_PRIMARY, IDENTITY_SUBTYPE_SECONDARY, IDENTITY_SUBTYPE_REFERENCE, } from "./core/identity/identity-constants.js";
+import { RELATIONSHIP_SUBTYPES } from "./core/relationship/relationship-constants.js";
+import { LAYOUT_SUBTYPES, LAYOUT_SUBTYPE_DATA_GRID } from "./presentation/layout/layout-constants.js";
+import { SOURCE_SUBTYPES } from "./persistence/source/source-constants.js";
+import { ORIGIN_SUBTYPES, ORIGIN_SUBTYPE_PASSTHROUGH, ORIGIN_SUBTYPE_AGGREGATE, } from "./persistence/origin/origin-constants.js";
+// ---------------------------------------------------------------------------
+// The per-(type, subType) attribute schemas live in per-concern *-schema.ts
+// modules (e.g. core/field/field-schema.ts, persistence/origin/origin-schema.ts).
+// This file keeps only the registration logic: the def() helper, the
+// subtype→class dispatch maps, and registerCoreTypes() itself.
+// ---------------------------------------------------------------------------
+function wildcard(childType) {
+    return {
+        childType,
+        childSubType: CHILD_RULE_WILDCARD,
+        childName: CHILD_RULE_WILDCARD,
+    };
+}
+function def(type, subType, description, childRules, NodeClass, attributes = [], dataType) {
+    const definition = {
+        typeId: new TypeId(type, subType),
+        description,
+        factory: (typeId, name) => {
+            const node = new NodeClass(typeId, name);
+            if (dataType !== undefined)
+                node.setDataType(dataType);
+            return node;
+        },
+        childRules,
+        attributes,
+    };
+    if (dataType !== undefined)
+        definition.dataType = dataType;
+    return definition;
+}
+/** Map from validator subtype string → concrete node constructor. */
+const VALIDATOR_CLASS_MAP = new Map([
+    [VALIDATOR_SUBTYPE_REQUIRED, MetaRequiredValidator],
+    [VALIDATOR_SUBTYPE_LENGTH, MetaLengthValidator],
+    [VALIDATOR_SUBTYPE_REGEX, MetaRegexValidator],
+    [VALIDATOR_SUBTYPE_NUMERIC, MetaNumericValidator],
+    [VALIDATOR_SUBTYPE_ARRAY, MetaArrayValidator],
+]);
+/** Map from identity subtype string → concrete node constructor. */
+const IDENTITY_CLASS_MAP = new Map([
+    [IDENTITY_SUBTYPE_PRIMARY, MetaPrimaryIdentity],
+    [IDENTITY_SUBTYPE_SECONDARY, MetaSecondaryIdentity],
+    [IDENTITY_SUBTYPE_REFERENCE, MetaReferenceIdentity],
+]);
+/** Map from origin subtype string → concrete node constructor. */
+const ORIGIN_CLASS_MAP = new Map([
+    [ORIGIN_SUBTYPE_PASSTHROUGH, MetaPassthroughOrigin],
+    [ORIGIN_SUBTYPE_AGGREGATE, MetaAggregateOrigin],
+]);
+// ATTR_CLASS_MAP + attrClassFor live in the leaf module ./attr-class-map.ts
+// (imported above) so MetaData.setAttr can resolve an attr subclass without
+// importing this module — that import created a module-eval cycle. They are
+// re-exported from the package index for the same public surface.
+function registerCoreTypeDefs(registry) {
+    // metadata — 1 subtype (the document root: metadata.root)
+    registry.register(def(TYPE_METADATA, SUBTYPE_ROOT, "Root metadata document", [
+        wildcard(TYPE_OBJECT),
+        wildcard(TYPE_FIELD),
+        wildcard(TYPE_ATTR),
+        wildcard(TYPE_VALIDATOR),
+    ], MetaRoot));
+    // object — 4 subtypes
+    const objectRules = [
+        wildcard(TYPE_FIELD),
+        wildcard(TYPE_IDENTITY),
+        wildcard(TYPE_RELATIONSHIP),
+        wildcard(TYPE_VALIDATOR),
+        wildcard(TYPE_LAYOUT),
+        wildcard(TYPE_SOURCE),
+        wildcard(TYPE_ATTR),
+    ];
+    for (const subType of OBJECT_SUBTYPES) {
+        registry.register(def(TYPE_OBJECT, subType, `Object/entity (${subType})`, objectRules, MetaObject, [...objectAttrs]));
+    }
+    // field — 13 subtypes
+    const fieldRules = [
+        wildcard(TYPE_VALIDATOR),
+        wildcard(TYPE_VIEW),
+        wildcard(TYPE_ATTR),
+        wildcard(TYPE_ORIGIN),
+    ];
+    for (const subType of FIELD_SUBTYPES) {
+        // field.currency additionally carries @currency; all other field subtypes
+        // share the common codegen/filter attrs only.
+        const fieldAttrs = subType === FIELD_SUBTYPE_CURRENCY
+            ? [...commonFieldAttrs, { ...currencyFieldAttr }]
+            : [...commonFieldAttrs];
+        registry.register(def(TYPE_FIELD, subType, `Field of type ${subType}`, fieldRules, MetaField, fieldAttrs, new MetaField(new TypeId(TYPE_FIELD, subType), "").dataType));
+    }
+    // attr — 9 subtypes, no children allowed. Each subtype's class owns its
+    // dataType (resolved by this.subType); we read it off a probe instance so the
+    // TypeDefinition.dataType contract (registry.find(...).dataType) still holds.
+    for (const subType of ATTR_SUBTYPES) {
+        const AttrClass = attrClassFor(subType);
+        const probeDataType = new AttrClass(new TypeId(TYPE_ATTR, subType), "").dataType;
+        registry.register(def(TYPE_ATTR, subType, `Attribute of type ${subType}`, [], AttrClass, [], probeDataType));
+    }
+    // validator — 6 subtypes (base + 5 named); dispatch to subtype-specific class.
+    // Subtype→class dispatch for TYPE_VALIDATOR (formerly handled by metaOf()):
+    //   required → MetaRequiredValidator, length → MetaLengthValidator,
+    //   regex → MetaRegexValidator, numeric → MetaNumericValidator,
+    //   array → MetaArrayValidator, default (base) → MetaValidator.
+    // Attr schemas: MetaValidator (base) + length/numeric/array read @min/@max via
+    //   this.ownAttr(VALIDATOR_ATTR_MIN/MAX); regex also reads @pattern via this.ownAttr().
+    //   required has no extra attrs.
+    const validatorRules = [wildcard(TYPE_ATTR)];
+    for (const subType of VALIDATOR_SUBTYPES) {
+        const NodeClass = VALIDATOR_CLASS_MAP.get(subType) ?? MetaValidator;
+        const validatorAttrs = VALIDATOR_ATTRS_MAP.get(subType) ?? [];
+        registry.register(def(TYPE_VALIDATOR, subType, `Validator (${subType})`, validatorRules, NodeClass, validatorAttrs));
+    }
+    // view — N subtypes. Each view permits only attr children (Java parity:
+    // MetaView only attaches to fields, never aggregates child views).
+    // Only view.currency carries a documented attr (@locale); others have none.
+    for (const subType of VIEW_SUBTYPES) {
+        const viewAttrs = subType === VIEW_SUBTYPE_CURRENCY ? [...currencyViewAttrs] : [];
+        registry.register(def(TYPE_VIEW, subType, `View (${subType})`, [wildcard(TYPE_ATTR)], MetaView, viewAttrs));
+    }
+    // layout — object-level UI surfaces (data grids, forms, tabs, cards).
+    // Each subtype permits only attr children — like views, layouts are config carriers.
+    for (const subType of LAYOUT_SUBTYPES) {
+        const layoutAttrs = subType === LAYOUT_SUBTYPE_DATA_GRID ? [...dataGridLayoutAttrs] : [];
+        registry.register(def(TYPE_LAYOUT, subType, `Layout (${subType})`, [wildcard(TYPE_ATTR)], MetaLayout, layoutAttrs));
+    }
+    // source — declares where an object's data lives (dbTable, dbView, ...).
+    // Only attr children; sources carry only configuration, never nested structure.
+    // DB-domain attrs (@name) are added by dbProvider via TypeRegistry.extend.
+    for (const subType of SOURCE_SUBTYPES) {
+        registry.register(def(TYPE_SOURCE, subType, `Source (${subType})`, [wildcard(TYPE_ATTR)], MetaSource, []));
+    }
+    // origin — field-level provenance. Only attr children.
+    // Subtype→class dispatch (mirrors validator / identity patterns):
+    //   passthrough → MetaPassthroughOrigin, aggregate → MetaAggregateOrigin,
+    //   base (and any unmapped subtype) → MetaOrigin.
+    for (const subType of ORIGIN_SUBTYPES) {
+        const NodeClass = ORIGIN_CLASS_MAP.get(subType) ?? MetaOrigin;
+        const originAttrs = ORIGIN_ATTRS_MAP.get(subType) ?? [];
+        registry.register(def(TYPE_ORIGIN, subType, `Origin (${subType})`, [wildcard(TYPE_ATTR)], NodeClass, originAttrs));
+    }
+    // identity — 2 subtypes (no base; Java doesn't register one).
+    // Subtype→class dispatch for TYPE_IDENTITY (formerly handled by metaOf()):
+    //   primary → MetaPrimaryIdentity, secondary → MetaSecondaryIdentity,
+    //   default → MetaIdentity (fallback, not currently registered).
+    for (const subType of IDENTITY_SUBTYPES) {
+        const NodeClass = IDENTITY_CLASS_MAP.get(subType) ?? MetaIdentity;
+        const idAttrs = IDENTITY_ATTRS_MAP.get(subType) ?? [{ ...identityFieldsAttr }];
+        registry.register(def(TYPE_IDENTITY, subType, `Identity (${subType})`, [wildcard(TYPE_ATTR)], NodeClass, idAttrs));
+    }
+    // relationship — 4 subtypes
+    for (const subType of RELATIONSHIP_SUBTYPES) {
+        registry.register(def(TYPE_RELATIONSHIP, subType, `Relationship (${subType})`, [wildcard(TYPE_ATTR)], MetaRelationship, [...relationshipAttrs]));
+    }
+    // Default subTypes for YAML authoring sugar: a bare `metadata:` / `object:`
+    // key resolves to these. `metadata` has exactly one subtype (root) so the
+    // default is unambiguous; `object` defaults to `entity`, the common case.
+    // Other types (field, validator, ...) have no default — authoring always
+    // writes the full `type.subType`.
+    registry.setDefaultSubType(TYPE_METADATA, SUBTYPE_ROOT);
+    registry.setDefaultSubType(TYPE_OBJECT, OBJECT_SUBTYPE_ENTITY);
+}
+/**
+ * The core metaobjects metamodel — the seven base types (object, field, attr,
+ * validator, view, identity, relationship) plus layout / source / origin and
+ * the metadata root. One provider per package: this is `@metaobjectsdev/metadata`'s.
+ */
+export const coreTypesProvider = {
+    id: "metaobjects-core-types",
+    description: "Core metaobjects metamodel types and subtypes.",
+    registerTypes(registry) {
+        registerCoreTypeDefs(registry);
+    },
+};
+/** The default provider bundle — core metamodel types plus DB-domain attrs.
+ *  Spread it to add more: `[...coreProviders, mine]`. */
+export const coreProviders = [coreTypesProvider, dbProvider];
+/**
+ * Register the core metamodel into an existing registry. Thin convenience
+ * wrapper over `coreTypesProvider`; prefer `composeRegistry(coreProviders)`.
+ */
+export function registerCoreTypes(registry) {
+    coreTypesProvider.registerTypes(registry);
+}
+//# sourceMappingURL=core-types.js.map

package/dist/core-types.js.map

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

package/dist/data-converter.d.ts

@@ -0,0 +1,17 @@
+import type { AttrValue } from "./shared/meta-data.js";
+import { type DataType } from "./data-type.js";
+/**
+ * Convert a raw parsed value to a valid AttrValue for a *known* DataType.
+ * Throws for input that cannot be a valid attr value (null / undefined /
+ * nested array). A plain object reaching a scalar branch is stringified by
+ * `String()` — callers that must reject objects use `toAttrValue`.
+ */
+export declare function convertToDataType(dataType: DataType, raw: unknown): AttrValue;
+/**
+ * Make a raw value a valid AttrValue with NO known type — for an undeclared
+ * `@`-attr. No type-directed conversion and no inference: scalars are stored
+ * as-is (a numeric-looking string stays a string), arrays become string[],
+ * objects/null/undefined are rejected.
+ */
+export declare function toAttrValue(raw: unknown): AttrValue;
+//# sourceMappingURL=data-converter.d.ts.map

package/dist/data-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-converter.d.ts","sourceRoot":"","sources":["../src/data-converter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,KAAK,QAAQ,EAMd,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,SAAS,CA0B7E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAOnD"}