@barefootjs/client 0.10.1 → 0.11.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { createSignal, createEffect, createDisposableEffect, createMemo, createRoot, onCleanup, onMount, untrack, batch, type Reactive, type Signal, type Memo, type CleanupFn, type EffectFn, } from '@barefootjs/client/reactive';
+export { createSignal, createEffect, createDisposableEffect, createMemo, createRoot, onCleanup, onMount, untrack, batch, setProfilerSink, beginTurn, endTurn, __bfReportOutput, type Reactive, type Signal, type Memo, type CleanupFn, type EffectFn, type ProfilerEventSink, type SubscriberKind, } from '@barefootjs/client/reactive';
+export { createRecordingSink, type ProfilerEvent, type ProfilerEventType, type RecordingSink, } from './profiler-events.ts';
 export { splitProps } from './split-props.ts';
 export { __slot, type SlotMarker } from './slot.ts';
 export { forwardProps } from './forward-props.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -8,9 +8,55 @@ import {
   onCleanup,
   onMount,
   untrack,
-  batch
+  batch,
+  setProfilerSink,
+  beginTurn,
+  endTurn,
+  __bfReportOutput
 } from "@barefootjs/client/reactive";
 
+// src/profiler-events.ts
+function createRecordingSink() {
+  const events = [];
+  const turnStack = [];
+  let seq = 0;
+  let turnCounter = 0;
+  const top = () => turnStack.length > 0 ? turnStack[turnStack.length - 1] : null;
+  const push = (e) => {
+    const t = top();
+    events.push({ seq: seq++, turn: t?.handlerId ?? null, turnSeq: t?.turnSeq ?? null, ...e });
+  };
+  const sink = {
+    signalSet: (id, batched) => push({ type: "signalSet", signal: id, batched }),
+    subscribeAdd: (signal, subscriber) => push({ type: "subscribeAdd", signal, subscriber }),
+    subscribeRemove: (signal, subscriber) => push({ type: "subscribeRemove", signal, subscriber }),
+    effectCreate: (id, kind) => push({ type: "effectCreate", subscriber: id, kind }),
+    effectEnter: (id) => push({ type: "effectEnter", subscriber: id }),
+    effectExit: (id, dur) => push({ type: "effectExit", subscriber: id, dur }),
+    effectOutput: (id, changed) => push({ type: "effectOutput", subscriber: id, changed }),
+    effectDispose: (id) => push({ type: "effectDispose", subscriber: id }),
+    batchBegin: (depth) => push({ type: "batchBegin", depth }),
+    batchFlush: (flushed) => push({ type: "batchFlush", flushed }),
+    turnBegin: (handlerId, loc) => {
+      push({ type: "turnBegin", handlerId, loc });
+      turnStack.push({ handlerId, turnSeq: ++turnCounter });
+    },
+    turnEnd: () => {
+      turnStack.pop();
+      push({ type: "turnEnd" });
+    }
+  };
+  return {
+    sink,
+    events,
+    reset() {
+      events.length = 0;
+      turnStack.length = 0;
+      seq = 0;
+      turnCounter = 0;
+    }
+  };
+}
 // src/split-props.ts
 function splitProps(props, keys) {
   const keySet = new Set(keys);
@@ -135,20 +181,25 @@ export {
   unwrap,
   untrack,
   splitProps,
+  setProfilerSink,
   provideContext,
   onMount,
   onCleanup,
   isSSRPortal,
   forwardProps,
   findSiblingSlot,
+  endTurn,
   createSignal,
   createRoot,
+  createRecordingSink,
   createPortal,
   createMemo,
   createEffect,
   createDisposableEffect,
   createContext,
   cleanupPortalPlaceholder,
+  beginTurn,
   batch,
-  __slot
+  __slot,
+  __bfReportOutput
 };

package/dist/profiler-events.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Profiler event collection (#1690, SR2).
+ *
+ * The reactive runtime (`reactive.ts`) reports raw instrumentation through a
+ * `ProfilerEventSink` (SR1). This module turns that callback stream into a
+ * flat, ordered, **turn-stamped** event log — the normalized SR2 contract the
+ * analyses (hot subscribers / wasted re-runs / batch advisor) and the SR4 IR
+ * join consume.
+ *
+ * The collector is the one place that knows the *current turn*: it tracks the
+ * `beginTurn`/`endTurn` stack (SR3) and stamps every event with the handler id
+ * in scope when it fired, so per-turn metrics (batch savings, runs/turn) need
+ * no microtask guesswork.
+ *
+ * Dev-only (SR8): nothing here runs unless `setProfilerSink` is handed a
+ * recording sink, which only the instrumented/profile build does.
+ */
+import type { ProfilerEventSink } from "./reactive.ts";
+import type { ProfilerEvent } from '@barefootjs/shared';
+export type { ProfilerEvent, ProfilerEventType } from '@barefootjs/shared';
+export interface RecordingSink {
+    /** The sink to hand to `setProfilerSink(...)`. */
+    sink: ProfilerEventSink;
+    /** The collected event log, in emission order. */
+    events: ProfilerEvent[];
+    /** Clear the log and the internal turn stack (start a fresh scenario). */
+    reset(): void;
+}
+/**
+ * Build a recording sink (SR2). Hand `.sink` to `setProfilerSink`, drive a
+ * scenario, then read `.events` — a turn-stamped, ordered log ready for the
+ * SR4 join and the analyses. Turns may nest (a handler that dispatches another
+ * handler); the stack's top is the attributed turn.
+ */
+export declare function createRecordingSink(): RecordingSink;
+//# sourceMappingURL=profiler-events.d.ts.map

package/dist/profiler-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-events.d.ts","sourceRoot":"","sources":["../src/profiler-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE1E,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,EAAE,iBAAiB,CAAA;IACvB,kDAAkD;IAClD,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,0EAA0E;IAC1E,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAgDnD"}

package/dist/reactive.d.ts

@@ -21,6 +21,86 @@ export type Signal<T> = [
 export type CleanupFn = () => void;
 export type EffectFn = () => void | CleanupFn;
 export type Memo<T> = Reactive<() => T>;
+export type SubscriberKind = 'effect' | 'memo' | 'root';
+/**
+ * Reactive measurement hooks. Every method is a measurement-only notification —
+ * implementations MUST NOT mutate reactive state or throw (a throw would change
+ * `set()`'s synchronous semantics). Ids are stable handles; `''` means the
+ * node was created while profiling was off. The compiler will later emit
+ * IR-aligned ids (SR3); until then ids are runtime-assigned counters.
+ */
+export interface ProfilerEventSink {
+    /** A signal's value changed (post `Object.is` bail). `batched` = inside `batch()`. */
+    signalSet(signalId: string, batched: boolean): void;
+    /** A subscriber began reading a signal (dependency edge added). */
+    subscribeAdd(signalId: string, subscriberId: string): void;
+    /** A subscriber stopped reading a signal (edge removed on re-run / dispose). */
+    subscribeRemove(signalId: string, subscriberId: string): void;
+    /** An effect / memo / root scope was created. */
+    effectCreate(subscriberId: string, kind: SubscriberKind): void;
+    /** An effect/memo body is about to run. */
+    effectEnter(subscriberId: string): void;
+    /** An effect/memo body finished. `durationMs` is wall time. */
+    effectExit(subscriberId: string, durationMs: number): void;
+    /**
+     * An effect/memo run produced an output fingerprint (#1690, §4.2.2).
+     * `changed` is `true` when the run produced new output (a memo value that
+     * differs by `Object.is`, or a DOM write that changed the node) and `false`
+     * when it recomputed but produced output identical to its previous run — a
+     * *wasted* re-run. Emitted at most once per run, only for runs whose output
+     * is fingerprintable (memo recompute / instrumented DOM write); a run that
+     * reports no output emits no event and isn't counted as wasted.
+     *
+     * Optional: it was added after the initial sink contract, so a pre-existing
+     * custom sink that omits it stays valid (the call site guards with `?.`). A
+     * sink without it simply opts out of the wasted-re-runs analysis.
+     */
+    effectOutput?(subscriberId: string, changed: boolean): void;
+    /** An effect / memo / root scope was disposed. */
+    effectDispose(subscriberId: string): void;
+    /** A `batch()` block opened at the given (post-increment) depth. */
+    batchBegin(depth: number): void;
+    /** A batch flush ran `flushed` effects. */
+    batchFlush(flushed: number): void;
+    /**
+     * A user interaction (one event handler invocation) began. Compiler-emitted
+     * `beginTurn(...)` wraps the handler body so subsequent events in this turn
+     * are attributed to `handlerId`. `loc` is the optional source location.
+     */
+    turnBegin(handlerId: string, loc?: string): void;
+    /** The current turn ended (handler returned). */
+    turnEnd(): void;
+}
+/**
+ * Install (or clear) the dev-only reactive measurement sink. Pass `null` to
+ * disable. Calling this before a scenario runs lets `bf debug profile` collect
+ * the event stream; production code never calls it, so the sink stays null and
+ * the choke points stay free (dev-only instrumentation, #1690).
+ */
+export declare function setProfilerSink(sink: ProfilerEventSink | null): void;
+/**
+ * Mark the start of a user-interaction turn (#1690, SR3). Compiler-emitted in
+ * profile mode at every event-handler boundary as
+ * `beginTurn(handlerId, loc); try { … } finally { endTurn() }`. Measurement
+ * only — it does not change `set()`'s synchronous semantics; it just stamps a
+ * turn onto the events emitted between begin and end. No-op when profiling is
+ * off.
+ */
+export declare function beginTurn(handlerId: string, loc?: string): void;
+/** Mark the end of the current interaction turn (#1690, SR3). */
+export declare function endTurn(): void;
+/**
+ * Report the current run's output fingerprint (#1690, §4.2.2). Called from the
+ * places that produce an effect's observable output — a memo recompute (the
+ * written value's `Object.is` identity) and instrumented DOM writes (whether the
+ * node actually changed). Accumulated onto the running effect (`Owner`) and
+ * flushed as one `effectOutput` event at run exit, so several writes in one run
+ * collapse to a single "did this run change anything" verdict.
+ *
+ * No-op when profiling is off or called outside a run — the wasted-re-runs
+ * analysis is the only consumer and it lives behind the dev-only sink (SR8).
+ */
+export declare function __bfReportOutput(changed: boolean): void;
 /**
  * Create a reactive value
  *
@@ -33,7 +113,7 @@ export type Memo<T> = Reactive<() => T>;
  * setCount(5)          // Update to 5
  * setCount(n => n + 1) // Update with function (becomes 6)
  */
-export declare function createSignal<T>(initialValue: T): Signal<T>;
+export declare function createSignal<T>(initialValue: T, __bfId?: string): Signal<T>;
 /**
  * Side effect that runs automatically when signals change
  *
@@ -46,7 +126,7 @@ export declare function createSignal<T>(initialValue: T): Signal<T>;
  * })
  * setCount(1)  // Logs "count changed: 1"
  */
-export declare function createEffect(fn: EffectFn): void;
+export declare function createEffect(fn: EffectFn, __bfId?: string, __bfKind?: SubscriberKind): void;
 /**
  * Create an isolated reactive scope with explicit disposal.
  * All effects/memos created inside run within this root and are
@@ -64,7 +144,7 @@ export declare function createRoot<T>(fn: (dispose: () => void) => T): T;
  *
  * @returns A dispose function that stops the effect and removes it from all signal dependencies.
  */
-export declare function createDisposableEffect(fn: EffectFn): () => void;
+export declare function createDisposableEffect(fn: EffectFn, __bfId?: string): () => void;
 /**
  * Register cleanup function for effects
  *
@@ -146,5 +226,5 @@ export declare function onMount(fn: () => void): void;
  * setCount(5)
  * doubled()    // 10
  */
-export declare function createMemo<T>(fn: () => T): Memo<T>;
+export declare function createMemo<T>(fn: () => T, __bfId?: string): Memo<T>;
 //# sourceMappingURL=reactive.d.ts.map

package/dist/reactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAAE,CAAA;AAE3D,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACtB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjB,uDAAuD;IACvD,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI;CAC1C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAA;AAClC,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,GAAG,SAAS,CAAA;AAC7C,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;AAmBvC;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAoC1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAmB/C;AAsFD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAwB/D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAuB/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAS7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQzC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAUvC;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CASlD"}
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"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"}

package/dist/reactive.js

@@ -1,16 +1,41 @@
 // src/reactive.ts
+var profilerSink = null;
+var signalSeq = 0;
+var subscriberSeq = 0;
+function setProfilerSink(sink) {
+  profilerSink = sink;
+}
+function beginTurn(handlerId, loc) {
+  if (profilerSink)
+    profilerSink.turnBegin(handlerId, loc);
+}
+function endTurn() {
+  if (profilerSink)
+    profilerSink.turnEnd();
+}
+function __bfReportOutput(changed) {
+  if (!profilerSink || !Owner)
+    return;
+  Owner.outputReported = true;
+  if (changed)
+    Owner.outputChanged = true;
+}
 var Owner = null;
 var Listener = null;
 var MAX_EFFECT_RUNS = 100;
 var BatchDepth = 0;
 var PendingEffects = new Set;
-function createSignal(initialValue) {
+function createSignal(initialValue, __bfId) {
   let value = initialValue;
   const subscribers = new Set;
+  const id = __bfId ?? (profilerSink ? `s${++signalSeq}` : "");
+  subscribers.__bfSignalId = id;
   const get = () => {
     if (Listener) {
       subscribers.add(Listener);
       Listener.dependencies.add(subscribers);
+      if (profilerSink)
+        profilerSink.subscribeAdd(id, Listener.id);
     }
     return value;
   };
@@ -20,6 +45,8 @@ function createSignal(initialValue) {
       return;
     }
     value = newValue;
+    if (profilerSink)
+      profilerSink.signalSet(id, BatchDepth > 0);
     if (BatchDepth > 0) {
       for (const effect of subscribers) {
         PendingEffects.add(effect);
@@ -33,7 +60,7 @@ function createSignal(initialValue) {
   };
   return [get, set];
 }
-function createEffect(fn) {
+function createEffect(fn, __bfId, __bfKind = "effect") {
   const effect = {
     fn,
     cleanup: null,
@@ -41,8 +68,14 @@ function createEffect(fn) {
     owner: Owner,
     children: [],
     disposed: false,
-    runCount: 0
+    runCount: 0,
+    id: __bfId ?? (profilerSink ? `e${++subscriberSeq}` : ""),
+    kind: __bfKind,
+    outputReported: false,
+    outputChanged: false
   };
+  if (profilerSink)
+    profilerSink.effectCreate(effect.id, effect.kind);
   if (Owner)
     Owner.children.push(effect);
   runEffect(effect);
@@ -55,18 +88,25 @@ function runEffect(effect) {
     effect.runCount = 0;
     throw new Error(`Circular dependency detected: effect re-entered itself ${MAX_EFFECT_RUNS} times.`);
   }
+  if (profilerSink)
+    profilerSink.effectEnter(effect.id);
   if (effect.cleanup) {
     effect.cleanup();
     effect.cleanup = null;
   }
   for (const dep of effect.dependencies) {
     dep.delete(effect);
+    if (profilerSink)
+      profilerSink.subscribeRemove(dep.__bfSignalId ?? "", effect.id);
   }
   effect.dependencies.clear();
   const prevOwner = Owner;
   const prevListener = Listener;
   Owner = effect;
   Listener = effect;
+  effect.outputReported = false;
+  effect.outputChanged = false;
+  const start = profilerSink ? performance.now() : 0;
   try {
     const result = effect.fn();
     if (typeof result === "function") {
@@ -76,6 +116,11 @@ function runEffect(effect) {
     Owner = prevOwner;
     Listener = prevListener;
     effect.runCount--;
+    if (profilerSink) {
+      profilerSink.effectExit(effect.id, performance.now() - start);
+      if (effect.outputReported)
+        profilerSink.effectOutput?.(effect.id, effect.outputChanged);
+    }
   }
 }
 function disposeSubtree(effect) {
@@ -92,8 +137,12 @@ function disposeSubtree(effect) {
   }
   for (const dep of effect.dependencies) {
     dep.delete(effect);
+    if (profilerSink)
+      profilerSink.subscribeRemove(dep.__bfSignalId ?? "", effect.id);
   }
   effect.dependencies.clear();
+  if (profilerSink)
+    profilerSink.effectDispose(effect.id);
   effect.owner = null;
 }
 function disposeEffect(effect) {
@@ -114,8 +163,14 @@ function createRoot(fn) {
     owner: Owner,
     children: [],
     disposed: false,
-    runCount: 0
+    runCount: 0,
+    id: profilerSink ? `r${++subscriberSeq}` : "",
+    kind: "root",
+    outputReported: false,
+    outputChanged: false
   };
+  if (profilerSink)
+    profilerSink.effectCreate(root.id, "root");
   if (Owner)
     Owner.children.push(root);
   const prevOwner = Owner;
@@ -129,7 +184,7 @@ function createRoot(fn) {
     Listener = prevListener;
   }
 }
-function createDisposableEffect(fn) {
+function createDisposableEffect(fn, __bfId) {
   let disposed = false;
   const effect = {
     fn: () => {
@@ -142,8 +197,14 @@ function createDisposableEffect(fn) {
     owner: Owner,
     children: [],
     disposed: false,
-    runCount: 0
+    runCount: 0,
+    id: __bfId ?? (profilerSink ? `e${++subscriberSeq}` : ""),
+    kind: "effect",
+    outputReported: false,
+    outputChanged: false
   };
+  if (profilerSink)
+    profilerSink.effectCreate(effect.id, effect.kind);
   if (Owner)
     Owner.children.push(effect);
   runEffect(effect);
@@ -173,6 +234,8 @@ function untrack(fn) {
 }
 function batch(fn) {
   BatchDepth++;
+  if (profilerSink)
+    profilerSink.batchBegin(BatchDepth);
   try {
     return fn();
   } finally {
@@ -186,6 +249,8 @@ function flushEffects() {
   while (PendingEffects.size > 0) {
     const effects = [...PendingEffects];
     PendingEffects.clear();
+    if (profilerSink)
+      profilerSink.batchFlush(effects.length);
     for (const effect of effects) {
       runEffect(effect);
     }
@@ -194,22 +259,34 @@ function flushEffects() {
 function onMount(fn) {
   createEffect(() => untrack(fn));
 }
-function createMemo(fn) {
-  const [value, setValue] = createSignal(undefined);
+function createMemo(fn, __bfId) {
+  const id = __bfId ?? (profilerSink ? `m${++subscriberSeq}` : "");
+  const [value, setValue] = createSignal(undefined, id);
+  let prev;
+  let hasPrev = false;
   createEffect(() => {
     const result = fn();
+    if (profilerSink) {
+      __bfReportOutput(!hasPrev || !Object.is(prev, result));
+      prev = result;
+      hasPrev = true;
+    }
     setValue(() => result);
-  });
+  }, id, "memo");
   return value;
 }
 export {
   untrack,
+  setProfilerSink,
   onMount,
   onCleanup,
+  endTurn,
   createSignal,
   createRoot,
   createMemo,
   createEffect,
   createDisposableEffect,
-  batch
+  beginTurn,
+  batch,
+  __bfReportOutput
 };

package/dist/runtime/dynamic-text.d.ts

@@ -10,6 +10,11 @@
  * returned by `createComponent`. Stringifying it produced
  * `"[object HTMLElement]"` (and clobbered the server-rendered subtree).
  *
+ * Profiler note (#1690, §4.2.2): each write reports an output fingerprint via
+ * `__bfReportOutput` — `false` when the slot already held the same text/node, so
+ * the wasted-re-runs analysis can flag a text binding that re-ran without
+ * changing the DOM. Dev-only: `__bfReportOutput` is a no-op when profiling is off.
+ *
  * `__bfText` mirrors `__bfSlot` (the branch-template equivalent): when the
  * value is a `Node`, it replaces the slot region with that node by identity;
  * otherwise it behaves exactly like the previous text assignment. It returns

package/dist/runtime/dynamic-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-text.d.ts","sourceRoot":"","sources":["../../src/runtime/dynamic-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CA0C1E"}
+{"version":3,"file":"dynamic-text.d.ts","sourceRoot":"","sources":["../../src/runtime/dynamic-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAsCH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAoD1E"}

package/dist/runtime/index.d.ts

@@ -1,4 +1,5 @@
-export { createSignal, createEffect, createDisposableEffect, createMemo, createRoot, onCleanup, onMount, untrack, batch, type Reactive, type Signal, type Memo, type CleanupFn, type EffectFn, } from '@barefootjs/client/reactive';
+export { createSignal, createEffect, createDisposableEffect, createMemo, createRoot, onCleanup, onMount, untrack, batch, setProfilerSink, beginTurn, endTurn, __bfReportOutput, type Reactive, type Signal, type Memo, type CleanupFn, type EffectFn, type ProfilerEventSink, type SubscriberKind, } from '@barefootjs/client/reactive';
+export { createRecordingSink, type ProfilerEvent, type ProfilerEventType, type RecordingSink, } from '../profiler-events.ts';
 export { splitProps } from '../split-props.ts';
 export { __slot, type SlotMarker } from '../slot.ts';
 export { forwardProps } from '../forward-props.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAIrC,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,eAAe,EACf,KAAK,OAAO,GACb,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAG3D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAG3F,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG1D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAIrC,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,eAAe,EACf,KAAK,OAAO,GACb,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAG3D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAG3F,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG1D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}