silvery 0.17.0 → 0.17.2

package/dist/key-mapping-BsUHe_nk.mjs

@@ -0,0 +1,3 @@
+import { n as keyToAnsi, r as parseKey, t as init_key_mapping } from "./key-mapping-DsyfLEdC.mjs";
+init_key_mapping();
+export { keyToAnsi, parseKey };

package/dist/key-mapping-DsyfLEdC.mjs

@@ -0,0 +1,132 @@
+import { n as __esmMin } from "./chunk-BSw8zbkd.mjs";
+//#region ../termless/src/key-mapping.ts
+function normalizeModifier(mod) {
+	return MODIFIER_ALIASES[mod.toLowerCase()] ?? mod.toLowerCase();
+}
+/**
+* Parse a key string like "Ctrl+a", "ArrowUp", "Shift+Tab" into a KeyDescriptor.
+*
+* Supports modifier prefixes: Ctrl, Control, Alt, Shift, Meta, Cmd, Option, Super.
+* Modifiers are case-insensitive and separated by "+".
+*/
+function parseKey(key) {
+	const parts = key.split("+");
+	const result = { key: parts.pop() };
+	for (const part of parts) switch (normalizeModifier(part)) {
+		case "ctrl":
+			result.ctrl = true;
+			break;
+		case "shift":
+			result.shift = true;
+			break;
+		case "alt":
+			result.alt = true;
+			break;
+		case "super":
+			result.super = true;
+			break;
+	}
+	return result;
+}
+/**
+* Convert a key descriptor or key string to its ANSI escape sequence.
+*
+* Handles:
+* - Single characters: returned as-is
+* - Named keys (ArrowUp, Enter, Tab, etc.): mapped to standard ANSI sequences
+* - Function keys (F1-F12): mapped to VT220/xterm sequences
+* - Ctrl+letter: ASCII control codes 1-26
+* - Ctrl+Enter: newline (\n)
+* - Alt+key: ESC prefix + key
+*/
+function keyToAnsi(key) {
+	const desc = typeof key === "string" ? parseKey(key) : key;
+	const { key: mainKey, ctrl, alt, shift } = desc;
+	const hasSuperOrMeta = desc.super;
+	if (ctrl && mainKey.length === 1) {
+		const code = mainKey.toLowerCase().charCodeAt(0) - 96;
+		if (code >= 1 && code <= 26) return String.fromCharCode(code);
+	}
+	if (ctrl && mainKey === "Enter") return "\n";
+	if ((alt || hasSuperOrMeta) && mainKey.length === 1) return `\x1b${mainKey}`;
+	const fkey = FKEY_MAP[mainKey];
+	if (fkey !== void 0) {
+		if (ctrl || alt || shift || hasSuperOrMeta) {
+			const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0);
+			const fkeyNum = parseInt(mainKey.slice(1));
+			if (fkeyNum <= 4) return `\x1b[${fkeyNum + 10};${mod}~`;
+			const match = fkey.match(/\x1b\[(\d+)~/);
+			if (match) return `\x1b[${match[1]};${mod}~`;
+		}
+		return fkey;
+	}
+	const mapped = KEY_MAP[mainKey];
+	if (mapped !== void 0) {
+		if (mapped === null) return "";
+		if ((ctrl || alt || shift || hasSuperOrMeta) && mapped.startsWith("\x1B[")) {
+			const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0);
+			const letterMatch = mapped.match(/\x1b\[([A-H])$/);
+			if (letterMatch) return `\x1b[1;${mod}${letterMatch[1]}`;
+			const tildeMatch = mapped.match(/\x1b\[(\d+)~$/);
+			if (tildeMatch) return `\x1b[${tildeMatch[1]};${mod}~`;
+		}
+		if (shift && mainKey === "Tab") return "\x1B[Z";
+		return mapped;
+	}
+	if (mainKey.length === 1) {
+		if (shift && mainKey.match(/[a-z]/)) return mainKey.toUpperCase();
+		return mainKey;
+	}
+	return mainKey;
+}
+var KEY_MAP, FKEY_MAP, MODIFIER_ALIASES;
+var init_key_mapping = __esmMin((() => {
+	KEY_MAP = {
+		ArrowUp: "\x1B[A",
+		ArrowDown: "\x1B[B",
+		ArrowLeft: "\x1B[D",
+		ArrowRight: "\x1B[C",
+		Home: "\x1B[H",
+		End: "\x1B[F",
+		PageUp: "\x1B[5~",
+		PageDown: "\x1B[6~",
+		Enter: "\r",
+		Tab: "	",
+		Backspace: "",
+		Delete: "\x1B[3~",
+		Escape: "\x1B",
+		Space: " ",
+		Control: null,
+		Shift: null,
+		Alt: null,
+		Meta: null
+	};
+	FKEY_MAP = {
+		F1: "\x1BOP",
+		F2: "\x1BOQ",
+		F3: "\x1BOR",
+		F4: "\x1BOS",
+		F5: "\x1B[15~",
+		F6: "\x1B[17~",
+		F7: "\x1B[18~",
+		F8: "\x1B[19~",
+		F9: "\x1B[20~",
+		F10: "\x1B[21~",
+		F11: "\x1B[23~",
+		F12: "\x1B[24~"
+	};
+	MODIFIER_ALIASES = {
+		ctrl: "ctrl",
+		control: "ctrl",
+		shift: "shift",
+		alt: "alt",
+		meta: "super",
+		cmd: "super",
+		option: "alt",
+		super: "super"
+	};
+}));
+//#endregion
+export { keyToAnsi as n, parseKey as r, init_key_mapping as t };
+
+//# sourceMappingURL=key-mapping-DsyfLEdC.mjs.map

package/dist/key-mapping-DsyfLEdC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-mapping-DsyfLEdC.mjs","names":[],"sources":["../../termless/src/key-mapping.ts"],"sourcesContent":["/**\n * Key parsing and ANSI encoding for termless.\n *\n * Converts human-readable key descriptions (e.g., \"Ctrl+a\", \"ArrowUp\", \"F5\")\n * into KeyDescriptor objects and ANSI escape sequences suitable for PTY input.\n */\n\nimport type { KeyDescriptor } from \"./types.ts\"\n\n// ── Named key → ANSI sequence map ──\n\nconst KEY_MAP: Record<string, string | null> = {\n  ArrowUp: \"\\x1b[A\",\n  ArrowDown: \"\\x1b[B\",\n  ArrowLeft: \"\\x1b[D\",\n  ArrowRight: \"\\x1b[C\",\n  Home: \"\\x1b[H\",\n  End: \"\\x1b[F\",\n  PageUp: \"\\x1b[5~\",\n  PageDown: \"\\x1b[6~\",\n  Enter: \"\\r\",\n  Tab: \"\\t\",\n  Backspace: \"\\x7f\",\n  Delete: \"\\x1b[3~\",\n  Escape: \"\\x1b\",\n  Space: \" \",\n  // Pure modifier keys produce no output on their own\n  Control: null,\n  Shift: null,\n  Alt: null,\n  Meta: null,\n}\n\n// ── Function keys F1-F12 ──\n\nconst FKEY_MAP: Record<string, string> = {\n  F1: \"\\x1bOP\",\n  F2: \"\\x1bOQ\",\n  F3: \"\\x1bOR\",\n  F4: \"\\x1bOS\",\n  F5: \"\\x1b[15~\",\n  F6: \"\\x1b[17~\",\n  F7: \"\\x1b[18~\",\n  F8: \"\\x1b[19~\",\n  F9: \"\\x1b[20~\",\n  F10: \"\\x1b[21~\",\n  F11: \"\\x1b[23~\",\n  F12: \"\\x1b[24~\",\n}\n\n// ── Modifier aliases ──\n\nconst MODIFIER_ALIASES: Record<string, string> = {\n  ctrl: \"ctrl\",\n  control: \"ctrl\",\n  shift: \"shift\",\n  alt: \"alt\",\n  meta: \"super\",\n  cmd: \"super\",\n  option: \"alt\",\n  super: \"super\",\n}\n\nfunction normalizeModifier(mod: string): string {\n  return MODIFIER_ALIASES[mod.toLowerCase()] ?? mod.toLowerCase()\n}\n\n/**\n * Parse a key string like \"Ctrl+a\", \"ArrowUp\", \"Shift+Tab\" into a KeyDescriptor.\n *\n * Supports modifier prefixes: Ctrl, Control, Alt, Shift, Meta, Cmd, Option, Super.\n * Modifiers are case-insensitive and separated by \"+\".\n */\nexport function parseKey(key: string): KeyDescriptor {\n  const parts = key.split(\"+\")\n  const mainKey = parts.pop()!\n  const result: KeyDescriptor = { key: mainKey }\n\n  for (const part of parts) {\n    const normalized = normalizeModifier(part)\n    switch (normalized) {\n      case \"ctrl\":\n        result.ctrl = true\n        break\n      case \"shift\":\n        result.shift = true\n        break\n      case \"alt\":\n        result.alt = true\n        break\n      case \"super\":\n        result.super = true\n        break\n    }\n  }\n\n  return result\n}\n\n/**\n * Convert a key descriptor or key string to its ANSI escape sequence.\n *\n * Handles:\n * - Single characters: returned as-is\n * - Named keys (ArrowUp, Enter, Tab, etc.): mapped to standard ANSI sequences\n * - Function keys (F1-F12): mapped to VT220/xterm sequences\n * - Ctrl+letter: ASCII control codes 1-26\n * - Ctrl+Enter: newline (\\n)\n * - Alt+key: ESC prefix + key\n */\nexport function keyToAnsi(key: KeyDescriptor | string): string {\n  const desc = typeof key === \"string\" ? parseKey(key) : key\n  const { key: mainKey, ctrl, alt, shift } = desc\n  const hasSuperOrMeta = desc.super\n\n  // Ctrl+letter -> control code (ASCII 1-26)\n  if (ctrl && mainKey.length === 1) {\n    const code = mainKey.toLowerCase().charCodeAt(0) - 96\n    if (code >= 1 && code <= 26) return String.fromCharCode(code)\n  }\n\n  // Ctrl+Enter -> \\n (legacy terminal convention: \\r = Enter, \\n = Ctrl+Enter/Ctrl+J)\n  if (ctrl && mainKey === \"Enter\") {\n    return \"\\n\"\n  }\n\n  // Alt (or Super/Meta) + single character -> ESC prefix\n  if ((alt || hasSuperOrMeta) && mainKey.length === 1) {\n    return `\\x1b${mainKey}`\n  }\n\n  // Function keys\n  const fkey = FKEY_MAP[mainKey]\n  if (fkey !== undefined) {\n    // With modifiers, use CSI sequences with modifier parameter\n    if (ctrl || alt || shift || hasSuperOrMeta) {\n      const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0)\n      // F1-F4 use SS3 format, convert to CSI for modified keys\n      const fkeyNum = parseInt(mainKey.slice(1))\n      if (fkeyNum <= 4) {\n        // F1=11, F2=12, F3=13, F4=14 in CSI ~ format\n        const csiNum = fkeyNum + 10\n        return `\\x1b[${csiNum};${mod}~`\n      }\n      // F5-F12 already use CSI ~ format: extract the number\n      const match = fkey.match(/\\x1b\\[(\\d+)~/)\n      if (match) {\n        return `\\x1b[${match[1]};${mod}~`\n      }\n    }\n    return fkey\n  }\n\n  // Named keys from KEY_MAP\n  const mapped = KEY_MAP[mainKey]\n  if (mapped !== undefined) {\n    if (mapped === null) return \"\" // Pure modifier keys produce nothing\n\n    // Arrow/navigation keys with modifiers use CSI 1;mod format\n    if ((ctrl || alt || shift || hasSuperOrMeta) && mapped.startsWith(\"\\x1b[\")) {\n      const mod = 1 + (shift ? 1 : 0) + (alt ? 2 : 0) + (ctrl ? 4 : 0) + (hasSuperOrMeta ? 8 : 0)\n      // CSI letter format (e.g., \\x1b[A) -> CSI 1;mod letter\n      const letterMatch = mapped.match(/\\x1b\\[([A-H])$/)\n      if (letterMatch) {\n        return `\\x1b[1;${mod}${letterMatch[1]}`\n      }\n      // CSI num ~ format (e.g., \\x1b[5~) -> CSI num;mod ~\n      const tildeMatch = mapped.match(/\\x1b\\[(\\d+)~$/)\n      if (tildeMatch) {\n        return `\\x1b[${tildeMatch[1]};${mod}~`\n      }\n    }\n\n    // Shift+Tab -> reverse tab (CSI Z)\n    if (shift && mainKey === \"Tab\") {\n      return \"\\x1b[Z\"\n    }\n\n    return mapped\n  }\n\n  // Single character without modifiers\n  if (mainKey.length === 1) {\n    // Shift+letter -> uppercase (passthrough for terminals)\n    if (shift && mainKey.match(/[a-z]/)) {\n      return mainKey.toUpperCase()\n    }\n    return mainKey\n  }\n\n  // Unknown key: return as-is\n  return mainKey\n}\n"],"mappings":";;AA+DA,SAAS,kBAAkB,KAAqB;AAC9C,QAAO,iBAAiB,IAAI,aAAa,KAAK,IAAI,aAAa;;;;;;;;AASjE,SAAgB,SAAS,KAA4B;CACnD,MAAM,QAAQ,IAAI,MAAM,IAAI;CAE5B,MAAM,SAAwB,EAAE,KADhB,MAAM,KAAK,EACmB;AAE9C,MAAK,MAAM,QAAQ,MAEjB,SADmB,kBAAkB,KAAK,EAC1C;EACE,KAAK;AACH,UAAO,OAAO;AACd;EACF,KAAK;AACH,UAAO,QAAQ;AACf;EACF,KAAK;AACH,UAAO,MAAM;AACb;EACF,KAAK;AACH,UAAO,QAAQ;AACf;;AAIN,QAAO;;;;;;;;;;;;;AAcT,SAAgB,UAAU,KAAqC;CAC7D,MAAM,OAAO,OAAO,QAAQ,WAAW,SAAS,IAAI,GAAG;CACvD,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,UAAU;CAC3C,MAAM,iBAAiB,KAAK;AAG5B,KAAI,QAAQ,QAAQ,WAAW,GAAG;EAChC,MAAM,OAAO,QAAQ,aAAa,CAAC,WAAW,EAAE,GAAG;AACnD,MAAI,QAAQ,KAAK,QAAQ,GAAI,QAAO,OAAO,aAAa,KAAK;;AAI/D,KAAI,QAAQ,YAAY,QACtB,QAAO;AAIT,MAAK,OAAO,mBAAmB,QAAQ,WAAW,EAChD,QAAO,OAAO;CAIhB,MAAM,OAAO,SAAS;AACtB,KAAI,SAAS,KAAA,GAAW;AAEtB,MAAI,QAAQ,OAAO,SAAS,gBAAgB;GAC1C,MAAM,MAAM,KAAK,QAAQ,IAAI,MAAM,MAAM,IAAI,MAAM,OAAO,IAAI,MAAM,iBAAiB,IAAI;GAEzF,MAAM,UAAU,SAAS,QAAQ,MAAM,EAAE,CAAC;AAC1C,OAAI,WAAW,EAGb,QAAO,QADQ,UAAU,GACH,GAAG,IAAI;GAG/B,MAAM,QAAQ,KAAK,MAAM,eAAe;AACxC,OAAI,MACF,QAAO,QAAQ,MAAM,GAAG,GAAG,IAAI;;AAGnC,SAAO;;CAIT,MAAM,SAAS,QAAQ;AACvB,KAAI,WAAW,KAAA,GAAW;AACxB,MAAI,WAAW,KAAM,QAAO;AAG5B,OAAK,QAAQ,OAAO,SAAS,mBAAmB,OAAO,WAAW,QAAQ,EAAE;GAC1E,MAAM,MAAM,KAAK,QAAQ,IAAI,MAAM,MAAM,IAAI,MAAM,OAAO,IAAI,MAAM,iBAAiB,IAAI;GAEzF,MAAM,cAAc,OAAO,MAAM,iBAAiB;AAClD,OAAI,YACF,QAAO,UAAU,MAAM,YAAY;GAGrC,MAAM,aAAa,OAAO,MAAM,gBAAgB;AAChD,OAAI,WACF,QAAO,QAAQ,WAAW,GAAG,GAAG,IAAI;;AAKxC,MAAI,SAAS,YAAY,MACvB,QAAO;AAGT,SAAO;;AAIT,KAAI,QAAQ,WAAW,GAAG;AAExB,MAAI,SAAS,QAAQ,MAAM,QAAQ,CACjC,QAAO,QAAQ,aAAa;AAE9B,SAAO;;AAIT,QAAO;;;;AApLH,WAAyC;EAC7C,SAAS;EACT,WAAW;EACX,WAAW;EACX,YAAY;EACZ,MAAM;EACN,KAAK;EACL,QAAQ;EACR,UAAU;EACV,OAAO;EACP,KAAK;EACL,WAAW;EACX,QAAQ;EACR,QAAQ;EACR,OAAO;EAEP,SAAS;EACT,OAAO;EACP,KAAK;EACL,MAAM;EACP;AAIK,YAAmC;EACvC,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,KAAK;EACL,KAAK;EACL,KAAK;EACN;AAIK,oBAA2C;EAC/C,MAAM;EACN,SAAS;EACT,OAAO;EACP,KAAK;EACL,MAAM;EACN,KAAK;EACL,QAAQ;EACR,OAAO;EACR"}

package/dist/layout-engine-B3dsnVLU.mjs

@@ -0,0 +1,50 @@
+//#region packages/ag-term/src/layout-engine.ts
+let layoutEngine = null;
+/**
+* Set the global layout engine instance.
+* Must be called before rendering.
+*/
+function setLayoutEngine(engine) {
+	layoutEngine = engine;
+}
+/**
+* Get the global layout engine instance.
+* Throws if not initialized.
+*/
+function getLayoutEngine() {
+	if (!layoutEngine) throw new Error("Layout engine not initialized. Call setLayoutEngine() or initYoga()/initFlexily() first.");
+	return layoutEngine;
+}
+/**
+* Check if a layout engine is initialized.
+*/
+function isLayoutEngineInitialized() {
+	return layoutEngine !== null;
+}
+/**
+* Get the layout constants from the current engine.
+* Convenience function for accessing constants.
+*/
+function getConstants() {
+	return getLayoutEngine().constants;
+}
+/**
+* Initialize the layout engine if not already set.
+*
+* @param engineType - 'flexily', 'flexily-classic', or 'yoga'. If not provided, checks
+*                     SILVERY_ENGINE env var, then defaults to 'flexily'.
+*/
+async function ensureDefaultLayoutEngine(engineType) {
+	if (isLayoutEngineInitialized()) return;
+	if ((engineType ?? process.env.SILVERY_ENGINE?.toLowerCase() ?? "flexily") === "yoga") {
+		const { initYogaEngine } = await import("./yoga-adapter-Daq6-dw1.mjs");
+		setLayoutEngine(await initYogaEngine());
+	} else {
+		const { createFlexilyZeroEngine } = await import("./flexily-zero-adapter-GHwEW11s.mjs");
+		setLayoutEngine(createFlexilyZeroEngine());
+	}
+}
+//#endregion
+export { setLayoutEngine as a, isLayoutEngineInitialized as i, getConstants as n, getLayoutEngine as r, ensureDefaultLayoutEngine as t };
+
+//# sourceMappingURL=layout-engine-B3dsnVLU.mjs.map

package/dist/layout-engine-B3dsnVLU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-engine-B3dsnVLU.mjs","names":[],"sources":["../packages/ag-term/src/layout-engine.ts"],"sourcesContent":["/**\n * Layout Engine Abstraction\n *\n * Provides a pluggable interface for layout engines (Yoga, Flexily, etc.)\n * This allows silvery to use different layout backends without code changes.\n *\n * Core type interfaces (LayoutNode, MeasureFunc, MeasureMode) live in\n * @silvery/ag/layout-types. This file contains the runtime engine management.\n */\n\nimport type { LayoutNode } from \"@silvery/ag/layout-types\"\n\n// ============================================================================\n// Branded Types for Type Safety\n// ============================================================================\n\n/**\n * Branded types prevent accidentally mixing up layout constant categories.\n * E.g., you can't pass an AlignValue where a FlexDirectionValue is expected.\n */\nexport type FlexDirectionValue = number & { readonly __brand: \"FlexDirection\" }\nexport type WrapValue = number & { readonly __brand: \"Wrap\" }\nexport type AlignValue = number & { readonly __brand: \"Align\" }\nexport type JustifyValue = number & { readonly __brand: \"Justify\" }\nexport type EdgeValue = number & { readonly __brand: \"Edge\" }\nexport type GutterValue = number & { readonly __brand: \"Gutter\" }\nexport type DisplayValue = number & { readonly __brand: \"Display\" }\nexport type PositionTypeValue = number & { readonly __brand: \"PositionType\" }\nexport type OverflowValue = number & { readonly __brand: \"Overflow\" }\nexport type DirectionValue = number & { readonly __brand: \"Direction\" }\nexport type MeasureModeValue = number & { readonly __brand: \"MeasureMode\" }\n\n// ============================================================================\n// Layout Constants Interface\n// ============================================================================\n\n/**\n * Constants for layout configuration.\n * These are the same across Yoga and Flexily.\n * Uses branded types for compile-time safety.\n */\nexport interface LayoutConstants {\n  // Flex Direction\n  FLEX_DIRECTION_COLUMN: FlexDirectionValue\n  FLEX_DIRECTION_COLUMN_REVERSE: FlexDirectionValue\n  FLEX_DIRECTION_ROW: FlexDirectionValue\n  FLEX_DIRECTION_ROW_REVERSE: FlexDirectionValue\n\n  // Wrap\n  WRAP_NO_WRAP: WrapValue\n  WRAP_WRAP: WrapValue\n  WRAP_WRAP_REVERSE: WrapValue\n\n  // Align\n  ALIGN_AUTO: AlignValue\n  ALIGN_FLEX_START: AlignValue\n  ALIGN_CENTER: AlignValue\n  ALIGN_FLEX_END: AlignValue\n  ALIGN_STRETCH: AlignValue\n  ALIGN_BASELINE: AlignValue\n  ALIGN_SPACE_BETWEEN: AlignValue\n  ALIGN_SPACE_AROUND: AlignValue\n  ALIGN_SPACE_EVENLY: AlignValue\n\n  // Justify\n  JUSTIFY_FLEX_START: JustifyValue\n  JUSTIFY_CENTER: JustifyValue\n  JUSTIFY_FLEX_END: JustifyValue\n  JUSTIFY_SPACE_BETWEEN: JustifyValue\n  JUSTIFY_SPACE_AROUND: JustifyValue\n  JUSTIFY_SPACE_EVENLY: JustifyValue\n\n  // Edge\n  EDGE_LEFT: EdgeValue\n  EDGE_TOP: EdgeValue\n  EDGE_RIGHT: EdgeValue\n  EDGE_BOTTOM: EdgeValue\n  EDGE_HORIZONTAL: EdgeValue\n  EDGE_VERTICAL: EdgeValue\n  EDGE_ALL: EdgeValue\n\n  // Gutter\n  GUTTER_COLUMN: GutterValue\n  GUTTER_ROW: GutterValue\n  GUTTER_ALL: GutterValue\n\n  // Display\n  DISPLAY_FLEX: DisplayValue\n  DISPLAY_NONE: DisplayValue\n\n  // Position Type\n  POSITION_TYPE_STATIC: PositionTypeValue\n  POSITION_TYPE_RELATIVE: PositionTypeValue\n  POSITION_TYPE_ABSOLUTE: PositionTypeValue\n\n  // Overflow\n  OVERFLOW_VISIBLE: OverflowValue\n  OVERFLOW_HIDDEN: OverflowValue\n  OVERFLOW_SCROLL: OverflowValue\n\n  // Direction\n  DIRECTION_LTR: DirectionValue\n\n  // Measure Mode\n  MEASURE_MODE_UNDEFINED: MeasureModeValue\n  MEASURE_MODE_EXACTLY: MeasureModeValue\n  MEASURE_MODE_AT_MOST: MeasureModeValue\n}\n\n// ============================================================================\n// Layout Engine Interface\n// ============================================================================\n\n/**\n * Abstract layout engine interface.\n * Implementations can wrap Yoga, Flexily, or other layout engines.\n */\nexport interface LayoutEngine {\n  /** Create a new layout node */\n  createNode(): LayoutNode\n\n  /** Layout constants for this engine */\n  readonly constants: LayoutConstants\n\n  /** Engine name for debugging */\n  readonly name: string\n}\n\n// ============================================================================\n// Global Layout Engine Management\n// ============================================================================\n\nlet layoutEngine: LayoutEngine | null = null\n\n/**\n * Set the global layout engine instance.\n * Must be called before rendering.\n */\nexport function setLayoutEngine(engine: LayoutEngine): void {\n  layoutEngine = engine\n}\n\n/**\n * Get the global layout engine instance.\n * Throws if not initialized.\n */\nexport function getLayoutEngine(): LayoutEngine {\n  if (!layoutEngine) {\n    throw new Error(\"Layout engine not initialized. Call setLayoutEngine() or initYoga()/initFlexily() first.\")\n  }\n  return layoutEngine\n}\n\n/**\n * Check if a layout engine is initialized.\n */\nexport function isLayoutEngineInitialized(): boolean {\n  return layoutEngine !== null\n}\n\n/**\n * Get the layout constants from the current engine.\n * Convenience function for accessing constants.\n */\nexport function getConstants(): LayoutConstants {\n  return getLayoutEngine().constants\n}\n\n// ============================================================================\n// Default Engine Initialization\n// ============================================================================\n\n/**\n * Layout engine type for configuration.\n *\n * - 'flexily': Zero-allocation Flexily (default, optimized for high-frequency layout)\n * - 'flexily-classic': Classic Flexily algorithm (for debugging/compatibility)\n * - 'yoga': Facebook's WASM-based flexbox (most mature)\n */\nexport type LayoutEngineType = \"flexily\" | \"yoga\"\n\n/**\n * Initialize the layout engine if not already set.\n *\n * @param engineType - 'flexily', 'flexily-classic', or 'yoga'. If not provided, checks\n *                     SILVERY_ENGINE env var, then defaults to 'flexily'.\n */\nexport async function ensureDefaultLayoutEngine(engineType?: LayoutEngineType): Promise<void> {\n  if (isLayoutEngineInitialized()) {\n    return\n  }\n\n  // Resolve engine type: option → env → 'flexily'\n  const resolved = engineType ?? (process.env.SILVERY_ENGINE?.toLowerCase() as LayoutEngineType) ?? \"flexily\"\n\n  if (resolved === \"yoga\") {\n    const { initYogaEngine } = await import(\"./adapters/yoga-adapter.js\")\n    setLayoutEngine(await initYogaEngine())\n  } else {\n    // 'flexily' (default) uses zero-allocation engine\n    const { createFlexilyZeroEngine } = await import(\"./adapters/flexily-zero-adapter.js\")\n    setLayoutEngine(createFlexilyZeroEngine())\n  }\n}\n"],"mappings":";AAoIA,IAAI,eAAoC;;;;;AAMxC,SAAgB,gBAAgB,QAA4B;AAC1D,gBAAe;;;;;;AAOjB,SAAgB,kBAAgC;AAC9C,KAAI,CAAC,aACH,OAAM,IAAI,MAAM,2FAA2F;AAE7G,QAAO;;;;;AAMT,SAAgB,4BAAqC;AACnD,QAAO,iBAAiB;;;;;;AAO1B,SAAgB,eAAgC;AAC9C,QAAO,iBAAiB,CAAC;;;;;;;;AAsB3B,eAAsB,0BAA0B,YAA8C;AAC5F,KAAI,2BAA2B,CAC7B;AAMF,MAFiB,cAAe,QAAQ,IAAI,gBAAgB,aAAa,IAAyB,eAEjF,QAAQ;EACvB,MAAM,EAAE,mBAAmB,MAAM,OAAO;AACxC,kBAAgB,MAAM,gBAAgB,CAAC;QAClC;EAEL,MAAM,EAAE,4BAA4B,MAAM,OAAO;AACjD,kBAAgB,yBAAyB,CAAC"}

package/dist/layout-engine-D_lSR4i9.mjs

@@ -0,0 +1,2 @@
+import { t as ensureDefaultLayoutEngine } from "./layout-engine-B3dsnVLU.mjs";
+export { ensureDefaultLayoutEngine };

package/dist/multi-progress-C0-rkn86.d.mts

@@ -0,0 +1,180 @@
+import { g as TaskStatus, t as ProgressBarOptions, u as SpinnerStyle } from "./types-CDgkE-Rw.mjs";
+
+//#region packages/ag-react/src/ui/cli/progress-bar.d.ts
+/**
+ * ProgressBar class for CLI progress indication
+ *
+ * @example
+ * ```ts
+ * const bar = new ProgressBar({ total: 100 });
+ * bar.start();
+ * for (let i = 0; i <= 100; i++) {
+ *   await doWork();
+ *   bar.update(i);
+ * }
+ * bar.stop();
+ * ```
+ */
+declare class ProgressBar {
+  private total;
+  private format;
+  private width;
+  private complete;
+  private incomplete;
+  private stream;
+  private hideCursor;
+  private phases;
+  private current;
+  private phase;
+  private startTime;
+  private isActive;
+  private etaBuffer;
+  constructor(options?: ProgressBarOptions);
+  /**
+   * Start the progress bar
+   */
+  start(initialValue?: number, initialTotal?: number): this;
+  /**
+   * Update progress value
+   */
+  update(value: number, tokens?: Record<string, string | number>): this;
+  /**
+   * Increment progress by amount (default: 1)
+   */
+  increment(amount?: number, tokens?: Record<string, string | number>): this;
+  /**
+   * Set the current phase (for multi-phase progress)
+   */
+  setPhase(phaseName: string, options?: {
+    current?: number;
+    total?: number;
+  }): this;
+  /**
+   * Stop the progress bar
+   */
+  stop(clear?: boolean): this;
+  /** Get ETA in seconds using smoothed rate */
+  private getETASeconds;
+  /**
+   * Render the progress bar
+   */
+  private render;
+  /**
+   * Get current progress ratio (0-1)
+   */
+  get ratio(): number;
+  /**
+   * Get current progress percentage (0-100)
+   */
+  get percentage(): number;
+  /**
+   * Dispose the progress bar (calls stop)
+   */
+  [Symbol.dispose](): void;
+}
+//#endregion
+//#region packages/ag-react/src/ui/cli/multi-progress.d.ts
+/** Task configuration */
+interface TaskConfig {
+  title: string;
+  type: "spinner" | "bar" | "group";
+  status: TaskStatus;
+  total?: number;
+  current?: number;
+  spinnerStyle?: SpinnerStyle;
+  indent?: number;
+}
+/** Internal task state */
+interface TaskState extends TaskConfig {
+  id: string;
+  /** Completion time in ms (shown dimmed after title on completion) */
+  completionTime?: number;
+}
+/**
+ * MultiProgress - Manage multiple concurrent progress indicators
+ *
+ * @example
+ * ```ts
+ * const multi = new MultiProgress();
+ *
+ * const download = multi.add("Downloading files", { type: "bar", total: 100 });
+ * const process = multi.add("Processing", { type: "spinner" });
+ *
+ * download.start();
+ * download.update(50);
+ * download.complete();
+ *
+ * process.start();
+ * process.complete();
+ *
+ * multi.stop();
+ * ```
+ */
+declare class MultiProgress {
+  private tasks;
+  private taskOrder;
+  private stream;
+  private isActive;
+  private timer;
+  private frameIndex;
+  private renderedLines;
+  constructor(stream?: NodeJS.WriteStream);
+  /**
+   * Add a new task
+   * @param insertAfter - ID of task to insert after (for hierarchical display)
+   */
+  add(title: string, options?: {
+    type?: "spinner" | "bar" | "group";
+    total?: number;
+    spinnerStyle?: SpinnerStyle;
+    indent?: number;
+    insertAfter?: string;
+  }): TaskHandle;
+  /**
+   * Start the multi-progress display
+   */
+  start(): this;
+  /**
+   * Dispose the multi-progress display (calls stop)
+   */
+  [Symbol.dispose](): void;
+  /**
+   * Stop the multi-progress display
+   * @param clear - If true, clear all task lines from terminal
+   */
+  stop(clear?: boolean): this;
+  /** @internal Update task state */
+  _updateTask(id: string, updates: Partial<TaskState>): void;
+  /** @internal Get task state */
+  _getTask(id: string): TaskState | undefined;
+  private render;
+}
+/**
+ * Handle for controlling an individual task
+ */
+declare class TaskHandle {
+  private multi;
+  private _id;
+  constructor(multi: MultiProgress, _id: string);
+  /** Get task ID (for insertAfter) */
+  get id(): string;
+  /** Start the task (set status to running) */
+  start(): this;
+  /** Update progress (for bar type) */
+  update(current: number): this;
+  /** Mark task as completed */
+  complete(titleOrTime?: string | number): this;
+  /** Mark task as failed */
+  fail(title?: string): this;
+  /** Mark task as skipped */
+  skip(title?: string): this;
+  /** Update task title */
+  setTitle(title: string): this;
+  /** Change task type (e.g., from spinner to group when sub-steps are added) */
+  setType(type: "spinner" | "bar" | "group"): this;
+  /** Get current status */
+  get status(): TaskStatus;
+}
+//#endregion
+export { TaskHandle as n, ProgressBar as r, MultiProgress as t };
+//# sourceMappingURL=multi-progress-C0-rkn86.d.mts.map

package/dist/multi-progress-C0-rkn86.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-progress-C0-rkn86.d.mts","names":[],"sources":["../packages/ag-react/src/ui/cli/progress-bar.ts","../packages/ag-react/src/ui/cli/multi-progress.ts"],"mappings":";;;;;;;;;;;;;;;;;cA0Ba,WAAA;EAAA,QACH,KAAA;EAAA,QACA,MAAA;EAAA,QACA,KAAA;EAAA,QACA,QAAA;EAAA,QACA,UAAA;EAAA,QACA,MAAA;EAAA,QACA,UAAA;EAAA,QACA,MAAA;EAAA,QAEA,OAAA;EAAA,QACA,KAAA;EAAA,QACA,SAAA;EAAA,QACA,QAAA;EAAA,QAGA,SAAA;cAEI,OAAA,GAAS,kBAAA;EAmCU;;;EArB/B,KAAA,CAAM,YAAA,WAAkB,YAAA;EAyCO;;;EApB/B,MAAA,CAAO,KAAA,UAAe,MAAA,GAAS,MAAA;EA2BS;;;EAPxC,SAAA,CAAU,MAAA,WAAY,MAAA,GAAS,MAAA;EA6B1B;;;EAtBL,QAAA,CAAS,SAAA,UAAmB,OAAA;IAAY,OAAA;IAAkB,KAAA;EAAA;EAgH3C;;;EA1Ff,IAAA,CAAK,KAAA;;UAqBG,aAAA;ECjIU;;;EAAA,QDwIV,MAAA;ECtIR;;;EAAA,IDsLI,KAAA,CAAA;ECnLJ;;;EAAA,ID0LI,UAAA,CAAA;ECxLE;;AAAA;EAAA,CD+LL,MAAA,CAAO,OAAA;AAAA;;;;UCtMA,UAAA;EACR,KAAA;EACA,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,KAAA;EACA,OAAA;EACA,YAAA,GAAe,YAAA;EACf,MAAA;AAAA;;UAIQ,SAAA,SAAkB,UAAA;EAC1B,EAAA;EDAQ;ECER,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;cAuBW,aAAA;EAAA,QACH,KAAA;EAAA,QACA,SAAA;EAAA,QACA,MAAA;EAAA,QACA,QAAA;EAAA,QACA,KAAA;EAAA,QACA,UAAA;EAAA,QACA,aAAA;cAEI,MAAA,GAAQ,MAAA,CAAO,WAAA;EDiJvB;;;;ECzIJ,GAAA,CACE,KAAA,UACA,OAAA;IACE,IAAA;IACA,KAAA;IACA,YAAA,GAAe,YAAA;IACf,MAAA;IACA,WAAA;EAAA,IAED,UAAA;EAzDwB;;;EA+F3B,KAAA,CAAA;EAlGQ;;;EAAA,CA2HP,MAAA,CAAO,OAAA;EAxHO;;;;EAgIf,IAAA,CAAK,KAAA;EA3Ha;EA8JlB,WAAA,CAAY,EAAA,UAAY,OAAA,EAAS,OAAA,CAAQ,SAAA;EA9JL;EA2KpC,QAAA,CAAS,EAAA,WAAa,SAAA;EAAA,QAId,MAAA;AAAA;;;AArJV;cAmNM,UAAA;EAAA,QAEM,KAAA;EAAA,QACA,GAAA;cADA,KAAA,EAAO,aAAA,EACP,GAAA;EA5LP;EAAA,IAgMC,EAAA,CAAA;EAtFqC;EA2FzC,KAAA,CAAA;EA9EsB;EAoFtB,MAAA,CAAO,OAAA;EApFwB;EA0F/B,QAAA,CAAS,WAAA;EAzOD;EAuPR,IAAA,CAAK,KAAA;EArPG;EA6PR,IAAA,CAAK,KAAA;EA3PG;EAmQR,QAAA,CAAS,KAAA;;EAMT,OAAA,CAAQ,IAAA;EAtQmB;EAAA,IA4QvB,MAAA,CAAA,GAAU,UAAA;AAAA"}

package/dist/multi-progress-CQVB9lES.mjs

@@ -0,0 +1,219 @@
+import { a as chalk, t as SPINNER_FRAMES } from "./spinner-DSByknyx.mjs";
+import { f as isTTY, i as CURSOR_HIDE, m as write, s as CURSOR_SHOW, t as CLEAR_LINE, u as cursorUp } from "./ansi-CXLE_pt1.mjs";
+//#region packages/ag-react/src/ui/cli/multi-progress.ts
+/**
+* MultiProgress - Container for managing multiple concurrent progress indicators
+*/
+/** Status icons */
+const STATUS_ICONS = {
+	pending: chalk.gray("○"),
+	running: "",
+	completed: chalk.green("✔"),
+	failed: chalk.red("✖"),
+	skipped: chalk.yellow("⊘")
+};
+/**
+* MultiProgress - Manage multiple concurrent progress indicators
+*
+* @example
+* ```ts
+* const multi = new MultiProgress();
+*
+* const download = multi.add("Downloading files", { type: "bar", total: 100 });
+* const process = multi.add("Processing", { type: "spinner" });
+*
+* download.start();
+* download.update(50);
+* download.complete();
+*
+* process.start();
+* process.complete();
+*
+* multi.stop();
+* ```
+*/
+var MultiProgress = class {
+	tasks = /* @__PURE__ */ new Map();
+	taskOrder = [];
+	stream;
+	isActive = false;
+	timer = null;
+	frameIndex = 0;
+	renderedLines = 0;
+	constructor(stream = process.stdout) {
+		this.stream = stream;
+	}
+	/**
+	* Add a new task
+	* @param insertAfter - ID of task to insert after (for hierarchical display)
+	*/
+	add(title, options = {}) {
+		const id = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+		const task = {
+			id,
+			title,
+			type: options.type ?? "spinner",
+			status: "pending",
+			total: options.total,
+			current: 0,
+			spinnerStyle: options.spinnerStyle ?? "dots",
+			indent: options.indent ?? 0
+		};
+		this.tasks.set(id, task);
+		if (options.insertAfter) {
+			const afterIndex = this.taskOrder.indexOf(options.insertAfter);
+			if (afterIndex >= 0) this.taskOrder.splice(afterIndex + 1, 0, id);
+			else this.taskOrder.push(id);
+		} else this.taskOrder.push(id);
+		if (this.isActive) this.render();
+		return new TaskHandle(this, id);
+	}
+	/**
+	* Start the multi-progress display
+	*/
+	start() {
+		if (this.isActive) return this;
+		this.isActive = true;
+		if (isTTY(this.stream)) write(CURSOR_HIDE, this.stream);
+		this.render();
+		this.timer = setInterval(() => {
+			this.frameIndex = (this.frameIndex + 1) % 10;
+			this.render();
+		}, 80);
+		return this;
+	}
+	/**
+	* Dispose the multi-progress display (calls stop)
+	*/
+	[Symbol.dispose]() {
+		this.stop();
+	}
+	/**
+	* Stop the multi-progress display
+	* @param clear - If true, clear all task lines from terminal
+	*/
+	stop(clear = false) {
+		if (!this.isActive) return this;
+		this.isActive = false;
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = null;
+		}
+		if (clear && isTTY(this.stream)) {
+			if (this.renderedLines > 0) {
+				write(cursorUp(this.renderedLines), this.stream);
+				for (let i = 0; i < this.renderedLines; i++) write(`${CLEAR_LINE}\n`, this.stream);
+				write(cursorUp(this.renderedLines), this.stream);
+			}
+		} else {
+			this.render();
+			write("\n", this.stream);
+		}
+		if (isTTY(this.stream)) write(CURSOR_SHOW, this.stream);
+		return this;
+	}
+	/** @internal Update task state */
+	_updateTask(id, updates) {
+		const task = this.tasks.get(id);
+		if (task) {
+			Object.assign(task, updates);
+			if (this.isActive && updates.status) this.render();
+		}
+	}
+	/** @internal Get task state */
+	_getTask(id) {
+		return this.tasks.get(id);
+	}
+	render() {
+		if (!isTTY(this.stream)) return;
+		if (this.renderedLines > 0) write(cursorUp(this.renderedLines), this.stream);
+		const lines = [];
+		for (const id of this.taskOrder) {
+			const task = this.tasks.get(id);
+			if (!task) continue;
+			let icon;
+			if (task.status === "running") if (task.type === "group") icon = STATUS_ICONS.pending;
+			else {
+				const frames = SPINNER_FRAMES[task.spinnerStyle ?? "dots"];
+				icon = chalk.cyan(frames[this.frameIndex % frames.length]);
+			}
+			else icon = STATUS_ICONS[task.status];
+			let line = `${"  ".repeat(task.indent ?? 0)}${icon} ${task.title}`;
+			if (task.type === "bar" && task.total && task.total > 0) {
+				const percent = task.current / task.total;
+				const barWidth = 20;
+				const filled = Math.round(barWidth * percent);
+				const empty = barWidth - filled;
+				const bar = chalk.cyan("█".repeat(filled)) + chalk.gray("░".repeat(empty));
+				line += ` ${bar} ${Math.round(percent * 100)}%`;
+			}
+			if (task.status === "completed" && task.completionTime !== void 0) line += chalk.dim(` ${task.completionTime}ms`);
+			lines.push(line);
+		}
+		for (const line of lines) write(`${CLEAR_LINE}${line}\n`, this.stream);
+		this.renderedLines = lines.length;
+	}
+};
+/**
+* Handle for controlling an individual task
+*/
+var TaskHandle = class {
+	constructor(multi, _id) {
+		this.multi = multi;
+		this._id = _id;
+	}
+	/** Get task ID (for insertAfter) */
+	get id() {
+		return this._id;
+	}
+	/** Start the task (set status to running) */
+	start() {
+		this.multi._updateTask(this._id, { status: "running" });
+		return this;
+	}
+	/** Update progress (for bar type) */
+	update(current) {
+		this.multi._updateTask(this._id, { current });
+		return this;
+	}
+	/** Mark task as completed */
+	complete(titleOrTime) {
+		const updates = { status: "completed" };
+		if (typeof titleOrTime === "number") updates.completionTime = titleOrTime;
+		else if (titleOrTime) updates.title = titleOrTime;
+		this.multi._updateTask(this._id, updates);
+		return this;
+	}
+	/** Mark task as failed */
+	fail(title) {
+		const updates = { status: "failed" };
+		if (title) updates.title = title;
+		this.multi._updateTask(this._id, updates);
+		return this;
+	}
+	/** Mark task as skipped */
+	skip(title) {
+		const updates = { status: "skipped" };
+		if (title) updates.title = title;
+		this.multi._updateTask(this._id, updates);
+		return this;
+	}
+	/** Update task title */
+	setTitle(title) {
+		this.multi._updateTask(this._id, { title });
+		return this;
+	}
+	/** Change task type (e.g., from spinner to group when sub-steps are added) */
+	setType(type) {
+		this.multi._updateTask(this._id, { type });
+		return this;
+	}
+	/** Get current status */
+	get status() {
+		return this.multi._getTask(this._id)?.status ?? "pending";
+	}
+};
+//#endregion
+export { MultiProgress as t };
+
+//# sourceMappingURL=multi-progress-CQVB9lES.mjs.map

package/dist/multi-progress-CQVB9lES.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-progress-CQVB9lES.mjs","names":[],"sources":["../packages/ag-react/src/ui/cli/multi-progress.ts"],"sourcesContent":["/**\n * MultiProgress - Container for managing multiple concurrent progress indicators\n */\n\nimport chalk from \"@silvery/ink/chalk\"\nimport type { SpinnerStyle, TaskStatus } from \"../types.js\"\nimport { CURSOR_HIDE, CURSOR_SHOW, CLEAR_LINE, cursorUp, write, isTTY } from \"./ansi\"\nimport { Spinner, SPINNER_FRAMES } from \"./spinner\"\nimport { ProgressBar } from \"./progress-bar\"\n\n/** Status icons */\nconst STATUS_ICONS: Record<TaskStatus, string> = {\n  pending: chalk.gray(\"○\"),\n  running: \"\", // Will be replaced with spinner frame\n  completed: chalk.green(\"✔\"),\n  failed: chalk.red(\"✖\"),\n  skipped: chalk.yellow(\"⊘\"),\n}\n\n/** Task configuration */\ninterface TaskConfig {\n  title: string\n  type: \"spinner\" | \"bar\" | \"group\"\n  status: TaskStatus\n  total?: number\n  current?: number\n  spinnerStyle?: SpinnerStyle\n  indent?: number\n}\n\n/** Internal task state */\ninterface TaskState extends TaskConfig {\n  id: string\n  /** Completion time in ms (shown dimmed after title on completion) */\n  completionTime?: number\n}\n\n/**\n * MultiProgress - Manage multiple concurrent progress indicators\n *\n * @example\n * ```ts\n * const multi = new MultiProgress();\n *\n * const download = multi.add(\"Downloading files\", { type: \"bar\", total: 100 });\n * const process = multi.add(\"Processing\", { type: \"spinner\" });\n *\n * download.start();\n * download.update(50);\n * download.complete();\n *\n * process.start();\n * process.complete();\n *\n * multi.stop();\n * ```\n */\nexport class MultiProgress {\n  private tasks: Map<string, TaskState> = new Map()\n  private taskOrder: string[] = []\n  private stream: NodeJS.WriteStream\n  private isActive = false\n  private timer: ReturnType<typeof setInterval> | null = null\n  private frameIndex = 0\n  private renderedLines = 0\n\n  constructor(stream: NodeJS.WriteStream = process.stdout) {\n    this.stream = stream\n  }\n\n  /**\n   * Add a new task\n   * @param insertAfter - ID of task to insert after (for hierarchical display)\n   */\n  add(\n    title: string,\n    options: {\n      type?: \"spinner\" | \"bar\" | \"group\"\n      total?: number\n      spinnerStyle?: SpinnerStyle\n      indent?: number\n      insertAfter?: string\n    } = {},\n  ): TaskHandle {\n    const id = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n\n    const task: TaskState = {\n      id,\n      title,\n      type: options.type ?? \"spinner\",\n      status: \"pending\",\n      total: options.total,\n      current: 0,\n      spinnerStyle: options.spinnerStyle ?? \"dots\",\n      indent: options.indent ?? 0,\n    }\n\n    this.tasks.set(id, task)\n\n    // Insert after specified task, or append to end\n    if (options.insertAfter) {\n      const afterIndex = this.taskOrder.indexOf(options.insertAfter)\n      if (afterIndex >= 0) {\n        this.taskOrder.splice(afterIndex + 1, 0, id)\n      } else {\n        this.taskOrder.push(id)\n      }\n    } else {\n      this.taskOrder.push(id)\n    }\n\n    if (this.isActive) {\n      this.render()\n    }\n\n    return new TaskHandle(this, id)\n  }\n\n  /**\n   * Start the multi-progress display\n   */\n  start(): this {\n    if (this.isActive) {\n      return this\n    }\n\n    this.isActive = true\n\n    if (isTTY(this.stream)) {\n      write(CURSOR_HIDE, this.stream)\n    }\n\n    this.render()\n\n    // Start animation timer\n    this.timer = setInterval(() => {\n      this.frameIndex = (this.frameIndex + 1) % 10\n      this.render()\n    }, 80)\n\n    return this\n  }\n\n  /**\n   * Dispose the multi-progress display (calls stop)\n   */\n  [Symbol.dispose](): void {\n    this.stop()\n  }\n\n  /**\n   * Stop the multi-progress display\n   * @param clear - If true, clear all task lines from terminal\n   */\n  stop(clear = false): this {\n    if (!this.isActive) {\n      return this\n    }\n\n    this.isActive = false\n\n    if (this.timer) {\n      clearInterval(this.timer)\n      this.timer = null\n    }\n\n    if (clear && isTTY(this.stream)) {\n      // Clear all rendered lines\n      if (this.renderedLines > 0) {\n        write(cursorUp(this.renderedLines), this.stream)\n        for (let i = 0; i < this.renderedLines; i++) {\n          write(`${CLEAR_LINE}\\n`, this.stream)\n        }\n        write(cursorUp(this.renderedLines), this.stream)\n      }\n    } else {\n      // Final render\n      this.render()\n      write(\"\\n\", this.stream)\n    }\n\n    if (isTTY(this.stream)) {\n      write(CURSOR_SHOW, this.stream)\n    }\n\n    return this\n  }\n\n  /** @internal Update task state */\n  _updateTask(id: string, updates: Partial<TaskState>): void {\n    const task = this.tasks.get(id)\n    if (task) {\n      Object.assign(task, updates)\n      // Only render immediately for status changes (complete/fail/etc.)\n      // Progress updates (current/total) are debounced by the 80ms animation timer\n      if (this.isActive && updates.status) {\n        this.render()\n      }\n    }\n  }\n\n  /** @internal Get task state */\n  _getTask(id: string): TaskState | undefined {\n    return this.tasks.get(id)\n  }\n\n  private render(): void {\n    if (!isTTY(this.stream)) {\n      return\n    }\n\n    // Move cursor up to clear previous render\n    if (this.renderedLines > 0) {\n      write(cursorUp(this.renderedLines), this.stream)\n    }\n\n    const lines: string[] = []\n\n    for (const id of this.taskOrder) {\n      const task = this.tasks.get(id)\n      if (!task) continue\n\n      let icon: string\n      if (task.status === \"running\") {\n        if (task.type === \"group\") {\n          // Groups don't animate - keep pending icon while running\n          icon = STATUS_ICONS.pending\n        } else {\n          const frames = SPINNER_FRAMES[task.spinnerStyle ?? \"dots\"]\n          icon = chalk.cyan(frames[this.frameIndex % frames.length])\n        }\n      } else {\n        icon = STATUS_ICONS[task.status]\n      }\n\n      const indent = \"  \".repeat(task.indent ?? 0)\n      let line = `${indent}${icon} ${task.title}`\n\n      // Add progress bar for bar type\n      if (task.type === \"bar\" && task.total && task.total > 0) {\n        const percent = task.current! / task.total\n        const barWidth = 20\n        const filled = Math.round(barWidth * percent)\n        const empty = barWidth - filled\n        const bar = chalk.cyan(\"█\".repeat(filled)) + chalk.gray(\"░\".repeat(empty))\n        line += ` ${bar} ${Math.round(percent * 100)}%`\n      }\n\n      // Add completion time in dimmed text\n      if (task.status === \"completed\" && task.completionTime !== undefined) {\n        line += chalk.dim(` ${task.completionTime}ms`)\n      }\n\n      lines.push(line)\n    }\n\n    // Clear and write each line\n    for (const line of lines) {\n      write(`${CLEAR_LINE}${line}\\n`, this.stream)\n    }\n\n    this.renderedLines = lines.length\n  }\n}\n\n/**\n * Handle for controlling an individual task\n */\nclass TaskHandle {\n  constructor(\n    private multi: MultiProgress,\n    private _id: string,\n  ) {}\n\n  /** Get task ID (for insertAfter) */\n  get id(): string {\n    return this._id\n  }\n\n  /** Start the task (set status to running) */\n  start(): this {\n    this.multi._updateTask(this._id, { status: \"running\" })\n    return this\n  }\n\n  /** Update progress (for bar type) */\n  update(current: number): this {\n    this.multi._updateTask(this._id, { current })\n    return this\n  }\n\n  /** Mark task as completed */\n  complete(titleOrTime?: string | number): this {\n    const updates: Partial<TaskState> = { status: \"completed\" }\n    if (typeof titleOrTime === \"number\") {\n      // Numeric = completion time in ms (preserves current title)\n      updates.completionTime = titleOrTime\n    } else if (titleOrTime) {\n      // String = new title (legacy behavior)\n      updates.title = titleOrTime\n    }\n    this.multi._updateTask(this._id, updates)\n    return this\n  }\n\n  /** Mark task as failed */\n  fail(title?: string): this {\n    const updates: Partial<TaskState> = { status: \"failed\" }\n    if (title) updates.title = title\n    this.multi._updateTask(this._id, updates)\n    return this\n  }\n\n  /** Mark task as skipped */\n  skip(title?: string): this {\n    const updates: Partial<TaskState> = { status: \"skipped\" }\n    if (title) updates.title = title\n    this.multi._updateTask(this._id, updates)\n    return this\n  }\n\n  /** Update task title */\n  setTitle(title: string): this {\n    this.multi._updateTask(this._id, { title })\n    return this\n  }\n\n  /** Change task type (e.g., from spinner to group when sub-steps are added) */\n  setType(type: \"spinner\" | \"bar\" | \"group\"): this {\n    this.multi._updateTask(this._id, { type })\n    return this\n  }\n\n  /** Get current status */\n  get status(): TaskStatus {\n    return this.multi._getTask(this._id)?.status ?? \"pending\"\n  }\n}\n\nexport type { TaskHandle }\n"],"mappings":"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"}