@bradygaster/squad-cli 0.8.5 → 0.8.16

package/dist/cli/shell/useAnimation.js

@@ -0,0 +1,139 @@
+/**
+ * Animation hooks for tasteful CLI transitions.
+ *
+ * All hooks respect NO_COLOR — when isNoColor() is true, animations are
+ * skipped and static content is returned immediately.
+ *
+ * Frame rate capped at ~15fps (67ms intervals) to stay GPU-friendly in Ink.
+ *
+ * Owned by Cheritto (TUI Engineer).
+ */
+import { useState, useEffect, useRef } from 'react';
+import { isNoColor } from './terminal.js';
+/** ~15fps frame interval */
+const FRAME_MS = 67;
+/**
+ * Typewriter: reveals text character by character over durationMs.
+ * NO_COLOR: returns full text immediately.
+ */
+export function useTypewriter(text, durationMs = 500) {
+    const noColor = isNoColor();
+    const [count, setCount] = useState(noColor ? text.length : 0);
+    useEffect(() => {
+        if (noColor || !text) {
+            setCount(text.length);
+            return;
+        }
+        setCount(0);
+        const charsPerFrame = Math.max(1, Math.ceil(text.length / (durationMs / FRAME_MS)));
+        const timer = setInterval(() => {
+            setCount(c => {
+                const next = Math.min(c + charsPerFrame, text.length);
+                if (next >= text.length)
+                    clearInterval(timer);
+                return next;
+            });
+        }, FRAME_MS);
+        return () => clearInterval(timer);
+    }, [text, durationMs, noColor]);
+    return text.slice(0, count);
+}
+/**
+ * Fade-in: starts dim, becomes normal after durationMs.
+ * Returns true while still fading (content should be dim).
+ * Triggers when `active` becomes true.
+ * NO_COLOR: always returns false (no fade).
+ */
+export function useFadeIn(active, durationMs = 300) {
+    const noColor = isNoColor();
+    const [dim, setDim] = useState(false);
+    useEffect(() => {
+        if (noColor || !active)
+            return;
+        setDim(true);
+        const timer = setTimeout(() => setDim(false), durationMs);
+        return () => clearTimeout(timer);
+    }, [active, durationMs, noColor]);
+    return dim;
+}
+/**
+ * Completion flash: detects when agents transition working/streaming → idle.
+ * Returns Set of agent names currently showing "✓ Done" flash.
+ * Flash lasts flashMs (default 1500ms).
+ * NO_COLOR: returns empty set.
+ *
+ * Uses React's setState-during-render pattern for synchronous detection,
+ * so the flash is visible on the same render that triggers the transition.
+ */
+export function useCompletionFlash(agents, flashMs = 1500) {
+    const noColor = isNoColor();
+    const prevRef = useRef(new Map());
+    const [flashing, setFlashing] = useState(new Set());
+    const timersRef = useRef(new Map());
+    // Detect transitions during render (synchronous)
+    const prev = prevRef.current;
+    if (!noColor) {
+        let changed = false;
+        const next = new Set(flashing);
+        for (const agent of agents) {
+            const prevStatus = prev.get(agent.name);
+            const wasActive = prevStatus === 'working' || prevStatus === 'streaming';
+            const isNowIdle = agent.status === 'idle';
+            if (wasActive && isNowIdle && !flashing.has(agent.name)) {
+                next.add(agent.name);
+                changed = true;
+            }
+        }
+        if (changed) {
+            setFlashing(next);
+        }
+    }
+    // Update prev status map after detection
+    const newMap = new Map();
+    for (const a of agents)
+        newMap.set(a.name, a.status);
+    prevRef.current = newMap;
+    // Timer cleanup: remove flash after flashMs
+    useEffect(() => {
+        for (const name of flashing) {
+            if (!timersRef.current.has(name)) {
+                const timer = setTimeout(() => {
+                    setFlashing(s => { const n = new Set(s); n.delete(name); return n; });
+                    timersRef.current.delete(name);
+                }, flashMs);
+                timersRef.current.set(name, timer);
+            }
+        }
+    }, [flashing, flashMs]);
+    // Cleanup all timers on unmount
+    useEffect(() => {
+        return () => { timersRef.current.forEach(t => clearTimeout(t)); };
+    }, []);
+    return flashing;
+}
+/**
+ * Message fade: tracks new messages and returns count of "fading" messages
+ * from the end of the visible list.
+ * NO_COLOR: always returns 0.
+ */
+export function useMessageFade(totalCount, fadeMs = 200) {
+    const noColor = isNoColor();
+    const prevRef = useRef(totalCount);
+    const [fadingCount, setFadingCount] = useState(0);
+    useEffect(() => {
+        if (noColor) {
+            prevRef.current = totalCount;
+            return;
+        }
+        const diff = totalCount - prevRef.current;
+        if (diff > 0) {
+            setFadingCount(diff);
+            const timer = setTimeout(() => setFadingCount(0), fadeMs);
+            prevRef.current = totalCount;
+            return () => clearTimeout(timer);
+        }
+        prevRef.current = totalCount;
+    }, [totalCount, fadeMs, noColor]);
+    return fadingCount;
+}
+//# sourceMappingURL=useAnimation.js.map

package/dist/cli/shell/useAnimation.js.map

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

package/dist/cli-entry.d.ts

@@ -1,10 +1,3 @@
 #!/usr/bin/env node
-/**
- * Squad CLI — entry point for command-line invocation.
- * Separated from src/index.ts so library consumers can import
- * the SDK without triggering CLI argument parsing or process.exit().
- *
- * SDK library exports live in src/index.ts (dist/index.js).
- */
 export {};
 //# sourceMappingURL=cli-entry.d.ts.map

package/dist/cli-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-entry.d.ts","sourceRoot":"","sources":["../src/cli-entry.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}
+{"version":3,"file":"cli-entry.d.ts","sourceRoot":"","sources":["../src/cli-entry.ts"],"names":[],"mappings":""}