@furo/open-models 1.13.0 → 1.15.0

package/dist/Registry.d.ts

@@ -6,6 +6,13 @@ import { FieldNode } from './FieldNode.js';
 export declare class Registry {
     static register(type: string, clazz: any): void;
     private static get;
+    /**
+     * Checks whether a given type is registered.
+     *
+     * @param {string} type - The name of the type to check for registration.
+     * @returns {boolean} `true` if the specified type is registered; otherwise, `false`.
+     */
+    static isRegistered(type: string): boolean;
     /**
      * Internal method to create instances for Any
      * @param typename

package/dist/Registry.js

@@ -12,6 +12,15 @@ export class Registry {
         }
         throw new Error(`Cannot find type ${typename}, ${typename} is not in the registry`);
     }
+    /**
+     * Checks whether a given type is registered.
+     *
+     * @param {string} type - The name of the type to check for registration.
+     * @returns {boolean} `true` if the specified type is registered; otherwise, `false`.
+     */
+    static isRegistered(type) {
+        return registry.has(type);
+    }
     /**
      * Internal method to create instances for Any
      * @param typename

package/dist/Registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"Registry.js","sourceRoot":"","sources":["../src/Registry.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAA2B,IAAI,GAAG,EAAqB,CAAC;AAEtE,MAAM,OAAO,QAAQ;IACnB,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,KAAU;QACtC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,GAAG,CAChB,QAAgB;QAMhB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,8DAA8D;YAC9D,OAAO,KAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oBAAoB,QAAQ,KAAK,QAAQ,yBAAyB,CACnE,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAC7B,QAAgB;IAChB,8DAA8D;IAC9D,QAAc,EACd,MAAkB,EAClB,aAAsB;QAEtB,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9D,CAAC;CACF","sourcesContent":["/**\n * notes:\n * primitives are also registered\n */\nimport { FieldNode } from './FieldNode';\n\nconst registry: Map<string, FieldNode> = new Map<string, FieldNode>();\n\nexport class Registry {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static register(type: string, clazz: any) {\n    registry.set(type, clazz);\n  }\n\n  private static get(\n    typename: string,\n  ): new (\n    initData?: object,\n    parent?: FieldNode | undefined,\n    attributeName?: string | undefined,\n  ) => FieldNode {\n    const clazz = registry.get(typename);\n    if (clazz !== undefined) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      return clazz as any;\n    }\n    throw new Error(\n      `Cannot find type ${typename}, ${typename} is not in the registry`,\n    );\n  }\n\n  /**\n   * Internal method to create instances for Any\n   * @param typename\n   * @param initData\n   * @param parent\n   * @param attributeName\n   */\n  static createInstanceByTypeName(\n    typename: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    initData?: any,\n    parent?: FieldNode,\n    attributeName?: string,\n  ): FieldNode {\n    const ConstructorName = Registry.get(typename);\n    return new ConstructorName(initData, parent, attributeName);\n  }\n}\n"]}
+{"version":3,"file":"Registry.js","sourceRoot":"","sources":["../src/Registry.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAA2B,IAAI,GAAG,EAAqB,CAAC;AAEtE,MAAM,OAAO,QAAQ;IACnB,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,KAAU;QACtC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,GAAG,CAChB,QAAgB;QAMhB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,8DAA8D;YAC9D,OAAO,KAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oBAAoB,QAAQ,KAAK,QAAQ,yBAAyB,CACnE,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,YAAY,CAAC,IAAW;QACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAC7B,QAAgB;IAChB,8DAA8D;IAC9D,QAAc,EACd,MAAkB,EAClB,aAAsB;QAEtB,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9D,CAAC;CACF","sourcesContent":["/**\n * notes:\n * primitives are also registered\n */\nimport { FieldNode } from './FieldNode';\n\nconst registry: Map<string, FieldNode> = new Map<string, FieldNode>();\n\nexport class Registry {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static register(type: string, clazz: any) {\n    registry.set(type, clazz);\n  }\n\n  private static get(\n    typename: string,\n  ): new (\n    initData?: object,\n    parent?: FieldNode | undefined,\n    attributeName?: string | undefined,\n  ) => FieldNode {\n    const clazz = registry.get(typename);\n    if (clazz !== undefined) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      return clazz as any;\n    }\n    throw new Error(\n      `Cannot find type ${typename}, ${typename} is not in the registry`,\n    );\n  }\n\n  /**\n   * Checks whether a given type is registered.\n   *\n   * @param {string} type - The name of the type to check for registration.\n   * @returns {boolean} `true` if the specified type is registered; otherwise, `false`.\n   */\n  public static isRegistered(type:string): boolean {\n    return registry.has(type);\n  }\n\n  /**\n   * Internal method to create instances for Any\n   * @param typename\n   * @param initData\n   * @param parent\n   * @param attributeName\n   */\n  static createInstanceByTypeName(\n    typename: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    initData?: any,\n    parent?: FieldNode,\n    attributeName?: string,\n  ): FieldNode {\n    const ConstructorName = Registry.get(typename);\n    return new ConstructorName(initData, parent, attributeName);\n  }\n}\n"]}

package/dist/decorators/EntityServiceTypes.d.ts

@@ -0,0 +1,133 @@
+/**
+ * ### EntityServiceEventType
+ *
+ * Standard event types dispatched by entity services.
+ * These events cover the full lifecycle of REST API operations.
+ *
+ * #### Request Lifecycle Events
+ * | Event              | Description                                           |
+ * |--------------------|-------------------------------------------------------|
+ * | `busy-changed`     | Loading/saving state changed                          |
+ * | `request-started`  | Request has been initiated                            |
+ * | `request-finished` | Request completed (success, error, or abort)          |
+ * | `request-aborted`  | Request was aborted (navigation, timeout, new request)|
+ *
+ * #### Success Events
+ * | Event              | Description                                           |
+ * |--------------------|-------------------------------------------------------|
+ * | `response-received`| Successful response with parsed data                  |
+ * | `raw-response`     | Successful response (raw, before parsing)             |
+ *
+ * #### Error Events
+ * | Event              | Description                                           |
+ * |--------------------|-------------------------------------------------------|
+ * | `response-error`   | Any error response (4xx/5xx) with parsed body         |
+ * | `raw-error`        | Any error response (raw, before parsing)              |
+ * | `error-404`        | Resource not found (404)                              |
+ * | `error-5xx`        | Server error (500+)                                   |
+ * | `fatal-error`      | Unhandled/unexpected error                            |
+ *
+ * Usage:
+ * ```typescript
+ * export type MyServiceEventType = EntityServiceEventType;
+ * // Or extend with custom events:
+ * export type MyServiceEventType = EntityServiceEventType | "custom-event";
+ * ```
+ */
+export type EntityServiceEventType = "busy-changed" | "request-started" | "request-finished" | "request-aborted" | "response-received" | "raw-response" | "response-error" | "raw-error" | "error-404" | "error-5xx" | "fatal-error";
+/**
+ * ### EntityServiceEventMap
+ *
+ * Maps each event type to its detail payload type.
+ * This enables type-safe event handling with `storeBindings`.
+ *
+ * #### Request Lifecycle Events
+ * | Event              | Detail Type                                      |
+ * |--------------------|--------------------------------------------------|
+ * | `busy-changed`     | `{ busy: boolean }`                              |
+ * | `request-started`  | `{ request: unknown }`                           |
+ * | `request-finished` | `{ request: unknown }`                           |
+ * | `request-aborted`  | `{ reason: string }`                             |
+ *
+ * #### Success Events
+ * | Event              | Detail Type                                      |
+ * |--------------------|--------------------------------------------------|
+ * | `response-received`| `{ response: unknown, serverResponse: Response }`|
+ * | `raw-response`     | `{ serverResponse: Response }`                   |
+ *
+ * #### Error Events
+ * | Event              | Detail Type                                      |
+ * |--------------------|--------------------------------------------------|
+ * | `response-error`   | `{ parsedResponse: unknown, serverResponse: Response }` |
+ * | `raw-error`        | `{ serverResponse: Response }`                   |
+ * | `error-404`        | `{ serverResponse: Response }`                   |
+ * | `error-5xx`        | `{ serverResponse: Response }`                   |
+ * | `fatal-error`      | `{ error: unknown }`                             |
+ *
+ * Usage:
+ * ```typescript
+ * // Extend with custom events:
+ * interface MyServiceEventMap extends EntityServiceEventMap {
+ *   "custom-event": { data: string };
+ * }
+ * ```
+ */
+export interface EntityServiceEventMap {
+    "busy-changed": {
+        busy: boolean;
+    };
+    "request-started": {
+        request: unknown;
+    };
+    "request-finished": {
+        request: unknown;
+    };
+    "request-aborted": {
+        reason: string;
+    };
+    "response-received": {
+        response: unknown;
+        serverResponse: Response;
+    };
+    "raw-response": {
+        serverResponse: Response;
+    };
+    "response-error": {
+        parsedResponse: unknown;
+        serverResponse: Response;
+    };
+    "raw-error": {
+        serverResponse: Response;
+    };
+    "error-404": {
+        serverResponse: Response;
+    };
+    "error-5xx": {
+        serverResponse: Response;
+    };
+    "fatal-error": {
+        error: unknown;
+    };
+}
+/**
+ * ### TypedEntityService
+ *
+ * Type alias for entity services with type-safe event handling.
+ * Use this when you need to type a variable or parameter that holds a service.
+ *
+ * Note: Services extend `EventTarget` at runtime, but this type provides
+ * compile-time type safety for event names when used with `storeBindings`.
+ *
+ * Usage:
+ * ```typescript
+ * // Type a variable
+ * const service: TypedEntityService = cubeEntityService;
+ *
+ * // With custom events
+ * interface MyEventMap extends EntityServiceEventMap {
+ *   "custom-event": { data: string };
+ * }
+ * const myService: TypedEntityService<MyEventMap> = myEntityService;
+ * ```
+ */
+export type TypedEntityService<_TEventMap extends EntityServiceEventMap = EntityServiceEventMap> = EventTarget;

package/dist/decorators/EntityServiceTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EntityServiceTypes.js.map

package/dist/decorators/EntityServiceTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityServiceTypes.js","sourceRoot":"","sources":["../../src/decorators/EntityServiceTypes.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * ### EntityServiceEventType\n *\n * Standard event types dispatched by entity services.\n * These events cover the full lifecycle of REST API operations.\n *\n * #### Request Lifecycle Events\n * | Event              | Description                                           |\n * |--------------------|-------------------------------------------------------|\n * | `busy-changed`     | Loading/saving state changed                          |\n * | `request-started`  | Request has been initiated                            |\n * | `request-finished` | Request completed (success, error, or abort)          |\n * | `request-aborted`  | Request was aborted (navigation, timeout, new request)|\n *\n * #### Success Events\n * | Event              | Description                                           |\n * |--------------------|-------------------------------------------------------|\n * | `response-received`| Successful response with parsed data                  |\n * | `raw-response`     | Successful response (raw, before parsing)             |\n *\n * #### Error Events\n * | Event              | Description                                           |\n * |--------------------|-------------------------------------------------------|\n * | `response-error`   | Any error response (4xx/5xx) with parsed body         |\n * | `raw-error`        | Any error response (raw, before parsing)              |\n * | `error-404`        | Resource not found (404)                              |\n * | `error-5xx`        | Server error (500+)                                   |\n * | `fatal-error`      | Unhandled/unexpected error                            |\n *\n * Usage:\n * ```typescript\n * export type MyServiceEventType = EntityServiceEventType;\n * // Or extend with custom events:\n * export type MyServiceEventType = EntityServiceEventType | \"custom-event\";\n * ```\n */\nexport type EntityServiceEventType =\n  // Request lifecycle\n  | \"busy-changed\"\n  | \"request-started\"\n  | \"request-finished\"\n  | \"request-aborted\"\n  // Success\n  | \"response-received\"\n  | \"raw-response\"\n  // Errors\n  | \"response-error\"\n  | \"raw-error\"\n  | \"error-404\"\n  | \"error-5xx\"\n  | \"fatal-error\";\n\n/**\n * ### EntityServiceEventMap\n *\n * Maps each event type to its detail payload type.\n * This enables type-safe event handling with `storeBindings`.\n *\n * #### Request Lifecycle Events\n * | Event              | Detail Type                                      |\n * |--------------------|--------------------------------------------------|\n * | `busy-changed`     | `{ busy: boolean }`                              |\n * | `request-started`  | `{ request: unknown }`                           |\n * | `request-finished` | `{ request: unknown }`                           |\n * | `request-aborted`  | `{ reason: string }`                             |\n *\n * #### Success Events\n * | Event              | Detail Type                                      |\n * |--------------------|--------------------------------------------------|\n * | `response-received`| `{ response: unknown, serverResponse: Response }`|\n * | `raw-response`     | `{ serverResponse: Response }`                   |\n *\n * #### Error Events\n * | Event              | Detail Type                                      |\n * |--------------------|--------------------------------------------------|\n * | `response-error`   | `{ parsedResponse: unknown, serverResponse: Response }` |\n * | `raw-error`        | `{ serverResponse: Response }`                   |\n * | `error-404`        | `{ serverResponse: Response }`                   |\n * | `error-5xx`        | `{ serverResponse: Response }`                   |\n * | `fatal-error`      | `{ error: unknown }`                             |\n *\n * Usage:\n * ```typescript\n * // Extend with custom events:\n * interface MyServiceEventMap extends EntityServiceEventMap {\n *   \"custom-event\": { data: string };\n * }\n * ```\n */\nexport interface EntityServiceEventMap {\n  // Request lifecycle\n  \"busy-changed\": { busy: boolean };\n  \"request-started\": { request: unknown };\n  \"request-finished\": { request: unknown };\n  \"request-aborted\": { reason: string };\n  // Success\n  \"response-received\": { response: unknown; serverResponse: Response };\n  \"raw-response\": { serverResponse: Response };\n  // Errors\n  \"response-error\": { parsedResponse: unknown; serverResponse: Response };\n  \"raw-error\": { serverResponse: Response };\n  \"error-404\": { serverResponse: Response };\n  \"error-5xx\": { serverResponse: Response };\n  \"fatal-error\": { error: unknown };\n}\n\n/**\n * ### TypedEntityService\n *\n * Type alias for entity services with type-safe event handling.\n * Use this when you need to type a variable or parameter that holds a service.\n *\n * Note: Services extend `EventTarget` at runtime, but this type provides\n * compile-time type safety for event names when used with `storeBindings`.\n *\n * Usage:\n * ```typescript\n * // Type a variable\n * const service: TypedEntityService = cubeEntityService;\n *\n * // With custom events\n * interface MyEventMap extends EntityServiceEventMap {\n *   \"custom-event\": { data: string };\n * }\n * const myService: TypedEntityService<MyEventMap> = myEntityService;\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport type TypedEntityService<_TEventMap extends EntityServiceEventMap = EntityServiceEventMap> = EventTarget;\n"]}

package/dist/decorators/FieldBindings.d.ts

@@ -0,0 +1,104 @@
+import { LitElement } from "lit";
+import type { ModelEventType } from "./ModelDecorators.js";
+/**
+ * Interface for FieldNode-like objects that support event listening.
+ */
+export interface FieldNodeLike {
+    __addEventListener(type: string, listener: (e: CustomEvent) => void): void;
+    __removeEventListener(type: string, listener: (e: CustomEvent) => void): void;
+    __meta?: {
+        typeName?: string;
+    };
+    value?: unknown;
+}
+/**
+ * Interface for components that bind to FieldNode models.
+ *
+ * Components implement `modelReaders` and `modelWriters` maps
+ * keyed by `__meta.typeName` (e.g., "primitives.STRING", "furo.fat.String").
+ *
+ * @example
+ * ```typescript
+ * export class MyInput extends LitElement implements BindableComponent {
+ *   @fieldBindings.model()
+ *   model: STRING | XString | undefined;
+ *
+ *   // Provided by decorator
+ *   declare writeToModel: () => void;
+ *
+ *   modelReaders = new Map<string, () => void>([
+ *     ["primitives.STRING", () => { this.value = (this.model as STRING).value ?? ""; }],
+ *     ["furo.fat.String", () => { this.value = (this.model as XString).value.value ?? ""; }],
+ *   ]);
+ *
+ *   modelWriters = new Map<string, () => void>([
+ *     ["primitives.STRING", () => { (this.model as STRING).value = this.value; }],
+ *     ["furo.fat.String", () => { (this.model as XString).value.value = this.value; }],
+ *   ]);
+ * }
+ * ```
+ */
+export interface BindableComponent extends LitElement {
+    model: FieldNodeLike | undefined;
+    /** Map of typeName → reader function (model → component) */
+    modelReaders: Map<string, () => void>;
+    /** Map of typeName → writer function (component → model) */
+    modelWriters: Map<string, () => void>;
+    /** Helper to write current value to model (provided by decorator) */
+    writeToModel: () => void;
+}
+/**
+ * ### 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 declare 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(): <T extends FieldNodeLike>(target: object, propertyKey: string) => void;
+    /**
+     * 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: ModelEventType): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => void;
+};

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"]}