@nmakarov/cli-toolkit 0.7.1 → 0.8.0

package/dist/index.cjs

@@ -1,10 +1,21 @@
 "use strict";
+
+var __esmCache = {};
+var __loadESMSync = function(moduleName) {
+  if (!__esmCache[moduleName]) {
+    throw new Error(`ESM module "${moduleName}" not loaded. Please call the load() function first: const toolkit = require("@nmakarov/cli-toolkit"); await toolkit.load();`);
+  }
+  return __esmCache[moduleName];
+};
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -27,1788 +38,1941 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  Args: () => Args,
-  Box: () => import_ink5.Box,
-  Db: () => Db,
-  Divider: () => Divider,
-  FileDatabase: () => FileDatabase,
-  FileDatabaseError: () => FileDatabaseError,
-  FooterPresets: () => FooterPresets,
-  GridCell: () => GridCell,
-  InputField: () => InputField,
-  ListComponent: () => ListComponent,
-  ListItem: () => ListItem,
-  MultiColumnListComponent: () => MultiColumnListComponent,
-  MultiColumnListWithPreviewComponent: () => MultiColumnListWithPreviewComponent,
-  Params: () => Params,
-  React: () => import_react5.default,
-  ScreenBody: () => ScreenBody,
-  ScreenContainer: () => ScreenContainer,
-  ScreenDivider: () => ScreenDivider,
-  ScreenFooter: () => ScreenFooter,
-  ScreenRow: () => ScreenRow,
-  ScreenTitle: () => ScreenTitle,
-  Text: () => import_ink5.Text,
-  TextBlock: () => TextBlock,
-  buildBreadcrumb: () => buildBreadcrumb,
-  buildDetailBreadcrumb: () => buildDetailBreadcrumb,
-  buildFooter: () => buildFooter,
-  defaultFileSynopsisFunction: () => defaultFileSynopsisFunction,
-  defaultVersionSynopsisFunction: () => defaultVersionSynopsisFunction,
-  getArgsInstance: () => getArgsInstance,
-  getParamsInstance: () => getParamsInstance,
-  h: () => import_react5.createElement,
-  joiEdateType: () => joiEdateType,
-  joiStringArrayType: () => joiStringArrayType,
-  load: () => load,
-  organizeFooterMessages: () => organizeFooterMessages,
-  setupContext: () => setupContext,
-  showListScreen: () => showListScreen,
-  showMenuScreen: () => showMenuScreen,
-  showMultiColumnListScreen: () => showMultiColumnListScreen,
-  showMultiColumnListWithPreviewScreen: () => showMultiColumnListWithPreviewScreen,
-  showScreen: () => showScreen,
-  showWordGridScreen: () => showWordGridScreen,
-  useCallback: () => import_react5.useCallback,
-  useEffect: () => import_react5.useEffect,
-  useInput: () => import_ink5.useInput,
-  useMemo: () => import_react5.useMemo,
-  useRef: () => import_react5.useRef,
-  useState: () => import_react5.useState
-});
-module.exports = __toCommonJS(src_exports);
-
-// src/args/index.ts
-var import_fs = require("fs");
-var import_path = require("path");
-var import_dotenv = require("dotenv");
-var Args = class {
-  args = {};
-  flags = {};
-  options = {};
-  commands = [];
-  usedKeys = /* @__PURE__ */ new Set();
-  aliases = {};
-  overrides = {};
-  defaults = {};
-  prefixes = [];
-  nots = [];
-  configValues = {};
-  configsLoaded = [];
-  env = "local";
-  constructor(config2 = {}) {
-    this.aliases = config2.aliases || {};
-    this.overrides = config2.overrides || {};
-    this.defaults = config2.defaults || {};
-    this.prefixes = config2.prefixes || ["not", "no"];
-    const args = config2.args || process.argv.slice(2);
-    this.parseArgs(args);
-    this.env = this.get("env")?.toLowerCase() || "local";
-    this.loadDotEnv();
-    this.loadConfigFiles();
-    this.checkConflicts();
-  }
-  /**
-   * Parse command line arguments
-   */
-  parseArgs(args) {
-    let i = 0;
-    while (i < args.length) {
-      const arg = args[i];
-      if (arg.startsWith("--")) {
-        const [key, value] = this.parseLongOption(arg);
-        this.setValue(key, value);
-        i++;
-      } else if (arg.startsWith("-")) {
-        const result = this.parseShortOption(arg, args, i);
-        if (result.consumed > 0) {
-          i += result.consumed;
+// src/screen/components.ts
+function getScreenWidth(maxWidth = null) {
+  const terminalWidth = process.stdout.columns || 80;
+  const availableWidth = Math.max(20, terminalWidth - 4);
+  return maxWidth ? Math.min(availableWidth, maxWidth) : availableWidth;
+}
+function ScreenContainer({ children }) {
+  const width = getScreenWidth();
+  return (0, import_react.createElement)(import_ink.Box, {
+    flexDirection: "column",
+    marginTop: 1,
+    borderStyle: "single",
+    borderColor: "cyan",
+    paddingX: 1,
+    width
+    // Use the calculated width directly
+  }, children);
+}
+function ScreenRow({ children }) {
+  return (0, import_react.createElement)(import_ink.Box, { flexDirection: "column" }, children);
+}
+function ScreenTitle({ text }) {
+  return (0, import_react.createElement)(
+    ScreenRow,
+    {},
+    (0, import_react.createElement)(import_ink.Text, { bold: true, color: "cyan" }, text)
+  );
+}
+function ScreenDivider({ width }) {
+  const dividerWidth = width || getScreenWidth() - 4;
+  return (0, import_react.createElement)(import_ink.Text, { color: "cyan", dimColor: true }, "\u2500".repeat(dividerWidth));
+}
+function ScreenBody({ children, alignItems = "flex-start" }) {
+  return (0, import_react.createElement)(import_ink.Box, { flexDirection: "column", alignItems }, children);
+}
+function ScreenFooter({ lines, textStyle }) {
+  const defaultTextStyle = {
+    dimColor: true,
+    color: "white"
+  };
+  const finalTextStyle = { ...defaultTextStyle, ...textStyle };
+  const flattenAndWrap = (items, keyPrefix = "") => {
+    const result = [];
+    let keyIndex = 0;
+    items.forEach((item, index) => {
+      if (Array.isArray(item)) {
+        const nested = flattenAndWrap(item, `${keyPrefix}-${index}`);
+        result.push(...nested);
+      } else if (typeof item === "string") {
+        result.push(
+          (0, import_react.createElement)(import_ink.Text, { key: `${keyPrefix}-${keyIndex++}`, ...finalTextStyle }, item)
+        );
+      } else {
+        const element = item;
+        if (element.key === null || element.key === void 0) {
+          result.push(
+            (0, import_react.createElement)(import_ink.Text, { key: `${keyPrefix}-${keyIndex++}`, ...finalTextStyle }, element)
+          );
         } else {
-          i++;
+          result.push(element);
         }
-      } else {
-        this.commands.push(arg);
-        i++;
       }
-    }
+    });
+    return result;
+  };
+  const wrappedItems = flattenAndWrap(lines);
+  return (0, import_react.createElement)(
+    import_ink.Box,
+    { flexDirection: "column" },
+    (0, import_react.createElement)(import_ink.Box, { flexDirection: "row" }, ...wrappedItems)
+  );
+}
+var import_react, import_ink;
+var init_components = __esm({
+  "src/screen/components.ts"() {
+    "use strict";
+    import_react = require("react");
+    import_ink = require("ink");
   }
-  /**
-   * Parse long option (--key=value or --key)
-   */
-  parseLongOption(arg) {
-    const key = arg.slice(2);
-    const prefix = this.prefixes.find((p) => key.startsWith(p));
-    if (prefix) {
-      let strippedKey = key.slice(prefix.length);
-      if (strippedKey.startsWith("-")) {
-        strippedKey = strippedKey.slice(1);
+});
+
+// src/screen/list-components.ts
+function MultiColumnListComponent({ items, ctx, selectedIndexRef }) {
+  const [, forceUpdate] = (0, import_react2.useState)({});
+  const termWidth = (process.stdout.columns || 80) - 8;
+  const maxItemLength = Math.max(...items.map((w) => w.length));
+  const columnWidth = maxItemLength + 3;
+  const columns = Math.max(1, Math.floor(termWidth / columnWidth));
+  const itemsPerColumn = Math.ceil(items.length / columns);
+  (0, import_react2.useEffect)(() => {
+    ctx.setAction("moveUp", () => {
+      selectedIndexRef.current = Math.max(0, selectedIndexRef.current - 1);
+      forceUpdate({});
+    });
+    ctx.setAction("moveDown", () => {
+      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + 1);
+      forceUpdate({});
+    });
+    ctx.setAction("moveLeft", () => {
+      if (selectedIndexRef.current === 0) {
+        ctx.goBack();
+      } else {
+        selectedIndexRef.current = Math.max(0, selectedIndexRef.current - itemsPerColumn);
+        forceUpdate({});
+      }
+    });
+    ctx.setAction("moveRight", () => {
+      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + itemsPerColumn);
+      forceUpdate({});
+    });
+    ctx.setKeyBinding([
+      { key: "leftArrow", caption: "navigate", action: "moveLeft", order: 0 },
+      { key: "rightArrow", caption: "navigate", action: "moveRight", order: 0 },
+      { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
+      { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
+    ]);
+    ctx.addFooter(`Total: ${items.length} items`);
+  }, []);
+  const selectedIndex = selectedIndexRef.current;
+  const rows = [];
+  for (let row = 0; row < itemsPerColumn; row++) {
+    const cols = [];
+    for (let col = 0; col < columns; col++) {
+      const index = col * itemsPerColumn + row;
+      if (index < items.length) {
+        const isSelected = index === selectedIndex;
+        cols.push(
+          h2(
+            import_ink2.Box,
+            { key: index, width: columnWidth },
+            h2(import_ink2.Text, {
+              color: isSelected ? "black" : "white",
+              backgroundColor: isSelected ? "cyan" : void 0,
+              bold: isSelected
+            }, items[index].padEnd(maxItemLength))
+          )
+        );
       }
-      this.nots.push(key);
-      return [strippedKey, false];
-    }
-    if (key.includes("=")) {
-      const eqIndex = key.indexOf("=");
-      const optionKey = key.slice(0, eqIndex);
-      const value = key.slice(eqIndex + 1);
-      return [optionKey, this.parseValue(value)];
-    } else {
-      return [key, true];
     }
+    rows.push(
+      h2(ScreenRow, { key: row, children: h2(import_ink2.Box, { flexDirection: "row" }, ...cols) })
+    );
   }
-  /**
-   * Parse short option (-k=value, -k, or bundled -vsd)
-   */
-  parseShortOption(arg, args, index) {
-    const key = arg.slice(1);
-    if (key.length === 1 && index + 1 < args.length && !args[index + 1].startsWith("-")) {
-      const value = args[index + 1];
-      this.setValue(key, this.parseValue(value));
-      return { consumed: 2 };
+  return h2(import_ink2.Box, { flexDirection: "column" }, ...rows);
+}
+function MultiColumnListWithPreviewComponent({
+  items,
+  getPreviewContent,
+  ctx,
+  selectedIndexRef
+}) {
+  const [, forceUpdate] = (0, import_react2.useState)({});
+  const termWidth = (process.stdout.columns || 80) - 8;
+  const maxItemLength = Math.max(...items.map((w) => w.length));
+  const columnWidth = maxItemLength + 3;
+  const columns = Math.max(1, Math.floor(termWidth / columnWidth));
+  const itemsPerColumn = Math.ceil(items.length / columns);
+  (0, import_react2.useEffect)(() => {
+    ctx.setAction("moveUp", () => {
+      selectedIndexRef.current = Math.max(0, selectedIndexRef.current - 1);
+      forceUpdate({});
+    });
+    ctx.setAction("moveDown", () => {
+      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + 1);
+      forceUpdate({});
+    });
+    ctx.setAction("moveLeft", () => {
+      if (selectedIndexRef.current === 0) {
+        ctx.goBack();
+      } else {
+        selectedIndexRef.current = Math.max(0, selectedIndexRef.current - itemsPerColumn);
+        forceUpdate({});
+      }
+    });
+    ctx.setAction("moveRight", () => {
+      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + itemsPerColumn);
+      forceUpdate({});
+    });
+    ctx.setKeyBinding([
+      { key: "leftArrow", caption: "navigate", action: "moveLeft", order: 0 },
+      { key: "rightArrow", caption: "navigate", action: "moveRight", order: 0 },
+      { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
+      { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
+    ]);
+    ctx.addFooter(`Total: ${items.length} items`);
+  }, []);
+  const selectedIndex = selectedIndexRef.current;
+  const selectedItem = items[selectedIndex];
+  const rows = [];
+  for (let row = 0; row < itemsPerColumn; row++) {
+    const cols = [];
+    for (let col = 0; col < columns; col++) {
+      const index = col * itemsPerColumn + row;
+      if (index < items.length) {
+        const isSelected = index === selectedIndex;
+        cols.push(
+          h2(
+            import_ink2.Box,
+            { key: index, width: columnWidth },
+            h2(import_ink2.Text, {
+              color: isSelected ? "black" : "white",
+              backgroundColor: isSelected ? "cyan" : void 0,
+              bold: isSelected
+            }, items[index].padEnd(maxItemLength))
+          )
+        );
+      }
     }
-    if (key.length > 1 && !key.includes("=")) {
-      for (let i = 0; i < key.length; i++) {
-        const shortKey = key[i];
-        if (shortKey in this.aliases) {
-          this.setValue(shortKey, true);
+    rows.push(
+      h2(ScreenRow, { key: row, children: h2(import_ink2.Box, { flexDirection: "row" }, ...cols) })
+    );
+  }
+  const previewContent = getPreviewContent ? getPreviewContent(selectedItem) : selectedItem;
+  const previewRows = [];
+  if (typeof previewContent === "string") {
+    previewRows.push(h2(ScreenRow, { key: "preview-string", children: h2(import_ink2.Text, { bold: true }, previewContent) }));
+  } else if (typeof previewContent === "object" && !import_react2.default.isValidElement(previewContent) && previewContent !== null) {
+    Object.entries(previewContent).forEach(([key, value], idx) => {
+      previewRows.push(h2(ScreenRow, { key: `preview-${key}-${idx}`, children: h2(import_ink2.Text, {}, `${key}: ${value}`) }));
+    });
+  } else if (import_react2.default.isValidElement(previewContent)) {
+    previewRows.push(h2(ScreenRow, { key: "preview-element", children: previewContent }));
+  }
+  return h2(
+    import_ink2.Box,
+    { flexDirection: "column" },
+    ...rows,
+    h2(ScreenRow, { key: "spacer-1", children: h2(import_ink2.Text, {}, " ") }),
+    h2(ScreenDivider, { key: "divider" }),
+    h2(ScreenRow, { key: "spacer-2", children: h2(import_ink2.Text, {}, " ") }),
+    ...previewRows
+  );
+}
+function ListComponent({ items, ctx, selectedIndexRef, renderItem, getTitle, sortable = false, maxHeight, sortHighlightStyle, selectionMarker = " " }) {
+  const [, forceUpdate] = (0, import_react2.useState)({});
+  const [sortOrder, setSortOrder] = (0, import_react2.useState)("none");
+  const [scrollOffset, setScrollOffset] = (0, import_react2.useState)(0);
+  const scrollStateRef = (0, import_react2.useRef)({ scrollOffset: 0, maxHeight: 0, totalItems: 0 });
+  const defaultGetTitle = (item) => {
+    return getTitle ? getTitle(item) : typeof item.value === "string" ? item.value : item.value?.title || item.name;
+  };
+  const titleGetter = getTitle || defaultGetTitle;
+  const displayItems = sortable && sortOrder !== "none" ? [...items].sort((a, b) => {
+    const titleA = titleGetter(a).toLowerCase();
+    const titleB = titleGetter(b).toLowerCase();
+    if (sortOrder === "asc") {
+      return titleA < titleB ? -1 : titleA > titleB ? 1 : 0;
+    } else {
+      return titleA > titleB ? -1 : titleA < titleB ? 1 : 0;
+    }
+  }) : items;
+  const effectiveMaxHeight = maxHeight || displayItems.length;
+  const canScroll = displayItems.length > effectiveMaxHeight;
+  const maxScrollOffset = Math.max(0, displayItems.length - effectiveMaxHeight);
+  const clampedScrollOffset = Math.min(Math.max(0, scrollOffset), maxScrollOffset);
+  const visibleItems = displayItems.slice(clampedScrollOffset, clampedScrollOffset + effectiveMaxHeight);
+  const canScrollUp = clampedScrollOffset > 0;
+  const canScrollDown = clampedScrollOffset < maxScrollOffset;
+  scrollStateRef.current = { scrollOffset, maxHeight: effectiveMaxHeight, totalItems: displayItems.length };
+  (0, import_react2.useEffect)(() => {
+    ctx.setAction("moveUp", () => {
+      const newIndex = Math.max(0, selectedIndexRef.current - 1);
+      selectedIndexRef.current = newIndex;
+      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
+      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
+      const currentClampedScrollOffset = Math.min(Math.max(0, currentScrollOffset), currentMaxScrollOffset);
+      if (newIndex < currentClampedScrollOffset) {
+        setScrollOffset(newIndex);
+      }
+      forceUpdate({});
+    });
+    ctx.setAction("moveDown", () => {
+      const currentItems = sortable && sortOrder !== "none" ? [...items].sort((a, b) => {
+        const titleA = titleGetter(a).toLowerCase();
+        const titleB = titleGetter(b).toLowerCase();
+        if (sortOrder === "asc") {
+          return titleA < titleB ? -1 : titleA > titleB ? 1 : 0;
         } else {
-          this.args[shortKey] = true;
+          return titleA > titleB ? -1 : titleA < titleB ? 1 : 0;
         }
+      }) : items;
+      const maxIndex = currentItems.length - 1;
+      const newIndex = Math.min(maxIndex, selectedIndexRef.current + 1);
+      selectedIndexRef.current = newIndex;
+      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
+      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
+      const currentClampedScrollOffset = Math.min(Math.max(0, currentScrollOffset), currentMaxScrollOffset);
+      if (newIndex >= currentClampedScrollOffset + currentMaxHeight) {
+        setScrollOffset(newIndex - currentMaxHeight + 1);
       }
-      return { consumed: 1 };
-    }
-    if (key.includes("=")) {
-      const eqIndex = key.indexOf("=");
-      const optionKey = key.slice(0, eqIndex);
-      const value = key.slice(eqIndex + 1);
-      if (optionKey.length > 1) {
-        for (let i = 0; i < optionKey.length - 1; i++) {
-          const shortKey = optionKey[i];
-          if (shortKey in this.aliases) {
-            this.setValue(shortKey, true);
+      forceUpdate({});
+    });
+    ctx.setAction("scrollUp", () => {
+      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
+      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
+      const newScrollOffset = Math.max(0, currentScrollOffset - 1);
+      setScrollOffset(newScrollOffset);
+      forceUpdate({});
+    });
+    ctx.setAction("scrollDown", () => {
+      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
+      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
+      const newScrollOffset = Math.min(currentMaxScrollOffset, currentScrollOffset + 1);
+      setScrollOffset(newScrollOffset);
+      forceUpdate({});
+    });
+    if (sortable) {
+      ctx.setAction("toggleSort", () => {
+        const nextSort = sortOrder === "none" ? "asc" : sortOrder === "asc" ? "desc" : "none";
+        const currentSelectedItem = displayItems[selectedIndexRef.current];
+        setSortOrder(nextSort);
+        const newSortedItems = nextSort !== "none" ? [...items].sort((a, b) => {
+          const titleA = titleGetter(a).toLowerCase();
+          const titleB = titleGetter(b).toLowerCase();
+          if (nextSort === "asc") {
+            return titleA < titleB ? -1 : titleA > titleB ? 1 : 0;
           } else {
-            this.args[shortKey] = true;
+            return titleA > titleB ? -1 : titleA < titleB ? 1 : 0;
           }
+        }) : items;
+        const newIndex = newSortedItems.findIndex((item) => item === currentSelectedItem);
+        if (newIndex !== -1) {
+          selectedIndexRef.current = newIndex;
+          setScrollOffset(newIndex);
+        } else {
+          selectedIndexRef.current = 0;
+          setScrollOffset(0);
         }
-        const lastKey = optionKey[optionKey.length - 1];
-        if (lastKey in this.aliases) {
-          this.setValue(lastKey, this.parseValue(value));
+        forceUpdate({});
+      });
+      const defaultHighlightStyle = {
+        color: "black",
+        backgroundColor: "green",
+        bold: true
+      };
+      const highlightStyle = { ...defaultHighlightStyle, ...sortHighlightStyle };
+      const sortCaption = () => {
+        if (sortOrder === "none") {
+          return h2(import_ink2.Text, {}, "s to toggle sort");
         } else {
-          this.args[lastKey] = this.parseValue(value);
+          const sortLabel = sortOrder === "asc" ? "ASC" : "DESC";
+          return h2(
+            import_ink2.Text,
+            {},
+            "s to toggle ",
+            h2(import_ink2.Text, { color: "white", bold: true }, "sort"),
+            " ",
+            h2(import_ink2.Text, highlightStyle, ` ${sortLabel} `)
+          );
         }
-      } else {
-        this.setValue(optionKey, this.parseValue(value));
-      }
-      return { consumed: 1 };
+      };
+      ctx.setKeyBinding([
+        { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
+        { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 },
+        {
+          key: "s",
+          caption: sortCaption,
+          action: "toggleSort",
+          order: 5
+        }
+      ]);
+      ctx.update();
     } else {
-      this.setValue(key, true);
-      return { consumed: 1 };
-    }
-  }
-  /**
-   * Parse value (handle quotes)
-   */
-  parseValue(value) {
-    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-      return value.slice(1, -1);
+      ctx.setKeyBinding([
+        { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
+        { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
+      ]);
     }
-    return value;
-  }
-  /**
-   * Set a value with proper categorization
-   */
-  setValue(key, value) {
-    const resolvedKey = this.aliases[key] || key;
-    if (typeof value === "boolean") {
-      this.flags[resolvedKey] = value;
+  }, [sortOrder, sortable]);
+  const selectedIndex = selectedIndexRef.current;
+  const defaultRenderItem = (item, isSelected, displayIndex, actualIndex) => {
+    const isFirstVisible = displayIndex === 0;
+    const isLastVisible = displayIndex === visibleItems.length - 1;
+    let arrowPrefix = "";
+    let selectionPrefix = "";
+    if (isFirstVisible && canScrollUp) {
+      arrowPrefix = "\u2191 ";
+    } else if (isLastVisible && canScrollDown) {
+      arrowPrefix = "\u2193 ";
     } else {
-      this.options[resolvedKey] = value;
-    }
-    this.args[resolvedKey.toLowerCase()] = value;
-  }
-  /**
-   * Check for conflicts (short + long form of same option)
-   */
-  checkConflicts() {
-    const conflicts = [];
-    for (const [shortKey, longKey] of Object.entries(this.aliases)) {
-      const hasShort = this.args[shortKey] !== void 0;
-      const hasLong = this.args[longKey] !== void 0;
-      if (hasShort && hasLong) {
-        conflicts.push(`Both -${shortKey} and --${longKey} specified`);
-      }
-    }
-    if (conflicts.length > 0) {
-      throw new Error(`Argument conflicts: ${conflicts.join(", ")}`);
-    }
-  }
-  /**
-   * Get a value with precedence order
-   */
-  get(key) {
-    const resolvedKey = this.aliases[key] || key;
-    this.usedKeys.add(resolvedKey);
-    if (this.overrides[resolvedKey] !== void 0) {
-      return this.overrides[resolvedKey];
-    }
-    const lcKey = resolvedKey.toLowerCase();
-    const lcKeyWithEnv = `${lcKey}${this.env ? `_${this.env.toLowerCase()}` : ""}`;
-    if (this.env && this.args[lcKeyWithEnv] !== void 0) {
-      return this.args[lcKeyWithEnv];
-    } else if (this.args[lcKey] !== void 0) {
-      return this.args[lcKey];
+      arrowPrefix = "  ";
     }
-    if (this.configValues[resolvedKey] !== void 0) {
-      return this.configValues[resolvedKey];
+    if (isSelected) {
+      selectionPrefix = selectionMarker;
+    } else {
+      selectionPrefix = " ".repeat(selectionMarker.length);
     }
-    const envKey = this.toEnvKey(resolvedKey);
-    const envKeyWithEnv = `${envKey}${this.env ? `_${this.env.toUpperCase()}` : ""}`;
-    const envSpecificKey = Object.keys(process.env).find(
-      (k) => this.env && k.toUpperCase() === envKeyWithEnv
+    return h2(
+      import_ink2.Box,
+      { flexDirection: "row" },
+      // Arrow (clickable if functional, not highlighted)
+      h2(import_ink2.Text, {
+        key: `arrow-${actualIndex}`,
+        color: "white"
+      }, arrowPrefix),
+      // Selection marker space (always same width, not highlighted) 
+      h2(import_ink2.Text, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
+      // Item name (highlighted if selected)
+      h2(import_ink2.Text, {
+        key: `name-${actualIndex}`,
+        color: isSelected ? "black" : "white",
+        backgroundColor: isSelected ? "cyan" : void 0,
+        bold: isSelected
+      }, item.name)
     );
-    const envKeyFound = Object.keys(process.env).find((k) => k.toUpperCase() === envKey);
-    if (envSpecificKey) {
-      return process.env[envSpecificKey];
-    } else if (envKeyFound) {
-      return process.env[envKeyFound];
-    }
-    if (this.defaults[resolvedKey] !== void 0) {
-      return this.defaults[resolvedKey];
-    }
-    if (resolvedKey === "env" && process.env.NODE_ENV !== void 0) {
-      return process.env.NODE_ENV;
-    }
-    return void 0;
-  }
-  /**
-   * Set a value (for testing/internal use)
-   */
-  set(key, value) {
-    this.args[key] = value;
-  }
-  /**
-   * Check if a command exists (case-insensitive)
-   */
-  hasCommand(cmd) {
-    return this.commands.some((command) => command.toLowerCase() === cmd.toLowerCase());
-  }
-  /**
-   * Get all commands
-   */
-  getCommands() {
-    return [...this.commands];
-  }
-  /**
-   * Get used keys (as array)
-   */
-  getUsed() {
-    return Array.from(this.usedKeys);
-  }
-  /**
-   * Get unused keys (as array)
-   */
-  getUnused() {
-    const unused = [];
-    for (const key of Object.keys(this.args)) {
-      if (!this.usedKeys.has(key) && !this.nots.includes(key)) {
-        unused.push(key);
+  };
+  const itemRenderer = renderItem || defaultRenderItem;
+  return h2(
+    import_ink2.Box,
+    { flexDirection: "column" },
+    ...visibleItems.map((item, displayIndex) => {
+      const actualIndex = clampedScrollOffset + displayIndex;
+      const isSelected = actualIndex === selectedIndex;
+      if (renderItem) {
+        const isFirstVisible = displayIndex === 0;
+        const isLastVisible = displayIndex === visibleItems.length - 1;
+        let arrowPrefix = "";
+        let selectionPrefix = "";
+        if (isFirstVisible && canScrollUp) {
+          arrowPrefix = "\u2191 ";
+        } else if (isLastVisible && canScrollDown) {
+          arrowPrefix = "\u2193 ";
+        } else {
+          arrowPrefix = "  ";
+        }
+        if (isSelected) {
+          selectionPrefix = selectionMarker;
+        } else {
+          selectionPrefix = " ".repeat(selectionMarker.length);
+        }
+        return h2(ScreenRow, {
+          key: `item-${actualIndex}`,
+          children: h2(
+            import_ink2.Box,
+            { flexDirection: "row" },
+            // Arrow (clickable if functional, not highlighted)
+            h2(import_ink2.Text, {
+              key: `arrow-${actualIndex}`,
+              color: "white"
+            }, arrowPrefix),
+            // Selection marker space (always same width, not highlighted) 
+            h2(import_ink2.Text, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
+            // Custom rendered content
+            renderItem(item, isSelected, displayIndex)
+          )
+        });
+      } else {
+        return h2(ScreenRow, {
+          key: `item-${actualIndex}`,
+          children: itemRenderer(item, isSelected, displayIndex, actualIndex)
+        });
       }
-    }
-    return unused;
-  }
-  /**
-   * Convert key to environment variable format
-   */
-  toEnvKey(key) {
-    return key.replace(
-      /[A-Z0-9]/g,
-      (match, offset) => offset === 0 ? match : "_" + match.toLowerCase()
-    ).toUpperCase();
+    })
+  );
+}
+var import_react2, import_ink2, h2;
+var init_list_components = __esm({
+  "src/screen/list-components.ts"() {
+    "use strict";
+    import_react2 = __toESM(require("react"), 1);
+    import_ink2 = require("ink");
+    init_components();
+    h2 = import_react2.createElement;
   }
-  /**
-   * Load .env file
-   */
-  loadDotEnv() {
-    const dotEnvPath = this.get("dotEnvPath") || process.cwd();
-    const dotEnvFile = this.get("dotEnvFile") || ".env";
-    if (this.get("dotEnvFile")) {
-      const customPath = (0, import_path.resolve)(dotEnvPath, dotEnvFile);
-      if ((0, import_fs.existsSync)(customPath)) {
-        (0, import_dotenv.config)({ path: customPath, quiet: true });
-      }
-      return;
+});
+
+// src/screen/screens.ts
+function groupKeyBindings(bindings) {
+  const groups = {};
+  const enabledBindings = bindings.filter((b) => b.enabled !== false);
+  enabledBindings.forEach((binding) => {
+    const caption = typeof binding.caption === "string" ? binding.caption : "";
+    if (!groups[caption]) {
+      groups[caption] = {
+        keys: [],
+        caption,
+        order: binding.order || 999
+      };
     }
-    let dotEnvPathFile = null;
-    const envSpecificFile = `.env.${this.env}`;
-    const envSpecificPath = (0, import_path.resolve)(dotEnvPath, envSpecificFile);
-    if ((0, import_fs.existsSync)(envSpecificPath)) {
-      dotEnvPathFile = envSpecificPath;
+    groups[caption].keys.push(binding.key);
+  });
+  return Object.values(groups);
+}
+function formatKeyBindings(bindings, mode = "long") {
+  const resolvedBindings = bindings.map((binding) => {
+    let resolvedCaption = binding.caption;
+    if (typeof binding.caption === "function") {
+      resolvedCaption = binding.caption();
     }
-    if (!dotEnvPathFile && !this.get("dotEnvPath")) {
-      const examplesPath = (0, import_path.resolve)(dotEnvPath, "examples");
-      const examplesEnvSpecificPath = (0, import_path.resolve)(examplesPath, envSpecificFile);
-      if ((0, import_fs.existsSync)(examplesEnvSpecificPath)) {
-        dotEnvPathFile = examplesEnvSpecificPath;
+    return {
+      ...binding,
+      resolvedCaption
+    };
+  });
+  const groups = groupKeyBindings(resolvedBindings.map((b) => ({
+    ...b,
+    caption: typeof b.resolvedCaption === "string" ? b.resolvedCaption : ""
+  })));
+  groups.sort((a, b) => a.order - b.order);
+  const items = [];
+  groups.forEach((group) => {
+    const bindingWithCustom = resolvedBindings.find(
+      (b) => group.keys.includes(b.key) && typeof b.resolvedCaption !== "string"
+    );
+    if (bindingWithCustom && bindingWithCustom.resolvedCaption) {
+      items.push(bindingWithCustom.resolvedCaption);
+    } else {
+      const keyStr = formatKeys(group.keys);
+      if (mode === "long") {
+        items.push(`${keyStr} to ${group.caption}`);
+      } else {
+        items.push(keyStr);
       }
     }
-    if (!dotEnvPathFile) {
-      dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, dotEnvFile);
-      if (!(0, import_fs.existsSync)(dotEnvPathFile)) {
-        if (!this.get("dotEnvPath")) {
-          const examplesPath = (0, import_path.resolve)(dotEnvPath, "examples");
-          const examplesEnvFile = (0, import_path.resolve)(examplesPath, dotEnvFile);
-          if ((0, import_fs.existsSync)(examplesEnvFile)) {
-            dotEnvPathFile = examplesEnvFile;
-          } else {
-            dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, "..", dotEnvFile);
+  });
+  return items;
+}
+function formatKeys(keys) {
+  const keyMap = {
+    "escape": "esc",
+    "leftArrow": "\u2190",
+    "rightArrow": "\u2192",
+    "upArrow": "\u2191",
+    "downArrow": "\u2193",
+    "return": "enter"
+  };
+  return keys.map((k) => keyMap[k] || k).join("/");
+}
+async function showScreen(config2) {
+  const {
+    title,
+    onRender,
+    parentData = {}
+  } = config2;
+  return new Promise((resolve2) => {
+    let instance2;
+    const keyBindings = [];
+    const actions = {};
+    const customFooterItems = [];
+    let renderResult = null;
+    let initialized = false;
+    const Screen = () => {
+      const [updateCounter, setUpdateCounter] = (0, import_react3.useState)(0);
+      if (!initialized) {
+        const defaultBindings = [
+          { key: "escape", caption: "go back", action: "back", protected: true, order: 1 },
+          { key: "leftArrow", caption: "go back", action: "back", protected: false, order: 1 }
+          // Note: 'select' is not a default - components add it if needed
+        ];
+        defaultBindings.forEach((binding) => {
+          keyBindings.push(binding);
+        });
+        actions.back = () => {
+          cleanup(null);
+        };
+        initialized = true;
+      }
+      const context = {
+        setAction: (actionName, handlerFn) => {
+          actions[actionName] = handlerFn;
+        },
+        setKeyBinding: (bindingOrBindings) => {
+          const bindingsToSet = Array.isArray(bindingOrBindings) ? bindingOrBindings : [bindingOrBindings];
+          bindingsToSet.forEach((binding) => {
+            const existingIndex = keyBindings.findIndex((b) => b.key === binding.key);
+            if (existingIndex >= 0) {
+              const existing = keyBindings[existingIndex];
+              if (existing.protected) {
+                console.warn(`Cannot override protected key: ${binding.key}`);
+                return;
+              }
+              keyBindings[existingIndex] = {
+                ...existing,
+                ...binding,
+                order: binding.order !== void 0 ? binding.order : existing.order,
+                enabled: binding.enabled !== void 0 ? binding.enabled : existing.enabled !== void 0 ? existing.enabled : true
+              };
+            } else {
+              keyBindings.push({
+                protected: false,
+                order: 999,
+                enabled: true,
+                ...binding
+              });
+            }
+          });
+        },
+        updateKeyBinding: (keyName, updates) => {
+          const index = keyBindings.findIndex((b) => b.key === keyName);
+          if (index >= 0) {
+            keyBindings[index] = {
+              ...keyBindings[index],
+              ...updates
+            };
           }
-        }
+        },
+        removeKeyBinding: (keyName) => {
+          const index = keyBindings.findIndex((b) => b.key === keyName);
+          if (index >= 0) {
+            if (keyBindings[index].protected) {
+              console.warn(`Cannot remove protected key: ${keyName}`);
+              return;
+            }
+            keyBindings.splice(index, 1);
+          }
+        },
+        addFooter: (item) => {
+          customFooterItems.push(item);
+        },
+        clearFooter: () => {
+          customFooterItems.length = 0;
+        },
+        setFooter: (items) => {
+          customFooterItems.length = 0;
+          const itemsArray = Array.isArray(items) ? items : [items];
+          customFooterItems.push(...itemsArray);
+        },
+        update: () => {
+          setUpdateCounter((c) => c + 1);
+        },
+        goBack: () => {
+          if (actions.back) {
+            actions.back();
+          }
+        },
+        close: (result) => {
+          cleanup(result);
+        },
+        parentData
+      };
+      if (!renderResult) {
+        renderResult = onRender(context);
       }
-    }
-    if (dotEnvPathFile && (0, import_fs.existsSync)(dotEnvPathFile)) {
-      (0, import_dotenv.config)({ path: dotEnvPathFile, quiet: true });
-    }
-  }
-  /**
-   * Load configuration files
-   */
-  loadConfigFiles() {
-    this.configsLoaded = [];
-    this.configValues = {};
-    const _defaultConfigExtension = this.get("defaultConfigExtension") || "js";
-    const optConfigFiles = this.get("config") || this.get("configs") || "";
-    const configFiles = optConfigFiles ? optConfigFiles.split(/,\s*/) : [];
-    const optConfigFilePath = this.get("configPath");
-    if (configFiles.length > 0) {
-      for (const cfgFile of configFiles) {
-        let notLoaded = false;
-        let notLoadedEnvSpecific = false;
-        const cfgFileWithPath = this.resolveFileWithPath(optConfigFilePath, cfgFile);
-        try {
-          const cfgContents = this.requireConfigFile(cfgFileWithPath);
-          this.configValues = { ...this.configValues, ...cfgContents };
-          this.configsLoaded.push(cfgFileWithPath);
-        } catch {
-          notLoaded = true;
+      (0, import_ink3.useInput)((input, key) => {
+        if (key.ctrl && input === "c") {
+          cleanup(null);
+          process.exit(0);
+          return;
         }
-        const cfgEnvFileWithPath = this.resolveFileWithPath(
-          optConfigFilePath,
-          cfgFile,
-          this.env
-        );
-        if (cfgEnvFileWithPath !== cfgFileWithPath) {
-          try {
-            const cfgContents = this.requireConfigFile(cfgEnvFileWithPath);
-            this.configValues = { ...this.configValues, ...cfgContents };
-            this.configsLoaded.push(cfgEnvFileWithPath);
-          } catch {
-            notLoadedEnvSpecific = true;
+        let matchedBinding = null;
+        for (const binding of keyBindings) {
+          let keyMatches = false;
+          if (key[binding.key]) {
+            keyMatches = true;
+          } else if (input === binding.key) {
+            keyMatches = true;
+          }
+          if (keyMatches) {
+            if (binding.enabled === false) {
+              continue;
+            }
+            if (binding.condition && !binding.condition(context)) {
+              continue;
+            }
+            matchedBinding = binding;
+            break;
           }
-        } else {
-          notLoadedEnvSpecific = true;
         }
-        if (notLoaded && notLoadedEnvSpecific) {
-          throw new Error(`can't load config file "${cfgFileWithPath}"`);
+        if (matchedBinding && actions[matchedBinding.action]) {
+          const actionResult = actions[matchedBinding.action]({
+            input,
+            key,
+            binding: matchedBinding
+          });
+        }
+      });
+      const footerLines = [];
+      const bindingItems = formatKeyBindings(keyBindings, "long");
+      if (bindingItems.length > 0) {
+        const bindingsLine = [];
+        bindingItems.forEach((item, idx) => {
+          if (idx > 0) {
+            bindingsLine.push(", ");
+          }
+          bindingsLine.push(item);
+        });
+        const allStrings = bindingItems.every((item) => typeof item === "string");
+        if (allStrings) {
+          footerLines.push(bindingsLine.join(""));
+        } else {
+          const wrappedBindingsLine = bindingsLine.map(
+            (item) => typeof item === "string" ? (0, import_react3.createElement)(import_ink3.Text, {}, item) : item
+          );
+          footerLines.push(wrappedBindingsLine);
         }
       }
-    }
-  }
-  /**
-   * Resolve file path with environment-specific naming
-   */
-  resolveFileWithPath(optConfigFilePath, cfgFile, env) {
-    let cfgFileWithPath = optConfigFilePath ? (0, import_path.isAbsolute)(optConfigFilePath) ? (0, import_path.resolve)(optConfigFilePath, cfgFile) : (0, import_path.resolve)(process.cwd(), optConfigFilePath, cfgFile) : (0, import_path.isAbsolute)(cfgFile) ? cfgFile : (0, import_path.resolve)(process.cwd(), cfgFile);
-    const { basePathWithName, extension } = this.splitPath(cfgFileWithPath);
-    if (env) {
-      cfgFileWithPath = `${basePathWithName}.${env}.${extension || "js"}`;
-    } else {
-      cfgFileWithPath = `${basePathWithName}.${extension || "js"}`;
-    }
-    return cfgFileWithPath;
-  }
-  /**
-   * Split file path into base path and extension
-   */
-  splitPath(filePath) {
-    const basePathWithName = (0, import_path.join)((0, import_path.dirname)(filePath), (0, import_path.basename)(filePath, (0, import_path.extname)(filePath)));
-    const extension = (0, import_path.extname)(filePath).slice(1);
-    return { basePathWithName, extension };
-  }
-  /**
-   * Require a configuration file (supports .js and .json)
-   */
-  requireConfigFile(filePath) {
-    if (!(0, import_fs.existsSync)(filePath)) {
-      throw new Error(`Config file not found: ${filePath}`);
-    }
-    const ext = (0, import_path.extname)(filePath).toLowerCase();
-    if (ext === ".json") {
-      const content = (0, import_fs.readFileSync)(filePath, "utf8");
-      return JSON.parse(content);
-    } else if (ext === ".js") {
-      try {
-        delete require.cache[require.resolve(filePath)];
-        return require(filePath);
-      } catch (error) {
-        throw new Error(`Failed to load JS config file: ${error instanceof Error ? error.message : String(error)}`);
-      }
-    } else {
-      throw new Error(`Unsupported file extension: ${ext}`);
-    }
-  }
-  /**
-   * Get all parsed data
-   */
-  getParsed() {
-    return {
-      command: this.commands[0] || "",
-      flags: { ...this.flags },
-      options: { ...this.options },
-      usedKeys: Array.from(this.usedKeys)
+      customFooterItems.forEach((item) => {
+        if (typeof item === "string") {
+          footerLines.push(item);
+        } else {
+          footerLines.push(item);
+        }
+      });
+      return (0, import_react3.createElement)(
+        ScreenContainer,
+        {},
+        (0, import_react3.createElement)(ScreenTitle, { text: title }),
+        (0, import_react3.createElement)(ScreenDivider),
+        (0, import_react3.createElement)(ScreenRow, {}, (0, import_react3.createElement)(import_ink3.Text, {}, " ")),
+        renderResult,
+        (0, import_react3.createElement)(ScreenRow, {}, (0, import_react3.createElement)(import_ink3.Text, {}, " ")),
+        (0, import_react3.createElement)(ScreenDivider),
+        (0, import_react3.createElement)(ScreenFooter, { lines: footerLines })
+      );
     };
-  }
-  /**
-   * Set prefixes dynamically and re-parse arguments (like legacy)
-   */
-  setPrefixes(prefixes) {
-    const arr = Array.isArray(prefixes) ? prefixes : prefixes.split(/,\s*/);
-    const sortedArr = arr.sort(
-      (a, b) => a.length < b.length ? 1 : a.length > b.length ? -1 : 0
-    );
-    this.prefixes = sortedArr.map((el) => el.toLowerCase());
-    const args = process.argv.slice(2);
-    this.parseArgs(args);
-  }
-};
-var instance = null;
-function getArgsInstance() {
-  return instance;
+    const cleanup = (result) => {
+      if (instance2) instance2.unmount();
+      setTimeout(() => resolve2(result), 50);
+    };
+    instance2 = (0, import_ink3.render)((0, import_react3.createElement)(Screen));
+  });
 }
-
-// src/params/index.ts
-var import_joi = __toESM(require("joi"), 1);
-
-// src/errors.ts
-var FrameworkError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "FrameworkError";
-  }
-};
-var ParamError = class extends FrameworkError {
-  constructor(message) {
-    super(message);
-    this.name = "ParamError";
-  }
-};
-
-// src/params/custom-types.ts
-var joiEdateType = (value, helpers) => {
-  if (typeof value === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/.test(value)) {
-    const testDate = new Date(value);
-    if (!isNaN(testDate.getTime())) {
-      return value;
-    }
-  }
-  if (value instanceof Date) {
-    return value.toISOString();
-  }
-  if (typeof value !== "string") {
-    value = String(value);
-  }
-  if (value.toLowerCase() === "now") {
-    return (/* @__PURE__ */ new Date()).toISOString();
-  }
-  const referenceRegex = /^@(\w+)([+-]\d+[smhdwy])$/i;
-  const referenceMatch = value.match(referenceRegex);
-  if (referenceMatch) {
-    const [, paramName, relativeExpr] = referenceMatch;
-    const context = helpers.prefs?.context;
-    if (!context || !context.params) {
-      throw new ParamError(`Cannot resolve cross-parameter reference @${paramName}: context not available. Ensure parameters are processed with proper context.`);
-    }
-    const referencedValue = context.params[paramName];
-    if (referencedValue === void 0 || referencedValue === null) {
-      throw new ParamError(`Cannot resolve @${paramName}: parameter "${paramName}" is not defined or has no value. Parameters are evaluated left-to-right.`);
-    }
-    let referenceDate;
-    if (referencedValue instanceof Date) {
-      referenceDate = referencedValue;
-    } else if (typeof referencedValue === "string") {
-      referenceDate = new Date(referencedValue);
-      if (isNaN(referenceDate.getTime())) {
-        throw new ParamError(`Referenced parameter @${paramName} has invalid date value: ${referencedValue}`);
+async function showListScreen(config2) {
+  const { title, items, onSelect, onEscape, parentData, initialSelectedIndex = 0, renderItem, getTitle, sortable, maxHeight, sortHighlightStyle, selectionMarker } = config2;
+  return showScreen({
+    title,
+    parentData,
+    onRender: (ctx) => {
+      const selectedIndexRef = { current: initialSelectedIndex };
+      ctx.setAction("select", () => {
+        const selected = items[selectedIndexRef.current];
+        if (onSelect) {
+          const result = onSelect(selected.value, selectedIndexRef.current);
+          ctx.close(result);
+        }
+      });
+      if (onEscape) {
+        ctx.setAction("back", () => {
+          const result = onEscape(selectedIndexRef.current);
+          ctx.close(result);
+        });
       }
-    } else {
-      throw new ParamError(`Referenced parameter @${paramName} is not a valid date type (found: ${typeof referencedValue})`);
-    }
-    const relativeMatch2 = relativeExpr.match(/^([+-])(\d+)([smhdwy])$/i);
-    if (!relativeMatch2) {
-      throw new ParamError(`Invalid relative time expression in @${paramName}${relativeExpr}`);
-    }
-    const [, sign, amount, unit] = relativeMatch2;
-    const offset = calculateTimeOffset(parseInt(amount, 10), unit, sign);
-    const resultDate = new Date(referenceDate.getTime() + offset);
-    return resultDate.toISOString();
-  }
-  const relativeTimeRegex = /^([+-])(\d+)([smhdwy])$/i;
-  const relativeMatch = value.match(relativeTimeRegex);
-  if (relativeMatch) {
-    const [, sign, amount, unit] = relativeMatch;
-    const numAmount = parseInt(amount, 10);
-    if (isNaN(numAmount)) {
-      throw new ParamError(`Invalid relative time amount: ${amount}`);
+      ctx.setKeyBinding({ key: "return", caption: "select", action: "select", order: 2 });
+      return (0, import_react3.createElement)(ListComponent, { items, ctx, selectedIndexRef, renderItem, getTitle, sortable, maxHeight, sortHighlightStyle, selectionMarker });
     }
-    const offset = calculateTimeOffset(numAmount, unit, sign);
-    const resultDate = new Date(Date.now() + offset);
-    return resultDate.toISOString();
-  }
-  const parsedDate = new Date(value);
-  if (isNaN(parsedDate.getTime())) {
-    throw new ParamError(`Invalid date format: ${value}. Expected a valid date string, "now", relative time expression (e.g., "-2h", "+1d"), or cross-parameter reference (e.g., "@startTime+2h")`);
-  }
-  return parsedDate.toISOString();
-};
-function calculateTimeOffset(amount, unit, sign) {
-  let multiplier = 1;
-  switch (unit.toLowerCase()) {
-    case "s":
-      multiplier = 1e3;
-      break;
-    case "m":
-      multiplier = 60 * 1e3;
-      break;
-    case "h":
-      multiplier = 60 * 60 * 1e3;
-      break;
-    case "d":
-      multiplier = 24 * 60 * 60 * 1e3;
-      break;
-    case "w":
-      multiplier = 7 * 24 * 60 * 60 * 1e3;
-      break;
-    case "y":
-      multiplier = 365 * 24 * 60 * 60 * 1e3;
-      break;
-    default:
-      throw new ParamError(`Invalid time unit: ${unit}. Supported units: s, m, h, d, w, y`);
-  }
-  return sign === "+" ? amount * multiplier : -amount * multiplier;
+  });
 }
-var joiStringArrayType = (type) => (value, helpers) => {
-  if (value === void 0 || typeof value === "function") {
-    return [];
-  }
-  const arr = value.split(/,\s*/).map((el) => {
-    if (type === "number") {
-      const v = parseInt(el, 10);
-      if (isNaN(v)) {
-        throw new ParamError(`array element "${el}" should be numeric`);
+async function showMultiColumnListScreen(config2) {
+  const { title, items, onSelect, onEscape, parentData, initialSelectedIndex = 0 } = config2;
+  return showScreen({
+    title,
+    parentData,
+    onRender: (ctx) => {
+      const selectedIndexRef = { current: initialSelectedIndex };
+      ctx.setAction("select", () => {
+        const selected = items[selectedIndexRef.current];
+        if (onSelect) {
+          const result = onSelect(selected, selectedIndexRef.current);
+          ctx.close(result);
+        }
+      });
+      if (onEscape) {
+        ctx.setAction("back", () => {
+          const result = onEscape(selectedIndexRef.current);
+          ctx.close(result);
+        });
       }
-      return v;
-    } else if (type === "boolean") {
-      const v = el.match(/true|t|yes|1/i) ? true : el.match(/false|f|no|0/i) ? false : null;
-      if (v === null) {
-        throw new ParamError(`array element "${el}" should be boolean`);
+      ctx.setKeyBinding({ key: "return", caption: "select", action: "select", order: 2 });
+      return (0, import_react3.createElement)(MultiColumnListComponent, { items, ctx, selectedIndexRef });
+    }
+  });
+}
+async function showMultiColumnListWithPreviewScreen(config2) {
+  const { title, items, getPreviewContent, onSelect, onEscape, parentData, initialSelectedIndex = 0 } = config2;
+  return showScreen({
+    title,
+    parentData,
+    onRender: (ctx) => {
+      const selectedIndexRef = { current: initialSelectedIndex };
+      ctx.setAction("select", () => {
+        const selected = items[selectedIndexRef.current];
+        if (onSelect) {
+          const result = onSelect(selected, selectedIndexRef.current);
+          ctx.close(result);
+        }
+      });
+      if (onEscape) {
+        ctx.setAction("back", () => {
+          const result = onEscape(selectedIndexRef.current);
+          ctx.close(result);
+        });
       }
-      return v;
-    } else if (type === "string") {
-      return el;
-    } else {
-      throw new ParamError(`unknown type "${type}" for array elements`);
+      ctx.setKeyBinding({ key: "return", caption: "select", action: "select", order: 2 });
+      return (0, import_react3.createElement)(MultiColumnListWithPreviewComponent, { items, getPreviewContent, ctx, selectedIndexRef });
     }
   });
-  return arr;
-};
+}
+var import_react3, import_ink3, showMenuScreen, showWordGridScreen;
+var init_screens = __esm({
+  "src/screen/screens.ts"() {
+    "use strict";
+    import_react3 = require("react");
+    import_ink3 = require("ink");
+    init_components();
+    init_list_components();
+    showMenuScreen = showListScreen;
+    showWordGridScreen = showMultiColumnListScreen;
+  }
+});
 
-// src/params/index.ts
-var Params = class {
-  params = {};
-  definitions = {};
-  args;
-  paramSetters = [];
-  paramGetters = [];
-  constructor({ args }, opts = {}) {
-    this.args = args;
-    for (const [k, v] of Object.entries(opts)) {
-      this.params[k] = v;
-    }
+// src/screen/ui-elements.ts
+function ListItem({
+  children,
+  isSelected = false,
+  color = "white",
+  backgroundColor,
+  bold = false,
+  dimColor = false
+}) {
+  return (0, import_react4.createElement)(
+    import_ink4.Box,
+    {},
+    (0, import_react4.createElement)(import_ink4.Text, {
+      color: isSelected ? backgroundColor || "green" : color,
+      backgroundColor: isSelected ? color : backgroundColor,
+      bold: isSelected || bold,
+      dimColor: !isSelected && dimColor
+    }, children)
+  );
+}
+function TextBlock({
+  text,
+  color = "white",
+  dimmed = false,
+  bold = false,
+  maxWidth
+}) {
+  return (0, import_react4.createElement)(
+    import_ink4.Box,
+    {},
+    (0, import_react4.createElement)(import_ink4.Text, {
+      color,
+      dimColor: dimmed,
+      bold
+    }, text)
+  );
+}
+function Divider({ character = "\u2500", width = 80 }) {
+  return (0, import_react4.createElement)(
+    import_ink4.Box,
+    { marginY: 1 },
+    (0, import_react4.createElement)(import_ink4.Text, { dimColor: true }, character.repeat(width))
+  );
+}
+function GridCell({
+  children,
+  width,
+  color = "white",
+  backgroundColor,
+  bold = false,
+  dimColor = false,
+  align = "left"
+}) {
+  return (0, import_react4.createElement)(
+    import_ink4.Box,
+    { width },
+    (0, import_react4.createElement)(import_ink4.Text, {
+      color,
+      backgroundColor,
+      bold,
+      dimColor,
+      textAlign: align
+    }, children)
+  );
+}
+function InputField({ prompt, value, onChange, onSubmit }) {
+  return (0, import_react4.createElement)(
+    import_ink4.Box,
+    { flexDirection: "column" },
+    (0, import_react4.createElement)(import_ink4.Text, {}, prompt),
+    (0, import_react4.createElement)(
+      import_ink4.Box,
+      { marginTop: 1 },
+      (0, import_react4.createElement)(import_ink4.Text, { color: "cyan" }, " > ", value, "_")
+    )
+  );
+}
+var import_react4, import_ink4;
+var init_ui_elements = __esm({
+  "src/screen/ui-elements.ts"() {
+    "use strict";
+    import_react4 = require("react");
+    import_ink4 = require("ink");
   }
-  /**
-   * Assign a parameter definition
-   */
-  assignDefinition(key, definition) {
-    if (this.definitions[key] && !definition) {
-      return this.definitions[key];
-    }
-    let type;
-    if (!definition) {
-      type = import_joi.default.string();
-    } else if (import_joi.default.isSchema(definition)) {
-      type = definition;
-    } else if (import_joi.default.isSchema(definition.type)) {
-      type = definition.type;
-    } else if (typeof definition === "string") {
-      type = this.toJoi(definition);
-    } else if (typeof definition.type === "string") {
-      type = this.toJoi(definition.type);
-    } else if (!definition.type) {
-      type = import_joi.default.string();
-    } else {
-      type = import_joi.default.string();
-    }
-    if (!this.definitions[key]) {
-      this.definitions[key] = {};
-    }
-    this.definitions[key].type = type;
-    if (definition && definition.values) {
-      if (Array.isArray(definition.values)) {
-        this.definitions[key].values = definition.values;
-      }
-    }
-    return this.definitions[key];
+});
+
+// src/screen/utils.ts
+function buildBreadcrumb(parts) {
+  if (parts.length === 0) return "";
+  if (parts.length === 1) return parts[0];
+  return parts.slice(1).map((part) => `\u2190  ${part}`).join("  ");
+}
+function buildDetailBreadcrumb(path4, suffix = "") {
+  if (path4.length <= 1) {
+    return suffix ? `\u2190  ${suffix}` : path4[0] || "";
   }
-  /**
-   * Convert string definition to Joi schema
-   */
-  toJoi(str) {
-    let type;
-    if (str.match(/^string|^text/i)) {
-      type = import_joi.default.string();
-    } else if (str.match(/^number|^integer|^int/i)) {
-      type = import_joi.default.number();
-    } else if (str.match(/^boolean|^bool/i)) {
-      type = import_joi.default.boolean();
-    } else if (str.match(/^date/i)) {
-      type = import_joi.default.custom(joiEdateType);
-    } else if (str.match(/^duration/i)) {
-      type = import_joi.default.string().isoDuration();
-    } else if (str.match(/^array/i)) {
-      let elementTypes = "string";
-      const tmp = str.match(/\((.*)\)/);
-      if (tmp && tmp[1].match(/string/i)) {
-        elementTypes = "string";
-      } else if (tmp && tmp[1].match(/number|integer|int/i)) {
-        elementTypes = "number";
-      } else if (tmp && tmp[1].match(/boolean|bool/i)) {
-        elementTypes = "boolean";
-      }
-      type = import_joi.default.custom(joiStringArrayType(elementTypes));
-    } else {
-      type = import_joi.default.string();
-    }
-    const regexForDefault = /\bdefault\s+([^\s]+)/;
-    const matchForDefault = str.match(regexForDefault);
-    if (matchForDefault) {
-      const defValObj = type.validate(matchForDefault[1]);
-      if (defValObj.error) {
-        throw new ParamError(`default value "${defValObj.value}" type mismatch`);
-      }
-      type = type.default(defValObj.value);
-    } else if (str.match(/required/)) {
-      type = type.required();
-    }
-    return type;
+  const breadcrumb = buildBreadcrumb(path4);
+  return suffix ? `${breadcrumb} ${suffix}` : breadcrumb;
+}
+var init_utils = __esm({
+  "src/screen/utils.ts"() {
+    "use strict";
   }
-  /**
-   * Validate a value against a definition
-   */
-  validate(key, val, def) {
-    const { value, error } = def.type.validate(val, { context: { params: this.params } });
-    if (error) {
-      const errs = error.details.map((el) => el.message).join(", ");
-      throw new ParamError(`"${key}" validation error: ${errs}`);
-    }
-    return value;
+});
+
+// src/screen/footer-builder.ts
+function buildFooter(config2 = {}) {
+  const {
+    navigation = null,
+    actions = null,
+    info = null,
+    escape = "Esc to go back",
+    custom = null
+  } = config2;
+  const lines = [];
+  const mainParts = [];
+  if (navigation) {
+    mainParts.push(navigation);
   }
-  /**
-   * Get a parameter value with validation
-   */
-  get(key, definition) {
-    const def = this.assignDefinition(key, definition);
-    let valFromGetters = void 0;
-    if (def.volatile || true) {
-      valFromGetters = this.runAllRegisteredGetters(key);
-    }
-    const valFromArgs = this.args.get(key);
-    const valFromParams = this.params[key];
-    const res = valFromGetters ? this.validate(key, valFromGetters, def) : valFromArgs ? this.validate(key, valFromArgs, def) : this.validate(key, valFromParams, def);
-    if (res !== void 0 && def.values && !def.values.includes(res)) {
-      throw new ParamError(`key ${key} should be one of ${def.values}`);
-    }
-    return res;
+  if (actions) {
+    mainParts.push(actions);
   }
-  /**
-   * Set a parameter value with validation
-   */
-  set(key, val, definition) {
-    if (val && val.type && val.value) {
-      definition = val;
-      val = val.value;
-    }
-    const def = this.assignDefinition(key, definition);
-    if (!this.runAllRegisteredSetters(key, val)) {
-      this.params[key] = val;
-    }
+  if (escape) {
+    mainParts.push(escape);
   }
-  /**
-   * Get all parameters from definitions
-   * Processes parameters left-to-right to support cross-parameter references
-   */
-  getAll(defs) {
-    const res = {};
-    for (const [k, def] of Object.entries(defs)) {
-      const value = this.get(k, def);
-      res[k] = value;
-      if (value !== void 0) {
-        this.params[k] = value;
-      }
-    }
-    return res;
+  if (mainParts.length > 0) {
+    lines.push(mainParts.join(", "));
   }
-  /**
-   * Run all registered getters for a key
-   */
-  runAllRegisteredGetters(key) {
-    let val = null;
-    for (const getter of this.paramGetters) {
-      val = getter(key, this.definitions[key]);
-      if (val !== void 0) {
-        break;
-      }
-    }
-    return val;
+  if (info) {
+    const infoLines = Array.isArray(info) ? info : [info];
+    lines.push(...infoLines);
   }
-  /**
-   * Run all registered setters for a key
-   */
-  runAllRegisteredSetters(key, value) {
-    let setterUsed = false;
-    for (const setter of this.paramSetters) {
-      setterUsed = setter(key, value);
-      if (setterUsed) {
-        break;
+  if (custom) {
+    const customLines = Array.isArray(custom) ? custom : [custom];
+    lines.push(...customLines);
+  }
+  return lines;
+}
+function organizeFooterMessages(messages) {
+  if (!messages || messages.length === 0) {
+    return ["Esc to go back"];
+  }
+  const navigation = messages.filter((m) => m.includes("\u2191") || m.includes("\u2193") || m.includes("\u2190") || m.includes("\u2192"));
+  const actions = messages.filter((m) => m.includes("Enter") || m.includes("select") || m.includes("submit"));
+  const escape = messages.filter((m) => m.includes("Esc"));
+  const others = messages.filter(
+    (m) => !navigation.includes(m) && !actions.includes(m) && !escape.includes(m)
+  );
+  const lines = [];
+  const mainLine = [...navigation, ...actions, ...escape].join(", ");
+  if (mainLine) lines.push(mainLine);
+  lines.push(...others);
+  return lines;
+}
+var FooterPresets;
+var init_footer_builder = __esm({
+  "src/screen/footer-builder.ts"() {
+    "use strict";
+    FooterPresets = {
+      /**
+       * Menu screen footer
+       */
+      menu: (customInfo = null) => buildFooter({
+        navigation: "\u2191/\u2193 to navigate",
+        actions: "Enter to select",
+        escape: "Esc to go back",
+        info: customInfo
+      }),
+      /**
+       * Word grid footer
+       */
+      wordGrid: (totalWords) => buildFooter({
+        navigation: "\u2191\u2193\u2190\u2192 to navigate",
+        actions: "Enter to select",
+        escape: "Esc to go back",
+        info: `Total: ${totalWords} words`
+      }),
+      /**
+       * Text input footer
+       */
+      textInput: () => buildFooter({
+        actions: "Type and press Enter to submit",
+        escape: "Esc to cancel"
+      }),
+      /**
+       * Info/static screen footer
+       */
+      info: () => buildFooter({
+        escape: "Esc to continue"
+      }),
+      /**
+       * Main menu footer (escape exits)
+       */
+      mainMenu: () => buildFooter({
+        navigation: "\u2191/\u2193 to navigate",
+        actions: "Enter to select",
+        escape: "Esc to exit"
+      }),
+      /**
+       * Action menu footer (for word cards, etc.)
+       */
+      actionMenu: (hasAudio = false) => {
+        const parts = buildFooter({
+          navigation: "\u2191/\u2193 to navigate",
+          actions: "Enter to select",
+          escape: "Esc to go back"
+        });
+        if (hasAudio) {
+          parts.push("Audio available");
+        }
+        return parts;
       }
+    };
+  }
+});
+
+// src/screen/index.ts
+async function load() {
+  if (loadPromise) return loadPromise;
+
+  loadPromise = Promise.resolve();
+  return loadPromise;
+}
+var import_react5, import_ink5, loadPromise;
+var init_screen = __esm({
+  "src/screen/index.ts"() {
+    "use strict";
+    import_react5 = __toESM(require("react"), 1);
+    import_ink5 = require("ink");
+    init_screens();
+    init_list_components();
+    init_components();
+    init_ui_elements();
+    init_utils();
+    init_footer_builder();
+    loadPromise = null;
+    if (typeof window === "undefined") {
+      load().catch(() => {
+      });
     }
-    return setterUsed;
+  }
+});
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Args: () => Args,
+  Box: () => import_ink5.Box,
+  Db: () => Db,
+  Divider: () => Divider,
+  FileDatabase: () => FileDatabase,
+  FileDatabaseError: () => FileDatabaseError,
+  FooterPresets: () => FooterPresets,
+  GridCell: () => GridCell,
+  InputField: () => InputField,
+  ListComponent: () => ListComponent,
+  ListItem: () => ListItem,
+  MultiColumnListComponent: () => MultiColumnListComponent,
+  MultiColumnListWithPreviewComponent: () => MultiColumnListWithPreviewComponent,
+  Params: () => Params,
+  React: () => import_react5.default,
+  ScreenBody: () => ScreenBody,
+  ScreenContainer: () => ScreenContainer,
+  ScreenDivider: () => ScreenDivider,
+  ScreenFooter: () => ScreenFooter,
+  ScreenRow: () => ScreenRow,
+  ScreenTitle: () => ScreenTitle,
+  Text: () => import_ink5.Text,
+  TextBlock: () => TextBlock,
+  buildBreadcrumb: () => buildBreadcrumb,
+  buildDetailBreadcrumb: () => buildDetailBreadcrumb,
+  buildFooter: () => buildFooter,
+  defaultFileSynopsisFunction: () => defaultFileSynopsisFunction,
+  defaultVersionSynopsisFunction: () => defaultVersionSynopsisFunction,
+  getArgsInstance: () => getArgsInstance,
+  h: () => import_react5.createElement,
+  joiEdateType: () => joiEdateType,
+  joiStringArrayType: () => joiStringArrayType,
+  load: () => load,
+  organizeFooterMessages: () => organizeFooterMessages,
+  setupContext: () => setupContext,
+  showListScreen: () => showListScreen,
+  showMenuScreen: () => showMenuScreen,
+  showMultiColumnListScreen: () => showMultiColumnListScreen,
+  showMultiColumnListWithPreviewScreen: () => showMultiColumnListWithPreviewScreen,
+  showScreen: () => showScreen,
+  showWordGridScreen: () => showWordGridScreen,
+  useCallback: () => import_react5.useCallback,
+  useEffect: () => import_react5.useEffect,
+  useInput: () => import_ink5.useInput,
+  useMemo: () => import_react5.useMemo,
+  useRef: () => import_react5.useRef,
+  useState: () => import_react5.useState
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/args/index.ts
+var import_fs = require("fs");
+var import_path = require("path");
+var import_dotenv = require("dotenv");
+var Args = class _Args {
+  args = {};
+  flags = {};
+  options = {};
+  commands = [];
+  usedKeys = /* @__PURE__ */ new Set();
+  aliases = {};
+  overrides = {};
+  defaults = {};
+  prefixes = [];
+  nots = [];
+  configValues = {};
+  configsLoaded = [];
+  env = "local";
+  constructor(config2 = {}) {
+    this.aliases = {};
+    this.overrides = {};
+    this.defaults = {};
+    this.prefixes = ["not", "no"];
+    if (Object.keys(config2).length > 0) {
+      this.configure(config2);
+    }
+    const args = config2.args || process.argv.slice(2);
+    this.parseArgs(args);
+    this.env = this.get("env")?.toLowerCase() || "local";
+    this.loadDotEnv();
+    this.loadConfigFiles();
+    this.checkConflicts();
   }
   /**
-   * Register a parameter getter
+   * Configure Args options
+   * Only parameters present in config are updated
+   * Note: Args is special - it's initialized first, so it can't take context
    */
-  registerParamGetter(fn) {
-    this.paramGetters.push(fn);
+  configure(config2) {
+    if (config2.aliases !== void 0) {
+      this.aliases = config2.aliases;
+    }
+    if (config2.overrides !== void 0) {
+      this.overrides = config2.overrides;
+    }
+    if (config2.defaults !== void 0) {
+      this.defaults = config2.defaults;
+    }
+    if (config2.prefixes !== void 0) {
+      this.prefixes = config2.prefixes;
+    }
   }
   /**
-   * Register a parameter setter
+   * Initialize Args instance
+   * Note: Args is special - it's initialized first, so it can't take context
+   * This static method is for consistency with other components
    */
-  registerParamSetter(fn) {
-    this.paramSetters.push(fn);
+  static init(config2 = {}) {
+    return new _Args(config2);
   }
-};
-var paramsInstance = null;
-var getParamsInstance = () => paramsInstance;
-
-// src/screen/index.ts
-var import_react5 = __toESM(require("react"), 1);
-var import_ink5 = require("ink");
-
-// src/screen/screens.ts
-var import_react3 = require("react");
-var import_ink3 = require("ink");
-
-// src/screen/components.ts
-var import_react = require("react");
-var import_ink = require("ink");
-function getScreenWidth(maxWidth = null) {
-  const terminalWidth = process.stdout.columns || 80;
-  const availableWidth = Math.max(20, terminalWidth - 4);
-  return maxWidth ? Math.min(availableWidth, maxWidth) : availableWidth;
-}
-function ScreenContainer({ children }) {
-  const width = getScreenWidth();
-  return (0, import_react.createElement)(import_ink.Box, {
-    flexDirection: "column",
-    marginTop: 1,
-    borderStyle: "single",
-    borderColor: "cyan",
-    paddingX: 1,
-    width
-    // Use the calculated width directly
-  }, children);
-}
-function ScreenRow({ children }) {
-  return (0, import_react.createElement)(import_ink.Box, { flexDirection: "column" }, children);
-}
-function ScreenTitle({ text }) {
-  return (0, import_react.createElement)(
-    ScreenRow,
-    {},
-    (0, import_react.createElement)(import_ink.Text, { bold: true, color: "cyan" }, text)
-  );
-}
-function ScreenDivider({ width }) {
-  const dividerWidth = width || getScreenWidth() - 4;
-  return (0, import_react.createElement)(import_ink.Text, { color: "cyan", dimColor: true }, "\u2500".repeat(dividerWidth));
-}
-function ScreenBody({ children, alignItems = "flex-start" }) {
-  return (0, import_react.createElement)(import_ink.Box, { flexDirection: "column", alignItems }, children);
-}
-function ScreenFooter({ lines, textStyle }) {
-  const defaultTextStyle = {
-    dimColor: true,
-    color: "white"
-  };
-  const finalTextStyle = { ...defaultTextStyle, ...textStyle };
-  const flattenAndWrap = (items, keyPrefix = "") => {
-    const result = [];
-    let keyIndex = 0;
-    items.forEach((item, index) => {
-      if (Array.isArray(item)) {
-        const nested = flattenAndWrap(item, `${keyPrefix}-${index}`);
-        result.push(...nested);
-      } else if (typeof item === "string") {
-        result.push(
-          (0, import_react.createElement)(import_ink.Text, { key: `${keyPrefix}-${keyIndex++}`, ...finalTextStyle }, item)
-        );
-      } else {
-        const element = item;
-        if (element.key === null || element.key === void 0) {
-          result.push(
-            (0, import_react.createElement)(import_ink.Text, { key: `${keyPrefix}-${keyIndex++}`, ...finalTextStyle }, element)
-          );
+  /**
+   * Parse command line arguments
+   */
+  parseArgs(args) {
+    let i = 0;
+    while (i < args.length) {
+      const arg = args[i];
+      if (arg.startsWith("--")) {
+        const [key, value] = this.parseLongOption(arg);
+        this.setValue(key, value);
+        i++;
+      } else if (arg.startsWith("-")) {
+        const result = this.parseShortOption(arg, args, i);
+        if (result.consumed > 0) {
+          i += result.consumed;
         } else {
-          result.push(element);
+          i++;
         }
-      }
-    });
-    return result;
-  };
-  const wrappedItems = flattenAndWrap(lines);
-  return (0, import_react.createElement)(
-    import_ink.Box,
-    { flexDirection: "column" },
-    (0, import_react.createElement)(import_ink.Box, { flexDirection: "row" }, ...wrappedItems)
-  );
-}
-
-// src/screen/list-components.ts
-var import_react2 = __toESM(require("react"), 1);
-var import_ink2 = require("ink");
-var h2 = import_react2.createElement;
-function MultiColumnListComponent({ items, ctx, selectedIndexRef }) {
-  const [, forceUpdate] = (0, import_react2.useState)({});
-  const termWidth = (process.stdout.columns || 80) - 8;
-  const maxItemLength = Math.max(...items.map((w) => w.length));
-  const columnWidth = maxItemLength + 3;
-  const columns = Math.max(1, Math.floor(termWidth / columnWidth));
-  const itemsPerColumn = Math.ceil(items.length / columns);
-  (0, import_react2.useEffect)(() => {
-    ctx.setAction("moveUp", () => {
-      selectedIndexRef.current = Math.max(0, selectedIndexRef.current - 1);
-      forceUpdate({});
-    });
-    ctx.setAction("moveDown", () => {
-      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + 1);
-      forceUpdate({});
-    });
-    ctx.setAction("moveLeft", () => {
-      if (selectedIndexRef.current === 0) {
-        ctx.goBack();
       } else {
-        selectedIndexRef.current = Math.max(0, selectedIndexRef.current - itemsPerColumn);
-        forceUpdate({});
-      }
-    });
-    ctx.setAction("moveRight", () => {
-      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + itemsPerColumn);
-      forceUpdate({});
-    });
-    ctx.setKeyBinding([
-      { key: "leftArrow", caption: "navigate", action: "moveLeft", order: 0 },
-      { key: "rightArrow", caption: "navigate", action: "moveRight", order: 0 },
-      { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
-      { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
-    ]);
-    ctx.addFooter(`Total: ${items.length} items`);
-  }, []);
-  const selectedIndex = selectedIndexRef.current;
-  const rows = [];
-  for (let row = 0; row < itemsPerColumn; row++) {
-    const cols = [];
-    for (let col = 0; col < columns; col++) {
-      const index = col * itemsPerColumn + row;
-      if (index < items.length) {
-        const isSelected = index === selectedIndex;
-        cols.push(
-          h2(
-            import_ink2.Box,
-            { key: index, width: columnWidth },
-            h2(import_ink2.Text, {
-              color: isSelected ? "black" : "white",
-              backgroundColor: isSelected ? "cyan" : void 0,
-              bold: isSelected
-            }, items[index].padEnd(maxItemLength))
-          )
-        );
+        this.commands.push(arg);
+        i++;
       }
     }
-    rows.push(
-      h2(ScreenRow, { key: row, children: h2(import_ink2.Box, { flexDirection: "row" }, ...cols) })
-    );
   }
-  return h2(import_ink2.Box, { flexDirection: "column" }, ...rows);
-}
-function MultiColumnListWithPreviewComponent({
-  items,
-  getPreviewContent,
-  ctx,
-  selectedIndexRef
-}) {
-  const [, forceUpdate] = (0, import_react2.useState)({});
-  const termWidth = (process.stdout.columns || 80) - 8;
-  const maxItemLength = Math.max(...items.map((w) => w.length));
-  const columnWidth = maxItemLength + 3;
-  const columns = Math.max(1, Math.floor(termWidth / columnWidth));
-  const itemsPerColumn = Math.ceil(items.length / columns);
-  (0, import_react2.useEffect)(() => {
-    ctx.setAction("moveUp", () => {
-      selectedIndexRef.current = Math.max(0, selectedIndexRef.current - 1);
-      forceUpdate({});
-    });
-    ctx.setAction("moveDown", () => {
-      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + 1);
-      forceUpdate({});
-    });
-    ctx.setAction("moveLeft", () => {
-      if (selectedIndexRef.current === 0) {
-        ctx.goBack();
-      } else {
-        selectedIndexRef.current = Math.max(0, selectedIndexRef.current - itemsPerColumn);
-        forceUpdate({});
-      }
-    });
-    ctx.setAction("moveRight", () => {
-      selectedIndexRef.current = Math.min(items.length - 1, selectedIndexRef.current + itemsPerColumn);
-      forceUpdate({});
-    });
-    ctx.setKeyBinding([
-      { key: "leftArrow", caption: "navigate", action: "moveLeft", order: 0 },
-      { key: "rightArrow", caption: "navigate", action: "moveRight", order: 0 },
-      { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
-      { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
-    ]);
-    ctx.addFooter(`Total: ${items.length} items`);
-  }, []);
-  const selectedIndex = selectedIndexRef.current;
-  const selectedItem = items[selectedIndex];
-  const rows = [];
-  for (let row = 0; row < itemsPerColumn; row++) {
-    const cols = [];
-    for (let col = 0; col < columns; col++) {
-      const index = col * itemsPerColumn + row;
-      if (index < items.length) {
-        const isSelected = index === selectedIndex;
-        cols.push(
-          h2(
-            import_ink2.Box,
-            { key: index, width: columnWidth },
-            h2(import_ink2.Text, {
-              color: isSelected ? "black" : "white",
-              backgroundColor: isSelected ? "cyan" : void 0,
-              bold: isSelected
-            }, items[index].padEnd(maxItemLength))
-          )
-        );
+  /**
+   * Parse long option (--key=value or --key)
+   */
+  parseLongOption(arg) {
+    const key = arg.slice(2);
+    const prefix = this.prefixes.find((p) => key.startsWith(p));
+    if (prefix) {
+      let strippedKey = key.slice(prefix.length);
+      if (strippedKey.startsWith("-")) {
+        strippedKey = strippedKey.slice(1);
       }
+      this.nots.push(key);
+      return [strippedKey, false];
     }
-    rows.push(
-      h2(ScreenRow, { key: row, children: h2(import_ink2.Box, { flexDirection: "row" }, ...cols) })
-    );
-  }
-  const previewContent = getPreviewContent ? getPreviewContent(selectedItem) : selectedItem;
-  const previewRows = [];
-  if (typeof previewContent === "string") {
-    previewRows.push(h2(ScreenRow, { key: "preview-string", children: h2(import_ink2.Text, { bold: true }, previewContent) }));
-  } else if (typeof previewContent === "object" && !import_react2.default.isValidElement(previewContent) && previewContent !== null) {
-    Object.entries(previewContent).forEach(([key, value], idx) => {
-      previewRows.push(h2(ScreenRow, { key: `preview-${key}-${idx}`, children: h2(import_ink2.Text, {}, `${key}: ${value}`) }));
-    });
-  } else if (import_react2.default.isValidElement(previewContent)) {
-    previewRows.push(h2(ScreenRow, { key: "preview-element", children: previewContent }));
-  }
-  return h2(
-    import_ink2.Box,
-    { flexDirection: "column" },
-    ...rows,
-    h2(ScreenRow, { key: "spacer-1", children: h2(import_ink2.Text, {}, " ") }),
-    h2(ScreenDivider, { key: "divider" }),
-    h2(ScreenRow, { key: "spacer-2", children: h2(import_ink2.Text, {}, " ") }),
-    ...previewRows
-  );
-}
-function ListComponent({ items, ctx, selectedIndexRef, renderItem, getTitle, sortable = false, maxHeight, sortHighlightStyle, selectionMarker = " " }) {
-  const [, forceUpdate] = (0, import_react2.useState)({});
-  const [sortOrder, setSortOrder] = (0, import_react2.useState)("none");
-  const [scrollOffset, setScrollOffset] = (0, import_react2.useState)(0);
-  const scrollStateRef = (0, import_react2.useRef)({ scrollOffset: 0, maxHeight: 0, totalItems: 0 });
-  const defaultGetTitle = (item) => {
-    return getTitle ? getTitle(item) : typeof item.value === "string" ? item.value : item.value?.title || item.name;
-  };
-  const titleGetter = getTitle || defaultGetTitle;
-  const displayItems = sortable && sortOrder !== "none" ? [...items].sort((a, b) => {
-    const titleA = titleGetter(a).toLowerCase();
-    const titleB = titleGetter(b).toLowerCase();
-    if (sortOrder === "asc") {
-      return titleA < titleB ? -1 : titleA > titleB ? 1 : 0;
+    if (key.includes("=")) {
+      const eqIndex = key.indexOf("=");
+      const optionKey = key.slice(0, eqIndex);
+      const value = key.slice(eqIndex + 1);
+      return [optionKey, this.parseValue(value)];
     } else {
-      return titleA > titleB ? -1 : titleA < titleB ? 1 : 0;
+      return [key, true];
     }
-  }) : items;
-  const effectiveMaxHeight = maxHeight || displayItems.length;
-  const canScroll = displayItems.length > effectiveMaxHeight;
-  const maxScrollOffset = Math.max(0, displayItems.length - effectiveMaxHeight);
-  const clampedScrollOffset = Math.min(Math.max(0, scrollOffset), maxScrollOffset);
-  const visibleItems = displayItems.slice(clampedScrollOffset, clampedScrollOffset + effectiveMaxHeight);
-  const canScrollUp = clampedScrollOffset > 0;
-  const canScrollDown = clampedScrollOffset < maxScrollOffset;
-  scrollStateRef.current = { scrollOffset, maxHeight: effectiveMaxHeight, totalItems: displayItems.length };
-  (0, import_react2.useEffect)(() => {
-    ctx.setAction("moveUp", () => {
-      const newIndex = Math.max(0, selectedIndexRef.current - 1);
-      selectedIndexRef.current = newIndex;
-      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
-      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
-      const currentClampedScrollOffset = Math.min(Math.max(0, currentScrollOffset), currentMaxScrollOffset);
-      if (newIndex < currentClampedScrollOffset) {
-        setScrollOffset(newIndex);
-      }
-      forceUpdate({});
-    });
-    ctx.setAction("moveDown", () => {
-      const currentItems = sortable && sortOrder !== "none" ? [...items].sort((a, b) => {
-        const titleA = titleGetter(a).toLowerCase();
-        const titleB = titleGetter(b).toLowerCase();
-        if (sortOrder === "asc") {
-          return titleA < titleB ? -1 : titleA > titleB ? 1 : 0;
+  }
+  /**
+   * Parse short option (-k=value, -k, or bundled -vsd)
+   */
+  parseShortOption(arg, args, index) {
+    const key = arg.slice(1);
+    if (key.length === 1 && index + 1 < args.length && !args[index + 1].startsWith("-")) {
+      const value = args[index + 1];
+      this.setValue(key, this.parseValue(value));
+      return { consumed: 2 };
+    }
+    if (key.length > 1 && !key.includes("=")) {
+      for (let i = 0; i < key.length; i++) {
+        const shortKey = key[i];
+        if (shortKey in this.aliases) {
+          this.setValue(shortKey, true);
         } else {
-          return titleA > titleB ? -1 : titleA < titleB ? 1 : 0;
+          this.args[shortKey] = true;
         }
-      }) : items;
-      const maxIndex = currentItems.length - 1;
-      const newIndex = Math.min(maxIndex, selectedIndexRef.current + 1);
-      selectedIndexRef.current = newIndex;
-      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
-      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
-      const currentClampedScrollOffset = Math.min(Math.max(0, currentScrollOffset), currentMaxScrollOffset);
-      if (newIndex >= currentClampedScrollOffset + currentMaxHeight) {
-        setScrollOffset(newIndex - currentMaxHeight + 1);
       }
-      forceUpdate({});
-    });
-    ctx.setAction("scrollUp", () => {
-      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
-      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
-      const newScrollOffset = Math.max(0, currentScrollOffset - 1);
-      setScrollOffset(newScrollOffset);
-      forceUpdate({});
-    });
-    ctx.setAction("scrollDown", () => {
-      const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
-      const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
-      const newScrollOffset = Math.min(currentMaxScrollOffset, currentScrollOffset + 1);
-      setScrollOffset(newScrollOffset);
-      forceUpdate({});
-    });
-    if (sortable) {
-      ctx.setAction("toggleSort", () => {
-        const nextSort = sortOrder === "none" ? "asc" : sortOrder === "asc" ? "desc" : "none";
-        const currentSelectedItem = displayItems[selectedIndexRef.current];
-        setSortOrder(nextSort);
-        const newSortedItems = nextSort !== "none" ? [...items].sort((a, b) => {
-          const titleA = titleGetter(a).toLowerCase();
-          const titleB = titleGetter(b).toLowerCase();
-          if (nextSort === "asc") {
-            return titleA < titleB ? -1 : titleA > titleB ? 1 : 0;
+      return { consumed: 1 };
+    }
+    if (key.includes("=")) {
+      const eqIndex = key.indexOf("=");
+      const optionKey = key.slice(0, eqIndex);
+      const value = key.slice(eqIndex + 1);
+      if (optionKey.length > 1) {
+        for (let i = 0; i < optionKey.length - 1; i++) {
+          const shortKey = optionKey[i];
+          if (shortKey in this.aliases) {
+            this.setValue(shortKey, true);
           } else {
-            return titleA > titleB ? -1 : titleA < titleB ? 1 : 0;
+            this.args[shortKey] = true;
           }
-        }) : items;
-        const newIndex = newSortedItems.findIndex((item) => item === currentSelectedItem);
-        if (newIndex !== -1) {
-          selectedIndexRef.current = newIndex;
-          setScrollOffset(newIndex);
-        } else {
-          selectedIndexRef.current = 0;
-          setScrollOffset(0);
         }
-        forceUpdate({});
-      });
-      const defaultHighlightStyle = {
-        color: "black",
-        backgroundColor: "green",
-        bold: true
-      };
-      const highlightStyle = { ...defaultHighlightStyle, ...sortHighlightStyle };
-      const sortCaption = () => {
-        if (sortOrder === "none") {
-          return h2(import_ink2.Text, {}, "s to toggle sort");
+        const lastKey = optionKey[optionKey.length - 1];
+        if (lastKey in this.aliases) {
+          this.setValue(lastKey, this.parseValue(value));
         } else {
-          const sortLabel = sortOrder === "asc" ? "ASC" : "DESC";
-          return h2(
-            import_ink2.Text,
-            {},
-            "s to toggle ",
-            h2(import_ink2.Text, { color: "white", bold: true }, "sort"),
-            " ",
-            h2(import_ink2.Text, highlightStyle, ` ${sortLabel} `)
-          );
-        }
-      };
-      ctx.setKeyBinding([
-        { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
-        { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 },
-        {
-          key: "s",
-          caption: sortCaption,
-          action: "toggleSort",
-          order: 5
+          this.args[lastKey] = this.parseValue(value);
         }
-      ]);
-      ctx.update();
+      } else {
+        this.setValue(optionKey, this.parseValue(value));
+      }
+      return { consumed: 1 };
     } else {
-      ctx.setKeyBinding([
-        { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
-        { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
-      ]);
+      this.setValue(key, true);
+      return { consumed: 1 };
     }
-  }, [sortOrder, sortable]);
-  const selectedIndex = selectedIndexRef.current;
-  const defaultRenderItem = (item, isSelected, displayIndex, actualIndex) => {
-    const isFirstVisible = displayIndex === 0;
-    const isLastVisible = displayIndex === visibleItems.length - 1;
-    let arrowPrefix = "";
-    let selectionPrefix = "";
-    if (isFirstVisible && canScrollUp) {
-      arrowPrefix = "\u2191 ";
-    } else if (isLastVisible && canScrollDown) {
-      arrowPrefix = "\u2193 ";
-    } else {
-      arrowPrefix = "  ";
+  }
+  /**
+   * Parse value (handle quotes)
+   */
+  parseValue(value) {
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      return value.slice(1, -1);
     }
-    if (isSelected) {
-      selectionPrefix = selectionMarker;
+    return value;
+  }
+  /**
+   * Set a value with proper categorization
+   */
+  setValue(key, value) {
+    const resolvedKey = this.aliases[key] || key;
+    if (typeof value === "boolean") {
+      this.flags[resolvedKey] = value;
     } else {
-      selectionPrefix = " ".repeat(selectionMarker.length);
+      this.options[resolvedKey] = value;
     }
-    return h2(
-      import_ink2.Box,
-      { flexDirection: "row" },
-      // Arrow (clickable if functional, not highlighted)
-      h2(import_ink2.Text, {
-        key: `arrow-${actualIndex}`,
-        color: "white"
-      }, arrowPrefix),
-      // Selection marker space (always same width, not highlighted) 
-      h2(import_ink2.Text, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
-      // Item name (highlighted if selected)
-      h2(import_ink2.Text, {
-        key: `name-${actualIndex}`,
-        color: isSelected ? "black" : "white",
-        backgroundColor: isSelected ? "cyan" : void 0,
-        bold: isSelected
-      }, item.name)
-    );
-  };
-  const itemRenderer = renderItem || defaultRenderItem;
-  return h2(
-    import_ink2.Box,
-    { flexDirection: "column" },
-    ...visibleItems.map((item, displayIndex) => {
-      const actualIndex = clampedScrollOffset + displayIndex;
-      const isSelected = actualIndex === selectedIndex;
-      if (renderItem) {
-        const isFirstVisible = displayIndex === 0;
-        const isLastVisible = displayIndex === visibleItems.length - 1;
-        let arrowPrefix = "";
-        let selectionPrefix = "";
-        if (isFirstVisible && canScrollUp) {
-          arrowPrefix = "\u2191 ";
-        } else if (isLastVisible && canScrollDown) {
-          arrowPrefix = "\u2193 ";
-        } else {
-          arrowPrefix = "  ";
-        }
-        if (isSelected) {
-          selectionPrefix = selectionMarker;
-        } else {
-          selectionPrefix = " ".repeat(selectionMarker.length);
-        }
-        return h2(ScreenRow, {
-          key: `item-${actualIndex}`,
-          children: h2(
-            import_ink2.Box,
-            { flexDirection: "row" },
-            // Arrow (clickable if functional, not highlighted)
-            h2(import_ink2.Text, {
-              key: `arrow-${actualIndex}`,
-              color: "white"
-            }, arrowPrefix),
-            // Selection marker space (always same width, not highlighted) 
-            h2(import_ink2.Text, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
-            // Custom rendered content
-            renderItem(item, isSelected, displayIndex)
-          )
-        });
-      } else {
-        return h2(ScreenRow, {
-          key: `item-${actualIndex}`,
-          children: itemRenderer(item, isSelected, displayIndex, actualIndex)
-        });
+    this.args[resolvedKey.toLowerCase()] = value;
+  }
+  /**
+   * Check for conflicts (short + long form of same option)
+   */
+  checkConflicts() {
+    const conflicts = [];
+    for (const [shortKey, longKey] of Object.entries(this.aliases)) {
+      const hasShort = this.args[shortKey] !== void 0;
+      const hasLong = this.args[longKey] !== void 0;
+      if (hasShort && hasLong) {
+        conflicts.push(`Both -${shortKey} and --${longKey} specified`);
       }
-    })
-  );
-}
-
-// src/screen/screens.ts
-function groupKeyBindings(bindings) {
-  const groups = {};
-  const enabledBindings = bindings.filter((b) => b.enabled !== false);
-  enabledBindings.forEach((binding) => {
-    const caption = typeof binding.caption === "string" ? binding.caption : "";
-    if (!groups[caption]) {
-      groups[caption] = {
-        keys: [],
-        caption,
-        order: binding.order || 999
-      };
     }
-    groups[caption].keys.push(binding.key);
-  });
-  return Object.values(groups);
-}
-function formatKeyBindings(bindings, mode = "long") {
-  const resolvedBindings = bindings.map((binding) => {
-    let resolvedCaption = binding.caption;
-    if (typeof binding.caption === "function") {
-      resolvedCaption = binding.caption();
+    if (conflicts.length > 0) {
+      throw new Error(`Argument conflicts: ${conflicts.join(", ")}`);
     }
-    return {
-      ...binding,
-      resolvedCaption
-    };
-  });
-  const groups = groupKeyBindings(resolvedBindings.map((b) => ({
-    ...b,
-    caption: typeof b.resolvedCaption === "string" ? b.resolvedCaption : ""
-  })));
-  groups.sort((a, b) => a.order - b.order);
-  const items = [];
-  groups.forEach((group) => {
-    const bindingWithCustom = resolvedBindings.find(
-      (b) => group.keys.includes(b.key) && typeof b.resolvedCaption !== "string"
+  }
+  /**
+   * Get a value with precedence order
+   */
+  get(key) {
+    const resolvedKey = this.aliases[key] || key;
+    this.usedKeys.add(resolvedKey);
+    if (this.overrides[resolvedKey] !== void 0) {
+      return this.overrides[resolvedKey];
+    }
+    const lcKey = resolvedKey.toLowerCase();
+    const lcKeyWithEnv = `${lcKey}${this.env ? `_${this.env.toLowerCase()}` : ""}`;
+    if (this.env && this.args[lcKeyWithEnv] !== void 0) {
+      return this.args[lcKeyWithEnv];
+    } else if (this.args[lcKey] !== void 0) {
+      return this.args[lcKey];
+    }
+    if (this.configValues[resolvedKey] !== void 0) {
+      return this.configValues[resolvedKey];
+    }
+    const envKey = this.toEnvKey(resolvedKey);
+    const envKeyWithEnv = `${envKey}${this.env ? `_${this.env.toUpperCase()}` : ""}`;
+    const envSpecificKey = Object.keys(process.env).find(
+      (k) => this.env && k.toUpperCase() === envKeyWithEnv
     );
-    if (bindingWithCustom && bindingWithCustom.resolvedCaption) {
-      items.push(bindingWithCustom.resolvedCaption);
-    } else {
-      const keyStr = formatKeys(group.keys);
-      if (mode === "long") {
-        items.push(`${keyStr} to ${group.caption}`);
-      } else {
-        items.push(keyStr);
+    const envKeyFound = Object.keys(process.env).find((k) => k.toUpperCase() === envKey);
+    if (envSpecificKey) {
+      return process.env[envSpecificKey];
+    } else if (envKeyFound) {
+      return process.env[envKeyFound];
+    }
+    if (this.defaults[resolvedKey] !== void 0) {
+      return this.defaults[resolvedKey];
+    }
+    if (resolvedKey === "env" && process.env.NODE_ENV !== void 0) {
+      return process.env.NODE_ENV;
+    }
+    return void 0;
+  }
+  /**
+   * Set a value (for testing/internal use)
+   */
+  set(key, value) {
+    this.args[key] = value;
+  }
+  /**
+   * Check if a command exists (case-insensitive)
+   */
+  hasCommand(cmd) {
+    return this.commands.some((command) => command.toLowerCase() === cmd.toLowerCase());
+  }
+  /**
+   * Get all commands
+   */
+  getCommands() {
+    return [...this.commands];
+  }
+  /**
+   * Get used keys (as array)
+   */
+  getUsed() {
+    return Array.from(this.usedKeys);
+  }
+  /**
+   * Get unused keys (as array)
+   */
+  getUnused() {
+    const unused = [];
+    for (const key of Object.keys(this.args)) {
+      if (!this.usedKeys.has(key) && !this.nots.includes(key)) {
+        unused.push(key);
       }
     }
-  });
-  return items;
-}
-function formatKeys(keys) {
-  const keyMap = {
-    "escape": "esc",
-    "leftArrow": "\u2190",
-    "rightArrow": "\u2192",
-    "upArrow": "\u2191",
-    "downArrow": "\u2193",
-    "return": "enter"
-  };
-  return keys.map((k) => keyMap[k] || k).join("/");
-}
-async function showScreen(config2) {
-  const {
-    title,
-    onRender,
-    parentData = {}
-  } = config2;
-  return new Promise((resolve2) => {
-    let instance2;
-    const keyBindings = [];
-    const actions = {};
-    const customFooterItems = [];
-    let renderResult = null;
-    let initialized = false;
-    const Screen = () => {
-      const [updateCounter, setUpdateCounter] = (0, import_react3.useState)(0);
-      if (!initialized) {
-        const defaultBindings = [
-          { key: "escape", caption: "go back", action: "back", protected: true, order: 1 },
-          { key: "leftArrow", caption: "go back", action: "back", protected: false, order: 1 }
-          // Note: 'select' is not a default - components add it if needed
-        ];
-        defaultBindings.forEach((binding) => {
-          keyBindings.push(binding);
-        });
-        actions.back = () => {
-          cleanup(null);
-        };
-        initialized = true;
+    return unused;
+  }
+  /**
+   * Convert key to environment variable format
+   */
+  toEnvKey(key) {
+    return key.replace(
+      /[A-Z0-9]/g,
+      (match, offset) => offset === 0 ? match : "_" + match.toLowerCase()
+    ).toUpperCase();
+  }
+  /**
+   * Load .env file
+   */
+  loadDotEnv() {
+    const dotEnvPath = this.get("dotEnvPath") || process.cwd();
+    const dotEnvFile = this.get("dotEnvFile") || ".env";
+    if (this.get("dotEnvFile")) {
+      const customPath = (0, import_path.resolve)(dotEnvPath, dotEnvFile);
+      if ((0, import_fs.existsSync)(customPath)) {
+        (0, import_dotenv.config)({ path: customPath, quiet: true });
       }
-      const context = {
-        setAction: (actionName, handlerFn) => {
-          actions[actionName] = handlerFn;
-        },
-        setKeyBinding: (bindingOrBindings) => {
-          const bindingsToSet = Array.isArray(bindingOrBindings) ? bindingOrBindings : [bindingOrBindings];
-          bindingsToSet.forEach((binding) => {
-            const existingIndex = keyBindings.findIndex((b) => b.key === binding.key);
-            if (existingIndex >= 0) {
-              const existing = keyBindings[existingIndex];
-              if (existing.protected) {
-                console.warn(`Cannot override protected key: ${binding.key}`);
-                return;
-              }
-              keyBindings[existingIndex] = {
-                ...existing,
-                ...binding,
-                order: binding.order !== void 0 ? binding.order : existing.order,
-                enabled: binding.enabled !== void 0 ? binding.enabled : existing.enabled !== void 0 ? existing.enabled : true
-              };
-            } else {
-              keyBindings.push({
-                protected: false,
-                order: 999,
-                enabled: true,
-                ...binding
-              });
-            }
-          });
-        },
-        updateKeyBinding: (keyName, updates) => {
-          const index = keyBindings.findIndex((b) => b.key === keyName);
-          if (index >= 0) {
-            keyBindings[index] = {
-              ...keyBindings[index],
-              ...updates
-            };
-          }
-        },
-        removeKeyBinding: (keyName) => {
-          const index = keyBindings.findIndex((b) => b.key === keyName);
-          if (index >= 0) {
-            if (keyBindings[index].protected) {
-              console.warn(`Cannot remove protected key: ${keyName}`);
-              return;
-            }
-            keyBindings.splice(index, 1);
-          }
-        },
-        addFooter: (item) => {
-          customFooterItems.push(item);
-        },
-        clearFooter: () => {
-          customFooterItems.length = 0;
-        },
-        setFooter: (items) => {
-          customFooterItems.length = 0;
-          const itemsArray = Array.isArray(items) ? items : [items];
-          customFooterItems.push(...itemsArray);
-        },
-        update: () => {
-          setUpdateCounter((c) => c + 1);
-        },
-        goBack: () => {
-          if (actions.back) {
-            actions.back();
-          }
-        },
-        close: (result) => {
-          cleanup(result);
-        },
-        parentData
-      };
-      if (!renderResult) {
-        renderResult = onRender(context);
+      return;
+    }
+    let dotEnvPathFile = null;
+    const envSpecificFile = `.env.${this.env}`;
+    const envSpecificPath = (0, import_path.resolve)(dotEnvPath, envSpecificFile);
+    if ((0, import_fs.existsSync)(envSpecificPath)) {
+      dotEnvPathFile = envSpecificPath;
+    }
+    if (!dotEnvPathFile && !this.get("dotEnvPath")) {
+      const examplesPath = (0, import_path.resolve)(dotEnvPath, "examples");
+      const examplesEnvSpecificPath = (0, import_path.resolve)(examplesPath, envSpecificFile);
+      if ((0, import_fs.existsSync)(examplesEnvSpecificPath)) {
+        dotEnvPathFile = examplesEnvSpecificPath;
       }
-      (0, import_ink3.useInput)((input, key) => {
-        if (key.ctrl && input === "c") {
-          cleanup(null);
-          process.exit(0);
-          return;
-        }
-        let matchedBinding = null;
-        for (const binding of keyBindings) {
-          let keyMatches = false;
-          if (key[binding.key]) {
-            keyMatches = true;
-          } else if (input === binding.key) {
-            keyMatches = true;
-          }
-          if (keyMatches) {
-            if (binding.enabled === false) {
-              continue;
-            }
-            if (binding.condition && !binding.condition(context)) {
-              continue;
-            }
-            matchedBinding = binding;
-            break;
+    }
+    if (!dotEnvPathFile) {
+      dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, dotEnvFile);
+      if (!(0, import_fs.existsSync)(dotEnvPathFile)) {
+        if (!this.get("dotEnvPath")) {
+          const examplesPath = (0, import_path.resolve)(dotEnvPath, "examples");
+          const examplesEnvFile = (0, import_path.resolve)(examplesPath, dotEnvFile);
+          if ((0, import_fs.existsSync)(examplesEnvFile)) {
+            dotEnvPathFile = examplesEnvFile;
+          } else {
+            dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, "..", dotEnvFile);
           }
         }
-        if (matchedBinding && actions[matchedBinding.action]) {
-          const actionResult = actions[matchedBinding.action]({
-            input,
-            key,
-            binding: matchedBinding
-          });
+      }
+    }
+    if (dotEnvPathFile && (0, import_fs.existsSync)(dotEnvPathFile)) {
+      (0, import_dotenv.config)({ path: dotEnvPathFile, quiet: true });
+    }
+  }
+  /**
+   * Load configuration files
+   */
+  loadConfigFiles() {
+    this.configsLoaded = [];
+    this.configValues = {};
+    const _defaultConfigExtension = this.get("defaultConfigExtension") || "js";
+    const optConfigFiles = this.get("config") || this.get("configs") || "";
+    const configFiles = optConfigFiles ? optConfigFiles.split(/,\s*/) : [];
+    const optConfigFilePath = this.get("configPath");
+    if (configFiles.length > 0) {
+      for (const cfgFile of configFiles) {
+        let notLoaded = false;
+        let notLoadedEnvSpecific = false;
+        const cfgFileWithPath = this.resolveFileWithPath(optConfigFilePath, cfgFile);
+        try {
+          const cfgContents = this.requireConfigFile(cfgFileWithPath);
+          this.configValues = { ...this.configValues, ...cfgContents };
+          this.configsLoaded.push(cfgFileWithPath);
+        } catch {
+          notLoaded = true;
         }
-      });
-      const footerLines = [];
-      const bindingItems = formatKeyBindings(keyBindings, "long");
-      if (bindingItems.length > 0) {
-        const bindingsLine = [];
-        bindingItems.forEach((item, idx) => {
-          if (idx > 0) {
-            bindingsLine.push(", ");
+        const cfgEnvFileWithPath = this.resolveFileWithPath(
+          optConfigFilePath,
+          cfgFile,
+          this.env
+        );
+        if (cfgEnvFileWithPath !== cfgFileWithPath) {
+          try {
+            const cfgContents = this.requireConfigFile(cfgEnvFileWithPath);
+            this.configValues = { ...this.configValues, ...cfgContents };
+            this.configsLoaded.push(cfgEnvFileWithPath);
+          } catch {
+            notLoadedEnvSpecific = true;
           }
-          bindingsLine.push(item);
-        });
-        const allStrings = bindingItems.every((item) => typeof item === "string");
-        if (allStrings) {
-          footerLines.push(bindingsLine.join(""));
         } else {
-          const wrappedBindingsLine = bindingsLine.map(
-            (item) => typeof item === "string" ? (0, import_react3.createElement)(import_ink3.Text, {}, item) : item
-          );
-          footerLines.push(wrappedBindingsLine);
+          notLoadedEnvSpecific = true;
         }
-      }
-      customFooterItems.forEach((item) => {
-        if (typeof item === "string") {
-          footerLines.push(item);
-        } else {
-          footerLines.push(item);
+        if (notLoaded && notLoadedEnvSpecific) {
+          throw new Error(`can't load config file "${cfgFileWithPath}"`);
         }
-      });
-      return (0, import_react3.createElement)(
-        ScreenContainer,
-        {},
-        (0, import_react3.createElement)(ScreenTitle, { text: title }),
-        (0, import_react3.createElement)(ScreenDivider),
-        (0, import_react3.createElement)(ScreenRow, {}, (0, import_react3.createElement)(import_ink3.Text, {}, " ")),
-        renderResult,
-        (0, import_react3.createElement)(ScreenRow, {}, (0, import_react3.createElement)(import_ink3.Text, {}, " ")),
-        (0, import_react3.createElement)(ScreenDivider),
-        (0, import_react3.createElement)(ScreenFooter, { lines: footerLines })
-      );
-    };
-    const cleanup = (result) => {
-      if (instance2) instance2.unmount();
-      setTimeout(() => resolve2(result), 50);
+      }
+    }
+  }
+  /**
+   * Resolve file path with environment-specific naming
+   */
+  resolveFileWithPath(optConfigFilePath, cfgFile, env) {
+    let cfgFileWithPath = optConfigFilePath ? (0, import_path.isAbsolute)(optConfigFilePath) ? (0, import_path.resolve)(optConfigFilePath, cfgFile) : (0, import_path.resolve)(process.cwd(), optConfigFilePath, cfgFile) : (0, import_path.isAbsolute)(cfgFile) ? cfgFile : (0, import_path.resolve)(process.cwd(), cfgFile);
+    const { basePathWithName, extension } = this.splitPath(cfgFileWithPath);
+    if (env) {
+      cfgFileWithPath = `${basePathWithName}.${env}.${extension || "js"}`;
+    } else {
+      cfgFileWithPath = `${basePathWithName}.${extension || "js"}`;
+    }
+    return cfgFileWithPath;
+  }
+  /**
+   * Split file path into base path and extension
+   */
+  splitPath(filePath) {
+    const basePathWithName = (0, import_path.join)((0, import_path.dirname)(filePath), (0, import_path.basename)(filePath, (0, import_path.extname)(filePath)));
+    const extension = (0, import_path.extname)(filePath).slice(1);
+    return { basePathWithName, extension };
+  }
+  /**
+   * Require a configuration file (supports .js and .json)
+   */
+  requireConfigFile(filePath) {
+    if (!(0, import_fs.existsSync)(filePath)) {
+      throw new Error(`Config file not found: ${filePath}`);
+    }
+    const ext = (0, import_path.extname)(filePath).toLowerCase();
+    if (ext === ".json") {
+      const content = (0, import_fs.readFileSync)(filePath, "utf8");
+      return JSON.parse(content);
+    } else if (ext === ".js") {
+      try {
+        delete require.cache[require.resolve(filePath)];
+        return require(filePath);
+      } catch (error) {
+        throw new Error(`Failed to load JS config file: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    } else {
+      throw new Error(`Unsupported file extension: ${ext}`);
+    }
+  }
+  /**
+   * Get all parsed data
+   */
+  getParsed() {
+    return {
+      command: this.commands[0] || "",
+      flags: { ...this.flags },
+      options: { ...this.options },
+      usedKeys: Array.from(this.usedKeys)
     };
-    instance2 = (0, import_ink3.render)((0, import_react3.createElement)(Screen));
-  });
+  }
+  /**
+   * Set prefixes dynamically and re-parse arguments (like legacy)
+   */
+  setPrefixes(prefixes) {
+    const arr = Array.isArray(prefixes) ? prefixes : prefixes.split(/,\s*/);
+    const sortedArr = arr.sort(
+      (a, b) => a.length < b.length ? 1 : a.length > b.length ? -1 : 0
+    );
+    this.prefixes = sortedArr.map((el) => el.toLowerCase());
+    const args = process.argv.slice(2);
+    this.parseArgs(args);
+  }
+};
+var instance = null;
+function getArgsInstance() {
+  return instance;
 }
-async function showListScreen(config2) {
-  const { title, items, onSelect, onEscape, parentData, initialSelectedIndex = 0, renderItem, getTitle, sortable, maxHeight, sortHighlightStyle, selectionMarker } = config2;
-  return showScreen({
-    title,
-    parentData,
-    onRender: (ctx) => {
-      const selectedIndexRef = { current: initialSelectedIndex };
-      ctx.setAction("select", () => {
-        const selected = items[selectedIndexRef.current];
-        if (onSelect) {
-          const result = onSelect(selected.value, selectedIndexRef.current);
-          ctx.close(result);
-        }
-      });
-      if (onEscape) {
-        ctx.setAction("back", () => {
-          const result = onEscape(selectedIndexRef.current);
-          ctx.close(result);
-        });
-      }
-      ctx.setKeyBinding({ key: "return", caption: "select", action: "select", order: 2 });
-      return (0, import_react3.createElement)(ListComponent, { items, ctx, selectedIndexRef, renderItem, getTitle, sortable, maxHeight, sortHighlightStyle, selectionMarker });
+
+// src/params/index.ts
+var import_joi = __toESM(require("joi"), 1);
+
+// src/errors.ts
+var FrameworkError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FrameworkError";
+  }
+};
+var ParamError = class extends FrameworkError {
+  constructor(message) {
+    super(message);
+    this.name = "ParamError";
+  }
+};
+
+// src/params/custom-types.ts
+var joiEdateType = (value, helpers) => {
+  if (typeof value === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/.test(value)) {
+    const testDate = new Date(value);
+    if (!isNaN(testDate.getTime())) {
+      return value;
+    }
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (typeof value !== "string") {
+    value = String(value);
+  }
+  if (value.toLowerCase() === "now") {
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+  const referenceRegex = /^@(\w+)([+-]\d+[smhdwy])$/i;
+  const referenceMatch = value.match(referenceRegex);
+  if (referenceMatch) {
+    const [, paramName, relativeExpr] = referenceMatch;
+    const context = helpers.prefs?.context;
+    if (!context || !context.params) {
+      throw new ParamError(`Cannot resolve cross-parameter reference @${paramName}: context not available. Ensure parameters are processed with proper context.`);
     }
-  });
-}
-async function showMultiColumnListScreen(config2) {
-  const { title, items, onSelect, onEscape, parentData, initialSelectedIndex = 0 } = config2;
-  return showScreen({
-    title,
-    parentData,
-    onRender: (ctx) => {
-      const selectedIndexRef = { current: initialSelectedIndex };
-      ctx.setAction("select", () => {
-        const selected = items[selectedIndexRef.current];
-        if (onSelect) {
-          const result = onSelect(selected, selectedIndexRef.current);
-          ctx.close(result);
-        }
-      });
-      if (onEscape) {
-        ctx.setAction("back", () => {
-          const result = onEscape(selectedIndexRef.current);
-          ctx.close(result);
-        });
+    const referencedValue = context.params[paramName];
+    if (referencedValue === void 0 || referencedValue === null) {
+      throw new ParamError(`Cannot resolve @${paramName}: parameter "${paramName}" is not defined or has no value. Parameters are evaluated left-to-right.`);
+    }
+    let referenceDate;
+    if (referencedValue instanceof Date) {
+      referenceDate = referencedValue;
+    } else if (typeof referencedValue === "string") {
+      referenceDate = new Date(referencedValue);
+      if (isNaN(referenceDate.getTime())) {
+        throw new ParamError(`Referenced parameter @${paramName} has invalid date value: ${referencedValue}`);
       }
-      ctx.setKeyBinding({ key: "return", caption: "select", action: "select", order: 2 });
-      return (0, import_react3.createElement)(MultiColumnListComponent, { items, ctx, selectedIndexRef });
+    } else {
+      throw new ParamError(`Referenced parameter @${paramName} is not a valid date type (found: ${typeof referencedValue})`);
     }
-  });
+    const relativeMatch2 = relativeExpr.match(/^([+-])(\d+)([smhdwy])$/i);
+    if (!relativeMatch2) {
+      throw new ParamError(`Invalid relative time expression in @${paramName}${relativeExpr}`);
+    }
+    const [, sign, amount, unit] = relativeMatch2;
+    const offset = calculateTimeOffset(parseInt(amount, 10), unit, sign);
+    const resultDate = new Date(referenceDate.getTime() + offset);
+    return resultDate.toISOString();
+  }
+  const relativeTimeRegex = /^([+-])(\d+)([smhdwy])$/i;
+  const relativeMatch = value.match(relativeTimeRegex);
+  if (relativeMatch) {
+    const [, sign, amount, unit] = relativeMatch;
+    const numAmount = parseInt(amount, 10);
+    if (isNaN(numAmount)) {
+      throw new ParamError(`Invalid relative time amount: ${amount}`);
+    }
+    const offset = calculateTimeOffset(numAmount, unit, sign);
+    const resultDate = new Date(Date.now() + offset);
+    return resultDate.toISOString();
+  }
+  const parsedDate = new Date(value);
+  if (isNaN(parsedDate.getTime())) {
+    throw new ParamError(`Invalid date format: ${value}. Expected a valid date string, "now", relative time expression (e.g., "-2h", "+1d"), or cross-parameter reference (e.g., "@startTime+2h")`);
+  }
+  return parsedDate.toISOString();
+};
+function calculateTimeOffset(amount, unit, sign) {
+  let multiplier = 1;
+  switch (unit.toLowerCase()) {
+    case "s":
+      multiplier = 1e3;
+      break;
+    case "m":
+      multiplier = 60 * 1e3;
+      break;
+    case "h":
+      multiplier = 60 * 60 * 1e3;
+      break;
+    case "d":
+      multiplier = 24 * 60 * 60 * 1e3;
+      break;
+    case "w":
+      multiplier = 7 * 24 * 60 * 60 * 1e3;
+      break;
+    case "y":
+      multiplier = 365 * 24 * 60 * 60 * 1e3;
+      break;
+    default:
+      throw new ParamError(`Invalid time unit: ${unit}. Supported units: s, m, h, d, w, y`);
+  }
+  return sign === "+" ? amount * multiplier : -amount * multiplier;
 }
-async function showMultiColumnListWithPreviewScreen(config2) {
-  const { title, items, getPreviewContent, onSelect, onEscape, parentData, initialSelectedIndex = 0 } = config2;
-  return showScreen({
-    title,
-    parentData,
-    onRender: (ctx) => {
-      const selectedIndexRef = { current: initialSelectedIndex };
-      ctx.setAction("select", () => {
-        const selected = items[selectedIndexRef.current];
-        if (onSelect) {
-          const result = onSelect(selected, selectedIndexRef.current);
-          ctx.close(result);
-        }
-      });
-      if (onEscape) {
-        ctx.setAction("back", () => {
-          const result = onEscape(selectedIndexRef.current);
-          ctx.close(result);
-        });
+var joiStringArrayType = (type) => (value, helpers) => {
+  if (value === void 0 || typeof value === "function") {
+    return [];
+  }
+  const arr = value.split(/,\s*/).map((el) => {
+    if (type === "number") {
+      const v = parseInt(el, 10);
+      if (isNaN(v)) {
+        throw new ParamError(`array element "${el}" should be numeric`);
       }
-      ctx.setKeyBinding({ key: "return", caption: "select", action: "select", order: 2 });
-      return (0, import_react3.createElement)(MultiColumnListWithPreviewComponent, { items, getPreviewContent, ctx, selectedIndexRef });
+      return v;
+    } else if (type === "boolean") {
+      const v = el.match(/true|t|yes|1/i) ? true : el.match(/false|f|no|0/i) ? false : null;
+      if (v === null) {
+        throw new ParamError(`array element "${el}" should be boolean`);
+      }
+      return v;
+    } else if (type === "string") {
+      return el;
+    } else {
+      throw new ParamError(`unknown type "${type}" for array elements`);
     }
   });
-}
-var showMenuScreen = showListScreen;
-var showWordGridScreen = showMultiColumnListScreen;
-
-// src/screen/ui-elements.ts
-var import_react4 = require("react");
-var import_ink4 = require("ink");
-function ListItem({
-  children,
-  isSelected = false,
-  color = "white",
-  backgroundColor,
-  bold = false,
-  dimColor = false
-}) {
-  return (0, import_react4.createElement)(
-    import_ink4.Box,
-    {},
-    (0, import_react4.createElement)(import_ink4.Text, {
-      color: isSelected ? backgroundColor || "green" : color,
-      backgroundColor: isSelected ? color : backgroundColor,
-      bold: isSelected || bold,
-      dimColor: !isSelected && dimColor
-    }, children)
-  );
-}
-function TextBlock({
-  text,
-  color = "white",
-  dimmed = false,
-  bold = false,
-  maxWidth
-}) {
-  return (0, import_react4.createElement)(
-    import_ink4.Box,
-    {},
-    (0, import_react4.createElement)(import_ink4.Text, {
-      color,
-      dimColor: dimmed,
-      bold
-    }, text)
-  );
-}
-function Divider({ character = "\u2500", width = 80 }) {
-  return (0, import_react4.createElement)(
-    import_ink4.Box,
-    { marginY: 1 },
-    (0, import_react4.createElement)(import_ink4.Text, { dimColor: true }, character.repeat(width))
-  );
-}
-function GridCell({
-  children,
-  width,
-  color = "white",
-  backgroundColor,
-  bold = false,
-  dimColor = false,
-  align = "left"
-}) {
-  return (0, import_react4.createElement)(
-    import_ink4.Box,
-    { width },
-    (0, import_react4.createElement)(import_ink4.Text, {
-      color,
-      backgroundColor,
-      bold,
-      dimColor,
-      textAlign: align
-    }, children)
-  );
-}
-function InputField({ prompt, value, onChange, onSubmit }) {
-  return (0, import_react4.createElement)(
-    import_ink4.Box,
-    { flexDirection: "column" },
-    (0, import_react4.createElement)(import_ink4.Text, {}, prompt),
-    (0, import_react4.createElement)(
-      import_ink4.Box,
-      { marginTop: 1 },
-      (0, import_react4.createElement)(import_ink4.Text, { color: "cyan" }, " > ", value, "_")
-    )
-  );
-}
-
-// src/screen/utils.ts
-function buildBreadcrumb(parts) {
-  if (parts.length === 0) return "";
-  if (parts.length === 1) return parts[0];
-  return parts.slice(1).map((part) => `\u2190  ${part}`).join("  ");
-}
-function buildDetailBreadcrumb(path4, suffix = "") {
-  if (path4.length <= 1) {
-    return suffix ? `\u2190  ${suffix}` : path4[0] || "";
-  }
-  const breadcrumb = buildBreadcrumb(path4);
-  return suffix ? `${breadcrumb} ${suffix}` : breadcrumb;
-}
+  return arr;
+};
 
-// src/screen/footer-builder.ts
-function buildFooter(config2 = {}) {
-  const {
-    navigation = null,
-    actions = null,
-    info = null,
-    escape = "Esc to go back",
-    custom = null
-  } = config2;
-  const lines = [];
-  const mainParts = [];
-  if (navigation) {
-    mainParts.push(navigation);
+// src/params/index.ts
+var Params = class _Params {
+  context;
+  // Partial context during initialization
+  params = {};
+  definitions = {};
+  args;
+  paramSetters = [];
+  paramGetters = [];
+  trackedParams = [];
+  constructor(context, options = {}) {
+    this.context = context;
+    this.args = context.args;
+    if (Object.keys(options).length > 0) {
+      this.configure(options);
+    }
   }
-  if (actions) {
-    mainParts.push(actions);
+  /**
+   * Configure parameters
+   * Only parameters present in options are updated
+   */
+  configure(options) {
+    for (const [k, v] of Object.entries(options)) {
+      this.params[k] = v;
+    }
   }
-  if (escape) {
-    mainParts.push(escape);
+  /**
+   * Initialize Params from context and CLI parameters
+   * Note: Params is special - it's initialized early with partial context
+   */
+  static init(context, options) {
+    return new _Params(context, options || {});
   }
-  if (mainParts.length > 0) {
-    lines.push(mainParts.join(", "));
+  /**
+   * Track a parameter request for --stopAfter=init feature
+   */
+  trackParam(key, definition, value, source) {
+    this.trackedParams.push({
+      key,
+      definition,
+      value,
+      source
+    });
   }
-  if (info) {
-    const infoLines = Array.isArray(info) ? info : [info];
-    lines.push(...infoLines);
+  /**
+   * Get all tracked parameters (for --stopAfter=init)
+   */
+  getTrackedParams() {
+    return [...this.trackedParams];
   }
-  if (custom) {
-    const customLines = Array.isArray(custom) ? custom : [custom];
-    lines.push(...customLines);
+  /**
+   * Get all figured parameters as a record
+   * Returns all parameters that were collected during initialization,
+   * whether from CLI args, options, or defaults
+   */
+  getAllFigured() {
+    const result = {};
+    for (const param of this.trackedParams) {
+      result[param.key] = {
+        value: param.value,
+        source: param.source
+      };
+    }
+    return result;
+  }
+  /**
+   * Clear tracked parameters
+   */
+  clearTrackedParams() {
+    this.trackedParams = [];
+  }
+  /**
+   * Assign a parameter definition
+   */
+  assignDefinition(key, definition) {
+    if (this.definitions[key] && !definition) {
+      return this.definitions[key];
+    }
+    let type;
+    if (!definition) {
+      type = import_joi.default.string();
+    } else if (import_joi.default.isSchema(definition)) {
+      type = definition;
+    } else if (import_joi.default.isSchema(definition.type)) {
+      type = definition.type;
+    } else if (typeof definition === "string") {
+      type = this.toJoi(definition);
+    } else if (typeof definition.type === "string") {
+      type = this.toJoi(definition.type);
+    } else if (!definition.type) {
+      type = import_joi.default.string();
+    } else {
+      type = import_joi.default.string();
+    }
+    if (!this.definitions[key]) {
+      this.definitions[key] = {};
+    }
+    this.definitions[key].type = type;
+    if (definition && definition.values) {
+      if (Array.isArray(definition.values)) {
+        this.definitions[key].values = definition.values;
+      }
+    }
+    return this.definitions[key];
+  }
+  /**
+   * Convert string definition to Joi schema
+   */
+  toJoi(str) {
+    let type;
+    if (str.match(/^string|^text/i)) {
+      type = import_joi.default.string();
+    } else if (str.match(/^number|^integer|^int/i)) {
+      type = import_joi.default.number();
+    } else if (str.match(/^boolean|^bool/i)) {
+      type = import_joi.default.boolean();
+    } else if (str.match(/^date/i)) {
+      type = import_joi.default.custom(joiEdateType);
+    } else if (str.match(/^duration/i)) {
+      type = import_joi.default.string().isoDuration();
+    } else if (str.match(/^array/i)) {
+      let elementTypes = "string";
+      const tmp = str.match(/\((.*)\)/);
+      if (tmp && tmp[1].match(/string/i)) {
+        elementTypes = "string";
+      } else if (tmp && tmp[1].match(/number|integer|int/i)) {
+        elementTypes = "number";
+      } else if (tmp && tmp[1].match(/boolean|bool/i)) {
+        elementTypes = "boolean";
+      }
+      type = import_joi.default.custom(joiStringArrayType(elementTypes));
+    } else {
+      type = import_joi.default.string();
+    }
+    const regexForDefault = /\bdefault\s+([^\s]+)/;
+    const matchForDefault = str.match(regexForDefault);
+    if (matchForDefault) {
+      const defValObj = type.validate(matchForDefault[1]);
+      if (defValObj.error) {
+        throw new ParamError(`default value "${defValObj.value}" type mismatch`);
+      }
+      type = type.default(defValObj.value);
+    } else if (str.match(/required/)) {
+      type = type.required();
+    } else {
+      type = type.optional();
+    }
+    return type;
   }
-  return lines;
-}
-var FooterPresets = {
   /**
-   * Menu screen footer
+   * Validate a value against a definition
    */
-  menu: (customInfo = null) => buildFooter({
-    navigation: "\u2191/\u2193 to navigate",
-    actions: "Enter to select",
-    escape: "Esc to go back",
-    info: customInfo
-  }),
+  validate(key, val, def) {
+    const normalizedVal = val === null ? void 0 : val;
+    const { value, error } = def.type.validate(normalizedVal, {
+      context: { params: this.params },
+      abortEarly: false,
+      allowUnknown: false
+    });
+    if (error) {
+      const errs = error.details.map((el) => el.message).join(", ");
+      throw new ParamError(`"${key}" validation error: ${errs}`);
+    }
+    return value;
+  }
   /**
-   * Word grid footer
+   * Get a parameter value with validation
    */
-  wordGrid: (totalWords) => buildFooter({
-    navigation: "\u2191\u2193\u2190\u2192 to navigate",
-    actions: "Enter to select",
-    escape: "Esc to go back",
-    info: `Total: ${totalWords} words`
-  }),
+  get(key, definition) {
+    const def = this.assignDefinition(key, definition);
+    let valFromGetters = void 0;
+    if (def.volatile || true) {
+      valFromGetters = this.runAllRegisteredGetters(key);
+    }
+    const valFromArgs = this.args.get(key);
+    const valFromParams = this.params[key];
+    let source = "default";
+    let value;
+    if (valFromGetters !== void 0 && valFromGetters !== null) {
+      value = this.validate(key, valFromGetters, def);
+      source = "options";
+    } else if (valFromArgs !== void 0 && valFromArgs !== null) {
+      value = this.validate(key, valFromArgs, def);
+      source = "cli";
+    } else if (valFromParams !== void 0 && valFromParams !== null) {
+      value = this.validate(key, valFromParams, def);
+      source = "options";
+    } else {
+      value = this.validate(key, void 0, def);
+      source = "default";
+    }
+    this.trackParam(key, definition || "string", value, source);
+    if (value !== void 0 && def.values && !def.values.includes(value)) {
+      throw new ParamError(`key ${key} should be one of ${def.values}`);
+    }
+    return value;
+  }
   /**
-   * Text input footer
+   * Set a parameter value with validation
    */
-  textInput: () => buildFooter({
-    actions: "Type and press Enter to submit",
-    escape: "Esc to cancel"
-  }),
+  set(key, val, definition) {
+    if (val && val.type && val.value) {
+      definition = val;
+      val = val.value;
+    }
+    const def = this.assignDefinition(key, definition);
+    if (!this.runAllRegisteredSetters(key, val)) {
+      this.params[key] = val;
+    }
+  }
   /**
-   * Info/static screen footer
+   * Get all parameters from definitions
+   * Processes parameters left-to-right to support cross-parameter references
    */
-  info: () => buildFooter({
-    escape: "Esc to continue"
-  }),
+  getAll(defs) {
+    const res = {};
+    for (const [k, def] of Object.entries(defs)) {
+      const value = this.get(k, def);
+      res[k] = value;
+      if (value !== void 0) {
+        this.params[k] = value;
+      }
+    }
+    return res;
+  }
   /**
-   * Main menu footer (escape exits)
+   * Run all registered getters for a key
    */
-  mainMenu: () => buildFooter({
-    navigation: "\u2191/\u2193 to navigate",
-    actions: "Enter to select",
-    escape: "Esc to exit"
-  }),
+  runAllRegisteredGetters(key) {
+    let val = void 0;
+    for (const getter of this.paramGetters) {
+      val = getter(key, this.definitions[key]);
+      if (val !== void 0 && val !== null) {
+        break;
+      }
+    }
+    return val;
+  }
   /**
-   * Action menu footer (for word cards, etc.)
+   * Run all registered setters for a key
    */
-  actionMenu: (hasAudio = false) => {
-    const parts = buildFooter({
-      navigation: "\u2191/\u2193 to navigate",
-      actions: "Enter to select",
-      escape: "Esc to go back"
-    });
-    if (hasAudio) {
-      parts.push("Audio available");
+  runAllRegisteredSetters(key, value) {
+    let setterUsed = false;
+    for (const setter of this.paramSetters) {
+      setterUsed = setter(key, value);
+      if (setterUsed) {
+        break;
+      }
     }
-    return parts;
+    return setterUsed;
   }
-};
-function organizeFooterMessages(messages) {
-  if (!messages || messages.length === 0) {
-    return ["Esc to go back"];
+  /**
+   * Register a parameter getter
+   */
+  registerParamGetter(fn) {
+    this.paramGetters.push(fn);
   }
-  const navigation = messages.filter((m) => m.includes("\u2191") || m.includes("\u2193") || m.includes("\u2190") || m.includes("\u2192"));
-  const actions = messages.filter((m) => m.includes("Enter") || m.includes("select") || m.includes("submit"));
-  const escape = messages.filter((m) => m.includes("Esc"));
-  const others = messages.filter(
-    (m) => !navigation.includes(m) && !actions.includes(m) && !escape.includes(m)
-  );
-  const lines = [];
-  const mainLine = [...navigation, ...actions, ...escape].join(", ");
-  if (mainLine) lines.push(mainLine);
-  lines.push(...others);
-  return lines;
-}
+  /**
+   * Register a parameter setter
+   */
+  registerParamSetter(fn) {
+    this.paramSetters.push(fn);
+  }
+};
 
-// src/screen/index.ts
-var loadPromise = null;
-async function load() {
-  if (loadPromise) return loadPromise;
-  loadPromise = Promise.all([
-    import("react"),
-    import("ink")
-  ]).then(() => {
-  });
-  return loadPromise;
-}
-if (typeof window === "undefined") {
-  load().catch(() => {
-  });
-}
+// src/screen.ts
+init_screen();
 
 // src/filedatabase/index.ts
 var import_fs4 = __toESM(require("fs"), 1);
@@ -3031,6 +3195,7 @@ var ALL_LEVELS = [
   "response",
   "progress"
 ];
+var MAX_LEVEL_LENGTH = Math.max(...ALL_LEVELS.map((level) => level.toUpperCase().length));
 var LEVEL_COLORS = {
   error: import_chalk.default.red.bold,
   warn: import_chalk.default.rgb(255, 165, 0),
@@ -3044,13 +3209,104 @@ var LEVEL_COLORS = {
   progress: import_chalk.default.green,
   results: import_chalk.default.magenta
 };
-var CliToolkitLogger = class {
+var Logger = class _Logger {
+  context;
+  // Partial context during initialization
   options;
   transport;
   startTimes = {};
   lastProgressTimes = {};
-  constructor(options = {}) {
-    this.options = this.normalizeOptions(options);
+  constructor(context, options = {}) {
+    this.context = context;
+    this.options = this.getDefaultOptions();
+    if (options) {
+      this.configure(options);
+    }
+    this.updateTransport();
+  }
+  /**
+   * Configure logger options
+   * Only parameters present in options are updated
+   */
+  configure(options) {
+    if (options.mode !== void 0) {
+      this.options.mode = this.isValidMode(options.mode) ? options.mode : "text";
+    }
+    if (options.route !== void 0) {
+      this.options.route = options.route;
+      this.updateTransport();
+    }
+    if (options.prefix !== void 0) {
+      this.options.prefix = options.prefix;
+    }
+    if (options.silent !== void 0) {
+      this.options.silent = options.silent;
+    }
+    if (options.showLevel !== void 0) {
+      this.options.showLevel = options.showLevel;
+    }
+    if (options.timestamp !== void 0) {
+      this.options.timestamp = options.timestamp;
+    }
+    if (options.levels !== void 0) {
+      this.options.levels = this.normalizeLevels(options.levels);
+    }
+    if (options.progress !== void 0) {
+      if (options.progress.withTimes !== void 0) {
+        this.options.progressTimes = options.progress.withTimes;
+      }
+      if (options.progress.throttleMs !== void 0) {
+        this.options.progressThrottle = options.progress.throttleMs;
+      }
+    }
+  }
+  /**
+   * Initialize logger from context and CLI parameters
+   */
+  static init(context, options) {
+    const paramDefs = {
+      mode: "string default text",
+      route: "string default console",
+      prefix: "string",
+      silent: "boolean default false",
+      showLevel: "boolean default true",
+      timestamp: "boolean default false",
+      levels: "string",
+      progressWithTimes: "boolean default false",
+      progressThrottleMs: "number"
+    };
+    const cliParams = context.params.getAll(paramDefs);
+    const config2 = {
+      mode: options?.mode ?? cliParams.mode,
+      route: options?.route ?? cliParams.route,
+      prefix: options?.prefix ?? cliParams.prefix,
+      silent: options?.silent ?? cliParams.silent,
+      showLevel: options?.showLevel ?? cliParams.showLevel,
+      timestamp: options?.timestamp ?? cliParams.timestamp,
+      levels: options?.levels ?? (cliParams.levels ? cliParams.levels.split(",") : void 0),
+      progress: options?.progress ?? {
+        withTimes: cliParams.progressWithTimes,
+        throttleMs: cliParams.progressThrottleMs
+      }
+    };
+    const logger = new _Logger(context, config2);
+    context.logger = logger;
+    return logger;
+  }
+  getDefaultOptions() {
+    return {
+      mode: "text",
+      route: this.shouldUseIpcRoute() ? "ipc" : "console",
+      prefix: void 0,
+      silent: false,
+      showLevel: true,
+      timestamp: false,
+      levels: ALL_LEVELS,
+      progressTimes: false,
+      progressThrottle: void 0
+    };
+  }
+  updateTransport() {
     this.transport = this.options.route === "ipc" ? new ParentProcessTransport() : new ConsoleTransport();
   }
   setMode(mode) {
@@ -3159,7 +3415,7 @@ var CliToolkitLogger = class {
       parts.push(now.toISOString());
     }
     if (this.options.showLevel) {
-      parts.push(struct.level.toUpperCase());
+      parts.push(struct.level.toUpperCase().padEnd(MAX_LEVEL_LENGTH));
     }
     if (struct.level === "progress") {
       if (struct.prefix) {
@@ -3193,22 +3449,6 @@ var CliToolkitLogger = class {
   inspectChunks(chunks) {
     return chunks.map((chunk) => import_util.default.inspect(chunk, { colors: true, depth: null })).join(" ");
   }
-  normalizeOptions(options) {
-    const { route, mode, prefix, silent, showLevel, timestamp, levels, progress } = options;
-    const shouldUseIpc = this.shouldUseIpcRoute();
-    const normalized = {
-      mode: this.isValidMode(mode) ? mode : "text",
-      route: route ?? (shouldUseIpc ? "ipc" : "console"),
-      prefix,
-      silent: silent ?? false,
-      showLevel: showLevel ?? true,
-      timestamp: timestamp ?? false,
-      levels: this.normalizeLevels(levels),
-      progressTimes: progress?.withTimes ?? false,
-      progressThrottle: progress?.throttleMs
-    };
-    return normalized;
-  }
   shouldUseIpcRoute() {
     if (process.env.VITEST || process.env.NODE_ENV === "test") {
       return false;
@@ -3239,35 +3479,44 @@ var CliToolkitLogger = class {
 
 // src/init/index.ts
 var import_events = require("events");
+function extractComponentOptions(opts, componentName) {
+  const reservedKeys = ["overrides", "defaults", "modules"];
+  const componentOptions = {};
+  for (const [key, value] of Object.entries(opts)) {
+    if (!reservedKeys.includes(key)) {
+      componentOptions[key] = value;
+    }
+  }
+  return componentOptions;
+}
 function setup(opts = {}) {
-  const args = new Args({
+  const args = Args.init({
     overrides: opts.overrides || {},
     defaults: opts.defaults || {}
   });
-  const params = new Params({ args }, opts.overrides || {});
-  const loggerOptions = opts.logger || {};
-  const logger = new CliToolkitLogger({
-    mode: loggerOptions.mode || "text",
-    route: loggerOptions.route || "console",
-    prefix: loggerOptions.prefix,
-    silent: loggerOptions.silent,
-    showLevel: loggerOptions.showLevel,
-    timestamp: loggerOptions.timestamp,
-    levels: loggerOptions.levels
-  });
-  const cleanupFunctions = [];
-  const context = {
+  const partialContext = {
     args,
-    params,
-    logger,
     emitter: new import_events.EventEmitter(),
     isStop: () => false,
-    // Will be set in init function
-    cleanupFunctions,
+    cleanupFunctions: [],
     registerCleanup: (fn) => {
-      cleanupFunctions.push(fn);
+      partialContext.cleanupFunctions.push(fn);
     }
   };
+  const params = Params.init(partialContext, opts.overrides || {});
+  partialContext.params = params;
+  const loggerOptions = extractComponentOptions(opts, "logger");
+  const logger = Logger.init(partialContext, loggerOptions);
+  partialContext.logger = logger;
+  const context = {
+    args,
+    params,
+    logger,
+    emitter: partialContext.emitter,
+    isStop: partialContext.isStop,
+    cleanupFunctions: partialContext.cleanupFunctions,
+    registerCleanup: partialContext.registerCleanup
+  };
   logger.debug("[setup] completed successfully");
   return context;
 }
@@ -3305,7 +3554,6 @@ function setupContext(opts = {}) {
   defaultFileSynopsisFunction,
   defaultVersionSynopsisFunction,
   getArgsInstance,
-  getParamsInstance,
   h,
   joiEdateType,
   joiStringArrayType,