@matter/model 0.16.0-alpha.0-20251018-dd1ea6a8a → 0.16.0-alpha.0-20251020-3f6e46245

package/dist/esm/decoration/decorators/nullable.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Quality } from "#aspects/Quality.js";
+import { InvalidMetadataError } from "#decoration/errors.js";
+import { FieldSemantics } from "#decoration/semantics/FieldSemantics.js";
+import { Decorator } from "#general";
+import { ValueModel } from "#models/ValueModel.js";
+const nullable = Decorator((_target, context) => {
+  const model = FieldSemantics.of(context).mutableModel;
+  if (!(model instanceof ValueModel)) {
+    throw new InvalidMetadataError("Only value models may be nullable");
+  }
+  model.quality = new Quality({ ...model.quality, nullable: true });
+});
+export {
+  nullable
+};
+//# sourceMappingURL=nullable.js.map

package/dist/esm/decoration/decorators/nullable.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/decoration/decorators/nullable.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,eAAe;AACxB,SAAS,4BAA4B;AACrC,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAKpB,MAAM,WAAW,UAAuC,CAAC,SAAS,YAAY;AACjF,QAAM,QAAQ,eAAe,GAAG,OAAO,EAAE;AACzC,MAAI,EAAE,iBAAiB,aAAa;AAChC,UAAM,IAAI,qBAAqB,mCAAmC;AAAA,EACtE;AACA,QAAM,UAAU,IAAI,QAAQ,EAAE,GAAG,MAAM,SAAS,UAAU,KAAK,CAAC;AACpE,CAAC;",
+  "names": []
+}

package/dist/esm/decoration/decorators/response.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Decorator } from "#general";
+import { DatatypeModel } from "#models/DatatypeModel.js";
+/**
+ * Specify the response type for a command.
+ */
+export declare function response(type: DatatypeModel): Decorator.ClassMethod;
+//# sourceMappingURL=response.d.ts.map

package/dist/esm/decoration/decorators/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../../src/decoration/decorators/response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC,WAAW,CAkBnE"}

package/dist/esm/decoration/decorators/response.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FieldSemantics } from "#decoration/semantics/FieldSemantics.js";
+import { CommandElement } from "#elements/CommandElement.js";
+import { Decorator } from "#general";
+import { CommandModel } from "#models/CommandModel.js";
+function response(type) {
+  return Decorator((_target, context) => {
+    const requestSemantics = FieldSemantics.of(context);
+    requestSemantics.modelType = CommandModel;
+    const request = requestSemantics.mutableModel;
+    const name = `${request.name}Response`;
+    new CommandModel({
+      name,
+      id: request.id,
+      parent: request.parent,
+      direction: CommandElement.Direction.Response,
+      operationalBase: type
+    });
+    request.response = name;
+  });
+}
+export {
+  response
+};
+//# sourceMappingURL=response.js.map

package/dist/esm/decoration/decorators/response.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/decoration/decorators/response.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;AAMtB,SAAS,SAAS,MAA4C;AACjE,SAAO,UAAU,CAAC,SAAS,YAAY;AACnC,UAAM,mBAAmB,eAAe,GAAG,OAAO;AAElD,qBAAiB,YAAY;AAC7B,UAAM,UAAU,iBAAiB;AAEjC,UAAM,OAAO,GAAG,QAAQ,IAAI;AAC5B,QAAI,aAAa;AAAA,MACb;AAAA,MACA,IAAI,QAAQ;AAAA,MACZ,QAAQ,QAAQ;AAAA,MAChB,WAAW,eAAe,UAAU;AAAA,MACpC,iBAAiB;AAAA,IACrB,CAAC;AAED,YAAQ,WAAW;AAAA,EACvB,CAAC;AACL;",
+  "names": []
+}

package/dist/esm/decoration/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "#general";
+export declare class MetadataError extends ImplementationError {
+}
+/**
+ * Thrown when a type is assigned to a class or property that is already typed.
+ */
+export declare class MetadataConflictError extends MetadataError {
+}
+/**
+ * Thrown when metadata is inappropriate for the decorated language element.
+ */
+export declare class InvalidMetadataError extends MetadataError {
+}
+/**
+ * Thrown when an error occurs instantiating a dummy instance of a class for introspection purposes.
+ */
+export declare class ClassIntrospectionError extends MetadataError {
+}
+/**
+ * Thrown when required metadata is missing.
+ */
+export declare class MissingMetadataError extends MetadataError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/decoration/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/decoration/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,qBAAa,aAAc,SAAQ,mBAAmB;CAAG;AAEzD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;CAAG;AAE3D;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAE1D;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;CAAG;AAE7D;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;CAAG"}

package/dist/esm/decoration/errors.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "#general";
+class MetadataError extends ImplementationError {
+}
+class MetadataConflictError extends MetadataError {
+}
+class InvalidMetadataError extends MetadataError {
+}
+class ClassIntrospectionError extends MetadataError {
+}
+class MissingMetadataError extends MetadataError {
+}
+export {
+  ClassIntrospectionError,
+  InvalidMetadataError,
+  MetadataConflictError,
+  MetadataError,
+  MissingMetadataError
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/decoration/errors.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/decoration/errors.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAE7B,MAAM,sBAAsB,oBAAoB;AAAC;AAKjD,MAAM,8BAA8B,cAAc;AAAC;AAKnD,MAAM,6BAA6B,cAAc;AAAC;AAKlD,MAAM,gCAAgC,cAAc;AAAC;AAKrD,MAAM,6BAA6B,cAAc;AAAC;",
+  "names": []
+}

package/dist/esm/decoration/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./decorators/index.js";
+export * from "./errors.js";
+export * from "./semantics/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/decoration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decoration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/esm/decoration/index.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./decorators/index.js";
+export * from "./errors.js";
+export * from "./semantics/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/decoration/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/decoration/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/decoration/semantics/ClassSemantics.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Model } from "#models/index.js";
+import { FieldSemantics } from "./FieldSemantics.js";
+import { Semantics } from "./Semantics.js";
+/**
+ * Matter semantic metadata attached to a class via decorators.
+ *
+ * We use decorators to allow for definition of model elements in the context of a specific type.
+ *
+ * Currently there are JavaScript/TypeScript limitations to be aware of when decorating type definitions:
+ *
+ *   * Decorators may only be applied to JavaScript classes.  So if you want to define an interface without
+ *     implementation, you must implement as a class and use as an interface.  That's why this is "class" metadata.
+ *
+ *   * Decorators may not affect the TypeScript type of an object.  This means that you must define both the Matter type
+ *     (e.g. {@link uint32}) and TypeScript type (e.g. `number`).
+ */
+export declare class ClassSemantics extends Semantics {
+    #private;
+    /**
+     * The model that represents the semantics for this class.
+     *
+     * This may be {@link localModel} or {@link prototypeBaseModel}
+     */
+    get semanticModel(): Model<import("../../index.js").BaseElement, Model<import("../../index.js").BaseElement, any>> | undefined;
+    /**
+     * Get the class constructor
+     */
+    get new(): ClassSemantics.Constructor | undefined;
+    /**
+     * Assign the constructor for the class.
+     */
+    set new(fn: ClassSemantics.Constructor);
+    /**
+     * The class {@link Model} inherited from {@link new}'s prototype chain, if any.
+     */
+    get prototypeBaseModel(): Model | undefined;
+    /**
+     * Obtain a {@link FieldSemantics} for the named field.
+     */
+    fieldFor(name: string | symbol): FieldSemantics;
+    /**
+     * Add logical fields for unrecognized members of an object.
+     *
+     * This extends the model with untyped fields for properties that are not otherwise typed.
+     */
+    defineUnknownMembers(instance: unknown): void;
+    /**
+     * Obtain the {@link ClassSemantics} for {@link source}.
+     */
+    static of(source: ClassSemantics.Source): ClassSemantics;
+    /**
+     * Determine {@link new} has semantic decoration.
+     */
+    static hasOwnSemantics(source: ClassSemantics.Constructor): boolean;
+    /**
+     * Access the {@link ClassSemantics} of {@link new} if it is defined.
+     */
+    static maybeOf(source: ClassSemantics.Constructor): ClassSemantics | undefined;
+    finalize(): void;
+    protected integrateModel(model: Model): Model<import("../../index.js").BaseElement, Model<import("../../index.js").BaseElement, any>>;
+    protected createModel(type?: Model.ConcreteType): Model<import("../../index.js").BaseElement, Model<import("../../index.js").BaseElement, any>>;
+}
+export declare namespace ClassSemantics {
+    /**
+     * A standard constructor with an optional decoration extension point.
+     */
+    interface Constructor extends NewableFunction {
+        /**
+         * If present, invoked for custom decoration after installing constructor.
+         */
+        [extend]?: (semantics: ClassSemantics) => void;
+    }
+    /**
+     * An object for which you may obtain {@link ClassSemantics}.
+     */
+    type Source = Constructor | DecoratorContext | ClassSemantics;
+    const extend: unique symbol;
+}
+//# sourceMappingURL=ClassSemantics.d.ts.map

package/dist/esm/decoration/semantics/ClassSemantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassSemantics.d.ts","sourceRoot":"","sources":["../../../../src/decoration/semantics/ClassSemantics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAA6B,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAMpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAmB3C;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,SAAS;;IAIzC;;;;OAIG;IACH,IAAI,aAAa,8GAahB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,cAAc,CAAC,WAAW,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAI,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,WAAW,EA6BrC;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,KAAK,GAAG,SAAS,CAsB1C;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAmB9B;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,OAAO;IAuDtC;;OAEG;WACa,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM;IAuChD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,WAAW;IAIzD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,WAAW;IAUxC,QAAQ;cA6CE,cAAc,CAAC,KAAK,EAAE,KAAK;cAoB3B,WAAW,CAAC,IAAI,GAAE,KAAK,CAAC,YAA4B;CAO1E;AAED,yBAAiB,cAAc,CAAC;IAC5B;;OAEG;IACH,UAAiB,WAAY,SAAQ,eAAe;QAChD;;WAEG;QACH,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;KAClD;IAED;;OAEG;IACH,KAAY,MAAM,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAE9D,MAAM,MAAM,eAAmB,CAAC;CAC1C"}

package/dist/esm/decoration/semantics/ClassSemantics.js

@@ -0,0 +1,246 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DatatypeModel } from "#models/index.js";
+import { camelize } from "#general";
+import { Scope } from "#logic/Scope.js";
+import { any, struct } from "#standard/elements/models.js";
+import { InvalidMetadataError, MetadataConflictError } from "../errors.js";
+import { FieldSemantics } from "./FieldSemantics.js";
+import { Semantics } from "./Semantics.js";
+const matter = Symbol("matter");
+class ClassSemantics extends Semantics {
+  #new;
+  #definedFields;
+  /**
+   * The model that represents the semantics for this class.
+   *
+   * This may be {@link localModel} or {@link prototypeBaseModel}
+   */
+  get semanticModel() {
+    if (this.localModel) {
+      return this.localModel;
+    }
+    if (this.#definedFields) {
+      return this.mutableModel;
+    }
+    return this.prototypeBaseModel;
+  }
+  /**
+   * Get the class constructor
+   */
+  get new() {
+    return this.#new;
+  }
+  /**
+   * Assign the constructor for the class.
+   */
+  set new(fn) {
+    if (this.#new === fn) {
+      return;
+    }
+    if (this.isFinal) {
+      throw new MetadataConflictError(
+        `Cannot install semantic constructor ${fn.name} because semantics are final`
+      );
+    }
+    this.#new = fn;
+    if (this.localModel && !this.localModel.isFinal && this.localModel.name !== this.#new?.name) {
+      this.localModel.name = this.#new?.name;
+    }
+    if (this.localModel) {
+      this.#applyBaseSemantics();
+    } else {
+      const base = this.prototypeBaseModel;
+      if (base !== void 0) {
+        this.mutableModel = base;
+      }
+    }
+  }
+  /**
+   * The class {@link Model} inherited from {@link new}'s prototype chain, if any.
+   */
+  get prototypeBaseModel() {
+    let current = this.#new?.prototype;
+    let base;
+    while (current) {
+      current = Object.getPrototypeOf(current);
+      if (typeof current !== "object" || current === null) {
+        return;
+      }
+      const constructor = current.constructor;
+      if (constructor === Object) {
+        return;
+      }
+      base = ClassSemantics.maybeOf(constructor);
+      if (base?.localModel) {
+        base.finalize();
+        return base.localModel;
+      }
+    }
+  }
+  /**
+   * Obtain a {@link FieldSemantics} for the named field.
+   */
+  fieldFor(name) {
+    if (typeof name !== "string") {
+      throw new InvalidMetadataError(`Cannot decorate symbolic function ${String(name)}`);
+    }
+    if (this.#definedFields === void 0) {
+      this.#definedFields = /* @__PURE__ */ new Map();
+    }
+    let field = this.#definedFields.get(name);
+    if (field === void 0) {
+      if (this.isFinal) {
+        throw new MetadataConflictError(`Cannot install field ${name} because semantics are final`);
+      }
+      this.#definedFields.set(name, field = new FieldSemantics(this, name));
+    }
+    return field;
+  }
+  /**
+   * Add logical fields for unrecognized members of an object.
+   *
+   * This extends the model with untyped fields for properties that are not otherwise typed.
+   */
+  defineUnknownMembers(instance) {
+    if (instance === void 0 || instance === null) {
+      return;
+    }
+    const known = this.semanticModel ? new Set(
+      Scope(this.semanticModel).membersOf(this.semanticModel).map((model) => camelize(model.name))
+    ) : /* @__PURE__ */ new Set();
+    const descriptors = Object.getOwnPropertyDescriptors(instance);
+    for (const name in descriptors) {
+      if (known.has(camelize(name))) {
+        continue;
+      }
+      if (typeof name !== "string") {
+        continue;
+      }
+      const descriptor = descriptors[name];
+      if (descriptor.set && !descriptor.get) {
+        continue;
+      }
+      try {
+        if (typeof instance[name] === "function") {
+          continue;
+        }
+      } catch (e) {
+        continue;
+      }
+      const model = this.fieldFor(name).mutableModel;
+      model.operationalBase = any;
+      if (!descriptor.writable && !descriptor.set) {
+        model.quality = { ...model.quality, fixed: true };
+      }
+      this.fieldFor(name).mutableModel.operationalBase = any;
+    }
+  }
+  /**
+   * Obtain the {@link ClassSemantics} for {@link source}.
+   */
+  static of(source) {
+    if (source instanceof ClassSemantics) {
+      return source;
+    }
+    if (typeof source !== "function") {
+      const metadata2 = source.metadata;
+      if (Object.hasOwn(metadata2, matter)) {
+        return metadata2[matter];
+      }
+      return metadata2[matter] = new ClassSemantics();
+    }
+    let metadata;
+    if (!Object.hasOwn(source, Symbol.metadata)) {
+      metadata = source[Symbol.metadata] = {};
+    } else {
+      metadata = source[Symbol.metadata];
+    }
+    let semantics;
+    if (!Object.hasOwn(metadata, matter)) {
+      semantics = metadata[matter] = new ClassSemantics();
+    } else {
+      semantics = metadata[matter];
+    }
+    if (!semantics.new) {
+      semantics.new = source;
+    }
+    return semantics;
+  }
+  /**
+   * Determine {@link new} has semantic decoration.
+   */
+  static hasOwnSemantics(source) {
+    return Object.hasOwn(source, Symbol.metadata) && Object.hasOwn(source[Symbol.metadata], matter);
+  }
+  /**
+   * Access the {@link ClassSemantics} of {@link new} if it is defined.
+   */
+  static maybeOf(source) {
+    if (this.hasOwnSemantics(source)) {
+      return ClassSemantics.of(source);
+    }
+  }
+  static {
+    Semantics.classOf = this.of;
+  }
+  finalize() {
+    if (this.isFinal) {
+      return;
+    }
+    this.#new?.[ClassSemantics.extend]?.(this);
+    super.finalize();
+    if (this.#definedFields) {
+      for (const field of this.#definedFields.values()) {
+        field.finalize();
+      }
+    }
+  }
+  #applyBaseSemantics() {
+    const base = this.prototypeBaseModel;
+    if (base === void 0) {
+      return;
+    }
+    const { type, base: currentBase } = this.mutableModel;
+    if (type === void 0 && (currentBase === void 0 || currentBase === struct)) {
+      const operationalBase = this.prototypeBaseModel;
+      if (operationalBase) {
+        this.mutableModel.operationalBase = operationalBase;
+      }
+    }
+    if (base && base.tag !== "datatype" && this.mutableModel.tag !== base.tag) {
+      this.modelType = base.constructor;
+    }
+    if (this.mutableModel.id === void 0 && base.id !== void 0) {
+      this.mutableModel.id = base.id;
+    }
+  }
+  integrateModel(model) {
+    if (this.localModel === void 0 || this.localModel.isFinal) {
+      return model;
+    }
+    if (model.isFinal) {
+      this.localModel.operationalBase = model;
+      return this.localModel;
+    }
+    model.children.push(...this.localModel.children);
+    return model;
+  }
+  createModel(type = DatatypeModel) {
+    let name = this.#new?.name;
+    if (name === void 0 || name === "") {
+      name = "Unnamed";
+    }
+    return new type({ name, operationalBase: struct });
+  }
+}
+((ClassSemantics2) => {
+  ClassSemantics2.extend = Symbol("extend");
+})(ClassSemantics || (ClassSemantics = {}));
+export {
+  ClassSemantics
+};
+//# sourceMappingURL=ClassSemantics.js.map

package/dist/esm/decoration/semantics/ClassSemantics.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/decoration/semantics/ClassSemantics.ts"],
+  "mappings": "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",
+  "names": ["metadata", "ClassSemantics"]
+}

package/dist/esm/decoration/semantics/FieldSemantics.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Model } from "#models/Model.js";
+import type { ClassSemantics } from "./ClassSemantics.js";
+import { Semantics } from "./Semantics.js";
+/**
+ * Decorator metadata associated with a specific class field.
+ */
+export declare class FieldSemantics extends Semantics {
+    constructor(owner: ClassSemantics, name: string);
+    protected createModel(): Model;
+    protected integrateModel(model: Model): Model;
+    static of(source: FieldSemantics.Source): FieldSemantics;
+}
+export declare namespace FieldSemantics {
+    type Source = DecoratorContext;
+}
+//# sourceMappingURL=FieldSemantics.d.ts.map

package/dist/esm/decoration/semantics/FieldSemantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldSemantics.d.ts","sourceRoot":"","sources":["../../../../src/decoration/semantics/FieldSemantics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAC7B,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM;cAM5B,WAAW,IAAI,KAAK;cAKpB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;WAQtC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM;CAQnD;AAED,yBAAiB,cAAc,CAAC;IAC5B,KAAY,MAAM,GAAG,gBAAgB,CAAC;CACzC"}

package/dist/esm/decoration/semantics/FieldSemantics.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvalidMetadataError } from "#decoration/errors.js";
+import { InternalError } from "#general";
+import { FieldModel } from "#models/FieldModel.js";
+import { Semantics } from "./Semantics.js";
+class FieldSemantics extends Semantics {
+  constructor(owner, name) {
+    super();
+    this.mutableModel = new FieldModel({ name, parent: owner.mutableModel });
+  }
+  createModel() {
+    throw new InternalError("Unexpected FieldSemantics.createModel");
+  }
+  integrateModel(model) {
+    if (this.localModel === void 0) {
+      return model;
+    }
+    this.mutableModel.operationalBase = model;
+    return this.mutableModel;
+  }
+  static of(source) {
+    if (source.kind === "class") {
+      throw new InvalidMetadataError(
+        `Cannot retrieve field semantics for class decorator ${source.name ?? "of anonymous class"}`
+      );
+    }
+    return Semantics.classOf(source).fieldFor(source.name);
+  }
+}
+export {
+  FieldSemantics
+};
+//# sourceMappingURL=FieldSemantics.js.map

package/dist/esm/decoration/semantics/FieldSemantics.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/decoration/semantics/FieldSemantics.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,4BAA4B;AACrC,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAG3B,SAAS,iBAAiB;AAKnB,MAAM,uBAAuB,UAAU;AAAA,EAC1C,YAAY,OAAuB,MAAc;AAC7C,UAAM;AAEN,SAAK,eAAe,IAAI,WAAW,EAAE,MAAM,QAAQ,MAAM,aAAa,CAAC;AAAA,EAC3E;AAAA,EAEmB,cAAqB;AAEpC,UAAM,IAAI,cAAc,uCAAuC;AAAA,EACnE;AAAA,EAEmB,eAAe,OAAqB;AACnD,QAAI,KAAK,eAAe,QAAW;AAC/B,aAAO;AAAA,IACX;AACA,SAAK,aAAa,kBAAkB;AACpC,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,OAAgB,GAAG,QAA+B;AAC9C,QAAI,OAAO,SAAS,SAAS;AACzB,YAAM,IAAI;AAAA,QACN,uDAAuD,OAAO,QAAQ,oBAAoB;AAAA,MAC9F;AAAA,IACJ;AACA,WAAO,UAAU,QAAQ,MAAM,EAAE,SAAS,OAAO,IAAI;AAAA,EACzD;AACJ;",
+  "names": []
+}