@praxisjs/decorators 1.6.1 → 2.0.0

package/dist/properties/compose.d.ts

@@ -1,10 +1,11 @@
-import type { StatefulComponent, Composable } from "@praxisjs/core";
+import type { Composable } from "@praxisjs/core";
+import { type FieldDecorator } from "../field";
 interface ComposeFactory {
     __isComposeFactory: true;
     resolve: (instance: object) => unknown;
 }
 /** Wraps a property as a live getter — passes `() => instance[propName]` to the composable. */
 export declare function getter(propName: string): ComposeFactory;
-export declare function Compose(ComposableClass: new (...args: any[]) => Composable, ...ctorArgs: unknown[]): <This extends StatefulComponent, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+export declare function Compose(ComposableClass: new (...args: any[]) => Composable, ...ctorArgs: unknown[]): FieldDecorator;
 export {};
 //# sourceMappingURL=compose.d.ts.map

package/dist/properties/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/properties/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIpE,UAAU,cAAc;IAAG,kBAAkB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE;AAE7F,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAKvD;AA6BD,wBAAgB,OAAO,CAErB,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,EACnD,GAAG,QAAQ,EAAE,OAAO,EAAE,kIAqBvB"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/properties/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,UAAU,CAAC;AAG5E,UAAU,cAAc;IAAG,kBAAkB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE;AAE7F,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAKvD;AA6BD,wBAAgB,OAAO,CAErB,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,EACnD,GAAG,QAAQ,EAAE,OAAO,EAAE,GACrB,cAAc,CAgChB"}

package/dist/properties/compose.js

@@ -1,4 +1,5 @@
-import { createFieldDecorator } from "../create-field-decorator";
+import { sharedField } from "../field";
+import { addLifecycleHooks } from "../lifecycle";
 /** Wraps a property as a live getter — passes `() => instance[propName]` to the composable. */
 export function getter(propName) {
     return {
@@ -32,24 +33,37 @@ function buildView(bindings) {
 export function Compose(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ComposableClass, ...ctorArgs) {
-    return createFieldDecorator({
-        bind(instance, _name, _initialValue) {
-            const resolvedArgs = ctorArgs.map((arg) => {
-                if (isFactory(arg))
-                    return arg.resolve(instance);
-                if (typeof arg !== "string")
-                    return arg;
-                const prop = instance[arg];
-                return prop !== undefined ? prop : arg;
-            });
-            const composable = new ComposableClass(...resolvedArgs);
-            const view = buildView(composable.setup());
-            return {
-                descriptor: { get: () => view },
-                onMount: composable.onMount?.bind(composable),
-                onUnmount: composable.onUnmount?.bind(composable),
-            };
-        },
+    return sharedField((name) => {
+        const composableSlot = Symbol(`praxis.composable.${name}`);
+        const viewSlot = Symbol(`praxis.compose.${name}`);
+        const composableOf = (instance) => instance[composableSlot];
+        const mount = (instance) => { composableOf(instance).onMount?.(); };
+        const unmount = (instance) => { composableOf(instance).onUnmount?.(); };
+        return {
+            descriptor: {
+                get() {
+                    return this[viewSlot];
+                },
+            },
+            init(instance) {
+                const resolvedArgs = ctorArgs.map((arg) => {
+                    if (isFactory(arg))
+                        return arg.resolve(instance);
+                    if (typeof arg !== "string")
+                        return arg;
+                    const prop = instance[arg];
+                    return prop !== undefined ? prop : arg;
+                });
+                const composable = new ComposableClass(...resolvedArgs);
+                instance[composableSlot] = composable;
+                instance[viewSlot] = buildView(composable.setup());
+                const hasMount = typeof composable.onMount === "function";
+                const hasUnmount = typeof composable.onUnmount === "function";
+                if (hasMount || hasUnmount) {
+                    addLifecycleHooks(instance, hasMount ? mount : undefined, hasUnmount ? unmount : undefined);
+                }
+            },
+        };
     });
 }
 //# sourceMappingURL=compose.js.map

package/dist/properties/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/properties/compose.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,+FAA+F;AAC/F,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,OAAO;QACL,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,CAAE,QAAoC,CAAC,QAAQ,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,oBAAoB,IAAI,KAAK,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,UAAU;QAC3B,CAAC,YAAY,IAAK,KAAgB,IAAI,cAAc,IAAK,KAAgB,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,QAAiC;IAClD,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE;gBAC/B,GAAG,EAAE,GAAG,EAAE,CAAE,KAAuB,EAAE;gBACrC,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,OAAO;AACrB,8DAA8D;AAC9D,eAAmD,EACnD,GAAG,QAAmB;IAEtB,OAAO,oBAAoB,CAAC;QAC1B,IAAI,CAAC,QAA2B,EAAE,KAAa,EAAE,aAAsB;YACrE,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxC,IAAI,SAAS,CAAC,GAAG,CAAC;oBAAE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACjD,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,OAAO,GAAG,CAAC;gBACxC,MAAM,IAAI,GAAI,QAA+C,CAAC,GAAG,CAAC,CAAC;gBACnE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACzC,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,GAAG,YAAY,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;YAE3C,OAAO;gBACL,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;gBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;gBAC7C,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC;aAClD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/properties/compose.ts"],"names":[],"mappings":"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"}

package/dist/properties/computed.d.ts

@@ -1,12 +1,14 @@
-export interface ComputedOptions<T = unknown> {
-    get?: (this: object) => T;
-    set?: (this: object, value: T) => void;
+import { type GetterDecorator } from "../create-getter-decorator";
+export interface ComputedOptions {
+    /**
+     * Handles writes to the property. A `set` accessor declared next to the getter in the class
+     * does the same, and TypeScript sees it.
+     */
+    set?(this: object, value: unknown): void;
 }
-export declare function Computed<T, Owner extends object = object>(options: {
-    get: (this: Owner) => T;
-    set: (this: Owner, value: T) => void;
-}): <This extends object>(target: ClassAccessorDecoratorTarget<This, T>, context: ClassAccessorDecoratorContext<This, T>) => ClassAccessorDecoratorResult<This, T>;
-export declare function Computed(options?: {
-    set?: (this: object, value: unknown) => void;
-}): <This, R>(target: (this: This) => R, context: ClassGetterDecoratorContext<This, R>) => (this: This) => R;
+/**
+ * Caches a getter as a reactive computed. A `set` accessor declared next to the getter makes the
+ * property writable.
+ */
+export declare function Computed(options?: ComputedOptions): GetterDecorator;
 //# sourceMappingURL=computed.d.ts.map

package/dist/properties/computed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/properties/computed.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;IAC1B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACxC;AAKD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE;IAClE,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC;IACxB,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACtC,GAAG,CAAC,IAAI,SAAS,MAAM,EACtB,MAAM,EAAE,4BAA4B,CAAC,IAAI,EAAE,CAAC,CAAC,EAC7C,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,CAAC,CAAC,KAC5C,4BAA4B,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAG3C,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE;IACjC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9C,GAAG,CAAC,IAAI,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EACzB,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,CAAC,CAAC,KAC1C,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC"}
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/properties/computed.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AASD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,CAqBnE"}

package/dist/properties/computed.js

@@ -1,26 +1,31 @@
-import { computed } from "@praxisjs/core/internal";
-import { createAccessorDecorator } from "../create-accessor-decorator";
-import { createWritableGetterDecorator } from "../create-getter-decorator";
+import { ComputedNode, readComputed } from "@praxisjs/core/internal";
+import { createGetterDecorator } from "../create-getter-decorator";
+// Kept out of the getter: a closure created inside it would make every read allocate a context.
+function computedFor(instance, getter) {
+    return new ComputedNode(() => getter.call(instance));
+}
+/**
+ * Caches a getter as a reactive computed. A `set` accessor declared next to the getter makes the
+ * property writable.
+ */
 export function Computed(options) {
-    const optionsGet = options?.get;
-    const optionsSet = options?.set;
-    if (optionsGet) {
-        return createAccessorDecorator({
-            bind(instance, _name, _initialValue) {
-                const c = computed(() => optionsGet.call(instance));
-                return {
-                    get: c,
-                    set: optionsSet ? (value) => { optionsSet.call(instance, value); } : undefined,
-                };
-            },
-        });
-    }
-    return createWritableGetterDecorator({
-        bind(instance, _name, original) {
-            const c = computed(() => original.call(instance));
+    // eslint-disable-next-line @typescript-eslint/unbound-method -- installed on the class, which calls it with the instance as `this`
+    const set = options?.set;
+    return createGetterDecorator({
+        label: "@Computed()",
+        setup(original, context) {
+            const node = Symbol(`praxis.computed.${String(context.name)}`);
             return {
-                get: c,
-                set: optionsSet ? (value) => { optionsSet.call(instance, value); } : undefined,
+                // Shared by every instance; the computed itself is only created the first time it is read,
+                // so a getter that a component never reads costs nothing beyond its slot.
+                get() {
+                    return readComputed((this[node] ??= computedFor(this, original)));
+                },
+                set,
+                init(instance) {
+                    // The slot is created up front so every instance keeps the same shape.
+                    instance[node] = undefined;
+                },
             };
         },
     });

package/dist/properties/computed.js.map

@@ -1 +1 @@
-{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../src/properties/computed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AA0B3E,MAAM,UAAU,QAAQ,CAAc,OAA4B;IAChE,MAAM,UAAU,GAAG,OAAO,EAAE,GAA8C,CAAC;IAC3E,MAAM,UAAU,GAAG,OAAO,EAAE,GAA2D,CAAC;IAExF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,uBAAuB,CAAC;YAC7B,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa;gBACjC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpD,OAAO;oBACL,GAAG,EAAE,CAAC;oBACN,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;iBAC/E,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,6BAA6B,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ;YAC5B,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClD,OAAO;gBACL,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aAC/E,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../src/properties/computed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAwB,MAAM,4BAA4B,CAAC;AAYzF,gGAAgG;AAChG,SAAS,WAAW,CAAI,QAAW,EAAE,MAA4B;IAC/D,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,mIAAmI;IACnI,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,CAAC;IACzB,OAAO,qBAAqB,CAAO;QACjC,KAAK,EAAE,aAAa;QACpB,KAAK,CAAC,QAAQ,EAAE,OAAO;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/D,OAAO;gBACL,2FAA2F;gBAC3F,0EAA0E;gBAC1E,GAAG;oBACD,OAAO,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACpE,CAAC;gBACD,GAAG;gBACH,IAAI,CAAC,QAAQ;oBACX,uEAAuE;oBACvE,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;gBAC7B,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAoB,CAAC;AACxB,CAAC"}

package/dist/properties/deep-state.d.ts

@@ -1,3 +1,4 @@
+import { type FieldDecorator } from "../field";
 import type { ReactiveHost } from "../reactive-host";
-export declare function DeepState(): <This extends ReactiveHost, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+export declare function DeepState(): FieldDecorator<ReactiveHost>;
 //# sourceMappingURL=deep-state.d.ts.map

package/dist/properties/deep-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-state.d.ts","sourceRoot":"","sources":["../../src/properties/deep-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAwBrD,wBAAgB,SAAS,8HAiCxB"}
+{"version":3,"file":"deep-state.d.ts","sourceRoot":"","sources":["../../src/properties/deep-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,UAAU,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmDrD,wBAAgB,SAAS,IAAI,cAAc,CAAC,YAAY,CAAC,CAqBxD"}

package/dist/properties/deep-state.js

@@ -1,55 +1,72 @@
-import { markStateDirty, signal } from "@praxisjs/core/internal";
-import { createFieldDecorator } from "../create-field-decorator";
-function deepProxy(target, notify) {
-    return new Proxy(target, {
-        get(obj, key, receiver) {
-            const val = Reflect.get(obj, key, receiver);
-            if (val !== null && typeof val === "object") {
-                return deepProxy(val, notify);
-            }
-            return val;
-        },
-        set(obj, key, value) {
-            const result = Reflect.set(obj, key, value);
-            notify();
-            return result;
-        },
-        deleteProperty(obj, key) {
-            const result = Reflect.deleteProperty(obj, key);
-            notify();
-            return result;
-        },
-    });
+import { markStateDirty, readSignal, SignalNode, writeSignal } from "@praxisjs/core/internal";
+import { sharedField } from "../field";
+// One per decorated field per instance. It is also the handler of every proxy it hands out, so
+// proxying a nested object allocates only the Proxy itself.
+class DeepStateCell {
+    host;
+    version = new SignalNode(0);
+    // One proxy per raw object: repeated reads return the same reference (so `a.b === a.b` and
+    // identity comparisons in effects hold) and don't allocate a new Proxy on every access.
+    proxies = undefined;
+    current;
+    constructor(host, value) {
+        this.host = host;
+        this.current = this.wrap(value);
+    }
+    wrap(value) {
+        if (value === null || typeof value !== "object")
+            return value;
+        const proxies = (this.proxies ??= new WeakMap());
+        let proxy = proxies.get(value);
+        if (proxy === undefined) {
+            proxy = new Proxy(value, this);
+            proxies.set(value, proxy);
+        }
+        return proxy;
+    }
+    changed() {
+        markStateDirty(this.host);
+        writeSignal(this.version, this.version.value + 1);
+    }
+    get(obj, key, receiver) {
+        return this.wrap(Reflect.get(obj, key, receiver));
+    }
+    set(obj, key, value) {
+        const had = Object.hasOwn(obj, key);
+        const prev = Reflect.get(obj, key);
+        const result = Reflect.set(obj, key, value);
+        if (!had || !Object.is(prev, value))
+            this.changed();
+        return result;
+    }
+    deleteProperty(obj, key) {
+        const had = Object.hasOwn(obj, key);
+        const result = Reflect.deleteProperty(obj, key);
+        if (had)
+            this.changed();
+        return result;
+    }
 }
 export function DeepState() {
-    return createFieldDecorator({
-        bind(instance, _name, initialValue) {
-            const version = signal(0);
-            let current = initialValue;
-            let proxy = current !== null && typeof current === "object"
-                ? deepProxy(current, notify)
-                : current;
-            function notify() {
-                markStateDirty(instance);
-                version.update((v) => v + 1);
-            }
-            return {
-                descriptor: {
-                    get() {
-                        version();
-                        return proxy;
-                    },
-                    set(value) {
-                        current = value;
-                        proxy =
-                            value !== null && typeof value === "object"
-                                ? deepProxy(value, notify)
-                                : value;
-                        notify();
-                    },
+    return sharedField((name) => {
+        const slot = Symbol(`praxis.deepState.${name}`);
+        return {
+            descriptor: {
+                get() {
+                    const cell = this[slot];
+                    readSignal(cell.version);
+                    return cell.current;
+                },
+                set(value) {
+                    const cell = this[slot];
+                    cell.current = cell.wrap(value);
+                    cell.changed();
                 },
-            };
-        },
+            },
+            init(instance, initialValue) {
+                instance[slot] = new DeepStateCell(instance, initialValue);
+            },
+        };
     });
 }
 //# sourceMappingURL=deep-state.js.map

package/dist/properties/deep-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-state.js","sourceRoot":"","sources":["../../src/properties/deep-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,SAAS,SAAS,CAAmB,MAAS,EAAE,MAAkB;IAChE,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ;YACpB,MAAM,GAAG,GAAY,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5C,OAAO,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK;YACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,cAAc,CAAC,GAAG,EAAE,GAAG;YACrB,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,oBAAoB,CAAe;QACxC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY;YAChC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,OAAO,GAAG,YAAY,CAAC;YAC3B,IAAI,KAAK,GACP,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAC7C,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;gBAC5B,CAAC,CAAC,OAAO,CAAC;YAEd,SAAS,MAAM;gBACb,cAAc,CAAC,QAAQ,CAAC,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,CAAC;YAED,OAAO;gBACL,UAAU,EAAE;oBACV,GAAG;wBACD,OAAO,EAAE,CAAC;wBACV,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,GAAG,CAAC,KAAc;wBAChB,OAAO,GAAG,KAAK,CAAC;wBAChB,KAAK;4BACH,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;gCACzC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;gCAC1B,CAAC,CAAC,KAAK,CAAC;wBACZ,MAAM,EAAE,CAAC;oBACX,CAAC;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"deep-state.js","sourceRoot":"","sources":["../../src/properties/deep-state.ts"],"names":[],"mappings":"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"}

package/dist/properties/function-prop.d.ts

@@ -1,2 +1,3 @@
-export declare function FunctionProp(): <This extends import("@praxisjs/core").StatefulComponent, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+import { type FieldDecorator } from "../field";
+export declare function FunctionProp(): FieldDecorator;
 //# sourceMappingURL=function-prop.d.ts.map

package/dist/properties/function-prop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-prop.d.ts","sourceRoot":"","sources":["../../src/properties/function-prop.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,4JA4B3B"}
+{"version":3,"file":"function-prop.d.ts","sourceRoot":"","sources":["../../src/properties/function-prop.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,UAAU,CAAC;AAE5E,wBAAgB,YAAY,IAAI,cAAc,CA0B7C"}

package/dist/properties/function-prop.js

@@ -1,28 +1,26 @@
 import { getComponentDefault, getComponentRawProp, setComponentDefault, } from "@praxisjs/core/internal";
-import { createFieldDecorator } from "../create-field-decorator";
+import { sharedField } from "../field";
 export function FunctionProp() {
-    return createFieldDecorator({
-        bind(instance, name, initialValue) {
+    return sharedField((name) => ({
+        descriptor: {
+            get() {
+                const fromParent = getComponentRawProp(this, name);
+                if (fromParent !== undefined) {
+                    if (process.env.NODE_ENV !== "production" &&
+                        typeof fromParent !== "function") {
+                        console.warn(`[FunctionProp] "${name}" received a non-function value (${typeof fromParent}). @FunctionProp() expects a function.`);
+                    }
+                    return fromParent;
+                }
+                return getComponentDefault(this, name);
+            },
+            set(value) {
+                setComponentDefault(this, name, value);
+            },
+        },
+        init(instance, initialValue) {
             setComponentDefault(instance, name, initialValue);
-            return {
-                descriptor: {
-                    get() {
-                        const fromParent = getComponentRawProp(instance, name);
-                        if (fromParent !== undefined) {
-                            if (process.env.NODE_ENV !== "production" &&
-                                typeof fromParent !== "function") {
-                                console.warn(`[FunctionProp] "${name}" received a non-function value (${typeof fromParent}). @FunctionProp() expects a function.`);
-                            }
-                            return fromParent;
-                        }
-                        return getComponentDefault(instance, name);
-                    },
-                    set(value) {
-                        setComponentDefault(instance, name, value);
-                    },
-                },
-            };
         },
-    });
+    }));
 }
 //# sourceMappingURL=function-prop.js.map

package/dist/properties/function-prop.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-prop.js","sourceRoot":"","sources":["../../src/properties/function-prop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,UAAU,YAAY;IAC1B,OAAO,oBAAoB,CAAC;QAC1B,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY;YAC/B,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAClD,OAAO;gBACL,UAAU,EAAE;oBACV,GAAG;wBACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;wBACvD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;4BAC7B,IACE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gCACrC,OAAO,UAAU,KAAK,UAAU,EAChC,CAAC;gCACD,OAAO,CAAC,IAAI,CACV,mBAAmB,IAAI,oCAAoC,OAAO,UAAU,wCAAwC,CACrH,CAAC;4BACJ,CAAC;4BACD,OAAO,UAAU,CAAC;wBACpB,CAAC;wBACD,OAAO,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAC7C,CAAC;oBACD,GAAG,CAAC,KAAc;wBAChB,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC7C,CAAC;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"function-prop.js","sourceRoot":"","sources":["../../src/properties/function-prop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAuC,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5E,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,UAAU,EAAE;YACV,GAAG;gBACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACnD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,IACE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;wBACrC,OAAO,UAAU,KAAK,UAAU,EAChC,CAAC;wBACD,OAAO,CAAC,IAAI,CACV,mBAAmB,IAAI,oCAAoC,OAAO,UAAU,wCAAwC,CACrH,CAAC;oBACJ,CAAC;oBACD,OAAO,UAAU,CAAC;gBACpB,CAAC;gBACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;YACD,GAAG,CAAkB,KAAc;gBACjC,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;SACF;QACD,IAAI,CAAC,QAAQ,EAAE,YAAY;YACzB,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACpD,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/properties/history.d.ts

@@ -1,5 +1,5 @@
-import type { StatefulComponent } from "@praxisjs/core";
 import { type HistoryElement } from "@praxisjs/core/internal";
+import { type FieldDecorator } from "../field";
 export type HistoryOf<C, K extends keyof C> = HistoryElement<C[K]>;
-export declare function History(fieldName: string, limit?: number): <This extends StatefulComponent, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+export declare function History(fieldName: string, limit?: number): FieldDecorator;
 //# sourceMappingURL=history.d.ts.map

package/dist/properties/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,cAAc,EAAW,MAAM,yBAAyB,CAAC;AAKvE,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnE,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,kIAkCpD"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAW,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,UAAU,CAAC;AAG5E,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAmBnE,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,CAkBrE"}

package/dist/properties/history.js

@@ -1,37 +1,40 @@
 import { history } from "@praxisjs/core/internal";
-import { createFieldDecorator } from "../create-field-decorator";
+import { sharedField } from "../field";
+import { addLifecycleHooks } from "../lifecycle";
+function createHistory(host, fieldName, limit) {
+    const h = history((() => host[fieldName]), limit);
+    const undo = h.undo.bind(h);
+    const redo = h.redo.bind(h);
+    h.undo = () => {
+        const prev = h.values()[h.values().length - 2];
+        if (prev === undefined)
+            return;
+        undo();
+        host[fieldName] = prev;
+    };
+    h.redo = () => {
+        redo();
+        host[fieldName] = h.current();
+    };
+    return h;
+}
 export function History(fieldName, limit = 50) {
-    return createFieldDecorator({
-        bind(instance, _name) {
-            const inst = instance;
-            let h;
-            const source = () => inst[fieldName];
-            return {
-                descriptor: {
-                    get() {
-                        if (!h) {
-                            const hInst = history(source, limit);
-                            const _undo = hInst.undo.bind(hInst);
-                            const _redo = hInst.redo.bind(hInst);
-                            hInst.undo = () => {
-                                const prev = hInst.values()[hInst.values().length - 2];
-                                if (prev === undefined)
-                                    return;
-                                _undo();
-                                inst[fieldName] = prev;
-                            };
-                            hInst.redo = () => {
-                                _redo();
-                                inst[fieldName] = hInst.current();
-                            };
-                            h = hInst;
-                        }
-                        return h;
-                    },
-                    enumerable: false,
+    return sharedField((name) => {
+        const slot = Symbol(`praxis.history.${name}`);
+        // The tracking effect would otherwise keep recording a source that outlives the component.
+        const destroy = (instance) => { instance[slot]?.destroy(); };
+        return {
+            descriptor: {
+                enumerable: false,
+                // Created on first read, so an instance whose history is never read records nothing.
+                get() {
+                    return (this[slot] ??= createHistory(this, fieldName, limit));
                 },
-            };
-        },
+            },
+            init(instance) {
+                addLifecycleHooks(instance, undefined, destroy);
+            },
+        };
     });
 }
 //# sourceMappingURL=history.js.map

package/dist/properties/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,KAAK,GAAG,EAAE;IACnD,OAAO,oBAAoB,CAAC;QAC1B,IAAI,CAAC,QAA2B,EAAE,KAAa;YAC7C,MAAM,IAAI,GAAG,QAA8C,CAAC;YAC5D,IAAI,CAAsC,CAAC;YAE3C,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAErC,OAAO;gBACL,UAAU,EAAE;oBACV,GAAG;wBACD,IAAI,CAAC,CAAC,EAAE,CAAC;4BACP,MAAM,KAAK,GAAG,OAAO,CAAC,MAAyB,EAAE,KAAK,CAAC,CAAC;4BACxD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;4BACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;4BACrC,KAAK,CAAC,IAAI,GAAG,GAAG,EAAE;gCAChB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gCACvD,IAAI,IAAI,KAAK,SAAS;oCAAE,OAAO;gCAC/B,KAAK,EAAE,CAAC;gCACR,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;4BACzB,CAAC,CAAC;4BACF,KAAK,CAAC,IAAI,GAAG,GAAG,EAAE;gCAChB,KAAK,EAAE,CAAC;gCACR,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;4BACpC,CAAC,CAAC;4BACF,CAAC,GAAG,KAAK,CAAC;wBACZ,CAAC;wBACD,OAAO,CAAC,CAAC;oBACX,CAAC;oBACD,UAAU,EAAE,KAAK;iBAClB;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/properties/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,EAAuC,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIjD,SAAS,aAAa,CAAC,IAAe,EAAE,SAAiB,EAAE,KAAa;IACtE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAoB,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE;QACZ,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/C,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACzB,CAAC,CAAC;IACF,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE;QACZ,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,KAAK,GAAG,EAAE;IACnD,OAAO,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAC9C,2FAA2F;QAC3F,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAE,EAAE,GAAK,QAAsB,CAAC,IAAI,CAAyC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7H,OAAO;YACL,UAAU,EAAE;gBACV,UAAU,EAAE,KAAK;gBACjB,qFAAqF;gBACrF,GAAG;oBACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChE,CAAC;aACF;YACD,IAAI,CAAC,QAAQ;gBACX,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/properties/index.d.ts

@@ -10,4 +10,5 @@ export { Resource, invalidateResource, type ResourceInstance, type ResourceOptio
 export { Synced } from "./synced";
 export { DeepState } from "./deep-state";
 export { Ref, createRef } from "./ref";
+export { Selector, type SelectorOptions } from "./selector";
 //# sourceMappingURL=index.d.ts.map

package/dist/properties/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/properties/index.js

@@ -10,4 +10,5 @@ export { Resource, invalidateResource } from "./resource";
 export { Synced } from "./synced";
 export { DeepState } from "./deep-state";
 export { Ref, createRef } from "./ref";
+export { Selector } from "./selector";
 //# sourceMappingURL=index.js.map

package/dist/properties/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAA+C,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAA+C,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAwB,MAAM,YAAY,CAAC"}

package/dist/properties/persisted.d.ts

@@ -1,3 +1,4 @@
 import { type PersistedSignalOptions } from "@praxisjs/core/internal";
-export declare function Persisted<T>(key?: string, options?: PersistedSignalOptions<T>): <This extends import("@praxisjs/core").StatefulComponent, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+import { type FieldDecorator } from "../field";
+export declare function Persisted<T>(key?: string, options?: PersistedSignalOptions<T>): FieldDecorator;
 //# sourceMappingURL=persisted.d.ts.map

package/dist/properties/persisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/properties/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAwBvF,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,2JAgBxC"}
+{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/properties/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,UAAU,CAAC;AA0B5E,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,GACtC,cAAc,CAqBhB"}