silvery 0.19.2 → 0.21.1

package/dist/{types-Bk2yw9Qj.mjs → src-WeA_J4BV.mjs}

@@ -1,4 +1,4 @@
-//#region node_modules/.bun/alien-signals@3.1.2/node_modules/alien-signals/esm/system.mjs
+//#region node_modules/alien-signals/esm/system.mjs
 function createReactiveSystem({ update, notify, unwatched }) {
 	return {
 		link,
@@ -168,7 +168,7 @@ function createReactiveSystem({ update, notify, unwatched }) {
 	}
 }
 //#endregion
-//#region node_modules/.bun/alien-signals@3.1.2/node_modules/alien-signals/esm/index.mjs
+//#region node_modules/alien-signals/esm/index.mjs
 let cycle = 0;
 let notifyIndex = 0;
 let queuedLength = 0;
@@ -364,105 +364,45 @@ function purgeDeps(sub) {
 	while (dep !== void 0) dep = unlink(dep, sub);
 }
 //#endregion
-//#region packages/ag/src/layout-signals.ts
+//#region packages/signals/src/index.ts
 /**
-* withLayoutSignals — reactive signal layer for AgNode layout outputs.
+* Subscribe to signal changes via an imperative callback.
 *
-* Composable plugin that wraps an AgNode with reactive signals for layout
-* rects, text content, and focus state. Engine-agnostic — works with
-* Flexily, Yoga, or any future layout engine.
-*
-* Signals are WeakMap-backed and lazily created. Nodes without subscribers
-* pay zero cost. After layout completes, the pipeline calls `syncSignals()`
-* to propagate imperative state into signals.
-*
-* ## Usage
+* alien-signals' `effect()` runs once eagerly to establish dependencies,
+* which means a plain `effect(() => handler(sig()))` fires with the seed
+* value. `watch()` swallows that first fire and only calls `onChange` when
+* the value actually changes — matching the old `.subscribe(handler)`
+* semantic consumers often want.
 *
 * ```ts
-* import { getLayoutSignals, syncSignals } from "@silvery/ag/layout-signals"
-*
-* // Get (or create) signals for a node
-* const signals = getLayoutSignals(node)
-* signals.boxRect()       // read current rect
-* signals.textContent()   // read current text
-*
-* // After layout/reconciler mutations, sync imperative → reactive
-* syncSignals(node)
+* const stop = watch(
+*   () => size.snapshot(),
+*   (next, prev) => { emit({ cols: next.cols, rows: next.rows }) },
+* )
+* // stop() to unsubscribe
 * ```
 *
-* ## Three-layer stack
-*
-* Layer 0: alien-signals (signal, computed, effect)
-* Layer 1: getLayoutSignals() — this module (@silvery/ag, framework-agnostic)
-* Layer 2: useSignal(signal) — @silvery/ag-react (React bridge)
-* Layer 3: useBoxRect(), useAgNode() — semantic convenience hooks
-*/
-const signalMap = /* @__PURE__ */ new WeakMap();
-/**
-* Get or create layout signals for a node.
-*
-* Lazily created on first access. Automatically garbage-collected
-* when the node is removed from the tree (WeakMap semantics).
+* Returns the effect's stop function.
 */
-function getLayoutSignals(node) {
-	let s = signalMap.get(node);
-	if (!s) {
-		s = {
-			boxRect: signal(node.boxRect),
-			scrollRect: signal(node.scrollRect),
-			screenRect: signal(node.screenRect),
-			textContent: signal(node.textContent),
-			focused: signal(node.interactiveState?.focused ?? false)
-		};
-		signalMap.set(node, s);
-	}
-	return s;
-}
-/**
-* Sync all rect signals from the node's current values.
-*
-* Called from notifyLayoutSubscribers after layout + scroll + sticky
-* phases complete. Only syncs nodes that have signals allocated.
-* Reference-equality check prevents unnecessary downstream updates.
-*/
-function syncRectSignals(node) {
-	const s = signalMap.get(node);
-	if (!s) return;
-	if (node.boxRect !== s.boxRect()) s.boxRect(node.boxRect);
-	if (node.scrollRect !== s.scrollRect()) s.scrollRect(node.scrollRect);
-	if (node.screenRect !== s.screenRect()) s.screenRect(node.screenRect);
-}
-/**
-* Sync textContent signal from the node's current value.
-*
-* Called from commitTextUpdate in the reconciler.
-*/
-function syncTextContentSignal(node) {
-	const s = signalMap.get(node);
-	if (!s) return;
-	if (node.textContent !== s.textContent()) s.textContent(node.textContent);
-}
-/**
-* Sync focused signal for a node.
-*
-* Called from FocusManager when focus changes.
-*/
-function syncFocusedSignal(node, focused) {
-	const s = signalMap.get(node);
-	if (!s) return;
-	if (focused !== s.focused()) s.focused(focused);
-}
-//#endregion
-//#region packages/ag/src/types.ts
-/**
-* Check if two rects are equal (same position and size).
-*/
-function rectEqual(a, b) {
-	if (a === b) return true;
-	if (!a || !b) return false;
-	return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+function watch(read, onChange, opts = {}) {
+	const equals = opts.equals ?? Object.is;
+	let seeded = false;
+	let prev;
+	return effect(() => {
+		const next = read();
+		if (!seeded) {
+			seeded = true;
+			prev = next;
+			if (opts.immediate) onChange(next, next);
+			return;
+		}
+		if (equals(next, prev)) return;
+		const old = prev;
+		prev = next;
+		onChange(next, old);
+	});
 }
 //#endregion
-export { syncTextContentSignal as a, signal as c, syncRectSignals as i, getLayoutSignals as n, computed as o, syncFocusedSignal as r, effect as s, rectEqual as t };
+export { signal as i, computed as n, effect as r, watch as t };
 
-//# sourceMappingURL=types-Bk2yw9Qj.mjs.map
+//# sourceMappingURL=src-WeA_J4BV.mjs.map

package/dist/src-WeA_J4BV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-WeA_J4BV.mjs","names":[],"sources":["../node_modules/alien-signals/esm/system.mjs","../node_modules/alien-signals/esm/index.mjs","../packages/signals/src/index.ts"],"sourcesContent":["export const ReactiveFlags = {\n    None: 0,\n    Mutable: 1,\n    Watching: 2,\n    RecursedCheck: 4,\n    Recursed: 8,\n    Dirty: 16,\n    Pending: 32,\n};\nexport function createReactiveSystem({ update, notify, unwatched, }) {\n    return {\n        link,\n        unlink,\n        propagate,\n        checkDirty,\n        shallowPropagate,\n    };\n    function link(dep, sub, version) {\n        const prevDep = sub.depsTail;\n        if (prevDep !== undefined && prevDep.dep === dep) {\n            return;\n        }\n        const nextDep = prevDep !== undefined ? prevDep.nextDep : sub.deps;\n        if (nextDep !== undefined && nextDep.dep === dep) {\n            nextDep.version = version;\n            sub.depsTail = nextDep;\n            return;\n        }\n        const prevSub = dep.subsTail;\n        if (prevSub !== undefined && prevSub.version === version && prevSub.sub === sub) {\n            return;\n        }\n        const newLink = sub.depsTail\n            = dep.subsTail\n                = {\n                    version,\n                    dep,\n                    sub,\n                    prevDep,\n                    nextDep,\n                    prevSub,\n                    nextSub: undefined,\n                };\n        if (nextDep !== undefined) {\n            nextDep.prevDep = newLink;\n        }\n        if (prevDep !== undefined) {\n            prevDep.nextDep = newLink;\n        }\n        else {\n            sub.deps = newLink;\n        }\n        if (prevSub !== undefined) {\n            prevSub.nextSub = newLink;\n        }\n        else {\n            dep.subs = newLink;\n        }\n    }\n    function unlink(link, sub = link.sub) {\n        const dep = link.dep;\n        const prevDep = link.prevDep;\n        const nextDep = link.nextDep;\n        const nextSub = link.nextSub;\n        const prevSub = link.prevSub;\n        if (nextDep !== undefined) {\n            nextDep.prevDep = prevDep;\n        }\n        else {\n            sub.depsTail = prevDep;\n        }\n        if (prevDep !== undefined) {\n            prevDep.nextDep = nextDep;\n        }\n        else {\n            sub.deps = nextDep;\n        }\n        if (nextSub !== undefined) {\n            nextSub.prevSub = prevSub;\n        }\n        else {\n            dep.subsTail = prevSub;\n        }\n        if (prevSub !== undefined) {\n            prevSub.nextSub = nextSub;\n        }\n        else if ((dep.subs = nextSub) === undefined) {\n            unwatched(dep);\n        }\n        return nextDep;\n    }\n    function propagate(link) {\n        let next = link.nextSub;\n        let stack;\n        top: do {\n            const sub = link.sub;\n            let flags = sub.flags;\n            if (!(flags & (4 | 8 | 16 | 32))) {\n                sub.flags = flags | 32;\n            }\n            else if (!(flags & (4 | 8))) {\n                flags = 0;\n            }\n            else if (!(flags & 4)) {\n                sub.flags = (flags & ~8) | 32;\n            }\n            else if (!(flags & (16 | 32)) && isValidLink(link, sub)) {\n                sub.flags = flags | (8 | 32);\n                flags &= 1;\n            }\n            else {\n                flags = 0;\n            }\n            if (flags & 2) {\n                notify(sub);\n            }\n            if (flags & 1) {\n                const subSubs = sub.subs;\n                if (subSubs !== undefined) {\n                    const nextSub = (link = subSubs).nextSub;\n                    if (nextSub !== undefined) {\n                        stack = { value: next, prev: stack };\n                        next = nextSub;\n                    }\n                    continue;\n                }\n            }\n            if ((link = next) !== undefined) {\n                next = link.nextSub;\n                continue;\n            }\n            while (stack !== undefined) {\n                link = stack.value;\n                stack = stack.prev;\n                if (link !== undefined) {\n                    next = link.nextSub;\n                    continue top;\n                }\n            }\n            break;\n        } while (true);\n    }\n    function checkDirty(link, sub) {\n        let stack;\n        let checkDepth = 0;\n        let dirty = false;\n        top: do {\n            const dep = link.dep;\n            const flags = dep.flags;\n            if (sub.flags & 16) {\n                dirty = true;\n            }\n            else if ((flags & (1 | 16)) === (1 | 16)) {\n                if (update(dep)) {\n                    const subs = dep.subs;\n                    if (subs.nextSub !== undefined) {\n                        shallowPropagate(subs);\n                    }\n                    dirty = true;\n                }\n            }\n            else if ((flags & (1 | 32)) === (1 | 32)) {\n                if (link.nextSub !== undefined || link.prevSub !== undefined) {\n                    stack = { value: link, prev: stack };\n                }\n                link = dep.deps;\n                sub = dep;\n                ++checkDepth;\n                continue;\n            }\n            if (!dirty) {\n                const nextDep = link.nextDep;\n                if (nextDep !== undefined) {\n                    link = nextDep;\n                    continue;\n                }\n            }\n            while (checkDepth--) {\n                const firstSub = sub.subs;\n                const hasMultipleSubs = firstSub.nextSub !== undefined;\n                if (hasMultipleSubs) {\n                    link = stack.value;\n                    stack = stack.prev;\n                }\n                else {\n                    link = firstSub;\n                }\n                if (dirty) {\n                    if (update(sub)) {\n                        if (hasMultipleSubs) {\n                            shallowPropagate(firstSub);\n                        }\n                        sub = link.sub;\n                        continue;\n                    }\n                    dirty = false;\n                }\n                else {\n                    sub.flags &= ~32;\n                }\n                sub = link.sub;\n                const nextDep = link.nextDep;\n                if (nextDep !== undefined) {\n                    link = nextDep;\n                    continue top;\n                }\n            }\n            return dirty;\n        } while (true);\n    }\n    function shallowPropagate(link) {\n        do {\n            const sub = link.sub;\n            const flags = sub.flags;\n            if ((flags & (32 | 16)) === 32) {\n                sub.flags = flags | 16;\n                if ((flags & (2 | 4)) === 2) {\n                    notify(sub);\n                }\n            }\n        } while ((link = link.nextSub) !== undefined);\n    }\n    function isValidLink(checkLink, sub) {\n        let link = sub.depsTail;\n        while (link !== undefined) {\n            if (link === checkLink) {\n                return true;\n            }\n            link = link.prevDep;\n        }\n        return false;\n    }\n}\n","import { createReactiveSystem } from './system.mjs';\nlet cycle = 0;\nlet batchDepth = 0;\nlet notifyIndex = 0;\nlet queuedLength = 0;\nlet activeSub;\nconst queued = [];\nconst { link, unlink, propagate, checkDirty, shallowPropagate, } = createReactiveSystem({\n    update(node) {\n        if (node.depsTail !== undefined) {\n            return updateComputed(node);\n        }\n        else {\n            return updateSignal(node);\n        }\n    },\n    notify(effect) {\n        let insertIndex = queuedLength;\n        let firstInsertedIndex = insertIndex;\n        do {\n            queued[insertIndex++] = effect;\n            effect.flags &= ~2;\n            effect = effect.subs?.sub;\n            if (effect === undefined || !(effect.flags & 2)) {\n                break;\n            }\n        } while (true);\n        queuedLength = insertIndex;\n        while (firstInsertedIndex < --insertIndex) {\n            const left = queued[firstInsertedIndex];\n            queued[firstInsertedIndex++] = queued[insertIndex];\n            queued[insertIndex] = left;\n        }\n    },\n    unwatched(node) {\n        if (!(node.flags & 1)) {\n            effectScopeOper.call(node);\n        }\n        else if (node.depsTail !== undefined) {\n            node.depsTail = undefined;\n            node.flags = 1 | 16;\n            purgeDeps(node);\n        }\n    },\n});\nexport function getActiveSub() {\n    return activeSub;\n}\nexport function setActiveSub(sub) {\n    const prevSub = activeSub;\n    activeSub = sub;\n    return prevSub;\n}\nexport function getBatchDepth() {\n    return batchDepth;\n}\nexport function startBatch() {\n    ++batchDepth;\n}\nexport function endBatch() {\n    if (!--batchDepth) {\n        flush();\n    }\n}\nexport function isSignal(fn) {\n    return fn.name === 'bound ' + signalOper.name;\n}\nexport function isComputed(fn) {\n    return fn.name === 'bound ' + computedOper.name;\n}\nexport function isEffect(fn) {\n    return fn.name === 'bound ' + effectOper.name;\n}\nexport function isEffectScope(fn) {\n    return fn.name === 'bound ' + effectScopeOper.name;\n}\nexport function signal(initialValue) {\n    return signalOper.bind({\n        currentValue: initialValue,\n        pendingValue: initialValue,\n        subs: undefined,\n        subsTail: undefined,\n        flags: 1,\n    });\n}\nexport function computed(getter) {\n    return computedOper.bind({\n        value: undefined,\n        subs: undefined,\n        subsTail: undefined,\n        deps: undefined,\n        depsTail: undefined,\n        flags: 0,\n        getter: getter,\n    });\n}\nexport function effect(fn) {\n    const e = {\n        fn,\n        subs: undefined,\n        subsTail: undefined,\n        deps: undefined,\n        depsTail: undefined,\n        flags: 2 | 4,\n    };\n    const prevSub = setActiveSub(e);\n    if (prevSub !== undefined) {\n        link(e, prevSub, 0);\n    }\n    try {\n        e.fn();\n    }\n    finally {\n        activeSub = prevSub;\n        e.flags &= ~4;\n    }\n    return effectOper.bind(e);\n}\nexport function effectScope(fn) {\n    const e = {\n        deps: undefined,\n        depsTail: undefined,\n        subs: undefined,\n        subsTail: undefined,\n        flags: 0,\n    };\n    const prevSub = setActiveSub(e);\n    if (prevSub !== undefined) {\n        link(e, prevSub, 0);\n    }\n    try {\n        fn();\n    }\n    finally {\n        activeSub = prevSub;\n    }\n    return effectScopeOper.bind(e);\n}\nexport function trigger(fn) {\n    const sub = {\n        deps: undefined,\n        depsTail: undefined,\n        flags: 2,\n    };\n    const prevSub = setActiveSub(sub);\n    try {\n        fn();\n    }\n    finally {\n        activeSub = prevSub;\n        let link = sub.deps;\n        while (link !== undefined) {\n            const dep = link.dep;\n            link = unlink(link, sub);\n            const subs = dep.subs;\n            if (subs !== undefined) {\n                sub.flags = 0;\n                propagate(subs);\n                shallowPropagate(subs);\n            }\n        }\n        if (!batchDepth) {\n            flush();\n        }\n    }\n}\nfunction updateComputed(c) {\n    ++cycle;\n    c.depsTail = undefined;\n    c.flags = 1 | 4;\n    const prevSub = setActiveSub(c);\n    try {\n        const oldValue = c.value;\n        return oldValue !== (c.value = c.getter(oldValue));\n    }\n    finally {\n        activeSub = prevSub;\n        c.flags &= ~4;\n        purgeDeps(c);\n    }\n}\nfunction updateSignal(s) {\n    s.flags = 1;\n    return s.currentValue !== (s.currentValue = s.pendingValue);\n}\nfunction run(e) {\n    const flags = e.flags;\n    if (flags & 16\n        || (flags & 32\n            && checkDirty(e.deps, e))) {\n        ++cycle;\n        e.depsTail = undefined;\n        e.flags = 2 | 4;\n        const prevSub = setActiveSub(e);\n        try {\n            e.fn();\n        }\n        finally {\n            activeSub = prevSub;\n            e.flags &= ~4;\n            purgeDeps(e);\n        }\n    }\n    else {\n        e.flags = 2;\n    }\n}\nfunction flush() {\n    try {\n        while (notifyIndex < queuedLength) {\n            const effect = queued[notifyIndex];\n            queued[notifyIndex++] = undefined;\n            run(effect);\n        }\n    }\n    finally {\n        while (notifyIndex < queuedLength) {\n            const effect = queued[notifyIndex];\n            queued[notifyIndex++] = undefined;\n            effect.flags |= 2 | 8;\n        }\n        notifyIndex = 0;\n        queuedLength = 0;\n    }\n}\nfunction computedOper() {\n    const flags = this.flags;\n    if (flags & 16\n        || (flags & 32\n            && (checkDirty(this.deps, this)\n                || (this.flags = flags & ~32, false)))) {\n        if (updateComputed(this)) {\n            const subs = this.subs;\n            if (subs !== undefined) {\n                shallowPropagate(subs);\n            }\n        }\n    }\n    else if (!flags) {\n        this.flags = 1 | 4;\n        const prevSub = setActiveSub(this);\n        try {\n            this.value = this.getter();\n        }\n        finally {\n            activeSub = prevSub;\n            this.flags &= ~4;\n        }\n    }\n    const sub = activeSub;\n    if (sub !== undefined) {\n        link(this, sub, cycle);\n    }\n    return this.value;\n}\nfunction signalOper(...value) {\n    if (value.length) {\n        if (this.pendingValue !== (this.pendingValue = value[0])) {\n            this.flags = 1 | 16;\n            const subs = this.subs;\n            if (subs !== undefined) {\n                propagate(subs);\n                if (!batchDepth) {\n                    flush();\n                }\n            }\n        }\n    }\n    else {\n        if (this.flags & 16) {\n            if (updateSignal(this)) {\n                const subs = this.subs;\n                if (subs !== undefined) {\n                    shallowPropagate(subs);\n                }\n            }\n        }\n        let sub = activeSub;\n        while (sub !== undefined) {\n            if (sub.flags & (1 | 2)) {\n                link(this, sub, cycle);\n                break;\n            }\n            sub = sub.subs?.sub;\n        }\n        return this.currentValue;\n    }\n}\nfunction effectOper() {\n    effectScopeOper.call(this);\n}\nfunction effectScopeOper() {\n    this.depsTail = undefined;\n    this.flags = 0;\n    purgeDeps(this);\n    const sub = this.subs;\n    if (sub !== undefined) {\n        unlink(sub);\n    }\n}\nfunction purgeDeps(sub) {\n    const depsTail = sub.depsTail;\n    let dep = depsTail !== undefined ? depsTail.nextDep : sub.deps;\n    while (dep !== undefined) {\n        dep = unlink(dep, sub);\n    }\n}\n","/**\n * @silvery/signals — Reactive signals for silvery.\n *\n * Thin wrapper around alien-signals providing:\n * - signal(value) — create a reactive value (call to read, call with arg to write)\n * - computed(fn) — derived reactive value that recomputes on dependency changes\n * - effect(fn) — side effect that re-runs when dependencies change\n * - effectScope(fn) — group effects for collective disposal\n * - batch(fn) — batch multiple signal updates into one notification\n * - watch(read, onChange) — change-only subscription (skips the seed fire)\n *\n * @packageDocumentation\n */\n\nexport {\n  signal,\n  computed,\n  effect,\n  effectScope,\n  startBatch,\n  endBatch,\n  trigger,\n  isSignal,\n  isComputed,\n  isEffect,\n  isEffectScope,\n  getActiveSub,\n  setActiveSub,\n  getBatchDepth,\n} from \"alien-signals\"\n\nimport { effect, startBatch, endBatch } from \"alien-signals\"\n\n/**\n * A reactive value — callable getter/setter.\n *\n * - `sig()` reads the current value (and subscribes the active effect/computed).\n * - `sig(next)` writes a new value; subscribers re-run only if `next !== current`.\n *\n * Matches the return shape of `signal<T>(initial)` from alien-signals, so any\n * `signal()` result is assignable to `Signal<T>`.\n */\nexport type Signal<T> = {\n  (): T\n  (value: T): void\n}\n\n/**\n * A read-only reactive value — callable getter that subscribes the active\n * effect/computed but cannot be written to. Matches the return shape of\n * `computed<T>(fn)` from alien-signals.\n */\nexport type ReadSignal<T> = () => T\n\n/** Batch multiple signal updates, notifying subscribers once at the end. */\nexport function batch(fn: () => void): void {\n  startBatch()\n  try {\n    fn()\n  } finally {\n    endBatch()\n  }\n}\n\n/**\n * Options for {@link watch}.\n */\nexport interface WatchOptions<T> {\n  /** If true, fire `onChange` on the seed read with `(next, next)`. Default false (change-only). */\n  immediate?: boolean\n  /** Equality predicate — handler fires only when `equals(next, prev)` is false. Default `Object.is`. */\n  equals?: (a: T, b: T) => boolean\n}\n\n/**\n * Subscribe to signal changes via an imperative callback.\n *\n * alien-signals' `effect()` runs once eagerly to establish dependencies,\n * which means a plain `effect(() => handler(sig()))` fires with the seed\n * value. `watch()` swallows that first fire and only calls `onChange` when\n * the value actually changes — matching the old `.subscribe(handler)`\n * semantic consumers often want.\n *\n * ```ts\n * const stop = watch(\n *   () => size.snapshot(),\n *   (next, prev) => { emit({ cols: next.cols, rows: next.rows }) },\n * )\n * // stop() to unsubscribe\n * ```\n *\n * Returns the effect's stop function.\n */\nexport function watch<T>(\n  read: () => T,\n  onChange: (next: T, prev: T) => void,\n  opts: WatchOptions<T> = {},\n): () => void {\n  const equals = opts.equals ?? Object.is\n  let seeded = false\n  let prev!: T\n  return effect(() => {\n    const next = read()\n    if (!seeded) {\n      seeded = true\n      prev = next\n      if (opts.immediate) onChange(next, next)\n      return\n    }\n    if (equals(next, prev)) return\n    const old = prev\n    prev = next\n    onChange(next, old)\n  })\n}\n"],"x_google_ignoreList":[0,1],"mappings":"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"}

package/dist/steps-DYrzCUCK.d.mts

@@ -0,0 +1,202 @@
+//#region packages/ag-react/src/ui/progress/step-node.d.ts
+/**
+ * Step node tree structure for declarative steps
+ *
+ * Parses the user's declarative object structure into an internal tree
+ * that can be rendered and executed.
+ */
+/**
+ * A single step in the tree
+ */
+interface StepNode {
+  /** Display label (auto-generated or custom) */
+  label: string;
+  /** Object key from the declaration */
+  key: string;
+  /** Work function (if leaf node) */
+  work?: (...args: unknown[]) => unknown;
+  /** Child steps (if group node) */
+  children?: StepNode[];
+  /** Indentation level for display */
+  indent: number;
+}
+/**
+ * What users can declare as a step value
+ */
+type StepValue = ((...args: unknown[]) => unknown) | [string, (...args: unknown[]) => unknown] | StepsDef;
+/**
+ * The declarative structure users provide
+ */
+type StepsDef = {
+  [key: string]: StepValue;
+};
+//#endregion
+//#region packages/ag-react/src/ui/progress/als-context.d.ts
+/**
+ * Context available to work functions during step execution
+ */
+interface StepContext {
+  /** Update progress on current step */
+  progress(current: number, total: number): void;
+  /** Create a sub-step (auto-completes previous sub-step) */
+  sub(label: string): void;
+  /** Get current step label (for debugging) */
+  readonly label: string;
+}
+/**
+ * Get the current step context
+ *
+ * Safe to call anywhere - returns a no-op context when called outside
+ * of a steps() execution context.
+ *
+ * @example
+ * ```typescript
+ * async function processFiles(files: string[]) {
+ *   for (let i = 0; i < files.length; i++) {
+ *     step().progress(i + 1, files.length);
+ *     await process(files[i]);
+ *   }
+ * }
+ *
+ * // In tests (no steps context)
+ * await processFiles(["a.md", "b.md"]);  // step() returns no-op, no errors
+ *
+ * // In production (with steps context)
+ * await steps({ process: processFiles }).run();  // Shows progress
+ * ```
+ */
+declare function step(): StepContext;
+//#endregion
+//#region packages/ag-react/src/ui/progress/declarative.d.ts
+/**
+ * Options for run() and pipe() execution
+ */
+interface ExecuteOptions$1 {
+  /** Clear progress display after completion (default: false) */
+  clear?: boolean;
+}
+/**
+ * Extract the return type from a generator or async generator
+ */
+type GeneratorReturn<T> = T extends Generator<unknown, infer R, unknown> ? R : T extends AsyncGenerator<unknown, infer R, unknown> ? R : T;
+/**
+ * Unwrap the result type, handling generators specially
+ */
+type UnwrapResult<T> = Awaited<GeneratorReturn<Awaited<T>>>;
+/**
+ * Result type: maps step keys to their return values
+ */
+type StepResults<T extends StepsDef> = { [K in keyof T]: T[K] extends ((...args: unknown[]) => infer R) ? UnwrapResult<R> : T[K] extends [string, (...args: unknown[]) => infer R] ? UnwrapResult<R> : T[K] extends StepsDef ? StepResults<T[K]> : unknown };
+/**
+ * The runner object returned by steps()
+ */
+interface StepsRunner<T extends StepsDef> {
+  /** Internal: the parsed step nodes (for testing) */
+  readonly _steps: StepNode[];
+  /**
+   * Execute all steps sequentially
+   * @returns Results keyed by step name
+   */
+  run(options?: ExecuteOptions$1): Promise<StepResults<T>>;
+  /**
+   * Execute all steps in a pipeline (each receives previous result)
+   * @returns Final step's result
+   */
+  pipe(options?: ExecuteOptions$1): Promise<unknown>;
+  /**
+   * Manually signal completion (for manual execution mode)
+   */
+  done(options?: {
+    clear?: boolean;
+  }): void;
+}
+//#endregion
+//#region packages/ag-react/src/ui/progress/steps.d.ts
+/** Progress update (object form) */
+interface ProgressUpdate {
+  current?: number;
+  total?: number;
+}
+/** Declare all sub-steps upfront (optional, yield as first value) */
+interface DeclareSteps {
+  declare: string[];
+}
+/** What generators can yield */
+type StepYield = string | ProgressUpdate | DeclareSteps;
+/**
+ * Controller for creating and updating sub-steps
+ *
+ * Passed to work functions that need to report sub-step progress.
+ */
+interface StepController {
+  /** Create a new sub-step (auto-completes previous sub-step) */
+  new (label: string): void;
+  /** Update progress on current sub-step */
+  progress(current: number, total: number): void;
+  /** Explicitly complete current sub-step (optional - new() auto-completes) */
+  done(): void;
+}
+/** Work function types */
+type SyncWork<T> = () => T;
+type AsyncWork<T> = () => PromiseLike<T>;
+type SyncGeneratorWork<T> = () => Generator<StepYield, T, unknown>;
+type AsyncGeneratorWork<T> = () => AsyncGenerator<StepYield, T, unknown>;
+/** Work function with step controller for sub-step progress */
+type WorkWithStep<T> = (step: StepController) => T | PromiseLike<T>;
+type WorkFn<T> = SyncWork<T> | AsyncWork<T> | SyncGeneratorWork<T> | AsyncGeneratorWork<T> | WorkWithStep<T>;
+/** Options for execute() */
+interface ExecuteOptions {
+  /** Clear progress display after completion (default: false) */
+  clear?: boolean;
+}
+interface StepBuilder {
+  /**
+   * Add a step to run
+   *
+   * @param title - Display title for this step
+   * @param work - Function to execute. Can be:
+   *   - Sync function: `() => result`
+   *   - Async function: `async () => result`
+   *   - Sync generator: `function* () { yield "sub-step"; return result; }`
+   *   - Async generator: `async function* () { yield "sub-step"; return result; }`
+   *
+   * Generators can yield:
+   *   - `"string"` - Creates a new sub-step with that label
+   *   - `{ current: N, total: M }` - Updates progress on current sub-step
+   */
+  run<T>(title: string, work: WorkFn<T>): StepBuilder;
+  /**
+   * Execute all steps in sequence
+   * @param options - Execution options
+   * @returns Results keyed by step title
+   */
+  execute(options?: ExecuteOptions): Promise<Record<string, unknown>>;
+}
+/**
+ * Create a step runner
+ *
+ * @overload Declarative mode - pass an object to declare steps upfront
+ * @overload Fluent mode - chain steps with .run() and execute with .execute()
+ *
+ * @example Declarative mode (recommended)
+ * ```typescript
+ * const loader = steps({
+ *   loadModules,
+ *   loadRepo: { discover, parse },
+ * });
+ * const results = await loader.run({ clear: true });
+ * ```
+ *
+ * @example Fluent mode
+ * ```typescript
+ * await steps()
+ *   .run("Step 1", doStep1)
+ *   .run("Step 2", doStep2)
+ *   .execute();
+ * ```
+ */
+declare function steps<T extends StepsDef>(def: T): StepsRunner<T>;
+declare function steps(): StepBuilder;
+//#endregion
+export { StepContext as a, StepsDef as c, StepsRunner as i, StepBuilder as n, step as o, steps as r, StepNode as s, ExecuteOptions as t };
+//# sourceMappingURL=steps-DYrzCUCK.d.mts.map

package/dist/steps-DYrzCUCK.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps-DYrzCUCK.d.mts","names":[],"sources":["../packages/ag-react/src/ui/progress/step-node.ts","../packages/ag-react/src/ui/progress/als-context.ts","../packages/ag-react/src/ui/progress/declarative.ts","../packages/ag-react/src/ui/progress/steps.ts"],"mappings":";;AAUA;;;;;;;;UAAiB,QAAA;EAWJ;EATX,KAAA;EAYM;EATN,GAAA;EAeU;EAZV,IAAA,OAAW,IAAA;;EAGX,QAAA,GAAW,QAAA;EAUJ;EAPP,MAAA;AAAA;;;AAcF;KARY,SAAA,QACH,IAAA,wCACQ,IAAA,2BACb,QAAA;;;;KAKQ,QAAA;EAAA,CACT,GAAA,WAAc,SAAA;AAAA;;;;;;UCzBA,WAAA;EDUT;ECRN,QAAA,CAAS,OAAA,UAAiB,KAAA;EDchB;ECXV,GAAA,CAAI,KAAA;;WAGK,KAAA;AAAA;;;;;;;;;;AAgDX;;;;;;;;ACtCA;;;;;iBDsCgB,IAAA,CAAA,GAAQ,WAAA;;;;;;UCtCP,gBAAA;EFRT;EEUN,KAAA;AAAA;;;;KAMG,eAAA,MACH,CAAA,SAAU,SAAA,8BACN,CAAA,GACA,CAAA,SAAU,cAAA,8BACR,CAAA,GACA,CAAA;;;;KAKH,YAAA,MAAkB,OAAA,CAAQ,eAAA,CAAgB,OAAA,CAAQ,CAAA;AFZvD;;;AAAA,KEiBK,WAAA,WAAsB,QAAA,kBACb,CAAA,GAAI,CAAA,CAAE,CAAA,eAAe,IAAA,2BAC7B,YAAA,CAAa,CAAA,IACb,CAAA,CAAE,CAAA,uBAAwB,IAAA,2BACxB,YAAA,CAAa,CAAA,IACb,CAAA,CAAE,CAAA,UAAW,QAAA,GACX,WAAA,CAAY,CAAA,CAAE,CAAA;;;AD/CxB;UCsDiB,WAAA,WAAsB,QAAA;;WAE5B,MAAA,EAAQ,QAAA;EDtDjB;;;;EC4DA,GAAA,CAAI,OAAA,GAAU,gBAAA,GAAiB,OAAA,CAAQ,WAAA,CAAY,CAAA;EDtD1C;;;AAgDX;ECYE,IAAA,CAAK,OAAA,GAAU,gBAAA,GAAiB,OAAA;;;;EAKhC,IAAA,CAAK,OAAA;IAAY,KAAA;EAAA;AAAA;;;;UCrBT,cAAA;EACR,OAAA;EACA,KAAA;AAAA;;UAIQ,YAAA;EACR,OAAA;AAAA;;KAIG,SAAA,YAAqB,cAAA,GAAiB,YAAA;;;;;;UAO1B,cAAA;EDzCX;EAAA,KC2CC,KAAA;ED3CuC;EC8C5C,QAAA,CAAS,OAAA,UAAiB,KAAA;ED5CpB;EC+CN,IAAA;AAAA;AD/CO;AAAA,KCmDJ,QAAA,YAAoB,CAAA;AAAA,KACpB,SAAA,YAAqB,WAAA,CAAY,CAAA;AAAA,KACjC,iBAAA,YAA6B,SAAA,CAAU,SAAA,EAAW,CAAA;AAAA,KAClD,kBAAA,YAA8B,cAAA,CAAe,SAAA,EAAW,CAAA;;KAExD,YAAA,OAAmB,IAAA,EAAM,cAAA,KAAmB,CAAA,GAAI,WAAA,CAAY,CAAA;AAAA,KAE5D,MAAA,MACD,QAAA,CAAS,CAAA,IACT,SAAA,CAAU,CAAA,IACV,iBAAA,CAAkB,CAAA,IAClB,kBAAA,CAAmB,CAAA,IACnB,YAAA,CAAa,CAAA;;UASA,cAAA;EDnEM;ECqErB,KAAA;AAAA;AAAA,UAGe,WAAA;EDxEuC;;AAAA;;;;;;;;;;;;ECuFtD,GAAA,IAAO,KAAA,UAAe,IAAA,EAAM,MAAA,CAAO,CAAA,IAAK,WAAA;ED7ElC;;;;;ECoFN,OAAA,CAAQ,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA0B7B,KAAA,WAAgB,QAAA,CAAA,CAAU,GAAA,EAAK,CAAA,GAAI,WAAA,CAAY,CAAA;AAAA,iBAC/C,KAAA,CAAA,GAAS,WAAA"}

package/dist/svg-DhxQkz-O.mjs

@@ -0,0 +1,255 @@
+//#region packages/ag-react/src/ui/recording-chrome/spec.ts
+const RECORDING_CHROME_STYLES = [
+	"none",
+	"macos",
+	"windows"
+];
+const MACOS_CONTROLS = [
+	{
+		glyph: "●",
+		color: "red"
+	},
+	{
+		glyph: "●",
+		color: "yellow"
+	},
+	{
+		glyph: "●",
+		color: "green"
+	}
+];
+const WINDOWS_CONTROLS = [
+	{
+		glyph: "−",
+		color: "$fg-muted"
+	},
+	{
+		glyph: "□",
+		color: "$fg-muted"
+	},
+	{
+		glyph: "×",
+		color: "red"
+	}
+];
+function recordingChromeOverhead(style) {
+	switch (style) {
+		case "macos":
+		case "windows": return {
+			cols: 2,
+			rows: 5
+		};
+		default: return {
+			cols: 0,
+			rows: 2
+		};
+	}
+}
+function composeRecordingChromeSpec(options = {}) {
+	const style = options.style ?? "macos";
+	const title = options.title ?? "";
+	const alignment = options.alignment ?? "center";
+	switch (style) {
+		case "macos": return {
+			style,
+			title,
+			alignment,
+			hasChrome: true,
+			overhead: recordingChromeOverhead(style),
+			live: {
+				borderStyle: "round",
+				titleBar: {
+					controlsSide: "left",
+					controls: MACOS_CONTROLS,
+					separator: "·"
+				}
+			}
+		};
+		case "windows": return {
+			style,
+			title,
+			alignment,
+			hasChrome: true,
+			overhead: recordingChromeOverhead(style),
+			live: {
+				borderStyle: "single",
+				titleBar: {
+					controlsSide: "right",
+					controls: WINDOWS_CONTROLS,
+					separator: null
+				}
+			}
+		};
+		default: return {
+			style: "none",
+			title,
+			alignment,
+			hasChrome: false,
+			overhead: recordingChromeOverhead("none"),
+			live: {
+				borderStyle: "none",
+				titleBar: null
+			}
+		};
+	}
+}
+function recordingChromeSvgLayout(spec) {
+	switch (spec.style) {
+		case "macos": {
+			const padding = 28;
+			const margin = 24;
+			const windowBarSize = 38;
+			return {
+				windowBar: "colorful",
+				windowBarSize,
+				padding,
+				borderRadius: 10,
+				margin,
+				shadow: 14,
+				contentOffset: {
+					x: margin + padding,
+					y: margin + padding + windowBarSize
+				}
+			};
+		}
+		case "windows": {
+			const padding = 24;
+			const margin = 0;
+			const windowBarSize = 34;
+			return {
+				windowBar: "windows",
+				windowBarSize,
+				padding,
+				borderRadius: 0,
+				margin,
+				shadow: 0,
+				contentOffset: {
+					x: margin + padding,
+					y: margin + padding + windowBarSize
+				}
+			};
+		}
+		default: return {
+			windowBar: "none",
+			windowBarSize: 0,
+			padding: 0,
+			borderRadius: 0,
+			margin: 0,
+			shadow: 0,
+			contentOffset: {
+				x: 0,
+				y: 0
+			}
+		};
+	}
+}
+function recordingChromeSvgContentOffset(spec) {
+	return recordingChromeSvgLayout(spec).contentOffset;
+}
+function recordingChromeSpecToSvgOptions(spec) {
+	if (!spec.hasChrome) return {};
+	const layout = recordingChromeSvgLayout(spec);
+	const options = {
+		windowBar: layout.windowBar,
+		windowBarSize: layout.windowBarSize,
+		padding: layout.padding,
+		borderRadius: layout.borderRadius,
+		...spec.title ? { windowTitle: spec.title } : {}
+	};
+	if (layout.margin > 0) options.margin = layout.margin;
+	if (layout.shadow > 0) options.shadow = layout.shadow;
+	return options;
+}
+//#endregion
+//#region packages/ag-react/src/ui/recording-chrome/svg.ts
+function coord(value) {
+	return String(Math.round(value * 1e3) / 1e3);
+}
+function escapeXml(text) {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function rgbToHex(color) {
+	return `#${color.r.toString(16).padStart(2, "0")}${color.g.toString(16).padStart(2, "0")}${color.b.toString(16).padStart(2, "0")}`;
+}
+function parseHex(color) {
+	const m = /^#([0-9a-fA-F]{6})$/.exec(color.trim());
+	if (!m) return null;
+	const n = Number.parseInt(m[1], 16);
+	return {
+		r: n >> 16 & 255,
+		g: n >> 8 & 255,
+		b: n & 255
+	};
+}
+function luminance(c) {
+	return (.2126 * c.r + .7152 * c.g + .0722 * c.b) / 255;
+}
+function deriveBarColor(themeBg) {
+	const rgb = parseHex(themeBg);
+	if (!rgb) return "#333333";
+	const shift = luminance(rgb) < .5 ? 28 : -28;
+	const clamp = (v) => Math.max(0, Math.min(255, v + shift));
+	return rgbToHex({
+		r: clamp(rgb.r),
+		g: clamp(rgb.g),
+		b: clamp(rgb.b)
+	});
+}
+function titleColorFor(barColor) {
+	const rgb = parseHex(barColor);
+	if (!rgb) return "#cccccc";
+	return luminance(rgb) < .5 ? "#cccccc" : "#333333";
+}
+function composeRecordingChromeSvg(options) {
+	const specLayout = options.spec ? recordingChromeSvgLayout(options.spec) : null;
+	const windowBar = specLayout?.windowBar ?? options.windowBar ?? "none";
+	if (windowBar === "none") return [];
+	const barWidth = options.barWidth;
+	const barHeight = options.barHeight ?? specLayout?.windowBarSize ?? 40;
+	const borderRadius = options.borderRadius ?? specLayout?.borderRadius ?? 0;
+	const themeBg = options.themeBackground;
+	const title = options.title ?? options.spec?.title ?? null;
+	const fontSize = options.fontSize ?? 16;
+	const titleFontSize = Math.max(13, Math.min(fontSize, Math.round(barHeight * .5)));
+	const parts = [];
+	const barColor = deriveBarColor(themeBg);
+	parts.push(`<rect width="${coord(barWidth)}" height="${coord(barHeight)}" rx="${coord(borderRadius)}" ry="${coord(borderRadius)}" fill="${barColor}"/>`);
+	if (borderRadius > 0) parts.push(`<rect y="${coord(barHeight - borderRadius)}" width="${coord(barWidth)}" height="${coord(borderRadius)}" fill="${barColor}"/>`);
+	const titleColor = titleColorFor(barColor);
+	if (windowBar === "windows") {
+		const slot = 46;
+		const glyphSize = 10;
+		const cy = barHeight / 2;
+		const closeX = barWidth - slot / 2;
+		const maxX = barWidth - slot * 1.5;
+		const minX = barWidth - slot * 2.5;
+		const half = glyphSize / 2;
+		parts.push(`<line x1="${coord(minX - half)}" y1="${coord(cy)}" x2="${coord(minX + half)}" y2="${coord(cy)}" stroke="${titleColor}" stroke-width="1.4"/>`);
+		parts.push(`<rect x="${coord(maxX - half)}" y="${coord(cy - half)}" width="${glyphSize}" height="${glyphSize}" fill="none" stroke="${titleColor}" stroke-width="1.4"/>`);
+		parts.push(`<line x1="${coord(closeX - half)}" y1="${coord(cy - half)}" x2="${coord(closeX + half)}" y2="${coord(cy + half)}" stroke="#e81123" stroke-width="1.6"/>`);
+		parts.push(`<line x1="${coord(closeX - half)}" y1="${coord(cy + half)}" x2="${coord(closeX + half)}" y2="${coord(cy - half)}" stroke="#e81123" stroke-width="1.6"/>`);
+		if (title) parts.push(`<text x="14" y="${coord(cy)}" font-size="${titleFontSize}" font-family="'Segoe UI', 'Helvetica Neue', Arial, sans-serif" fill="${titleColor}" dominant-baseline="central">${escapeXml(title)}</text>`);
+		return parts;
+	}
+	const dotRadius = 6;
+	const dotY = barHeight / 2;
+	const dotStartX = 20;
+	if (windowBar === "rings") {
+		parts.push(`<circle cx="${dotStartX}" cy="${coord(dotY)}" r="${dotRadius}" fill="none" stroke="#ff5f57" stroke-width="1.5"/>`);
+		parts.push(`<circle cx="${dotStartX + 20}" cy="${coord(dotY)}" r="${dotRadius}" fill="none" stroke="#febc2e" stroke-width="1.5"/>`);
+		parts.push(`<circle cx="${dotStartX + 40}" cy="${coord(dotY)}" r="${dotRadius}" fill="none" stroke="#28c840" stroke-width="1.5"/>`);
+	} else {
+		parts.push(`<circle cx="${dotStartX}" cy="${coord(dotY)}" r="${dotRadius}" fill="#ff5f57"/>`);
+		parts.push(`<circle cx="${dotStartX + 20}" cy="${coord(dotY)}" r="${dotRadius}" fill="#febc2e"/>`);
+		parts.push(`<circle cx="${dotStartX + 40}" cy="${coord(dotY)}" r="${dotRadius}" fill="#28c840"/>`);
+	}
+	if (title) {
+		const titleStartX = dotStartX + 40 + dotRadius + 14;
+		parts.push(`<text x="${titleStartX}" y="${coord(dotY)}" font-size="${titleFontSize}" font-family="'Helvetica Neue', Arial, sans-serif" font-weight="bold" fill="${titleColor}" dominant-baseline="central">${escapeXml(title)}</text>`);
+	}
+	return parts;
+}
+//#endregion
+export { recordingChromeSpecToSvgOptions as a, recordingChromeOverhead as i, RECORDING_CHROME_STYLES as n, recordingChromeSvgContentOffset as o, composeRecordingChromeSpec as r, recordingChromeSvgLayout as s, composeRecordingChromeSvg as t };
+
+//# sourceMappingURL=svg-DhxQkz-O.mjs.map