@metaobjectsdev/metadata 0.9.0 → 0.10.0

package/dist/core/relationship/meta-relationship.js

@@ -2,7 +2,7 @@
 //
 // Extends MetaData directly: no model wrapper, no metaOf() indirection.
 import { MetaData } from "../../shared/meta-data.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, } from "./relationship-constants.js";
+import { RELATIONSHIP_ATTR_CARDINALITY, RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_THROUGH, RELATIONSHIP_ATTR_SOURCE_REF_FIELD, RELATIONSHIP_ATTR_SYMMETRIC, RELATIONSHIP_ATTR_ON_DELETE, RELATIONSHIP_ATTR_ON_UPDATE, } from "./relationship-constants.js";
 export class MetaRelationship extends MetaData {
     get cardinality() {
         const v = this.ownAttr(RELATIONSHIP_ATTR_CARDINALITY);
@@ -13,15 +13,19 @@ export class MetaRelationship extends MetaData {
         const v = this.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
         return typeof v === "string" ? v : undefined;
     }
-    /** Join-table entity name for N:M relationships. */
-    get joinEntity() {
-        const v = this.ownAttr(RELATIONSHIP_ATTR_JOIN_ENTITY);
+    /** Junction (through) entity name for M:N relationships. */
+    get through() {
+        const v = this.ownAttr(RELATIONSHIP_ATTR_THROUGH);
         return typeof v === "string" ? v : undefined;
     }
-    /** Join-table column names for N:M relationships. */
-    get joinFields() {
-        const f = this.ownAttr(RELATIONSHIP_ATTR_JOIN_FIELDS);
-        return Array.isArray(f) ? f : [];
+    /** Source-side FK field on the junction (directed self-join disambiguator). */
+    get sourceRefField() {
+        const v = this.ownAttr(RELATIONSHIP_ATTR_SOURCE_REF_FIELD);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Whether this M:N relationship is an undirected (symmetric) self-join. */
+    get symmetric() {
+        return this.ownAttr(RELATIONSHIP_ATTR_SYMMETRIC) === true;
     }
     /** Referential action on parent delete. Undefined when not explicitly set (default derives from subtype). */
     get onDelete() {

package/dist/core/relationship/meta-relationship.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-relationship.js","sourceRoot":"","sources":["../../../src/core/relationship/meta-relationship.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,IAAI,WAAW;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,6DAA6D;IAC7D,IAAI,SAAS;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,oDAAoD;IACpD,IAAI,UAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,6GAA6G;IAC7G,IAAI,QAAQ;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAED,8FAA8F;IAC9F,IAAI,QAAQ;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;CACF"}
+{"version":3,"file":"meta-relationship.js","sourceRoot":"","sources":["../../../src/core/relationship/meta-relationship.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,IAAI,WAAW;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,6DAA6D;IAC7D,IAAI,SAAS;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAC5D,IAAI,OAAO;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,+EAA+E;IAC/E,IAAI,cAAc;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,4EAA4E;IAC5E,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,KAAK,IAAI,CAAC;IAC5D,CAAC;IAED,6GAA6G;IAC7G,IAAI,QAAQ;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAED,8FAA8F;IAC9F,IAAI,QAAQ;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;CACF"}

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

@@ -5,8 +5,12 @@ export declare const RELATIONSHIP_SUBTYPES: readonly ["base", "association", "ag
 export type RelationshipSubType = (typeof RELATIONSHIP_SUBTYPES)[number];
 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";
+/** M:N junction (through) entity — a third entity declaring two identity.reference children. */
+export declare const RELATIONSHIP_ATTR_THROUGH = "through";
+/** M:N directed-self-join disambiguator — names the source-side FK field on the junction. */
+export declare const RELATIONSHIP_ATTR_SOURCE_REF_FIELD = "sourceRefField";
+/** M:N undirected-self-join flag — union-on-read; valid only when objectRef == the declaring entity. */
+export declare const RELATIONSHIP_ATTR_SYMMETRIC = "symmetric";
 export declare const CARDINALITY_ONE = "one";
 export declare const CARDINALITY_MANY = "many";
 export declare const CARDINALITY_VALUES: readonly ["one", "many"];

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

@@ -1 +1 @@
-{"version":3,"file":"relationship-constants.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/relationship-constants.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAC9D,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAC9D,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,gEAKxB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMzE,eAAO,MAAM,6BAA6B,gBAAgB,CAAC;AAC3D,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAC1D,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAM1D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,eAAO,MAAM,kBAAkB,0BAA+C,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMnE,eAAO,MAAM,2BAA2B,aAAa,CAAC;AACtD,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD;mGACmG;AACnG,eAAO,MAAM,mBAAmB,2DAA4D,CAAC;AAC7F,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAIpF,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,iBAA6B,CAAC"}
+{"version":3,"file":"relationship-constants.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/relationship-constants.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAC9D,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAC9D,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,gEAKxB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMzE,eAAO,MAAM,6BAA6B,gBAAgB,CAAC;AAC3D,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,YAAY,CAAC;AACnD,6FAA6F;AAC7F,eAAO,MAAM,kCAAkC,mBAAmB,CAAC;AACnE,wGAAwG;AACxG,eAAO,MAAM,2BAA2B,cAAc,CAAC;AAMvD,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,eAAO,MAAM,kBAAkB,0BAA+C,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMnE,eAAO,MAAM,2BAA2B,aAAa,CAAC;AACtD,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD;mGACmG;AACnG,eAAO,MAAM,mBAAmB,2DAA4D,CAAC;AAC7F,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAIpF,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,iBAA6B,CAAC"}

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

@@ -17,8 +17,12 @@ export const RELATIONSHIP_SUBTYPES = [
 // ---------------------------------------------------------------------------
 export const RELATIONSHIP_ATTR_CARDINALITY = "cardinality";
 export const RELATIONSHIP_ATTR_OBJECT_REF = "objectRef";
-export const RELATIONSHIP_ATTR_JOIN_ENTITY = "joinEntity"; // N:M cardinality
-export const RELATIONSHIP_ATTR_JOIN_FIELDS = "joinFields"; // N:M cardinality
+/** M:N junction (through) entity — a third entity declaring two identity.reference children. */
+export const RELATIONSHIP_ATTR_THROUGH = "through";
+/** M:N directed-self-join disambiguator — names the source-side FK field on the junction. */
+export const RELATIONSHIP_ATTR_SOURCE_REF_FIELD = "sourceRefField";
+/** M:N undirected-self-join flag — union-on-read; valid only when objectRef == the declaring entity. */
+export const RELATIONSHIP_ATTR_SYMMETRIC = "symmetric";
 // ---------------------------------------------------------------------------
 // Relationship cardinality values (for RELATIONSHIP_ATTR_CARDINALITY)
 // ---------------------------------------------------------------------------

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

@@ -1 +1 @@
-{"version":3,"file":"relationship-constants.js","sourceRoot":"","sources":["../../../src/core/relationship/relationship-constants.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAC9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAC9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY;IACZ,gCAAgC;IAChC,gCAAgC;IAChC,gCAAgC;CACxB,CAAC;AAGX,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,aAAa,CAAC;AAC3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC,CAAI,kBAAkB;AAChF,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC,CAAI,kBAAkB;AAEhF,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAU,CAAC;AAG/E,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAEtD;mGACmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC;AAG7F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAgD;IACvF,CAAC,gCAAgC,CAAC,EAAE,SAAS;IAC7C,CAAC,gCAAgC,CAAC,EAAE,UAAU;IAC9C,CAAC,gCAAgC,CAAC,EAAE,UAAU;CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,iBAAiB,GAAsB,SAAS,CAAC"}
+{"version":3,"file":"relationship-constants.js","sourceRoot":"","sources":["../../../src/core/relationship/relationship-constants.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAC9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAC9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY;IACZ,gCAAgC;IAChC,gCAAgC;IAChC,gCAAgC;CACxB,CAAC;AAGX,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,aAAa,CAAC;AAC3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AACxD,gGAAgG;AAChG,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AACnD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kCAAkC,GAAG,gBAAgB,CAAC;AACnE,wGAAwG;AACxG,MAAM,CAAC,MAAM,2BAA2B,GAAG,WAAW,CAAC;AAEvD,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAU,CAAC;AAG/E,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAEtD;mGACmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC;AAG7F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAgD;IACvF,CAAC,gCAAgC,CAAC,EAAE,SAAS;IAC7C,CAAC,gCAAgC,CAAC,EAAE,UAAU;IAC9C,CAAC,gCAAgC,CAAC,EAAE,UAAU;CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,iBAAiB,GAAsB,SAAS,CAAC"}

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

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

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

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

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

@@ -0,0 +1,310 @@
+export const RELATIONSHIP_DEFINITION = {
+    "provider": "metaobjects-core-types",
+    "types": [
+        {
+            "type": "relationship",
+            "subType": "base",
+            "description": "Abstract relationship base — shared shape for the concrete association/aggregation/composition subtypes; not authored directly.",
+            "rules": "@cardinality is an open string at the metamodel level ('one'/'many', and Java-canonical composite forms such as 'many-to-one'); @objectRef names the target entity. M:N is expressed by @cardinality:'many' + @objectRef + @through: @through names a junction entity that MUST declare two identity.reference children (one per FK side), and the relationship's FK fields are DERIVED from those references — never restated. @sourceRefField disambiguates a DIRECTED self-join by naming the source-side FK field on the junction; @symmetric marks an UNDIRECTED self-join (union-on-read) valid only when @objectRef == the declaring entity; the two are mutually exclusive. @onDelete/@onUpdate carry referential actions (cascade/set-null/restrict/no-action).",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "cardinality",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Cardinality of the relationship target (e.g. 'one', 'many', 'many-to-one')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "objectRef",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Name or fully-qualified name of the target object the relationship points to (e.g. 'Week' or 'acme::vehicle::Car')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "through",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Junction (through) entity name for M:N relationships — a third entity declaring two identity.reference children, one per FK side. The relationship's FK fields are derived from those references."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "sourceRefField",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Directed self-join disambiguator: names the source-side FK field on the junction (the other reference is the target side). Required only for directed/ambiguous self-join M:N. Mutually exclusive with @symmetric."
+                },
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "symmetric",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Undirected self-join flag (union-on-read). Valid only when @objectRef == the declaring entity. Mutually exclusive with @sourceRefField."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onDelete",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on parent delete. Default derives from subtype (composition→cascade, aggregation→set-null, association→restrict)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onUpdate",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on key update. Default cascade."
+                }
+            ]
+        },
+        {
+            "type": "relationship",
+            "subType": "association",
+            "description": "A plain reference to another entity — no ownership; the target has an independent lifecycle (default @onDelete restrict).",
+            "rules": "M:N is expressed by @cardinality:'many' + @objectRef + @through: @through names a junction entity that MUST declare two identity.reference children (one per FK side), and the relationship's FK fields are DERIVED from those references — never restated. @sourceRefField disambiguates a DIRECTED self-join by naming the source-side FK field on the junction; @symmetric marks an UNDIRECTED self-join (union-on-read) valid only when @objectRef == the declaring entity; the two are mutually exclusive. Association is a plain reference — the target's lifecycle is independent (default @onDelete restrict).",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "cardinality",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Cardinality of the relationship target (e.g. 'one', 'many', 'many-to-one')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "objectRef",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Name or fully-qualified name of the target object the relationship points to (e.g. 'Week' or 'acme::vehicle::Car')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "through",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Junction (through) entity name for M:N relationships — a third entity declaring two identity.reference children, one per FK side. The relationship's FK fields are derived from those references."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "sourceRefField",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Directed self-join disambiguator: names the source-side FK field on the junction (the other reference is the target side). Required only for directed/ambiguous self-join M:N. Mutually exclusive with @symmetric."
+                },
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "symmetric",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Undirected self-join flag (union-on-read). Valid only when @objectRef == the declaring entity. Mutually exclusive with @sourceRefField."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onDelete",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on parent delete. Default derives from subtype (composition→cascade, aggregation→set-null, association→restrict)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onUpdate",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on key update. Default cascade."
+                }
+            ]
+        },
+        {
+            "type": "relationship",
+            "subType": "aggregation",
+            "description": "A shared/independent containment — the parent groups the target but does not own its lifecycle (default @onDelete set-null).",
+            "rules": "M:N is expressed by @cardinality:'many' + @objectRef + @through: @through names a junction entity that MUST declare two identity.reference children (one per FK side), and the relationship's FK fields are DERIVED from those references — never restated. @sourceRefField disambiguates a DIRECTED self-join by naming the source-side FK field on the junction; @symmetric marks an UNDIRECTED self-join (union-on-read) valid only when @objectRef == the declaring entity; the two are mutually exclusive. Aggregation is shared/independent — the target outlives the parent (default @onDelete set-null).",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "cardinality",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Cardinality of the relationship target (e.g. 'one', 'many', 'many-to-one')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "objectRef",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Name or fully-qualified name of the target object the relationship points to (e.g. 'Week' or 'acme::vehicle::Car')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "through",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Junction (through) entity name for M:N relationships — a third entity declaring two identity.reference children, one per FK side. The relationship's FK fields are derived from those references."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "sourceRefField",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Directed self-join disambiguator: names the source-side FK field on the junction (the other reference is the target side). Required only for directed/ambiguous self-join M:N. Mutually exclusive with @symmetric."
+                },
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "symmetric",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Undirected self-join flag (union-on-read). Valid only when @objectRef == the declaring entity. Mutually exclusive with @sourceRefField."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onDelete",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on parent delete. Default derives from subtype (composition→cascade, aggregation→set-null, association→restrict)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onUpdate",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on key update. Default cascade."
+                }
+            ]
+        },
+        {
+            "type": "relationship",
+            "subType": "composition",
+            "description": "An owned containment — the parent owns the target's lifecycle; deleting the parent deletes the children (default @onDelete cascade).",
+            "rules": "M:N is expressed by @cardinality:'many' + @objectRef + @through: @through names a junction entity that MUST declare two identity.reference children (one per FK side), and the relationship's FK fields are DERIVED from those references — never restated. @sourceRefField disambiguates a DIRECTED self-join by naming the source-side FK field on the junction; @symmetric marks an UNDIRECTED self-join (union-on-read) valid only when @objectRef == the declaring entity; the two are mutually exclusive. Composition is owned lifecycle — the children do not outlive the parent (default @onDelete cascade).",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "cardinality",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Cardinality of the relationship target (e.g. 'one', 'many', 'many-to-one')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "objectRef",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Name or fully-qualified name of the target object the relationship points to (e.g. 'Week' or 'acme::vehicle::Car')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "through",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Junction (through) entity name for M:N relationships — a third entity declaring two identity.reference children, one per FK side. The relationship's FK fields are derived from those references."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "sourceRefField",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Directed self-join disambiguator: names the source-side FK field on the junction (the other reference is the target side). Required only for directed/ambiguous self-join M:N. Mutually exclusive with @symmetric."
+                },
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "symmetric",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Undirected self-join flag (union-on-read). Valid only when @objectRef == the declaring entity. Mutually exclusive with @sourceRefField."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onDelete",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on parent delete. Default derives from subtype (composition→cascade, aggregation→set-null, association→restrict)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "onUpdate",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "cascade",
+                        "set-null",
+                        "restrict",
+                        "no-action"
+                    ],
+                    "description": "Referential action on key update. Default cascade."
+                }
+            ]
+        }
+    ]
+};
+//# sourceMappingURL=relationship-definition.embedded.js.map

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

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

package/dist/core/relationship/relationship-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationship-schema.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/relationship-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAepD,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAE,UAAU,EA+CzC,CAAC"}
+{"version":3,"file":"relationship-schema.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/relationship-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgBpD,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAwDzC,CAAC"}

package/dist/core/relationship/relationship-schema.js

@@ -1,7 +1,7 @@
 // Relationship attribute schemas — attrs common to every relationship subtype.
 // Consumed by registerCoreTypes().
-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";
+import { ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_BOOLEAN, } from "../attr/attr-constants.js";
+import { RELATIONSHIP_ATTR_CARDINALITY, RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_THROUGH, RELATIONSHIP_ATTR_SOURCE_REF_FIELD, RELATIONSHIP_ATTR_SYMMETRIC, RELATIONSHIP_ATTR_ON_DELETE, RELATIONSHIP_ATTR_ON_UPDATE, REFERENTIAL_ACTIONS, } from "./relationship-constants.js";
 /** Attrs common to every relationship subtype. */
 export const relationshipAttrs = [
     {
@@ -22,16 +22,22 @@ export const relationshipAttrs = [
         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,
+        name: RELATIONSHIP_ATTR_THROUGH,
         valueType: ATTR_SUBTYPE_STRING,
         required: false,
-        description: "Join-table entity name for N:M relationships.",
+        description: "Junction (through) entity name for M:N relationships — a third entity declaring two identity.reference children, one per FK side. The relationship's FK fields are derived from those references.",
     },
     {
-        name: RELATIONSHIP_ATTR_JOIN_FIELDS,
-        valueType: ATTR_SUBTYPE_STRINGARRAY,
+        name: RELATIONSHIP_ATTR_SOURCE_REF_FIELD,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        description: "Directed self-join disambiguator: names the source-side FK field on the junction (the other reference is the target side). Required only for directed/ambiguous self-join M:N. Mutually exclusive with @symmetric.",
+    },
+    {
+        name: RELATIONSHIP_ATTR_SYMMETRIC,
+        valueType: ATTR_SUBTYPE_BOOLEAN,
         required: false,
-        description: "Join-table column names for N:M relationships.",
+        description: "Undirected self-join flag (union-on-read). Valid only when @objectRef == the declaring entity. Mutually exclusive with @sourceRefField.",
     },
     {
         name: RELATIONSHIP_ATTR_ON_DELETE,

package/dist/core/relationship/relationship-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"relationship-schema.js","sourceRoot":"","sources":["../../../src/core/relationship/relationship-schema.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mCAAmC;AAGnC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C;QACE,IAAI,EAAE,6BAA6B;QACnC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,0EAA0E;QAC1E,wEAAwE;QACxE,oEAAoE;QACpE,0EAA0E;QAC1E,6EAA6E;QAC7E,WAAW,EACT,6EAA6E;KAChF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,qHAAqH;KACxH;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,SAAS,EAAE,wBAAwB;QACnC,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,gDAAgD;KAC9D;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACvC,WAAW,EACT,sIAAsI;KACzI;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACvC,WAAW,EAAE,oDAAoD;KAClE;CACF,CAAC"}
+{"version":3,"file":"relationship-schema.js","sourceRoot":"","sources":["../../../src/core/relationship/relationship-schema.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mCAAmC;AAGnC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C;QACE,IAAI,EAAE,6BAA6B;QACnC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,0EAA0E;QAC1E,wEAAwE;QACxE,oEAAoE;QACpE,0EAA0E;QAC1E,6EAA6E;QAC7E,WAAW,EACT,6EAA6E;KAChF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,qHAAqH;KACxH;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,mMAAmM;KACtM;IACD;QACE,IAAI,EAAE,kCAAkC;QACxC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,oNAAoN;KACvN;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,SAAS,EAAE,oBAAoB;QAC/B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,yIAAyI;KAC5I;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACvC,WAAW,EACT,sIAAsI;KACzI;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACvC,WAAW,EAAE,oDAAoD;KAClE;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,134 @@
+export const VALIDATOR_DEFINITION = {
+    "provider": "metaobjects-core-types",
+    "types": [
+        {
+            "type": "validator",
+            "subType": "base",
+            "description": "Abstract base validator — the shared root subtype concrete validators specialize. Carries the @min/@max bounds attrs but enforces no rule of its own.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "min",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Minimum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "max",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Maximum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                }
+            ]
+        },
+        {
+            "type": "validator",
+            "subType": "required",
+            "description": "Fails when the value is null/empty (NOT NULL). Equivalent to @required on the owning field."
+        },
+        {
+            "type": "validator",
+            "subType": "length",
+            "description": "Bounds string length / collection size via @min/@max.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "min",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Minimum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "max",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Maximum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                }
+            ]
+        },
+        {
+            "type": "validator",
+            "subType": "regex",
+            "description": "Requires the value match a regular expression (@pattern).",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "min",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Minimum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "max",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Maximum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "pattern",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Regular expression the value must match."
+                }
+            ]
+        },
+        {
+            "type": "validator",
+            "subType": "numeric",
+            "description": "Bounds a numeric value's magnitude via @min/@max.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "min",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Minimum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "max",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Maximum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                }
+            ]
+        },
+        {
+            "type": "validator",
+            "subType": "array",
+            "description": "Bounds the element count of an array-valued field via @min/@max.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "min",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Minimum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "max",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Maximum allowed value (length, numeric value, or array element count depending on the validator subtype)."
+                }
+            ]
+        }
+    ]
+};
+//# sourceMappingURL=validator-definition.embedded.js.map