@praxisjs/fsm 2.1.7 → 2.2.1

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @praxisjs/fsm
 
+## 2.2.1
+
+### Patch 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: 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: Performance pass and bug fixes across the feature packages.
+  - `@praxisjs/router`: static paths are matched through an index and dynamic ones with a single regex run; `RouterView` keeps a shared layout mounted across navigations; new `router.isActive(path)` (used by `Link`, so a navigation re-evaluates only the links whose state changed) and `router.destroy()`. Fixes regex characters in route paths (`.`, `(`, `+`...) being treated as patterns, and a router replaced by `createRouter()` still reacting to `popstate`. `@Route` no longer wraps the class, and the field decorators share one accessor.
+  - `@praxisjs/store`: plugin-wrapped actions keep their identity across reads, extensions are bound once, and writing a field inside an effect no longer subscribes the effect to it. `constructor` and inherited `Object.prototype` members are no longer reported as actions. `@Store` caches the singleton.
+  - `@praxisjs/motion`: `@Tween` and `@Spring` share one accessor per field and no longer start a frame loop at construction; `tween()`/`spring()` react to target writes without an effect. Fixes `reset()` leaving a tween marked as playing.
+  - `@praxisjs/di`: cached singletons and tokens resolve without allocating, `@Injectable` registers the class itself instead of a subclass, and a dependency cycle through `inject()` calls in constructors now reports `[DI] Circular dependency detected` instead of overflowing the stack.
+  - `@praxisjs/fsm`: `send()` and `reset()` no longer subscribe the calling effect to the machine state, transitions allocate nothing per send, and `@StateMachine` shares one accessor.
+  - `@praxisjs/head`: tag diffing without `JSON.stringify` or a full `<head>` query per update; updating or removing an entry below the top one leaves the document alone, and removing an unknown id no longer resets the title.
+  - `@praxisjs/content`: each entry is loaded, parsed and rendered once and shared by `getCollection`, `getPage` and `getEntry`; `getEntry` looks the slug up in an index; schema defaults are built once per class.
+
+- 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]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+  - @praxisjs/decorators@2.0.0
+  - @praxisjs/core@2.3.0
+  - @praxisjs/shared@0.3.2
+
+## 2.2.0
+
+### Minor Changes
+
+- 2d5bd45: New `historyLimit` option, defaulting to 100: `history` keeps only the most recent transitions (`0` disables it, `Infinity` keeps everything). A machine with more than 100 transitions no longer reports the oldest ones unless `historyLimit: Infinity` is set.
+
+### Patch Changes
+
+- Updated dependencies [a97a37c]
+- Updated dependencies [c7a5950]
+  - @praxisjs/core@2.2.0
+  - @praxisjs/decorators@1.7.0
+
 ## 2.1.7
 
 ### Patch Changes

package/dist/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAG,MAAM,WAAW,CAAC;AAEjF,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAiB5B,CAC7B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAEtC,OAAO,EAAE,2BAA2B,CAAC,GAAG,CAAC,KACtC,IAAI,CACV;AAED,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAEhB,CAAC,SAAS,MAAM,GAAG,GAAG,EAGtB,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAInE,CAAC,SAAS,MAAM,EAC/B,QAAQ,SAAS,EACjB,SAAS,0BAA0B,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KACpD,IAAI,CAsBR"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAG,MAAM,WAAW,CAAC;AAEjF,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAiB5B,CAC7B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAEtC,OAAO,EAAE,2BAA2B,CAAC,GAAG,CAAC,KACtC,IAAI,CACV;AAED,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAEhB,CAAC,SAAS,MAAM,GAAG,GAAG,EAGtB,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAEnE,CAAC,SAAS,MAAM,EAC/B,QAAQ,SAAS,EACjB,SAAS,0BAA0B,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KACpD,IAAI,CA2BR"}

package/dist/decorators.js

@@ -1,4 +1,4 @@
-import { createMethodDecorator, } from "@praxisjs/decorators";
+import { createMethodDecorator, addClaimableInitializer, assertFieldContext, } from "@praxisjs/decorators";
 import { createMachine } from "./machine";
 export function Transition(machineProp, event) {
     const decorator = createMethodDecorator({
@@ -20,26 +20,31 @@ export function Transition(machineProp, event) {
 export function StateMachine(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 definition) {
-    const machines = new WeakMap();
     return function (_value, context) {
-        context.addInitializer(function () {
-            const name = context.name;
-            Object.defineProperty(this, name, {
-                get() {
-                    const self = this;
-                    if (!machines.has(self)) {
-                        const def = typeof definition === "function"
-                            ? definition.call(self)
-                            : definition;
-                        machines.set(self, createMachine(def, self));
-                    }
-                    return machines.get(self);
-                },
-                // eslint-disable-next-line @typescript-eslint/no-empty-function
-                set() { },
-                enumerable: true,
-                configurable: true,
-            });
+        assertFieldContext(context);
+        const name = context.name;
+        // Each instance's machine lives under this symbol, created on first read; the accessor itself
+        // is shared by every instance.
+        const slot = Symbol(`praxis.fsm.${String(name)}`);
+        const descriptor = {
+            get() {
+                let machine = this[slot];
+                if (machine === undefined) {
+                    const def = typeof definition === "function" ? definition.call(this) : definition;
+                    machine = createMachine(def, this);
+                    this[slot] = machine;
+                }
+                return machine;
+            },
+            // eslint-disable-next-line @typescript-eslint/no-empty-function
+            set() { },
+            enumerable: true,
+            configurable: true,
+        };
+        addClaimableInitializer(context, function () {
+            // Reserving the slot up front keeps every instance of the class on the same shape.
+            this[slot] = undefined;
+            Object.defineProperty(this, name, descriptor);
         });
     };
 }

package/dist/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAyC,MAAM,WAAW,CAAC;AAEjF,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,KAAa;IAC3D,MAAM,SAAS,GAAG,qBAAqB,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,QAAQ;YACrB,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC5B,MAAM,OAAO,GAAI,QAAoC,CAAC,WAAW,CAEpD,CAAC;gBACd,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,iBAAiB,WAAW,2BAA2B,CAAC,CAAC;oBACtE,OAAO;gBACT,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;oBACrB,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAY,CAAC;YACrD,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,+DAA+D;IAC/D,OAAO,SAIE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY;AAM1B,8DAA8D;AAC9D,UAAoF;IAEpF,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAyB,CAAC;IAEtD,OAAO,UACL,MAAiB,EACjB,OAAqD;QAErD,OAAO,CAAC,cAAc,CAAC;YACrB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;gBAChC,GAAG;oBACD,MAAM,IAAI,GAAG,IAAS,CAAC;oBACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACxB,MAAM,GAAG,GACP,OAAO,UAAU,KAAK,UAAU;4BAC9B,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;4BACvB,CAAC,CAAC,UAAU,CAAC;wBACjB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC/C,CAAC;oBACD,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAkB,CAAC;gBAC7C,CAAC;gBACD,gEAAgE;gBAChE,GAAG,KAAU,CAAC;gBACd,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAyC,MAAM,WAAW,CAAC;AAEjF,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,KAAa;IAC3D,MAAM,SAAS,GAAG,qBAAqB,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,QAAQ;YACrB,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC5B,MAAM,OAAO,GAAI,QAAoC,CAAC,WAAW,CAEpD,CAAC;gBACd,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,iBAAiB,WAAW,2BAA2B,CAAC,CAAC;oBACtE,OAAO;gBACT,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;oBACrB,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAY,CAAC;YACrD,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,+DAA+D;IAC/D,OAAO,SAIE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY;AAM1B,8DAA8D;AAC9D,UAAoF;IAEpF,OAAO,UACL,MAAiB,EACjB,OAAqD;QAErD,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,8FAA8F;QAC9F,+BAA+B;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,UAAU,GAAuB;YACrC,GAAG;gBACD,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,MAAM,GAAG,GAAG,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;oBAClF,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,IAAoB,CAAC,CAAC;oBACnD,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBACvB,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,gEAAgE;YAChE,GAAG,KAAU,CAAC;YACd,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SACnB,CAAC;QACF,uBAAuB,CAAC,OAAO,EAAE;YAC/B,mFAAmF;YAClF,IAAgC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;YACpD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/machine.d.ts

@@ -19,6 +19,12 @@ export interface MachineDefinition<S extends string, E extends string, T extends
     initial: S;
     states: StateMap<S, E, T>;
     onTransition?: (from: S, event: E, to: S) => void;
+    /**
+     * Maximum number of entries kept in `history`; the oldest are dropped first. `0` disables the
+     * history and `Infinity` keeps everything. Defaults to 100: each transition copies the array,
+     * so an unbounded history makes a long-running machine slower and larger over time.
+     */
+    historyLimit?: number;
 }
 export interface Machine<S extends string, E extends string> {
     state: Computed<S>;

package/dist/machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3E,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAC1F,CAAC,EACD;IACE,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,EAAE,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,WAAW,iBAAiB,CAChC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,GAAG,MAAM;IAEzB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IACzD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,EAAE,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACxB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACvB,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAgBD,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAE,CAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CA4C9E"}
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3E,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAC1F,CAAC,EACD;IACE,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,EAAE,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,WAAW,iBAAiB,CAChC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,GAAG,MAAM;IAEzB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;IAClD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IACzD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,EAAE,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACxB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACvB,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAgBD,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAE,CAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAmD9E"}

package/dist/machine.js

@@ -1,50 +1,54 @@
-import { signal, computed } from "@praxisjs/core/internal";
-function resolveTransition(config, instance) {
-    if (config == null)
-        return null;
-    if (typeof config === "string")
-        return { target: config };
-    const { target, guard, action } = config;
-    return {
-        target,
-        guard: guard ? () => guard(instance) : undefined,
-        action: action ? () => { action(instance); } : undefined,
-    };
+import { computed, readSignal, SignalNode, writeSignal } from "@praxisjs/core/internal";
+function normalize(config) {
+    return typeof config === "string" ? { target: config } : config;
 }
+const DEFAULT_HISTORY_LIMIT = 100;
 export function createMachine(definition, instance = {}) {
-    const _state = signal(definition.initial);
-    const _history = signal([]);
+    const stateNode = new SignalNode(definition.initial);
+    const historyNode = new SignalNode([]);
+    const limit = definition.historyLimit ?? DEFAULT_HISTORY_LIMIT;
+    function transitionFor(state, event) {
+        const config = definition.states[state].on?.[event];
+        return config == null ? null : normalize(config);
+    }
+    // Reads the current state without tracking: sending is a write, so an effect that sends must not
+    // re-run because the state it just changed moved.
     function send(event) {
-        const current = _state();
-        const resolved = resolveTransition(definition.states[current].on?.[event], instance);
-        if (!resolved)
+        const current = stateNode.value;
+        const transition = transitionFor(current, event);
+        if (!transition)
             return false;
-        if (resolved.guard && !resolved.guard())
+        if (transition.guard && !transition.guard(instance))
             return false;
-        const { target: nextState } = resolved;
+        const nextState = transition.target;
         definition.states[current].onExit?.({ event, to: nextState });
-        _state.set(nextState);
-        _history.update((h) => [...h, { from: current, event, to: nextState }]);
+        writeSignal(stateNode, nextState);
+        if (limit !== 0) {
+            const prev = historyNode.value;
+            const next = prev.length < limit ? prev.slice() : prev.slice(prev.length - limit + 1);
+            next.push({ from: current, event, to: nextState });
+            writeSignal(historyNode, next);
+        }
         definition.onTransition?.(current, event, nextState);
-        resolved.action?.();
+        transition.action?.(instance);
         definition.states[nextState].onEnter?.({ event, from: current });
         return true;
     }
     return {
-        state: computed(() => _state()),
-        history: computed(() => _history()),
+        state: computed(() => readSignal(stateNode)),
+        history: computed(() => readSignal(historyNode)),
         send,
         can: (event) => {
-            const resolved = resolveTransition(definition.states[_state()].on?.[event], instance);
-            if (!resolved)
+            const transition = transitionFor(readSignal(stateNode), event);
+            if (!transition)
                 return false;
-            return !resolved.guard || resolved.guard();
+            return !transition.guard || transition.guard(instance);
         },
-        is: (state) => _state() === state,
+        is: (state) => readSignal(stateNode) === state,
         reset: () => {
-            definition.states[_state()].onExit?.(undefined);
-            _state.set(definition.initial);
-            _history.set([]);
+            definition.states[stateNode.value].onExit?.(undefined);
+            writeSignal(stateNode, definition.initial);
+            writeSignal(historyNode, []);
             definition.states[definition.initial].onEnter?.(undefined);
         },
     };

package/dist/machine.js.map

@@ -1 +1 @@
-{"version":3,"file":"machine.js","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"machine.js","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@praxisjs/fsm",
-  "version": "2.1.7",
+  "version": "2.2.1",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -10,16 +11,24 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/__tests__",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
   "devDependencies": {
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@praxisjs/core": "2.1.0",
-    "@praxisjs/decorators": "1.6.1",
-    "@praxisjs/shared": "0.3.1"
+    "@praxisjs/core": "2.3.0",
+    "@praxisjs/decorators": "2.0.0",
+    "@praxisjs/shared": "0.3.2"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit"
   }
 }

package/src/decorators.ts

@@ -1,5 +1,7 @@
 import {
   createMethodDecorator,
+  addClaimableInitializer,
+  assertFieldContext,
 } from "@praxisjs/decorators";
 
 import { createMachine, type Machine, type MachineDefinition  } from "./machine";
@@ -37,31 +39,34 @@ export function StateMachine<
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   definition: MachineDefinition<S, E, T> | ((this: any) => MachineDefinition<S, E, T>),
 ) {
-  const machines = new WeakMap<object, Machine<S, E>>();
-
   return function <U extends object>(
     _value: undefined,
     context: ClassFieldDecoratorContext<U, Machine<S, E>>,
   ): void {
-    context.addInitializer(function (this: object) {
-      const name = context.name;
-      Object.defineProperty(this, name, {
-        get(): Machine<S, E> {
-          const self = this as T;
-          if (!machines.has(self)) {
-            const def =
-              typeof definition === "function"
-                ? definition.call(self)
-                : definition;
-            machines.set(self, createMachine(def, self));
-          }
-          return machines.get(self) as Machine<S, E>;
-        },
-        // eslint-disable-next-line @typescript-eslint/no-empty-function
-        set(): void {},
-        enumerable: true,
-        configurable: true,
-      });
+    assertFieldContext(context);
+    const name = context.name;
+    // Each instance's machine lives under this symbol, created on first read; the accessor itself
+    // is shared by every instance.
+    const slot = Symbol(`praxis.fsm.${String(name)}`);
+    const descriptor: PropertyDescriptor = {
+      get(this: Record<symbol, Machine<S, E> | undefined>): Machine<S, E> {
+        let machine = this[slot];
+        if (machine === undefined) {
+          const def = typeof definition === "function" ? definition.call(this) : definition;
+          machine = createMachine(def, this as unknown as T);
+          this[slot] = machine;
+        }
+        return machine;
+      },
+      // eslint-disable-next-line @typescript-eslint/no-empty-function
+      set(): void {},
+      enumerable: true,
+      configurable: true,
+    };
+    addClaimableInitializer(context, function () {
+      // Reserving the slot up front keeps every instance of the class on the same shape.
+      (this as Record<symbol, unknown>)[slot] = undefined;
+      Object.defineProperty(this, name, descriptor);
     });
   };
 }

package/src/machine.ts

@@ -1,4 +1,4 @@
-import { signal, computed } from "@praxisjs/core/internal";
+import { computed, readSignal, SignalNode, writeSignal } from "@praxisjs/core/internal";
 import type { Computed } from "@praxisjs/shared";
 
 export interface TransitionTarget<S extends string, T extends object = object> {
@@ -24,6 +24,12 @@ export interface MachineDefinition<
   initial: S;
   states: StateMap<S, E, T>;
   onTransition?: (from: S, event: E, to: S) => void;
+  /**
+   * Maximum number of entries kept in `history`; the oldest are dropped first. `0` disables the
+   * history and `Infinity` keeps everything. Defaults to 100: each transition copies the array,
+   * so an unbounded history makes a long-running machine slower and larger over time.
+   */
+  historyLimit?: number;
 }
 
 export interface Machine<S extends string, E extends string> {
@@ -35,65 +41,72 @@ export interface Machine<S extends string, E extends string> {
   reset(): void;
 }
 
-function resolveTransition<S extends string, T extends object>(
-  config: S | TransitionTarget<S, T> | undefined,
-  instance: T,
-): { target: S; guard?: () => boolean; action?: () => void } | null {
-  if (config == null) return null;
-  if (typeof config === "string") return { target: config };
-  const { target, guard, action } = config;
-  return {
-    target,
-    guard: guard ? () => guard(instance) : undefined,
-    action: action ? () => { action(instance); } : undefined,
-  };
+interface HistoryEntry<S extends string, E extends string> {
+  from: S;
+  event: E;
+  to: S;
+}
+
+function normalize<S extends string, T extends object>(
+  config: S | TransitionTarget<S, T>,
+): TransitionTarget<S, T> {
+  return typeof config === "string" ? { target: config } : config;
 }
 
+const DEFAULT_HISTORY_LIMIT = 100;
+
 export function createMachine<
   S extends string,
   E extends string,
   T extends object = object,
 >(definition: MachineDefinition<S, E, T>, instance: T = {} as T): Machine<S, E> {
-  const _state = signal(definition.initial);
-  const _history = signal<Array<{ from: S; event: E; to: S }>>([]);
+  const stateNode = new SignalNode(definition.initial);
+  const historyNode = new SignalNode<Array<HistoryEntry<S, E>>>([]);
+  const limit = definition.historyLimit ?? DEFAULT_HISTORY_LIMIT;
+
+  function transitionFor(state: S, event: E): TransitionTarget<S, T> | null {
+    const config = definition.states[state].on?.[event];
+    return config == null ? null : normalize(config);
+  }
 
+  // Reads the current state without tracking: sending is a write, so an effect that sends must not
+  // re-run because the state it just changed moved.
   function send(event: E): boolean {
-    const current = _state();
-    const resolved = resolveTransition(
-      definition.states[current].on?.[event],
-      instance,
-    );
-    if (!resolved) return false;
-    if (resolved.guard && !resolved.guard()) return false;
+    const current = stateNode.value;
+    const transition = transitionFor(current, event);
+    if (!transition) return false;
+    if (transition.guard && !transition.guard(instance)) return false;
 
-    const { target: nextState } = resolved;
+    const nextState = transition.target;
 
     definition.states[current].onExit?.({ event, to: nextState });
-    _state.set(nextState);
-    _history.update((h) => [...h, { from: current, event, to: nextState }]);
+    writeSignal(stateNode, nextState);
+    if (limit !== 0) {
+      const prev = historyNode.value;
+      const next = prev.length < limit ? prev.slice() : prev.slice(prev.length - limit + 1);
+      next.push({ from: current, event, to: nextState });
+      writeSignal(historyNode, next);
+    }
     definition.onTransition?.(current, event, nextState);
-    resolved.action?.();
+    transition.action?.(instance);
     definition.states[nextState].onEnter?.({ event, from: current });
     return true;
   }
 
   return {
-    state: computed(() => _state()),
-    history: computed(() => _history()),
+    state: computed(() => readSignal(stateNode)),
+    history: computed(() => readSignal(historyNode)),
     send,
     can: (event) => {
-      const resolved = resolveTransition(
-        definition.states[_state()].on?.[event],
-        instance,
-      );
-      if (!resolved) return false;
-      return !resolved.guard || resolved.guard();
+      const transition = transitionFor(readSignal(stateNode), event);
+      if (!transition) return false;
+      return !transition.guard || transition.guard(instance);
     },
-    is: (state) => _state() === state,
+    is: (state) => readSignal(stateNode) === state,
     reset: () => {
-      definition.states[_state()].onExit?.(undefined);
-      _state.set(definition.initial);
-      _history.set([]);
+      definition.states[stateNode.value].onExit?.(undefined);
+      writeSignal(stateNode, definition.initial);
+      writeSignal(historyNode, []);
       definition.states[definition.initial].onEnter?.(undefined);
     },
   };

package/dist/__tests__/decorators.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=decorators.test.d.ts.map

package/dist/__tests__/decorators.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorators.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/decorators.test.ts"],"names":[],"mappings":""}