@posthog/wizard 1.36.1 → 2.0.0

package/dist/src/ui/tui/primitives/TextBlock.js

@@ -0,0 +1,144 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * TextBlock — Animates a single string paragraph.
+ *
+ * Self-contained: owns its own animIdx and timer.
+ * Calls onComplete() when the animation finishes.
+ *
+ * Five animation modes:
+ *   1. Typewriter           — character-by-character reveal
+ *   2. Word by word         — each word appears in order
+ *   3. Sentence by sentence — sentences appear one at a time
+ *   4. Paragraph fade       — paragraph appears at full opacity immediately
+ *   5. Sentence fade        — paragraph dim, sentences light up in order
+ */
+import { Text } from 'ink';
+import { useState, useEffect, useRef, useMemo } from 'react';
+import { Colors } from '../styles.js';
+import { splitSentences, sentenceEndChars, sentenceEndWords, } from './text-helpers.js';
+import { wrapAndTruncate } from './layout-helpers.js';
+export var TextRevealMode;
+(function (TextRevealMode) {
+    TextRevealMode[TextRevealMode["Typewriter"] = 0] = "Typewriter";
+    TextRevealMode[TextRevealMode["WordByWord"] = 1] = "WordByWord";
+    TextRevealMode[TextRevealMode["SentenceBySentence"] = 2] = "SentenceBySentence";
+    TextRevealMode[TextRevealMode["ParagraphFade"] = 3] = "ParagraphFade";
+    TextRevealMode[TextRevealMode["SentenceFade"] = 4] = "SentenceFade";
+})(TextRevealMode || (TextRevealMode = {}));
+export const TEXT_REVEAL_MODE_LABELS = [
+    'Typewriter',
+    'Word by word',
+    'Sentence by sentence',
+    'Paragraph fade',
+    'Sentence fade',
+];
+export const TEXT_REVEAL_MODE_COUNT = 5;
+/** Default interval per mode (ms) */
+export const TEXT_REVEAL_MODE_DEFAULTS = {
+    [TextRevealMode.WordByWord]: 240,
+    [TextRevealMode.Typewriter]: 32,
+    [TextRevealMode.SentenceBySentence]: 1800,
+    [TextRevealMode.ParagraphFade]: 4800,
+    [TextRevealMode.SentenceFade]: 2400,
+};
+export const TextBlock = ({ text, active, completed, onComplete, mode, bullet, animationInterval, sentenceInterval = 1600, maxHeight, availableWidth, }) => {
+    const speed = animationInterval ?? TEXT_REVEAL_MODE_DEFAULTS[mode];
+    const [animIdx, setAnimIdx] = useState(mode === TextRevealMode.SentenceFade ? 1 : 0);
+    // Reset synchronously during render to avoid a one-frame flash
+    const resetRef = useRef(0);
+    const prevMode = useRef(mode);
+    if (prevMode.current !== mode) {
+        prevMode.current = mode;
+        resetRef.current += 1;
+        setAnimIdx(mode === TextRevealMode.SentenceFade ? 1 : 0);
+    }
+    const words = text.split(/\s+/);
+    const sentences = splitSentences(text);
+    const sentenceCharEnds = useMemo(() => sentenceEndChars(text), [text]);
+    const sentenceWordEnds = useMemo(() => sentenceEndWords(text), [text]);
+    const isDone = mode === TextRevealMode.Typewriter
+        ? animIdx >= text.length
+        : mode === TextRevealMode.ParagraphFade
+            ? true
+            : mode === TextRevealMode.WordByWord
+                ? animIdx >= words.length
+                : mode === TextRevealMode.SentenceFade ||
+                    mode === TextRevealMode.SentenceBySentence
+                    ? animIdx >= sentences.length
+                    : true;
+    // Fire onComplete when done
+    useEffect(() => {
+        if (isDone && active)
+            onComplete();
+    }, [isDone, active, onComplete]);
+    // Animate: single effect for all tick-based modes
+    useEffect(() => {
+        if (!active || mode === TextRevealMode.ParagraphFade || isDone)
+            return;
+        const token = resetRef.current;
+        const isFirstTick = animIdx === 0;
+        let delay = isFirstTick ? 0 : speed;
+        if (!isFirstTick &&
+            mode === TextRevealMode.Typewriter &&
+            animIdx > 0 &&
+            sentenceCharEnds.has(animIdx - 1)) {
+            delay = sentenceInterval;
+        }
+        else if (!isFirstTick &&
+            mode === TextRevealMode.WordByWord &&
+            animIdx > 0 &&
+            sentenceWordEnds.has(animIdx - 1)) {
+            delay = sentenceInterval;
+        }
+        const timer = setTimeout(() => {
+            if (token !== resetRef.current)
+                return;
+            setAnimIdx((c) => c + 1);
+        }, delay);
+        return () => clearTimeout(timer);
+    }, [
+        active,
+        mode,
+        animIdx,
+        isDone,
+        speed,
+        sentenceInterval,
+        sentenceCharEnds,
+        sentenceWordEnds,
+    ]);
+    // Pre-wrap text ourselves to avoid Ink's native wrap leaving leading spaces
+    // on continuation lines. When maxHeight is set, also truncates to last N rows.
+    const wrap = (visibleText) => {
+        if (availableWidth == null)
+            return visibleText;
+        if (maxHeight == null) {
+            return wrapAndTruncate(visibleText, availableWidth, Infinity);
+        }
+        return wrapAndTruncate(visibleText, availableWidth, maxHeight);
+    };
+    // Completed: dimmed text
+    if (completed) {
+        return (_jsxs(Text, { dimColor: true, children: [bullet, wrap(text)] }));
+    }
+    // Active: mode-specific rendering
+    if (mode === TextRevealMode.Typewriter) {
+        const revealed = text.slice(0, animIdx);
+        const atSentenceEnd = /[.!?]\s*$/.test(revealed);
+        const display = atSentenceEnd ? revealed.trimEnd() : revealed;
+        return (_jsxs(Text, { children: [bullet, wrap(display), _jsx(Text, { color: Colors.muted, children: '\u258C' })] }));
+    }
+    if (mode === TextRevealMode.WordByWord) {
+        const visible = words.slice(0, animIdx).join(' ');
+        return (_jsxs(Text, { children: [bullet, wrap(visible)] }));
+    }
+    if (mode === TextRevealMode.ParagraphFade) {
+        return (_jsxs(Text, { children: [bullet, wrap(text)] }));
+    }
+    if (mode === TextRevealMode.SentenceBySentence) {
+        const visible = sentences.slice(0, animIdx).join('');
+        return (_jsxs(Text, { children: [bullet, wrap(visible)] }));
+    }
+    // SentenceFade
+    return (_jsxs(Text, { children: [bullet, sentences.map((s, si) => (_jsx(Text, { dimColor: si >= animIdx, children: s }, si)))] }));
+};
+//# sourceMappingURL=TextBlock.js.map

package/dist/src/ui/tui/primitives/TextBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextBlock.js","sourceRoot":"","sources":["../../../../../src/ui/tui/primitives/TextBlock.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * TextBlock — Animates a single string paragraph.\n *\n * Self-contained: owns its own animIdx and timer.\n * Calls onComplete() when the animation finishes.\n *\n * Five animation modes:\n *   1. Typewriter           — character-by-character reveal\n *   2. Word by word         — each word appears in order\n *   3. Sentence by sentence — sentences appear one at a time\n *   4. Paragraph fade       — paragraph appears at full opacity immediately\n *   5. Sentence fade        — paragraph dim, sentences light up in order\n */\n\nimport { Text } from 'ink';\nimport { useState, useEffect, useRef, useMemo, type ReactNode } from 'react';\nimport { Colors } from '../styles.js';\nimport {\n  splitSentences,\n  sentenceEndChars,\n  sentenceEndWords,\n} from './text-helpers.js';\nimport { wrapAndTruncate } from './layout-helpers.js';\n\nexport enum TextRevealMode {\n  Typewriter = 0,\n  WordByWord = 1,\n  SentenceBySentence = 2,\n  ParagraphFade = 3,\n  SentenceFade = 4,\n}\n\nexport const TEXT_REVEAL_MODE_LABELS = [\n  'Typewriter',\n  'Word by word',\n  'Sentence by sentence',\n  'Paragraph fade',\n  'Sentence fade',\n];\n\nexport const TEXT_REVEAL_MODE_COUNT = 5;\n\n/** Default interval per mode (ms) */\nexport const TEXT_REVEAL_MODE_DEFAULTS: Record<TextRevealMode, number> = {\n  [TextRevealMode.WordByWord]: 240,\n  [TextRevealMode.Typewriter]: 32,\n  [TextRevealMode.SentenceBySentence]: 1800,\n  [TextRevealMode.ParagraphFade]: 4800,\n  [TextRevealMode.SentenceFade]: 2400,\n};\n\ninterface TextBlockProps {\n  text: string;\n  active: boolean;\n  completed: boolean;\n  onComplete: () => void;\n  mode: TextRevealMode;\n  bullet?: ReactNode;\n  animationInterval?: number;\n  sentenceInterval?: number;\n  /** Max rows this block may occupy. When exceeded, top lines are truncated. */\n  maxHeight?: number;\n  /** Available text width in columns (for truncation wrapping). */\n  availableWidth?: number;\n}\n\nexport const TextBlock = ({\n  text,\n  active,\n  completed,\n  onComplete,\n  mode,\n  bullet,\n  animationInterval,\n  sentenceInterval = 1600,\n  maxHeight,\n  availableWidth,\n}: TextBlockProps) => {\n  const speed = animationInterval ?? TEXT_REVEAL_MODE_DEFAULTS[mode];\n\n  const [animIdx, setAnimIdx] = useState(\n    mode === TextRevealMode.SentenceFade ? 1 : 0,\n  );\n\n  // Reset synchronously during render to avoid a one-frame flash\n  const resetRef = useRef(0);\n  const prevMode = useRef(mode);\n  if (prevMode.current !== mode) {\n    prevMode.current = mode;\n    resetRef.current += 1;\n    setAnimIdx(mode === TextRevealMode.SentenceFade ? 1 : 0);\n  }\n\n  const words = text.split(/\\s+/);\n  const sentences = splitSentences(text);\n\n  const sentenceCharEnds = useMemo(() => sentenceEndChars(text), [text]);\n  const sentenceWordEnds = useMemo(() => sentenceEndWords(text), [text]);\n\n  const isDone =\n    mode === TextRevealMode.Typewriter\n      ? animIdx >= text.length\n      : mode === TextRevealMode.ParagraphFade\n      ? true\n      : mode === TextRevealMode.WordByWord\n      ? animIdx >= words.length\n      : mode === TextRevealMode.SentenceFade ||\n        mode === TextRevealMode.SentenceBySentence\n      ? animIdx >= sentences.length\n      : true;\n\n  // Fire onComplete when done\n  useEffect(() => {\n    if (isDone && active) onComplete();\n  }, [isDone, active, onComplete]);\n\n  // Animate: single effect for all tick-based modes\n  useEffect(() => {\n    if (!active || mode === TextRevealMode.ParagraphFade || isDone) return;\n    const token = resetRef.current;\n\n    const isFirstTick = animIdx === 0;\n\n    let delay = isFirstTick ? 0 : speed;\n    if (\n      !isFirstTick &&\n      mode === TextRevealMode.Typewriter &&\n      animIdx > 0 &&\n      sentenceCharEnds.has(animIdx - 1)\n    ) {\n      delay = sentenceInterval;\n    } else if (\n      !isFirstTick &&\n      mode === TextRevealMode.WordByWord &&\n      animIdx > 0 &&\n      sentenceWordEnds.has(animIdx - 1)\n    ) {\n      delay = sentenceInterval;\n    }\n\n    const timer = setTimeout(() => {\n      if (token !== resetRef.current) return;\n      setAnimIdx((c) => c + 1);\n    }, delay);\n    return () => clearTimeout(timer);\n  }, [\n    active,\n    mode,\n    animIdx,\n    isDone,\n    speed,\n    sentenceInterval,\n    sentenceCharEnds,\n    sentenceWordEnds,\n  ]);\n\n  // Pre-wrap text ourselves to avoid Ink's native wrap leaving leading spaces\n  // on continuation lines. When maxHeight is set, also truncates to last N rows.\n  const wrap = (visibleText: string): string => {\n    if (availableWidth == null) return visibleText;\n    if (maxHeight == null) {\n      return wrapAndTruncate(visibleText, availableWidth, Infinity);\n    }\n    return wrapAndTruncate(visibleText, availableWidth, maxHeight);\n  };\n\n  // Completed: dimmed text\n  if (completed) {\n    return (\n      <Text dimColor>\n        {bullet}\n        {wrap(text)}\n      </Text>\n    );\n  }\n\n  // Active: mode-specific rendering\n  if (mode === TextRevealMode.Typewriter) {\n    const revealed = text.slice(0, animIdx);\n    const atSentenceEnd = /[.!?]\\s*$/.test(revealed);\n    const display = atSentenceEnd ? revealed.trimEnd() : revealed;\n    return (\n      <Text>\n        {bullet}\n        {wrap(display)}\n        <Text color={Colors.muted}>{'\\u258C'}</Text>\n      </Text>\n    );\n  }\n\n  if (mode === TextRevealMode.WordByWord) {\n    const visible = words.slice(0, animIdx).join(' ');\n    return (\n      <Text>\n        {bullet}\n        {wrap(visible)}\n      </Text>\n    );\n  }\n\n  if (mode === TextRevealMode.ParagraphFade) {\n    return (\n      <Text>\n        {bullet}\n        {wrap(text)}\n      </Text>\n    );\n  }\n\n  if (mode === TextRevealMode.SentenceBySentence) {\n    const visible = sentences.slice(0, animIdx).join('');\n    return (\n      <Text>\n        {bullet}\n        {wrap(visible)}\n      </Text>\n    );\n  }\n\n  // SentenceFade\n  return (\n    <Text>\n      {bullet}\n      {sentences.map((s, si) => (\n        <Text key={si} dimColor={si >= animIdx}>\n          {s}\n        </Text>\n      ))}\n    </Text>\n  );\n};\n"]}

package/dist/src/ui/tui/primitives/content-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Content block types and type guards.
+ *
+ * Extracted from ContentSequencer so that pure-logic modules (like
+ * layout-helpers) can import them without pulling in Ink/React.
+ */
+import type { ReactNode } from 'react';
+import type { TextRevealMode } from './TextBlock.js';
+/** Object form — string or ReactNode content with per-block overrides. */
+export interface ContentObjectBlock {
+    content: string | ReactNode;
+    mode?: TextRevealMode;
+    animationInterval?: number;
+    sentenceInterval?: number;
+    pause?: number;
+    persist?: boolean;
+}
+/** Lines block — reveals ReactNode lines one at a time. */
+export interface ContentLinesBlock {
+    type: 'lines';
+    lines: ReactNode[];
+    interval?: number;
+    pause?: number;
+}
+/** Clear block — page break that hides all prior blocks. */
+export interface ContentClearBlock {
+    type: 'clear';
+    pause?: number;
+}
+/** A content block in the sequence. Bare strings are sugar for { content: '...' }. */
+export type ContentBlock = string | ContentObjectBlock | ContentLinesBlock | ContentClearBlock;
+/** Type guard for lines blocks. */
+export declare function isLinesBlock(block: ContentBlock): block is ContentLinesBlock;
+/** Type guard for clear blocks. */
+export declare function isClearBlock(block: ContentBlock): block is ContentClearBlock;
+/** Type guard for object blocks (text or node content). */
+export declare function isObjectBlock(block: ContentBlock): block is ContentObjectBlock;

package/dist/src/ui/tui/primitives/content-types.js

@@ -0,0 +1,19 @@
+/**
+ * Content block types and type guards.
+ *
+ * Extracted from ContentSequencer so that pure-logic modules (like
+ * layout-helpers) can import them without pulling in Ink/React.
+ */
+/** Type guard for lines blocks. */
+export function isLinesBlock(block) {
+    return typeof block !== 'string' && 'type' in block && block.type === 'lines';
+}
+/** Type guard for clear blocks. */
+export function isClearBlock(block) {
+    return typeof block !== 'string' && 'type' in block && block.type === 'clear';
+}
+/** Type guard for object blocks (text or node content). */
+export function isObjectBlock(block) {
+    return typeof block !== 'string' && !('type' in block);
+}
+//# sourceMappingURL=content-types.js.map

package/dist/src/ui/tui/primitives/content-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.js","sourceRoot":"","sources":["../../../../../src/ui/tui/primitives/content-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,mCAAmC;AACnC,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChF,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChF,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAC3B,KAAmB;IAEnB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AACzD,CAAC","sourcesContent":["/**\n * Content block types and type guards.\n *\n * Extracted from ContentSequencer so that pure-logic modules (like\n * layout-helpers) can import them without pulling in Ink/React.\n */\n\nimport type { ReactNode } from 'react';\nimport type { TextRevealMode } from './TextBlock.js';\n\n/** Object form — string or ReactNode content with per-block overrides. */\nexport interface ContentObjectBlock {\n  content: string | ReactNode;\n  mode?: TextRevealMode;\n  animationInterval?: number;\n  sentenceInterval?: number;\n  pause?: number;\n  persist?: boolean;\n}\n\n/** Lines block — reveals ReactNode lines one at a time. */\nexport interface ContentLinesBlock {\n  type: 'lines';\n  lines: ReactNode[];\n  interval?: number;\n  pause?: number;\n}\n\n/** Clear block — page break that hides all prior blocks. */\nexport interface ContentClearBlock {\n  type: 'clear';\n  pause?: number;\n}\n\n/** A content block in the sequence. Bare strings are sugar for { content: '...' }. */\nexport type ContentBlock =\n  | string\n  | ContentObjectBlock\n  | ContentLinesBlock\n  | ContentClearBlock;\n\n/** Type guard for lines blocks. */\nexport function isLinesBlock(block: ContentBlock): block is ContentLinesBlock {\n  return typeof block !== 'string' && 'type' in block && block.type === 'lines';\n}\n\n/** Type guard for clear blocks. */\nexport function isClearBlock(block: ContentBlock): block is ContentClearBlock {\n  return typeof block !== 'string' && 'type' in block && block.type === 'clear';\n}\n\n/** Type guard for object blocks (text or node content). */\nexport function isObjectBlock(\n  block: ContentBlock,\n): block is ContentObjectBlock {\n  return typeof block !== 'string' && !('type' in block);\n}\n"]}

package/dist/src/ui/tui/primitives/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Barrel export for all TUI layout primitives.
+ */
+export { CardLayout } from './CardLayout.js';
+export { SplitView } from './SplitView.js';
+export { LoadingBox } from './LoadingBox.js';
+export { ProgressList } from './ProgressList.js';
+export type { ProgressItem } from './ProgressList.js';
+export { PromptLabel } from './PromptLabel.js';
+export { PickerMenu } from './PickerMenu.js';
+export { ConfirmationInput } from './ConfirmationInput.js';
+export { LogViewer } from './LogViewer.js';
+export { EventPlanViewer } from './EventPlanViewer.js';
+export { ScreenContainer } from './ScreenContainer.js';
+export { ScreenErrorBoundary } from './ScreenErrorBoundary.js';
+export { TabContainer } from './TabContainer.js';
+export type { TabDefinition } from './TabContainer.js';
+export { HNViewer } from './HNViewer.js';
+export { DissolveTransition } from './DissolveTransition.js';
+export type { WipeDirection } from './DissolveTransition.js';
+export { ContentSequencer } from './ContentSequencer.js';
+export type { ContentBlock, ContentObjectBlock, ContentLinesBlock, ContentClearBlock, } from './ContentSequencer.js';
+export { estimateBlockHeight, computeVisibleRange, wordWrap, wrapAndTruncate, } from './layout-helpers.js';
+export { TextRevealMode, TEXT_REVEAL_MODE_LABELS, TEXT_REVEAL_MODE_COUNT, TEXT_REVEAL_MODE_DEFAULTS, } from './TextBlock.js';

package/dist/src/ui/tui/primitives/index.js

@@ -0,0 +1,21 @@
+/**
+ * Barrel export for all TUI layout primitives.
+ */
+export { CardLayout } from './CardLayout.js';
+export { SplitView } from './SplitView.js';
+export { LoadingBox } from './LoadingBox.js';
+export { ProgressList } from './ProgressList.js';
+export { PromptLabel } from './PromptLabel.js';
+export { PickerMenu } from './PickerMenu.js';
+export { ConfirmationInput } from './ConfirmationInput.js';
+export { LogViewer } from './LogViewer.js';
+export { EventPlanViewer } from './EventPlanViewer.js';
+export { ScreenContainer } from './ScreenContainer.js';
+export { ScreenErrorBoundary } from './ScreenErrorBoundary.js';
+export { TabContainer } from './TabContainer.js';
+export { HNViewer } from './HNViewer.js';
+export { DissolveTransition } from './DissolveTransition.js';
+export { ContentSequencer } from './ContentSequencer.js';
+export { estimateBlockHeight, computeVisibleRange, wordWrap, wrapAndTruncate, } from './layout-helpers.js';
+export { TextRevealMode, TEXT_REVEAL_MODE_LABELS, TEXT_REVEAL_MODE_COUNT, TEXT_REVEAL_MODE_DEFAULTS, } from './TextBlock.js';
+//# sourceMappingURL=index.js.map

package/dist/src/ui/tui/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ui/tui/primitives/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,EACR,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC","sourcesContent":["/**\n * Barrel export for all TUI layout primitives.\n */\n\nexport { CardLayout } from './CardLayout.js';\nexport { SplitView } from './SplitView.js';\nexport { LoadingBox } from './LoadingBox.js';\nexport { ProgressList } from './ProgressList.js';\nexport type { ProgressItem } from './ProgressList.js';\nexport { PromptLabel } from './PromptLabel.js';\nexport { PickerMenu } from './PickerMenu.js';\nexport { ConfirmationInput } from './ConfirmationInput.js';\nexport { LogViewer } from './LogViewer.js';\nexport { EventPlanViewer } from './EventPlanViewer.js';\nexport { ScreenContainer } from './ScreenContainer.js';\nexport { ScreenErrorBoundary } from './ScreenErrorBoundary.js';\nexport { TabContainer } from './TabContainer.js';\nexport type { TabDefinition } from './TabContainer.js';\nexport { HNViewer } from './HNViewer.js';\nexport { DissolveTransition } from './DissolveTransition.js';\nexport type { WipeDirection } from './DissolveTransition.js';\nexport { ContentSequencer } from './ContentSequencer.js';\nexport type {\n  ContentBlock,\n  ContentObjectBlock,\n  ContentLinesBlock,\n  ContentClearBlock,\n} from './ContentSequencer.js';\nexport {\n  estimateBlockHeight,\n  computeVisibleRange,\n  wordWrap,\n  wrapAndTruncate,\n} from './layout-helpers.js';\nexport {\n  TextRevealMode,\n  TEXT_REVEAL_MODE_LABELS,\n  TEXT_REVEAL_MODE_COUNT,\n  TEXT_REVEAL_MODE_DEFAULTS,\n} from './TextBlock.js';\n"]}

package/dist/src/ui/tui/primitives/layout-helpers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Layout helpers — pure functions for height estimation and viewport eviction.
+ *
+ * These are the core of the responsive content system. They estimate how many
+ * terminal rows a content block will occupy and determine which blocks fit
+ * within a given height budget.
+ */
+import type { ContentBlock } from './content-types.js';
+/**
+ * Estimate the number of terminal rows a content block will occupy,
+ * including 1 row of marginBottom.
+ */
+export declare function estimateBlockHeight(block: ContentBlock, availableWidth: number): number;
+/**
+ * Given all blocks, the active index, available width, and a row budget,
+ * return [startIdx, endIdx] — the range of blocks to render.
+ *
+ * Always includes activeIdx. Walks backward to include as many completed
+ * blocks as fit within maxHeight.
+ */
+export declare function computeVisibleRange(blocks: ContentBlock[], activeIdx: number, availableWidth: number, maxHeight: number): [number, number];
+/**
+ * Word-wrap text at clean word boundaries. Always returns pre-wrapped text
+ * joined with \n — this avoids Ink's native wrap which can leave leading
+ * spaces on continuation lines.
+ *
+ * Uses a 1-char safety margin so slight width estimate mismatches don't
+ * cause Ink to re-wrap our already-wrapped lines.
+ */
+export declare function wordWrap(text: string, availableWidth: number): string[];
+/**
+ * Word-wrap text and return only the last `maxRows` lines.
+ * Used for intra-block truncation when a single text block exceeds the viewport.
+ * Also used for normal rendering to avoid Ink's leading-space wrap artifacts.
+ */
+export declare function wrapAndTruncate(text: string, availableWidth: number, maxRows: number): string;

package/dist/src/ui/tui/primitives/layout-helpers.js

@@ -0,0 +1,95 @@
+/**
+ * Layout helpers — pure functions for height estimation and viewport eviction.
+ *
+ * These are the core of the responsive content system. They estimate how many
+ * terminal rows a content block will occupy and determine which blocks fit
+ * within a given height budget.
+ */
+import { isLinesBlock, isClearBlock, isObjectBlock } from './content-types.js';
+/**
+ * Estimate the number of terminal rows a content block will occupy,
+ * including 1 row of marginBottom.
+ */
+export function estimateBlockHeight(block, availableWidth) {
+    if (typeof block === 'string') {
+        return wordWrap(block, availableWidth).length + 1; // +1 for marginBottom
+    }
+    if (isClearBlock(block))
+        return 0;
+    if (isLinesBlock(block)) {
+        return block.lines.length + 1;
+    }
+    if (isObjectBlock(block)) {
+        if (typeof block.content === 'string') {
+            return wordWrap(block.content, availableWidth).length + 1;
+        }
+        return 4; // conservative fixed estimate for ReactNode
+    }
+    return 1;
+}
+/**
+ * Given all blocks, the active index, available width, and a row budget,
+ * return [startIdx, endIdx] — the range of blocks to render.
+ *
+ * Always includes activeIdx. Walks backward to include as many completed
+ * blocks as fit within maxHeight.
+ */
+export function computeVisibleRange(blocks, activeIdx, availableWidth, maxHeight) {
+    // Reserve a 2-row buffer so resize-induced estimate drift doesn't
+    // cause overflow="hidden" to clip the margin between blocks.
+    const budget = Math.max(4, maxHeight - 2);
+    let totalHeight = estimateBlockHeight(blocks[activeIdx], availableWidth);
+    let start = activeIdx;
+    for (let i = activeIdx - 1; i >= 0; i--) {
+        // Clear blocks act as a hard boundary — don't show anything before them
+        if (isClearBlock(blocks[i]))
+            break;
+        const h = estimateBlockHeight(blocks[i], availableWidth);
+        if (totalHeight + h > budget)
+            break;
+        totalHeight += h;
+        start = i;
+    }
+    return [start, activeIdx];
+}
+/**
+ * Word-wrap text at clean word boundaries. Always returns pre-wrapped text
+ * joined with \n — this avoids Ink's native wrap which can leave leading
+ * spaces on continuation lines.
+ *
+ * Uses a 1-char safety margin so slight width estimate mismatches don't
+ * cause Ink to re-wrap our already-wrapped lines.
+ */
+export function wordWrap(text, availableWidth) {
+    const safeWidth = Math.max(10, availableWidth - 1);
+    const words = text.split(/\s+/);
+    const lines = [];
+    let currentLine = '';
+    for (const word of words) {
+        if (currentLine.length + word.length + 1 > safeWidth &&
+            currentLine.length > 0) {
+            lines.push(currentLine);
+            currentLine = word;
+        }
+        else {
+            currentLine += (currentLine.length > 0 ? ' ' : '') + word;
+        }
+    }
+    if (currentLine.length > 0) {
+        lines.push(currentLine);
+    }
+    return lines;
+}
+/**
+ * Word-wrap text and return only the last `maxRows` lines.
+ * Used for intra-block truncation when a single text block exceeds the viewport.
+ * Also used for normal rendering to avoid Ink's leading-space wrap artifacts.
+ */
+export function wrapAndTruncate(text, availableWidth, maxRows) {
+    const lines = wordWrap(text, availableWidth);
+    if (lines.length <= maxRows) {
+        return lines.join('\n');
+    }
+    return lines.slice(-maxRows).join('\n');
+}
+//# sourceMappingURL=layout-helpers.js.map

package/dist/src/ui/tui/primitives/layout-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-helpers.js","sourceRoot":"","sources":["../../../../../src/ui/tui/primitives/layout-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Layout helpers — pure functions for height estimation and viewport eviction.\n *\n * These are the core of the responsive content system. They estimate how many\n * terminal rows a content block will occupy and determine which blocks fit\n * within a given height budget.\n */\n\nimport type { ContentBlock } from './content-types.js';\nimport { isLinesBlock, isClearBlock, isObjectBlock } from './content-types.js';\n\n/**\n * Estimate the number of terminal rows a content block will occupy,\n * including 1 row of marginBottom.\n */\nexport function estimateBlockHeight(\n  block: ContentBlock,\n  availableWidth: number,\n): number {\n  if (typeof block === 'string') {\n    return wordWrap(block, availableWidth).length + 1; // +1 for marginBottom\n  }\n\n  if (isClearBlock(block)) return 0;\n\n  if (isLinesBlock(block)) {\n    return block.lines.length + 1;\n  }\n\n  if (isObjectBlock(block)) {\n    if (typeof block.content === 'string') {\n      return wordWrap(block.content, availableWidth).length + 1;\n    }\n    return 4; // conservative fixed estimate for ReactNode\n  }\n\n  return 1;\n}\n\n/**\n * Given all blocks, the active index, available width, and a row budget,\n * return [startIdx, endIdx] — the range of blocks to render.\n *\n * Always includes activeIdx. Walks backward to include as many completed\n * blocks as fit within maxHeight.\n */\nexport function computeVisibleRange(\n  blocks: ContentBlock[],\n  activeIdx: number,\n  availableWidth: number,\n  maxHeight: number,\n): [number, number] {\n  // Reserve a 2-row buffer so resize-induced estimate drift doesn't\n  // cause overflow=\"hidden\" to clip the margin between blocks.\n  const budget = Math.max(4, maxHeight - 2);\n\n  let totalHeight = estimateBlockHeight(blocks[activeIdx], availableWidth);\n  let start = activeIdx;\n\n  for (let i = activeIdx - 1; i >= 0; i--) {\n    // Clear blocks act as a hard boundary — don't show anything before them\n    if (isClearBlock(blocks[i])) break;\n    const h = estimateBlockHeight(blocks[i], availableWidth);\n    if (totalHeight + h > budget) break;\n    totalHeight += h;\n    start = i;\n  }\n\n  return [start, activeIdx];\n}\n\n/**\n * Word-wrap text at clean word boundaries. Always returns pre-wrapped text\n * joined with \\n — this avoids Ink's native wrap which can leave leading\n * spaces on continuation lines.\n *\n * Uses a 1-char safety margin so slight width estimate mismatches don't\n * cause Ink to re-wrap our already-wrapped lines.\n */\nexport function wordWrap(text: string, availableWidth: number): string[] {\n  const safeWidth = Math.max(10, availableWidth - 1);\n  const words = text.split(/\\s+/);\n  const lines: string[] = [];\n  let currentLine = '';\n\n  for (const word of words) {\n    if (\n      currentLine.length + word.length + 1 > safeWidth &&\n      currentLine.length > 0\n    ) {\n      lines.push(currentLine);\n      currentLine = word;\n    } else {\n      currentLine += (currentLine.length > 0 ? ' ' : '') + word;\n    }\n  }\n  if (currentLine.length > 0) {\n    lines.push(currentLine);\n  }\n\n  return lines;\n}\n\n/**\n * Word-wrap text and return only the last `maxRows` lines.\n * Used for intra-block truncation when a single text block exceeds the viewport.\n * Also used for normal rendering to avoid Ink's leading-space wrap artifacts.\n */\nexport function wrapAndTruncate(\n  text: string,\n  availableWidth: number,\n  maxRows: number,\n): string {\n  const lines = wordWrap(text, availableWidth);\n\n  if (lines.length <= maxRows) {\n    return lines.join('\\n');\n  }\n\n  return lines.slice(-maxRows).join('\\n');\n}\n"]}

package/dist/src/ui/tui/primitives/text-helpers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Text-splitting helpers for sentence boundary detection.
+ * Used by TextBlock for animation pauses at punctuation.
+ */
+/** Split text into sentences (keeps the delimiter attached) */
+export declare function splitSentences(text: string): string[];
+/** Build a set of character indices where sentences end (for typewriter pause) */
+export declare function sentenceEndChars(text: string): Set<number>;
+/** Build a set of word indices where sentences end (for word-by-word pause) */
+export declare function sentenceEndWords(text: string): Set<number>;

package/dist/src/ui/tui/primitives/text-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * Text-splitting helpers for sentence boundary detection.
+ * Used by TextBlock for animation pauses at punctuation.
+ */
+/** Split text into sentences (keeps the delimiter attached) */
+export function splitSentences(text) {
+    const parts = [];
+    const re = /[^.!?]*[.!?]+\s*/g;
+    let match;
+    let lastIndex = 0;
+    while ((match = re.exec(text)) !== null) {
+        parts.push(match[0]);
+        lastIndex = re.lastIndex;
+    }
+    if (lastIndex < text.length) {
+        parts.push(text.slice(lastIndex));
+    }
+    return parts;
+}
+/** Build a set of character indices where sentences end (for typewriter pause) */
+export function sentenceEndChars(text) {
+    const ends = new Set();
+    const sentences = splitSentences(text);
+    let pos = 0;
+    for (const s of sentences) {
+        pos += s.length;
+        ends.add(pos - 1);
+    }
+    return ends;
+}
+/** Build a set of word indices where sentences end (for word-by-word pause) */
+export function sentenceEndWords(text) {
+    const ends = new Set();
+    const sentences = splitSentences(text);
+    let wordCount = 0;
+    for (const s of sentences) {
+        const words = s.trim().split(/\s+/).filter(Boolean);
+        wordCount += words.length;
+        ends.add(wordCount - 1);
+    }
+    return ends;
+}
+//# sourceMappingURL=text-helpers.js.map

package/dist/src/ui/tui/primitives/text-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-helpers.js","sourceRoot":"","sources":["../../../../../src/ui/tui/primitives/text-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,mBAAmB,CAAC;IAC/B,IAAI,KAA6B,CAAC;IAClC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC;IAC3B,CAAC;IACD,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Text-splitting helpers for sentence boundary detection.\n * Used by TextBlock for animation pauses at punctuation.\n */\n\n/** Split text into sentences (keeps the delimiter attached) */\nexport function splitSentences(text: string): string[] {\n  const parts: string[] = [];\n  const re = /[^.!?]*[.!?]+\\s*/g;\n  let match: RegExpExecArray | null;\n  let lastIndex = 0;\n  while ((match = re.exec(text)) !== null) {\n    parts.push(match[0]);\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) {\n    parts.push(text.slice(lastIndex));\n  }\n  return parts;\n}\n\n/** Build a set of character indices where sentences end (for typewriter pause) */\nexport function sentenceEndChars(text: string): Set<number> {\n  const ends = new Set<number>();\n  const sentences = splitSentences(text);\n  let pos = 0;\n  for (const s of sentences) {\n    pos += s.length;\n    ends.add(pos - 1);\n  }\n  return ends;\n}\n\n/** Build a set of word indices where sentences end (for word-by-word pause) */\nexport function sentenceEndWords(text: string): Set<number> {\n  const ends = new Set<number>();\n  const sentences = splitSentences(text);\n  let wordCount = 0;\n  for (const s of sentences) {\n    const words = s.trim().split(/\\s+/).filter(Boolean);\n    wordCount += words.length;\n    ends.add(wordCount - 1);\n  }\n  return ends;\n}\n"]}

package/dist/src/ui/tui/router.d.ts

@@ -0,0 +1,56 @@
+/**
+ * WizardRouter — declarative flow pipelines + overlay stack.
+ *
+ * Two layers:
+ *   Flow cursor    — linear pipeline of screens, advanced with next()
+ *   Overlay stack  — interrupts (outage, auth-expired, etc.) that push/pop
+ *
+ * The visible screen is: top of overlay stack if non-empty, otherwise the flow cursor.
+ *
+ * Adding a flow screen = append to a pipeline array.
+ * Adding an overlay = call pushOverlay() from anywhere.
+ * No switch statements, no hardcoded transitions in business logic.
+ */
+import type { WizardSession } from '../../lib/wizard-session.js';
+import { Screen, Flow, type FlowEntry } from './flows.js';
+export { Screen, Flow };
+export type { FlowEntry };
+/** Screens that interrupt flows as overlays */
+export declare enum Overlay {
+    Outage = "outage",
+    SettingsOverride = "settings-override"
+}
+/** Union of all screen names */
+export type ScreenName = Screen | Overlay;
+export declare class WizardRouter {
+    private flow;
+    private flowName;
+    private overlays;
+    constructor(flowName?: Flow);
+    /**
+     * Resolve which screen should be active based on session state.
+     * Walks the flow pipeline, skipping hidden entries and completed entries,
+     * returns the first incomplete screen.
+     */
+    resolve(session: WizardSession): ScreenName;
+    /** The screen that should be rendered right now. */
+    get activeScreen(): ScreenName;
+    /** The name of the active flow. */
+    get activeFlow(): Flow;
+    /** Whether an overlay is currently active. */
+    get hasOverlay(): boolean;
+    /**
+     * Push an overlay that interrupts the current flow.
+     * The flow resumes when the overlay is dismissed via popOverlay().
+     */
+    pushOverlay(overlay: Overlay): void;
+    /**
+     * Dismiss the topmost overlay. The flow screen underneath resumes.
+     */
+    popOverlay(): void;
+    /**
+     * Direction hint for screen transitions.
+     */
+    private _lastDirection;
+    get lastNavDirection(): 'push' | 'pop' | null;
+}

package/dist/src/ui/tui/router.js

@@ -0,0 +1,94 @@
+/**
+ * WizardRouter — declarative flow pipelines + overlay stack.
+ *
+ * Two layers:
+ *   Flow cursor    — linear pipeline of screens, advanced with next()
+ *   Overlay stack  — interrupts (outage, auth-expired, etc.) that push/pop
+ *
+ * The visible screen is: top of overlay stack if non-empty, otherwise the flow cursor.
+ *
+ * Adding a flow screen = append to a pipeline array.
+ * Adding an overlay = call pushOverlay() from anywhere.
+ * No switch statements, no hardcoded transitions in business logic.
+ */
+import { FLOWS, Screen, Flow } from './flows.js';
+// Re-export so existing imports from './router.js' keep working
+export { Screen, Flow };
+// ── Screen name taxonomy ──────────────────────────────────────────────
+/** Screens that interrupt flows as overlays */
+export var Overlay;
+(function (Overlay) {
+    Overlay["Outage"] = "outage";
+    Overlay["SettingsOverride"] = "settings-override";
+})(Overlay || (Overlay = {}));
+// ── Router ────────────────────────────────────────────────────────────
+export class WizardRouter {
+    flow;
+    flowName;
+    overlays = [];
+    constructor(flowName = Flow.Wizard) {
+        this.flowName = flowName;
+        this.flow = FLOWS[flowName];
+    }
+    /**
+     * Resolve which screen should be active based on session state.
+     * Walks the flow pipeline, skipping hidden entries and completed entries,
+     * returns the first incomplete screen.
+     */
+    resolve(session) {
+        if (this.overlays.length > 0) {
+            return this.overlays[this.overlays.length - 1];
+        }
+        for (const entry of this.flow) {
+            if (entry.show && !entry.show(session))
+                continue;
+            if (entry.isComplete && entry.isComplete(session))
+                continue;
+            return entry.screen;
+        }
+        // All entries complete — show the last screen (outro)
+        return this.flow[this.flow.length - 1].screen;
+    }
+    /** The screen that should be rendered right now. */
+    get activeScreen() {
+        // Overlays take priority — resolve() handles this too,
+        // but activeScreen is called before session is available in some paths
+        if (this.overlays.length > 0) {
+            return this.overlays[this.overlays.length - 1];
+        }
+        return this.flow[0].screen;
+    }
+    /** The name of the active flow. */
+    get activeFlow() {
+        return this.flowName;
+    }
+    /** Whether an overlay is currently active. */
+    get hasOverlay() {
+        return this.overlays.length > 0;
+    }
+    /**
+     * Push an overlay that interrupts the current flow.
+     * The flow resumes when the overlay is dismissed via popOverlay().
+     */
+    pushOverlay(overlay) {
+        this.overlays.push(overlay);
+    }
+    /**
+     * Dismiss the topmost overlay. The flow screen underneath resumes.
+     */
+    popOverlay() {
+        this.overlays.pop();
+    }
+    /**
+     * Direction hint for screen transitions.
+     */
+    _lastDirection = null;
+    get lastNavDirection() {
+        return this._lastDirection;
+    }
+    /** @internal — called by store wrapper to track direction */
+    _setDirection(dir) {
+        this._lastDirection = dir;
+    }
+}
+//# sourceMappingURL=router.js.map