@api-client/core 0.11.11 → 0.12.0

package/build/src/modeling/DomainProperty.js

@@ -0,0 +1,560 @@
+import { __esDecorate, __runInitializers } from "tslib";
+import { DomainPropertyKind } from '../models/kinds.js';
+import { DomainElement } from './DomainElement.js';
+import { nanoid } from 'nanoid';
+import { Thing } from '../models/Thing.js';
+import { observed, retargetChange, toRaw } from './observed.js';
+import { BinaryFormats, DomainPropertyAttributes, DomainPropertyList, DomainPropertyTypes, NumberFormats, } from './DataFormat.js';
+import { ShapeGenerator } from './amf/ShapeGenerator.js';
+/**
+ * Represents a property within a data domain entity.
+ *
+ * A `DomainProperty` defines a single data element within a
+ * `DomainEntity`. It specifies the data type, constraints,
+ * and other metadata for a specific piece of information.
+ *
+ * **Key Features:**
+ *
+ * -   **Data Type:** Defines the type of data the property
+ *     holds (e.g., string, number, boolean, date).
+ * -   **Constraints:** Supports defining constraints such as
+ *     minimum/maximum values, enum values, and default values.
+ * -   **Bindings:** Allows defining how the property is
+ *     represented in different formats (e.g., web APIs,
+ *     protocol buffers).
+ * -   **Metadata:** Supports metadata such as tags, taxonomy,
+ *     read-only/write-only status, and deprecation.
+ * -   **Schema:** Allows defining a general schema for the
+ *     property, which is propagated to all bindings.
+ *
+ * **Usage:**
+ *
+ * Use the `DataEntity.addProperty` method to add a new property to an
+ * entity. The property can be created using the constructor, but it
+ * won't be added to the graph until you call the `addProperty` method.
+ *
+ * **Example:**
+ *
+ * ```typescript
+ * const entity = dataModel.addEntity({ key: 'user' });
+ * const property = entity.addProperty({
+ *   key: 'name',
+ *   type: 'string',
+ *   required: true,
+ *   schema: {
+ *     minimum: 3,
+ *     maximum: 50,
+ *   },
+ * });
+ * ```
+ */
+let DomainProperty = (() => {
+    let _classSuper = DomainElement;
+    let _info_decorators;
+    let _info_initializers = [];
+    let _info_extraInitializers = [];
+    let _required_decorators;
+    let _required_initializers = [];
+    let _required_extraInitializers = [];
+    let _multiple_decorators;
+    let _multiple_initializers = [];
+    let _multiple_extraInitializers = [];
+    let _primary_decorators;
+    let _primary_initializers = [];
+    let _primary_extraInitializers = [];
+    let _index_decorators;
+    let _index_initializers = [];
+    let _index_extraInitializers = [];
+    let _readOnly_decorators;
+    let _readOnly_initializers = [];
+    let _readOnly_extraInitializers = [];
+    let _writeOnly_decorators;
+    let _writeOnly_initializers = [];
+    let _writeOnly_extraInitializers = [];
+    let _deprecated_decorators;
+    let _deprecated_initializers = [];
+    let _deprecated_extraInitializers = [];
+    let _tags_decorators;
+    let _tags_initializers = [];
+    let _tags_extraInitializers = [];
+    let _taxonomy_decorators;
+    let _taxonomy_initializers = [];
+    let _taxonomy_extraInitializers = [];
+    let _type_decorators;
+    let _type_initializers = [];
+    let _type_extraInitializers = [];
+    let _schema_decorators;
+    let _schema_initializers = [];
+    let _schema_extraInitializers = [];
+    let _bindings_decorators;
+    let _bindings_initializers = [];
+    let _bindings_extraInitializers = [];
+    return class DomainProperty extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _info_decorators = [retargetChange()];
+            _required_decorators = [observed()];
+            _multiple_decorators = [observed()];
+            _primary_decorators = [observed()];
+            _index_decorators = [observed()];
+            _readOnly_decorators = [observed()];
+            _writeOnly_decorators = [observed()];
+            _deprecated_decorators = [observed()];
+            _tags_decorators = [observed({ deep: true })];
+            _taxonomy_decorators = [observed({ deep: true })];
+            _type_decorators = [observed()];
+            _schema_decorators = [observed({ deep: true })];
+            _bindings_decorators = [observed({ deep: true })];
+            __esDecorate(this, null, _info_decorators, { kind: "accessor", name: "info", static: false, private: false, access: { has: obj => "info" in obj, get: obj => obj.info, set: (obj, value) => { obj.info = value; } }, metadata: _metadata }, _info_initializers, _info_extraInitializers);
+            __esDecorate(this, null, _required_decorators, { kind: "accessor", name: "required", static: false, private: false, access: { has: obj => "required" in obj, get: obj => obj.required, set: (obj, value) => { obj.required = value; } }, metadata: _metadata }, _required_initializers, _required_extraInitializers);
+            __esDecorate(this, null, _multiple_decorators, { kind: "accessor", name: "multiple", static: false, private: false, access: { has: obj => "multiple" in obj, get: obj => obj.multiple, set: (obj, value) => { obj.multiple = value; } }, metadata: _metadata }, _multiple_initializers, _multiple_extraInitializers);
+            __esDecorate(this, null, _primary_decorators, { kind: "accessor", name: "primary", static: false, private: false, access: { has: obj => "primary" in obj, get: obj => obj.primary, set: (obj, value) => { obj.primary = value; } }, metadata: _metadata }, _primary_initializers, _primary_extraInitializers);
+            __esDecorate(this, null, _index_decorators, { kind: "accessor", name: "index", static: false, private: false, access: { has: obj => "index" in obj, get: obj => obj.index, set: (obj, value) => { obj.index = value; } }, metadata: _metadata }, _index_initializers, _index_extraInitializers);
+            __esDecorate(this, null, _readOnly_decorators, { kind: "accessor", name: "readOnly", static: false, private: false, access: { has: obj => "readOnly" in obj, get: obj => obj.readOnly, set: (obj, value) => { obj.readOnly = value; } }, metadata: _metadata }, _readOnly_initializers, _readOnly_extraInitializers);
+            __esDecorate(this, null, _writeOnly_decorators, { kind: "accessor", name: "writeOnly", static: false, private: false, access: { has: obj => "writeOnly" in obj, get: obj => obj.writeOnly, set: (obj, value) => { obj.writeOnly = value; } }, metadata: _metadata }, _writeOnly_initializers, _writeOnly_extraInitializers);
+            __esDecorate(this, null, _deprecated_decorators, { kind: "accessor", name: "deprecated", static: false, private: false, access: { has: obj => "deprecated" in obj, get: obj => obj.deprecated, set: (obj, value) => { obj.deprecated = value; } }, metadata: _metadata }, _deprecated_initializers, _deprecated_extraInitializers);
+            __esDecorate(this, null, _tags_decorators, { kind: "accessor", name: "tags", static: false, private: false, access: { has: obj => "tags" in obj, get: obj => obj.tags, set: (obj, value) => { obj.tags = value; } }, metadata: _metadata }, _tags_initializers, _tags_extraInitializers);
+            __esDecorate(this, null, _taxonomy_decorators, { kind: "accessor", name: "taxonomy", static: false, private: false, access: { has: obj => "taxonomy" in obj, get: obj => obj.taxonomy, set: (obj, value) => { obj.taxonomy = value; } }, metadata: _metadata }, _taxonomy_initializers, _taxonomy_extraInitializers);
+            __esDecorate(this, null, _type_decorators, { kind: "accessor", name: "type", static: false, private: false, access: { has: obj => "type" in obj, get: obj => obj.type, set: (obj, value) => { obj.type = value; } }, metadata: _metadata }, _type_initializers, _type_extraInitializers);
+            __esDecorate(this, null, _schema_decorators, { kind: "accessor", name: "schema", static: false, private: false, access: { has: obj => "schema" in obj, get: obj => obj.schema, set: (obj, value) => { obj.schema = value; } }, metadata: _metadata }, _schema_initializers, _schema_extraInitializers);
+            __esDecorate(this, null, _bindings_decorators, { kind: "accessor", name: "bindings", static: false, private: false, access: { has: obj => "bindings" in obj, get: obj => obj.bindings, set: (obj, value) => { obj.bindings = value; } }, metadata: _metadata }, _bindings_initializers, _bindings_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        kind;
+        #info_accessor_storage = __runInitializers(this, _info_initializers, void 0);
+        /**
+         * The description of the domain property.
+         */
+        get info() { return this.#info_accessor_storage; }
+        set info(value) { this.#info_accessor_storage = value; }
+        #required_accessor_storage = (__runInitializers(this, _info_extraInitializers), __runInitializers(this, _required_initializers, void 0));
+        /**
+         * Wether the data property is required.
+         */
+        get required() { return this.#required_accessor_storage; }
+        set required(value) { this.#required_accessor_storage = value; }
+        #multiple_accessor_storage = (__runInitializers(this, _required_extraInitializers), __runInitializers(this, _multiple_initializers, void 0));
+        /**
+         * Whether the data property allows multiple items.
+         */
+        get multiple() { return this.#multiple_accessor_storage; }
+        set multiple(value) { this.#multiple_accessor_storage = value; }
+        #primary_accessor_storage = (__runInitializers(this, _multiple_extraInitializers), __runInitializers(this, _primary_initializers, void 0));
+        /**
+         * Whether this property describes a primary key of the entity.
+         */
+        get primary() { return this.#primary_accessor_storage; }
+        set primary(value) { this.#primary_accessor_storage = value; }
+        #index_accessor_storage = (__runInitializers(this, _primary_extraInitializers), __runInitializers(this, _index_initializers, void 0));
+        /**
+         * Whether this property describes an indexed property of the entity.
+         */
+        get index() { return this.#index_accessor_storage; }
+        set index(value) { this.#index_accessor_storage = value; }
+        #readOnly_accessor_storage = (__runInitializers(this, _index_extraInitializers), __runInitializers(this, _readOnly_initializers, void 0));
+        /**
+         * Whether the property is read only in the schema.
+         */
+        get readOnly() { return this.#readOnly_accessor_storage; }
+        set readOnly(value) { this.#readOnly_accessor_storage = value; }
+        #writeOnly_accessor_storage = (__runInitializers(this, _readOnly_extraInitializers), __runInitializers(this, _writeOnly_initializers, void 0));
+        /**
+         * Whether the property is write only in the schema.
+         */
+        get writeOnly() { return this.#writeOnly_accessor_storage; }
+        set writeOnly(value) { this.#writeOnly_accessor_storage = value; }
+        #deprecated_accessor_storage = (__runInitializers(this, _writeOnly_extraInitializers), __runInitializers(this, _deprecated_initializers, void 0));
+        /**
+         * Whether this property is deprecated.
+         */
+        get deprecated() { return this.#deprecated_accessor_storage; }
+        set deprecated(value) { this.#deprecated_accessor_storage = value; }
+        #tags_accessor_storage = (__runInitializers(this, _deprecated_extraInitializers), __runInitializers(this, _tags_initializers, []
+        /**
+         * Reserved for future use.
+         *
+         * The keys of the taxonomy items associated with the property.
+         */
+        ));
+        /**
+         * Optional general purpose tags for the UI.
+         *
+         * Note to implementations, use the `addTag()` method as it propagates the "tag" value in the namespace.
+         * Also, the tags property is excluded from the observer properties.
+         * Changes to this property will not notify the observers.
+         */
+        get tags() { return this.#tags_accessor_storage; }
+        set tags(value) { this.#tags_accessor_storage = value; }
+        #taxonomy_accessor_storage = (__runInitializers(this, _tags_extraInitializers), __runInitializers(this, _taxonomy_initializers, []
+        /**
+         * The data type for this property.
+         * Note, not all schemas support the same type. For example, defining `sint32`
+         * works for protocol buffers but does not for JSON. In such case we use default
+         * translation `sint32` -> `number`. Another way it to create
+         * a derivative entity for specific schema to describe specific schema case.
+         */
+        ));
+        /**
+         * Reserved for future use.
+         *
+         * The keys of the taxonomy items associated with the property.
+         */
+        get taxonomy() { return this.#taxonomy_accessor_storage; }
+        set taxonomy(value) { this.#taxonomy_accessor_storage = value; }
+        #type_accessor_storage = (__runInitializers(this, _taxonomy_extraInitializers), __runInitializers(this, _type_initializers, 'string'
+        /**
+         * The general schema definition of this property.
+         * This is propagated to all bindings (when they support these properties).
+         */
+        ));
+        /**
+         * The data type for this property.
+         * Note, not all schemas support the same type. For example, defining `sint32`
+         * works for protocol buffers but does not for JSON. In such case we use default
+         * translation `sint32` -> `number`. Another way it to create
+         * a derivative entity for specific schema to describe specific schema case.
+         */
+        get type() { return this.#type_accessor_storage; }
+        set type(value) { this.#type_accessor_storage = value; }
+        #schema_accessor_storage = (__runInitializers(this, _type_extraInitializers), __runInitializers(this, _schema_initializers, void 0));
+        /**
+         * The general schema definition of this property.
+         * This is propagated to all bindings (when they support these properties).
+         */
+        get schema() { return this.#schema_accessor_storage; }
+        set schema(value) { this.#schema_accessor_storage = value; }
+        #bindings_accessor_storage = (__runInitializers(this, _schema_extraInitializers), __runInitializers(this, _bindings_initializers, []
+        /**
+         * Creates a full data model schema with defaults.
+         *
+         * @param input The partial data model schema.
+         * @returns The data model schema.
+         */
+        ));
+        /**
+         * The list of bindings for this property.
+         *
+         * A binding defines a translation from a data model to a specific format.
+         * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs
+         * or a protocol buffer schema.
+         */
+        get bindings() { return this.#bindings_accessor_storage; }
+        set bindings(value) { this.#bindings_accessor_storage = value; }
+        /**
+         * Creates a full data model schema with defaults.
+         *
+         * @param input The partial data model schema.
+         * @returns The data model schema.
+         */
+        static createSchema(input = {}) {
+            const { key = nanoid(), multiple, required, type = DomainPropertyList.string, index, primary, readOnly, writeOnly, tags, taxonomy, deprecated, schema, bindings, } = input;
+            if (typeof type === 'string') {
+                if (!DomainPropertyTypes.includes(type)) {
+                    throw new Error(`Invalid data property type ${type}`);
+                }
+            }
+            const info = Thing.fromJSON(input.info, { name: 'New property' }).toJSON();
+            const result = {
+                kind: DomainPropertyKind,
+                key,
+                info,
+                type,
+            };
+            if (typeof multiple === 'boolean') {
+                result.multiple = multiple;
+            }
+            if (typeof required === 'boolean') {
+                result.required = required;
+            }
+            if (typeof index === 'boolean') {
+                result.index = index;
+            }
+            if (typeof primary === 'boolean') {
+                result.primary = primary;
+            }
+            if (typeof readOnly === 'boolean') {
+                result.readOnly = readOnly;
+            }
+            if (typeof writeOnly === 'boolean') {
+                result.writeOnly = writeOnly;
+            }
+            if (typeof deprecated === 'boolean') {
+                result.deprecated = deprecated;
+            }
+            if (Array.isArray(tags)) {
+                result.tags = [...tags];
+            }
+            if (Array.isArray(taxonomy)) {
+                result.taxonomy = [...taxonomy];
+            }
+            if (schema) {
+                result.schema = structuredClone(schema);
+            }
+            if (Array.isArray(bindings)) {
+                result.bindings = bindings.map((i) => structuredClone(i));
+            }
+            else {
+                result.bindings = [];
+            }
+            return result;
+        }
+        /**
+         * The key of the parent entity.
+         */
+        parent = __runInitializers(this, _bindings_extraInitializers);
+        /**
+         * Creates a new domain property instance.
+         * It does not add it to the graph.
+         * You need to call the `addProperty` method of the graph or a data model to add it.
+         *
+         * Domain objects constructors shouldn't be used directly. Use methods
+         * provided on the DataDomain class to create new objects.
+         *
+         * @param root A reference to the root DataDomain instance.
+         * @param parent The key of the parent entity.
+         * @param input The partial domain property schema.
+         * @returns Created domain property instance.
+         */
+        constructor(root, parent, input = {}) {
+            const init = DomainProperty.createSchema(input);
+            super(root, init.key);
+            this.parent = parent;
+            this.kind = DomainPropertyKind;
+            this.info = new Thing(init.info);
+            this.type = init.type;
+            if (typeof init.multiple === 'boolean') {
+                this.multiple = init.multiple;
+            }
+            else {
+                this.multiple = undefined;
+            }
+            if (typeof init.required === 'boolean') {
+                this.required = init.required;
+            }
+            else {
+                this.required = undefined;
+            }
+            if (typeof init.index === 'boolean') {
+                this.index = init.index;
+            }
+            else {
+                this.index = undefined;
+            }
+            if (typeof init.deprecated === 'boolean') {
+                this.deprecated = init.deprecated;
+            }
+            else {
+                this.deprecated = undefined;
+            }
+            if (typeof init.primary === 'boolean') {
+                this.primary = init.primary;
+            }
+            else {
+                this.primary = undefined;
+            }
+            if (typeof init.readOnly === 'boolean') {
+                this.readOnly = init.readOnly;
+            }
+            else {
+                this.readOnly = undefined;
+            }
+            if (typeof init.writeOnly === 'boolean') {
+                this.writeOnly = init.writeOnly;
+            }
+            else {
+                this.writeOnly = undefined;
+            }
+            if (Array.isArray(init.tags)) {
+                this.tags = [...init.tags];
+            }
+            else {
+                this.tags = [];
+            }
+            if (Array.isArray(init.taxonomy)) {
+                this.taxonomy = [...init.taxonomy];
+            }
+            else {
+                this.taxonomy = [];
+            }
+            if (init.schema) {
+                this.schema = structuredClone(init.schema);
+            }
+            else {
+                this.schema = undefined;
+            }
+            if (Array.isArray(init.bindings)) {
+                this.bindings = init.bindings.map((i) => structuredClone(i));
+            }
+            else {
+                this.bindings = [];
+            }
+        }
+        /**
+         * Checks whether the input is a valid definition of a domain property.
+         *
+         * @param input The input to validate.
+         * @param options Validation options.
+         * @returns true when the passed input is a valid definition of a domain property.
+         */
+        static validate(input, options = {}) {
+            if (!input || (typeof input !== 'object' && input !== null)) {
+                return false;
+            }
+            const typed = input;
+            if (options.strict && typed.kind !== DomainPropertyKind) {
+                return false;
+            }
+            return true;
+        }
+        toJSON() {
+            const result = {
+                kind: this.kind,
+                key: this.key,
+                info: this.info.toJSON(),
+                type: this.type || DomainPropertyList.string,
+            };
+            if (typeof this.index === 'boolean') {
+                result.index = this.index;
+            }
+            if (typeof this.deprecated === 'boolean') {
+                result.deprecated = this.deprecated;
+            }
+            if (typeof this.primary === 'boolean') {
+                result.primary = this.primary;
+            }
+            if (typeof this.multiple === 'boolean') {
+                result.multiple = this.multiple;
+            }
+            if (typeof this.required === 'boolean') {
+                result.required = this.required;
+            }
+            if (typeof this.readOnly === 'boolean') {
+                result.readOnly = this.readOnly;
+            }
+            if (typeof this.writeOnly === 'boolean') {
+                result.writeOnly = this.writeOnly;
+            }
+            if (Array.isArray(this.tags) && this.tags.length) {
+                result.tags = [...this.tags];
+            }
+            if (Array.isArray(this.taxonomy) && this.taxonomy.length) {
+                result.taxonomy = [...this.taxonomy];
+            }
+            if (this.schema) {
+                result.schema = structuredClone(toRaw(this, this.schema));
+            }
+            if (Array.isArray(this.bindings) && this.bindings.length) {
+                result.bindings = toRaw(this, this.bindings)?.map((i) => structuredClone(i));
+            }
+            return result;
+        }
+        /**
+         * Removes this property from the parent entity.
+         * It calls the `removeProperty()` method of the parent entity.
+         */
+        remove() {
+            const parent = this.getParentInstance();
+            parent?.removeProperty(this.key);
+        }
+        /**
+         * Returns a parent data entity where this data property exist.
+         */
+        getParentInstance() {
+            return this.root.graph.node(this.parent);
+        }
+        /**
+         * Checks whether the passed value is one of the supported data types.
+         * @param value The value to test
+         * @returns True when the passed value is one of the supported data types.
+         */
+        static isValidType(value) {
+            if (typeof value !== 'string') {
+                return false;
+            }
+            return DomainPropertyTypes.includes(value);
+        }
+        /**
+         * Checks whether the passed value is one of the supported data property attributes.
+         * @param value The value to test
+         * @returns True when the passed value is one of the supported data property attributes.
+         */
+        static isValidAttribute(value) {
+            if (typeof value !== 'string') {
+                return false;
+            }
+            return DomainPropertyAttributes.includes(value);
+        }
+        /**
+         * Checks whether the passed value of one of the supported `format` values.
+         *
+         * @param value The value to test
+         * @returns `true` when the value is one of the supported `format` values.
+         */
+        static isValidFormat(value) {
+            if (value === undefined) {
+                // It is the valid value.
+                return true;
+            }
+            if (typeof value !== 'string') {
+                return false;
+            }
+            if (NumberFormats.includes(value)) {
+                return true;
+            }
+            if (BinaryFormats.includes(value)) {
+                return true;
+            }
+            return false;
+        }
+        /**
+         * Creates the `schema` object if missing and returns it.
+         * @returns The schema object.
+         */
+        ensureSchema() {
+            if (!this.schema) {
+                this.schema = {};
+            }
+            return this.schema;
+        }
+        /**
+         * Creates if not existing and returns web bindings definition.
+         * @returns The web binding definition
+         */
+        getWebBinding() {
+            let object = this.bindings.find((i) => i.type === 'web');
+            if (!object) {
+                object = { type: 'web', schema: {} };
+                this.bindings.push(object);
+            }
+            return object.schema;
+        }
+        /**
+         * Returns the schema value of the binding, if any was created.
+         * @param type The type of the binding to read.
+         * @returns The binding schema, if any
+         */
+        readBinding(type) {
+            const item = this.bindings.find((i) => i.type === type);
+            return item?.schema || undefined;
+        }
+        /**
+         * Creates a Property Shape of AMF.
+         *
+         * The property itself is auto-generated. If the `schema` is
+         * defined then it is used as the `range` of the property.
+         * Otherwise basic shape is generated for the range.
+         *
+         * This is a preferred way of reading the AMF shape as this
+         * synchronizes changed data properties with the shape
+         * definition.
+         *
+         * @returns AMF property shape definition.
+         */
+        toApiShape() {
+            const serializer = new ShapeGenerator();
+            return serializer.property(this);
+        }
+    };
+})();
+export { DomainProperty };
+//# sourceMappingURL=DomainProperty.js.map

package/build/src/modeling/DomainProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainProperty.js","sourceRoot":"","sources":["../../../src/modeling/DomainProperty.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,aAAa,EAA4B,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAe,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAEL,aAAa,EAEb,wBAAwB,EAExB,kBAAkB,EAElB,mBAAmB,EAEnB,aAAa,GACd,MAAM,iBAAiB,CAAA;AAKxB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAsExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;IACU,cAAc;sBAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAApC,cAAe,SAAQ,WAAa;;;gCAM9C,cAAc,EAAE;oCAKhB,QAAQ,EAAE;oCAKV,QAAQ,EAAE;mCAKV,QAAQ,EAAE;iCAKV,QAAQ,EAAE;oCAKV,QAAQ,EAAE;qCAKV,QAAQ,EAAE;sCAKV,QAAQ,EAAE;gCASV,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oCAOxB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gCASxB,QAAQ,EAAE;kCAMV,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oCASxB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YA3EP,iKAAS,IAAI,6BAAJ,IAAI,mFAAO;YAK1B,6KAAS,QAAQ,6BAAR,QAAQ,2FAAqB;YAKtC,6KAAS,QAAQ,6BAAR,QAAQ,2FAAqB;YAKtC,0KAAS,OAAO,6BAAP,OAAO,yFAAqB;YAKrC,oKAAS,KAAK,6BAAL,KAAK,qFAAqB;YAKnC,6KAAS,QAAQ,6BAAR,QAAQ,2FAAqB;YAKtC,gLAAS,SAAS,6BAAT,SAAS,6FAAqB;YAKvC,mLAAS,UAAU,6BAAV,UAAU,+FAAqB;YAS1B,iKAAS,IAAI,6BAAJ,IAAI,mFAAe;YAO5B,6KAAS,QAAQ,6BAAR,QAAQ,2FAAe;YAS9C,iKAAS,IAAI,6BAAJ,IAAI,mFAA+B;YAM9B,uKAAS,MAAM,6BAAN,MAAM,uFAA4B;YAS3C,6KAAS,QAAQ,6BAAR,QAAQ,2FAAwB;;;QAhF1D,IAAI,CAA2B;QAKtB,6EAAoB;QAHtC;;WAEG;QACe,IAAS,IAAI,0CAAO;QAApB,IAAS,IAAI,gDAAO;QAK1B,yIAAsC;QAHlD;;WAEG;QACS,IAAS,QAAQ,8CAAqB;QAAtC,IAAS,QAAQ,oDAAqB;QAKtC,6IAAsC;QAHlD;;WAEG;QACS,IAAS,QAAQ,8CAAqB;QAAtC,IAAS,QAAQ,oDAAqB;QAKtC,2IAAqC;QAHjD;;WAEG;QACS,IAAS,OAAO,6CAAqB;QAArC,IAAS,OAAO,mDAAqB;QAKrC,sIAAmC;QAH/C;;WAEG;QACS,IAAS,KAAK,2CAAqB;QAAnC,IAAS,KAAK,iDAAqB;QAKnC,0IAAsC;QAHlD;;WAEG;QACS,IAAS,QAAQ,8CAAqB;QAAtC,IAAS,QAAQ,oDAAqB;QAKtC,+IAAuC;QAHnD;;WAEG;QACS,IAAS,SAAS,+CAAqB;QAAvC,IAAS,SAAS,qDAAqB;QAKvC,kJAAwC;QAHpD;;WAEG;QACS,IAAS,UAAU,gDAAqB;QAAxC,IAAS,UAAU,sDAAqB;QAS1B,8HAA0B,EAAE;QAEtD;;;;WAIG;WANmD;QAPtD;;;;;;WAMG;QACuB,IAAS,IAAI,0CAAe;QAA5B,IAAS,IAAI,gDAAe;QAO5B,gIAA8B,EAAE;QAE1D;;;;;;WAMG;WARuD;QAL1D;;;;WAIG;QACuB,IAAS,QAAQ,8CAAe;QAAhC,IAAS,QAAQ,oDAAe;QAS9C,4HAAoC,QAAQ;QAExD;;;WAGG;WALqD;QAPxD;;;;;;WAMG;QACS,IAAS,IAAI,0CAA+B;QAA5C,IAAS,IAAI,gDAA+B;QAM9B,qIAA2C;QAJrE;;;WAGG;QACuB,IAAS,MAAM,4CAA4B;QAA3C,IAAS,MAAM,kDAA4B;QAS3C,kIAAuC,EAAE;QAEnE;;;;;WAKG;WAPgE;QAPnE;;;;;;WAMG;QACuB,IAAS,QAAQ,8CAAwB;QAAzC,IAAS,QAAQ,oDAAwB;QAEnE;;;;;WAKG;QACH,MAAM,CAAC,YAAY,CAAC,QAAuC,EAAE;YAC3D,MAAM,EACJ,GAAG,GAAG,MAAM,EAAE,EACd,QAAQ,EACR,QAAQ,EACR,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAChC,KAAK,EACL,OAAO,EACP,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,GACT,GAAG,KAAK,CAAA;YACT,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAA0B,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAA;gBACvD,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;YAC1E,MAAM,MAAM,GAAyB;gBACnC,IAAI,EAAE,kBAAkB;gBACxB,GAAG;gBACH,IAAI;gBACJ,IAAI;aACL,CAAA;YACD,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;YAC5B,CAAC;YACD,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;YAC5B,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;YACtB,CAAC;YACD,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;YAC1B,CAAC;YACD,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;YAC5B,CAAC;YACD,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;YAC9B,CAAC;YACD,IAAI,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;YAChC,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;YACzB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAA;YACjC,CAAC;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;YACzC,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAA;YACtB,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED;;WAEG;QACO,MAAM,wDAAQ;QAExB;;;;;;;;;;;;WAYG;QACH,YAAY,IAAgB,EAAE,MAAc,EAAE,QAAuC,EAAE;YACrF,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YAC/C,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;YACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;YACpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;YAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;YAErB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YAC/B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;YAC3B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YAC/B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;YAC3B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;YACzB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;YACxB,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;YAC7B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACtC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;YAC1B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YAC/B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;YAC3B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;YACjC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;YAC5B,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;YAChB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;YACpB,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC5C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;YACzB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;QAED;;;;;;WAMG;QACH,MAAM,CAAC,QAAQ,CAAC,KAAc,EAAE,UAAkC,EAAE;YAClE,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAA;YACd,CAAC;YACD,MAAM,KAAK,GAAG,KAA6B,CAAA;YAC3C,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACxD,OAAO,KAAK,CAAA;YACd,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM;YACJ,MAAM,MAAM,GAAyB;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;gBACxB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,kBAAkB,CAAC,MAAM;aAC7C,CAAA;YACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;YAC3B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;YACrC,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACtC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC/B,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YACjC,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YACjC,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;YACjC,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACxC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;YACnC,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;YAC9B,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACzD,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;YACtC,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;YAC3D,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACzD,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9E,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED;;;WAGG;QACH,MAAM;YACJ,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACvC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClC,CAAC;QAED;;WAEG;QACH,iBAAiB;YACf,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAA6B,CAAA;QACtE,CAAC;QAED;;;;WAIG;QACH,MAAM,CAAC,WAAW,CAAC,KAAc;YAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAA;YACd,CAAC;YACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAA2B,CAAC,CAAA;QAClE,CAAC;QAED;;;;WAIG;QACH,MAAM,CAAC,gBAAgB,CAAC,KAAc;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAA;YACd,CAAC;YACD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,KAAgC,CAAC,CAAA;QAC5E,CAAC;QAED;;;;;WAKG;QACH,MAAM,CAAC,aAAa,CAAC,KAAc;YACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,yBAAyB;gBACzB,OAAO,IAAI,CAAA;YACb,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAA;YACd,CAAC;YACD,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAqB,CAAC,EAAE,CAAC;gBAClD,OAAO,IAAI,CAAA;YACb,CAAC;YACD,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAqB,CAAC,EAAE,CAAC;gBAClD,OAAO,IAAI,CAAA;YACb,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED;;;WAGG;QACH,YAAY;YACV,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;YAClB,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,CAAA;QACpB,CAAC;QAED;;;WAGG;QACH,aAAa;YACX,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAgC,CAAA;YACvF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAqB,CAAA;gBACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC5B,CAAC;YACD,OAAO,MAAM,CAAC,MAA6B,CAAA;QAC7C,CAAC;QAED;;;;WAIG;QACH,WAAW,CAAC,IAAwB;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAoB,CAAA;YAC1E,OAAO,IAAI,EAAE,MAAM,IAAI,SAAS,CAAA;QAClC,CAAC;QAED;;;;;;;;;;;;WAYG;QACH,UAAU;YACR,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAA;YACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;;;SA5ZU,cAAc","sourcesContent":["import type { DataDomain } from './DataDomain.js'\nimport { DomainPropertyKind } from '../models/kinds.js'\nimport { DomainElement, type DomainElementSchema } from './DomainElement.js'\nimport { nanoid } from 'nanoid'\nimport { type IThing, Thing } from '../models/Thing.js'\nimport { observed, retargetChange, toRaw } from './observed.js'\nimport {\n  type BinaryFormat,\n  BinaryFormats,\n  type DomainPropertyAttribute,\n  DomainPropertyAttributes,\n  type DomainPropertyFormat,\n  DomainPropertyList,\n  type DomainPropertyType,\n  DomainPropertyTypes,\n  type NumberFormat,\n  NumberFormats,\n} from './DataFormat.js'\nimport type { PropertyBinding, PropertyBindings, PropertyWebBindings } from './Bindings.js'\nimport type { ModelValidationOptions } from '../models/types.js'\nimport type { DomainEntity } from './DomainEntity.js'\nimport type { IApiPropertyShape } from '../amf/definitions/Shapes.js'\nimport { ShapeGenerator } from './amf/ShapeGenerator.js'\nimport { PropertySchema } from './types.js'\n\nexport interface DomainPropertySchema extends DomainElementSchema {\n  kind: typeof DomainPropertyKind\n  /**\n   * The domain property description.\n   */\n  info: IThing\n  /**\n   * Wether the data property is required.\n   */\n  required?: boolean\n  /**\n   * Whether the data property allows multiple items.\n   */\n  multiple?: boolean\n  /**\n   * Whether this property describes a primary key of the entity.\n   */\n  primary?: boolean\n  /**\n   * Whether this property describes an indexed property of the entity.\n   */\n  index?: boolean\n  /**\n   * Whether the property is read only in the schema.\n   */\n  readOnly?: boolean\n  /**\n   * Whether the property is write only in the schema.\n   */\n  writeOnly?: boolean\n  /**\n   * Whether this property is deprecated.\n   */\n  deprecated?: boolean\n  /**\n   * Optional general purpose tags for the UI.\n   */\n  tags?: string[]\n  /**\n   * For future use.\n   *\n   * The keys of the taxonomy items associated with the property.\n   */\n  taxonomy?: string[]\n  /**\n   * The data type for this property.\n   * Note, not all schemas support the same type. For example, defining `sint32`\n   * works for protocol buffers, but does not for JSON. In such case we use default\n   * translation `sint32` -> `number`. Another way it to create\n   * a derivative entity for specific schema to describe specific schema case.\n   */\n  type: DomainPropertyType\n  /**\n   * The general schema definition of this property.\n   * This is propagated to all bindings (when they support these properties).\n   */\n  schema?: PropertySchema\n  /**\n   * The list of bindings for this property.\n   *\n   * A binding defines a translation from a data model to a specific format.\n   * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs\n   * or a protocol buffer schema.\n   */\n  bindings?: PropertyBinding[]\n}\n\n/**\n * Represents a property within a data domain entity.\n *\n * A `DomainProperty` defines a single data element within a\n * `DomainEntity`. It specifies the data type, constraints,\n * and other metadata for a specific piece of information.\n *\n * **Key Features:**\n *\n * -   **Data Type:** Defines the type of data the property\n *     holds (e.g., string, number, boolean, date).\n * -   **Constraints:** Supports defining constraints such as\n *     minimum/maximum values, enum values, and default values.\n * -   **Bindings:** Allows defining how the property is\n *     represented in different formats (e.g., web APIs,\n *     protocol buffers).\n * -   **Metadata:** Supports metadata such as tags, taxonomy,\n *     read-only/write-only status, and deprecation.\n * -   **Schema:** Allows defining a general schema for the\n *     property, which is propagated to all bindings.\n *\n * **Usage:**\n *\n * Use the `DataEntity.addProperty` method to add a new property to an\n * entity. The property can be created using the constructor, but it\n * won't be added to the graph until you call the `addProperty` method.\n *\n * **Example:**\n *\n * ```typescript\n * const entity = dataModel.addEntity({ key: 'user' });\n * const property = entity.addProperty({\n *   key: 'name',\n *   type: 'string',\n *   required: true,\n *   schema: {\n *     minimum: 3,\n *     maximum: 50,\n *   },\n * });\n * ```\n */\nexport class DomainProperty extends DomainElement {\n  override kind: typeof DomainPropertyKind\n\n  /**\n   * The description of the domain property.\n   */\n  @retargetChange() accessor info: Thing\n\n  /**\n   * Wether the data property is required.\n   */\n  @observed() accessor required: boolean | undefined\n\n  /**\n   * Whether the data property allows multiple items.\n   */\n  @observed() accessor multiple: boolean | undefined\n\n  /**\n   * Whether this property describes a primary key of the entity.\n   */\n  @observed() accessor primary: boolean | undefined\n\n  /**\n   * Whether this property describes an indexed property of the entity.\n   */\n  @observed() accessor index: boolean | undefined\n\n  /**\n   * Whether the property is read only in the schema.\n   */\n  @observed() accessor readOnly: boolean | undefined\n\n  /**\n   * Whether the property is write only in the schema.\n   */\n  @observed() accessor writeOnly: boolean | undefined\n\n  /**\n   * Whether this property is deprecated.\n   */\n  @observed() accessor deprecated: boolean | undefined\n\n  /**\n   * Optional general purpose tags for the UI.\n   *\n   * Note to implementations, use the `addTag()` method as it propagates the \"tag\" value in the namespace.\n   * Also, the tags property is excluded from the observer properties.\n   * Changes to this property will not notify the observers.\n   */\n  @observed({ deep: true }) accessor tags: string[] = []\n\n  /**\n   * Reserved for future use.\n   *\n   * The keys of the taxonomy items associated with the property.\n   */\n  @observed({ deep: true }) accessor taxonomy: string[] = []\n\n  /**\n   * The data type for this property.\n   * Note, not all schemas support the same type. For example, defining `sint32`\n   * works for protocol buffers but does not for JSON. In such case we use default\n   * translation `sint32` -> `number`. Another way it to create\n   * a derivative entity for specific schema to describe specific schema case.\n   */\n  @observed() accessor type: DomainPropertyType = 'string'\n\n  /**\n   * The general schema definition of this property.\n   * This is propagated to all bindings (when they support these properties).\n   */\n  @observed({ deep: true }) accessor schema: PropertySchema | undefined\n\n  /**\n   * The list of bindings for this property.\n   *\n   * A binding defines a translation from a data model to a specific format.\n   * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs\n   * or a protocol buffer schema.\n   */\n  @observed({ deep: true }) accessor bindings: PropertyBinding[] = []\n\n  /**\n   * Creates a full data model schema with defaults.\n   *\n   * @param input The partial data model schema.\n   * @returns The data model schema.\n   */\n  static createSchema(input: Partial<DomainPropertySchema> = {}): DomainPropertySchema {\n    const {\n      key = nanoid(),\n      multiple,\n      required,\n      type = DomainPropertyList.string,\n      index,\n      primary,\n      readOnly,\n      writeOnly,\n      tags,\n      taxonomy,\n      deprecated,\n      schema,\n      bindings,\n    } = input\n    if (typeof type === 'string') {\n      if (!DomainPropertyTypes.includes(type as DomainPropertyType)) {\n        throw new Error(`Invalid data property type ${type}`)\n      }\n    }\n    const info = Thing.fromJSON(input.info, { name: 'New property' }).toJSON()\n    const result: DomainPropertySchema = {\n      kind: DomainPropertyKind,\n      key,\n      info,\n      type,\n    }\n    if (typeof multiple === 'boolean') {\n      result.multiple = multiple\n    }\n    if (typeof required === 'boolean') {\n      result.required = required\n    }\n    if (typeof index === 'boolean') {\n      result.index = index\n    }\n    if (typeof primary === 'boolean') {\n      result.primary = primary\n    }\n    if (typeof readOnly === 'boolean') {\n      result.readOnly = readOnly\n    }\n    if (typeof writeOnly === 'boolean') {\n      result.writeOnly = writeOnly\n    }\n    if (typeof deprecated === 'boolean') {\n      result.deprecated = deprecated\n    }\n    if (Array.isArray(tags)) {\n      result.tags = [...tags]\n    }\n    if (Array.isArray(taxonomy)) {\n      result.taxonomy = [...taxonomy]\n    }\n    if (schema) {\n      result.schema = structuredClone(schema)\n    }\n    if (Array.isArray(bindings)) {\n      result.bindings = bindings.map((i) => structuredClone(i))\n    } else {\n      result.bindings = []\n    }\n    return result\n  }\n\n  /**\n   * The key of the parent entity.\n   */\n  protected parent: string\n\n  /**\n   * Creates a new domain property instance.\n   * It does not add it to the graph.\n   * You need to call the `addProperty` method of the graph or a data model to add it.\n   *\n   * Domain objects constructors shouldn't be used directly. Use methods\n   * provided on the DataDomain class to create new objects.\n   *\n   * @param root A reference to the root DataDomain instance.\n   * @param parent The key of the parent entity.\n   * @param input The partial domain property schema.\n   * @returns Created domain property instance.\n   */\n  constructor(root: DataDomain, parent: string, input: Partial<DomainPropertySchema> = {}) {\n    const init = DomainProperty.createSchema(input)\n    super(root, init.key)\n    this.parent = parent\n    this.kind = DomainPropertyKind\n    this.info = new Thing(init.info)\n    this.type = init.type\n\n    if (typeof init.multiple === 'boolean') {\n      this.multiple = init.multiple\n    } else {\n      this.multiple = undefined\n    }\n    if (typeof init.required === 'boolean') {\n      this.required = init.required\n    } else {\n      this.required = undefined\n    }\n    if (typeof init.index === 'boolean') {\n      this.index = init.index\n    } else {\n      this.index = undefined\n    }\n    if (typeof init.deprecated === 'boolean') {\n      this.deprecated = init.deprecated\n    } else {\n      this.deprecated = undefined\n    }\n    if (typeof init.primary === 'boolean') {\n      this.primary = init.primary\n    } else {\n      this.primary = undefined\n    }\n    if (typeof init.readOnly === 'boolean') {\n      this.readOnly = init.readOnly\n    } else {\n      this.readOnly = undefined\n    }\n    if (typeof init.writeOnly === 'boolean') {\n      this.writeOnly = init.writeOnly\n    } else {\n      this.writeOnly = undefined\n    }\n    if (Array.isArray(init.tags)) {\n      this.tags = [...init.tags]\n    } else {\n      this.tags = []\n    }\n    if (Array.isArray(init.taxonomy)) {\n      this.taxonomy = [...init.taxonomy]\n    } else {\n      this.taxonomy = []\n    }\n    if (init.schema) {\n      this.schema = structuredClone(init.schema)\n    } else {\n      this.schema = undefined\n    }\n    if (Array.isArray(init.bindings)) {\n      this.bindings = init.bindings.map((i) => structuredClone(i))\n    } else {\n      this.bindings = []\n    }\n  }\n\n  /**\n   * Checks whether the input is a valid definition of a domain property.\n   *\n   * @param input The input to validate.\n   * @param options Validation options.\n   * @returns true when the passed input is a valid definition of a domain property.\n   */\n  static validate(input: unknown, options: ModelValidationOptions = {}): boolean {\n    if (!input || (typeof input !== 'object' && input !== null)) {\n      return false\n    }\n    const typed = input as DomainPropertySchema\n    if (options.strict && typed.kind !== DomainPropertyKind) {\n      return false\n    }\n    return true\n  }\n\n  toJSON(): DomainPropertySchema {\n    const result: DomainPropertySchema = {\n      kind: this.kind,\n      key: this.key,\n      info: this.info.toJSON(),\n      type: this.type || DomainPropertyList.string,\n    }\n    if (typeof this.index === 'boolean') {\n      result.index = this.index\n    }\n    if (typeof this.deprecated === 'boolean') {\n      result.deprecated = this.deprecated\n    }\n    if (typeof this.primary === 'boolean') {\n      result.primary = this.primary\n    }\n    if (typeof this.multiple === 'boolean') {\n      result.multiple = this.multiple\n    }\n    if (typeof this.required === 'boolean') {\n      result.required = this.required\n    }\n    if (typeof this.readOnly === 'boolean') {\n      result.readOnly = this.readOnly\n    }\n    if (typeof this.writeOnly === 'boolean') {\n      result.writeOnly = this.writeOnly\n    }\n    if (Array.isArray(this.tags) && this.tags.length) {\n      result.tags = [...this.tags]\n    }\n    if (Array.isArray(this.taxonomy) && this.taxonomy.length) {\n      result.taxonomy = [...this.taxonomy]\n    }\n    if (this.schema) {\n      result.schema = structuredClone(toRaw(this, this.schema))\n    }\n    if (Array.isArray(this.bindings) && this.bindings.length) {\n      result.bindings = toRaw(this, this.bindings)?.map((i) => structuredClone(i))\n    }\n    return result\n  }\n\n  /**\n   * Removes this property from the parent entity.\n   * It calls the `removeProperty()` method of the parent entity.\n   */\n  remove(): void {\n    const parent = this.getParentInstance()\n    parent?.removeProperty(this.key)\n  }\n\n  /**\n   * Returns a parent data entity where this data property exist.\n   */\n  getParentInstance(): DomainEntity | undefined {\n    return this.root.graph.node(this.parent) as DomainEntity | undefined\n  }\n\n  /**\n   * Checks whether the passed value is one of the supported data types.\n   * @param value The value to test\n   * @returns True when the passed value is one of the supported data types.\n   */\n  static isValidType(value: unknown): value is DomainPropertyType {\n    if (typeof value !== 'string') {\n      return false\n    }\n    return DomainPropertyTypes.includes(value as DomainPropertyType)\n  }\n\n  /**\n   * Checks whether the passed value is one of the supported data property attributes.\n   * @param value The value to test\n   * @returns True when the passed value is one of the supported data property attributes.\n   */\n  static isValidAttribute(value: unknown): value is DomainPropertyAttribute {\n    if (typeof value !== 'string') {\n      return false\n    }\n    return DomainPropertyAttributes.includes(value as DomainPropertyAttribute)\n  }\n\n  /**\n   * Checks whether the passed value of one of the supported `format` values.\n   *\n   * @param value The value to test\n   * @returns `true` when the value is one of the supported `format` values.\n   */\n  static isValidFormat(value: unknown): value is DomainPropertyFormat {\n    if (value === undefined) {\n      // It is the valid value.\n      return true\n    }\n    if (typeof value !== 'string') {\n      return false\n    }\n    if (NumberFormats.includes(value as NumberFormat)) {\n      return true\n    }\n    if (BinaryFormats.includes(value as BinaryFormat)) {\n      return true\n    }\n    return false\n  }\n\n  /**\n   * Creates the `schema` object if missing and returns it.\n   * @returns The schema object.\n   */\n  ensureSchema(): PropertySchema {\n    if (!this.schema) {\n      this.schema = {}\n    }\n    return this.schema\n  }\n\n  /**\n   * Creates if not existing and returns web bindings definition.\n   * @returns The web binding definition\n   */\n  getWebBinding(): PropertyWebBindings {\n    let object = this.bindings.find((i) => i.type === 'web') as PropertyBinding | undefined\n    if (!object) {\n      object = { type: 'web', schema: {} } as PropertyBinding\n      this.bindings.push(object)\n    }\n    return object.schema as PropertyWebBindings\n  }\n\n  /**\n   * Returns the schema value of the binding, if any was created.\n   * @param type The type of the binding to read.\n   * @returns The binding schema, if any\n   */\n  readBinding(type: 'web' | 'protobuf'): PropertyBindings | undefined {\n    const item = this.bindings.find((i) => i.type === type) as PropertyBinding\n    return item?.schema || undefined\n  }\n\n  /**\n   * Creates a Property Shape of AMF.\n   *\n   * The property itself is auto-generated. If the `schema` is\n   * defined then it is used as the `range` of the property.\n   * Otherwise basic shape is generated for the range.\n   *\n   * This is a preferred way of reading the AMF shape as this\n   * synchronizes changed data properties with the shape\n   * definition.\n   *\n   * @returns AMF property shape definition.\n   */\n  toApiShape(): IApiPropertyShape {\n    const serializer = new ShapeGenerator()\n    return serializer.property(this)\n  }\n}\n"]}

package/build/src/modeling/DomainSerialization.d.ts

@@ -0,0 +1,40 @@
+import type { DataDomainGraph, SerializedGraph } from './types.js';
+import type { DataDomain } from './DataDomain.js';
+interface GraphMergeResult {
+    /**
+     * The set of node ids generated for the foreign nodes.
+     */
+    nodes: Set<string>;
+    /**
+     * The set of edge ids generated for the foreign edges.
+     */
+    edges: Set<string>;
+}
+export declare function serialize(g: DataDomainGraph, domainKey: string): SerializedGraph;
+/**
+ * Removes all foreign nodes, edges, and parents from the graph.
+ * @param g The graph to remove the foreign nodes from
+ * @param domainKey The key of the domain to remove
+ */
+export declare function removeForeignGraph(g: DataDomainGraph, domainKey: string): void;
+/**
+ * Merges a foreign domain graph into the current domain graph.
+ * @param own Our domain graph
+ * @param foreign The foreign domain graph
+ * @param domain The key of the foreign domain
+ */
+export declare function mergeGraph(own: DataDomainGraph, foreign: DataDomainGraph, domain: string): GraphMergeResult;
+/**
+ * To deserialize a graph:
+ *
+ * - Create a new DataDomain instance
+ * - Restore all foreign nodes and edges
+ * - Call the deserialize function
+ *
+ * @param root The DataDomain instance to use as the root for the graph
+ * @param json The previously serialized graph
+ * @returns Deserialized graph instance
+ */
+export declare function deserialize(root: DataDomain, json?: SerializedGraph, dependencies?: DataDomain[]): DataDomainGraph;
+export {};
+//# sourceMappingURL=DomainSerialization.d.ts.map

package/build/src/modeling/DomainSerialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainSerialization.d.ts","sourceRoot":"","sources":["../../../src/modeling/DomainSerialization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAwC,eAAe,EAAE,MAAM,YAAY,CAAA;AASxG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAMjD,UAAU,gBAAgB;IACxB;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACnB;AAsDD,wBAAgB,SAAS,CAAC,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAWhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAa9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAyD3G;AA+DD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,GAAG,eAAe,CA8DlH"}