@thomas-siegfried/tapout 0.0.2 → 0.0.4

package/README.md

@@ -4,6 +4,8 @@ A modern ESM reactivity and templating library, spiritually inspired by [Knockou
 
 Tapout provides dependency-tracked observables, computed values, declarative DOM bindings, a component system, and TC39 Stage 3 decorators — all in a lightweight, explicit architecture built on TypeScript.
 
+For detailed TypeScript decorator setup and compatibility notes, see [`decorator-config.md`](./decorator-config.md).
+
 ## Table of Contents
 
 - [Installation](#installation)

package/decorator-config.md

@@ -0,0 +1,220 @@
+# Vite Decorator Setup Guide
+
+Four tested configurations for using decorators with Vite 7/8 and tapout.
+
+---
+
+## Option A: Babel + TC39 Stage 3 Decorators
+
+Uses the `accessor` keyword. Babel transpiles TC39 decorators into `_applyDecs` helper calls.
+
+### Install
+
+```bash
+npm install -D vite-plugin-babel @babel/plugin-proposal-decorators @babel/plugin-transform-typescript
+```
+
+### `vite.config.ts`
+
+```typescript
+import { defineConfig } from 'vite';
+import babel from 'vite-plugin-babel';
+
+export default defineConfig({
+  resolve: {
+    preserveSymlinks: true,       // only needed for npm link scenarios
+  },
+  oxc: false as any,              // disable Vite 8's default Oxc transpiler
+  plugins: [
+    babel({
+      filter: /\.[jt]sx?$/,       // must include .ts/.tsx — default only handles .js/.jsx
+      babelConfig: {
+        plugins: [
+          ['@babel/plugin-proposal-decorators', { version: '2023-11' }],
+          ['@babel/plugin-transform-typescript', { allowDeclareFields: true }],
+        ],
+      },
+    }),
+  ],
+});
+```
+
+### `tsconfig.json`
+
+Do **not** add `experimentalDecorators`. Keep `useDefineForClassFields: true` (the default).
+
+### Source syntax
+
+```typescript
+@reactive accessor currentRoute: string = 'dashboard';
+@reactiveArray accessor items: Item[] = [];
+@computed get fullName(): string { return ... }
+```
+
+---
+
+## Option B: Babel + Experimental (Legacy) Decorators
+
+No `accessor` keyword. Babel transpiles legacy decorators. Requires `@babel/plugin-transform-class-properties` with `loose: true` to prevent Babel from creating own data properties that shadow the decorator's getter/setter.
+
+### Install
+
+```bash
+npm install -D vite-plugin-babel @babel/plugin-proposal-decorators @babel/plugin-transform-class-properties @babel/plugin-transform-typescript
+```
+
+### `vite.config.ts`
+
+```typescript
+import { defineConfig } from 'vite';
+import babel from 'vite-plugin-babel';
+
+export default defineConfig({
+  resolve: {
+    preserveSymlinks: true,
+  },
+  oxc: false as any,
+  plugins: [
+    babel({
+      filter: /\.[jt]sx?$/,
+      babelConfig: {
+        plugins: [
+          ['@babel/plugin-proposal-decorators', { version: 'legacy' }],
+          ['@babel/plugin-transform-class-properties', { loose: true }],
+          ['@babel/plugin-transform-typescript', { allowDeclareFields: true }],
+        ],
+      },
+    }),
+  ],
+});
+```
+
+### `tsconfig.json`
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false
+  }
+}
+```
+
+### Source syntax
+
+```typescript
+@reactive currentRoute: string = 'dashboard';
+@reactiveArray items: Item[] = [];
+@computed get fullName(): string { return ... }
+```
+
+### Babel-specific note
+
+Babel passes a `descriptor` with an `initializer` property to legacy field decorators — this is a Babel convention, not a standard. tapout handles this to prevent Babel's class property transform from shadowing the decorator's getter/setter with a plain data property.
+
+---
+
+## Option C: Oxc (Vite 8 built-in) + Experimental (Legacy) Decorators
+
+No Babel needed — Vite 8's built-in Oxc transpiler handles legacy decorators natively. Zero extra dependencies.
+
+### Install
+
+No additional packages needed beyond Vite itself.
+
+### `vite.config.ts`
+
+```typescript
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  resolve: {
+    preserveSymlinks: true,
+  },
+  oxc: {
+    decorator: {
+      legacy: true,
+    },
+  },
+});
+```
+
+### `tsconfig.json`
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false
+  }
+}
+```
+
+### Source syntax
+
+Same as Option B (no `accessor` keyword).
+
+---
+
+## Option D: esbuild (Vite 7 built-in) + Experimental (Legacy) Decorators
+
+No Babel or Oxc needed — Vite 7's built-in esbuild transpiler handles legacy decorators natively by reading `tsconfig.json`. Zero extra dependencies.
+
+### Install
+
+No additional packages needed beyond Vite itself.
+
+```bash
+npm install -D vite@~7.3.1
+```
+
+### `vite.config.ts`
+
+No `vite.config.ts` is required. esbuild reads `experimentalDecorators` and `useDefineForClassFields` directly from `tsconfig.json` — no explicit esbuild config needed.
+
+### `tsconfig.json`
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false
+  }
+}
+```
+
+`erasableSyntaxOnly` (added in TypeScript 5.9) must **not** be enabled — it rejects decorator syntax as non-erasable.
+
+### Source syntax
+
+Same as Option B (no `accessor` keyword).
+
+### esbuild-specific notes
+
+- esbuild does **not** support `emitDecoratorMetadata`. tapout does not use `reflect-metadata`, so this is a non-issue.
+- esbuild does **not** pass a `descriptor` with an `initializer` to legacy field decorators (unlike Babel). tapout's legacy path handles both cases — with and without the Babel-style `initializer`.
+
+---
+
+## Quick Reference
+
+| | Option A | Option B | Option C | Option D |
+|---|---|---|---|---|
+| Vite version | 8 | 8 | 8 | 7 |
+| Spec | TC39 Stage 3 | Experimental/Legacy | Experimental/Legacy | Experimental/Legacy |
+| Transpiler | Babel | Babel | Oxc (built-in) | esbuild (built-in) |
+| Extra deps | 2 packages | 3 packages | None | None |
+| `accessor` keyword | Yes | No | No | No |
+| `experimentalDecorators` | No | Yes | Yes | Yes |
+| `useDefineForClassFields` | `true` | `false` | `false` | `false` |
+| `emitDecoratorMetadata` | N/A | Supported | Supported | Not supported |
+
+## Common Gotchas
+
+- **`oxc: false as any`** — required for Options A/B to disable Vite 8's default Oxc transpiler so Babel takes over. The `as any` is needed because Vite 8's types don't expose this option.
+- **`filter: /\.[jt]sx?$/`** — critical for Babel options. Without it, `.ts` files bypass Babel and hit the default transpiler.
+- **`preserveSymlinks: true`** (Vite 8) / **`resolve.dedupe`** (Vite 7) — only needed when using `npm link` for local package development.
+- **Plugin order matters** — decorators must come before class-properties, which must come before TypeScript transform (Options A/B only).
+- **Vite caches pre-bundled deps** — after changing a linked package, delete `node_modules/.vite` and restart the dev server.
+- **`erasableSyntaxOnly: true`** — if present in `tsconfig.json`, must be removed when enabling `experimentalDecorators`. TypeScript 5.9 introduced this flag to enforce type-only syntax, but decorator emit is runtime code.
+- **esbuild reads tsconfig automatically** (Option D) — no `vite.config.ts` is needed at all. esbuild picks up `experimentalDecorators` and `useDefineForClassFields` from the project's `tsconfig.json`.

package/dist/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,KAAK,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AA+DzC,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACzC;AAyCD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxL,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAC7E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;AAC9H,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,yBAAyB,CAAC;AAwF9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7L,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;AACnI,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,yBAAyB,CAAC;AA+CnF,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAuF3C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;IACrM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAAC;CAC3G;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAClC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAC5I,WAAW,GAAG,IAAI,CAAC;AAEtB,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,GAAG,IAAI,CAAC;AAsB7B,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,SAAS,CAO/F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAEpG"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,KAAK,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AA+DzC,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACzC;AAyCD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxL,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAC7E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;AAC9H,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,yBAAyB,CAAC;AAwF9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7L,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;AACnI,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,yBAAyB,CAAC;AA+CnF,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAuF3C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;IACrM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAAC;CAC3G;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAClC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAC5I,WAAW,GAAG,IAAI,CAAC;AAEtB,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,GAAG,IAAI,CAAC;AAsB7B,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,SAAS,CAO/F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAEpG"}

package/dist/decorators.js

@@ -1,5 +1,6 @@
 import { Observable } from './observable.js';
 import { ObservableArray } from './observableArray.js';
+import { getReactiveArrayDecoratorProxy } from './reactiveArrayDecoratorProxy.js';
 import { Computed } from './computed.js';
 import { registerDependency } from './dependencyDetection.js';
 // --- Observable registry for getObservable() ---
@@ -106,12 +107,12 @@ function createStage3ReactiveArray(extenders) {
             if (extenders)
                 obs.extend(extenders);
             storeObservable(this, context.name, obs);
-            return obs;
+            return getReactiveArrayDecoratorProxy(obs);
         },
         get() {
             const obs = lookupObservable(this, context.name);
             registerDependency(obs);
-            return obs;
+            return getReactiveArrayDecoratorProxy(obs);
         },
         set(newValue) {
             const obs = lookupObservable(this, context.name);
@@ -136,7 +137,7 @@ function applyLegacyReactiveArray(target, propertyKey, descriptor, extenders) {
                 storeObservable(this, propertyKey, obs);
             }
             registerDependency(obs);
-            return obs;
+            return getReactiveArrayDecoratorProxy(obs);
         },
         set(value) {
             let obs = lookupObservable(this, propertyKey);

package/dist/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAW9D,kDAAkD;AAElD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAqD,CAAC;AACtF,MAAM,eAAe,GAAG,IAAI,OAAO,EAAmD,CAAC;AAEvF,SAAS,eAAe,CAAC,QAAgB,EAAE,GAAoB,EAAE,GAAoB;IACnF,IAAI,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,OAAO,EAAE,CAAC;QAC5B,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IACD,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,GAAoB;IAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2BAA2B;AAE3B,SAAS,eAAe,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,CAAC;AAClE,CAAC;AAED,2CAA2C;AAE3C,SAAS,oBAAoB,CAAC,SAA2B;IACvD,OAAO,CAAC,MAAwB,EAAE,OAA2B,EAAqB,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,YAAqB;YACxB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,SAAS;gBAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACrC,eAAe,CAAC,IAAc,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG;YACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAwB,CAAC;YACxE,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,GAAG,CAAe,QAAiB;YACjC,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAwB,CAAC;YACxE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAWD,SAAS,mBAAmB,CAC1B,MAAc,EACd,WAA4B,EAC5B,UAAkC,EAClC,SAA2B;IAE3B,MAAM,WAAW,GAAG,UAAU,EAAE,WAAW,CAAC;IAC5C,MAAM,OAAO,GAAuB;QAClC,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,GAAG;YACD,IAAI,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnE,GAAG,GAAG,IAAI,UAAU,CAAU,SAAS,CAAC,CAAC;gBACzC,IAAI,SAAS;oBAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACrC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC1C,CAAC;YACD,OAAQ,GAA2B,CAAC,GAAG,EAAE,CAAC;QAC5C,CAAC;QACD,GAAG,CAAe,KAAc;YAC9B,IAAI,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,UAAU,CAAU,KAAK,CAAC,CAAC;gBACrC,IAAI,SAAS;oBAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACrC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACL,GAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;KACF,CAAC;IACF,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACjE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAiBD,MAAM,UAAU,QAAQ,CACtB,cAAuB,EACvB,YAAsB,EACtB,UAAkC;IAElC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,cAAiC,CAAC;QAC9C,OAAO,UAAU,MAAe,EAAE,aAAsB,EAAE,WAAmC;YAC3F,IAAI,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;gBACnC,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,MAA0B,EAAE,aAAmC,CAAC,CAAC;YACpG,CAAC;YACD,OAAO,mBAAmB,CAAC,MAAgB,EAAE,aAAgC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QACnG,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO,oBAAoB,EAAE,CAAC,cAAkC,EAAE,YAAkC,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,mBAAmB,CAAC,cAAwB,EAAE,YAA+B,EAAE,UAAU,CAAC,CAAC;AACpG,CAAC;AAED,gDAAgD;AAEhD,SAAS,yBAAyB,CAAC,SAA2B;IAC5D,OAAO,CAAC,MAAwB,EAAE,OAA2B,EAAqB,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,YAAqB;YACxB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,SAAS;gBAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACrC,eAAe,CAAC,IAAc,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,8BAA8B,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,GAAG;YACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAA6B,CAAC;YAC7E,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO,8BAA8B,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,GAAG,CAAe,QAAiB;YACjC,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAA6B,CAAC;YAC7E,GAAG,CAAC,GAAG,CAAC,QAAqB,CAAC,CAAC;QACjC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,yDAAyD;AAEzD,SAAS,wBAAwB,CAC/B,MAAc,EACd,WAA4B,EAC5B,UAAkC,EAClC,SAA2B;IAE3B,MAAM,WAAW,GAAG,UAAU,EAAE,WAAW,CAAC;IAC5C,MAAM,OAAO,GAAuB;QAClC,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,GAAG;YACD,IAAI,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,GAAG,IAAI,eAAe,CAAU,GAAG,CAAC,CAAC;gBACxC,IAAI,SAAS;oBAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACrC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC1C,CAAC;YACD,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO,8BAA8B,CAAC,GAA+B,CAAC,CAAC;QACzE,CAAC;QACD,GAAG,CAAe,KAAc;YAC9B,IAAI,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9C,GAAG,GAAG,IAAI,eAAe,CAAU,GAAG,CAAC,CAAC;gBACxC,IAAI,SAAS;oBAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACrC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACL,GAAgC,CAAC,GAAG,CAAC,KAAkB,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;KACF,CAAC;IACF,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACjE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAQD,MAAM,UAAU,aAAa,CAC3B,cAAuB,EACvB,YAAsB,EACtB,UAAkC;IAElC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,cAAiC,CAAC;QAC9C,OAAO,UAAU,MAAe,EAAE,aAAsB,EAAE,WAAmC;YAC3F,IAAI,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;gBACnC,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC,MAA0B,EAAE,aAAmC,CAAC,CAAC;YACzG,CAAC;YACD,OAAO,wBAAwB,CAAC,MAAgB,EAAE,aAAgC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QACxG,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO,yBAAyB,EAAE,CAAC,cAAkC,EAAE,YAAkC,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,wBAAwB,CAAC,cAAwB,EAAE,YAA+B,EAAE,UAAU,CAAC,CAAC;AACzG,CAAC;AAED,oBAAoB;AAEpB,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,GAAoB,EACpB,MAAe,EACf,OAA4B;IAE5B,IAAI,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAA4B,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,QAAQ,CAAI;YACrB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,OAAO;YACd,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QACH,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAyB,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAKD,mCAAmC;AACnC,SAAS,mBAAmB,CAC1B,KAAkB,EAClB,OAAgD;IAEhD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAE/B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,KAAK,CAAC;QAC7B,OAAO;YACL,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,KAAK,CAAC;QAC7B,OAAO,UAAwB,QAAiB;YAC9C,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,IAAI,CAAkC,CAAC;YAC7D,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,KAAK,CAAC;QAC7B,OAAO;YACL,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,SAAS,mBAAmB,CAC1B,OAAe,EACf,WAA4B,EAC5B,UAA8B;IAE9B,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;QACnB,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC;QACtC,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC;QAEtC,UAAU,CAAC,GAAG,GAAG;YACf,MAAM,IAAI,GAAG,mBAAmB,CAC9B,IAAI,EAAE,WAAW,EACjB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EACzB,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CACvD,CAAC;YACF,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACnB,UAAU,CAAC,GAAG,GAAG,UAAwB,KAAc;gBACrD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACtC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,WAAW,CAAkC,CAAC;gBACpE,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC3C,MAAM,cAAc,GAAG,UAAU,CAAC,KAAoB,CAAC;QACvD,UAAU,CAAC,KAAK,GAAG;YACjB,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/E,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAwBD,iBAAiB;AACjB,MAAM,UAAU,QAAQ,CACtB,aAAsB,EACtB,YAAsB,EACtB,UAA+B;IAE/B,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO,mBAAmB,CACxB,aAA4B,EAC5B,YAAuD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,mBAAmB,CACxB,aAAuB,EACvB,YAA+B,EAC/B,UAAW,CACZ,CAAC;AACJ,CAAC;AAED,gDAAgD;AAEhD,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,GAAoB;IAChE,IAAI,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,KAAM,MAA2C,CAAC,GAAG,CAAC,CAAC;QACvD,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,GAAoB,EAAE,GAAoB;IAC5F,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/dependencyDetection.d.ts

@@ -7,6 +7,8 @@ export interface TrackingFrame {
         getDependencies(): AnySubscribable[];
     };
     isInitial?: boolean;
+    /** Dedupes repeated registration of the same subscribable in one frame (e.g. `@reactiveArray` getter + indexed proxy read). */
+    _dependencyDedupe?: WeakSet<AnySubscribable>;
 }
 export declare function getId(): number;
 export declare function begin(frame?: TrackingFrame): void;

package/dist/dependencyDetection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependencyDetection.d.ts","sourceRoot":"","sources":["../src/dependencyDetection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,mBAAmB,CAAC;AAGtE,KAAK,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,EAAE;QACT,oBAAoB,IAAI,MAAM,CAAC;QAC/B,eAAe,IAAI,eAAe,EAAE,CAAC;KACtC,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAGjD;AAED,wBAAgB,GAAG,IAAI,IAAI,CAE1B;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAUtE;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAO9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAKzD;AAED,wBAAgB,eAAe,IAAI,eAAe,EAAE,GAAG,SAAS,CAK/D;AAED,wBAAgB,SAAS,IAAI,OAAO,GAAG,SAAS,CAK/C;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,SAAS,CAE1E"}
+{"version":3,"file":"dependencyDetection.d.ts","sourceRoot":"","sources":["../src/dependencyDetection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,mBAAmB,CAAC;AAGtE,KAAK,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,EAAE;QACT,oBAAoB,IAAI,MAAM,CAAC;QAC/B,eAAe,IAAI,eAAe,EAAE,CAAC;KACtC,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+HAA+H;IAC/H,iBAAiB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9C;AAMD,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAGjD;AAED,wBAAgB,GAAG,IAAI,IAAI,CAE1B;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAmBtE;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAO9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAKzD;AAED,wBAAgB,eAAe,IAAI,eAAe,EAAE,GAAG,SAAS,CAK/D;AAED,wBAAgB,SAAS,IAAI,OAAO,GAAG,SAAS,CAK/C;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,SAAS,CAE1E"}

package/dist/dependencyDetection.js

@@ -17,6 +17,15 @@ export function registerDependency(subscribable) {
         if (!isSubscribable(subscribable)) {
             throw new Error('Only subscribable things can act as dependencies');
         }
+        let dedupe = currentFrame._dependencyDedupe;
+        if (!dedupe) {
+            dedupe = new WeakSet();
+            currentFrame._dependencyDedupe = dedupe;
+        }
+        if (dedupe.has(subscribable)) {
+            return;
+        }
+        dedupe.add(subscribable);
         currentFrame.callback(subscribable, subscribable._id || (subscribable._id = getId()));
     }
 }

package/dist/dependencyDetection.js.map

@@ -1 +1 @@
-{"version":3,"file":"dependencyDetection.js","sourceRoot":"","sources":["../src/dependencyDetection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AActE,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,MAAM,WAAW,GAAqC,EAAE,CAAC;AACzD,IAAI,YAAuC,CAAC;AAE5C,MAAM,UAAU,KAAK;IACnB,OAAO,EAAE,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAqB;IACzC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,YAA6B;IAC9D,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,YAAY,CAAC,QAAQ,CACnB,YAAY,EACZ,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,QAAiB;IACzC,IAAI,CAAC;QACH,KAAK,EAAE,CAAC;QACR,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,GAAG,EAAE,CAAC;IACR,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC,SAAS,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,EAAE,QAAQ,CAAC;AAChC,CAAC"}
+{"version":3,"file":"dependencyDetection.js","sourceRoot":"","sources":["../src/dependencyDetection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAgBtE,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,MAAM,WAAW,GAAqC,EAAE,CAAC;AACzD,IAAI,YAAuC,CAAC;AAE5C,MAAM,UAAU,KAAK;IACnB,OAAO,EAAE,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAqB;IACzC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,YAA6B;IAC9D,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,iBAAiB,GAAG,MAAM,CAAC;QAC1C,CAAC;QACD,IAAI,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzB,YAAY,CAAC,QAAQ,CACnB,YAAY,EACZ,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,QAAiB;IACzC,IAAI,CAAC;QACH,KAAK,EAAE,CAAC;QACR,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,GAAG,EAAE,CAAC;IACR,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC,SAAS,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,EAAE,QAAQ,CAAC;AAChC,CAAC"}

package/dist/reactiveArrayDecoratorProxy.d.ts

@@ -0,0 +1,9 @@
+import { ObservableArray } from './observableArray.js';
+/**
+ * Proxy used only for `@reactiveArray` decorated properties: supports `list[0]` read/write
+ * while keeping `getObservable()` on the underlying {@link ObservableArray}.
+ *
+ * Methods and accessors are applied to the real instance (not the proxy) so internal state works.
+ */
+export declare function getReactiveArrayDecoratorProxy<T>(obs: ObservableArray<T>): ObservableArray<T>;
+//# sourceMappingURL=reactiveArrayDecoratorProxy.d.ts.map

package/dist/reactiveArrayDecoratorProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactiveArrayDecoratorProxy.d.ts","sourceRoot":"","sources":["../src/reactiveArrayDecoratorProxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAevD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CA6D7F"}

package/dist/reactiveArrayDecoratorProxy.js

@@ -0,0 +1,83 @@
+import { registerDependency } from './dependencyDetection.js';
+const proxyCache = new WeakMap();
+/**
+ * ES array index property name: ToString(ToUint32(P)) === P and ToUint32(P) ≠ 2³²−1.
+ * @see https://tc39.es/ecma262/#sec-array-exotic-objects
+ */
+function parseArrayIndexString(key) {
+    const index = Number(key) >>> 0;
+    if (index === 0xffff_ffff)
+        return undefined;
+    if (`${index}` !== key)
+        return undefined;
+    return index;
+}
+/**
+ * Proxy used only for `@reactiveArray` decorated properties: supports `list[0]` read/write
+ * while keeping `getObservable()` on the underlying {@link ObservableArray}.
+ *
+ * Methods and accessors are applied to the real instance (not the proxy) so internal state works.
+ */
+export function getReactiveArrayDecoratorProxy(obs) {
+    let prox = proxyCache.get(obs);
+    if (!prox) {
+        prox = new Proxy(obs, {
+            get(target, prop, _receiver) {
+                if (typeof prop === 'string') {
+                    const index = parseArrayIndexString(prop);
+                    if (index !== undefined) {
+                        registerDependency(target);
+                        return target.peek()[index];
+                    }
+                }
+                const value = Reflect.get(target, prop, target);
+                if (typeof value === 'function') {
+                    return value.bind(target);
+                }
+                return value;
+            },
+            set(target, prop, value, _receiver) {
+                if (typeof prop === 'string') {
+                    const index = parseArrayIndexString(prop);
+                    if (index !== undefined) {
+                        const arr = target.peek();
+                        target.valueWillMutate();
+                        arr[index] = value;
+                        target.valueHasMutated();
+                        return true;
+                    }
+                }
+                return Reflect.set(target, prop, value, target);
+            },
+            has(target, prop) {
+                if (typeof prop === 'string') {
+                    const index = parseArrayIndexString(prop);
+                    if (index !== undefined) {
+                        registerDependency(target);
+                        return Reflect.has(target.peek(), prop);
+                    }
+                }
+                return Reflect.has(target, prop);
+            },
+            deleteProperty(target, prop) {
+                if (typeof prop === 'string') {
+                    const index = parseArrayIndexString(prop);
+                    if (index !== undefined) {
+                        const arr = target.peek();
+                        if (Reflect.has(arr, prop)) {
+                            target.valueWillMutate();
+                            delete arr[index];
+                            target.valueHasMutated();
+                            return true;
+                        }
+                        return true;
+                    }
+                }
+                return Reflect.deleteProperty(target, prop);
+            },
+        });
+        proxyCache.set(obs, prox);
+    }
+    return prox;
+}
+//# sourceMappingURL=reactiveArrayDecoratorProxy.js.map

package/dist/reactiveArrayDecoratorProxy.js.map

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

package/dist/wireParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wireParams.d.ts","sourceRoot":"","sources":["../src/wireParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CACxC;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,IAAI,GACb,gBAAgB,CA+BlB"}
+{"version":3,"file":"wireParams.d.ts","sourceRoot":"","sources":["../src/wireParams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBtD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;CACxC;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,IAAI,GACb,gBAAgB,CAuClB"}

package/dist/wireParams.js

@@ -4,14 +4,27 @@ import { isSubscribable } from './subscribable.js';
 import { getObservable, replaceObservable } from './decorators.js';
 import { addDisposeCallback } from './domNodeDisposal.js';
 const SKIP_KEYS = new Set(['$raw']);
+function getWritableChildTarget(instance, key) {
+    const decorated = getObservable(instance, key);
+    if (decorated instanceof Observable)
+        return decorated;
+    if (decorated instanceof Computed && decorated.hasWriteFunction)
+        return decorated;
+    const directValue = instance[key];
+    if (directValue instanceof Observable)
+        return directValue;
+    if (directValue instanceof Computed && directValue.hasWriteFunction)
+        return directValue;
+    return undefined;
+}
 export function wireParams(instance, params, element) {
     const subscriptions = [];
     for (const key of Object.keys(params)) {
         if (SKIP_KEYS.has(key))
             continue;
         const paramValue = params[key];
-        const childObs = getObservable(instance, key);
-        const childIsReactive = childObs !== undefined && isSubscribable(childObs);
+        const childTarget = getWritableChildTarget(instance, key);
+        const childIsReactive = childTarget !== undefined && isSubscribable(childTarget);
         if (paramValue instanceof Observable) {
             if (childIsReactive) {
                 replaceObservable(instance, key, paramValue);
@@ -21,9 +34,19 @@ export function wireParams(instance, params, element) {
             }
         }
         else if (paramValue instanceof Computed) {
-            instance[key] = paramValue.get();
+            if (childTarget) {
+                childTarget.set(paramValue.get());
+            }
+            else {
+                instance[key] = paramValue.get();
+            }
             const sub = paramValue.subscribe((newValue) => {
-                instance[key] = newValue;
+                if (childTarget) {
+                    childTarget.set(newValue);
+                }
+                else {
+                    instance[key] = newValue;
+                }
             });
             subscriptions.push(sub);
             if (element) {

package/dist/wireParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"wireParams.js","sourceRoot":"","sources":["../src/wireParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAMpC,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,MAA+B,EAC/B,OAAc;IAEd,MAAM,aAAa,GAA4B,EAAE,CAAC;IAElD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAEjC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,eAAe,GAAG,QAAQ,KAAK,SAAS,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;QAE3E,IAAI,UAAU,YAAY,UAAU,EAAE,CAAC;YACrC,IAAI,eAAe,EAAE,CAAC;gBACpB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACL,QAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAChE,CAAC;QACH,CAAC;aAAM,IAAI,UAAU,YAAY,QAAQ,EAAE,CAAC;YACzC,QAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAC9D,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,QAAiB,EAAE,EAAE;gBACpD,QAAoC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACxD,CAAC,CAAC,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,OAAO,EAAE,CAAC;gBACZ,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;aAAM,CAAC;YACL,QAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"wireParams.js","sourceRoot":"","sources":["../src/wireParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpC,SAAS,sBAAsB,CAAC,QAAgB,EAAE,GAAW;IAC3D,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/C,IAAI,SAAS,YAAY,UAAU;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,SAAS,YAAY,QAAQ,IAAI,SAAS,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAElF,MAAM,WAAW,GAAI,QAAoC,CAAC,GAAG,CAAC,CAAC;IAC/D,IAAI,WAAW,YAAY,UAAU;QAAE,OAAO,WAAW,CAAC;IAC1D,IAAI,WAAW,YAAY,QAAQ,IAAI,WAAW,CAAC,gBAAgB;QAAE,OAAO,WAAW,CAAC;IAExF,OAAO,SAAS,CAAC;AACnB,CAAC;AAMD,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,MAA+B,EAC/B,OAAc;IAEd,MAAM,aAAa,GAA4B,EAAE,CAAC;IAElD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAEjC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAG,WAAW,KAAK,SAAS,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QAEjF,IAAI,UAAU,YAAY,UAAU,EAAE,CAAC;YACrC,IAAI,eAAe,EAAE,CAAC;gBACpB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACL,QAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAChE,CAAC;QACH,CAAC;aAAM,IAAI,UAAU,YAAY,QAAQ,EAAE,CAAC;YAC1C,IAAI,WAAW,EAAE,CAAC;gBAChB,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACL,QAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAChE,CAAC;YACD,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,QAAiB,EAAE,EAAE;gBACrD,IAAI,WAAW,EAAE,CAAC;oBAChB,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACL,QAAoC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;gBACxD,CAAC;YACH,CAAC,CAAC,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,OAAO,EAAE,CAAC;gBACZ,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;aAAM,CAAC;YACL,QAAoC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC"}

package/llms.txt

@@ -0,0 +1,360 @@
+# Tapout
+
+> Tapout is a modern ESM reactivity and templating library, spiritually inspired by KnockoutJS. Same philosophy, modern implementation.
+
+## Guidance
+
+- Prefer `@reactive accessor` over `new Observable()` for class properties
+- Prefer `@reactiveArray accessor` over `new ObservableArray()` for array properties
+- Prefer `@computed` over `new Computed()` for derived values in classes
+- Prefer `@component` decorator over `components.register()` for component registration
+- Use `tapout/core` when you only need reactivity (no DOM)
+- Use `tapout` when you need DOM bindings, templates, and components
+- Always dispose subscriptions and effects when no longer needed
+- Use `DisposableGroup` for centralized cleanup
+- Use `PureComputed` (or `@computed`, which uses it) for intermittent UI values
+
+## Installation
+
+```bash
+npm install tapout
+```
+
+ESM-only. Two entry points:
+
+```typescript
+import { Observable, applyBindings } from 'tapout';       // full library
+import { Observable, Computed } from 'tapout/core';        // reactivity only, no DOM
+```
+
+## Quick Start (Preferred Style)
+
+```typescript
+import { reactive, computed, component, applyBindings } from 'tapout';
+
+@component('greeting-card', `
+  <p>First: <input data-bind="textInput: firstName" /></p>
+  <p>Last: <input data-bind="textInput: lastName" /></p>
+  <h2 data-bind="text: fullName"></h2>
+`)
+class GreetingCard {
+  @reactive accessor firstName = 'Jane';
+  @reactive accessor lastName = 'Doe';
+
+  @computed get fullName() {
+    return `${this.firstName} ${this.lastName}`;
+  }
+}
+
+applyBindings({}, document.body);
+```
+
+```html
+<greeting-card></greeting-card>
+```
+
+## Core Reactivity
+
+### Observable
+
+Mutable reactive value. Reading inside a computed or effect tracks the dependency.
+
+```typescript
+const count = new Observable(0);
+count.get();    // read (tracks dependency)
+count.peek();   // read without tracking
+count.set(5);   // write, notifies subscribers
+```
+
+Decorator equivalent (preferred in classes):
+
+```typescript
+class MyClass {
+  @reactive accessor count = 0;
+}
+// Reading: this.count (tracks), Writing: this.count = 5 (notifies)
+```
+
+Pass extender options: `@reactive({ deferred: true }) accessor query = '';`
+
+### ObservableArray
+
+Observable wrapping an array with mutation methods: `push`, `pop`, `shift`, `unshift`, `splice`, `sort`, `reverse`, `remove`, `removeAll`, `replace`.
+
+```typescript
+const items = new ObservableArray(['a', 'b']);
+items.push('c');
+items.remove('a');
+```
+
+Decorator equivalent (preferred in classes):
+
+```typescript
+class MyClass {
+  @reactiveArray accessor items: string[] = [];
+}
+```
+
+Subscribe to fine-grained diffs:
+
+```typescript
+items.subscribe(changes => { /* status, value, index */ }, 'arrayChange');
+```
+
+### Computed
+
+Derived value, re-evaluates when dependencies change.
+
+```typescript
+const area = new Computed(() => width.get() * height.get());
+```
+
+Writable computed:
+
+```typescript
+const full = new Computed({
+  read: () => `${first.get()} ${last.get()}`,
+  write: (v: string) => { [first, last] = v.split(' ').map(s => s); },
+});
+```
+
+Decorator equivalent (preferred in classes):
+
+```typescript
+class MyClass {
+  @reactive accessor first = 'John';
+  @reactive accessor last = 'Doe';
+
+  @computed get full() { return `${this.first} ${this.last}`; }
+  set full(v: string) { [this.first, this.last] = v.split(' '); }
+}
+```
+
+### PureComputed
+
+Memory-optimized computed that sleeps when it has no subscribers. `@computed` uses this internally.
+
+```typescript
+const label = new PureComputed(() => `Count: ${count.get()}`);
+```
+
+### Effects
+
+```typescript
+// Runs immediately, then on each dependency change
+const handle = effect(() => name.get(), val => console.log(val));
+
+// Runs only on subsequent changes (not immediately)
+const handle = observe(() => name.get(), val => console.log(val));
+
+handle.dispose(); // stop
+```
+
+### Subscriptions
+
+```typescript
+const sub = count.subscribe(value => console.log(value));
+sub.dispose();
+```
+
+Event channels: `'change'` (default), `'beforeChange'`, `'spectate'`, `'dirty'`, `'awake'`, `'asleep'`, `'arrayChange'`.
+
+### Events
+
+Stateless hot signals with owner/consumer separation:
+
+```typescript
+class MyService {
+  private _onSave = new Event<SaveEvent>();
+  readonly onSave = this._onSave.subscribable;
+
+  save(id: number) { this._onSave.emit(new SaveEvent(id, true)); }
+}
+```
+
+Type-filtered: `event.subscribable.on(SaveEvent).subscribe(...)`.
+Aggregate: `AggregateEvent` rolls up multiple event sources via `pipe()`.
+
+### DisposableGroup
+
+Centralized cleanup for subscriptions and event subscriptions:
+
+```typescript
+private _subs = new DisposableGroup();
+// this._subs.add(someSubscription);
+// this._subs.dispose(); // cleans up all at once
+```
+
+## Extenders
+
+```typescript
+obs.extend({ rateLimit: { timeout: 300, method: 'notifyWhenChangesStop' } });
+obs.extend({ rateLimit: 200 });      // throttle
+obs.extend({ notify: 'always' });    // always notify
+obs.extend({ deferred: true });      // microtask batching
+```
+
+## Decorators (Preferred API)
+
+| Decorator | Target | Backing |
+|---|---|---|
+| `@reactive` | `accessor` property | `Observable` |
+| `@reactiveArray` | `accessor` property | `ObservableArray` |
+| `@computed` | getter, getter+setter, method | `PureComputed` / writable `Computed` |
+| `@component(tag, template)` | class | registers component |
+
+Access underlying observable: `getObservable(instance, 'propName')`.
+Replace underlying observable: `replaceObservable(instance, 'propName', newObs)`.
+
+## Components
+
+### Registration (decorator preferred)
+
+```typescript
+@component('user-card', '<div><span data-bind="text: name"></span></div>')
+class UserCard {
+  @reactive accessor name = '';
+}
+```
+
+Or with options:
+
+```typescript
+@component({ tag: 'user-card', template: '...', synchronous: true })
+class UserCard { ... }
+```
+
+Manual registration (use decorator instead when possible):
+
+```typescript
+components.register('user-card', { template: '...', viewModel: UserCard });
+```
+
+### Usage
+
+```html
+<user-card params="name: userName"></user-card>
+```
+
+### Params and Wiring
+
+- Plain values assigned directly
+- Computed params create one-way subscription
+- `$`-prefixed observable params enable two-way binding
+
+```html
+<user-card params="name: $sharedName"></user-card>
+```
+
+### Lifecycle
+
+```typescript
+onInit()                        // after creation and param wiring
+onDescendantsComplete(node)     // after DOM is ready
+dispose()                       // on cleanup
+```
+
+### Slots
+
+```html
+<!-- Component template -->
+<div data-bind="slot: 'header'">Default</div>
+<div data-bind="slot: ''">Default body</div>
+
+<!-- Usage -->
+<my-card>
+  <h2 slot="header">Custom Title</h2>
+  <p>Body content</p>
+</my-card>
+```
+
+## Binding System
+
+Apply bindings: `applyBindings(vm, rootElement)`.
+
+### Context
+
+`$data`, `$root`, `$parent`, `$parents`, `$index`, `$component`, `$parentContext`, `$rawData`, `$componentTemplateNodes`.
+
+Inspect: `contextFor(element)`, `dataFor(element)`.
+
+### Built-in Bindings
+
+**Display:** `text`, `html`, `visible`, `hidden`.
+**Attributes:** `attr: { href: url }`, `css: { active: isActive }`, `class: className`, `style: { color: c }`.
+**Form state:** `enable`, `disable`, `uniqueName`.
+**Events:** `event: { mouseover: fn }`, `click`, `submit`, `enter`. Return `true` for default behavior. Use `clickBubble: false` to stop bubbling.
+**Two-way:** `value`, `textInput`, `checked`, `checkedValue`, `hasFocus`, `selectedOptions`, `options`.
+**Control flow:** `if`, `ifnot`, `with`, `using`, `let`, `foreach`, `template`.
+**Dialog:** `modal`.
+
+### Virtual Elements
+
+```html
+<!-- tap if: showSection -->
+  <p>Content</p>
+<!-- /tap -->
+
+<!-- tap foreach: items -->
+  <span data-bind="text: $data"></span>
+<!-- /tap -->
+```
+
+### Interpolation Markup
+
+Enable with `enableInterpolationMarkup()`:
+
+```html
+<span>Hello, {{ name }}!</span>
+<div>{{{ richHtml }}}</div>
+{{# if isLoggedIn }}<p>Welcome!</p>{{/ if }}
+```
+
+### Attribute Interpolation
+
+Enable with `enableAttributeInterpolationMarkup()`:
+
+```html
+<a href="{{ baseUrl }}/profile/{{ userId }}">Profile</a>
+```
+
+### Namespaced Bindings
+
+Enable with `enableNamespacedBindings()`:
+
+```html
+<a data-bind="attr.href: url, css.active: isActive">Link</a>
+```
+
+### Filters
+
+Enable with `enableTextFilter('text')`:
+
+```html
+<span data-bind="text: name | uppercase"></span>
+<span data-bind="text: bio | default:'None'"></span>
+```
+
+Built-in: `uppercase`, `lowercase`, `default`, `json`. Custom: `filters['myFilter'] = (val, ...args) => result`.
+
+## Utilities
+
+- `toJS(obj)` — deep-unwrap observables to plain JS
+- `toJSON(obj)` — JSON string of unwrapped object
+- `when(() => condition, callback)` — one-shot reactive wait (or returns Promise if no callback)
+- `unwrapObservable(val)` — recursively unwrap
+- `cleanNode(el)`, `removeNode(el)`, `addDisposeCallback(el, fn)` — DOM cleanup
+
+## Configuration
+
+```typescript
+import { options } from 'tapout';
+options.deferUpdates = true;                    // global microtask batching
+options.onError = (err) => { ... };             // global error handler
+options.viewModelFactory = (ctor) => new ctor(); // DI hook
+options.customElementDisplayContents = true;     // display: contents on custom elements
+```
+
+## Type Guards
+
+`isObservable(v)`, `isObservableArray(v)`, `isComputed(v)`, `isPureComputed(v)`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thomas-siegfried/tapout",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,9 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "llms.txt",
+    "decorator-config.md"
   ],
   "scripts": {
     "build": "tsc",

package/src/decorators.ts

@@ -1,5 +1,6 @@
 import { Observable } from './observable.js';
 import { ObservableArray } from './observableArray.js';
+import { getReactiveArrayDecoratorProxy } from './reactiveArrayDecoratorProxy.js';
 import { Computed } from './computed.js';
 import type { Subscribable } from './subscribable.js';
 import type { ExtenderOptions } from './extenders.js';
@@ -157,12 +158,12 @@ function createStage3ReactiveArray(extenders?: ExtenderOptions) {
       const obs = new ObservableArray(arr);
       if (extenders) obs.extend(extenders);
       storeObservable(this as object, context.name, obs);
-      return obs;
+      return getReactiveArrayDecoratorProxy(obs);
     },
     get(this: object): unknown {
       const obs = lookupObservable(this, context.name) as ObservableArray<unknown>;
       registerDependency(obs);
-      return obs;
+      return getReactiveArrayDecoratorProxy(obs);
     },
     set(this: object, newValue: unknown): void {
       const obs = lookupObservable(this, context.name) as ObservableArray<unknown>;
@@ -193,7 +194,7 @@ function applyLegacyReactiveArray(
         storeObservable(this, propertyKey, obs);
       }
       registerDependency(obs);
-      return obs;
+      return getReactiveArrayDecoratorProxy(obs as ObservableArray<unknown>);
     },
     set(this: object, value: unknown) {
       let obs = lookupObservable(this, propertyKey);

package/src/dependencyDetection.ts

@@ -10,6 +10,8 @@ export interface TrackingFrame {
     getDependencies(): AnySubscribable[];
   };
   isInitial?: boolean;
+  /** Dedupes repeated registration of the same subscribable in one frame (e.g. `@reactiveArray` getter + indexed proxy read). */
+  _dependencyDedupe?: WeakSet<AnySubscribable>;
 }
 
 let lastId = 0;
@@ -34,6 +36,15 @@ export function registerDependency(subscribable: AnySubscribable): void {
     if (!isSubscribable(subscribable)) {
       throw new Error('Only subscribable things can act as dependencies');
     }
+    let dedupe = currentFrame._dependencyDedupe;
+    if (!dedupe) {
+      dedupe = new WeakSet();
+      currentFrame._dependencyDedupe = dedupe;
+    }
+    if (dedupe.has(subscribable)) {
+      return;
+    }
+    dedupe.add(subscribable);
     currentFrame.callback(
       subscribable,
       subscribable._id || (subscribable._id = getId()),

package/src/reactiveArrayDecoratorProxy.ts

@@ -0,0 +1,84 @@
+import { registerDependency } from './dependencyDetection.js';
+import { ObservableArray } from './observableArray.js';
+
+const proxyCache = new WeakMap<ObservableArray<unknown>, object>();
+
+/**
+ * ES array index property name: ToString(ToUint32(P)) === P and ToUint32(P) ≠ 2³²−1.
+ * @see https://tc39.es/ecma262/#sec-array-exotic-objects
+ */
+function parseArrayIndexString(key: string): number | undefined {
+  const index = Number(key) >>> 0;
+  if (index === 0xffff_ffff) return undefined;
+  if (`${index}` !== key) return undefined;
+  return index;
+}
+
+/**
+ * Proxy used only for `@reactiveArray` decorated properties: supports `list[0]` read/write
+ * while keeping `getObservable()` on the underlying {@link ObservableArray}.
+ *
+ * Methods and accessors are applied to the real instance (not the proxy) so internal state works.
+ */
+export function getReactiveArrayDecoratorProxy<T>(obs: ObservableArray<T>): ObservableArray<T> {
+  let prox = proxyCache.get(obs as ObservableArray<unknown>);
+  if (!prox) {
+    prox = new Proxy(obs, {
+      get(target, prop, _receiver) {
+        if (typeof prop === 'string') {
+          const index = parseArrayIndexString(prop);
+          if (index !== undefined) {
+            registerDependency(target);
+            return target.peek()[index];
+          }
+        }
+        const value = Reflect.get(target, prop, target);
+        if (typeof value === 'function') {
+          return value.bind(target);
+        }
+        return value;
+      },
+      set(target, prop, value, _receiver) {
+        if (typeof prop === 'string') {
+          const index = parseArrayIndexString(prop);
+          if (index !== undefined) {
+            const arr = target.peek();
+            target.valueWillMutate();
+            arr[index] = value as T;
+            target.valueHasMutated();
+            return true;
+          }
+        }
+        return Reflect.set(target, prop, value, target);
+      },
+      has(target, prop) {
+        if (typeof prop === 'string') {
+          const index = parseArrayIndexString(prop);
+          if (index !== undefined) {
+            registerDependency(target);
+            return Reflect.has(target.peek(), prop);
+          }
+        }
+        return Reflect.has(target, prop);
+      },
+      deleteProperty(target, prop) {
+        if (typeof prop === 'string') {
+          const index = parseArrayIndexString(prop);
+          if (index !== undefined) {
+            const arr = target.peek();
+            if (Reflect.has(arr, prop)) {
+              target.valueWillMutate();
+              delete arr[index];
+              target.valueHasMutated();
+              return true;
+            }
+            return true;
+          }
+        }
+        return Reflect.deleteProperty(target, prop);
+      },
+    });
+    proxyCache.set(obs as ObservableArray<unknown>, prox);
+  }
+  return prox as ObservableArray<T>;
+}

package/src/wireParams.ts

@@ -7,6 +7,18 @@ import { addDisposeCallback } from './domNodeDisposal.js';
 
 const SKIP_KEYS = new Set(['$raw']);
 
+function getWritableChildTarget(instance: object, key: string): Observable<unknown> | Computed<unknown> | undefined {
+  const decorated = getObservable(instance, key);
+  if (decorated instanceof Observable) return decorated;
+  if (decorated instanceof Computed && decorated.hasWriteFunction) return decorated;
+
+  const directValue = (instance as Record<string, unknown>)[key];
+  if (directValue instanceof Observable) return directValue;
+  if (directValue instanceof Computed && directValue.hasWriteFunction) return directValue;
+
+  return undefined;
+}
+
 export interface WireParamsResult {
   subscriptions: Subscription<unknown>[];
 }
@@ -22,8 +34,8 @@ export function wireParams(
     if (SKIP_KEYS.has(key)) continue;
 
     const paramValue = params[key];
-    const childObs = getObservable(instance, key);
-    const childIsReactive = childObs !== undefined && isSubscribable(childObs);
+    const childTarget = getWritableChildTarget(instance, key);
+    const childIsReactive = childTarget !== undefined && isSubscribable(childTarget);
 
     if (paramValue instanceof Observable) {
       if (childIsReactive) {
@@ -32,9 +44,17 @@ export function wireParams(
         (instance as Record<string, unknown>)[key] = paramValue.get();
       }
     } else if (paramValue instanceof Computed) {
-      (instance as Record<string, unknown>)[key] = paramValue.get();
+      if (childTarget) {
+        childTarget.set(paramValue.get());
+      } else {
+        (instance as Record<string, unknown>)[key] = paramValue.get();
+      }
       const sub = paramValue.subscribe((newValue: unknown) => {
-        (instance as Record<string, unknown>)[key] = newValue;
+        if (childTarget) {
+          childTarget.set(newValue);
+        } else {
+          (instance as Record<string, unknown>)[key] = newValue;
+        }
       });
       subscriptions.push(sub);
       if (element) {