@praxisjs/decorators 1.6.1 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @praxisjs/decorators
 
+## 2.0.0
+
+### Major Changes
+
+- 75115a9: Remove the `accessor`-based APIs: `createAccessorDecorator` (with `AccessorBehavior` and `AccessorBinding`) and the `@Computed({ get, set })` form declared on an `accessor` field. Use `createFieldDecorator` with `setup` on a plain field, and a `@Computed()` getter with a `set` accessor next to it. See the migration notes in "Creating Decorators".
+
+  Add a shared `setup` form to `createFieldDecorator`, `createMethodDecorator`, `createGetterDecorator` and `createWritableGetterDecorator`: created once per decorated member, shared by every instance, with per-instance state in symbol slots and optional `init`/`onMount`/`onUnmount`. `ClassBehavior` can define `onMount(instance)`, `onUnmount(instance)` and `render(instance, originalRender)` itself, and `create` is optional. `createGetterObserverDecorator` takes `register` (per mount) and runs a cleanup returned by `observe` on unmount. Every builder takes a `label`, checks the member kind with a clear `TypeError`, and has typed `Host`/`Value` parameters.
+
+  The per-instance forms are faster: `createMethodDecorator({ wrap })` and `createWritableGetterDecorator({ bind })` call through one replacement on the class instead of defining a property on every instance (detached `wrap` methods are now bound and stack under built-in method decorators), and `@Computed()` installs its getter on the class. Fixes `@Computed()` with a `set` accessor declared next to the getter, which threw on assignment.
+
+### Minor Changes
+
+- 75115a9: Decorated fields are defined by their innermost decorator. With `@praxisjs/vite-plugin`, `@State()`, `@Prop()`, every built-in field decorator and `createFieldDecorator` bindings install their property directly with the field's initial value instead of replacing a plain value, which kept every instance in V8's slow dictionary mode. New `addClaimableInitializer(context, init)` export for field decorators written against the TC39 API.
+- 75115a9: Field decorators throw a `TypeError` when the class is defined if they decorate an `accessor`, naming the member to fix. Covers `@State()`, `@Prop()`, every built-in field decorator and `createFieldDecorator` bindings. New `assertFieldContext(context, label?)` export for field decorators written against the TC39 API directly.
+- 75115a9: Cheaper decorators per instance and per call. Method decorators (`@Bind`, `@Once`, `@Throttle`, `@Debounce`, `@Retry`, `@Log`, `@Memo`, `@Emit`, `@Until`) replace the method once on the class and bind it lazily on first read, field decorators share one accessor pair per field with per-instance state in symbol slots, lifecycle hooks chain without bound functions, and slots, `@Persisted` and `@Synced` no longer read `WeakMap`s. Fixes `@Until` on `@State` fields, a leaked registration when `onMount()` runs twice, stacked method decorators dropping all but one, and method decorators on private methods doing nothing.
+- 75115a9: Rendering and reactivity performance overhaul. `@praxisjs/core` has a new push-pull reactive graph (linked dependencies reused across runs, version-checked computeds, glitch-free effects) and keeps component internals on the instance. `@praxisjs/decorators` shares one accessor pair per `@State`/`@Prop` field, creates `@Computed` lazily, and `@Component` no longer wraps the class. `@praxisjs/runtime` adds the compiled-template helpers, a shared event dispatcher, leaner scopes and reactive children, skipped no-op prop writes, cheaper component mounting and a detached fill for large `For` renders, and fixes a static `<select>` value being lost. `@praxisjs/vite-plugin` compiles JSX trees of host elements into templates cloned per render (`templates` option, on by default).
+- 75115a9: Add a keyed selection primitive. `selector(source, equals?)` in `@praxisjs/core/internal` and the `@Selector(field, { equals })` field decorator expose `isSelected(key)`, whose subscribers are grouped by key: a change to the source re-runs only the effects that read the previous or the next key, instead of every row comparing against it. Key buckets and the source subscription are released when their effects are disposed.
+
+### Patch Changes
+
+- 75115a9: Edge-case fixes in the new fast paths. `@praxisjs/vite-plugin` keeps a claimed field's initializer in the field's own scope instead of moving it into the constructor, where a constructor parameter or local of the same name shadowed what it read (and `new.target` fields are claimed too). `selector()` from `@praxisjs/core` compares against the current source value when read outside an effect, also inside a batch or an event handler before its subscribers are notified. `@praxisjs/runtime` keeps updating a hydrated element through a reactive child that fills it alone, rebuilds compiled templates when `render()` runs with another global document (a new SSG window), and always writes `open`, `selectedIndex`, media and scroll props from reactive bindings so a re-run restores what the user changed. Compiled templates keep the leading whitespace of JSX text (`{v} / {m}` lost its first space) and keep tabs inside a line, as the JSX transform does. Methods of `@Bind`, `@Emit` and the other built-in method decorators can be spied on with `vi.spyOn(instance, name)` before their first read again. `@praxisjs/router`'s `Link` removes its `class` attribute when it stops being active instead of leaving `class=""`.
+- 75115a9: Published packages no longer contain their tests: package builds compile `src` without `src/**/__tests__` (through a `tsconfig.build.json`), and each package's `files` leaves test sources and stale compiled tests out of the tarball. `pnpm typecheck` still type-checks the tests.
+- 75115a9: Smaller production bundles. The framework and feature packages are marked `"sideEffects": false`, so bundlers leave out the modules an app does not use (`For`/`Index` and `selector()` were kept in every bundle by their shape keepers). `@praxisjs/core`'s graph gates its observer instrumentation on a boolean that minifiers fold away when no observer is ever installed. `@praxisjs/runtime` passes `Index`'s positional update to the list view, so `For`-only apps leave it out, and builds its event prop table from camel-case names. `@praxisjs/devtools` is built one file per module and its decorators check `process.env.NODE_ENV` inline, so `@Trace`/`@Debug` in production code no longer bundle the registry and the panel. `@praxisjs/vite-plugin` serves TypeScript's decorator helpers and the claimed fields' helper from one virtual module (`virtual:praxisjs/decorators`) instead of writing them into every decorated file, and replaces the identical copies `tsc` wrote into ES module libraries.
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+  - @praxisjs/core@2.3.0
+  - @praxisjs/shared@0.3.2
+
+## 1.7.0
+
+### Minor Changes
+
+- c7a5950: `@Persisted` now removes its `window` `storage` listener when the component unmounts (each instance used to leave one behind). `@DeepState` returns one stable proxy per nested object instead of a new `Proxy` per read, and no longer notifies for no-op assignments, deletes of missing keys, or the redundant `length` write of an array `push`.
+
+  `@Memo` keeps the 100 most recently used argument combinations by default (least-recently-used eviction); `@Memo({ max })` changes the limit and `Infinity` restores the unbounded cache. `@History` stops tracking on unmount.
+
+### Patch Changes
+
+- Updated dependencies [a97a37c]
+  - @praxisjs/core@2.2.0
+
 ## 1.6.1
 
 ### Patch Changes

package/dist/component/component.d.ts

@@ -1,3 +1,3 @@
 import type { ComponentConstructor, ComponentInstance } from "@praxisjs/shared/internal";
-export declare function Component(): <T extends new (...args: any[]) => ComponentInstance>(constructor: T, context: ClassDecoratorContext) => T & ComponentConstructor;
+export declare function Component(): <T extends new (...args: any[]) => ComponentInstance>(constructor: T, _context: ClassDecoratorContext) => T & ComponentConstructor;
 //# sourceMappingURL=component.d.ts.map

package/dist/component/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAuBnC,wBAAgB,SAAS,KAEN,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,iBAAiB,EAClE,aAAa,CAAC,EACd,SAAS,qBAAqB,KAC7B,CAAC,GAAG,oBAAoB,CAM5B"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAKnC,wBAAgB,SAAS,KAEN,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,iBAAiB,EAClE,aAAa,CAAC,EACd,UAAU,qBAAqB,KAC9B,CAAC,GAAG,oBAAoB,CAM5B"}

package/dist/component/component.js

@@ -1,21 +1,14 @@
 import { StatelessComponent } from "@praxisjs/core";
-import { ClassBehavior, createClassDecorator, } from "../create-class-decorator";
-class ComponentBehavior extends ClassBehavior {
-    create(_instance) {
-        return {};
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    initialize(Enhanced, original) {
-        const isStateless = original.prototype instanceof StatelessComponent;
-        Object.defineProperty(Enhanced, "__isComponent", { value: true, configurable: true });
-        Object.defineProperty(Enhanced, "__isStateless", { value: isStateless, configurable: true });
-    }
-}
-const behavior = new ComponentBehavior();
+// @Component only marks the class for the runtime. It adds no behavior, so it marks the class itself
+// instead of wrapping it in an enhanced subclass: every instance would otherwise pay for the
+// wrapper's per-instance object and per-render closure.
 export function Component() {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return function (constructor, context) {
-        return createClassDecorator(behavior)(constructor, context);
+    return function (constructor, _context) {
+        const isStateless = constructor.prototype instanceof StatelessComponent;
+        Object.defineProperty(constructor, "__isComponent", { value: true, configurable: true });
+        Object.defineProperty(constructor, "__isStateless", { value: isStateless, configurable: true });
+        return constructor;
     };
 }
 //# sourceMappingURL=component.js.map

package/dist/component/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOpD,OAAO,EACL,aAAa,EACb,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,iBAAkB,SAAQ,aAAa;IAC3C,MAAM,CAAC,SAAwB;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,8DAA8D;IAC9D,UAAU,CAAC,QAAyC,EAAE,QAAyC;QAC7F,MAAM,WAAW,GAAI,QAAQ,CAAC,SAAoB,YAAY,kBAAkB,CAAC;QACjF,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEzC,MAAM,UAAU,SAAS;IACvB,8DAA8D;IAC9D,OAAO,UACL,WAAc,EACd,OAA8B;QAE9B,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CACnC,WAAiG,EACjG,OAAO,CAC+B,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/component/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMpD,qGAAqG;AACrG,6FAA6F;AAC7F,wDAAwD;AACxD,MAAM,UAAU,SAAS;IACvB,8DAA8D;IAC9D,OAAO,UACL,WAAc,EACd,QAA+B;QAE/B,MAAM,WAAW,GAAI,WAAW,CAAC,SAAoB,YAAY,kBAAkB,CAAC;QACpF,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QAChG,OAAO,WAAuC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/dist/component/lazy.d.ts

@@ -13,5 +13,5 @@ export interface LazyOptions {
     /** Extra margin around the root before triggering (e.g. `"200px"`). Defaults to `"100px"`. */
     rootMargin?: string;
 }
-export declare function Lazy(placeholderOrOptions?: number | LazyOptions): <T extends new (...args: any[]) => RootComponent<Record<string, any>>>(constructor: T, _context: ClassDecoratorContext) => T;
+export declare function Lazy(placeholderOrOptions?: number | LazyOptions): <T extends new (...args: any[]) => RootComponent<Record<string, any>>>(constructor: T, context: ClassDecoratorContext) => T;
 //# sourceMappingURL=lazy.d.ts.map

package/dist/component/lazy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/component/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuDD,wBAAgB,IAAI,CAAC,oBAAoB,GAAE,MAAM,GAAG,WAAiB,mBAxC7D,GAAJ,0GA8CH"}
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/component/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAGnB,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+DD,wBAAgB,IAAI,CAAC,oBAAoB,GAAE,MAAM,GAAG,WAAiB,+HAMpE"}

package/dist/component/lazy.js

@@ -1,5 +1,47 @@
-import { getComponentAnchor, signal, } from "@praxisjs/core/internal";
+import { getComponentAnchor, readSignal, SignalNode, writeSignal, } from "@praxisjs/core/internal";
 import { ClassBehavior, createClassDecorator } from "../create-class-decorator";
+// One object per instance whose methods live on the prototype, instead of three closures.
+class LazyEnhancement {
+    instance;
+    options;
+    visible = new SignalNode(false);
+    observer = undefined;
+    constructor(instance, options) {
+        this.instance = instance;
+        this.options = options;
+    }
+    onMount() {
+        const el = getComponentAnchor(this.instance)?.parentElement ?? null;
+        if (!el)
+            return;
+        if (!("IntersectionObserver" in window)) {
+            writeSignal(this.visible, true);
+            return;
+        }
+        const { placeholder = 200, root, rootMargin = "100px" } = this.options;
+        if (!this.visible.value)
+            el.style.minHeight = `${String(placeholder)}px`;
+        const rootEl = root === undefined || root === null ? null : root.current ?? null;
+        this.observer = new IntersectionObserver((entries) => {
+            if (entries[0]?.isIntersecting) {
+                writeSignal(this.visible, true);
+                el.style.minHeight = "";
+                this.observer?.disconnect();
+            }
+        }, { root: rootEl, rootMargin });
+        this.observer.observe(el);
+    }
+    onUnmount() {
+        this.observer?.disconnect();
+    }
+    render(originalRender) {
+        return (() => {
+            if (!readSignal(this.visible))
+                return null;
+            return originalRender();
+        });
+    }
+}
 class LazyBehavior extends ClassBehavior {
     options;
     constructor(options) {
@@ -7,41 +49,7 @@ class LazyBehavior extends ClassBehavior {
         this.options = options;
     }
     create(instance) {
-        const { placeholder = 200, root, rootMargin = "100px" } = this.options;
-        const visible = signal(false);
-        let observer;
-        return {
-            onMount() {
-                const el = getComponentAnchor(instance)?.parentElement ?? null;
-                if (!el)
-                    return;
-                if (!("IntersectionObserver" in window)) {
-                    visible.set(true);
-                    return;
-                }
-                if (!visible())
-                    el.style.minHeight = `${String(placeholder)}px`;
-                const rootEl = root === undefined || root === null ? null : root.current ?? null;
-                observer = new IntersectionObserver((entries) => {
-                    if (entries[0]?.isIntersecting) {
-                        visible.set(true);
-                        el.style.minHeight = "";
-                        observer?.disconnect();
-                    }
-                }, { root: rootEl, rootMargin });
-                observer.observe(el);
-            },
-            onUnmount() {
-                observer?.disconnect();
-            },
-            render(originalRender) {
-                return (() => {
-                    if (!visible())
-                        return null;
-                    return originalRender();
-                });
-            },
-        };
+        return new LazyEnhancement(instance, this.options);
     }
 }
 export function Lazy(placeholderOrOptions = 200) {

package/dist/component/lazy.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/component/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,MAAM,GACP,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAyB,MAAM,2BAA2B,CAAC;AAevG,MAAM,YAAa,SAAQ,aAAa;IACT;IAA7B,YAA6B,OAAoB;QAC/C,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAa;IAEjD,CAAC;IAED,MAAM,CAAC,QAAuB;QAC5B,MAAM,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,QAA0C,CAAC;QAE/C,OAAO;YACL,OAAO;gBACL,MAAM,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,EAAE,aAAa,IAAI,IAAI,CAAC;gBAC/D,IAAI,CAAC,EAAE;oBAAE,OAAO;gBAEhB,IAAI,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC,EAAE,CAAC;oBACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAClB,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,OAAO,EAAE;oBAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;gBAEhE,MAAM,MAAM,GACV,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;gBAEpE,QAAQ,GAAG,IAAI,oBAAoB,CACjC,CAAC,OAAO,EAAE,EAAE;oBACV,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;wBAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBAClB,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;wBACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;oBACzB,CAAC;gBACH,CAAC,EACD,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAC7B,CAAC;gBAEF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;YAED,SAAS;gBACP,QAAQ,EAAE,UAAU,EAAE,CAAC;YACzB,CAAC;YAED,MAAM,CAAC,cAAc;gBACnB,OAAO,CAAC,GAAG,EAAE;oBACX,IAAI,CAAC,OAAO,EAAE;wBAAE,OAAO,IAAI,CAAC;oBAC5B,OAAO,cAAc,EAAE,CAAC;gBAC1B,CAAC,CAAoB,CAAC;YACxB,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,IAAI,CAAC,uBAA6C,GAAG;IACnE,MAAM,OAAO,GACX,OAAO,oBAAoB,KAAK,QAAQ;QACtC,CAAC,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACvC,CAAC,CAAC,oBAAoB,CAAC;IAC3B,OAAO,oBAAoB,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/component/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,UAAU,EAEV,UAAU,EACV,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAyB,MAAM,2BAA2B,CAAC;AAevG,0FAA0F;AAC1F,MAAM,eAAe;IAKA;IACA;IALF,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,QAAQ,GAAqC,SAAS,CAAC;IAE/D,YACmB,QAAuB,EACvB,OAAoB;QADpB,aAAQ,GAAR,QAAQ,CAAe;QACvB,YAAO,GAAP,OAAO,CAAa;IACpC,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,aAAa,IAAI,IAAI,CAAC;QACpE,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,IAAI,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;QAEzE,MAAM,MAAM,GACV,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QAEpE,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CACtC,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;gBAC/B,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAChC,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC,EACD,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAC7B,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,SAAS;QACP,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,cAA0C;QAC/C,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC3C,OAAO,cAAc,EAAE,CAAC;QAC1B,CAAC,CAAoB,CAAC;IACxB,CAAC;CACF;AAED,MAAM,YAAa,SAAQ,aAAa;IACT;IAA7B,YAA6B,OAAoB;QAC/C,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAa;IAEjD,CAAC;IAED,MAAM,CAAC,QAAuB;QAC5B,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,UAAU,IAAI,CAAC,uBAA6C,GAAG;IACnE,MAAM,OAAO,GACX,OAAO,oBAAoB,KAAK,QAAQ;QACtC,CAAC,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACvC,CAAC,CAAC,oBAAoB,CAAC;IAC3B,OAAO,oBAAoB,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/create-class-decorator.d.ts

@@ -1,16 +1,38 @@
 import type { RootComponent } from "@praxisjs/core/internal";
+type RenderResult = Node | Node[] | null;
 export interface ClassEnhancement {
     onMount?(): void;
     onUnmount?(): void;
-    render?(originalRender: () => Node | Node[] | null): Node | Node[] | null;
+    render?(originalRender: () => RenderResult): RenderResult;
 }
-export declare abstract class ClassBehavior {
-    abstract create(instance: RootComponent): ClassEnhancement;
+type AnyConstructor = new (...args: any[]) => unknown;
+type AnyComponent = RootComponent<Record<string, any>>;
+/**
+ * The behavior a class decorator adds. Every method is optional: hooks that take the instance
+ * (`onMount`, `onUnmount`, `render`) live on the behavior itself and allocate nothing per
+ * instance; `create` returns a per-instance `ClassEnhancement` when hooks need their own closures.
+ */
+export declare abstract class ClassBehavior<Instance extends object = AnyComponent> {
+    /** Names the decorator in error messages, e.g. `"@Analytics()"`. */
+    label?: string;
+    /** Runs once per instance, after its own constructor. */
+    create?(instance: Instance): ClassEnhancement;
+    /** Runs on every mount of each instance, after the class's own `onMount`. */
+    onMount?(instance: Instance): void;
+    /** Runs on every unmount of each instance, after the class's own `onUnmount`. */
+    onUnmount?(instance: Instance): void;
+    /** Wraps every render of each instance; `originalRender` renders the class's own output. */
+    render?(instance: Instance, originalRender: () => RenderResult): RenderResult;
     /**
      * Called once after the enhanced class is created.
      * Use this to set static properties on the class constructor itself.
      */
-    initialize?(_Enhanced: new (...args: any[]) => unknown, _original: new (...args: any[]) => unknown): void;
+    initialize?(_Enhanced: AnyConstructor, _original: AnyConstructor): void;
 }
-export declare function createClassDecorator(behavior: ClassBehavior): <T extends new (...args: any[]) => RootComponent<Record<string, any>>>(constructor: T, _context: ClassDecoratorContext) => T;
+/**
+ * Builds a class decorator from a `ClassBehavior`. The class is extended by a subclass that runs
+ * the behavior's hooks; a behavior with only `initialize` leaves the class as it is.
+ */
+export declare function createClassDecorator<Instance extends object = AnyComponent>(behavior: ClassBehavior<Instance>): <T extends new (...args: any[]) => Instance>(constructor: T, context: ClassDecoratorContext) => T;
+export {};
 //# sourceMappingURL=create-class-decorator.d.ts.map

package/dist/create-class-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-class-decorator.d.ts","sourceRoot":"","sources":["../src/create-class-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,MAAM,CAAC,CACL,cAAc,EAAE,MAAM,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,GACzC,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;CACzB;AAED,8BAAsB,aAAa;IACjC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,gBAAgB;IAE1D;;;OAGG;IAEH,UAAU,CAAC,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,IAAI;CAC1G;AAQD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,IAGxD,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EACpE,aAAa,CAAC,EAAE,UAAU,qBAAqB,KAAG,CAAC,CAyCtD"}
+{"version":3,"file":"create-class-decorator.d.ts","sourceRoot":"","sources":["../src/create-class-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,KAAK,YAAY,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,MAAM,CAAC,CAAC,cAAc,EAAE,MAAM,YAAY,GAAG,YAAY,CAAC;CAC3D;AAGD,KAAK,cAAc,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;AAEtD,KAAK,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAEvD;;;;GAIG;AACH,8BAAsB,aAAa,CAAC,QAAQ,SAAS,MAAM,GAAG,YAAY;IACxE,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,MAAM,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB;IAE7C,6EAA6E;IAC7E,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAElC,iFAAiF;IACjF,SAAS,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAEpC,4FAA4F;IAC5F,MAAM,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,GAAG,YAAY;IAE7E;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI;CACxE;AAkBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,MAAM,GAAG,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,IAI1G,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,QAAQ,EAC1C,aAAa,CAAC,EAAE,SAAS,qBAAqB,KAAG,CAAC,CA6DrD"}

package/dist/create-class-decorator.js

@@ -1,40 +1,75 @@
+import { assertMemberKind } from "./field";
+/**
+ * The behavior a class decorator adds. Every method is optional: hooks that take the instance
+ * (`onMount`, `onUnmount`, `render`) live on the behavior itself and allocate nothing per
+ * instance; `create` returns a per-instance `ClassEnhancement` when hooks need their own closures.
+ */
 export class ClassBehavior {
+    /** Names the decorator in error messages, e.g. `"@Analytics()"`. */
+    label;
 }
-// Tracks instances whose render is currently being called as `originalRender`
-// from within an enhancement. When set, the Enhanced render skips the
-// this._enh.render dispatch so stacked decorators (e.g. @Lazy + @Component)
-// don't re-enter the outermost enhancement recursively.
-const _originalRenderInProgress = new WeakSet();
+// Keyed by symbols so they can't collide with the component's own fields.
+const ENHANCEMENT = Symbol("praxis.classEnhancement");
+// Set on an instance while its render is being called as `originalRender` from within an
+// enhancement. While set, the Enhanced render skips the enhancement's render so stacked decorators
+// (e.g. @Lazy + another render-overriding decorator) don't re-enter the outermost one recursively.
+const IN_ORIGINAL_RENDER = Symbol("praxis.inOriginalRender");
+const NO_ENHANCEMENT = Object.freeze({});
+/**
+ * Builds a class decorator from a `ClassBehavior`. The class is extended by a subclass that runs
+ * the behavior's hooks; a behavior with only `initialize` leaves the class as it is.
+ */
 export function createClassDecorator(behavior) {
-    return function (constructor, _context) {
+    const label = behavior.label ?? "This class decorator";
+    return function (constructor, context) {
+        assertMemberKind(context, "class", label);
+        const hasCreate = behavior.create !== undefined;
+        const sharedRender = behavior.render !== undefined;
+        if (!hasCreate && !sharedRender && behavior.onMount === undefined && behavior.onUnmount === undefined) {
+            behavior.initialize?.(constructor, constructor);
+            return constructor;
+        }
+        const original = constructor.prototype.render;
         const Enhanced = class extends constructor {
-            _enh = behavior.create(this);
+            [ENHANCEMENT] = hasCreate
+                ? behavior.create(this)
+                : NO_ENHANCEMENT;
             onMount() {
                 super.onMount?.();
-                this._enh.onMount?.();
+                behavior.onMount?.(this);
+                this[ENHANCEMENT].onMount?.();
             }
             onUnmount() {
                 super.onUnmount?.();
-                this._enh.onUnmount?.();
+                behavior.onUnmount?.(this);
+                this[ENHANCEMENT].onUnmount?.();
             }
             render(...args) {
-                const originalRender = () => {
-                    _originalRenderInProgress.add(this);
+                const render = original;
+                const host = this;
+                const enhancement = host[ENHANCEMENT];
+                if ((!sharedRender && enhancement.render === undefined) || host[IN_ORIGINAL_RENDER] === true) {
+                    return render.apply(this, args);
+                }
+                const renderOriginal = () => {
+                    host[IN_ORIGINAL_RENDER] = true;
                     try {
-                        return constructor.prototype.render.apply(this, args);
+                        return render.apply(this, args);
                     }
                     finally {
-                        _originalRenderInProgress.delete(this);
+                        host[IN_ORIGINAL_RENDER] = false;
                     }
                 };
-                if (this._enh.render && !_originalRenderInProgress.has(this)) {
-                    return this._enh.render(originalRender);
-                }
-                return constructor.prototype.render.apply(this, args);
+                const inner = enhancement.render === undefined
+                    ? renderOriginal
+                    : () => enhancement.render(renderOriginal);
+                if (!sharedRender)
+                    return inner();
+                return behavior.render(this, inner);
             }
         };
         // If the original class has no render, remove the wrapper so instances see `undefined`.
-        if (typeof constructor.prototype.render !== "function") {
+        if (typeof original !== "function") {
             delete Enhanced.prototype.render;
         }
         Object.defineProperty(Enhanced, "name", { value: constructor.name });

package/dist/create-class-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-class-decorator.js","sourceRoot":"","sources":["../src/create-class-decorator.ts"],"names":[],"mappings":"AAUA,MAAM,OAAgB,aAAa;CASlC;AAED,8EAA8E;AAC9E,sEAAsE;AACtE,4EAA4E;AAC5E,wDAAwD;AACxD,MAAM,yBAAyB,GAAG,IAAI,OAAO,EAAE,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,OAAO,UAGL,WAAc,EAAE,QAA+B;QAC/C,MAAM,QAAQ,GAAG,KAAM,SAAQ,WAAW;YACvB,IAAI,GAAqB,QAAQ,CAAC,MAAM,CACvD,IAAgC,CACjC,CAAC;YAEF,OAAO;gBACL,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACxB,CAAC;YAED,SAAS;gBACP,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAC1B,CAAC;YAED,MAAM,CAAC,GAAG,IAAe;gBACvB,MAAM,cAAc,GAAG,GAAG,EAAE;oBAC1B,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACpC,IAAI,CAAC;wBACH,OAAQ,WAAW,CAAC,SAAmE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACnH,CAAC;4BAAS,CAAC;wBACT,yBAAyB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC,CAAC;gBACF,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC1C,CAAC;gBACD,OAAQ,WAAW,CAAC,SAAmE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnH,CAAC;SACF,CAAC;QAEF,wFAAwF;QACxF,IAAI,OAAQ,WAAW,CAAC,SAAkC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjF,OAAQ,QAAQ,CAAC,SAAkC,CAAC,MAAM,CAAC;QAC7D,CAAC;QAED,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7C,OAAO,QAAwB,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-class-decorator.js","sourceRoot":"","sources":["../src/create-class-decorator.ts"],"names":[],"mappings":"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"}

package/dist/create-field-decorator.d.ts

@@ -1,4 +1,5 @@
 import type { StatefulComponent } from "@praxisjs/core";
+import { type FieldDecorator } from "./field";
 export interface FieldBinding {
     /** Replaces the decorated property. If absent, the original property is left untouched. */
     descriptor?: PropertyDescriptor;
@@ -7,8 +8,46 @@ export interface FieldBinding {
     onMount?: () => void;
     onUnmount?: () => void;
 }
-export interface FieldBehavior<T = object> {
-    bind(instance: T, name: string, initialValue: unknown): FieldBinding;
+export interface FieldBehavior<T = object, Value = unknown> {
+    /** Names the decorator in error messages, e.g. `"@SessionValue()"`. */
+    label?: string;
+    /** Runs once per instance, while it is built. */
+    bind(instance: T, name: string, initialValue: Value): FieldBinding;
 }
-export declare function createFieldDecorator<T = StatefulComponent>(behavior: FieldBehavior<T>): <This extends T, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+/**
+ * What a shared field decorator installs. `get` and `set` become one accessor pair shared by every
+ * instance (`this` is the instance), so per-instance state belongs in symbol slots on the instance,
+ * created in `init`.
+ */
+export interface FieldSetup<This = object, Value = unknown> {
+    get?(this: This): Value;
+    set?(this: This, value: Value): void;
+    /**
+     * Runs once per instance, before `get`/`set` are installed, with the field's initial value. A
+     * decorator stacked under this one has already installed its own property.
+     */
+    init?: (instance: This, initialValue: Value) => void;
+    onMount?: (instance: This) => void;
+    onUnmount?: (instance: This) => void;
+    /** Defaults to `true`, like a plain field. */
+    enumerable?: boolean;
+}
+export interface SharedFieldBehavior<Host = object, Value = unknown> {
+    /** Names the decorator in error messages, e.g. `"@Clamp()"`. */
+    label?: string;
+    /** Runs once per decorated field, when the class is defined. */
+    setup(name: string, context: ClassFieldDecoratorContext<Host, Value>): FieldSetup<Host, Value>;
+}
+/**
+ * Builds a field decorator.
+ *
+ * With `setup`, the recommended form, the decorator's accessors are created once per decorated
+ * field and shared by every instance, which keeps its state in symbol slots: building an instance
+ * allocates no closures and every instance keeps the same hidden class.
+ *
+ * With `bind`, a binding (descriptor, hooks, extra properties) is created for each instance, which
+ * suits decorators that wrap whatever property a decorator stacked under them installed.
+ */
+export declare function createFieldDecorator<Host = object, Value = unknown>(behavior: SharedFieldBehavior<Host, Value>): FieldDecorator<Host, Value>;
+export declare function createFieldDecorator<T = StatefulComponent, Value = unknown>(behavior: FieldBehavior<T, Value>): FieldDecorator<T, Value>;
 //# sourceMappingURL=create-field-decorator.d.ts.map

package/dist/create-field-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-field-decorator.d.ts","sourceRoot":"","sources":["../src/create-field-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM;IACvC,IAAI,CACF,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,OAAO,GACpB,YAAY,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,iBAAiB,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,IACnE,IAAI,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,EAC9C,QAAQ,SAAS,EACjB,SAAS,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAC/C,IAAI,CA0CR"}
+{"version":3,"file":"create-field-decorator.d.ts","sourceRoot":"","sources":["../src/create-field-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAA8D,KAAK,cAAc,EAAkB,MAAM,SAAS,CAAC;AAG1H,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IACxD,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,GAAG,YAAY,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,IAAI,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IACxD,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,CAAC;IACxB,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;IACrC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB,CAAC,IAAI,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO;IACjE,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAChG;AA6ED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO,EACjE,QAAQ,EAAE,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,GACzC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC/B,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,iBAAiB,EAAE,KAAK,GAAG,OAAO,EACzE,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,GAChC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/dist/create-field-decorator.js

@@ -1,37 +1,73 @@
-export function createFieldDecorator(behavior) {
+import { addClaimableInitializer, assertFieldContext, describeValue } from "./field";
+import { addLifecycleHooks } from "./lifecycle";
+const DEFAULT_LABEL = "This field decorator";
+function defineValue(instance, name, value) {
+    Object.defineProperty(instance, name, { value, writable: true, enumerable: true, configurable: true });
+}
+function bindField(behavior) {
+    const label = behavior.label ?? DEFAULT_LABEL;
     return function (_value, context) {
-        context.addInitializer(function () {
+        assertFieldContext(context, label);
+        const name = context.name;
+        addClaimableInitializer(context, function (initialValue) {
             const instance = this;
-            const name = context.name;
-            const initialValue = instance[name];
-            const { descriptor, additional, onMount, onUnmount } = behavior.bind(instance, name, initialValue);
+            const binding = behavior.bind(instance, name, initialValue);
+            if (typeof binding !== "object" || binding === null) {
+                throw new TypeError(`${label}: bind() must return an object (a FieldBinding), got ${describeValue(binding)}.`);
+            }
+            const { descriptor, additional, onMount, onUnmount } = binding;
             if (descriptor) {
-                Reflect.deleteProperty(instance, name);
-                Object.defineProperty(instance, name, {
-                    enumerable: true,
-                    configurable: true,
-                    ...descriptor,
-                });
+                // The descriptor is fresh from bind(), so defaults are filled in place rather than copied.
+                descriptor.enumerable ??= true;
+                descriptor.configurable ??= true;
+                Object.defineProperty(instance, name, descriptor);
             }
-            for (const [key, desc] of Object.entries(additional ?? {})) {
-                Object.defineProperty(instance, key, {
-                    configurable: true,
-                    ...desc,
-                });
+            else if (!Object.hasOwn(instance, name)) {
+                // A binding without a descriptor keeps the plain field, which a claimed field has not got yet.
+                defineValue(instance, name, initialValue);
             }
-            if (onMount ?? onUnmount) {
-                const prevMount = instance.onMount?.bind(instance);
-                const prevUnmount = instance.onUnmount?.bind(instance);
-                instance.onMount = () => {
-                    prevMount?.();
-                    onMount?.();
-                };
-                instance.onUnmount = () => {
-                    prevUnmount?.();
-                    onUnmount?.();
-                };
+            if (additional) {
+                for (const key in additional) {
+                    const desc = additional[key];
+                    desc.configurable ??= true;
+                    Object.defineProperty(instance, key, desc);
+                }
             }
+            if (onMount ?? onUnmount)
+                addLifecycleHooks(instance, onMount, onUnmount);
         });
     };
 }
+function sharedFieldDecorator(behavior) {
+    const label = behavior.label ?? DEFAULT_LABEL;
+    return function (_value, context) {
+        assertFieldContext(context, label);
+        const name = context.name;
+        const result = behavior.setup(name, context);
+        if (typeof result !== "object" || result === null) {
+            throw new TypeError(`${label}: setup() must return an object (a FieldSetup), got ${describeValue(result)}.`);
+        }
+        const field = result;
+        const { init, onMount, onUnmount } = field;
+        const descriptor = field.get === undefined && field.set === undefined
+            ? undefined
+            // eslint-disable-next-line @typescript-eslint/unbound-method -- installed as accessors, which call them with the instance as `this`
+            : { get: field.get, set: field.set, enumerable: field.enumerable ?? true, configurable: true };
+        const hooks = onMount !== undefined || onUnmount !== undefined;
+        addClaimableInitializer(context, function (value) {
+            const instance = this;
+            init?.(instance, value);
+            if (descriptor !== undefined)
+                Object.defineProperty(instance, name, descriptor);
+            else if (!Object.hasOwn(instance, name))
+                defineValue(instance, name, value);
+            if (hooks) {
+                addLifecycleHooks(instance, onMount, onUnmount);
+            }
+        });
+    };
+}
+export function createFieldDecorator(behavior) {
+    return "setup" in behavior ? sharedFieldDecorator(behavior) : bindField(behavior);
+}
 //# sourceMappingURL=create-field-decorator.js.map

package/dist/create-field-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-field-decorator.js","sourceRoot":"","sources":["../src/create-field-decorator.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,oBAAoB,CAAwB,QAA0B;IACpF,OAAO,UACL,MAAiB,EACjB,OAAgD;QAEhD,OAAO,CAAC,cAAc,CAAC;YACrB,MAAM,QAAQ,GAAG,IAA0D,CAAC;YAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAc,CAAC;YACpC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEpC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,IAAI,CAClE,QAAa,EACb,IAAI,EACJ,YAAY,CACb,CAAC;YAEF,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACvC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE;oBACpC,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,IAAI;oBAClB,GAAG,UAAU;iBACd,CAAC,CAAC;YACL,CAAC;YAED,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE;oBACnC,YAAY,EAAE,IAAI;oBAClB,GAAG,IAAI;iBACR,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvD,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAE;oBACtB,SAAS,EAAE,EAAE,CAAC;oBACd,OAAO,EAAE,EAAE,CAAC;gBACd,CAAC,CAAC;gBACF,QAAQ,CAAC,SAAS,GAAG,GAAG,EAAE;oBACxB,WAAW,EAAE,EAAE,CAAC;oBAChB,SAAS,EAAE,EAAE,CAAC;gBAChB,CAAC,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-field-decorator.js","sourceRoot":"","sources":["../src/create-field-decorator.ts"],"names":[],"mappings":"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"}