@furo/open-models 1.13.0 → 1.15.0

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":"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","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 {};

package/dist/decorators/SchemaBuilder.js

@@ -0,0 +1,89 @@
+import { Registry } from "../Registry.js";
+const primitivesMap = new Map([
+    ["primitives.BOOLEAN", "boolean"],
+    ["primitives.BYTES", "string"],
+    ["primitives.DOUBLE", "number"],
+    ["primitives.ENUM", "string"],
+    ["primitives.FLOAT", "number"],
+    ["primitives.INT32", "integer"],
+    ["primitives.INT64", "integer"],
+    ["primitives.SINT32", "integer"],
+    ["primitives.SINT64", "integer"],
+    ["primitives.STRING", "string"],
+    ["primitives.UINT32", "integer"],
+    ["primitives.UINT64", "integer"],
+]);
+export class SchemaBuilder {
+    static generate(model) {
+        const schema = {
+            $schema: "http://json-schema.org/draft-07/schema#",
+            $id: model.__meta.typeName,
+            type: "object",
+            description: model.__meta.description,
+        };
+        schema.properties = SchemaBuilder.getProps(model);
+        // required fields
+        const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);
+        if (rq.length > 0) {
+            schema.required = rq;
+        }
+        return schema;
+    }
+    static getProps(model) {
+        return Object.fromEntries(model.__meta.nodeFields.map(fieldDescriptor => {
+            const field = model.__getFieldNodeByPath(fieldDescriptor.fieldName);
+            if (field.__isPrimitive && field.__meta.typeName !== "primitives.ENUM") {
+                const spec = {
+                    type: primitivesMap.get(field.__meta.typeName),
+                    description: [fieldDescriptor.description, field.__meta.description].join(""),
+                    ...SchemaBuilder.getConstraints(fieldDescriptor.constraints),
+                };
+                return [fieldDescriptor.fieldName, spec];
+            }
+            // ENUM
+            if (field.__meta.typeName === "primitives.ENUM") {
+                const eargs = model.__getFieldNodeByPath("material").enumArg;
+                return [
+                    fieldDescriptor.fieldName,
+                    {
+                        type: primitivesMap.get(field.__meta.typeName),
+                        description: [fieldDescriptor.description, field.__meta.description].join(""),
+                        enum: Array.from(Object.keys(eargs)),
+                    },
+                ];
+            }
+            const schema = {
+                type: "object",
+                description: [fieldDescriptor.description, field.__meta.description].join(""),
+            };
+            schema.properties = SchemaBuilder.getProps(field);
+            // required fields
+            const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);
+            if (rq.length > 0) {
+                schema.required = rq;
+            }
+            return [fieldDescriptor.fieldName, schema];
+        }));
+    }
+    static getRequiredFields(descriptors) {
+        const req = [];
+        descriptors.forEach(descriptor => {
+            if (descriptor.constraints?.required) {
+                req.push(descriptor.fieldName);
+            }
+        });
+        return req;
+    }
+    static getConstraints(constraints) {
+        if (constraints === undefined) {
+            return {};
+        }
+        const co = { ...constraints };
+        delete co.required;
+        return co;
+    }
+    static createFieldNodeFromSchema(schema) {
+        return Registry.createInstanceByTypeName(schema.$id, schema);
+    }
+}
+//# sourceMappingURL=SchemaBuilder.js.map

package/dist/decorators/SchemaBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.js","sourceRoot":"","sources":["../../src/decorators/SchemaBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["import { ENUM } from \"../primitives/ENUM\";\nimport { FieldConstraints } from \"../FieldConstraints\";\nimport { FieldNode } from \"../FieldNode\";\nimport type { FieldDescriptor } from \"../FieldNode\";\nimport { Registry } from \"../Registry\";\nimport type { JSONSchema7, JSONSchema7Definition } from \"json-schema\";\n\nconst primitivesMap: Map<string, string> = new Map([\n  [\"primitives.BOOLEAN\", \"boolean\"],\n  [\"primitives.BYTES\", \"string\"],\n  [\"primitives.DOUBLE\", \"number\"],\n  [\"primitives.ENUM\", \"string\"],\n  [\"primitives.FLOAT\", \"number\"],\n  [\"primitives.INT32\", \"integer\"],\n  [\"primitives.INT64\", \"integer\"],\n  [\"primitives.SINT32\", \"integer\"],\n  [\"primitives.SINT64\", \"integer\"],\n  [\"primitives.STRING\", \"string\"],\n  [\"primitives.UINT32\", \"integer\"],\n  [\"primitives.UINT64\", \"integer\"],\n]);\n\ninterface FieldNodeSchema {\n  $schema: string;\n  $id: string;\n  [key: string]: unknown;\n}\n\nexport class SchemaBuilder {\n  public static generate(model: FieldNode): JSONSchema7 {\n    const schema: JSONSchema7 = {\n      $schema: \"http://json-schema.org/draft-07/schema#\",\n      $id: model.__meta.typeName,\n      type: \"object\",\n      description: model.__meta.description,\n    };\n\n    schema.properties = SchemaBuilder.getProps(model);\n\n    // required fields\n    const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);\n    if (rq.length > 0) {\n      schema.required = rq;\n    }\n\n    return schema;\n  }\n\n  private static getProps(model: FieldNode): Record<string, JSONSchema7Definition> {\n    return Object.fromEntries(\n      model.__meta.nodeFields.map(fieldDescriptor => {\n        const field = model.__getFieldNodeByPath(fieldDescriptor.fieldName) as FieldNode;\n\n        if (field.__isPrimitive && field.__meta.typeName !== \"primitives.ENUM\") {\n          const spec = {\n            type: primitivesMap.get(field.__meta.typeName!)!,\n            description: [fieldDescriptor.description, field.__meta.description].join(\"\"),\n            ...SchemaBuilder.getConstraints(fieldDescriptor.constraints),\n          };\n\n          return [fieldDescriptor.fieldName, spec];\n        }\n        // ENUM\n        if (field.__meta.typeName === \"primitives.ENUM\") {\n          const eargs = (model.__getFieldNodeByPath(\"material\") as ENUM<unknown>).enumArg;\n\n          return [\n            fieldDescriptor.fieldName,\n            {\n              type: primitivesMap.get(field.__meta.typeName!),\n              description: [fieldDescriptor.description, field.__meta.description].join(\"\"),\n              enum: Array.from(Object.keys(eargs)),\n            },\n          ];\n        }\n\n        const schema: JSONSchema7 = {\n          type: \"object\",\n          description: [fieldDescriptor.description, field.__meta.description].join(\"\"),\n        };\n        schema.properties = SchemaBuilder.getProps(field);\n        // required fields\n        const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);\n        if (rq.length > 0) {\n          schema.required = rq;\n        }\n\n        return [fieldDescriptor.fieldName, schema];\n      })\n    );\n  }\n\n  private static getRequiredFields(descriptors: FieldDescriptor[]): string[] {\n    const req: string[] = [];\n    descriptors.forEach(descriptor => {\n      if (descriptor.constraints?.required) {\n        req.push(descriptor.fieldName);\n      }\n    });\n    return req;\n  }\n\n  private static getConstraints(constraints: FieldConstraints | undefined) {\n    if (constraints === undefined) {\n      return {};\n    }\n    const co = { ...constraints };\n    delete co.required;\n    return co;\n  }\n\n  public static createFieldNodeFromSchema(schema: FieldNodeSchema): FieldNode {\n    return Registry.createInstanceByTypeName(schema.$id, schema);\n  }\n}\n"]}

package/dist/decorators/ServiceDecorators.d.ts

@@ -0,0 +1,79 @@
+import { EntityServiceEventMap } from "./EntityServiceTypes.js";
+/**
+ * ### serviceBindings Factory
+ *
+ * Creates type-safe decorators bound to a specific service instance.
+ * Use this to bind component properties and methods to service events.
+ *
+ * The factory is generic and works with any `EventTarget`.
+ * Event types and their detail payloads are type-checked at compile time
+ * via the `TEventMap` type parameter.
+ *
+ * Usage:
+ * ```typescript
+ * import { cubeEntityService } from "./CubeEntityService";
+ * import { serviceBindings } from "./ServiceDecorators.js";
+ *
+ * const cube = serviceBindings(cubeEntityService);
+ *
+ * class MyComponent extends LitElement {
+ *   // Property binding - type-safe event name, auto-extracts from detail
+ *   @cube.bindToEvent("busy-changed")
+ *   @state()
+ *   private busy: boolean = false;
+ *
+ *   // Event binding - type-safe event name and detail type
+ *   @cube.onEvent("response-received")
+ *   private onResponseReceived() {
+ *     console.log("Data received!");
+ *   }
+ *
+ *   @cube.onEvent("error-5xx")
+ *   private onError(detail: { serverResponse: Response }) {
+ *     console.error("Server error:", detail.serverResponse);
+ *   }
+ *
+ *   // Compile error! "typo-event" is not a valid event type
+ *   // @cube.onEvent("typo-event")
+ * }
+ * ```
+ *
+ * ### Custom Event Maps
+ *
+ * To add custom events, extend the `EntityServiceEventMap`:
+ * ```typescript
+ * interface MyServiceEventMap extends EntityServiceEventMap {
+ *   "custom-event": { data: string };
+ * }
+ *
+ * const myBindings = serviceBindings<MyServiceEventMap>(myService);
+ * ```
+ *
+ * @typeParam TEventMap - The event map type (defaults to EntityServiceEventMap)
+ * @param service - The EventTarget service to bind to
+ * @returns Object with `bindToEvent` and `onEvent` decorator factories
+ */
+export declare function serviceBindings<TEventMap extends EntityServiceEventMap = EntityServiceEventMap>(service: EventTarget): {
+    /**
+     * Binds a property to a service event.
+     * When the event fires, the property is automatically updated from event.detail.
+     *
+     * @typeParam K - The event type (constrained to valid event names)
+     * @param eventType - The event name to listen for
+     * @param detailKey - Optional key to extract from event.detail (defaults to inferring from event type)
+     */
+    bindToEvent<K extends keyof TEventMap & string>(eventType: K, detailKey?: string): (target: object, propertyKey: string) => void;
+    /**
+     * Binds a method to a service event.
+     * When the event fires, the method is called with event.detail as argument.
+     *
+     * The detail type is inferred from the event map:
+     * - `@cube.onEvent("busy-changed")` → method receives `{ busy: boolean }`
+     * - `@cube.onEvent("error-5xx")` → method receives `{ serverResponse: Response }`
+     * - `@cube.onEvent("response-received")` → method receives `{ response, serverResponse }`
+     *
+     * @typeParam K - The event type (constrained to valid event names)
+     * @param eventType - The event name to listen for
+     */
+    onEvent<K extends keyof TEventMap & string>(eventType: K): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => void;
+};