/** * @license * Copyright 2022-2026 Matter.js Authors * SPDX-License-Identifier: Apache-2.0 */ import { Access } from "#aspects/index.js"; import { FieldSemantics } from "#decoration/semantics/FieldSemantics.js"; import { AttributeModel } from "#models/AttributeModel.js"; import { ValueModel } from "#models/ValueModel.js"; import { Decorator } from "@matter/general"; import { element } from "./element.js"; const defaultAttributeAccess = Decorator((_target, context) => { const model = FieldSemantics.of(context).mutableModel; if (model instanceof ValueModel && model.access.rw === undefined) { model.access = new Access({ ...model.access, rw: Access.Rw.Read, readPriv: Access.Privilege.View }); } }); /** * Decorates a property as a Matter attribute. * * Decorator-declared attributes default to read-only access (`R V`) — the Matter spec convention for read-only * attributes. Apply the `writable` decorator to mark an attribute as writable; that yields `RW V O` via * `Access.Default` extension. * * `readPriv: View` must be set alongside `rw: Read` in the default: without it `Access.isEmpty` reports true and * `Access.extend` discards the value during effective-access resolution, silently reinstating `Access.Default` * (`RW V O`). */ export const attribute = (...modifiers: element.Modifier[]) => element(AttributeModel, defaultAttributeAccess, ...modifiers);