@rlabs-inc/signals 1.12.0 → 1.13.1

package/README.md

@@ -85,6 +85,10 @@ flushSync()  // Logs: "Count: 5, Doubled: 10"
   - [typedSlotArray](#typedslotarray)
   - [typedSlotArrayGroup](#typedslotarraygroup)
   - [reactiveProps](#reactiveprops)
+- [Shared Memory](#shared-memory)
+  - [SharedSlotBuffer](#sharedslotbuffer)
+  - [Repeater](#repeater)
+  - [Notifier](#notifier)
 - [Deep Reactivity](#deep-reactivity)
 - [Utilities](#utilities)
 - [Reactive Collections](#reactive-collections)
@@ -720,6 +724,91 @@ MyComponent({ name: nameSignal, count: () => getCount(), active: activeSignal })
 
 ---
 
+## Shared Memory
+
+Cross-language reactive shared memory primitives. Three layers that connect independent reactive graphs (e.g., TypeScript and Rust) through SharedArrayBuffer with zero serialization.
+
+### SharedSlotBuffer
+
+Reactive typed arrays backed by shared memory. `get()` tracks dependencies, `set()` writes + notifies the reactive graph + notifies the other side.
+
+```typescript
+import { sharedSlotBuffer, sharedSlotBufferGroup, NoopNotifier } from '@rlabs-inc/signals'
+
+// Create a buffer backed by SharedArrayBuffer
+const sab = new SharedArrayBuffer(4096 * 4)
+const widths = sharedSlotBuffer({
+  buffer: new Float32Array(sab),
+  notifier: new NoopNotifier(), // or AtomicsNotifier for cross-thread
+})
+
+// Reactive read — tracks dependency in deriveds/effects
+const w = widths.get(0)
+
+// Write — updates shared memory + marks reactions dirty + notifies
+widths.set(0, 150.0)
+
+// Batch write — single notification at the end
+widths.setBatch([[0, 100], [1, 200], [2, 300]])
+
+// Direct TypedArray access for FFI
+nativeEngine(widths.raw) // Float32Array on SharedArrayBuffer
+
+// Create a group of buffers with shared dirty tracking
+const layout = sharedSlotBufferGroup({
+  width: { buffer: new Float32Array(sab, 0, 4096), notifier },
+  height: { buffer: new Float32Array(sab, 4096 * 4, 4096), notifier },
+})
+```
+
+### Repeater
+
+A new reactive graph primitive — NOT an effect, NOT a derived. A purpose-built forwarding node that runs **inline during `markReactions`** with zero scheduling overhead. ~40-50 bytes per binding (vs ~200+ for Effect).
+
+```typescript
+import { signal, repeat } from '@rlabs-inc/signals'
+
+const myWidth = signal(100)
+
+// Bind signal → buffer position
+// When myWidth changes, the repeater forwards the value inline
+const dispose = repeat(myWidth, widthBuffer, 0)
+
+// That's it. No effect scheduling, no microtask delay.
+// myWidth.value = 200 → buffer[0] is 200 during the same markReactions pass
+```
+
+**How it works:**
+```
+myWidth.value = 200
+  → markReactions(myWidth)
+    → encounters REPEATER node
+      → calls forward() INLINE (not scheduled)
+        → reads myWidth (already 200)
+        → writes buffer[0] = 200
+        → sets dirty flag
+        → notifier.notify() (batched)
+    → markReactions continues...
+```
+
+### Notifier
+
+Pluggable cross-side notification. Decouples the reactive system from the transport layer.
+
+```typescript
+import { AtomicsNotifier, NoopNotifier } from '@rlabs-inc/signals'
+
+// For cross-thread/cross-language communication
+const wakeFlag = new Int32Array(new SharedArrayBuffer(4))
+const notifier = new AtomicsNotifier(wakeFlag)
+// Multiple synchronous writes → single Atomics.notify via microtask batching
+
+// For testing (no-op)
+const silent = new NoopNotifier()
+```
+
+---
+
 ## Deep Reactivity
 
 ### proxy

package/dist/core/constants.d.ts

@@ -34,6 +34,8 @@ export declare const UNOWNED: number;
 export declare const DISCONNECTED: number;
 /** Effect is an inspect effect (for $inspect) */
 export declare const INSPECT_EFFECT: number;
+/** Reaction is a repeater (inline write-through forwarding node) */
+export declare const REPEATER: number;
 /** Sentinel for uninitialized values (deleted properties, new deriveds) */
 export declare const UNINITIALIZED: unique symbol;
 /** Sentinel for stale reactions (aborted async work) */

package/dist/core/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AASA,2CAA2C;AAC3C,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,0BAA0B;AAC1B,eAAO,MAAM,MAAM,QAAS,CAAA;AAE5B,wEAAwE;AACxE,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,iDAAiD;AACjD,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,wCAAwC;AACxC,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,+BAA+B;AAC/B,eAAO,MAAM,YAAY,QAAS,CAAA;AAMlC,4CAA4C;AAC5C,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,yDAAyD;AACzD,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,mEAAmE;AACnE,eAAO,MAAM,WAAW,QAAU,CAAA;AAElC,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,QAAU,CAAA;AAE3C,gCAAgC;AAChC,eAAO,MAAM,SAAS,QAAU,CAAA;AAEhC,+BAA+B;AAC/B,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,mCAAmC;AACnC,eAAO,MAAM,UAAU,QAAU,CAAA;AAEjC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAU,CAAA;AAMvC,oDAAoD;AACpD,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,0DAA0D;AAC1D,eAAO,MAAM,YAAY,QAAS,CAAA;AAMlC,iDAAiD;AACjD,eAAO,MAAM,cAAc,QAAU,CAAA;AAMrC,2EAA2E;AAC3E,eAAO,MAAM,aAAa,EAAE,OAAO,MAAkD,CAAA;AAErF,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,OAAO,MAAmD,CAAA;AAEvF,0CAA0C;AAC1C,eAAO,MAAM,YAAY,EAAE,OAAO,MAA0C,CAAA;AAE5E,sCAAsC;AACtC,eAAO,MAAM,eAAe,EAAE,OAAO,MAA6C,CAAA;AAElF,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,OAAO,MAA4C,CAAA;AAEhF,8CAA8C;AAC9C,eAAO,MAAM,aAAa,EAAE,OAAO,MAA2C,CAAA;AAE9E,sCAAsC;AACtC,eAAO,MAAM,WAAW,EAAE,OAAO,MAAyC,CAAA;AAM1E,sCAAsC;AACtC,eAAO,MAAM,MAAM,QAAS,CAAA;AAM5B,gEAAgE;AAChE,eAAO,MAAM,WAAW,QAAiC,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AASA,2CAA2C;AAC3C,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,0BAA0B;AAC1B,eAAO,MAAM,MAAM,QAAS,CAAA;AAE5B,wEAAwE;AACxE,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,iDAAiD;AACjD,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,wCAAwC;AACxC,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,+BAA+B;AAC/B,eAAO,MAAM,YAAY,QAAS,CAAA;AAMlC,4CAA4C;AAC5C,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,yDAAyD;AACzD,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,mEAAmE;AACnE,eAAO,MAAM,WAAW,QAAU,CAAA;AAElC,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,QAAU,CAAA;AAE3C,gCAAgC;AAChC,eAAO,MAAM,SAAS,QAAU,CAAA;AAEhC,+BAA+B;AAC/B,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,mCAAmC;AACnC,eAAO,MAAM,UAAU,QAAU,CAAA;AAEjC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAU,CAAA;AAMvC,oDAAoD;AACpD,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,0DAA0D;AAC1D,eAAO,MAAM,YAAY,QAAS,CAAA;AAMlC,iDAAiD;AACjD,eAAO,MAAM,cAAc,QAAU,CAAA;AAErC,oEAAoE;AACpE,eAAO,MAAM,QAAQ,QAAU,CAAA;AAM/B,2EAA2E;AAC3E,eAAO,MAAM,aAAa,EAAE,OAAO,MAAkD,CAAA;AAErF,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,OAAO,MAAmD,CAAA;AAEvF,0CAA0C;AAC1C,eAAO,MAAM,YAAY,EAAE,OAAO,MAA0C,CAAA;AAE5E,sCAAsC;AACtC,eAAO,MAAM,eAAe,EAAE,OAAO,MAA6C,CAAA;AAElF,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,OAAO,MAA4C,CAAA;AAEhF,8CAA8C;AAC9C,eAAO,MAAM,aAAa,EAAE,OAAO,MAA2C,CAAA;AAE9E,sCAAsC;AACtC,eAAO,MAAM,WAAW,EAAE,OAAO,MAAyC,CAAA;AAM1E,sCAAsC;AACtC,eAAO,MAAM,MAAM,QAAS,CAAA;AAM5B,gEAAgE;AAChE,eAAO,MAAM,WAAW,QAAiC,CAAA"}

package/dist/index.d.ts

@@ -18,8 +18,13 @@ export { ReactiveSet } from './collections/set.js';
 export { ReactiveDate } from './collections/date.js';
 export { ReactiveSharedFloat32Array, ReactiveSharedUint8Array, ReactiveSharedInt32Array, ReactiveSharedUint32Array, createSharedBufferContext, notifyNative, scheduleNotify, } from './shared/reactive-shared-array.js';
 export type { SharedBufferContext, ReactiveSharedArrayOptions, } from './shared/reactive-shared-array.js';
+export { sharedSlotBuffer, sharedSlotBufferGroup } from './shared/shared-slot-buffer.js';
+export type { SharedSlotBuffer, SharedSlotBufferOptions, SharedSlotBufferGroupConfig } from './shared/shared-slot-buffer.js';
+export { AtomicsNotifier, NoopNotifier } from './shared/notifier.js';
+export type { Notifier } from './shared/notifier.js';
+export { repeat } from './primitives/repeater.js';
 export { get, set, isDirty, setSignalStatus, markReactions, updateReaction, removeReactions, disconnectSource, } from './reactivity/tracking.js';
-export { DERIVED, EFFECT, RENDER_EFFECT, ROOT_EFFECT, BRANCH_EFFECT, USER_EFFECT, BLOCK_EFFECT, CLEAN, DIRTY, MAYBE_DIRTY, REACTION_IS_UPDATING, DESTROYED, INERT, EFFECT_RAN, EFFECT_PRESERVED, UNOWNED, DISCONNECTED, UNINITIALIZED, STALE_REACTION, STATE_SYMBOL, REACTIVE_MARKER, BINDING_SYMBOL, LINKED_SYMBOL, SLOT_SYMBOL, } from './core/constants.js';
+export { DERIVED, EFFECT, RENDER_EFFECT, ROOT_EFFECT, BRANCH_EFFECT, USER_EFFECT, BLOCK_EFFECT, CLEAN, DIRTY, MAYBE_DIRTY, REACTION_IS_UPDATING, DESTROYED, INERT, EFFECT_RAN, EFFECT_PRESERVED, UNOWNED, DISCONNECTED, REPEATER, UNINITIALIZED, STALE_REACTION, STATE_SYMBOL, REACTIVE_MARKER, BINDING_SYMBOL, LINKED_SYMBOL, SLOT_SYMBOL, } from './core/constants.js';
 export { activeReaction, activeEffect, untracking, writeVersion, readVersion, batchDepth, setActiveReaction, setActiveEffect, setUntracking, incrementWriteVersion, incrementReadVersion, incrementBatchDepth, decrementBatchDepth, getReadVersion, getWriteVersion, getBatchDepth, } from './core/globals.js';
 export type { Signal, Source, Reaction, Derived, Effect, Value, ReadableSignal, WritableSignal, DerivedSignal, DisposeFn, CleanupFn, EffectFn, Equals, Uninitialized, ExtractInner, } from './core/types.js';
 export type { Binding, ReadonlyBinding } from './primitives/bind.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -47,6 +47,8 @@ __export(exports_src, {
   slot: () => slot,
   signals: () => signals,
   signal: () => signal,
+  sharedSlotBufferGroup: () => sharedSlotBufferGroup,
+  sharedSlotBuffer: () => sharedSlotBuffer,
   shallowEquals: () => shallowEquals,
   setUntracking: () => setUntracking,
   setSignalStatus: () => setSignalStatus,
@@ -56,6 +58,7 @@ __export(exports_src, {
   scheduleNotify: () => scheduleNotify,
   safeNotEqual: () => safeNotEqual,
   safeEquals: () => safeEquals,
+  repeat: () => repeat,
   removeReactions: () => removeReactions,
   readVersion: () => readVersion,
   reactiveProps: () => reactiveProps,
@@ -119,9 +122,11 @@ __export(exports_src, {
   ReactiveMap: () => ReactiveMap,
   ReactiveDate: () => ReactiveDate,
   ROOT_EFFECT: () => ROOT_EFFECT,
+  REPEATER: () => REPEATER,
   RENDER_EFFECT: () => RENDER_EFFECT,
   REACTIVE_MARKER: () => REACTIVE_MARKER,
   REACTION_IS_UPDATING: () => REACTION_IS_UPDATING,
+  NoopNotifier: () => NoopNotifier,
   MAYBE_DIRTY: () => MAYBE_DIRTY,
   LINKED_SYMBOL: () => LINKED_SYMBOL,
   INERT: () => INERT,
@@ -135,7 +140,8 @@ __export(exports_src, {
   CLEAN: () => CLEAN,
   BRANCH_EFFECT: () => BRANCH_EFFECT,
   BLOCK_EFFECT: () => BLOCK_EFFECT,
-  BINDING_SYMBOL: () => BINDING_SYMBOL
+  BINDING_SYMBOL: () => BINDING_SYMBOL,
+  AtomicsNotifier: () => AtomicsNotifier
 });
 module.exports = __toCommonJS(exports_src);
 
@@ -201,6 +207,7 @@ var EFFECT_PRESERVED = 1 << 17;
 var UNOWNED = 1 << 8;
 var DISCONNECTED = 1 << 9;
 var INSPECT_EFFECT = 1 << 18;
+var REPEATER = 1 << 19;
 var UNINITIALIZED = Symbol.for("rlabs.signals.uninitialized");
 var STALE_REACTION = Symbol.for("rlabs.signals.stale_reaction");
 var STATE_SYMBOL = Symbol.for("rlabs.signals.state");
@@ -415,6 +422,110 @@ async function tick() {
   flushSync();
 }
 
+// src/primitives/repeater.ts
+var SOURCE_SYMBOL = Symbol.for("signal.source");
+function resolveSource(input) {
+  if (typeof input === "number") {
+    return null;
+  }
+  if (typeof input === "function") {
+    return null;
+  }
+  const maybeSource = input;
+  if (maybeSource && typeof maybeSource.f === "number" && "v" in maybeSource && "reactions" in maybeSource) {
+    return {
+      source: maybeSource,
+      readFn: () => get(maybeSource)
+    };
+  }
+  const src = input[SOURCE_SYMBOL];
+  if (src && typeof src.f === "number" && "reactions" in src) {
+    return { source: src, readFn: () => get(src) };
+  }
+  return null;
+}
+function repeat(input, target, index) {
+  if (typeof input === "number") {
+    target.set(index, input);
+    return () => {};
+  }
+  if (typeof input === "function") {
+    return repeatGetter(input, target, index);
+  }
+  const resolved = resolveSource(input);
+  if (resolved) {
+    return repeatSource(resolved.source, resolved.readFn, target, index);
+  }
+  if (typeof input.value !== "undefined") {
+    return repeatSignalWrapper(input, target, index);
+  }
+  throw new Error("repeat(): unsupported source type");
+}
+function repeatSource(src, readFn, target, index) {
+  const node = {
+    f: REPEATER | CLEAN,
+    wv: 0,
+    fn: null,
+    deps: [src],
+    _readFn: readFn,
+    _target: target,
+    _index: index
+  };
+  if (src.reactions === null) {
+    src.reactions = [node];
+  } else {
+    src.reactions.push(node);
+  }
+  target.set(index, readFn());
+  return () => {
+    node.f |= DESTROYED;
+    if (src.reactions) {
+      const idx = src.reactions.indexOf(node);
+      if (idx !== -1) {
+        const last = src.reactions.length - 1;
+        if (idx !== last)
+          src.reactions[idx] = src.reactions[last];
+        src.reactions.pop();
+        if (src.reactions.length === 0)
+          src.reactions = null;
+      }
+    }
+  };
+}
+function repeatGetter(getter, target, index) {
+  const node = {
+    f: REPEATER | CLEAN,
+    wv: 0,
+    fn: getter,
+    deps: null,
+    _readFn: getter,
+    _target: target,
+    _index: index
+  };
+  const initialValue = updateReaction(node);
+  target.set(index, initialValue);
+  return () => {
+    node.f |= DESTROYED;
+    removeReactions(node, 0);
+    node.deps = null;
+  };
+}
+function repeatSignalWrapper(sig, target, index) {
+  const src = sig[SOURCE_SYMBOL];
+  if (src && typeof src.f === "number" && "reactions" in src) {
+    return repeatSource(src, () => get(src), target, index);
+  }
+  return repeatGetter(() => sig.value, target, index);
+}
+function forwardRepeater(reaction) {
+  const r = reaction;
+  if ((r.f & DESTROYED) !== 0)
+    return false;
+  const val = r._readFn();
+  r._target.set(r._index, val);
+  return true;
+}
+
 // src/reactivity/tracking.ts
 function get(signal) {
   if (activeReaction !== null && !untracking) {
@@ -533,6 +644,11 @@ function markReactions(signal, status) {
       }
       if ((flags & DERIVED) !== 0) {
         stack.push({ signal: reaction, status: MAYBE_DIRTY });
+      } else if ((flags & REPEATER) !== 0) {
+        if (notDirty) {
+          forwardRepeater(reaction);
+          setSignalStatus(reaction, CLEAN);
+        }
       } else if (notDirty) {
         scheduleEffect(reaction);
       }
@@ -729,7 +845,7 @@ function updateReaction(reaction) {
 }
 
 // src/primitives/signal.ts
-var SOURCE_SYMBOL = Symbol("signal.source");
+var SOURCE_SYMBOL2 = Symbol.for("signal.source");
 function source(initialValue, options) {
   return {
     f: 0,
@@ -749,7 +865,7 @@ var signalCleanup = new FinalizationRegistry((src) => {
 function signal(initialValue, options) {
   const src = source(initialValue, options);
   const sig = {
-    [SOURCE_SYMBOL]: src,
+    [SOURCE_SYMBOL2]: src,
     get value() {
       return get(src);
     },
@@ -761,7 +877,7 @@ function signal(initialValue, options) {
   return sig;
 }
 function getSource(sig) {
-  return sig[SOURCE_SYMBOL];
+  return sig[SOURCE_SYMBOL2];
 }
 var proxyFn = null;
 function setProxyFn(fn) {
@@ -2926,6 +3042,181 @@ class ReactiveSharedUint32Array {
     return this.view.length;
   }
 }
+// src/shared/shared-slot-buffer.ts
+function sharedSlotBuffer(options) {
+  let buffer;
+  if (options.buffer) {
+    buffer = options.buffer;
+  } else if (options.type && options.capacity != null) {
+    buffer = new options.type(options.capacity);
+  } else {
+    throw new Error("sharedSlotBuffer: provide either buffer or type+capacity");
+  }
+  const capacity = buffer.length;
+  const defaultValue = options.defaultValue ?? 0;
+  const notifier = options.notifier ?? null;
+  const dirtyFlags = options.dirtyFlags ?? null;
+  const source2 = {
+    f: SOURCE | CLEAN,
+    v: 0,
+    wv: 0,
+    rv: 0,
+    reactions: null,
+    equals: () => false
+  };
+  const indexSources = new Map;
+  function _set(index, value) {
+    if (buffer[index] === value)
+      return;
+    buffer[index] = value;
+    if (dirtyFlags)
+      dirtyFlags[index] = 1;
+    source2.wv = incrementWriteVersion();
+    markReactions(source2, DIRTY);
+    const idx = indexSources.get(index);
+    if (idx) {
+      idx.v = value;
+      idx.wv = source2.wv;
+      markReactions(idx, DIRTY);
+    }
+    notifier?.notify();
+  }
+  return {
+    get capacity() {
+      return capacity;
+    },
+    get raw() {
+      return buffer;
+    },
+    get(index) {
+      get(source2);
+      const idx = indexSources.get(index);
+      if (idx)
+        get(idx);
+      return buffer[index];
+    },
+    peek(index) {
+      return buffer[index];
+    },
+    set: _set,
+    setBatch(updates) {
+      let changed = false;
+      const wv = incrementWriteVersion();
+      for (let i = 0;i < updates.length; i++) {
+        const [index, value] = updates[i];
+        if (buffer[index] !== value) {
+          buffer[index] = value;
+          if (dirtyFlags)
+            dirtyFlags[index] = 1;
+          changed = true;
+          const idx = indexSources.get(index);
+          if (idx) {
+            idx.v = value;
+            idx.wv = wv;
+            markReactions(idx, DIRTY);
+          }
+        }
+      }
+      if (changed) {
+        source2.wv = wv;
+        markReactions(source2, DIRTY);
+        notifier?.notify();
+      }
+    },
+    getIndexSource(index) {
+      let src = indexSources.get(index);
+      if (!src) {
+        src = {
+          f: SOURCE | CLEAN,
+          v: buffer[index],
+          wv: 0,
+          rv: 0,
+          reactions: null,
+          equals: Object.is
+        };
+        indexSources.set(index, src);
+      }
+      return src;
+    },
+    notifyChanged() {
+      source2.wv = incrementWriteVersion();
+      markReactions(source2, DIRTY);
+    },
+    notifyIndicesChanged(indices) {
+      const wv = incrementWriteVersion();
+      for (let i = 0;i < indices.length; i++) {
+        const idx = indexSources.get(indices[i]);
+        if (idx) {
+          idx.v = buffer[indices[i]];
+          idx.wv = wv;
+          markReactions(idx, DIRTY);
+        }
+      }
+      source2.wv = wv;
+      markReactions(source2, DIRTY);
+    },
+    clear(index) {
+      _set(index, defaultValue);
+    },
+    dispose() {
+      source2.reactions = null;
+      indexSources.forEach((src) => {
+        src.reactions = null;
+      });
+      indexSources.clear();
+    }
+  };
+}
+function sharedSlotBufferGroup(config, options) {
+  const notifier = options?.notifier;
+  const dirtyFlags = options?.dirtyFlags;
+  const arrays = {};
+  const buffers = [];
+  for (const key in config) {
+    const cfg = config[key];
+    const buf = sharedSlotBuffer({
+      type: cfg.type,
+      capacity: cfg.capacity,
+      defaultValue: cfg.defaultValue,
+      notifier,
+      dirtyFlags
+    });
+    arrays[key] = buf;
+    buffers.push(buf);
+  }
+  return {
+    arrays,
+    dispose() {
+      for (let i = 0;i < buffers.length; i++) {
+        buffers[i].dispose();
+      }
+    }
+  };
+}
+// src/shared/notifier.ts
+class AtomicsNotifier {
+  wakeFlag;
+  index;
+  pending = false;
+  constructor(wakeFlag, index = 0) {
+    this.wakeFlag = wakeFlag;
+    this.index = index;
+  }
+  notify() {
+    if (!this.pending) {
+      this.pending = true;
+      queueMicrotask(() => {
+        this.pending = false;
+        Atomics.store(this.wakeFlag, this.index, 1);
+        Atomics.notify(this.wakeFlag, this.index);
+      });
+    }
+  }
+}
+
+class NoopNotifier {
+  notify() {}
+}
 
 // src/index.ts
 setProxyFn(proxy);

package/dist/index.mjs

@@ -60,6 +60,7 @@ var EFFECT_PRESERVED = 1 << 17;
 var UNOWNED = 1 << 8;
 var DISCONNECTED = 1 << 9;
 var INSPECT_EFFECT = 1 << 18;
+var REPEATER = 1 << 19;
 var UNINITIALIZED = Symbol.for("rlabs.signals.uninitialized");
 var STALE_REACTION = Symbol.for("rlabs.signals.stale_reaction");
 var STATE_SYMBOL = Symbol.for("rlabs.signals.state");
@@ -274,6 +275,110 @@ async function tick() {
   flushSync();
 }
 
+// src/primitives/repeater.ts
+var SOURCE_SYMBOL = Symbol.for("signal.source");
+function resolveSource(input) {
+  if (typeof input === "number") {
+    return null;
+  }
+  if (typeof input === "function") {
+    return null;
+  }
+  const maybeSource = input;
+  if (maybeSource && typeof maybeSource.f === "number" && "v" in maybeSource && "reactions" in maybeSource) {
+    return {
+      source: maybeSource,
+      readFn: () => get(maybeSource)
+    };
+  }
+  const src = input[SOURCE_SYMBOL];
+  if (src && typeof src.f === "number" && "reactions" in src) {
+    return { source: src, readFn: () => get(src) };
+  }
+  return null;
+}
+function repeat(input, target, index) {
+  if (typeof input === "number") {
+    target.set(index, input);
+    return () => {};
+  }
+  if (typeof input === "function") {
+    return repeatGetter(input, target, index);
+  }
+  const resolved = resolveSource(input);
+  if (resolved) {
+    return repeatSource(resolved.source, resolved.readFn, target, index);
+  }
+  if (typeof input.value !== "undefined") {
+    return repeatSignalWrapper(input, target, index);
+  }
+  throw new Error("repeat(): unsupported source type");
+}
+function repeatSource(src, readFn, target, index) {
+  const node = {
+    f: REPEATER | CLEAN,
+    wv: 0,
+    fn: null,
+    deps: [src],
+    _readFn: readFn,
+    _target: target,
+    _index: index
+  };
+  if (src.reactions === null) {
+    src.reactions = [node];
+  } else {
+    src.reactions.push(node);
+  }
+  target.set(index, readFn());
+  return () => {
+    node.f |= DESTROYED;
+    if (src.reactions) {
+      const idx = src.reactions.indexOf(node);
+      if (idx !== -1) {
+        const last = src.reactions.length - 1;
+        if (idx !== last)
+          src.reactions[idx] = src.reactions[last];
+        src.reactions.pop();
+        if (src.reactions.length === 0)
+          src.reactions = null;
+      }
+    }
+  };
+}
+function repeatGetter(getter, target, index) {
+  const node = {
+    f: REPEATER | CLEAN,
+    wv: 0,
+    fn: getter,
+    deps: null,
+    _readFn: getter,
+    _target: target,
+    _index: index
+  };
+  const initialValue = updateReaction(node);
+  target.set(index, initialValue);
+  return () => {
+    node.f |= DESTROYED;
+    removeReactions(node, 0);
+    node.deps = null;
+  };
+}
+function repeatSignalWrapper(sig, target, index) {
+  const src = sig[SOURCE_SYMBOL];
+  if (src && typeof src.f === "number" && "reactions" in src) {
+    return repeatSource(src, () => get(src), target, index);
+  }
+  return repeatGetter(() => sig.value, target, index);
+}
+function forwardRepeater(reaction) {
+  const r = reaction;
+  if ((r.f & DESTROYED) !== 0)
+    return false;
+  const val = r._readFn();
+  r._target.set(r._index, val);
+  return true;
+}
+
 // src/reactivity/tracking.ts
 function get(signal) {
   if (activeReaction !== null && !untracking) {
@@ -392,6 +497,11 @@ function markReactions(signal, status) {
       }
       if ((flags & DERIVED) !== 0) {
         stack.push({ signal: reaction, status: MAYBE_DIRTY });
+      } else if ((flags & REPEATER) !== 0) {
+        if (notDirty) {
+          forwardRepeater(reaction);
+          setSignalStatus(reaction, CLEAN);
+        }
       } else if (notDirty) {
         scheduleEffect(reaction);
       }
@@ -588,7 +698,7 @@ function updateReaction(reaction) {
 }
 
 // src/primitives/signal.ts
-var SOURCE_SYMBOL = Symbol("signal.source");
+var SOURCE_SYMBOL2 = Symbol.for("signal.source");
 function source(initialValue, options) {
   return {
     f: 0,
@@ -608,7 +718,7 @@ var signalCleanup = new FinalizationRegistry((src) => {
 function signal(initialValue, options) {
   const src = source(initialValue, options);
   const sig = {
-    [SOURCE_SYMBOL]: src,
+    [SOURCE_SYMBOL2]: src,
     get value() {
       return get(src);
     },
@@ -620,7 +730,7 @@ function signal(initialValue, options) {
   return sig;
 }
 function getSource(sig) {
-  return sig[SOURCE_SYMBOL];
+  return sig[SOURCE_SYMBOL2];
 }
 var proxyFn = null;
 function setProxyFn(fn) {
@@ -2785,6 +2895,181 @@ class ReactiveSharedUint32Array {
     return this.view.length;
   }
 }
+// src/shared/shared-slot-buffer.ts
+function sharedSlotBuffer(options) {
+  let buffer;
+  if (options.buffer) {
+    buffer = options.buffer;
+  } else if (options.type && options.capacity != null) {
+    buffer = new options.type(options.capacity);
+  } else {
+    throw new Error("sharedSlotBuffer: provide either buffer or type+capacity");
+  }
+  const capacity = buffer.length;
+  const defaultValue = options.defaultValue ?? 0;
+  const notifier = options.notifier ?? null;
+  const dirtyFlags = options.dirtyFlags ?? null;
+  const source2 = {
+    f: SOURCE | CLEAN,
+    v: 0,
+    wv: 0,
+    rv: 0,
+    reactions: null,
+    equals: () => false
+  };
+  const indexSources = new Map;
+  function _set(index, value) {
+    if (buffer[index] === value)
+      return;
+    buffer[index] = value;
+    if (dirtyFlags)
+      dirtyFlags[index] = 1;
+    source2.wv = incrementWriteVersion();
+    markReactions(source2, DIRTY);
+    const idx = indexSources.get(index);
+    if (idx) {
+      idx.v = value;
+      idx.wv = source2.wv;
+      markReactions(idx, DIRTY);
+    }
+    notifier?.notify();
+  }
+  return {
+    get capacity() {
+      return capacity;
+    },
+    get raw() {
+      return buffer;
+    },
+    get(index) {
+      get(source2);
+      const idx = indexSources.get(index);
+      if (idx)
+        get(idx);
+      return buffer[index];
+    },
+    peek(index) {
+      return buffer[index];
+    },
+    set: _set,
+    setBatch(updates) {
+      let changed = false;
+      const wv = incrementWriteVersion();
+      for (let i = 0;i < updates.length; i++) {
+        const [index, value] = updates[i];
+        if (buffer[index] !== value) {
+          buffer[index] = value;
+          if (dirtyFlags)
+            dirtyFlags[index] = 1;
+          changed = true;
+          const idx = indexSources.get(index);
+          if (idx) {
+            idx.v = value;
+            idx.wv = wv;
+            markReactions(idx, DIRTY);
+          }
+        }
+      }
+      if (changed) {
+        source2.wv = wv;
+        markReactions(source2, DIRTY);
+        notifier?.notify();
+      }
+    },
+    getIndexSource(index) {
+      let src = indexSources.get(index);
+      if (!src) {
+        src = {
+          f: SOURCE | CLEAN,
+          v: buffer[index],
+          wv: 0,
+          rv: 0,
+          reactions: null,
+          equals: Object.is
+        };
+        indexSources.set(index, src);
+      }
+      return src;
+    },
+    notifyChanged() {
+      source2.wv = incrementWriteVersion();
+      markReactions(source2, DIRTY);
+    },
+    notifyIndicesChanged(indices) {
+      const wv = incrementWriteVersion();
+      for (let i = 0;i < indices.length; i++) {
+        const idx = indexSources.get(indices[i]);
+        if (idx) {
+          idx.v = buffer[indices[i]];
+          idx.wv = wv;
+          markReactions(idx, DIRTY);
+        }
+      }
+      source2.wv = wv;
+      markReactions(source2, DIRTY);
+    },
+    clear(index) {
+      _set(index, defaultValue);
+    },
+    dispose() {
+      source2.reactions = null;
+      indexSources.forEach((src) => {
+        src.reactions = null;
+      });
+      indexSources.clear();
+    }
+  };
+}
+function sharedSlotBufferGroup(config, options) {
+  const notifier = options?.notifier;
+  const dirtyFlags = options?.dirtyFlags;
+  const arrays = {};
+  const buffers = [];
+  for (const key in config) {
+    const cfg = config[key];
+    const buf = sharedSlotBuffer({
+      type: cfg.type,
+      capacity: cfg.capacity,
+      defaultValue: cfg.defaultValue,
+      notifier,
+      dirtyFlags
+    });
+    arrays[key] = buf;
+    buffers.push(buf);
+  }
+  return {
+    arrays,
+    dispose() {
+      for (let i = 0;i < buffers.length; i++) {
+        buffers[i].dispose();
+      }
+    }
+  };
+}
+// src/shared/notifier.ts
+class AtomicsNotifier {
+  wakeFlag;
+  index;
+  pending = false;
+  constructor(wakeFlag, index = 0) {
+    this.wakeFlag = wakeFlag;
+    this.index = index;
+  }
+  notify() {
+    if (!this.pending) {
+      this.pending = true;
+      queueMicrotask(() => {
+        this.pending = false;
+        Atomics.store(this.wakeFlag, this.index, 1);
+        Atomics.notify(this.wakeFlag, this.index);
+      });
+    }
+  }
+}
+
+class NoopNotifier {
+  notify() {}
+}
 
 // src/index.ts
 setProxyFn(proxy);
@@ -2807,6 +3092,8 @@ export {
   slot,
   signals,
   signal,
+  sharedSlotBufferGroup,
+  sharedSlotBuffer,
   shallowEquals,
   setUntracking,
   setSignalStatus,
@@ -2816,6 +3103,7 @@ export {
   scheduleNotify,
   safeNotEqual,
   safeEquals,
+  repeat,
   removeReactions,
   readVersion,
   reactiveProps,
@@ -2879,9 +3167,11 @@ export {
   ReactiveMap,
   ReactiveDate,
   ROOT_EFFECT,
+  REPEATER,
   RENDER_EFFECT,
   REACTIVE_MARKER,
   REACTION_IS_UPDATING,
+  NoopNotifier,
   MAYBE_DIRTY,
   LINKED_SYMBOL,
   INERT,
@@ -2895,5 +3185,6 @@ export {
   CLEAN,
   BRANCH_EFFECT,
   BLOCK_EFFECT,
-  BINDING_SYMBOL
+  BINDING_SYMBOL,
+  AtomicsNotifier
 };

package/dist/primitives/repeater.d.ts

@@ -0,0 +1,40 @@
+import type { Reaction, ReadableSignal, WritableSignal, DerivedSignal } from '../core/types.js';
+import type { SharedSlotBuffer } from '../shared/shared-slot-buffer.js';
+/**
+ * A repeater node implements the Reaction interface but with the REPEATER flag.
+ * It has ONE permanent dependency (the source) and never re-wires deps.
+ *
+ * When markReactions encounters a REPEATER during traversal, it calls
+ * the repeater's readFn to get the current value and writes it to the target.
+ */
+export interface RepeaterNode extends Reaction {
+    /** Read function - reads current value from the bound source */
+    _readFn: () => number;
+    /** Target buffer to write to */
+    _target: SharedSlotBuffer;
+    /** Index in target buffer */
+    _index: number;
+}
+type RepeaterSource = WritableSignal<number> | ReadableSignal<number> | DerivedSignal<number> | (() => number) | number;
+/**
+ * Create a repeater: forwards a reactive source to a SharedSlotBuffer position.
+ *
+ * For static values: just calls target.set(index, value) — no repeater created.
+ * For reactive sources: creates a RepeaterNode, registers with source.reactions.
+ * Returns a dispose function.
+ *
+ * @param input - The value source: a signal, derived, getter, or static number
+ * @param target - The SharedSlotBuffer to write to
+ * @param index - Which position in the buffer
+ * @returns Dispose function (removes repeater from source.reactions)
+ */
+export declare function repeat(input: RepeaterSource, target: SharedSlotBuffer, index: number): () => void;
+/**
+ * Execute a repeater's forward operation.
+ * Called inline during markReactions when a REPEATER node is encountered.
+ *
+ * @returns true if the value was written to the target
+ */
+export declare function forwardRepeater(reaction: Reaction): boolean;
+export {};
+//# sourceMappingURL=repeater.d.ts.map

package/dist/primitives/repeater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeater.d.ts","sourceRoot":"","sources":["../../src/primitives/repeater.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAU,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGvG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AASvE;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,gEAAgE;IAChE,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,gCAAgC;IAChC,OAAO,EAAE,gBAAgB,CAAA;IACzB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAMD,KAAK,cAAc,GACf,cAAc,CAAC,MAAM,CAAC,GACtB,cAAc,CAAC,MAAM,CAAC,GACtB,aAAa,CAAC,MAAM,CAAC,GACrB,CAAC,MAAM,MAAM,CAAC,GACd,MAAM,CAAA;AAqDV;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,IAAI,CAwBZ;AAuGD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAO3D"}

package/dist/reactivity/tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/reactivity/tracking.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAkCjE;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAiD3C;AAoGD;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CA8BrD;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA8BlE;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3E;AAMD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAoGnD;AAWD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAE3E;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsBrD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvE;AA8BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAmG1D"}
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/reactivity/tracking.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAoCjE;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAiD3C;AAoGD;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CA8BrD;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoClE;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3E;AAMD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAoGnD;AAWD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAE3E;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsBrD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvE;AA8BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAmG1D"}

package/dist/shared/notifier.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A notification mechanism for cross-side communication.
+ *
+ * When a SharedSlotBuffer is written to, the notifier is called to inform
+ * the other side (e.g., Rust) that changes are pending.
+ *
+ * Implementations can batch notifications (e.g., via microtask) to avoid
+ * redundant wake-ups during a synchronous update burst.
+ */
+export interface Notifier {
+    /** Notify the other side that changes are pending. */
+    notify(): void;
+}
+/**
+ * Notifier that uses Atomics.store + Atomics.notify to wake a thread
+ * waiting on a shared memory location.
+ *
+ * Notifications are batched via microtask: multiple synchronous writes
+ * result in a single Atomics.notify call.
+ */
+export declare class AtomicsNotifier implements Notifier {
+    private readonly wakeFlag;
+    private readonly index;
+    private pending;
+    constructor(wakeFlag: Int32Array, index?: number);
+    notify(): void;
+}
+/**
+ * A no-op notifier for testing or local-only usage.
+ */
+export declare class NoopNotifier implements Notifier {
+    notify(): void;
+}
+//# sourceMappingURL=notifier.d.ts.map

package/dist/shared/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/shared/notifier.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,MAAM,IAAI,IAAI,CAAA;CACf;AAMD;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,OAAO,CAAQ;gBAEX,QAAQ,EAAE,UAAU,EAAE,KAAK,SAAI;IAK3C,MAAM,IAAI,IAAI;CAUf;AAMD;;GAEG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,MAAM,IAAI,IAAI;CAGf"}

package/dist/shared/shared-slot-buffer.d.ts

@@ -0,0 +1,67 @@
+import type { Source } from '../core/types.js';
+import type { Notifier } from './notifier.js';
+export type TypedArray = Float32Array | Float64Array | Int8Array | Int16Array | Int32Array | Uint8Array | Uint16Array | Uint32Array | Uint8ClampedArray;
+export type TypedArrayConstructor = Float32ArrayConstructor | Float64ArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor | Uint8ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | Uint8ClampedArrayConstructor;
+export interface SharedSlotBuffer {
+    /** Maximum number of elements */
+    readonly capacity: number;
+    /** Direct access to underlying typed array (for FFI pointer passing) */
+    readonly raw: TypedArray;
+    /** Reactive read - tracks dependency */
+    get(index: number): number;
+    /** Non-reactive read */
+    peek(index: number): number;
+    /** Write + markReactions + dirty flag + notify */
+    set(index: number, value: number): void;
+    /** Batch write - single notification at end */
+    setBatch(updates: [number, number][]): void;
+    /** Get fine-grained per-index source for tracking */
+    getIndexSource(index: number): Source<number>;
+    /** Notify TS reactive graph that other side changed data */
+    notifyChanged(): void;
+    /** Notify specific indices changed from other side */
+    notifyIndicesChanged(indices: number[]): void;
+    /** Reset index to default value */
+    clear(index: number): void;
+    /** Clean up */
+    dispose(): void;
+}
+export interface SharedSlotBufferOptions {
+    /** External TypedArray view (fixed capacity, e.g., over SharedArrayBuffer) */
+    buffer?: TypedArray;
+    /** OR: allocate internally with this constructor */
+    type?: TypedArrayConstructor;
+    /** Capacity (required if type is provided, ignored if buffer is provided) */
+    capacity?: number;
+    /** Default value for clear() */
+    defaultValue?: number;
+    /** Cross-side notifier */
+    notifier?: Notifier;
+    /** Per-index dirty flags (external, e.g., from SharedArrayBuffer) */
+    dirtyFlags?: Uint8Array;
+}
+/**
+ * Create a reactive typed array backed by shared memory.
+ *
+ * The buffer is "just" a reactive read/write array - no source binding.
+ * Use `repeat()` from the repeater module to wire signals to buffer positions.
+ */
+export declare function sharedSlotBuffer(options: SharedSlotBufferOptions): SharedSlotBuffer;
+export type SharedSlotBufferGroupConfig = Record<string, {
+    type: TypedArrayConstructor;
+    capacity: number;
+    defaultValue?: number;
+}>;
+/**
+ * Create multiple SharedSlotBuffers sharing a single notifier and dirty flags.
+ */
+export declare function sharedSlotBufferGroup<T extends SharedSlotBufferGroupConfig>(config: T, options?: {
+    notifier?: Notifier;
+    dirtyFlags?: Uint8Array;
+}): {
+    arrays: {
+        [K in keyof T]: SharedSlotBuffer;
+    };
+    dispose(): void;
+};
+//# sourceMappingURL=shared-slot-buffer.d.ts.map

package/dist/shared/shared-slot-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-slot-buffer.d.ts","sourceRoot":"","sources":["../../src/shared/shared-slot-buffer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAM7C,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,GACV,WAAW,GACX,WAAW,GACX,iBAAiB,CAAA;AAErB,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,uBAAuB,GACvB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,4BAA4B,CAAA;AAMhC,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,wCAAwC;IACxC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,wBAAwB;IACxB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,kDAAkD;IAClD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CAAA;IAC3C,qDAAqD;IACrD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC7C,4DAA4D;IAC5D,aAAa,IAAI,IAAI,CAAA;IACrB,sDAAsD;IACtD,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC7C,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,eAAe;IACf,OAAO,IAAI,IAAI,CAAA;CAChB;AAMD,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,oDAAoD;IACpD,IAAI,CAAC,EAAE,qBAAqB,CAAA;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAuJnF;AAMD,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,qBAAqB,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAC,CAAA;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,2BAA2B,EACzE,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB;KAAE,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CA2BnE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rlabs-inc/signals",
-  "version": "1.12.0",
+  "version": "1.13.1",
   "description": "Production-grade fine-grained reactivity for TypeScript. A complete standalone mirror of Svelte 5's reactivity system - signals, effects, derived values, deep reactivity, reactive collections, reactive bindings, and reactive slots.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",