@flyingrobots/bijou-tui 4.4.1 → 7.0.0

package/README.md

@@ -7,7 +7,7 @@ The high-fidelity TEA runtime for Bijou.
 ## Role
 
 - **The Elm Architecture (TEA)**: A deterministic state-update-view loop for industrial-strength terminal software.
-- **Fractal TEA**: Compose nested sub-apps with `initSubApp()`, `updateSubApp()`, and `mount()`.
+- **Fractal TEA**: Compose nested sub-apps with `createSubAppAdapter()`, `initSubApp()`, `updateSubApp()`, and `mount()`.
 - **Declarative Motion**: Interpolate layout changes smoothly with physics-based springs and tween animations.
 - **Surface-First Pipeline**: Programmable rendering middleware for fragments, diffing, and shader-based transitions.
 
@@ -20,18 +20,18 @@ npm install @flyingrobots/bijou @flyingrobots/bijou-node @flyingrobots/bijou-tui
 ## Quick Start (Sub-App Composition)
 
 ```typescript
-import { initDefaultContext } from '@flyingrobots/bijou-node';
-import { run, mount, type App } from '@flyingrobots/bijou-tui';
+import { startApp } from '@flyingrobots/bijou-node';
+import { createSubAppAdapter, mount, type App } from '@flyingrobots/bijou-tui';
 import { createSurface } from '@flyingrobots/bijou';
 
-initDefaultContext();
-
-type ChildModel = { count: number };
-type ChildMsg = { type: 'noop' };
-type Model = { left: ChildModel; right: ChildModel };
-type Msg = { pane: 'left' | 'right'; msg: ChildMsg };
+type ChildMsg = { type: 'tick' };
+type ParentModel = {
+  left: { count: number };
+  right: { count: number };
+};
+type ParentMsg = { type: 'left'; msg: ChildMsg } | { type: 'right'; msg: ChildMsg };
 
-const childApp: App<ChildModel, ChildMsg> = {
+const childApp: App<{ count: number }, ChildMsg> = {
   init: () => [{ count: 0 }, []],
   update: (msg, model) => [model, []],
   view: (model) => {
@@ -41,18 +41,20 @@ const childApp: App<ChildModel, ChildMsg> = {
   }
 };
 
-const app: App<Model, Msg> = {
+const mapLeft = createSubAppAdapter<ParentMsg, ChildMsg>({
+  tick: (msg) => ({ type: 'left', msg }),
+});
+
+const mapRight = createSubAppAdapter<ParentMsg, ChildMsg>({
+  tick: (msg) => ({ type: 'right', msg }),
+});
+
+const app: App<ParentModel, ParentMsg> = {
   init: () => [{ left: { count: 0 }, right: { count: 0 } }, []],
   update: (msg, model) => [model, []],
   view: (model) => {
-    const [left] = mount(childApp, {
-      model: model.left,
-      onMsg: (msg) => ({ pane: 'left', msg }),
-    });
-    const [right] = mount(childApp, {
-      model: model.right,
-      onMsg: (msg) => ({ pane: 'right', msg }),
-    });
+    const [left] = mount(childApp, { model: model.left, onMsg: mapLeft });
+    const [right] = mount(childApp, { model: model.right, onMsg: mapRight });
     
     const screen = createSurface(80, 24);
     screen.blit(left, 0, 0);
@@ -61,9 +63,21 @@ const app: App<Model, Msg> = {
   }
 };
 
-run(app);
+await startApp(app);
 ```
 
+For Node hosts, prefer `startApp()` for the first-app path. Reach for
+`run(app, { ctx })` when the host owns context creation explicitly.
+
+When you need to mix small string fragments with surface-returning primitives,
+keep composition on the surface side: use `contentSurface()` directly or pass
+strings into `vstackSurface()` / `hstackSurface()`. Raw strings are still not a
+valid `view()` return type.
+
+Use `proseSurface(text, { width })` when paragraph-like text should wrap at
+word boundaries before becoming a surface. Keep `contentSurface()` for
+preformatted output, tables, boxes, and caller-managed line breaks.
+
 ## Strategy: Choosing Component Families
 
 Select the family based on the interaction semantic.
@@ -73,6 +87,15 @@ Select the family based on the interaction semantic.
 - **`modal()`**: Required decision that blocks background activity.
 - **`toast()`**: Transient notification for a single event.
 - **`tooltip()`**: Micro-explanation for a local target.
+- **`debugOverlay()`**: Development-only perf HUD composited onto any app surface.
+- **`layoutInspectorOverlay()`**: Development-only geometry HUD for region
+  bounds, focus, and layers.
+- **`inputRoutingInspectorText()`**: Development-only route trace for recent
+  key and pointer events.
+- **`focusMapText()`**: Development-only focus ownership and tab-order report.
+- **`evaluateSurfaceBudget()`**: Deterministic warnings for surface and timing
+  thresholds.
+- **`surfaceDiffSurface()`**: Side-by-side or overlay inspection for two rendered surfaces.
 
 ### Collection Interaction
 - **`navigableTable()`**: Keyboard-driven traversal and cell inspection.
@@ -80,11 +103,43 @@ Select the family based on the interaction semantic.
 - **`commandPalette()`**: Action discovery and navigation.
 
 ### Shell and Workspace Layout
-- **`createFramedApp()`**: Batteries-included workspace with tabs, panes, and help.
+- **`createFramedApp()`**: Batteries-included workspace with tabs, panes,
+  help, and a shell-owned perf HUD toggled with the backtick key.
 - **`splitPane()`**: Dynamic primary/secondary context comparison.
 - **`grid()`**: Stable regions with simultaneous visibility.
 - **`viewport()`**: The canonical scroll mask for rich composition.
 
+For framed shells, Node hosts can still prefer `startApp(app)`: the hosted
+Node bootstrap delegates to self-running framed apps automatically. Use the
+explicit runner path when you want to stay inside `@flyingrobots/bijou-tui`
+or when the host owns `ctx` directly:
+
+```typescript
+import { createFramedApp, runFramedApp } from '@flyingrobots/bijou-tui';
+
+const app = createFramedApp({ pages: [page] });
+
+await app.run({ ctx });
+// or: await runFramedApp({ pages: [page] }, { ctx });
+```
+
+This path keeps the shell batteries included: mouse input defaults to `true`,
+the shared runtime loop still does the heavy lifting, and frame timing/budget
+telemetry stays attached to the frame model for shell-owned UI. For Node-hosted
+apps, `startApp(app)` remains the default bootstrap.
+
+## Runtime Diagnostics
+
+The EventBus exposes command queue facts through `getCommandDiagnostics()`.
+`run(app, { commandBackpressureThreshold })` routes a warning when pending
+commands cross the threshold, without hard-capping legitimate bursts. The
+default threshold is 1000; use `0` to disable the warning.
+
+Render pipeline middleware is synchronous by contract. If middleware returns a
+Promise, Bijou reports a pipeline diagnostic, keeps the current frame moving,
+and ignores any late `next()` continuation so stage ordering stays
+deterministic.
+
 ## Animation
 
 ### Spring Physics
@@ -99,6 +154,11 @@ const cmd = animate({
 });
 ```
 
+Spring commands integrate physics with bounded fixed timesteps by default, so a
+slow terminal frame cannot feed a large raw pulse delta into the spring. Tune
+`fixedStepSeconds` and `maxPulseSeconds` only when an app needs a custom
+simulation cadence.
+
 ### Timeline Orchestration
 ```typescript
 import { timeline } from '@flyingrobots/bijou-tui';
@@ -110,10 +170,173 @@ const tl = timeline()
   .build();
 ```
 
+## Post-Process Shaders
+
+`canvas()` can render procedural surfaces at cell, Quad, Braille, or glyph-fit
+resolution. Use `resolution: 'glyph'` when a shader should sample a 2x4 grid but
+collapse into geometry-aware Unicode or ASCII characters instead of Braille.
+
+```typescript
+import { canvas } from '@flyingrobots/bijou-tui';
+
+const logo = canvas(24, 6, ({ u, v }) => {
+  const lit = Math.abs(u - v) < 0.08;
+  return lit ? { char: 'X', fg: '#ffffff' } : ' ';
+}, { resolution: 'glyph' });
+```
+
+```typescript
+import { run, surfaceShaderFilter, scanlines, vignette } from '@flyingrobots/bijou-tui';
+
+await run(app, {
+  configurePipeline(pipeline) {
+    pipeline.use('PostProcess', surfaceShaderFilter(
+      scanlines({ dimFactor: 0.82 }),
+      vignette({ edgeFactor: 0.78 }),
+    ));
+  },
+});
+```
+
+Use `surfaceShaderFilter(...)` to compose built-in post-process passes like
+`scanlines()`, `flicker()`, `noise()`, and `vignette()` over the packed target
+surface before diff/output.
+
+## Testing
+
+Use `testRuntime()` when you want an inspectable harness instead of a
+one-shot script result:
+
+```typescript
+import { testRuntime } from '@flyingrobots/bijou-tui';
+
+const harness = await testRuntime(app, { ctx });
+await harness.press('q');
+
+expect(harness.frame).toBeDefined();
+expect(harness.messages).toHaveLength(1);
+expect(harness.commands.every((record) => record.settled)).toBe(true);
+
+await harness.teardown();
+```
+
+Keep `runScript()` for fixture-style interaction playback and GIF/demo
+capture, and use `testRuntime()` when you need direct assertions on
+snapshots, emitted messages, command outcomes, or cleanup disposal.
+
+Use `surfaceDiffText()` or `surfaceDiffSurface()` when a frame assertion fails
+and you need cell-level truth instead of a raw string dump:
+
+```typescript
+import { surfaceDiffText } from '@flyingrobots/bijou-tui';
+
+expect(surfaceDiffText(before, after)).toContain('surface diff: 2 changed');
+```
+
+Use `layoutInspectorOverlay()` when a layout assertion needs visual geometry
+truth on top of the rendered frame:
+
+```typescript
+import {
+  layoutInspectorOverlay,
+  layoutInspectorText,
+} from '@flyingrobots/bijou-tui';
+
+const inspected = layoutInspectorOverlay(frame, [
+  {
+    id: 'editor',
+    rect: { col: 2, row: 1, width: 40, height: 12 },
+    focused: true,
+  },
+]);
+
+expect(layoutInspectorText([
+  { id: 'editor', rect: { x: 2, y: 1, width: 40, height: 12 } },
+]))
+  .toContain('focused=false');
+```
+
+Use `evaluateSurfaceBudget()` directly in tests or pass `surfaceBudget` to
+`run()` when an interactive app should route non-fatal runtime warnings:
+
+```typescript
+import { evaluateSurfaceBudget, run } from '@flyingrobots/bijou-tui';
+
+expect(evaluateSurfaceBudget({
+  surface: frame,
+  thresholds: { maxArea: 4000 },
+})).toEqual([]);
+
+await run(app, {
+  ctx,
+  surfaceBudget: { maxArea: 4000, maxStageDurationMs: { Paint: 8 } },
+});
+```
+
+Use `appendInputRoutingRecord()` and `inputRoutingInspectorText()` when a shell
+or app wants to keep the last few routing decisions visible:
+
+```typescript
+import {
+  appendInputRoutingRecord,
+  inputRoutingInspectorText,
+} from '@flyingrobots/bijou-tui';
+
+const history = appendInputRoutingRecord({ records: [] }, {
+  event,
+  result,
+  commandLabels: ['save-file'],
+});
+
+console.log(inputRoutingInspectorText(history));
+```
+
+Use `createInputGestureRecognizer()` and `createInputActionMap()` when raw input
+needs to become semantic gestures before routing. Bijou ships standard feature
+event names such as `press`, `held`, `release`, `tap`, `double-tap`,
+`long-press`, and lets apps provide their own event type strings.
+
+```typescript
+import {
+  createInputActionMap,
+  createInputGestureRecognizer,
+} from '@flyingrobots/bijou-tui';
+
+const recognizer = createInputGestureRecognizer({ doubleTapMs: 300 });
+const actions = createInputActionMap<{ type: 'toggle-footer' }>()
+  .bind('footer.doubleTab', 'Toggle footer', [
+    { deviceId: 'keyboard', featureId: 'key.tab', type: 'double-tap' },
+  ], { type: 'toggle-footer' });
+
+const action = actions.handle(recognizer.observeKey(keyMsg, ctx.runtime.clock.now()));
+```
+
+Use `focusMapText()` or `focusMapSurface()` when focus ownership and tab order
+need the same deterministic treatment:
+
+```typescript
+import { focusMapText } from '@flyingrobots/bijou-tui';
+
+const report = focusMapText([
+  {
+    id: 'editor',
+    owner: 'workspace',
+    role: 'textbox',
+    rect: { x: 2, y: 1, width: 60, height: 20 },
+    tabIndex: 1,
+    focusable: true,
+    focused: true,
+  },
+]);
+
+expect(report).toContain('[1] *editor');
+```
+
 ## Documentation
 
 - **[GUIDE.md](./GUIDE.md)**: Productive-fast path for building apps.
 - **[ADVANCED_GUIDE.md](./ADVANCED_GUIDE.md)**: Shell doctrine, shaders, and motion internals.
+- **[Render Pipeline Guide](../../docs/guides/render-pipeline.md)**: Stage order, `RenderState`, and `configurePipeline()` truth.
 - **[Design System](../../docs/design-system/README.md)**: Semantic guidance and patterns.
 
 ---

package/dist/animate.d.ts

@@ -43,6 +43,10 @@ export interface SpringAnimateOptions<M> extends AnimateBase<M> {
     readonly type?: 'spring';
     /** Spring config — preset name or custom values. */
     readonly spring?: Partial<SpringConfig> | SpringPreset;
+    /** Integration step in seconds. Defaults to 1/120 for stable spring physics. */
+    readonly fixedStepSeconds?: number;
+    /** Maximum pulse time accepted in one runtime pulse. Defaults to 1/20. */
+    readonly maxPulseSeconds?: number;
 }
 /**
  * Options for a duration-based tween animation.

package/dist/animate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EAQd,MAAM,aAAa,CAAC;AAMrB;;;;GAIG;AACH,UAAU,WAAW,CAAC,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC7D,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CACxD;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC5D,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAMjF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAiB7D;AA+FD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAMrD"}
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EAQd,MAAM,aAAa,CAAC;AASrB;;;;GAIG;AACH,UAAU,WAAW,CAAC,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC7D,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IACvD,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC5D,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAMjF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CA2B7D;AAyID;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAMrD"}

package/dist/animate.js

@@ -15,6 +15,8 @@
  * the target value in a single frame.
  */
 import { springStep, createSpringState, resolveSpringConfig, tweenStep, createTweenState, resolveTweenConfig, EASINGS, } from './spring.js';
+const DEFAULT_SPRING_FIXED_STEP_SECONDS = 1 / 120;
+const DEFAULT_SPRING_MAX_PULSE_SECONDS = 1 / 20;
 // ---------------------------------------------------------------------------
 // animate() — the main API
 // ---------------------------------------------------------------------------
@@ -44,28 +46,43 @@ export function animate(options) {
         return createTweenCmd(from, to, options.duration, options.ease ?? EASINGS.easeOutCubic, onFrame, onComplete);
     }
     const config = resolveSpringConfig(options.spring);
-    return createSpringCmd(from, to, config, onFrame, onComplete);
+    return createSpringCmd(from, to, config, {
+        fixedStepSeconds: resolvePositiveSeconds(options.fixedStepSeconds, DEFAULT_SPRING_FIXED_STEP_SECONDS),
+        maxPulseSeconds: resolveMaxPulseSeconds(options.maxPulseSeconds, options.fixedStepSeconds),
+    }, onFrame, onComplete);
 }
-// ---------------------------------------------------------------------------
-// Internal: spring command
-// ---------------------------------------------------------------------------
 /**
- * Build a TEA command that runs a spring animation via `setInterval`.
+ * Build a TEA command that advances a spring animation from runtime pulses.
+ *
+ * The command subscribes through `caps.onPulse`, caps each accepted pulse with
+ * `maxPulseSeconds`, and accumulates that time into fixed-step spring physics
+ * updates. Slow runtime pulses may delay progress, but they do not feed one
+ * large raw delta into the spring integrator.
  *
  * @template M - The message type emitted into the TEA update cycle.
- * @param from       - Starting value.
- * @param to         - Target value.
- * @param config     - Resolved spring physics parameters.
- * @param fps        - Frames per second for the interval timer.
- * @param onFrame    - Callback invoked each frame with the interpolated value.
- * @param onComplete - Optional callback invoked when the spring settles.
+ * @param from        - Starting value.
+ * @param to          - Target value.
+ * @param config      - Resolved spring physics parameters.
+ * @param integration - `fixedStepSeconds` and `maxPulseSeconds` integration policy.
+ * @param onFrame     - Callback invoked after spring physics advances.
+ * @param onComplete  - Optional callback invoked when the spring settles.
  * @returns A TEA command that resolves when the spring is done.
  */
-function createSpringCmd(from, to, config, onFrame, onComplete) {
+function createSpringCmd(from, to, config, integration, onFrame, onComplete) {
     return (emit, caps) => new Promise((resolve) => {
         let state = createSpringState(from);
+        let accumulatedSeconds = 0;
         const handle = caps.onPulse((dt) => {
-            state = springStep(state, to, config, dt);
+            accumulatedSeconds = Math.min(integration.maxPulseSeconds, accumulatedSeconds + acceptedPulseSeconds(dt, integration.maxPulseSeconds));
+            let stepped = false;
+            while (accumulatedSeconds >= integration.fixedStepSeconds && !state.done) {
+                state = springStep(state, to, config, integration.fixedStepSeconds);
+                accumulatedSeconds -= integration.fixedStepSeconds;
+                stepped = true;
+            }
+            if (!stepped) {
+                return;
+            }
             emit(onFrame(state.value));
             if (state.done) {
                 handle.dispose();
@@ -76,23 +93,33 @@ function createSpringCmd(from, to, config, onFrame, onComplete) {
         });
     });
 }
+function resolveMaxPulseSeconds(maxPulseSeconds, fixedStepSeconds) {
+    return Math.max(resolvePositiveSeconds(maxPulseSeconds, DEFAULT_SPRING_MAX_PULSE_SECONDS), resolvePositiveSeconds(fixedStepSeconds, DEFAULT_SPRING_FIXED_STEP_SECONDS));
+}
+function resolvePositiveSeconds(value, fallback) {
+    return value != null && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function acceptedPulseSeconds(dt, maxPulseSeconds) {
+    if (!Number.isFinite(dt) || dt <= 0) {
+        return 0;
+    }
+    return Math.min(dt, maxPulseSeconds);
+}
 // ---------------------------------------------------------------------------
 // Internal: tween command
 // ---------------------------------------------------------------------------
 /**
- * Build a TEA command that runs a tween animation via `setInterval`.
+ * Build a TEA command that advances a tween animation from runtime pulse `dt`.
  *
- * Uses wall-clock time (`Date.now()`) to compute actual elapsed time
- * per frame, so animations run at the correct speed regardless of
- * timer jitter or system load.
+ * The command subscribes through `caps.onPulse`; each pulse supplies elapsed
+ * seconds, which are converted to milliseconds before calling `tweenStep()`.
  *
  * @template M - The message type emitted into the TEA update cycle.
  * @param from       - Starting value.
  * @param to         - Target value.
  * @param duration   - Total animation duration in milliseconds.
  * @param ease       - Easing function applied to normalized progress.
- * @param fps        - Frames per second for the interval timer.
- * @param onFrame    - Callback invoked each frame with the interpolated value.
+ * @param onFrame    - Callback invoked after tween progress advances.
  * @param onComplete - Optional callback invoked when the tween completes.
  * @returns A TEA command that resolves when the tween is done.
  */
@@ -101,7 +128,7 @@ function createTweenCmd(from, to, duration, ease, onFrame, onComplete) {
     return (emit, caps) => new Promise((resolve) => {
         let state = createTweenState(from);
         const handle = caps.onPulse((dt) => {
-            // TweenStep expects milliseconds for delta
+            // tweenStep expects the pulse delta in milliseconds.
             state = tweenStep(state, config, dt * 1000);
             emit(onFrame(state.value));
             if (state.done) {

package/dist/animate.js.map

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

package/dist/app-frame-actions.d.ts.map

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

package/dist/app-frame-actions.js

@@ -13,7 +13,9 @@ import { timeline } from './timeline.js';
 import { EASINGS } from './spring.js';
 import { collectPaneIds, assertUniquePaneIds, findPaneNode, frameBodyRect, } from './app-frame-utils.js';
 import { framePaneOutputToSurface, renderFrameNode } from './app-frame-render.js';
+import { animate } from './animate.js';
 let focusedPaneMeasureScratch = null;
+const FOOTER_TOGGLE_DURATION_MS = 200;
 function renderPaneSurfaceForMeasurement(output, width, height) {
     const scratch = focusedPaneMeasureScratch;
     focusedPaneMeasureScratch = framePaneOutputToSurface(output, width, height, scratch != null && scratch.width === width && scratch.height === height
@@ -26,6 +28,10 @@ export function applyFrameAction(action, model, options, pagesById) {
     switch (action.type) {
         case 'toggle-help':
             return [{ ...model, helpOpen: !model.helpOpen }, []];
+        case 'toggle-perf-hud':
+            return [{ ...model, perfHudOpen: !model.perfHudOpen }, []];
+        case 'toggle-footer':
+            return toggleFooter(model);
         case 'toggle-settings': {
             const activePage = pagesById.get(model.activePageId);
             const settings = options.settings?.({
@@ -71,6 +77,8 @@ export function applyFrameAction(action, model, options, pagesById) {
                     quitConfirmOpen: false,
                 }, []];
         }
+        case 'push-notification':
+            return [model, []];
         case 'prev-tab':
             return switchTab(model, -1, pagesById, options);
         case 'next-tab':
@@ -109,11 +117,58 @@ export function applyFrameAction(action, model, options, pagesById) {
         case 'runtime-issue':
         case 'notification-tick':
             return [model, []];
+        case 'footer-transition':
+            if (action.generation !== (model.footerAnimationGeneration ?? 0))
+                return [model, []];
+            return [{
+                    ...model,
+                    footerTranslateY: Math.max(0, Math.min(1, action.translateY)),
+                }, []];
+        case 'footer-transition-complete':
+            if (action.generation !== (model.footerAnimationGeneration ?? 0))
+                return [model, []];
+            return [{
+                    ...model,
+                    footerVisible: action.visible,
+                    footerTranslateY: action.visible ? 0 : 1,
+                }, []];
         case 'transition':
         case 'transition-complete':
             return [model, []];
     }
 }
+function toggleFooter(model) {
+    const currentVisible = model.footerVisible ?? true;
+    const visible = !currentVisible;
+    const generation = (model.footerAnimationGeneration ?? 0) + 1;
+    const defaultTranslateY = currentVisible ? 0 : 1;
+    const from = Math.max(0, Math.min(1, model.footerTranslateY ?? defaultTranslateY));
+    const to = visible ? 0 : 1;
+    const ease = visible ? EASINGS.easeIn : EASINGS.easeOut;
+    return [{
+            ...model,
+            footerVisible: visible,
+            footerAnimationGeneration: generation,
+        }, [
+            animate({
+                type: 'tween',
+                from,
+                to,
+                duration: FOOTER_TOGGLE_DURATION_MS,
+                ease,
+                onFrame: (translateY) => wrapFrameMsg({
+                    type: 'footer-transition',
+                    translateY,
+                    generation,
+                }),
+                onComplete: () => wrapFrameMsg({
+                    type: 'footer-transition-complete',
+                    visible,
+                    generation,
+                }),
+            }),
+        ]];
+}
 function hasNotificationCenter(model, options, pagesById) {
     const activePage = pagesById.get(model.activePageId);
     if (activePage == null)