@metaobjectsdev/metadata 0.5.0-rc.1

package/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other transformations
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of recording and
+      discussing modifications to the Work, but excluding communication that
+      is conspicuously marked or designated in writing by the copyright owner
+      as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contribution embodied within the Work constitutes direct or contributory
+      patent infringement, then any patent licenses granted to You under
+      this License for that Work shall terminate as of the date such
+      litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or in addition to the
+          NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, reproduce, modify,
+      prepare derivative works of, distribute, and sublicense such modifications,
+      as an additional requirement of this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may offer
+      only obligations consistent to this License provided that the
+      obligations are consistent with this License.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format in question. Also add information
+      on how to contact you electronically and/or by mail.
+
+      Copyright 2026 MetaObjects Contributors
+
+      Licensed under the Apache License, Version 2.0 (the "License");
+      you may not use this file except in compliance with the License.
+      You may obtain a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+      Unless required by applicable law or agreed to in writing, software
+      distributed under the License is distributed on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+      See the License for the specific language governing permissions and
+      limitations under the License.

package/README.md

@@ -0,0 +1,29 @@
+# @metaobjectsdev/metadata
+
+The metamodel loader, typed views, and constants for the MetaObjects standard. This is the foundation package every other `@metaobjectsdev/*` package builds on — it parses `metaobjects/*.json` files into a typed object model, resolves `extends` and overlay merging, and exposes the 11-type vocabulary as named constants.
+
+## Install
+
+```bash
+pnpm add @metaobjectsdev/metadata
+```
+
+## Usage
+
+```ts
+import { MetaDataLoader, InMemorySource } from "@metaobjectsdev/metadata";
+
+const json = `{ "metadata.root": { "package": "demo", "children": [] } }`;
+const result = await new MetaDataLoader().load([new InMemorySource(json)]);
+```
+
+The public loader API is `MetaDataLoader` + `InMemorySource`. A `MetaDataLoader` instance is single-use; construct a new one per load.
+
+## Links
+
+- [Spec](https://github.com/metaobjectsdev/metaobjects/tree/main/spec)
+- [Metamodel reference](https://github.com/metaobjectsdev/metaobjects/blob/main/spec/metamodel.md)
+
+## License
+
+Apache 2.0 — see [LICENSE](../../../../LICENSE) at the repo root.

package/dist/attr-class-map.d.ts

@@ -0,0 +1,26 @@
+import type { TypeId } from "./registry.js";
+import type { MetaData } from "./shared/meta-data.js";
+import type { MetaAttr } from "./core/attr/meta-attr.js";
+/** A general node constructor — kept assignable from AttrConstructor. */
+export type NodeConstructor = new (typeId: TypeId, name: string) => MetaData;
+/** A MetaAttr (sub)class constructor — narrower than NodeConstructor so callers
+ *  can read `.dataType` off a probe instance and store the result in a
+ *  Map<string, MetaAttr>. Assignable to NodeConstructor since MetaAttr extends
+ *  MetaData. MetaAttr is imported type-only here so this module stays free of
+ *  any meta-tree value import (type imports are erased — no eval cycle). */
+export type AttrConstructor = new (typeId: TypeId, name: string) => MetaAttr;
+/** Subtype → concrete attr subclass. Populated by each subclass at module load
+ *  via registerAttrClass. The base MetaAttr is the fallback for unmapped
+ *  (scalar/string) subtypes — see attrClassFor. */
+export declare const ATTR_CLASS_MAP: Map<string, AttrConstructor>;
+/** Register a subtype → subclass mapping. Called by each attr subclass module
+ *  at load time (`registerAttrClass(ATTR_SUBTYPE_X, XAttr)`). */
+export declare function registerAttrClass(subType: string, ctor: AttrConstructor): void;
+/** Register the base MetaAttr as the fallback for unmapped subtypes. Called once
+ *  by meta-attr.ts at load. */
+export declare function registerFallbackAttrClass(ctor: AttrConstructor): void;
+/** The concrete MetaAttr subclass for an attr subtype (default base MetaAttr).
+ *  Used by MetaData.setAttr to materialize an undeclared attr as the right
+ *  class, and by core-types to register the subtype's TypeDefinition. */
+export declare function attrClassFor(subType: string): AttrConstructor;
+//# sourceMappingURL=attr-class-map.d.ts.map

package/dist/attr-class-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-class-map.d.ts","sourceRoot":"","sources":["../src/attr-class-map.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;AAE7E;;;;4EAI4E;AAC5E,MAAM,MAAM,eAAe,GAAG,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;AAE7E;;mDAEmD;AACnD,eAAO,MAAM,cAAc,8BAAqC,CAAC;AAMjE;iEACiE;AACjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAE9E;AAED;+BAC+B;AAC/B,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAErE;AAED;;yEAEyE;AACzE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAY7D"}

package/dist/attr-class-map.js

@@ -0,0 +1,44 @@
+// attr-class-map — dependency-free registry mapping each attr subtype to its
+// concrete MetaAttr (sub)class.
+//
+// Why a registry (and not a static Map literal of class references): MetaData
+// (the base of every node, including MetaAttr) must resolve an attr subclass in
+// setAttr. If MetaData imported a module that imported the MetaAttr subclasses,
+// that closes a module-eval cycle (meta-data → <map> → meta-attr → meta-data)
+// and the `class MetaAttr extends MetaData` clause runs before MetaData is
+// initialized (TDZ). To break it, this module imports NOTHING from the meta
+// tree: each subclass registers ITSELF here (one self-registration line per
+// subclass — the Open-Closed seam), and meta-data.ts reads back through this
+// dependency-free leaf.
+/** Subtype → concrete attr subclass. Populated by each subclass at module load
+ *  via registerAttrClass. The base MetaAttr is the fallback for unmapped
+ *  (scalar/string) subtypes — see attrClassFor. */
+export const ATTR_CLASS_MAP = new Map();
+/** Fallback constructor for unmapped subtypes (the base MetaAttr). Registered
+ *  by meta-attr.ts at load so attrClassFor never returns undefined. */
+let fallbackAttrClass;
+/** Register a subtype → subclass mapping. Called by each attr subclass module
+ *  at load time (`registerAttrClass(ATTR_SUBTYPE_X, XAttr)`). */
+export function registerAttrClass(subType, ctor) {
+    ATTR_CLASS_MAP.set(subType, ctor);
+}
+/** Register the base MetaAttr as the fallback for unmapped subtypes. Called once
+ *  by meta-attr.ts at load. */
+export function registerFallbackAttrClass(ctor) {
+    fallbackAttrClass = ctor;
+}
+/** The concrete MetaAttr subclass for an attr subtype (default base MetaAttr).
+ *  Used by MetaData.setAttr to materialize an undeclared attr as the right
+ *  class, and by core-types to register the subtype's TypeDefinition. */
+export function attrClassFor(subType) {
+    const ctor = ATTR_CLASS_MAP.get(subType) ?? fallbackAttrClass;
+    if (ctor === undefined) {
+        throw new Error(`Attr classes are not registered (no fallback set, and no class for subType '${subType}'). ` +
+            `The MetaAttr subclasses self-register as a module side-effect; a deep direct import that ` +
+            `bypasses the package entry can run MetaData.setAttr before they load. ` +
+            `Import the package entry ("@metaobjectsdev/metadata") or register the core types ` +
+            `(registerCoreTypes) before constructing/loading metadata.`);
+    }
+    return ctor;
+}
+//# sourceMappingURL=attr-class-map.js.map

package/dist/attr-class-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-class-map.js","sourceRoot":"","sources":["../src/attr-class-map.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gCAAgC;AAChC,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,wBAAwB;AAgBxB;;mDAEmD;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEjE;uEACuE;AACvE,IAAI,iBAA8C,CAAC;AAEnD;iEACiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAqB;IACtE,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;+BAC+B;AAC/B,MAAM,UAAU,yBAAyB,CAAC,IAAqB;IAC7D,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED;;yEAEyE;AACzE,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC;IAC9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,+EAA+E,OAAO,MAAM;YAC1F,2FAA2F;YAC3F,wEAAwE;YACxE,mFAAmF;YACnF,2DAA2D,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/attr-schema-validate.d.ts

@@ -0,0 +1,9 @@
+import type { MetaData } from "./shared/meta-data.js";
+import { ParseError } from "./errors.js";
+import type { TypeRegistry } from "./registry.js";
+export interface AttrSchemaValidationResult {
+    errors: ParseError[];
+    warnings: string[];
+}
+export declare function validateAttrSchema(root: MetaData, registry: TypeRegistry): AttrSchemaValidationResult;
+//# sourceMappingURL=attr-schema-validate.d.ts.map

package/dist/attr-schema-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-schema-validate.d.ts","sourceRoot":"","sources":["../src/attr-schema-validate.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,YAAY,GACrB,0BAA0B,CAI5B"}

package/dist/attr-schema-validate.js

@@ -0,0 +1,100 @@
+// Phase A3 — attribute-schema validation pass.
+//
+// Consumes the per-(type, subType) attribute schema populated in core-types.ts
+// (Phase A2). For each node in the loaded typed tree, looks up
+// registry.attrsOf(node.type, node.subType) and checks the node's OWN
+// @-attributes against that schema:
+//
+//   1. Required attrs present       — every AttrSchema with required:true must
+//                                      have a matching attr on the node.
+//   2. Declared attrs well-typed    — for each @-attr ON the node that IS in the
+//                                      schema, its value must satisfy the
+//                                      MetaAttr instance's own validateValue.
+//   3. allowedValues honored        — declared attrs with a non-empty
+//                                      allowedValues set must hold a member value.
+//   4. Undeclared attrs             — NOT an error, NOT a warning (open policy).
+//
+// `default` values are NOT auto-applied — A3 is pure validation, not mutation.
+//
+// Checks 2+3 dispatch to the materialized MetaAttr instance: each attr is a
+// MetaAttr that owns validateValue(value): ValueError[] (resolved by its
+// subType, which the parser chose from the declared valueType). The central
+// value-shape helper + the per-shape subtype sets are gone — value-shape
+// knowledge now lives on the instance. The pass maps each ValueError to a
+// ParseError with the unchanged ERR_BAD_ATTR_VALUE code, so conformance
+// fixtures stay green.
+//
+// Modeled on src/subtype-rules.ts: a recursive walk producing an
+// { errors, warnings } result. All A3 findings are ERRORS; warnings stays [].
+import { ParseError } from "./errors.js";
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+export function validateAttrSchema(root, registry) {
+    const errors = [];
+    walk(root, registry, errors);
+    return { errors, warnings: [] };
+}
+function walk(node, registry, errors) {
+    validateNode(node, registry, errors);
+    for (const child of node.ownChildren()) {
+        walk(child, registry, errors);
+    }
+}
+/** A node label for error messages, e.g. `origin.aggregate 'weekCount'`. */
+function nodeLabel(node) {
+    const head = `${node.type}.${node.subType}`;
+    return node.name !== "" ? `${head} '${node.name}'` : head;
+}
+function validateNode(node, registry, errors) {
+    const schema = registry.attrsOf(node.type, node.subType);
+    if (schema.length === 0)
+        return;
+    // Index the schema by attr name for the declared-attr checks below.
+    const byName = new Map();
+    for (const spec of schema)
+        byName.set(spec.name, spec);
+    // --- Check 1: required attrs present ---
+    //
+    // Use attrs() (own + inherited via extends:) to determine presence.
+    // A node that legitimately inherits a required attr from its super must NOT be
+    // flagged as missing it — inherited attrs count as satisfying the requirement.
+    // Contrast with Checks 2+3 below, which iterate own attrs only: inherited attrs
+    // were already validated on the node that declared them, so re-checking would
+    // double-report. This mirrors the effective-vs-own split in subtype-rules.ts.
+    const effective = node.attrs();
+    for (const spec of schema) {
+        if (spec.required && !effective.has(spec.name)) {
+            errors.push(new ParseError(`${nodeLabel(node)} is missing required attribute '@${spec.name}'`, { code: "ERR_MISSING_REQUIRED_ATTR" }));
+        }
+    }
+    // --- Checks 2 + 3: declared attrs on the node are well-typed + in range ---
+    for (const inst of node.ownMetaAttrs()) {
+        const spec = byName.get(inst.name);
+        if (spec === undefined)
+            continue; // undeclared attr → open policy: ignore.
+        const value = inst.value;
+        if (value === undefined)
+            continue;
+        // Check 2: the instance validates its own value shape. When the declared
+        // valueType is absent (e.g. @default), skip — any AttrValue is valid.
+        if (spec.valueType !== undefined) {
+            const valueErrors = inst.validateValue(value);
+            if (valueErrors.length > 0) {
+                for (const ve of valueErrors) {
+                    errors.push(new ParseError(`${nodeLabel(node)} ${ve.message}`, { code: "ERR_BAD_ATTR_VALUE" }));
+                }
+                continue; // type wrong → skip allowedValues
+            }
+        }
+        // Check 3: allowedValues membership (unchanged).
+        if (spec.allowedValues !== undefined && spec.allowedValues.length > 0) {
+            if (!spec.allowedValues.includes(value)) {
+                errors.push(new ParseError(`${nodeLabel(node)} attribute '@${inst.name}' has value ` +
+                    `'${String(value)}' which is not one of the allowed values: ` +
+                    `${spec.allowedValues.map((v) => String(v)).join(", ")}`, { code: "ERR_BAD_ATTR_VALUE" }));
+            }
+        }
+    }
+}
+//# sourceMappingURL=attr-schema-validate.js.map

package/dist/attr-schema-validate.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,208 @@
+export declare const TYPE_METADATA = "metadata";
+export declare const TYPE_OBJECT = "object";
+export declare const TYPE_FIELD = "field";
+export declare const TYPE_ATTR = "attr";
+export declare const TYPE_VALIDATOR = "validator";
+export declare const TYPE_VIEW = "view";
+export declare const TYPE_IDENTITY = "identity";
+export declare const TYPE_RELATIONSHIP = "relationship";
+export declare const TYPE_LAYOUT = "layout";
+export declare const TYPE_SOURCE = "source";
+export declare const TYPE_ORIGIN = "origin";
+export declare const BASE_TYPES: readonly ["metadata", "object", "field", "attr", "validator", "view", "identity", "relationship", "layout", "source", "origin"];
+export type BaseType = (typeof BASE_TYPES)[number];
+export declare const SUBTYPE_BASE = "base";
+/**
+ * The metadata document root subtype. The root node is `metadata.root` in the
+ * canonical format. (Distinct from the universal SUBTYPE_BASE — the redesigned
+ * format spec confirms the root subtype is `root`, not `base`.)
+ */
+export declare const SUBTYPE_ROOT = "root";
+export declare const METADATA_SUBTYPES: readonly ["root"];
+export type MetadataSubType = (typeof METADATA_SUBTYPES)[number];
+export declare const OBJECT_SUBTYPE_ENTITY = "entity";
+export declare const OBJECT_SUBTYPE_VALUE = "value";
+export declare const OBJECT_SUBTYPES: readonly ["base", "entity", "value"];
+export type ObjectSubType = (typeof OBJECT_SUBTYPES)[number];
+export declare const FIELD_SUBTYPE_STRING = "string";
+export declare const FIELD_SUBTYPE_INT = "int";
+export declare const FIELD_SUBTYPE_SHORT = "short";
+export declare const FIELD_SUBTYPE_BYTE = "byte";
+export declare const FIELD_SUBTYPE_LONG = "long";
+export declare const FIELD_SUBTYPE_DOUBLE = "double";
+export declare const FIELD_SUBTYPE_FLOAT = "float";
+export declare const FIELD_SUBTYPE_DECIMAL = "decimal";
+export declare const FIELD_SUBTYPE_BOOLEAN = "boolean";
+export declare const FIELD_SUBTYPE_DATE = "date";
+export declare const FIELD_SUBTYPE_TIME = "time";
+export declare const FIELD_SUBTYPE_TIMESTAMP = "timestamp";
+export declare const FIELD_SUBTYPE_OBJECT = "object";
+export declare const FIELD_SUBTYPE_CLASS = "class";
+export declare const FIELD_SUBTYPE_CURRENCY = "currency";
+export declare const FIELD_SUBTYPES: readonly ["base", "string", "int", "short", "byte", "long", "double", "float", "decimal", "boolean", "date", "time", "timestamp", "object", "class", "currency"];
+export type FieldSubType = (typeof FIELD_SUBTYPES)[number];
+export declare const ATTR_SUBTYPE_STRING = "string";
+export declare const ATTR_SUBTYPE_INT = "int";
+export declare const ATTR_SUBTYPE_LONG = "long";
+export declare const ATTR_SUBTYPE_DOUBLE = "double";
+export declare const ATTR_SUBTYPE_BOOLEAN = "boolean";
+export declare const ATTR_SUBTYPE_CLASS = "class";
+export declare const ATTR_SUBTYPE_PROPERTIES = "properties";
+export declare const ATTR_SUBTYPE_STRINGARRAY = "stringarray";
+export declare const ATTR_SUBTYPES: readonly ["base", "string", "int", "long", "double", "boolean", "class", "properties", "stringarray"];
+export type AttrSubType = (typeof ATTR_SUBTYPES)[number];
+export declare const VALIDATOR_SUBTYPE_REQUIRED = "required";
+export declare const VALIDATOR_SUBTYPE_LENGTH = "length";
+export declare const VALIDATOR_SUBTYPE_REGEX = "regex";
+export declare const VALIDATOR_SUBTYPE_NUMERIC = "numeric";
+export declare const VALIDATOR_SUBTYPE_ARRAY = "array";
+export declare const VALIDATOR_SUBTYPES: readonly ["base", "required", "length", "regex", "numeric", "array"];
+export type ValidatorSubType = (typeof VALIDATOR_SUBTYPES)[number];
+export declare const VIEW_SUBTYPE_TEXT = "text";
+export declare const VIEW_SUBTYPE_TEXTAREA = "textarea";
+export declare const VIEW_SUBTYPE_DATE = "date";
+export declare const VIEW_SUBTYPE_MONTH = "month";
+export declare const VIEW_SUBTYPE_HOTLINK = "hotlink";
+export declare const VIEW_SUBTYPE_DROPDOWN = "dropdown";
+export declare const VIEW_SUBTYPE_RADIO = "radio";
+export declare const VIEW_SUBTYPE_CHECKBOX = "checkbox";
+export declare const VIEW_SUBTYPE_NUMBER = "number";
+export declare const VIEW_SUBTYPE_PASSWORD = "password";
+export declare const VIEW_SUBTYPE_HIDDEN = "hidden";
+export declare const VIEW_SUBTYPE_WEB = "web";
+export declare const VIEW_SUBTYPE_CURRENCY = "currency";
+export declare const VIEW_SUBTYPES: readonly ["base", "text", "textarea", "date", "month", "hotlink", "dropdown", "radio", "checkbox", "number", "password", "hidden", "web", "currency"];
+export type ViewSubType = (typeof VIEW_SUBTYPES)[number];
+export declare const LAYOUT_SUBTYPE_DATA_GRID = "dataGrid";
+export declare const LAYOUT_SUBTYPES: readonly ["base", "dataGrid"];
+export type LayoutSubType = (typeof LAYOUT_SUBTYPES)[number];
+export declare const LAYOUT_DATA_GRID_ATTR_PAGE_SIZE = "pageSize";
+export declare const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD = "defaultSortField";
+export declare const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER = "defaultSortOrder";
+export declare const LAYOUT_DATA_GRID_ATTR_FILTERABLE = "filterable";
+export declare const LAYOUT_DATA_GRID_ATTR_FILTER = "filter";
+export declare const LAYOUT_DATA_GRID_ATTR_COLUMNS = "columns";
+/** BCP 47 locale code on a view[currency]. Defaults to "en-US" when omitted. */
+export declare const VIEW_CURRENCY_ATTR_LOCALE = "locale";
+/** Default BCP 47 locale code when @locale is omitted on a view[currency]. */
+export declare const VIEW_CURRENCY_ATTR_LOCALE_DEFAULT = "en-US";
+export declare const IDENTITY_SUBTYPE_PRIMARY = "primary";
+export declare const IDENTITY_SUBTYPE_SECONDARY = "secondary";
+export declare const IDENTITY_SUBTYPE_REFERENCE = "reference";
+export declare const IDENTITY_SUBTYPES: readonly ["primary", "secondary", "reference"];
+export type IdentitySubType = (typeof IDENTITY_SUBTYPES)[number];
+export declare const RELATIONSHIP_SUBTYPE_ASSOCIATION = "association";
+export declare const RELATIONSHIP_SUBTYPE_AGGREGATION = "aggregation";
+export declare const RELATIONSHIP_SUBTYPE_COMPOSITION = "composition";
+export declare const RELATIONSHIP_SUBTYPES: readonly ["base", "association", "aggregation", "composition"];
+export type RelationshipSubType = (typeof RELATIONSHIP_SUBTYPES)[number];
+export declare const RESERVED_KEY_NAME = "name";
+export declare const RESERVED_KEY_PACKAGE = "package";
+export declare const RESERVED_KEY_EXTENDS = "extends";
+export declare const RESERVED_KEY_ABSTRACT = "abstract";
+export declare const RESERVED_KEY_OVERLAY = "overlay";
+export declare const RESERVED_KEY_IS_ARRAY = "isArray";
+export declare const RESERVED_KEY_CHILDREN = "children";
+/** attr-child-node body key carrying the typed value. */
+export declare const RESERVED_KEY_VALUE = "value";
+export declare const RESERVED_KEYS: Set<string>;
+export declare const JSON_KEY_SCHEMA = "$schema";
+export declare const ATTR_PREFIX = "@";
+/** Separator fusing type and subType in a node's wrapper key (`object.entity`). */
+export declare const TYPE_SUBTYPE_SEPARATOR = ".";
+/** Separator between package segments and between package and name. */
+export declare const PACKAGE_SEPARATOR = "::";
+/** Relative-reference "go up one level" marker. */
+export declare const PACKAGE_PARENT = "..";
+export declare const CHILD_RULE_WILDCARD = "*";
+export declare const IDENTITY_ATTR_FIELDS = "fields";
+export declare const IDENTITY_ATTR_GENERATION = "generation";
+/** On secondary identities: true → uniqueIndex; false/absent → index. Defaults to true for back-compat. */
+export declare const IDENTITY_ATTR_UNIQUE = "unique";
+/** Identity-reference attr: target entity (bare or dotted `Entity.field` / `Entity.fA,fB`). */
+export declare const IDENTITY_REFERENCE_ATTR_REFERENCES = "references";
+/** Identity-reference attr: physical-enforcement flag. Default true → hard FK constraint; false → logical-only reference. */
+export declare const IDENTITY_REFERENCE_ATTR_ENFORCE = "enforce";
+export declare const RELATIONSHIP_ATTR_CARDINALITY = "cardinality";
+export declare const RELATIONSHIP_ATTR_OBJECT_REF = "objectRef";
+export declare const RELATIONSHIP_ATTR_JOIN_ENTITY = "joinEntity";
+export declare const RELATIONSHIP_ATTR_JOIN_FIELDS = "joinFields";
+export declare const FIELD_ATTR_REQUIRED = "required";
+export declare const FIELD_ATTR_UNIQUE = "unique";
+export declare const FIELD_ATTR_DEFAULT = "default";
+export declare const FIELD_ATTR_MAX_LENGTH = "maxLength";
+export declare const FIELD_ATTR_DB_COLUMN = "dbColumn";
+export declare const FIELD_ATTR_PRECISION = "precision";
+export declare const FIELD_ATTR_SCALE = "scale";
+export declare const FIELD_ATTR_FILTERABLE = "filterable";
+export declare const FIELD_ATTR_SORTABLE = "sortable";
+export declare const FIELD_ATTR_SORTABLE_DEFAULT_ORDER = "sortableDefaultOrder";
+/** When true, suppress the @filterable-without-index Loader warning (Project D drift check). */
+export declare const FIELD_ATTR_DB_INDEXED = "db.indexed";
+/** ISO 4217 currency code on a currency-subtype field. Defaults to "USD" when omitted. */
+export declare const FIELD_ATTR_CURRENCY = "currency";
+/** Default ISO 4217 currency code when @currency is omitted on a currency field. */
+export declare const FIELD_ATTR_CURRENCY_DEFAULT = "USD";
+/** Auto-set semantics on a timestamp field. Values: "onCreate" | "onUpdate". */
+export declare const FIELD_ATTR_AUTO_SET = "autoSet";
+/** Name (or FQN) of the target object an object-typed field nests. Same wire
+ *  spelling as the relationship `@objectRef` — Java's single ATTR_OBJECT_REF. */
+export declare const FIELD_ATTR_OBJECT_REF = "objectRef";
+export declare const AUTO_SET_ON_CREATE = "onCreate";
+export declare const AUTO_SET_ON_UPDATE = "onUpdate";
+export declare const AUTO_SET_VALUES: readonly ["onCreate", "onUpdate"];
+export type AutoSetValue = (typeof AUTO_SET_VALUES)[number];
+export declare const SORT_ORDER_ASC = "asc";
+export declare const SORT_ORDER_DESC = "desc";
+export declare const SORT_ORDER_VALUES: readonly ["asc", "desc"];
+export type SortOrderValue = (typeof SORT_ORDER_VALUES)[number];
+export declare const OBJECT_JAVA_RUNTIME_POJO = "pojo";
+export declare const OBJECT_JAVA_RUNTIME_MAP = "map";
+export declare const OBJECT_JAVA_RUNTIME_PROXY = "proxy";
+export declare const OBJECT_JAVA_RUNTIME_VALUES: readonly ["pojo", "map", "proxy"];
+export type ObjectJavaRuntimeValue = (typeof OBJECT_JAVA_RUNTIME_VALUES)[number];
+export declare const VALIDATOR_ATTR_PATTERN = "pattern";
+export declare const VALIDATOR_ATTR_MIN = "min";
+export declare const VALIDATOR_ATTR_MAX = "max";
+export declare const GENERATION_INCREMENT = "increment";
+export declare const GENERATION_UUID = "uuid";
+export declare const GENERATION_ASSIGNED = "assigned";
+export declare const GENERATION_VALUES: readonly ["increment", "uuid", "assigned"];
+export type GenerationValue = (typeof GENERATION_VALUES)[number];
+export declare const CARDINALITY_ONE = "one";
+export declare const CARDINALITY_MANY = "many";
+export declare const CARDINALITY_VALUES: readonly ["one", "many"];
+export type CardinalityValue = (typeof CARDINALITY_VALUES)[number];
+export declare const FILTER_OPS: readonly ["eq", "ne", "gt", "gte", "lt", "lte", "in", "like", "isNull"];
+export type FilterOp = (typeof FILTER_OPS)[number];
+export declare const OPS_BY_SUBTYPE: Readonly<Record<string, readonly FilterOp[]>>;
+export declare function opsForSubType(subType: string): readonly FilterOp[];
+/** Java runtime strategy for an object. Values: "pojo" | "map" | "proxy". */
+export declare const OBJECT_ATTR_JAVA_RUNTIME = "javaRuntime";
+export declare const SOURCE_SUBTYPE_DB_TABLE = "dbTable";
+export declare const SOURCE_SUBTYPE_DB_VIEW = "dbView";
+export declare const SOURCE_SUBTYPES: readonly ["base", "dbTable", "dbView"];
+export type SourceSubType = (typeof SOURCE_SUBTYPES)[number];
+export declare const SOURCE_DB_TABLE_ATTR_NAME = "name";
+export declare const SOURCE_DB_VIEW_ATTR_NAME = "name";
+/** Shared @name attr key for MetaSource (covers both dbTable and dbView). Use this
+ *  in generic source accessors instead of the subtype-specific aliases above. */
+export declare const SOURCE_ATTR_NAME = "name";
+/** Optional DB schema attr on source[dbTable] / source[dbView]. Postgres uses
+ *  this to namespace tables/views. SQLite has no schema concept and rejects
+ *  any non-default value. Default for Postgres: "public". */
+export declare const SOURCE_ATTR_SCHEMA = "schema";
+/** Default Postgres schema when @schema is omitted from a source. */
+export declare const DEFAULT_DB_SCHEMA_POSTGRES = "public";
+export declare const ORIGIN_SUBTYPE_PASSTHROUGH = "passthrough";
+export declare const ORIGIN_SUBTYPE_AGGREGATE = "aggregate";
+export declare const ORIGIN_SUBTYPES: readonly ["base", "passthrough", "aggregate"];
+export type OriginSubType = (typeof ORIGIN_SUBTYPES)[number];
+export declare const ORIGIN_PASSTHROUGH_ATTR_FROM = "from";
+export declare const ORIGIN_PASSTHROUGH_ATTR_VIA = "via";
+export declare const ORIGIN_AGGREGATE_ATTR_AGG = "agg";
+export declare const ORIGIN_AGGREGATE_ATTR_OF = "of";
+export declare const ORIGIN_AGGREGATE_ATTR_VIA = "via";
+export declare const AGGREGATE_FUNCTIONS: readonly ["count", "sum", "avg", "min", "max"];
+export type AggregateFunction = (typeof AGGREGATE_FUNCTIONS)[number];
+//# sourceMappingURL=constants.d.ts.map