@juanibiapina/pi-extension-settings 0.7.0 → 0.8.0

package/src/settings/storage.ts

@@ -0,0 +1,86 @@
+/**
+ * Read/write extension settings to JSON files.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+
+const SETTINGS_FILE_NAME = "settings-extensions.json";
+
+type SettingsFile = Record<string, Record<string, string>>;
+
+/**
+ * Get the global settings file path.
+ */
+function getGlobalSettingsPath(): string {
+	return join(getAgentDir(), SETTINGS_FILE_NAME);
+}
+
+/**
+ * Load the settings file. Returns empty object if file doesn't exist or is invalid.
+ */
+function loadSettingsFile(path: string): SettingsFile {
+	if (!existsSync(path)) {
+		return {};
+	}
+	try {
+		const content = readFileSync(path, "utf-8");
+		return JSON.parse(content) as SettingsFile;
+	} catch {
+		return {};
+	}
+}
+
+/**
+ * Save settings to the global file.
+ */
+function saveSettingsFile(path: string, settings: SettingsFile): void {
+	const dir = dirname(path);
+	if (!existsSync(dir)) {
+		mkdirSync(dir, { recursive: true });
+	}
+	writeFileSync(path, JSON.stringify(settings, null, "\t"));
+}
+
+/**
+ * Get a setting value for an extension.
+ * Returns the stored value, or the provided default, or undefined.
+ *
+ * @param extensionName - Extension name
+ * @param settingId - Setting ID within the extension
+ * @param defaultValue - Default value if setting is not found
+ * @returns The setting value
+ */
+export function getSetting(extensionName: string, settingId: string, defaultValue?: string): string | undefined {
+	const globalPath = getGlobalSettingsPath();
+	const settings = loadSettingsFile(globalPath);
+
+	// Check if value exists in file
+	const extSettings = settings[extensionName];
+	if (extSettings && settingId in extSettings) {
+		return extSettings[settingId];
+	}
+
+	return defaultValue;
+}
+
+/**
+ * Set a setting value for an extension.
+ * Always writes to the global settings file.
+ *
+ * @param extensionName - Extension name
+ * @param settingId - Setting ID within the extension
+ * @param value - Value to set
+ */
+export function setSetting(extensionName: string, settingId: string, value: string): void {
+	const globalPath = getGlobalSettingsPath();
+	const settings = loadSettingsFile(globalPath);
+
+	if (!settings[extensionName]) {
+		settings[extensionName] = {};
+	}
+	settings[extensionName][settingId] = value;
+
+	saveSettingsFile(globalPath, settings);
+}

package/src/settings/types.ts

@@ -0,0 +1,34 @@
+/**
+ * Type definitions for extension settings.
+ */
+
+export interface OrderedListOption {
+	/** Value stored in the comma-separated setting */
+	id: string;
+	/** Display label in the menu */
+	label: string;
+}
+
+export interface SettingDefinition {
+	/** Unique identifier for this setting within the extension */
+	id: string;
+	/** Display label */
+	label: string;
+	/** Optional description shown when selected */
+	description?: string;
+	/** Default value if not set in config file */
+	defaultValue: string;
+	/**
+	 * Values to cycle through (Enter/Space cycles).
+	 * If undefined or empty, the setting is treated as a free-form string input.
+	 * Mutually exclusive with `options`.
+	 */
+	values?: string[];
+	/**
+	 * Available options for ordered multi-select.
+	 * When present, Enter opens an ordered list submenu where items can be
+	 * toggled on/off and reordered. Value is stored as comma-separated IDs.
+	 * Mutually exclusive with `values`.
+	 */
+	options?: OrderedListOption[];
+}

package/dist/components/ordered-multi-select.d.ts

@@ -1,26 +0,0 @@
-/**
- * Ordered multi-select component.
- *
- * Displays a list of options that can be toggled on/off and reordered.
- * Selected items appear at the top with their position number.
- * Value is stored as a comma-separated string of selected IDs in order.
- */
-import { type Component } from "@earendil-works/pi-tui";
-import type { OrderedListOption } from "../settings/types.js";
-import type { SettingsListTheme } from "./settings-list.js";
-export declare class OrderedMultiSelect implements Component {
-    private options;
-    private selected;
-    private cursorIndex;
-    private theme;
-    private done;
-    constructor(options: OrderedListOption[], currentValue: string, theme: SettingsListTheme, done: (selectedValue?: string) => void);
-    invalidate(): void;
-    render(width: number): string[];
-    handleInput(data: string): void;
-    private buildDisplayItems;
-    private toggleCurrent;
-    private moveUp;
-    private moveDown;
-}
-//# sourceMappingURL=ordered-multi-select.d.ts.map

package/dist/components/ordered-multi-select.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ordered-multi-select.d.ts","sourceRoot":"","sources":["../../src/components/ordered-multi-select.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,SAAS,EAA+C,MAAM,wBAAwB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAS5D,qBAAa,kBAAmB,YAAW,SAAS;IACnD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,IAAI,CAAmC;gBAG9C,OAAO,EAAE,iBAAiB,EAAE,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI;IAWvC,UAAU,IAAI,IAAI;IAElB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAkC/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA2B/B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,QAAQ;CAYhB"}

package/dist/components/ordered-multi-select.js

@@ -1,141 +0,0 @@
-/**
- * Ordered multi-select component.
- *
- * Displays a list of options that can be toggled on/off and reordered.
- * Selected items appear at the top with their position number.
- * Value is stored as a comma-separated string of selected IDs in order.
- */
-import { getKeybindings, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
-export class OrderedMultiSelect {
-    options;
-    selected;
-    cursorIndex = 0;
-    theme;
-    done;
-    constructor(options, currentValue, theme, done) {
-        this.options = options;
-        this.selected = currentValue
-            .split(",")
-            .map((s) => s.trim())
-            .filter(Boolean);
-        this.theme = theme;
-        this.done = done;
-    }
-    invalidate() { }
-    render(width) {
-        const lines = [];
-        const items = this.buildDisplayItems();
-        for (let i = 0; i < items.length; i++) {
-            const item = items[i];
-            const isCursor = i === this.cursorIndex;
-            const prefix = isCursor ? this.theme.cursor : "  ";
-            let marker;
-            if (item.selected) {
-                marker = this.theme.value(`✓ ${String(item.position).padStart(2)}`, isCursor);
-            }
-            else {
-                marker = this.theme.label("     ", isCursor);
-            }
-            const label = this.theme.label(item.option.label, isCursor);
-            const line = `${prefix}${marker}  ${label}`;
-            lines.push(truncateToWidth(line, width, "…"));
-        }
-        // Scroll indicator
-        if (items.length > 0) {
-            const scrollText = `  (${this.cursorIndex + 1}/${items.length})`;
-            lines.push(this.theme.hint(scrollText));
-        }
-        // Hint line
-        lines.push("");
-        lines.push(this.theme.hint("  Space toggle · Shift+↑/↓ reorder · Enter confirm · Esc cancel"));
-        return lines;
-    }
-    handleInput(data) {
-        const kb = getKeybindings();
-        const items = this.buildDisplayItems();
-        if (items.length === 0) {
-            if (kb.matches(data, "tui.select.cancel")) {
-                this.done(undefined);
-            }
-            return;
-        }
-        if (kb.matches(data, "tui.select.up") || matchesKey(data, "up")) {
-            this.cursorIndex = this.cursorIndex === 0 ? items.length - 1 : this.cursorIndex - 1;
-        }
-        else if (kb.matches(data, "tui.select.down") || matchesKey(data, "down")) {
-            this.cursorIndex = this.cursorIndex === items.length - 1 ? 0 : this.cursorIndex + 1;
-        }
-        else if (data === " " || matchesKey(data, "space")) {
-            this.toggleCurrent(items);
-        }
-        else if (matchesKey(data, "shift+up")) {
-            this.moveUp(items);
-        }
-        else if (matchesKey(data, "shift+down")) {
-            this.moveDown(items);
-        }
-        else if (kb.matches(data, "tui.select.confirm")) {
-            this.done(this.selected.join(","));
-        }
-        else if (kb.matches(data, "tui.select.cancel")) {
-            this.done(undefined);
-        }
-    }
-    buildDisplayItems() {
-        const items = [];
-        // Selected items first, in order
-        for (let i = 0; i < this.selected.length; i++) {
-            const id = this.selected[i];
-            const option = this.options.find((o) => o.id === id);
-            if (option) {
-                items.push({ option, selected: true, position: i + 1 });
-            }
-        }
-        // Unselected items, in original options order
-        for (const option of this.options) {
-            if (!this.selected.includes(option.id)) {
-                items.push({ option, selected: false, position: 0 });
-            }
-        }
-        return items;
-    }
-    toggleCurrent(items) {
-        const item = items[this.cursorIndex];
-        if (!item)
-            return;
-        const id = item.option.id;
-        if (item.selected) {
-            // Remove from selected
-            this.selected = this.selected.filter((s) => s !== id);
-        }
-        else {
-            // Add to end of selected
-            this.selected.push(id);
-        }
-    }
-    moveUp(items) {
-        const item = items[this.cursorIndex];
-        if (!item?.selected)
-            return;
-        const idx = this.selected.indexOf(item.option.id);
-        if (idx <= 0)
-            return;
-        // Swap with previous in selected array
-        [this.selected[idx - 1], this.selected[idx]] = [this.selected[idx], this.selected[idx - 1]];
-        // Move cursor up to follow the item
-        this.cursorIndex--;
-    }
-    moveDown(items) {
-        const item = items[this.cursorIndex];
-        if (!item?.selected)
-            return;
-        const idx = this.selected.indexOf(item.option.id);
-        if (idx < 0 || idx >= this.selected.length - 1)
-            return;
-        // Swap with next in selected array
-        [this.selected[idx], this.selected[idx + 1]] = [this.selected[idx + 1], this.selected[idx]];
-        // Move cursor down to follow the item
-        this.cursorIndex++;
-    }
-}
-//# sourceMappingURL=ordered-multi-select.js.map

package/dist/components/ordered-multi-select.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ordered-multi-select.js","sourceRoot":"","sources":["../../src/components/ordered-multi-select.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ordered multi-select component.\n *\n * Displays a list of options that can be toggled on/off and reordered.\n * Selected items appear at the top with their position number.\n * Value is stored as a comma-separated string of selected IDs in order.\n */\n\nimport { type Component, getKeybindings, matchesKey, truncateToWidth } from \"@earendil-works/pi-tui\";\nimport type { OrderedListOption } from \"../settings/types.js\";\nimport type { SettingsListTheme } from \"./settings-list.js\";\n\ninterface DisplayItem {\n\toption: OrderedListOption;\n\tselected: boolean;\n\t/** 1-based position within selected items, or 0 if not selected */\n\tposition: number;\n}\n\nexport class OrderedMultiSelect implements Component {\n\tprivate options: OrderedListOption[];\n\tprivate selected: string[];\n\tprivate cursorIndex = 0;\n\tprivate theme: SettingsListTheme;\n\tprivate done: (selectedValue?: string) => void;\n\n\tconstructor(\n\t\toptions: OrderedListOption[],\n\t\tcurrentValue: string,\n\t\ttheme: SettingsListTheme,\n\t\tdone: (selectedValue?: string) => void,\n\t) {\n\t\tthis.options = options;\n\t\tthis.selected = currentValue\n\t\t\t.split(\",\")\n\t\t\t.map((s) => s.trim())\n\t\t\t.filter(Boolean);\n\t\tthis.theme = theme;\n\t\tthis.done = done;\n\t}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tconst lines: string[] = [];\n\t\tconst items = this.buildDisplayItems();\n\n\t\tfor (let i = 0; i < items.length; i++) {\n\t\t\tconst item = items[i];\n\t\t\tconst isCursor = i === this.cursorIndex;\n\t\t\tconst prefix = isCursor ? this.theme.cursor : \"  \";\n\n\t\t\tlet marker: string;\n\t\t\tif (item.selected) {\n\t\t\t\tmarker = this.theme.value(`✓ ${String(item.position).padStart(2)}`, isCursor);\n\t\t\t} else {\n\t\t\t\tmarker = this.theme.label(\"     \", isCursor);\n\t\t\t}\n\n\t\t\tconst label = this.theme.label(item.option.label, isCursor);\n\t\t\tconst line = `${prefix}${marker}  ${label}`;\n\t\t\tlines.push(truncateToWidth(line, width, \"…\"));\n\t\t}\n\n\t\t// Scroll indicator\n\t\tif (items.length > 0) {\n\t\t\tconst scrollText = `  (${this.cursorIndex + 1}/${items.length})`;\n\t\t\tlines.push(this.theme.hint(scrollText));\n\t\t}\n\n\t\t// Hint line\n\t\tlines.push(\"\");\n\t\tlines.push(this.theme.hint(\"  Space toggle · Shift+↑/↓ reorder · Enter confirm · Esc cancel\"));\n\n\t\treturn lines;\n\t}\n\n\thandleInput(data: string): void {\n\t\tconst kb = getKeybindings();\n\t\tconst items = this.buildDisplayItems();\n\t\tif (items.length === 0) {\n\t\t\tif (kb.matches(data, \"tui.select.cancel\")) {\n\t\t\t\tthis.done(undefined);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif (kb.matches(data, \"tui.select.up\") || matchesKey(data, \"up\")) {\n\t\t\tthis.cursorIndex = this.cursorIndex === 0 ? items.length - 1 : this.cursorIndex - 1;\n\t\t} else if (kb.matches(data, \"tui.select.down\") || matchesKey(data, \"down\")) {\n\t\t\tthis.cursorIndex = this.cursorIndex === items.length - 1 ? 0 : this.cursorIndex + 1;\n\t\t} else if (data === \" \" || matchesKey(data, \"space\")) {\n\t\t\tthis.toggleCurrent(items);\n\t\t} else if (matchesKey(data, \"shift+up\")) {\n\t\t\tthis.moveUp(items);\n\t\t} else if (matchesKey(data, \"shift+down\")) {\n\t\t\tthis.moveDown(items);\n\t\t} else if (kb.matches(data, \"tui.select.confirm\")) {\n\t\t\tthis.done(this.selected.join(\",\"));\n\t\t} else if (kb.matches(data, \"tui.select.cancel\")) {\n\t\t\tthis.done(undefined);\n\t\t}\n\t}\n\n\tprivate buildDisplayItems(): DisplayItem[] {\n\t\tconst items: DisplayItem[] = [];\n\n\t\t// Selected items first, in order\n\t\tfor (let i = 0; i < this.selected.length; i++) {\n\t\t\tconst id = this.selected[i];\n\t\t\tconst option = this.options.find((o) => o.id === id);\n\t\t\tif (option) {\n\t\t\t\titems.push({ option, selected: true, position: i + 1 });\n\t\t\t}\n\t\t}\n\n\t\t// Unselected items, in original options order\n\t\tfor (const option of this.options) {\n\t\t\tif (!this.selected.includes(option.id)) {\n\t\t\t\titems.push({ option, selected: false, position: 0 });\n\t\t\t}\n\t\t}\n\n\t\treturn items;\n\t}\n\n\tprivate toggleCurrent(items: DisplayItem[]): void {\n\t\tconst item = items[this.cursorIndex];\n\t\tif (!item) return;\n\n\t\tconst id = item.option.id;\n\t\tif (item.selected) {\n\t\t\t// Remove from selected\n\t\t\tthis.selected = this.selected.filter((s) => s !== id);\n\t\t} else {\n\t\t\t// Add to end of selected\n\t\t\tthis.selected.push(id);\n\t\t}\n\t}\n\n\tprivate moveUp(items: DisplayItem[]): void {\n\t\tconst item = items[this.cursorIndex];\n\t\tif (!item?.selected) return;\n\n\t\tconst idx = this.selected.indexOf(item.option.id);\n\t\tif (idx <= 0) return;\n\n\t\t// Swap with previous in selected array\n\t\t[this.selected[idx - 1], this.selected[idx]] = [this.selected[idx], this.selected[idx - 1]];\n\t\t// Move cursor up to follow the item\n\t\tthis.cursorIndex--;\n\t}\n\n\tprivate moveDown(items: DisplayItem[]): void {\n\t\tconst item = items[this.cursorIndex];\n\t\tif (!item?.selected) return;\n\n\t\tconst idx = this.selected.indexOf(item.option.id);\n\t\tif (idx < 0 || idx >= this.selected.length - 1) return;\n\n\t\t// Swap with next in selected array\n\t\t[this.selected[idx], this.selected[idx + 1]] = [this.selected[idx + 1], this.selected[idx]];\n\t\t// Move cursor down to follow the item\n\t\tthis.cursorIndex++;\n\t}\n}\n"]}

package/dist/components/settings-list.d.ts

@@ -1,64 +0,0 @@
-/**
- * Settings list component with support for cycling values and string input.
- * Based on @earendil-works/pi-tui SettingsList, extended with string editing.
- */
-import { type Component } from "@earendil-works/pi-tui";
-export interface SettingItem {
-    /** Unique identifier for this setting */
-    id: string;
-    /** Display label (left side) */
-    label: string;
-    /** Optional description shown when selected */
-    description?: string;
-    /** Current value to display (right side) */
-    currentValue: string;
-    /**
-     * If provided, Enter/Space cycles through these values.
-     * If undefined/empty, the setting is treated as a string input.
-     */
-    values?: string[];
-    /** If provided, Enter opens this submenu. Receives current value and done callback. */
-    submenu?: (currentValue: string, done: (selectedValue?: string) => void) => Component;
-    /** If false, item is selectable but cannot be edited or changed. */
-    editable?: boolean;
-}
-export interface SettingsListTheme {
-    label: (text: string, selected: boolean) => string;
-    value: (text: string, selected: boolean) => string;
-    description: (text: string) => string;
-    cursor: string;
-    hint: (text: string) => string;
-}
-export interface SettingsListOptions {
-    enableSearch?: boolean;
-}
-export declare class SettingsList implements Component {
-    private items;
-    private filteredItems;
-    private theme;
-    private selectedIndex;
-    private maxVisible;
-    private onChange;
-    private onCancel;
-    private searchInput?;
-    private searchEnabled;
-    private submenuComponent;
-    private submenuItemIndex;
-    private editingInput;
-    private editingItemIndex;
-    constructor(items: SettingItem[], maxVisible: number, theme: SettingsListTheme, onChange: (id: string, newValue: string) => void, onCancel: () => void, options?: SettingsListOptions);
-    /** Update an item's currentValue */
-    updateValue(id: string, newValue: string): void;
-    invalidate(): void;
-    render(width: number): string[];
-    private renderMainList;
-    handleInput(data: string): void;
-    private handleEditingInput;
-    private confirmEdit;
-    private cancelEdit;
-    private activateItem;
-    private closeSubmenu;
-    private applyFilter;
-    private addHintLine;
-}
-//# sourceMappingURL=settings-list.d.ts.map

package/dist/components/settings-list.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"settings-list.d.ts","sourceRoot":"","sources":["../../src/components/settings-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,KAAK,SAAS,EAQd,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,WAAW;IAC3B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uFAAuF;IACvF,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI,KAAK,SAAS,CAAC;IACtF,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;IACnD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;IACnD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,YAAa,YAAW,SAAS;IAC7C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAU;IAG/B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,gBAAgB,CAAuB;IAG/C,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,gBAAgB,CAAuB;gBAG9C,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,EAChD,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,GAAE,mBAAwB;IAclC,oCAAoC;IACpC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO/C,UAAU,IAAI,IAAI;IAIlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAS/B,OAAO,CAAC,cAAc;IAqFtB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqC/B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;CAUnB"}

package/dist/components/settings-list.js

@@ -1,251 +0,0 @@
-/**
- * Settings list component with support for cycling values and string input.
- * Based on @earendil-works/pi-tui SettingsList, extended with string editing.
- */
-import { fuzzyFilter, getKeybindings, Input, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
-export class SettingsList {
-    items;
-    filteredItems;
-    theme;
-    selectedIndex = 0;
-    maxVisible;
-    onChange;
-    onCancel;
-    searchInput;
-    searchEnabled;
-    // Submenu state
-    submenuComponent = null;
-    submenuItemIndex = null;
-    // String editing state
-    editingInput = null;
-    editingItemIndex = null;
-    constructor(items, maxVisible, theme, onChange, onCancel, options = {}) {
-        this.items = items;
-        this.filteredItems = items;
-        this.maxVisible = maxVisible;
-        this.theme = theme;
-        this.onChange = onChange;
-        this.onCancel = onCancel;
-        this.searchEnabled = options.enableSearch ?? false;
-        if (this.searchEnabled) {
-            this.searchInput = new Input();
-        }
-    }
-    /** Update an item's currentValue */
-    updateValue(id, newValue) {
-        const item = this.items.find((i) => i.id === id);
-        if (item) {
-            item.currentValue = newValue;
-        }
-    }
-    invalidate() {
-        this.submenuComponent?.invalidate?.();
-    }
-    render(width) {
-        // If submenu is active, render it instead
-        if (this.submenuComponent) {
-            return this.submenuComponent.render(width);
-        }
-        return this.renderMainList(width);
-    }
-    renderMainList(width) {
-        const lines = [];
-        if (this.searchEnabled && this.searchInput && !this.editingInput) {
-            lines.push(...this.searchInput.render(width));
-            lines.push("");
-        }
-        if (this.items.length === 0) {
-            lines.push(this.theme.hint("  No settings available"));
-            if (this.searchEnabled) {
-                this.addHintLine(lines);
-            }
-            return lines;
-        }
-        const displayItems = this.searchEnabled ? this.filteredItems : this.items;
-        if (displayItems.length === 0) {
-            lines.push(this.theme.hint("  No matching settings"));
-            this.addHintLine(lines);
-            return lines;
-        }
-        // Calculate visible range with scrolling
-        const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(this.maxVisible / 2), displayItems.length - this.maxVisible));
-        const endIndex = Math.min(startIndex + this.maxVisible, displayItems.length);
-        // Calculate max label width for alignment
-        const maxLabelWidth = Math.min(30, Math.max(...this.items.map((item) => visibleWidth(item.label))));
-        // Render visible items
-        for (let i = startIndex; i < endIndex; i++) {
-            const item = displayItems[i];
-            if (!item)
-                continue;
-            const isSelected = i === this.selectedIndex;
-            const isEditing = this.editingInput && this.editingItemIndex === i;
-            const prefix = isSelected ? this.theme.cursor : "  ";
-            const prefixWidth = visibleWidth(prefix);
-            // Pad label to align values
-            const labelPadded = item.label + " ".repeat(Math.max(0, maxLabelWidth - visibleWidth(item.label)));
-            const labelText = this.theme.label(labelPadded, isSelected);
-            // Calculate space for value
-            const separator = "  ";
-            const usedWidth = prefixWidth + maxLabelWidth + visibleWidth(separator);
-            const valueMaxWidth = width - usedWidth - 2;
-            if (isEditing && this.editingInput) {
-                // Render inline input for string editing
-                const inputLines = this.editingInput.render(valueMaxWidth);
-                const inputLine = inputLines[0] ?? "";
-                lines.push(prefix + labelText + separator + inputLine);
-            }
-            else {
-                const valueText = this.theme.value(truncateToWidth(item.currentValue, valueMaxWidth, ""), isSelected);
-                lines.push(prefix + labelText + separator + valueText);
-            }
-        }
-        // Add scroll indicator if needed
-        if (startIndex > 0 || endIndex < displayItems.length) {
-            const scrollText = `  (${this.selectedIndex + 1}/${displayItems.length})`;
-            lines.push(this.theme.hint(truncateToWidth(scrollText, width - 2, "")));
-        }
-        // Add description for selected item
-        const selectedItem = displayItems[this.selectedIndex];
-        if (selectedItem?.description && !this.editingInput) {
-            lines.push("");
-            const wrappedDesc = wrapTextWithAnsi(selectedItem.description, width - 4);
-            for (const line of wrappedDesc) {
-                lines.push(this.theme.description(`  ${line}`));
-            }
-        }
-        // Add hint
-        this.addHintLine(lines);
-        return lines;
-    }
-    handleInput(data) {
-        // If editing a string value, handle input for the editor
-        if (this.editingInput) {
-            this.handleEditingInput(data);
-            return;
-        }
-        // If submenu is active, delegate all input to it
-        if (this.submenuComponent) {
-            this.submenuComponent.handleInput?.(data);
-            return;
-        }
-        // Main list input handling
-        const kb = getKeybindings();
-        const displayItems = this.searchEnabled ? this.filteredItems : this.items;
-        if (kb.matches(data, "tui.select.up")) {
-            if (displayItems.length === 0)
-                return;
-            this.selectedIndex = this.selectedIndex === 0 ? displayItems.length - 1 : this.selectedIndex - 1;
-        }
-        else if (kb.matches(data, "tui.select.down")) {
-            if (displayItems.length === 0)
-                return;
-            this.selectedIndex = this.selectedIndex === displayItems.length - 1 ? 0 : this.selectedIndex + 1;
-        }
-        else if (kb.matches(data, "tui.select.confirm") || data === " ") {
-            this.activateItem();
-        }
-        else if (kb.matches(data, "tui.select.cancel")) {
-            this.onCancel();
-        }
-        else if (this.searchEnabled && this.searchInput) {
-            const sanitized = data.replace(/ /g, "");
-            if (!sanitized) {
-                return;
-            }
-            this.searchInput.handleInput(sanitized);
-            this.applyFilter(this.searchInput.getValue());
-        }
-    }
-    handleEditingInput(data) {
-        if (!this.editingInput)
-            return;
-        // Enter: confirm edit
-        if (matchesKey(data, "enter")) {
-            this.confirmEdit();
-            return;
-        }
-        // Escape: cancel edit
-        if (matchesKey(data, "escape")) {
-            this.cancelEdit();
-            return;
-        }
-        // Pass other input to the editor
-        this.editingInput.handleInput(data);
-    }
-    confirmEdit() {
-        if (!this.editingInput || this.editingItemIndex === null)
-            return;
-        const displayItems = this.searchEnabled ? this.filteredItems : this.items;
-        const item = displayItems[this.editingItemIndex];
-        if (item) {
-            const newValue = this.editingInput.getValue();
-            item.currentValue = newValue;
-            this.onChange(item.id, newValue);
-        }
-        this.editingInput = null;
-        this.editingItemIndex = null;
-    }
-    cancelEdit() {
-        this.editingInput = null;
-        this.editingItemIndex = null;
-    }
-    activateItem() {
-        const displayItems = this.searchEnabled ? this.filteredItems : this.items;
-        const item = displayItems[this.selectedIndex];
-        if (!item)
-            return;
-        if (item.editable === false) {
-            return;
-        }
-        if (item.submenu) {
-            // Open submenu, passing current value so it can pre-select correctly
-            this.submenuItemIndex = this.selectedIndex;
-            this.submenuComponent = item.submenu(item.currentValue, (selectedValue) => {
-                if (selectedValue !== undefined) {
-                    item.currentValue = selectedValue;
-                    this.onChange(item.id, selectedValue);
-                }
-                this.closeSubmenu();
-            });
-        }
-        else if (item.values && item.values.length > 0) {
-            // Cycle through values
-            const currentIndex = item.values.indexOf(item.currentValue);
-            const nextIndex = (currentIndex + 1) % item.values.length;
-            const newValue = item.values[nextIndex];
-            item.currentValue = newValue;
-            this.onChange(item.id, newValue);
-        }
-        else {
-            // String input - start editing
-            this.editingItemIndex = this.selectedIndex;
-            this.editingInput = new Input();
-            this.editingInput.setValue(item.currentValue);
-        }
-    }
-    closeSubmenu() {
-        this.submenuComponent = null;
-        // Restore selection to the item that opened the submenu
-        if (this.submenuItemIndex !== null) {
-            this.selectedIndex = this.submenuItemIndex;
-            this.submenuItemIndex = null;
-        }
-    }
-    applyFilter(query) {
-        this.filteredItems = fuzzyFilter(this.items, query, (item) => item.label);
-        this.selectedIndex = 0;
-    }
-    addHintLine(lines) {
-        lines.push("");
-        if (this.editingInput) {
-            lines.push(this.theme.hint("  Enter to confirm · Esc to cancel"));
-        }
-        else if (this.searchEnabled) {
-            lines.push(this.theme.hint("  Type to search · Enter/Space to change · Esc to cancel"));
-        }
-        else {
-            lines.push(this.theme.hint("  Enter/Space to change · Esc to cancel"));
-        }
-    }
-}
-//# sourceMappingURL=settings-list.js.map