@furo/open-models 1.20.1 → 1.21.0

package/custom-elements.json

@@ -2110,6 +2110,13 @@
               "type": {
                 "text": "(error: unknown) => void | undefined"
               }
+            },
+            {
+              "kind": "field",
+              "name": "onRawJsonResponse",
+              "type": {
+                "text": "(json: JSONObject) => void | undefined"
+              }
             }
           ]
         }
@@ -2620,151 +2627,435 @@
     },
     {
       "kind": "javascript-module",
-      "path": "dist/proxies/ARRAY.js",
+      "path": "dist/decorators/DefaultServiceEventHandlers.js",
       "declarations": [
         {
-          "kind": "class",
-          "description": "",
-          "name": "ARRAY",
-          "members": [
+          "kind": "function",
+          "name": "DefaultServiceEventHandlers",
+          "parameters": [
             {
-              "kind": "field",
-              "name": "_value",
+              "name": "dispatch",
               "type": {
-                "text": "T[]"
+                "text": "DispatchFn"
               },
-              "privacy": "private",
-              "default": "[]"
+              "description": "Function to dispatch events (typically bound to the service's dispatchEvent)"
             },
             {
-              "kind": "field",
-              "name": "___Constructor",
+              "name": "options",
+              "default": "{}",
               "type": {
-                "text": "(new () => T) | undefined"
+                "text": "DefaultServiceEventHandlersOptions"
               },
-              "privacy": "private",
-              "default": "undefined"
-            },
+              "description": "Optional configuration"
+            }
+          ],
+          "description": "### DefaultServiceEventHandlers\n\nCreates default service handlers that dispatch standard events.\nUse this to reduce boilerplate when setting up service handlers.\n\nThe `onResponse` handler is intentionally NOT included - you must provide your own\nimplementation since response handling is typically service-specific.\n\nUsage:\n```typescript\nclass MyEntityService extends EventTarget {\n  private dispatch = createDispatch(this);\n\n  setupHandlers() {\n    this.service.Get.setHandlers({\n      ...DefaultServiceEventHandlers(this.dispatch),\n      onResponse: (response, serverResponse) => {\n        // Your custom response handling\n        this.entity.fromLiteral(response.entity);\n        this.dispatch(\"response-received\", { response, serverResponse });\n      },\n    });\n  }\n}\n```\n\nWith loading check:\n```typescript\nthis.service.Get.setHandlers({\n  ...DefaultServiceEventHandlers(this.dispatch, {\n    isLoading: () => this.service.Get.isLoading || this.service.Update.isLoading,\n  }),\n  onResponse: (response, serverResponse) => { ... },\n});\n```",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "CreateDispatch",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "EventTarget"
+              },
+              "description": "The EventTarget to dispatch events on"
+            }
+          ],
+          "description": "### createDispatch\n\nHelper to create a typed dispatch function for an EventTarget.\n\nUsage:\n```typescript\nclass MyService extends EventTarget {\n  private dispatch = createDispatch(this);\n\n  doSomething() {\n    this.dispatch(\"busy-changed\", { busy: true });\n  }\n}\n```"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DefaultServiceEventHandlers",
+          "declaration": {
+            "name": "DefaultServiceEventHandlers",
+            "module": "src/decorators/DefaultServiceEventHandlers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CreateDispatch",
+          "declaration": {
+            "name": "CreateDispatch",
+            "module": "src/decorators/DefaultServiceEventHandlers.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/decorators/EntityServiceTypes.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/decorators/FieldBindings.js",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "fieldBindings",
+          "type": {
+            "text": "object"
+          },
+          "default": "{ /** * 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: object, propertyKey: string) { const ctor = target.constructor as typeof ReactiveElement; // Patch lifecycle patchLifecycle(ctor); // Add writeToModel helper method if (!Object.prototype.hasOwnProperty.call(target, \"writeToModel\")) { Object.defineProperty(target, \"writeToModel\", { value: function writeToModel(this: LitElement & Record<symbol, (() => void) | undefined>) { const writeFn = this[MODEL_WRITE_FN]; if (writeFn) { try { writeFn(); } catch (e) { 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(this: LitElement & Record<symbol, FieldNodeLike | undefined>): FieldNodeLike | undefined { return this[CURRENT_MODEL]; }, set(this: LitElement & BindableComponent & Record<symbol, FieldNodeLike | (() => void) | undefined>, value: FieldNodeLike | undefined) { const oldModel = this[CURRENT_MODEL] as FieldNodeLike | undefined; 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 // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) const reader = this.modelReaders?.get(typeName); if (reader) { this[MODEL_READ_FN] = reader.bind(this); } else { // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) console.warn(`No modelReader for type \"${typeName}\". Available: ${[...(this.modelReaders?.keys() ?? [])].join(\", \")}`); this[MODEL_READ_FN] = undefined; } // Resolve writer // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) const writer = this.modelWriters?.get(typeName); if (writer) { this[MODEL_WRITE_FN] = writer.bind(this); } else { // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) 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: ModelEventType) { return function onEventDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) { // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment const originalMethod = descriptor.value; const ctor = target.constructor as typeof ReactiveElement; let events = (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS]; // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) if (!events) { events = []; (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS] = events; } // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment events.push({ propertyKey, eventType, method: originalMethod }); patchLifecycle(ctor); }; }, /** * Decorator that marks a method to be called once after a new model is assigned and bound. * * Useful for one-time setup like setting a11y attributes, placeholders, or constraints * based on the model's type. * * @example * ```typescript * @fieldBindings.onInit() * protected init() { * this.accessibleName = this.model?.__label ?? \"Toggle\"; * } * ``` */ onInit() { return function onInitDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) { // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment const originalMethod = descriptor.value; const ctor = target.constructor as typeof ReactiveElement; // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type let inits = (ctor as unknown as Record<symbol, { propertyKey: string; method: Function }[]>)[FIELD_INIT_METHODS]; // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) if (!inits) { inits = []; // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type (ctor as unknown as Record<symbol, { propertyKey: string; method: Function }[]>)[FIELD_INIT_METHODS] = inits; } // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment inits.push({ propertyKey, method: originalMethod }); patchLifecycle(ctor); }; }, }",
+          "description": "### fieldBindings\n\nDecorators for creating reusable components that bind to FieldNode models.\n\nThe 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"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "fieldBindings",
+          "declaration": {
+            "name": "fieldBindings",
+            "module": "src/decorators/FieldBindings.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/decorators/ModelDecorators.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "ModelBindings",
+          "parameters": [
+            {
+              "name": "model",
+              "type": {
+                "text": "FieldNodeLike"
+              },
+              "description": "The FieldNode model to bind to"
+            }
+          ],
+          "description": "### ModelBindings Factory\n\nCreates type-safe decorators bound to a specific FieldNode model.\nUse this to bind component properties and methods to model events.\n\nUsage:\n```typescript\nimport { ModelBindings } from \"@x/furo/open-models/ModelDecorators\";\nimport { CubeEntityModel } from \"./CubeEntityModel\";\n\nconst cubeModel = ModelBindings(CubeEntityModel.model);\n\nclass MyComponent extends LitElement {\n  // Triggers re-render on any model update",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ModelBindings",
+          "declaration": {
+            "name": "ModelBindings",
+            "module": "src/decorators/ModelDecorators.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/decorators/SchemaBuilder.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SchemaBuilder",
+          "members": [
             {
               "kind": "method",
-              "name": "add",
+              "name": "generate",
               "privacy": "public",
+              "static": true,
               "return": {
                 "type": {
-                  "text": "T"
+                  "text": "JSONSchema7"
                 }
               },
               "parameters": [
                 {
-                  "name": "initData",
-                  "optional": true,
-                  "type": {
-                    "text": "I"
-                  }
-                },
-                {
-                  "name": "before",
-                  "optional": true,
+                  "name": "model",
                   "type": {
-                    "text": "boolean"
+                    "text": "FieldNode"
                   }
                 }
-              ],
-              "description": "Creates an element of type T and adds it to the beginning or end (default) of the ARRAY"
+              ]
             },
             {
               "kind": "method",
-              "name": "initFromLiteral",
+              "name": "getProps",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "Record<string, JSONSchema7Definition>"
+                }
+              },
               "parameters": [
                 {
-                  "name": "initData",
+                  "name": "model",
                   "type": {
-                    "text": "I[]"
+                    "text": "FieldNode"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "__mapProtoNameJsonToJson",
+              "name": "getRequiredFields",
+              "privacy": "private",
+              "static": true,
               "return": {
                 "type": {
-                  "text": "any"
+                  "text": "string[]"
                 }
               },
               "parameters": [
                 {
-                  "name": "data",
+                  "name": "descriptors",
                   "type": {
-                    "text": "any"
+                    "text": "FieldDescriptor[]"
                   }
                 }
-              ],
-              "description": "creates a literal type from a json type",
-              "inheritedFrom": {
-                "name": "FieldNode",
-                "module": "dist/FieldNode.js"
-              }
+              ]
             },
             {
               "kind": "method",
-              "name": "__updateWithLiteral",
+              "name": "getConstraints",
+              "privacy": "private",
+              "static": true,
               "parameters": [
                 {
-                  "name": "initData",
+                  "name": "constraints",
                   "type": {
-                    "text": "I[]"
+                    "text": "FieldConstraints | undefined"
                   }
                 }
-              ],
-              "description": "Updates the model from literal data, without changing the validity and value state.",
-              "inheritedFrom": {
-                "name": "FieldNode",
-                "module": "dist/FieldNode.js"
-              }
+              ]
             },
             {
               "kind": "method",
-              "name": "__getFieldNodeByPath",
+              "name": "createFieldNodeFromSchema",
+              "privacy": "public",
+              "static": true,
               "return": {
                 "type": {
-                  "text": "FieldNode | undefined"
+                  "text": "FieldNode"
                 }
               },
               "parameters": [
                 {
-                  "name": "deepPath",
-                  "default": "\"\""
-                }
-              ],
-              "description": "Get a FieldNode by giving a field path using the proto names for the fields.\n\n\n\n- `email_addresses[3].type[2]` for the second `type` value in the third `email_addresses` message.\n- `user.location.street` for the street in location in user.",
-              "inheritedFrom": {
-                "name": "FieldNode",
-                "module": "dist/FieldNode.js"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "__notifyArrayChanges",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "bubbles",
-                  "optional": true,
+                  "name": "schema",
                   "type": {
-                    "text": "boolean"
+                    "text": "FieldNodeSchema"
                   }
                 }
               ]
-            },
-            {
-              "kind": "field",
-              "name": "__childNodes",
-              "type": {
-                "text": "any[]"
-              },
-              "privacy": "public",
-              "description": "Returns the child nodes of a node.",
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SchemaBuilder",
+          "declaration": {
+            "name": "SchemaBuilder",
+            "module": "src/decorators/SchemaBuilder.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/decorators/ServiceDecorators.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "ServiceBindings",
+          "parameters": [
+            {
+              "name": "service",
+              "type": {
+                "text": "EventTarget"
+              },
+              "description": "The EventTarget service to bind to"
+            }
+          ],
+          "description": "### ServiceBindings Factory\n\nCreates type-safe decorators bound to a specific service instance.\nUse this to bind component properties and methods to service events.\n\nThe factory is generic and works with any `EventTarget`.\nEvent types and their detail payloads are type-checked at compile time\nvia the `TEventMap` type parameter.\n\nUsage:\n```typescript\nimport { cubeEntityService } from \"./CubeEntityService\";\nimport { ServiceBindings } from \"./ServiceDecorators\";\n\nconst cube = ServiceBindings(cubeEntityService);\n\nclass MyComponent extends LitElement {\n  // Property binding - type-safe event name, auto-extracts from detail",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ServiceBindings",
+          "declaration": {
+            "name": "ServiceBindings",
+            "module": "src/decorators/ServiceDecorators.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/proxies/ARRAY.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ARRAY",
+          "members": [
+            {
+              "kind": "field",
+              "name": "_value",
+              "type": {
+                "text": "T[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "___Constructor",
+              "type": {
+                "text": "(new () => T) | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "method",
+              "name": "add",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "T"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "initData",
+                  "optional": true,
+                  "type": {
+                    "text": "I"
+                  }
+                },
+                {
+                  "name": "before",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Creates an element of type T and adds it to the beginning or end (default) of the ARRAY"
+            },
+            {
+              "kind": "method",
+              "name": "initFromLiteral",
+              "parameters": [
+                {
+                  "name": "initData",
+                  "type": {
+                    "text": "I[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "__mapProtoNameJsonToJson",
+              "return": {
+                "type": {
+                  "text": "any"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "data",
+                  "type": {
+                    "text": "any"
+                  }
+                }
+              ],
+              "description": "creates a literal type from a json type",
+              "inheritedFrom": {
+                "name": "FieldNode",
+                "module": "dist/FieldNode.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "__updateWithLiteral",
+              "parameters": [
+                {
+                  "name": "initData",
+                  "type": {
+                    "text": "I[]"
+                  }
+                }
+              ],
+              "description": "Updates the model from literal data, without changing the validity and value state.",
+              "inheritedFrom": {
+                "name": "FieldNode",
+                "module": "dist/FieldNode.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "__getFieldNodeByPath",
+              "return": {
+                "type": {
+                  "text": "FieldNode | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "deepPath",
+                  "default": "\"\""
+                }
+              ],
+              "description": "Get a FieldNode by giving a field path using the proto names for the fields.\n\n\n\n- `email_addresses[3].type[2]` for the second `type` value in the third `email_addresses` message.\n- `user.location.street` for the street in location in user.",
+              "inheritedFrom": {
+                "name": "FieldNode",
+                "module": "dist/FieldNode.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "__notifyArrayChanges",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "bubbles",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "__childNodes",
+              "type": {
+                "text": "any[]"
+              },
+              "privacy": "public",
+              "description": "Returns the child nodes of a node.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "FieldNode",
@@ -7306,290 +7597,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "dist/decorators/DefaultServiceEventHandlers.js",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "DefaultServiceEventHandlers",
-          "parameters": [
-            {
-              "name": "dispatch",
-              "type": {
-                "text": "DispatchFn"
-              },
-              "description": "Function to dispatch events (typically bound to the service's dispatchEvent)"
-            },
-            {
-              "name": "options",
-              "default": "{}",
-              "type": {
-                "text": "DefaultServiceEventHandlersOptions"
-              },
-              "description": "Optional configuration"
-            }
-          ],
-          "description": "### DefaultServiceEventHandlers\n\nCreates default service handlers that dispatch standard events.\nUse this to reduce boilerplate when setting up service handlers.\n\nThe `onResponse` handler is intentionally NOT included - you must provide your own\nimplementation since response handling is typically service-specific.\n\nUsage:\n```typescript\nclass MyEntityService extends EventTarget {\n  private dispatch = createDispatch(this);\n\n  setupHandlers() {\n    this.service.Get.setHandlers({\n      ...DefaultServiceEventHandlers(this.dispatch),\n      onResponse: (response, serverResponse) => {\n        // Your custom response handling\n        this.entity.fromLiteral(response.entity);\n        this.dispatch(\"response-received\", { response, serverResponse });\n      },\n    });\n  }\n}\n```\n\nWith loading check:\n```typescript\nthis.service.Get.setHandlers({\n  ...DefaultServiceEventHandlers(this.dispatch, {\n    isLoading: () => this.service.Get.isLoading || this.service.Update.isLoading,\n  }),\n  onResponse: (response, serverResponse) => { ... },\n});\n```",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          }
-        },
-        {
-          "kind": "function",
-          "name": "CreateDispatch",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "target",
-              "type": {
-                "text": "EventTarget"
-              },
-              "description": "The EventTarget to dispatch events on"
-            }
-          ],
-          "description": "### createDispatch\n\nHelper to create a typed dispatch function for an EventTarget.\n\nUsage:\n```typescript\nclass MyService extends EventTarget {\n  private dispatch = createDispatch(this);\n\n  doSomething() {\n    this.dispatch(\"busy-changed\", { busy: true });\n  }\n}\n```"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "DefaultServiceEventHandlers",
-          "declaration": {
-            "name": "DefaultServiceEventHandlers",
-            "module": "src/decorators/DefaultServiceEventHandlers.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "CreateDispatch",
-          "declaration": {
-            "name": "CreateDispatch",
-            "module": "src/decorators/DefaultServiceEventHandlers.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "dist/decorators/EntityServiceTypes.js",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "dist/decorators/FieldBindings.js",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "fieldBindings",
-          "type": {
-            "text": "object"
-          },
-          "default": "{ /** * 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: object, propertyKey: string) { const ctor = target.constructor as typeof ReactiveElement; // Patch lifecycle patchLifecycle(ctor); // Add writeToModel helper method if (!Object.prototype.hasOwnProperty.call(target, \"writeToModel\")) { Object.defineProperty(target, \"writeToModel\", { value: function writeToModel(this: LitElement & Record<symbol, (() => void) | undefined>) { const writeFn = this[MODEL_WRITE_FN]; if (writeFn) { try { writeFn(); } catch (e) { 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(this: LitElement & Record<symbol, FieldNodeLike | undefined>): FieldNodeLike | undefined { return this[CURRENT_MODEL]; }, set(this: LitElement & BindableComponent & Record<symbol, FieldNodeLike | (() => void) | undefined>, value: FieldNodeLike | undefined) { const oldModel = this[CURRENT_MODEL] as FieldNodeLike | undefined; 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 // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) const reader = this.modelReaders?.get(typeName); if (reader) { this[MODEL_READ_FN] = reader.bind(this); } else { // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) console.warn(`No modelReader for type \"${typeName}\". Available: ${[...(this.modelReaders?.keys() ?? [])].join(\", \")}`); this[MODEL_READ_FN] = undefined; } // Resolve writer // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) const writer = this.modelWriters?.get(typeName); if (writer) { this[MODEL_WRITE_FN] = writer.bind(this); } else { // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) 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: ModelEventType) { return function onEventDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) { // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment const originalMethod = descriptor.value; const ctor = target.constructor as typeof ReactiveElement; let events = (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS]; // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) if (!events) { events = []; (ctor as unknown as Record<symbol, FieldEventMeta[]>)[FIELD_EVENTS] = events; } // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment events.push({ propertyKey, eventType, method: originalMethod }); patchLifecycle(ctor); }; }, /** * Decorator that marks a method to be called once after a new model is assigned and bound. * * Useful for one-time setup like setting a11y attributes, placeholders, or constraints * based on the model's type. * * @example * ```typescript * @fieldBindings.onInit() * protected init() { * this.accessibleName = this.model?.__label ?? \"Toggle\"; * } * ``` */ onInit() { return function onInitDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) { // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment const originalMethod = descriptor.value; const ctor = target.constructor as typeof ReactiveElement; // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type let inits = (ctor as unknown as Record<symbol, { propertyKey: string; method: Function }[]>)[FIELD_INIT_METHODS]; // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime data may not match types (REST API input) if (!inits) { inits = []; // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type (ctor as unknown as Record<symbol, { propertyKey: string; method: Function }[]>)[FIELD_INIT_METHODS] = inits; } // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment inits.push({ propertyKey, method: originalMethod }); patchLifecycle(ctor); }; }, }",
-          "description": "### fieldBindings\n\nDecorators for creating reusable components that bind to FieldNode models.\n\nThe 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"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "fieldBindings",
-          "declaration": {
-            "name": "fieldBindings",
-            "module": "src/decorators/FieldBindings.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "dist/decorators/ModelDecorators.js",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "ModelBindings",
-          "parameters": [
-            {
-              "name": "model",
-              "type": {
-                "text": "FieldNodeLike"
-              },
-              "description": "The FieldNode model to bind to"
-            }
-          ],
-          "description": "### ModelBindings Factory\n\nCreates type-safe decorators bound to a specific FieldNode model.\nUse this to bind component properties and methods to model events.\n\nUsage:\n```typescript\nimport { ModelBindings } from \"@x/furo/open-models/ModelDecorators\";\nimport { CubeEntityModel } from \"./CubeEntityModel\";\n\nconst cubeModel = ModelBindings(CubeEntityModel.model);\n\nclass MyComponent extends LitElement {\n  // Triggers re-render on any model update",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          }
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "ModelBindings",
-          "declaration": {
-            "name": "ModelBindings",
-            "module": "src/decorators/ModelDecorators.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "dist/decorators/SchemaBuilder.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SchemaBuilder",
-          "members": [
-            {
-              "kind": "method",
-              "name": "generate",
-              "privacy": "public",
-              "static": true,
-              "return": {
-                "type": {
-                  "text": "JSONSchema7"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "model",
-                  "type": {
-                    "text": "FieldNode"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "getProps",
-              "privacy": "private",
-              "static": true,
-              "return": {
-                "type": {
-                  "text": "Record<string, JSONSchema7Definition>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "model",
-                  "type": {
-                    "text": "FieldNode"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "getRequiredFields",
-              "privacy": "private",
-              "static": true,
-              "return": {
-                "type": {
-                  "text": "string[]"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "descriptors",
-                  "type": {
-                    "text": "FieldDescriptor[]"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "getConstraints",
-              "privacy": "private",
-              "static": true,
-              "parameters": [
-                {
-                  "name": "constraints",
-                  "type": {
-                    "text": "FieldConstraints | undefined"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "createFieldNodeFromSchema",
-              "privacy": "public",
-              "static": true,
-              "return": {
-                "type": {
-                  "text": "FieldNode"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "schema",
-                  "type": {
-                    "text": "FieldNodeSchema"
-                  }
-                }
-              ]
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SchemaBuilder",
-          "declaration": {
-            "name": "SchemaBuilder",
-            "module": "src/decorators/SchemaBuilder.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "dist/decorators/ServiceDecorators.js",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "ServiceBindings",
-          "parameters": [
-            {
-              "name": "service",
-              "type": {
-                "text": "EventTarget"
-              },
-              "description": "The EventTarget service to bind to"
-            }
-          ],
-          "description": "### ServiceBindings Factory\n\nCreates type-safe decorators bound to a specific service instance.\nUse this to bind component properties and methods to service events.\n\nThe factory is generic and works with any `EventTarget`.\nEvent types and their detail payloads are type-checked at compile time\nvia the `TEventMap` type parameter.\n\nUsage:\n```typescript\nimport { cubeEntityService } from \"./CubeEntityService\";\nimport { ServiceBindings } from \"./ServiceDecorators\";\n\nconst cube = ServiceBindings(cubeEntityService);\n\nclass MyComponent extends LitElement {\n  // Property binding - type-safe event name, auto-extracts from detail",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          }
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "ServiceBindings",
-          "declaration": {
-            "name": "ServiceBindings",
-            "module": "src/decorators/ServiceDecorators.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "dist/primitives/BOOLEAN.js",