silvery 0.19.2 → 0.21.0

package/dist/ui/cli.d.mts

@@ -1,5 +1,5 @@
-import { i as createSpinner, n as SPINNER_FRAMES, r as Spinner, t as CallableSpinner } from "../spinner-CGo34vyR.mjs";
-import { n as TaskHandle, r as ProgressBar, t as MultiProgress } from "../multi-progress-DAQC7eap.mjs";
-import { a as CURSOR_RESTORE, c as CURSOR_TO_START, d as getTerminalWidth, f as isTTY, h as writeLine, i as CURSOR_HIDE, l as cursorDown, m as write, n as CLEAR_LINE_END, o as CURSOR_SAVE, p as withCursor, r as CLEAR_SCREEN, s as CURSOR_SHOW, t as CLEAR_LINE, u as cursorUp } from "../ansi-Cc33mW54.mjs";
+import { i as createSpinner, n as SPINNER_FRAMES, r as Spinner, t as CallableSpinner } from "../spinner-CZINHpkV.mjs";
+import { n as TaskHandle, r as ProgressBar, t as MultiProgress } from "../multi-progress-DHZ2xUT2.mjs";
+import { a as CURSOR_RESTORE, c as CURSOR_TO_START, d as getTerminalWidth, f as isTTY, h as writeLine, i as CURSOR_HIDE, l as cursorDown, m as write, n as CLEAR_LINE_END, o as CURSOR_SAVE, p as withCursor, r as CLEAR_SCREEN, s as CURSOR_SHOW, t as CLEAR_LINE, u as cursorUp } from "../ansi-2Xn0yatP.mjs";
 import { ColorizeHelpOptions, colorizeHelp } from "@silvery/commander";
 export { CLEAR_LINE, CLEAR_LINE_END, CLEAR_SCREEN, CURSOR_HIDE, CURSOR_RESTORE, CURSOR_SAVE, CURSOR_SHOW, CURSOR_TO_START, CallableSpinner, type ColorizeHelpOptions, MultiProgress, ProgressBar, SPINNER_FRAMES, Spinner, TaskHandle, colorizeHelp, createSpinner, cursorDown, cursorUp, getTerminalWidth, isTTY, withCursor, write, writeLine };

package/dist/ui/cli.mjs

@@ -1,7 +1,7 @@
-import { i as createSpinner, r as Spinner, t as SPINNER_FRAMES } from "../spinner-CeOmcuw_.mjs";
-import { a as CURSOR_RESTORE, c as CURSOR_TO_START, d as getTerminalWidth, f as isTTY, h as writeLine, i as CURSOR_HIDE, l as cursorDown, m as write, n as CLEAR_LINE_END, o as CURSOR_SAVE, p as withCursor, r as CLEAR_SCREEN, s as CURSOR_SHOW, t as CLEAR_LINE, u as cursorUp } from "../ansi-CLOitHKx.mjs";
-import { t as ProgressBar } from "../progress-bar-CXE5Qfkd.mjs";
-import { t as MultiProgress } from "../multi-progress-Bq9Oi_WI.mjs";
-import "../cli-BKp0YtBD.mjs";
+import { i as createSpinner, r as Spinner, t as SPINNER_FRAMES } from "../spinner-D9lrHr8s.mjs";
+import { a as CURSOR_RESTORE, c as CURSOR_TO_START, d as getTerminalWidth, f as isTTY, h as writeLine, i as CURSOR_HIDE, l as cursorDown, m as write, n as CLEAR_LINE_END, o as CURSOR_SAVE, p as withCursor, r as CLEAR_SCREEN, s as CURSOR_SHOW, t as CLEAR_LINE, u as cursorUp } from "../ansi-D1KQMAbf.mjs";
+import { t as ProgressBar } from "../progress-bar-oJwq22CR.mjs";
+import { t as MultiProgress } from "../multi-progress-CIRjrzma.mjs";
+import "../cli-dvo0r2fs.mjs";
 import { colorizeHelp } from "@silvery/commander";
 export { CLEAR_LINE, CLEAR_LINE_END, CLEAR_SCREEN, CURSOR_HIDE, CURSOR_RESTORE, CURSOR_SAVE, CURSOR_SHOW, CURSOR_TO_START, MultiProgress, ProgressBar, SPINNER_FRAMES, Spinner, colorizeHelp, createSpinner, cursorDown, cursorUp, getTerminalWidth, isTTY, withCursor, write, writeLine };

package/dist/ui/display.d.mts

@@ -1,4 +1,4 @@
-import { f as TableColumn, p as TableProps } from "../types-BH_v3iMT.mjs";
+import { f as TableColumn, p as TableProps } from "../types-kt_fKR37.mjs";
 import React from "react";
 
 //#region packages/ag-react/src/ui/display/Table.d.ts

package/dist/ui/image.d.mts

@@ -1,2 +1,2 @@
-import { a as isSixelSupported, c as encodeKittyImage, i as encodeSixel, l as isKittyGraphicsSupported, n as ImageProps, o as KittyImageOptions, r as SixelImageData, s as deleteKittyImage, t as Image } from "../index-BnA7mNpo.mjs";
-export { Image, ImageProps, KittyImageOptions, SixelImageData, deleteKittyImage, encodeKittyImage, encodeSixel, isKittyGraphicsSupported, isSixelSupported };
+import { a as encodeSixel, c as KittyPlaceOptions, d as encodeKittyImage, f as isKittyGraphicsSupported, i as decodePngToRgba, l as deleteKittyImage, n as ImageProps, o as isSixelSupported, p as placeKittyImage, r as SixelImageData, s as KittyImageOptions, t as Image, u as deleteKittyPlacement } from "../index-XbNrPhWl.mjs";
+export { Image, ImageProps, KittyImageOptions, KittyPlaceOptions, SixelImageData, decodePngToRgba, deleteKittyImage, deleteKittyPlacement, encodeKittyImage, encodeSixel, isKittyGraphicsSupported, isSixelSupported, placeKittyImage };

package/dist/ui/image.mjs

@@ -1,2 +1,2 @@
-import { a as encodeKittyImage, i as deleteKittyImage, n as encodeSixel, o as isKittyGraphicsSupported, r as isSixelSupported, t as Image } from "../image-CTII5QWI.mjs";
-export { Image, deleteKittyImage, encodeKittyImage, encodeSixel, isKittyGraphicsSupported, isSixelSupported };
+import { a as deleteKittyImage, c as isKittyGraphicsSupported, i as isSixelSupported, l as placeKittyImage, n as decodePngToRgba, o as deleteKittyPlacement, r as encodeSixel, s as encodeKittyImage, t as Image } from "../image-C2Birh2x.mjs";
+export { Image, decodePngToRgba, deleteKittyImage, deleteKittyPlacement, encodeKittyImage, encodeSixel, isKittyGraphicsSupported, isSixelSupported, placeKittyImage };

package/dist/ui/input.d.mts

@@ -1,4 +1,4 @@
-import { _ as TextInputOptions, o as SelectOption, s as SelectProps, v as TextInputProps } from "../types-BH_v3iMT.mjs";
+import { _ as TextInputOptions, o as SelectOption, s as SelectProps, v as TextInputProps } from "../types-kt_fKR37.mjs";
 import React from "react";
 
 //#region packages/ag-react/src/ui/input/TextInput.d.ts

package/dist/ui/input.mjs

@@ -48,10 +48,11 @@ function TextInput({ value, onChange, placeholder, mask, autocomplete, onAutocom
 	const beforeCursor = displayValue.slice(0, cursor);
 	const afterCursor = displayValue.slice(cursor);
 	const suggestionSuffix = suggestion ? suggestion.slice(value.length) : "";
+	const showPlaceholder = !value && placeholder;
 	return /* @__PURE__ */ jsx("span", {
 		"data-silvery-ui-text-input": true,
 		"data-focused": focused,
-		children: !value && placeholder ? /* @__PURE__ */ jsx("span", {
+		children: showPlaceholder ? /* @__PURE__ */ jsx("span", {
 			"data-color": "dim",
 			children: placeholder
 		}) : /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -204,10 +205,11 @@ function Select({ options, value, onChange, maxVisible = 10, highlightIndex: con
 			visibleOptions.map((option, visibleIdx) => {
 				const actualIndex = scrollOffset + visibleIdx;
 				const isSelected = option.value === value;
+				const isHighlighted = actualIndex === highlightIndex;
 				return /* @__PURE__ */ jsxs("div", {
 					"data-silvery-select-option": true,
 					"data-selected": isSelected,
-					"data-highlighted": actualIndex === highlightIndex,
+					"data-highlighted": isHighlighted,
 					children: [/* @__PURE__ */ jsx("span", {
 						"data-silvery-select-indicator": true,
 						children: isSelected ? ">" : " "

package/dist/ui/input.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"input.mjs","names":[],"sources":["../../packages/ag-react/src/ui/input/TextInput.tsx","../../packages/ag-react/src/ui/input/Select.tsx"],"sourcesContent":["/**\n * React TextInput component for silvery/Ink TUI apps\n */\n\nimport React, { useState, useCallback } from \"react\"\nimport type { TextInputProps } from \"../types.js\"\n\n/**\n * Single-line text input component for React TUI apps\n *\n * This is a controlled component that renders the current input state.\n * It does NOT handle keyboard input directly - that's the caller's responsibility\n * (via useInput hook in Ink, or similar).\n *\n * @example\n * ```tsx\n * import { TextInput } from \"./index\";\n * import { useInput } from \"ink\";\n *\n * function MyForm() {\n *   const [value, setValue] = useState(\"\");\n *\n *   useInput((input, key) => {\n *     if (key.backspace || key.delete) {\n *       setValue(v => v.slice(0, -1));\n *     } else if (!key.ctrl && !key.meta && input) {\n *       setValue(v => v + input);\n *     }\n *   });\n *\n *   return <TextInput value={value} onChange={setValue} placeholder=\"Type here...\" />;\n * }\n *\n * // With password masking\n * <TextInput value={password} onChange={setPassword} mask=\"*\" />\n *\n * // With autocomplete\n * <TextInput\n *   value={query}\n *   onChange={setQuery}\n *   autocomplete={[\"apple\", \"apricot\", \"avocado\"]}\n * />\n * ```\n */\nexport function TextInput({\n  value,\n  onChange,\n  placeholder,\n  mask,\n  autocomplete,\n  onAutocomplete,\n  onSubmit,\n  cursorPosition,\n  focused = true,\n}: TextInputProps): React.ReactElement {\n  // Calculate display value (masked or plain)\n  const displayValue = mask ? mask.repeat(value.length) : value\n\n  // Find matching autocomplete suggestion\n  const suggestion = getAutocompleteSuggestion(value, autocomplete)\n\n  // Cursor position defaults to end of input\n  const cursor = cursorPosition ?? value.length\n\n  // Build the display: value + cursor + suggestion suffix\n  const beforeCursor = displayValue.slice(0, cursor)\n  const afterCursor = displayValue.slice(cursor)\n  const suggestionSuffix = suggestion ? suggestion.slice(value.length) : \"\"\n\n  // Show placeholder if empty and not focused or no value\n  const showPlaceholder = !value && placeholder\n\n  return (\n    <span data-silvery-ui-text-input data-focused={focused}>\n      {showPlaceholder ? (\n        <span data-color=\"dim\">{placeholder}</span>\n      ) : (\n        <>\n          <span>{beforeCursor}</span>\n          {focused && (\n            <span data-cursor data-inverse>\n              {afterCursor[0] || \" \"}\n            </span>\n          )}\n          <span>{afterCursor.slice(1)}</span>\n          {suggestionSuffix && <span data-color=\"dim\">{suggestionSuffix}</span>}\n        </>\n      )}\n    </span>\n  )\n}\n\n/**\n * Hook for managing text input state with autocomplete support\n *\n * @example\n * ```tsx\n * function SearchInput() {\n *   const { value, displayValue, suggestion, handleInput, acceptSuggestion, clear } =\n *     useTextInput({ autocomplete: [\"apple\", \"banana\", \"cherry\"] });\n *\n *   useInput((input, key) => {\n *     if (key.tab && suggestion) {\n *       acceptSuggestion();\n *     } else {\n *       handleInput(input, key);\n *     }\n *   });\n *\n *   return <Text>{displayValue}</Text>;\n * }\n * ```\n */\nexport function useTextInput(\n  options: {\n    initialValue?: string\n    mask?: string\n    autocomplete?: string[]\n    onSubmit?: (value: string) => void\n  } = {},\n): {\n  value: string\n  setValue: (value: string) => void\n  displayValue: string\n  suggestion: string | undefined\n  cursorPosition: number\n  setCursorPosition: (pos: number) => void\n  handleInput: (input: string, key: InputKey) => void\n  acceptSuggestion: () => void\n  clear: () => void\n} {\n  const [value, setValue] = useState(options.initialValue ?? \"\")\n  const [cursorPosition, setCursorPosition] = useState(value.length)\n\n  const displayValue = options.mask ? options.mask.repeat(value.length) : value\n\n  const suggestion = getAutocompleteSuggestion(value, options.autocomplete)\n\n  const handleInput = useCallback(\n    (input: string, key: InputKey) => {\n      if (key.return) {\n        options.onSubmit?.(value)\n        return\n      }\n\n      if (key.backspace || key.delete) {\n        if (cursorPosition > 0) {\n          setValue((v) => v.slice(0, cursorPosition - 1) + v.slice(cursorPosition))\n          setCursorPosition((p) => Math.max(0, p - 1))\n        }\n        return\n      }\n\n      if (key.leftArrow) {\n        setCursorPosition((p) => Math.max(0, p - 1))\n        return\n      }\n\n      if (key.rightArrow) {\n        setCursorPosition((p) => Math.min(value.length, p + 1))\n        return\n      }\n\n      // Ignore control characters (but allow opt+key composed chars via key.text)\n      if (key.ctrl || !input) {\n        return\n      }\n\n      // Insert the actual typed character (pre-normalization), not the keybinding key.\n      // E.g., Shift+3 should insert '#', not '3'.\n      const char = key.text ?? input\n      if (key.meta && !char) return // opt+key with no text output\n      setValue((v) => v.slice(0, cursorPosition) + char + v.slice(cursorPosition))\n      setCursorPosition((p) => p + char.length)\n    },\n    [value, cursorPosition, options.onSubmit],\n  )\n\n  const acceptSuggestion = useCallback(() => {\n    if (suggestion) {\n      setValue(suggestion)\n      setCursorPosition(suggestion.length)\n    }\n  }, [suggestion])\n\n  const clear = useCallback(() => {\n    setValue(\"\")\n    setCursorPosition(0)\n  }, [])\n\n  return {\n    value,\n    setValue,\n    displayValue,\n    suggestion,\n    cursorPosition,\n    setCursorPosition,\n    handleInput,\n    acceptSuggestion,\n    clear,\n  }\n}\n\n/** Key object type (matches Ink's Key interface) */\ninterface InputKey {\n  return?: boolean\n  backspace?: boolean\n  delete?: boolean\n  leftArrow?: boolean\n  rightArrow?: boolean\n  upArrow?: boolean\n  downArrow?: boolean\n  tab?: boolean\n  escape?: boolean\n  ctrl?: boolean\n  meta?: boolean\n  shift?: boolean\n  text?: string\n}\n\n/**\n * Find a matching autocomplete suggestion for the current input\n */\nfunction getAutocompleteSuggestion(value: string, autocomplete?: string[]): string | undefined {\n  if (!value || !autocomplete?.length) {\n    return undefined\n  }\n\n  const lowerValue = value.toLowerCase()\n  return autocomplete.find(\n    (item) => item.toLowerCase().startsWith(lowerValue) && item.length > value.length,\n  )\n}\n","/**\n * React Select component for silvery/Ink TUI apps\n *\n * Single-choice selection list with keyboard navigation.\n */\n\nimport React, { useState, useEffect, useCallback } from \"react\"\nimport type { SelectProps, SelectOption } from \"../types.js\"\n\n/**\n * Scrollable single-choice selection list\n *\n * @example\n * ```tsx\n * import { Select } from \"./index\";\n *\n * function SettingsView() {\n *   const [theme, setTheme] = useState(\"light\");\n *\n *   return (\n *     <Select\n *       options={[\n *         { label: \"Light\", value: \"light\" },\n *         { label: \"Dark\", value: \"dark\" },\n *         { label: \"System\", value: \"system\" },\n *       ]}\n *       value={theme}\n *       onChange={setTheme}\n *     />\n *   );\n * }\n * ```\n */\nexport function Select<T>({\n  options,\n  value,\n  onChange,\n  maxVisible = 10,\n  highlightIndex: controlledHighlightIndex,\n  onHighlightChange,\n}: SelectProps<T>): React.ReactElement {\n  // Find the index of the currently selected value\n  const selectedIndex = options.findIndex((opt) => opt.value === value)\n\n  // Internal highlight state (for uncontrolled mode)\n  const [internalHighlightIndex, setInternalHighlightIndex] = useState(\n    selectedIndex >= 0 ? selectedIndex : 0,\n  )\n\n  // Use controlled or internal highlight index\n  const highlightIndex = controlledHighlightIndex ?? internalHighlightIndex\n\n  // Calculate scroll window\n  const scrollOffset = Math.max(\n    0,\n    Math.min(highlightIndex - Math.floor(maxVisible / 2), options.length - maxVisible),\n  )\n  const visibleOptions = options.slice(scrollOffset, scrollOffset + maxVisible)\n  const hasMoreAbove = scrollOffset > 0\n  const hasMoreBelow = scrollOffset + maxVisible < options.length\n\n  // Sync internal highlight when value changes externally\n  useEffect(() => {\n    if (controlledHighlightIndex === undefined && selectedIndex >= 0) {\n      setInternalHighlightIndex(selectedIndex)\n    }\n  }, [selectedIndex, controlledHighlightIndex])\n\n  return (\n    <div data-silvery-select>\n      {hasMoreAbove && <div data-silvery-select-scroll-indicator=\"up\">...</div>}\n      {visibleOptions.map((option, visibleIdx) => {\n        const actualIndex = scrollOffset + visibleIdx\n        const isSelected = option.value === value\n        const isHighlighted = actualIndex === highlightIndex\n\n        return (\n          <div\n            key={actualIndex}\n            data-silvery-select-option\n            data-selected={isSelected}\n            data-highlighted={isHighlighted}\n          >\n            <span data-silvery-select-indicator>{isSelected ? \">\" : \" \"}</span>\n            <span data-silvery-select-label>{option.label}</span>\n          </div>\n        )\n      })}\n      {hasMoreBelow && <div data-silvery-select-scroll-indicator=\"down\">...</div>}\n    </div>\n  )\n}\n\n/**\n * Hook for managing select state with keyboard navigation\n *\n * @example\n * ```tsx\n * function MySelect() {\n *   const options = [\n *     { label: \"Option A\", value: \"a\" },\n *     { label: \"Option B\", value: \"b\" },\n *   ];\n *\n *   const { highlightIndex, moveUp, moveDown, select, value } = useSelect({\n *     options,\n *     initialValue: \"a\",\n *   });\n *\n *   useInput((input, key) => {\n *     if (key.upArrow) moveUp();\n *     if (key.downArrow) moveDown();\n *     if (key.return) select();\n *   });\n *\n *   return <Select options={options} value={value} highlightIndex={highlightIndex} />;\n * }\n * ```\n */\nexport function useSelect<T>({\n  options,\n  initialValue,\n  onChange,\n}: {\n  options: SelectOption<T>[]\n  initialValue?: T\n  onChange?: (value: T) => void\n}): {\n  value: T | undefined\n  highlightIndex: number\n  moveUp: () => void\n  moveDown: () => void\n  select: () => void\n  setHighlightIndex: (index: number) => void\n} {\n  const initialIndex =\n    initialValue !== undefined ? options.findIndex((opt) => opt.value === initialValue) : 0\n\n  const [highlightIndex, setHighlightIndex] = useState(Math.max(0, initialIndex))\n  const [value, setValue] = useState<T | undefined>(initialValue)\n\n  const moveUp = useCallback(() => {\n    setHighlightIndex((i) => Math.max(0, i - 1))\n  }, [])\n\n  const moveDown = useCallback(() => {\n    setHighlightIndex((i) => Math.min(options.length - 1, i + 1))\n  }, [options.length])\n\n  const select = useCallback(() => {\n    const option = options[highlightIndex]\n    if (option) {\n      setValue(option.value)\n      onChange?.(option.value)\n    }\n  }, [highlightIndex, options, onChange])\n\n  return {\n    value,\n    highlightIndex,\n    moveUp,\n    moveDown,\n    select,\n    setHighlightIndex,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"input.mjs","names":[],"sources":["../../packages/ag-react/src/ui/input/TextInput.tsx","../../packages/ag-react/src/ui/input/Select.tsx"],"sourcesContent":["/**\n * React TextInput component for silvery/Ink TUI apps\n */\n\nimport React, { useState, useCallback } from \"react\"\nimport type { TextInputProps } from \"../types.js\"\n\n/**\n * Single-line text input component for React TUI apps\n *\n * This is a controlled component that renders the current input state.\n * It does NOT handle keyboard input directly - that's the caller's responsibility\n * (via useInput hook in Ink, or similar).\n *\n * @example\n * ```tsx\n * import { TextInput } from \"./index\";\n * import { useInput } from \"ink\";\n *\n * function MyForm() {\n *   const [value, setValue] = useState(\"\");\n *\n *   useInput((input, key) => {\n *     if (key.backspace || key.delete) {\n *       setValue(v => v.slice(0, -1));\n *     } else if (!key.ctrl && !key.meta && input) {\n *       setValue(v => v + input);\n *     }\n *   });\n *\n *   return <TextInput value={value} onChange={setValue} placeholder=\"Type here...\" />;\n * }\n *\n * // With password masking\n * <TextInput value={password} onChange={setPassword} mask=\"*\" />\n *\n * // With autocomplete\n * <TextInput\n *   value={query}\n *   onChange={setQuery}\n *   autocomplete={[\"apple\", \"apricot\", \"avocado\"]}\n * />\n * ```\n */\nexport function TextInput({\n  value,\n  onChange,\n  placeholder,\n  mask,\n  autocomplete,\n  onAutocomplete,\n  onSubmit,\n  cursorPosition,\n  focused = true,\n}: TextInputProps): React.ReactElement {\n  // Calculate display value (masked or plain)\n  const displayValue = mask ? mask.repeat(value.length) : value\n\n  // Find matching autocomplete suggestion\n  const suggestion = getAutocompleteSuggestion(value, autocomplete)\n\n  // Cursor position defaults to end of input\n  const cursor = cursorPosition ?? value.length\n\n  // Build the display: value + cursor + suggestion suffix\n  const beforeCursor = displayValue.slice(0, cursor)\n  const afterCursor = displayValue.slice(cursor)\n  const suggestionSuffix = suggestion ? suggestion.slice(value.length) : \"\"\n\n  // Show placeholder if empty and not focused or no value\n  const showPlaceholder = !value && placeholder\n\n  return (\n    <span data-silvery-ui-text-input data-focused={focused}>\n      {showPlaceholder ? (\n        <span data-color=\"dim\">{placeholder}</span>\n      ) : (\n        <>\n          <span>{beforeCursor}</span>\n          {focused && (\n            <span data-cursor data-inverse>\n              {afterCursor[0] || \" \"}\n            </span>\n          )}\n          <span>{afterCursor.slice(1)}</span>\n          {suggestionSuffix && <span data-color=\"dim\">{suggestionSuffix}</span>}\n        </>\n      )}\n    </span>\n  )\n}\n\n/**\n * Hook for managing text input state with autocomplete support\n *\n * @example\n * ```tsx\n * function SearchInput() {\n *   const { value, displayValue, suggestion, handleInput, acceptSuggestion, clear } =\n *     useTextInput({ autocomplete: [\"apple\", \"banana\", \"cherry\"] });\n *\n *   useInput((input, key) => {\n *     if (key.tab && suggestion) {\n *       acceptSuggestion();\n *     } else {\n *       handleInput(input, key);\n *     }\n *   });\n *\n *   return <Text>{displayValue}</Text>;\n * }\n * ```\n */\nexport function useTextInput(\n  options: {\n    initialValue?: string\n    mask?: string\n    autocomplete?: string[]\n    onSubmit?: (value: string) => void\n  } = {},\n): {\n  value: string\n  setValue: (value: string) => void\n  displayValue: string\n  suggestion: string | undefined\n  cursorPosition: number\n  setCursorPosition: (pos: number) => void\n  handleInput: (input: string, key: InputKey) => void\n  acceptSuggestion: () => void\n  clear: () => void\n} {\n  const [value, setValue] = useState(options.initialValue ?? \"\")\n  const [cursorPosition, setCursorPosition] = useState(value.length)\n\n  const displayValue = options.mask ? options.mask.repeat(value.length) : value\n\n  const suggestion = getAutocompleteSuggestion(value, options.autocomplete)\n\n  const handleInput = useCallback(\n    (input: string, key: InputKey) => {\n      if (key.return) {\n        options.onSubmit?.(value)\n        return\n      }\n\n      if (key.backspace || key.delete) {\n        if (cursorPosition > 0) {\n          setValue((v) => v.slice(0, cursorPosition - 1) + v.slice(cursorPosition))\n          setCursorPosition((p) => Math.max(0, p - 1))\n        }\n        return\n      }\n\n      if (key.leftArrow) {\n        setCursorPosition((p) => Math.max(0, p - 1))\n        return\n      }\n\n      if (key.rightArrow) {\n        setCursorPosition((p) => Math.min(value.length, p + 1))\n        return\n      }\n\n      // Ignore control characters (but allow opt+key composed chars via key.text)\n      if (key.ctrl || !input) {\n        return\n      }\n\n      // Insert the actual typed character (pre-normalization), not the keybinding key.\n      // E.g., Shift+3 should insert '#', not '3'.\n      const char = key.text ?? input\n      if (key.meta && !char) return // opt+key with no text output\n      setValue((v) => v.slice(0, cursorPosition) + char + v.slice(cursorPosition))\n      setCursorPosition((p) => p + char.length)\n    },\n    [value, cursorPosition, options.onSubmit],\n  )\n\n  const acceptSuggestion = useCallback(() => {\n    if (suggestion) {\n      setValue(suggestion)\n      setCursorPosition(suggestion.length)\n    }\n  }, [suggestion])\n\n  const clear = useCallback(() => {\n    setValue(\"\")\n    setCursorPosition(0)\n  }, [])\n\n  return {\n    value,\n    setValue,\n    displayValue,\n    suggestion,\n    cursorPosition,\n    setCursorPosition,\n    handleInput,\n    acceptSuggestion,\n    clear,\n  }\n}\n\n/** Key object type (matches Ink's Key interface) */\ninterface InputKey {\n  return?: boolean\n  backspace?: boolean\n  delete?: boolean\n  leftArrow?: boolean\n  rightArrow?: boolean\n  upArrow?: boolean\n  downArrow?: boolean\n  tab?: boolean\n  escape?: boolean\n  ctrl?: boolean\n  meta?: boolean\n  shift?: boolean\n  text?: string\n}\n\n/**\n * Find a matching autocomplete suggestion for the current input\n */\nfunction getAutocompleteSuggestion(value: string, autocomplete?: string[]): string | undefined {\n  if (!value || !autocomplete?.length) {\n    return undefined\n  }\n\n  const lowerValue = value.toLowerCase()\n  return autocomplete.find(\n    (item) => item.toLowerCase().startsWith(lowerValue) && item.length > value.length,\n  )\n}\n","/**\n * React Select component for silvery/Ink TUI apps\n *\n * Single-choice selection list with keyboard navigation.\n */\n\nimport React, { useState, useEffect, useCallback } from \"react\"\nimport type { SelectProps, SelectOption } from \"../types.js\"\n\n/**\n * Scrollable single-choice selection list\n *\n * @example\n * ```tsx\n * import { Select } from \"./index\";\n *\n * function SettingsView() {\n *   const [theme, setTheme] = useState(\"light\");\n *\n *   return (\n *     <Select\n *       options={[\n *         { label: \"Light\", value: \"light\" },\n *         { label: \"Dark\", value: \"dark\" },\n *         { label: \"System\", value: \"system\" },\n *       ]}\n *       value={theme}\n *       onChange={setTheme}\n *     />\n *   );\n * }\n * ```\n */\nexport function Select<T>({\n  options,\n  value,\n  onChange,\n  maxVisible = 10,\n  highlightIndex: controlledHighlightIndex,\n  onHighlightChange,\n}: SelectProps<T>): React.ReactElement {\n  // Find the index of the currently selected value\n  const selectedIndex = options.findIndex((opt) => opt.value === value)\n\n  // Internal highlight state (for uncontrolled mode)\n  const [internalHighlightIndex, setInternalHighlightIndex] = useState(\n    selectedIndex >= 0 ? selectedIndex : 0,\n  )\n\n  // Use controlled or internal highlight index\n  const highlightIndex = controlledHighlightIndex ?? internalHighlightIndex\n\n  // Calculate scroll window\n  const scrollOffset = Math.max(\n    0,\n    Math.min(highlightIndex - Math.floor(maxVisible / 2), options.length - maxVisible),\n  )\n  const visibleOptions = options.slice(scrollOffset, scrollOffset + maxVisible)\n  const hasMoreAbove = scrollOffset > 0\n  const hasMoreBelow = scrollOffset + maxVisible < options.length\n\n  // Sync internal highlight when value changes externally\n  useEffect(() => {\n    if (controlledHighlightIndex === undefined && selectedIndex >= 0) {\n      setInternalHighlightIndex(selectedIndex)\n    }\n  }, [selectedIndex, controlledHighlightIndex])\n\n  return (\n    <div data-silvery-select>\n      {hasMoreAbove && <div data-silvery-select-scroll-indicator=\"up\">...</div>}\n      {visibleOptions.map((option, visibleIdx) => {\n        const actualIndex = scrollOffset + visibleIdx\n        const isSelected = option.value === value\n        const isHighlighted = actualIndex === highlightIndex\n\n        return (\n          <div\n            key={actualIndex}\n            data-silvery-select-option\n            data-selected={isSelected}\n            data-highlighted={isHighlighted}\n          >\n            <span data-silvery-select-indicator>{isSelected ? \">\" : \" \"}</span>\n            <span data-silvery-select-label>{option.label}</span>\n          </div>\n        )\n      })}\n      {hasMoreBelow && <div data-silvery-select-scroll-indicator=\"down\">...</div>}\n    </div>\n  )\n}\n\n/**\n * Hook for managing select state with keyboard navigation\n *\n * @example\n * ```tsx\n * function MySelect() {\n *   const options = [\n *     { label: \"Option A\", value: \"a\" },\n *     { label: \"Option B\", value: \"b\" },\n *   ];\n *\n *   const { highlightIndex, moveUp, moveDown, select, value } = useSelect({\n *     options,\n *     initialValue: \"a\",\n *   });\n *\n *   useInput((input, key) => {\n *     if (key.upArrow) moveUp();\n *     if (key.downArrow) moveDown();\n *     if (key.return) select();\n *   });\n *\n *   return <Select options={options} value={value} highlightIndex={highlightIndex} />;\n * }\n * ```\n */\nexport function useSelect<T>({\n  options,\n  initialValue,\n  onChange,\n}: {\n  options: SelectOption<T>[]\n  initialValue?: T\n  onChange?: (value: T) => void\n}): {\n  value: T | undefined\n  highlightIndex: number\n  moveUp: () => void\n  moveDown: () => void\n  select: () => void\n  setHighlightIndex: (index: number) => void\n} {\n  const initialIndex =\n    initialValue !== undefined ? options.findIndex((opt) => opt.value === initialValue) : 0\n\n  const [highlightIndex, setHighlightIndex] = useState(Math.max(0, initialIndex))\n  const [value, setValue] = useState<T | undefined>(initialValue)\n\n  const moveUp = useCallback(() => {\n    setHighlightIndex((i) => Math.max(0, i - 1))\n  }, [])\n\n  const moveDown = useCallback(() => {\n    setHighlightIndex((i) => Math.min(options.length - 1, i + 1))\n  }, [options.length])\n\n  const select = useCallback(() => {\n    const option = options[highlightIndex]\n    if (option) {\n      setValue(option.value)\n      onChange?.(option.value)\n    }\n  }, [highlightIndex, options, onChange])\n\n  return {\n    value,\n    highlightIndex,\n    moveUp,\n    moveDown,\n    select,\n    setHighlightIndex,\n  }\n}\n"],"mappings":"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"}

package/dist/ui/progress.d.mts

@@ -1,249 +1,5 @@
-import { a as ProgressInfo, d as StepProgress } from "../types-BH_v3iMT.mjs";
-import { i as createSpinner, r as Spinner, t as CallableSpinner } from "../spinner-CGo34vyR.mjs";
-import { n as TaskHandle, r as ProgressBar, t as MultiProgress } from "../multi-progress-DAQC7eap.mjs";
-
-//#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
-//#region packages/ag-react/src/ui/progress/task.d.ts
-interface TaskWrapper {
-  /**
-   * Wrap work with a spinner indicator
-   * @param work - Promise, function, or generator
-   */
-  wrap<T>(work: T | PromiseLike<T> | (() => T | PromiseLike<T>) | (() => Generator<ProgressInfo, T, unknown>)): Promise<T>;
-}
-/**
- * Create a task wrapper with spinner
- *
- * @param title - Display title for the task
- * @returns TaskWrapper with wrap() method
- */
-declare function task(title: string): TaskWrapper;
-//#endregion
-//#region packages/ag-react/src/ui/progress/tasks.d.ts
-/** Options for run() */
-interface RunOptions {
-  /** Clear progress display after completion (default: false) */
-  clear?: boolean;
-}
-interface TaskBuilder {
-  /**
-   * Add a task to the sequence
-   * @param title - Display title
-   * @param work - Function, async function, or generator
-   */
-  add<T>(title: string, work: () => T | PromiseLike<T> | Generator<ProgressInfo, T, unknown>): TaskBuilder;
-  /**
-   * Run all tasks in sequence
-   * @param options - Run options
-   * @returns Results keyed by task title
-   */
-  run(options?: RunOptions): Promise<Record<string, unknown>>;
-}
-/**
- * Create a sequential task builder
- *
- * @returns TaskBuilder with add() and run() methods
- */
-declare function tasks(): TaskBuilder;
-//#endregion
-export { CallableSpinner, ExecuteOptions, MultiProgress, ProgressBar, ProgressInfo, RunOptions, Spinner, StepBuilder, type StepContext, type StepNode, StepProgress, type StepsDef, type StepsRunner, TaskBuilder, TaskHandle, TaskWrapper, createSpinner, step, steps, task, tasks };
-//# sourceMappingURL=progress.d.mts.map
+import { a as ProgressInfo, d as StepProgress } from "../types-kt_fKR37.mjs";
+import { i as createSpinner, r as Spinner, t as CallableSpinner } from "../spinner-CZINHpkV.mjs";
+import { n as TaskHandle, r as ProgressBar, t as MultiProgress } from "../multi-progress-DHZ2xUT2.mjs";
+import { a as StepContext, c as StepsDef, i as StepsRunner, n as StepBuilder, o as step, r as steps, s as StepNode, t as ExecuteOptions } from "../steps-Bp2uNqnn.mjs";
+export { CallableSpinner, ExecuteOptions, MultiProgress, ProgressBar, ProgressInfo, Spinner, StepBuilder, StepContext, StepNode, StepProgress, StepsDef, StepsRunner, TaskHandle, createSpinner, step, steps };