@furo/open-models 1.14.0 → 1.15.1

package/dist/decorators/FieldBindings.js

@@ -0,0 +1,229 @@
+// Symbol keys for class metadata
+const FIELD_EVENTS = Symbol.for("__fieldEvents__");
+// Symbol keys for instance storage
+const FIELD_LISTENERS = Symbol.for("__fieldListeners__");
+const FIELD_PATCHED = Symbol.for("__fieldPatched__");
+const CURRENT_MODEL = Symbol.for("__currentModel__");
+const MODEL_WRITE_FN = Symbol.for("__modelWriteFn__");
+const MODEL_READ_FN = Symbol.for("__modelReadFn__");
+// ─────────────────────────────────────────────────────────────────
+// fieldBindings - Decorators for Reusable Bindable Components
+// ─────────────────────────────────────────────────────────────────
+/**
+ * ### fieldBindings
+ *
+ * Decorators for creating reusable components that bind to FieldNode models.
+ *
+ * The component provides `modelReaders` and `modelWriters` maps keyed by
+ * `__meta.typeName`. The decorator handles:
+ * - Binding/unbinding on model change
+ * - Calling the correct reader when model value changes
+ * - Providing `writeToModel()` method that calls the correct writer
+ *
+ * @example
+ * ```typescript
+ * export class MyInput extends LitElement implements BindableComponent {
+ *   @fieldBindings.model()
+ *   model: STRING | XString | undefined;
+ *
+ *   declare writeToModel: () => void;
+ *
+ *   modelReaders = new Map([
+ *     ["primitives.STRING", () => { this.value = (this.model as STRING).value ?? ""; }],
+ *     ["furo.fat.String", () => { this.value = (this.model as XString).value.value ?? ""; }],
+ *   ]);
+ *
+ *   modelWriters = new Map([
+ *     ["primitives.STRING", () => { (this.model as STRING).value = this.value; }],
+ *     ["furo.fat.String", () => { (this.model as XString).value.value = this.value; }],
+ *   ]);
+ *
+ *   private _onInput(e: Event) {
+ *     this.value = (e.target as HTMLInputElement).value;
+ *     this.writeToModel();
+ *   }
+ * }
+ * ```
+ */
+export const fieldBindings = {
+    /**
+     * Decorator for the `model` property.
+     *
+     * Handles:
+     * - Binding/unbinding when model changes
+     * - Resolving reader/writer functions based on model type
+     * - Calling reader on model value changes
+     * - Providing `writeToModel()` method
+     */
+    model() {
+        return function modelDecorator(target, propertyKey) {
+            const ctor = target.constructor;
+            // Patch lifecycle
+            patchLifecycle(ctor);
+            // Add writeToModel helper method
+            if (!Object.prototype.hasOwnProperty.call(target, "writeToModel")) {
+                Object.defineProperty(target, "writeToModel", {
+                    value: function writeToModel() {
+                        const writeFn = this[MODEL_WRITE_FN];
+                        if (writeFn) {
+                            try {
+                                writeFn();
+                            }
+                            catch (e) {
+                                // eslint-disable-next-line no-console
+                                console.error("Failed to write to model:", e);
+                            }
+                        }
+                    },
+                    writable: false,
+                    enumerable: false,
+                    configurable: true,
+                });
+            }
+            // Create getter/setter for the model property
+            Object.defineProperty(target, propertyKey, {
+                get() {
+                    return this[CURRENT_MODEL];
+                },
+                set(value) {
+                    const oldModel = this[CURRENT_MODEL];
+                    if (value === oldModel)
+                        return;
+                    // Unbind from old model
+                    if (oldModel) {
+                        unbindFromModel(this, oldModel);
+                    }
+                    // Store new model
+                    this[CURRENT_MODEL] = value;
+                    // Resolve reader/writer functions based on type
+                    if (value) {
+                        const typeName = value.__meta?.typeName ?? "primitives.STRING";
+                        // Resolve reader
+                        const reader = this.modelReaders?.get(typeName);
+                        if (reader) {
+                            this[MODEL_READ_FN] = reader.bind(this);
+                        }
+                        else {
+                            // eslint-disable-next-line no-console
+                            console.warn(`No modelReader for type "${typeName}". Available: ${[...(this.modelReaders?.keys() ?? [])].join(", ")}`);
+                            this[MODEL_READ_FN] = undefined;
+                        }
+                        // Resolve writer
+                        const writer = this.modelWriters?.get(typeName);
+                        if (writer) {
+                            this[MODEL_WRITE_FN] = writer.bind(this);
+                        }
+                        else {
+                            // eslint-disable-next-line no-console
+                            console.warn(`No modelWriter for type "${typeName}". Available: ${[...(this.modelWriters?.keys() ?? [])].join(", ")}`);
+                            this[MODEL_WRITE_FN] = undefined;
+                        }
+                    }
+                    else {
+                        this[MODEL_READ_FN] = undefined;
+                        this[MODEL_WRITE_FN] = undefined;
+                    }
+                    // Bind to new model (if connected)
+                    if (value && this.isConnected) {
+                        bindToModel(this, value);
+                    }
+                    // Trigger Lit update
+                    this.requestUpdate();
+                },
+                enumerable: true,
+                configurable: true,
+            });
+        };
+    },
+    /**
+     * Binds a method to an event on the model.
+     * When the event fires, the method is called with the event detail.
+     *
+     * @param eventType - The event type to listen for
+     */
+    onEvent(eventType) {
+        return function onEventDecorator(target, propertyKey, descriptor) {
+            const originalMethod = descriptor.value;
+            const ctor = target.constructor;
+            let events = ctor[FIELD_EVENTS];
+            if (!events) {
+                events = [];
+                ctor[FIELD_EVENTS] = events;
+            }
+            events.push({ propertyKey, eventType, method: originalMethod });
+            patchLifecycle(ctor);
+        };
+    },
+};
+/**
+ * Bind to the model - set up event listeners and call initial read.
+ */
+function bindToModel(component, model) {
+    const ctor = component.constructor;
+    const events = ctor[FIELD_EVENTS] ?? [];
+    const listeners = new Map();
+    component[FIELD_LISTENERS] = listeners;
+    // Get the pre-resolved read function
+    const readFn = component[MODEL_READ_FN];
+    // Set up value change listener - calls the reader
+    if (readFn) {
+        const valueListener = () => {
+            readFn();
+        };
+        listeners.set("value", { eventType: "this-field-value-changed", listener: valueListener });
+        model.__addEventListener("this-field-value-changed", valueListener);
+        // Initial read
+        readFn();
+    }
+    // Set up event bindings from @fieldBindings.onEvent decorators
+    events.forEach(({ propertyKey, eventType, method }) => {
+        const listener = (e) => {
+            method.call(component, e.detail);
+        };
+        listeners.set(`event:${propertyKey}`, { eventType, listener });
+        model.__addEventListener(eventType, listener);
+    });
+}
+/**
+ * Unbind all listeners from the model.
+ */
+function unbindFromModel(component, model) {
+    const listeners = component[FIELD_LISTENERS];
+    if (!listeners)
+        return;
+    listeners.forEach(({ eventType, listener }) => {
+        model.__removeEventListener(eventType, listener);
+    });
+    listeners.clear();
+}
+// ─────────────────────────────────────────────────────────────────
+// Lifecycle Patching
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Patch connectedCallback/disconnectedCallback to handle model binding.
+ */
+function patchLifecycle(ctor) {
+    if (ctor[FIELD_PATCHED]) {
+        return;
+    }
+    ctor[FIELD_PATCHED] = true;
+    const originalConnected = ctor.prototype.connectedCallback;
+    const originalDisconnected = ctor.prototype.disconnectedCallback;
+    ctor.prototype.connectedCallback = function connectedCallback() {
+        originalConnected?.call(this);
+        // Bind to model if already set
+        const model = this[CURRENT_MODEL];
+        if (model) {
+            bindToModel(this, model);
+        }
+    };
+    ctor.prototype.disconnectedCallback = function disconnectedCallback() {
+        // Unbind from model
+        const model = this[CURRENT_MODEL];
+        if (model) {
+            unbindFromModel(this, model);
+        }
+        originalDisconnected?.call(this);
+    };
+}
+//# sourceMappingURL=FieldBindings.js.map

package/dist/decorators/FieldBindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldBindings.js","sourceRoot":"","sources":["../../src/decorators/FieldBindings.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-param-reassign */\nimport { LitElement, ReactiveElement } from \"lit\";\n\nimport type { ModelEventType } from \"./ModelDecorators\";\n\n// ─────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Interface for FieldNode-like objects that support event listening.\n */\nexport interface FieldNodeLike {\n  __addEventListener(type: string, listener: (e: CustomEvent) => void): void;\n  __removeEventListener(type: string, listener: (e: CustomEvent) => void): void;\n  __meta?: { typeName?: string };\n  value?: unknown;\n}\n\n/**\n * Interface for components that bind to FieldNode models.\n *\n * Components implement `modelReaders` and `modelWriters` maps\n * keyed by `__meta.typeName` (e.g., \"primitives.STRING\", \"furo.fat.String\").\n *\n * @example\n * ```typescript\n * export class MyInput extends LitElement implements BindableComponent {\n *   @fieldBindings.model()\n *   model: STRING | XString | undefined;\n *\n *   // Provided by decorator\n *   declare writeToModel: () => void;\n *\n *   modelReaders = new Map<string, () => void>([\n *     [\"primitives.STRING\", () => { this.value = (this.model as STRING).value ?? \"\"; }],\n *     [\"furo.fat.String\", () => { this.value = (this.model as XString).value.value ?? \"\"; }],\n *   ]);\n *\n *   modelWriters = new Map<string, () => void>([\n *     [\"primitives.STRING\", () => { (this.model as STRING).value = this.value; }],\n *     [\"furo.fat.String\", () => { (this.model as XString).value.value = this.value; }],\n *   ]);\n * }\n * ```\n */\nexport interface BindableComponent extends LitElement {\n  model: FieldNodeLike | undefined;\n\n  /** Map of typeName → reader function (model → component) */\n  modelReaders: Map<string, () => void>;\n\n  /** Map of typeName → writer function (component → model) */\n  modelWriters: Map<string, () => void>;\n\n  /** Helper to write current value to model (provided by decorator) */\n  writeToModel: () => void;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Metadata Storage\n// ─────────────────────────────────────────────────────────────────\n\ninterface FieldEventMeta {\n  propertyKey: string;\n  eventType: ModelEventType;\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  method: Function;\n}\n\n// Symbol keys for class metadata\nconst FIELD_EVENTS = Symbol.for(\"__fieldEvents__\");\n\n// Symbol keys for instance storage\nconst FIELD_LISTENERS = Symbol.for(\"__fieldListeners__\");\nconst FIELD_PATCHED = Symbol.for(\"__fieldPatched__\");\nconst CURRENT_MODEL = Symbol.for(\"__currentModel__\");\nconst MODEL_WRITE_FN = Symbol.for(\"__modelWriteFn__\");\nconst MODEL_READ_FN = Symbol.for(\"__modelReadFn__\");\n\n// ─────────────────────────────────────────────────────────────────\n// fieldBindings - Decorators for Reusable Bindable Components\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * ### fieldBindings\n *\n * Decorators for creating reusable components that bind to FieldNode models.\n *\n * The component provides `modelReaders` and `modelWriters` maps keyed by\n * `__meta.typeName`. The decorator handles:\n * - Binding/unbinding on model change\n * - Calling the correct reader when model value changes\n * - Providing `writeToModel()` method that calls the correct writer\n *\n * @example\n * ```typescript\n * export class MyInput extends LitElement implements BindableComponent {\n *   @fieldBindings.model()\n *   model: STRING | XString | undefined;\n *\n *   declare writeToModel: () => void;\n *\n *   modelReaders = new Map([\n *     [\"primitives.STRING\", () => { this.value = (this.model as STRING).value ?? \"\"; }],\n *     [\"furo.fat.String\", () => { this.value = (this.model as XString).value.value ?? \"\"; }],\n *   ]);\n *\n *   modelWriters = new Map([\n *     [\"primitives.STRING\", () => { (this.model as STRING).value = this.value; }],\n *     [\"furo.fat.String\", () => { (this.model as XString).value.value = this.value; }],\n *   ]);\n *\n *   private _onInput(e: Event) {\n *     this.value = (e.target as HTMLInputElement).value;\n *     this.writeToModel();\n *   }\n * }\n * ```\n */\nexport const fieldBindings = {\n  /**\n   * Decorator for the `model` property.\n   *\n   * Handles:\n   * - Binding/unbinding when model changes\n   * - Resolving reader/writer functions based on model type\n   * - Calling reader on model value changes\n   * - Providing `writeToModel()` method\n   */\n  model() {\n    return function modelDecorator<T extends FieldNodeLike>(target: object, propertyKey: string) {\n      const ctor = target.constructor as typeof ReactiveElement;\n\n      // Patch lifecycle\n      patchLifecycle(ctor);\n\n      // Add writeToModel helper method\n      if (!Object.prototype.hasOwnProperty.call(target, \"writeToModel\")) {\n        Object.defineProperty(target, \"writeToModel\", {\n          value: function writeToModel(this: LitElement & Record<symbol, (() => void) | undefined>) {\n            const writeFn = this[MODEL_WRITE_FN];\n            if (writeFn) {\n              try {\n                writeFn();\n              } catch (e) {\n                // eslint-disable-next-line no-console\n                console.error(\"Failed to write to model:\", e);\n              }\n            }\n          },\n          writable: false,\n          enumerable: false,\n          configurable: true,\n        });\n      }\n\n      // Create getter/setter for the model property\n      Object.defineProperty(target, propertyKey, {\n        get(this: LitElement & Record<symbol, T | undefined>): T | undefined {\n          return this[CURRENT_MODEL];\n        },\n        set(this: LitElement & BindableComponent & Record<symbol, T | (() => void) | undefined>, value: T | undefined) {\n          const oldModel = this[CURRENT_MODEL] as T | undefined;\n          if (value === oldModel) return;\n\n          // Unbind from old model\n          if (oldModel) {\n            unbindFromModel(this, oldModel);\n          }\n\n          // Store new model\n          this[CURRENT_MODEL] = value;\n\n          // Resolve reader/writer functions based on type\n          if (value) {\n            const typeName = value.__meta?.typeName ?? \"primitives.STRING\";\n\n            // Resolve reader\n            const reader = this.modelReaders?.get(typeName);\n            if (reader) {\n              this[MODEL_READ_FN] = reader.bind(this);\n            } else {\n              // eslint-disable-next-line no-console\n              console.warn(`No modelReader for type \"${typeName}\". Available: ${[...(this.modelReaders?.keys() ?? [])].join(\", \")}`);\n              this[MODEL_READ_FN] = undefined;\n            }\n\n            // Resolve writer\n            const writer = this.modelWriters?.get(typeName);\n            if (writer) {\n              this[MODEL_WRITE_FN] = writer.bind(this);\n            } else {\n              // eslint-disable-next-line no-console\n              console.warn(`No modelWriter for type \"${typeName}\". Available: ${[...(this.modelWriters?.keys() ?? [])].join(\", \")}`);\n              this[MODEL_WRITE_FN] = undefined;\n            }\n          } else {\n            this[MODEL_READ_FN] = undefined;\n            this[MODEL_WRITE_FN] = undefined;\n          }\n\n          // Bind to new model (if connected)\n          if (value && this.isConnected) {\n            bindToModel(this, value);\n          }\n\n          // Trigger Lit update\n          this.requestUpdate();\n        },\n        enumerable: true,\n        configurable: true,\n      });\n    };\n  },\n\n  /**\n   * Binds a method to an event on the model.\n   * When the event fires, the method is called with the event detail.\n   *\n   * @param eventType - The event type to listen for\n   */\n  onEvent(eventType: ModelEventType) {\n    return function onEventDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) {\n      const originalMethod = descriptor.value;\n      const ctor = target.constructor as typeof ReactiveElement;\n\n      let events = (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS];\n      if (!events) {\n        events = [];\n        (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS] = events;\n      }\n      events.push({ propertyKey, eventType, method: originalMethod });\n\n      patchLifecycle(ctor);\n    };\n  },\n};\n\n// ─────────────────────────────────────────────────────────────────\n// Binding Logic\n// ─────────────────────────────────────────────────────────────────\n\ninterface ListenerEntry {\n  eventType: string;\n  listener: (e: CustomEvent) => void;\n}\n\ntype ComponentWithListeners = LitElement & BindableComponent & Record<symbol, Map<string, ListenerEntry> | FieldNodeLike | (() => void) | undefined>;\n\n/**\n * Bind to the model - set up event listeners and call initial read.\n */\nfunction bindToModel(component: ComponentWithListeners, model: FieldNodeLike): void {\n  const ctor = component.constructor as typeof ReactiveElement;\n  const events = (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS] ?? [];\n\n  const listeners = new Map<string, ListenerEntry>();\n  component[FIELD_LISTENERS] = listeners;\n\n  // Get the pre-resolved read function\n  const readFn = component[MODEL_READ_FN] as (() => void) | undefined;\n\n  // Set up value change listener - calls the reader\n  if (readFn) {\n    const valueListener = () => {\n      readFn();\n    };\n\n    listeners.set(\"value\", { eventType: \"this-field-value-changed\", listener: valueListener });\n    model.__addEventListener(\"this-field-value-changed\", valueListener);\n\n    // Initial read\n    readFn();\n  }\n\n  // Set up event bindings from @fieldBindings.onEvent decorators\n  events.forEach(({ propertyKey, eventType, method }) => {\n    const listener = (e: CustomEvent) => {\n      method.call(component, e.detail);\n    };\n\n    listeners.set(`event:${propertyKey}`, { eventType, listener });\n    model.__addEventListener(eventType, listener);\n  });\n}\n\n/**\n * Unbind all listeners from the model.\n */\nfunction unbindFromModel(component: ComponentWithListeners, model: FieldNodeLike): void {\n  const listeners = component[FIELD_LISTENERS] as Map<string, ListenerEntry> | undefined;\n  if (!listeners) return;\n\n  listeners.forEach(({ eventType, listener }) => {\n    model.__removeEventListener(eventType, listener);\n  });\n  listeners.clear();\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Lifecycle Patching\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Patch connectedCallback/disconnectedCallback to handle model binding.\n */\nfunction patchLifecycle(ctor: typeof ReactiveElement): void {\n  if ((ctor as unknown as Record<symbol, boolean>)[FIELD_PATCHED]) {\n    return;\n  }\n  (ctor as unknown as Record<symbol, boolean>)[FIELD_PATCHED] = true;\n\n  const originalConnected = ctor.prototype.connectedCallback;\n  const originalDisconnected = ctor.prototype.disconnectedCallback;\n\n  ctor.prototype.connectedCallback = function connectedCallback(this: ComponentWithListeners) {\n    originalConnected?.call(this);\n\n    // Bind to model if already set\n    const model = this[CURRENT_MODEL] as FieldNodeLike | undefined;\n    if (model) {\n      bindToModel(this, model);\n    }\n  };\n\n  ctor.prototype.disconnectedCallback = function disconnectedCallback(this: ComponentWithListeners) {\n    // Unbind from model\n    const model = this[CURRENT_MODEL] as FieldNodeLike | undefined;\n    if (model) {\n      unbindFromModel(this, model);\n    }\n\n    originalDisconnected?.call(this);\n  };\n}\n"]}

package/dist/decorators/ModelDecorators.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Event types dispatched by FieldNode models.
+ */
+export type ModelEventType = "update" | "field-value-changed" | "this-field-value-changed" | "field-value-updated" | "this-state-changed" | "state-changed" | "validity-changed" | "array-changed" | "this-array-changed" | "map-changed" | "this-map-changed" | "parent-readonly-set" | "parent-readonly-unset" | "model-injected";
+/**
+ * Event map for FieldNode model events.
+ * Most events don't have detail - they just notify that something changed.
+ */
+export interface ModelEventMap {
+    update: undefined;
+    "field-value-changed": unknown;
+    "this-field-value-changed": undefined;
+    "field-value-updated": unknown;
+    "this-state-changed": undefined;
+    "state-changed": unknown;
+    "validity-changed": undefined;
+    "array-changed": unknown;
+    "this-array-changed": undefined;
+    "map-changed": unknown;
+    "this-map-changed": undefined;
+    "parent-readonly-set": undefined;
+    "parent-readonly-unset": undefined;
+    "model-injected": undefined;
+}
+/**
+ * Interface for FieldNode-like objects that support event listening and path navigation.
+ */
+interface FieldNodeLike {
+    __addEventListener(type: string, listener: (e: CustomEvent) => void): void;
+    __removeEventListener(type: string, listener: (e: CustomEvent) => void): void;
+    __getFieldNodeByPath?(path: string): FieldNodeLike | undefined;
+    value?: unknown;
+}
+/**
+ * ### modelBindings Factory
+ *
+ * Creates type-safe decorators bound to a specific FieldNode model.
+ * Use this to bind component properties and methods to model events.
+ *
+ * Usage:
+ * ```typescript
+ * import { modelBindings } from "@x/furo/open-models/ModelDecorators";
+ * import { CubeEntityModel } from "./CubeEntityModel";
+ *
+ * const cubeModel = modelBindings(CubeEntityModel.model);
+ *
+ * class MyComponent extends LitElement {
+ *   // Bind to a nested field value - updates when cube.length changes
+ *   @cubeModel.bind("cube.length")
+ *   @state()
+ *   private cubeLength: number = 0;
+ *
+ *   // Bind to model validity
+ *   @cubeModel.bind("__isValid", "validity-changed")
+ *   @state()
+ *   private isValid: boolean = true;
+ *
+ *   // React to any field value change on the model
+ *   @cubeModel.onEvent("field-value-changed")
+ *   private onAnyFieldChanged() {
+ *     console.log("Something changed!");
+ *   }
+ *
+ *   // React to a specific field's changes
+ *   @cubeModel.onFieldEvent("cube.length", "this-field-value-changed")
+ *   private onLengthChanged() {
+ *     console.log("Length changed!");
+ *   }
+ * }
+ * ```
+ *
+ * @param model - The FieldNode model to bind to
+ * @returns Object with `bind`, `onEvent`, and `onFieldEvent` decorator factories
+ */
+export declare function ModelBindings<TEventMap extends ModelEventMap = ModelEventMap>(model: FieldNodeLike): {
+    /**
+     * Binds a component property to a model field value.
+     * When the field changes, the property is automatically updated.
+     *
+     * @param path - Path to the field (e.g., "cube.length", "__isValid")
+     * @param eventType - Event to listen for (defaults to "this-field-value-changed")
+     */
+    bind(path: string, eventType?: ModelEventType): (target: object, propertyKey: string) => void;
+    /**
+     * Binds a method to an event on the root model.
+     * When the event fires, the method is called.
+     *
+     * @param eventType - The event type to listen for
+     */
+    onEvent<K extends keyof TEventMap & ModelEventType>(eventType: K): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => void;
+    /**
+     * Binds a method to an event on a specific field.
+     * When the event fires on that field, the method is called.
+     *
+     * @param path - Path to the field (e.g., "cube.length")
+     * @param eventType - The event type to listen for
+     */
+    onFieldEvent<K extends keyof TEventMap & ModelEventType>(path: string, eventType: K): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => void;
+};
+export {};

package/dist/decorators/ModelDecorators.js

@@ -0,0 +1,227 @@
+const bindingsMetadata = new WeakMap();
+// Symbol keys for instance storage
+const MODEL_BIND_LISTENERS = Symbol.for("__modelBindListeners__");
+const MODEL_EVENT_LISTENERS = Symbol.for("__modelEventListeners__");
+const MODEL_BIND_PATCHED = Symbol.for("__modelBindPatched__");
+const MODEL_EVENT_PATCHED = Symbol.for("__modelEventPatched__");
+const MODEL_EVENT_METHODS = Symbol.for("__modelEventMethods__");
+// ─────────────────────────────────────────────────────────────────
+// modelBindings Factory
+// ─────────────────────────────────────────────────────────────────
+/**
+ * ### modelBindings Factory
+ *
+ * Creates type-safe decorators bound to a specific FieldNode model.
+ * Use this to bind component properties and methods to model events.
+ *
+ * Usage:
+ * ```typescript
+ * import { modelBindings } from "@x/furo/open-models/ModelDecorators";
+ * import { CubeEntityModel } from "./CubeEntityModel";
+ *
+ * const cubeModel = modelBindings(CubeEntityModel.model);
+ *
+ * class MyComponent extends LitElement {
+ *   // Bind to a nested field value - updates when cube.length changes
+ *   @cubeModel.bind("cube.length")
+ *   @state()
+ *   private cubeLength: number = 0;
+ *
+ *   // Bind to model validity
+ *   @cubeModel.bind("__isValid", "validity-changed")
+ *   @state()
+ *   private isValid: boolean = true;
+ *
+ *   // React to any field value change on the model
+ *   @cubeModel.onEvent("field-value-changed")
+ *   private onAnyFieldChanged() {
+ *     console.log("Something changed!");
+ *   }
+ *
+ *   // React to a specific field's changes
+ *   @cubeModel.onFieldEvent("cube.length", "this-field-value-changed")
+ *   private onLengthChanged() {
+ *     console.log("Length changed!");
+ *   }
+ * }
+ * ```
+ *
+ * @param model - The FieldNode model to bind to
+ * @returns Object with `bind`, `onEvent`, and `onFieldEvent` decorator factories
+ */
+export function ModelBindings(model) {
+    return {
+        /**
+         * Binds a component property to a model field value.
+         * When the field changes, the property is automatically updated.
+         *
+         * @param path - Path to the field (e.g., "cube.length", "__isValid")
+         * @param eventType - Event to listen for (defaults to "this-field-value-changed")
+         */
+        bind(path, eventType = "this-field-value-changed") {
+            return function bindDecorator(target, propertyKey) {
+                let metadata = bindingsMetadata.get(target);
+                if (!metadata) {
+                    metadata = new Map();
+                    bindingsMetadata.set(target, metadata);
+                }
+                metadata.set(propertyKey, { model, path, eventType });
+                patchBindLifecycle(target.constructor);
+            };
+        },
+        /**
+         * Binds a method to an event on the root model.
+         * When the event fires, the method is called.
+         *
+         * @param eventType - The event type to listen for
+         */
+        onEvent(eventType) {
+            return function onEventDecorator(target, propertyKey, descriptor) {
+                const originalMethod = descriptor.value;
+                const ctor = target.constructor;
+                let methods = ctor[MODEL_EVENT_METHODS];
+                if (!methods) {
+                    methods = [];
+                    ctor[MODEL_EVENT_METHODS] = methods;
+                }
+                methods.push({ propertyKey, model, path: null, eventType, method: originalMethod });
+                patchEventLifecycle(ctor);
+            };
+        },
+        /**
+         * Binds a method to an event on a specific field.
+         * When the event fires on that field, the method is called.
+         *
+         * @param path - Path to the field (e.g., "cube.length")
+         * @param eventType - The event type to listen for
+         */
+        onFieldEvent(path, eventType) {
+            return function onFieldEventDecorator(target, propertyKey, descriptor) {
+                const originalMethod = descriptor.value;
+                const ctor = target.constructor;
+                let methods = ctor[MODEL_EVENT_METHODS];
+                if (!methods) {
+                    methods = [];
+                    ctor[MODEL_EVENT_METHODS] = methods;
+                }
+                methods.push({ propertyKey, model, path, eventType, method: originalMethod });
+                patchEventLifecycle(ctor);
+            };
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────
+// Lifecycle Patching
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Get the field node for a path, handling both direct properties and nested paths.
+ */
+function getFieldForPath(model, path) {
+    // Check if it's a direct property (starts with __ or no dots)
+    if (path.startsWith("__") || !path.includes(".")) {
+        return model;
+    }
+    // Navigate to nested field (we trust the field exists per user guarantee)
+    if (model.__getFieldNodeByPath) {
+        return model.__getFieldNodeByPath(path);
+    }
+    return model;
+}
+/**
+ * Get the value for a path from the model.
+ */
+function getValueForPath(model, path) {
+    if (path.startsWith("__")) {
+        // Direct property access for internal properties
+        return model[path];
+    }
+    if (!path.includes(".")) {
+        // Direct child field
+        const field = model[path];
+        return field?.value ?? field;
+    }
+    // Nested path - get the field and return its value
+    if (model.__getFieldNodeByPath) {
+        const field = model.__getFieldNodeByPath(path);
+        return field?.value ?? field;
+    }
+    return undefined;
+}
+/**
+ * Patch connectedCallback/disconnectedCallback for bind decorators.
+ */
+function patchBindLifecycle(ctor) {
+    if (ctor[MODEL_BIND_PATCHED]) {
+        return;
+    }
+    ctor[MODEL_BIND_PATCHED] = true;
+    const originalConnected = ctor.prototype.connectedCallback;
+    const originalDisconnected = ctor.prototype.disconnectedCallback;
+    ctor.prototype.connectedCallback = function connectedCallback() {
+        originalConnected?.call(this);
+        const metadata = bindingsMetadata.get(Object.getPrototypeOf(this));
+        if (!metadata)
+            return;
+        const listeners = new Map();
+        this[MODEL_BIND_LISTENERS] = listeners;
+        metadata.forEach(({ model, path, eventType }, propKey) => {
+            const field = getFieldForPath(model, path);
+            // Set initial value
+            this[propKey] = getValueForPath(model, path);
+            const listener = () => {
+                this[propKey] = getValueForPath(model, path);
+            };
+            listeners.set(propKey, { listener, field, eventType });
+            field.__addEventListener(eventType, listener);
+        });
+    };
+    ctor.prototype.disconnectedCallback = function disconnectedCallback() {
+        const listeners = this[MODEL_BIND_LISTENERS];
+        if (listeners) {
+            listeners.forEach(({ listener, field, eventType }) => {
+                field.__removeEventListener(eventType, listener);
+            });
+            listeners.clear();
+        }
+        originalDisconnected?.call(this);
+    };
+}
+/**
+ * Patch connectedCallback/disconnectedCallback for event decorators.
+ */
+function patchEventLifecycle(ctor) {
+    if (ctor[MODEL_EVENT_PATCHED]) {
+        return;
+    }
+    ctor[MODEL_EVENT_PATCHED] = true;
+    const originalConnected = ctor.prototype.connectedCallback;
+    const originalDisconnected = ctor.prototype.disconnectedCallback;
+    ctor.prototype.connectedCallback = function connectedCallback() {
+        originalConnected?.call(this);
+        const methods = this.constructor[MODEL_EVENT_METHODS];
+        if (!methods)
+            return;
+        const listeners = new Map();
+        this[MODEL_EVENT_LISTENERS] = listeners;
+        methods.forEach(({ propertyKey, model, path, eventType, method }) => {
+            // If path is specified, listen on that field; otherwise listen on root model
+            const field = path ? getFieldForPath(model, path) : model;
+            const listener = (e) => {
+                method.call(this, e.detail);
+            };
+            listeners.set(propertyKey, { listener, field, eventType });
+            field.__addEventListener(eventType, listener);
+        });
+    };
+    ctor.prototype.disconnectedCallback = function disconnectedCallback() {
+        const listeners = this[MODEL_EVENT_LISTENERS];
+        if (listeners) {
+            listeners.forEach(({ listener, field, eventType }) => {
+                field.__removeEventListener(eventType, listener);
+            });
+            listeners.clear();
+        }
+        originalDisconnected?.call(this);
+    };
+}
+//# sourceMappingURL=ModelDecorators.js.map

package/dist/decorators/ModelDecorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelDecorators.js","sourceRoot":"","sources":["../../src/decorators/ModelDecorators.ts"],"names":[],"mappings":"AAkEA,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAoC,CAAC;AAWzE,mCAAmC;AACnC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAClE,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACpE,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAC9D,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAChE,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEhE,oEAAoE;AACpE,wBAAwB;AACxB,oEAAoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,aAAa,CAAkD,KAAoB;IACjG,OAAO;QACL;;;;;;WAMG;QACH,IAAI,CAAC,IAAY,EAAE,YAA4B,0BAA0B;YACvE,OAAO,SAAS,aAAa,CAAC,MAAc,EAAE,WAAmB;gBAC/D,IAAI,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;oBACrB,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACzC,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;gBAEtD,kBAAkB,CAAC,MAAM,CAAC,WAAqC,CAAC,CAAC;YACnE,CAAC,CAAC;QACJ,CAAC;QAED;;;;;WAKG;QACH,OAAO,CAA6C,SAAY;YAC9D,OAAO,SAAS,gBAAgB,CAAC,MAAc,EAAE,WAAmB,EAAE,UAA8B;gBAClG,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;gBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAqC,CAAC;gBAE1D,IAAI,OAAO,GAAI,IAAsD,CAAC,mBAAmB,CAAC,CAAC;gBAC3F,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,EAAE,CAAC;oBACZ,IAAsD,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC;gBACzF,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;gBAEpF,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC;QACJ,CAAC;QAED;;;;;;WAMG;QACH,YAAY,CAA6C,IAAY,EAAE,SAAY;YACjF,OAAO,SAAS,qBAAqB,CAAC,MAAc,EAAE,WAAmB,EAAE,UAA8B;gBACvG,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;gBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAqC,CAAC;gBAE1D,IAAI,OAAO,GAAI,IAAsD,CAAC,mBAAmB,CAAC,CAAC;gBAC3F,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,EAAE,CAAC;oBACZ,IAAsD,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC;gBACzF,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;gBAE9E,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,qBAAqB;AACrB,oEAAoE;AAEpE;;GAEG;AACH,SAAS,eAAe,CAAC,KAAoB,EAAE,IAAY;IACzD,8DAA8D;IAC9D,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,0EAA0E;IAC1E,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAkB,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAoB,EAAE,IAAY;IACzD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,iDAAiD;QACjD,OAAQ,KAA4C,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,qBAAqB;QACrB,MAAM,KAAK,GAAI,KAA4C,CAAC,IAAI,CAA8B,CAAC;QAC/F,OAAO,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC;IAC/B,CAAC;IACD,mDAAmD;IACnD,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAA4B;IACtD,IAAK,IAA2C,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACrE,OAAO;IACT,CAAC;IACA,IAA2C,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAExE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;IAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;IAEjE,IAAI,CAAC,SAAS,CAAC,iBAAiB,GAAG,SAAS,iBAAiB;QAG3D,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2F,CAAC;QACrH,IAAI,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAC;QAEvC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAE3C,oBAAoB;YACnB,IAA2C,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAErF,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACnB,IAA2C,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACvF,CAAC,CAAC;YAEF,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACvD,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC,SAAS,CAAC,oBAAoB,GAAG,SAAS,oBAAoB;QAGjE,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC7C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;gBACnD,KAAK,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAED,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAA4B;IACvD,IAAK,IAA2C,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACtE,OAAO;IACT,CAAC;IACA,IAA2C,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;IAEzE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;IAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;IAEjE,IAAI,CAAC,SAAS,CAAC,iBAAiB,GAAG,SAAS,iBAAiB;QAG3D,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,OAAO,GAAI,IAAI,CAAC,WAA6D,CAAC,mBAAmB,CAAC,CAAC;QACzG,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2F,CAAC;QACrH,IAAI,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAAC;QAExC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;YAClE,6EAA6E;YAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAE1D,MAAM,QAAQ,GAAG,CAAC,CAAc,EAAE,EAAE;gBAClC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC,CAAC;YAEF,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3D,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC,SAAS,CAAC,oBAAoB,GAAG,SAAS,oBAAoB;QAGjE,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;gBACnD,KAAK,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAED,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/* eslint-disable no-param-reassign */\nimport { LitElement, ReactiveElement } from \"lit\";\n\n// ─────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Event types dispatched by FieldNode models.\n */\nexport type ModelEventType =\n  | \"update\"\n  | \"field-value-changed\"\n  | \"this-field-value-changed\"\n  | \"field-value-updated\"\n  | \"this-state-changed\"\n  | \"state-changed\"\n  | \"validity-changed\"\n  | \"array-changed\"\n  | \"this-array-changed\"\n  | \"map-changed\"\n  | \"this-map-changed\"\n  | \"parent-readonly-set\"\n  | \"parent-readonly-unset\"\n  | \"model-injected\";\n\n/**\n * Event map for FieldNode model events.\n * Most events don't have detail - they just notify that something changed.\n */\nexport interface ModelEventMap {\n  update: undefined;\n  \"field-value-changed\": unknown;\n  \"this-field-value-changed\": undefined;\n  \"field-value-updated\": unknown;\n  \"this-state-changed\": undefined;\n  \"state-changed\": unknown;\n  \"validity-changed\": undefined;\n  \"array-changed\": unknown;\n  \"this-array-changed\": undefined;\n  \"map-changed\": unknown;\n  \"this-map-changed\": undefined;\n  \"parent-readonly-set\": undefined;\n  \"parent-readonly-unset\": undefined;\n  \"model-injected\": undefined;\n}\n\n/**\n * Interface for FieldNode-like objects that support event listening and path navigation.\n */\ninterface FieldNodeLike {\n  __addEventListener(type: string, listener: (e: CustomEvent) => void): void;\n  __removeEventListener(type: string, listener: (e: CustomEvent) => void): void;\n  __getFieldNodeByPath?(path: string): FieldNodeLike | undefined;\n  value?: unknown;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Metadata Storage\n// ─────────────────────────────────────────────────────────────────\n\ninterface BindingMeta {\n  model: FieldNodeLike;\n  path: string;\n  eventType: ModelEventType;\n}\nconst bindingsMetadata = new WeakMap<object, Map<string, BindingMeta>>();\n\ninterface EventBindingMeta {\n  propertyKey: string;\n  model: FieldNodeLike;\n  path: string | null;\n  eventType: ModelEventType;\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  method: Function;\n}\n\n// Symbol keys for instance storage\nconst MODEL_BIND_LISTENERS = Symbol.for(\"__modelBindListeners__\");\nconst MODEL_EVENT_LISTENERS = Symbol.for(\"__modelEventListeners__\");\nconst MODEL_BIND_PATCHED = Symbol.for(\"__modelBindPatched__\");\nconst MODEL_EVENT_PATCHED = Symbol.for(\"__modelEventPatched__\");\nconst MODEL_EVENT_METHODS = Symbol.for(\"__modelEventMethods__\");\n\n// ─────────────────────────────────────────────────────────────────\n// modelBindings Factory\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * ### modelBindings Factory\n *\n * Creates type-safe decorators bound to a specific FieldNode model.\n * Use this to bind component properties and methods to model events.\n *\n * Usage:\n * ```typescript\n * import { modelBindings } from \"@x/furo/open-models/ModelDecorators\";\n * import { CubeEntityModel } from \"./CubeEntityModel\";\n *\n * const cubeModel = modelBindings(CubeEntityModel.model);\n *\n * class MyComponent extends LitElement {\n *   // Bind to a nested field value - updates when cube.length changes\n *   @cubeModel.bind(\"cube.length\")\n *   @state()\n *   private cubeLength: number = 0;\n *\n *   // Bind to model validity\n *   @cubeModel.bind(\"__isValid\", \"validity-changed\")\n *   @state()\n *   private isValid: boolean = true;\n *\n *   // React to any field value change on the model\n *   @cubeModel.onEvent(\"field-value-changed\")\n *   private onAnyFieldChanged() {\n *     console.log(\"Something changed!\");\n *   }\n *\n *   // React to a specific field's changes\n *   @cubeModel.onFieldEvent(\"cube.length\", \"this-field-value-changed\")\n *   private onLengthChanged() {\n *     console.log(\"Length changed!\");\n *   }\n * }\n * ```\n *\n * @param model - The FieldNode model to bind to\n * @returns Object with `bind`, `onEvent`, and `onFieldEvent` decorator factories\n */\nexport function ModelBindings<TEventMap extends ModelEventMap = ModelEventMap>(model: FieldNodeLike) {\n  return {\n    /**\n     * Binds a component property to a model field value.\n     * When the field changes, the property is automatically updated.\n     *\n     * @param path - Path to the field (e.g., \"cube.length\", \"__isValid\")\n     * @param eventType - Event to listen for (defaults to \"this-field-value-changed\")\n     */\n    bind(path: string, eventType: ModelEventType = \"this-field-value-changed\") {\n      return function bindDecorator(target: object, propertyKey: string) {\n        let metadata = bindingsMetadata.get(target);\n        if (!metadata) {\n          metadata = new Map();\n          bindingsMetadata.set(target, metadata);\n        }\n        metadata.set(propertyKey, { model, path, eventType });\n\n        patchBindLifecycle(target.constructor as typeof ReactiveElement);\n      };\n    },\n\n    /**\n     * Binds a method to an event on the root model.\n     * When the event fires, the method is called.\n     *\n     * @param eventType - The event type to listen for\n     */\n    onEvent<K extends keyof TEventMap & ModelEventType>(eventType: K) {\n      return function onEventDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) {\n        const originalMethod = descriptor.value;\n        const ctor = target.constructor as typeof ReactiveElement;\n\n        let methods = (ctor as unknown as Record<symbol, EventBindingMeta[]>)[MODEL_EVENT_METHODS];\n        if (!methods) {\n          methods = [];\n          (ctor as unknown as Record<symbol, EventBindingMeta[]>)[MODEL_EVENT_METHODS] = methods;\n        }\n        methods.push({ propertyKey, model, path: null, eventType, method: originalMethod });\n\n        patchEventLifecycle(ctor);\n      };\n    },\n\n    /**\n     * Binds a method to an event on a specific field.\n     * When the event fires on that field, the method is called.\n     *\n     * @param path - Path to the field (e.g., \"cube.length\")\n     * @param eventType - The event type to listen for\n     */\n    onFieldEvent<K extends keyof TEventMap & ModelEventType>(path: string, eventType: K) {\n      return function onFieldEventDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) {\n        const originalMethod = descriptor.value;\n        const ctor = target.constructor as typeof ReactiveElement;\n\n        let methods = (ctor as unknown as Record<symbol, EventBindingMeta[]>)[MODEL_EVENT_METHODS];\n        if (!methods) {\n          methods = [];\n          (ctor as unknown as Record<symbol, EventBindingMeta[]>)[MODEL_EVENT_METHODS] = methods;\n        }\n        methods.push({ propertyKey, model, path, eventType, method: originalMethod });\n\n        patchEventLifecycle(ctor);\n      };\n    },\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Lifecycle Patching\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Get the field node for a path, handling both direct properties and nested paths.\n */\nfunction getFieldForPath(model: FieldNodeLike, path: string): FieldNodeLike {\n  // Check if it's a direct property (starts with __ or no dots)\n  if (path.startsWith(\"__\") || !path.includes(\".\")) {\n    return model;\n  }\n  // Navigate to nested field (we trust the field exists per user guarantee)\n  if (model.__getFieldNodeByPath) {\n    return model.__getFieldNodeByPath(path) as FieldNodeLike;\n  }\n  return model;\n}\n\n/**\n * Get the value for a path from the model.\n */\nfunction getValueForPath(model: FieldNodeLike, path: string): unknown {\n  if (path.startsWith(\"__\")) {\n    // Direct property access for internal properties\n    return (model as unknown as Record<string, unknown>)[path];\n  }\n  if (!path.includes(\".\")) {\n    // Direct child field\n    const field = (model as unknown as Record<string, unknown>)[path] as FieldNodeLike | undefined;\n    return field?.value ?? field;\n  }\n  // Nested path - get the field and return its value\n  if (model.__getFieldNodeByPath) {\n    const field = model.__getFieldNodeByPath(path);\n    return field?.value ?? field;\n  }\n  return undefined;\n}\n\n/**\n * Patch connectedCallback/disconnectedCallback for bind decorators.\n */\nfunction patchBindLifecycle(ctor: typeof ReactiveElement): void {\n  if ((ctor as unknown as Record<symbol, boolean>)[MODEL_BIND_PATCHED]) {\n    return;\n  }\n  (ctor as unknown as Record<symbol, boolean>)[MODEL_BIND_PATCHED] = true;\n\n  const originalConnected = ctor.prototype.connectedCallback;\n  const originalDisconnected = ctor.prototype.disconnectedCallback;\n\n  ctor.prototype.connectedCallback = function connectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: (e: CustomEvent) => void; field: FieldNodeLike; eventType: string }>>\n  ) {\n    originalConnected?.call(this);\n\n    const metadata = bindingsMetadata.get(Object.getPrototypeOf(this));\n    if (!metadata) return;\n\n    const listeners = new Map<string, { listener: (e: CustomEvent) => void; field: FieldNodeLike; eventType: string }>();\n    this[MODEL_BIND_LISTENERS] = listeners;\n\n    metadata.forEach(({ model, path, eventType }, propKey) => {\n      const field = getFieldForPath(model, path);\n\n      // Set initial value\n      (this as unknown as Record<string, unknown>)[propKey] = getValueForPath(model, path);\n\n      const listener = () => {\n        (this as unknown as Record<string, unknown>)[propKey] = getValueForPath(model, path);\n      };\n\n      listeners.set(propKey, { listener, field, eventType });\n      field.__addEventListener(eventType, listener);\n    });\n  };\n\n  ctor.prototype.disconnectedCallback = function disconnectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: (e: CustomEvent) => void; field: FieldNodeLike; eventType: string }>>\n  ) {\n    const listeners = this[MODEL_BIND_LISTENERS];\n    if (listeners) {\n      listeners.forEach(({ listener, field, eventType }) => {\n        field.__removeEventListener(eventType, listener);\n      });\n      listeners.clear();\n    }\n\n    originalDisconnected?.call(this);\n  };\n}\n\n/**\n * Patch connectedCallback/disconnectedCallback for event decorators.\n */\nfunction patchEventLifecycle(ctor: typeof ReactiveElement): void {\n  if ((ctor as unknown as Record<symbol, boolean>)[MODEL_EVENT_PATCHED]) {\n    return;\n  }\n  (ctor as unknown as Record<symbol, boolean>)[MODEL_EVENT_PATCHED] = true;\n\n  const originalConnected = ctor.prototype.connectedCallback;\n  const originalDisconnected = ctor.prototype.disconnectedCallback;\n\n  ctor.prototype.connectedCallback = function connectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: (e: CustomEvent) => void; field: FieldNodeLike; eventType: string }>>\n  ) {\n    originalConnected?.call(this);\n\n    const methods = (this.constructor as unknown as Record<symbol, EventBindingMeta[]>)[MODEL_EVENT_METHODS];\n    if (!methods) return;\n\n    const listeners = new Map<string, { listener: (e: CustomEvent) => void; field: FieldNodeLike; eventType: string }>();\n    this[MODEL_EVENT_LISTENERS] = listeners;\n\n    methods.forEach(({ propertyKey, model, path, eventType, method }) => {\n      // If path is specified, listen on that field; otherwise listen on root model\n      const field = path ? getFieldForPath(model, path) : model;\n\n      const listener = (e: CustomEvent) => {\n        method.call(this, e.detail);\n      };\n\n      listeners.set(propertyKey, { listener, field, eventType });\n      field.__addEventListener(eventType, listener);\n    });\n  };\n\n  ctor.prototype.disconnectedCallback = function disconnectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: (e: CustomEvent) => void; field: FieldNodeLike; eventType: string }>>\n  ) {\n    const listeners = this[MODEL_EVENT_LISTENERS];\n    if (listeners) {\n      listeners.forEach(({ listener, field, eventType }) => {\n        field.__removeEventListener(eventType, listener);\n      });\n      listeners.clear();\n    }\n\n    originalDisconnected?.call(this);\n  };\n}\n"]}

package/dist/decorators/SchemaBuilder.d.ts

@@ -0,0 +1,15 @@
+import { FieldNode } from "../FieldNode.js";
+import type { JSONSchema7 } from "json-schema";
+interface FieldNodeSchema {
+    $schema: string;
+    $id: string;
+    [key: string]: unknown;
+}
+export declare class SchemaBuilder {
+    static generate(model: FieldNode): JSONSchema7;
+    private static getProps;
+    private static getRequiredFields;
+    private static getConstraints;
+    static createFieldNodeFromSchema(schema: FieldNodeSchema): FieldNode;
+}
+export {};