@boba-cli/filepicker 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,16 @@
+# @boba-cli/filepicker
+
+File system browser component for Boba terminal UIs. Ported from the Charm `bubbles/filepicker` component.
+
+<img src="../../examples/filepicker-demo.gif" width="950" alt="Filepicker component demo" />
+
+## Usage
+
+```ts
+import { FilepickerModel } from '@boba-cli/filepicker'
+
+const [picker, cmd] = FilepickerModel.new({
+  currentDir: process.cwd(),
+  showHidden: false,
+})
+```

package/dist/index.cjs

@@ -0,0 +1,317 @@
+'use strict';
+
+var key = require('@boba-cli/key');
+var chapstick = require('@boba-cli/chapstick');
+var tea = require('@boba-cli/tea');
+
+// src/fs.ts
+async function readDirectory(filesystem, pathAdapter, path, showHidden, dirFirst = true) {
+  const result = await filesystem.readdir(path, { withFileTypes: true });
+  if (typeof result[0] === "string") {
+    throw new Error("Expected DirectoryEntry array but got string array");
+  }
+  const entries = result;
+  const files = [];
+  for (const entry of entries) {
+    const isHidden = isHiddenUnix(entry.name);
+    if (!showHidden && isHidden) continue;
+    const fullPath = pathAdapter.join(path, entry.name);
+    const stats = await filesystem.stat(fullPath);
+    files.push({
+      name: entry.name,
+      path: fullPath,
+      isDir: entry.isDirectory(),
+      isHidden,
+      size: stats.size,
+      mode: stats.mode
+    });
+  }
+  return files.sort((a, b) => sortFiles(a, b, dirFirst));
+}
+function sortFiles(a, b, dirFirst = true) {
+  if (dirFirst) {
+    if (a.isDir && !b.isDir) return -1;
+    if (!a.isDir && b.isDir) return 1;
+  }
+  return a.name.localeCompare(b.name);
+}
+function isHiddenUnix(name) {
+  return name.startsWith(".");
+}
+var defaultKeyMap = {
+  up: key.newBinding({ keys: ["up", "k"] }),
+  down: key.newBinding({ keys: ["down", "j"] }),
+  select: key.newBinding({ keys: ["enter"] }),
+  back: key.newBinding({ keys: ["backspace", "h", "left"] }),
+  open: key.newBinding({ keys: ["right", "l"] }),
+  toggleHidden: key.newBinding({ keys: ["."] }),
+  pageUp: key.newBinding({ keys: ["pgup", "u"] }),
+  pageDown: key.newBinding({ keys: ["pgdown", "d"] }),
+  gotoTop: key.newBinding({ keys: ["home", "g"] }),
+  gotoBottom: key.newBinding({ keys: ["end", "G"] }),
+  shortHelp() {
+    return [this.up, this.down, this.select, this.back];
+  },
+  fullHelp() {
+    return [
+      [this.up, this.down, this.pageUp, this.pageDown],
+      [this.select, this.open, this.back, this.toggleHidden],
+      [this.gotoTop, this.gotoBottom]
+    ];
+  }
+};
+
+// src/messages.ts
+var DirReadMsg = class {
+  constructor(path, files, error) {
+    this.path = path;
+    this.files = files;
+    this.error = error;
+  }
+  _tag = "filepicker-dir-read";
+};
+var FileSelectedMsg = class {
+  constructor(file) {
+    this.file = file;
+  }
+  _tag = "filepicker-file-selected";
+};
+function defaultStyles() {
+  return {
+    directory: new chapstick.Style().bold(true),
+    file: new chapstick.Style(),
+    hidden: new chapstick.Style().italic(true),
+    selected: new chapstick.Style().background("#303030").foreground("#ffffff"),
+    cursor: new chapstick.Style().bold(true),
+    status: new chapstick.Style().italic(true)
+  };
+}
+function filterByType(files, allowed) {
+  if (!allowed || allowed.length === 0) return files;
+  return files.filter((f) => {
+    if (f.isDir) return true;
+    return allowed.some((ext) => f.name.endsWith(ext));
+  });
+}
+var FilepickerModel = class _FilepickerModel {
+  currentDir;
+  files;
+  cursor;
+  selectedFile;
+  showHidden;
+  showPermissions;
+  showSize;
+  dirFirst;
+  height;
+  allowedTypes;
+  styles;
+  keyMap;
+  filesystem;
+  path;
+  constructor(state) {
+    this.currentDir = state.currentDir;
+    this.files = state.files;
+    this.cursor = state.cursor;
+    this.selectedFile = state.selectedFile;
+    this.showHidden = state.showHidden;
+    this.showPermissions = state.showPermissions;
+    this.showSize = state.showSize;
+    this.dirFirst = state.dirFirst;
+    this.height = state.height;
+    this.allowedTypes = state.allowedTypes;
+    this.styles = state.styles;
+    this.keyMap = state.keyMap;
+    this.filesystem = state.filesystem;
+    this.path = state.path;
+  }
+  /** Create a new model and command to read the directory. */
+  static new(options) {
+    const styles = { ...defaultStyles(), ...options.styles ?? {} };
+    const model = new _FilepickerModel({
+      currentDir: options.currentDir ?? options.filesystem.cwd(),
+      files: [],
+      cursor: 0,
+      selectedFile: null,
+      showHidden: options.showHidden ?? false,
+      showPermissions: options.showPermissions ?? false,
+      showSize: options.showSize ?? false,
+      dirFirst: options.dirFirst ?? true,
+      height: options.height ?? 0,
+      allowedTypes: options.allowedTypes ?? [],
+      styles,
+      keyMap: options.keyMap ?? defaultKeyMap,
+      filesystem: options.filesystem,
+      path: options.path
+    });
+    return model.refresh();
+  }
+  /** Current selected file (if any). */
+  selected() {
+    return this.files[this.cursor];
+  }
+  /** Go to the parent directory. */
+  back() {
+    const parent = this.path.dirname(this.currentDir);
+    const model = this.with({ currentDir: parent, cursor: 0 });
+    return model.refresh();
+  }
+  /** Enter the highlighted directory, or select a file. */
+  enter() {
+    const file = this.selected();
+    if (!file) return [this, null];
+    if (file.isDir) {
+      const model = this.with({
+        currentDir: file.path,
+        cursor: 0,
+        selectedFile: null
+      });
+      return model.refresh();
+    }
+    return this.select();
+  }
+  /** Refresh the current directory listing. */
+  refresh() {
+    const cmd = async () => {
+      try {
+        const files = await readDirectory(
+          this.filesystem,
+          this.path,
+          this.currentDir,
+          this.showHidden,
+          this.dirFirst
+        );
+        const filtered = filterByType(files, this.allowedTypes);
+        return new DirReadMsg(this.currentDir, filtered);
+      } catch (error) {
+        return new DirReadMsg(this.currentDir, [], error);
+      }
+    };
+    return [this, cmd];
+  }
+  /** Select the current file. */
+  select() {
+    const file = this.selected();
+    if (!file) return [this, null];
+    const model = this.with({ selectedFile: file });
+    return [model, tea.msg(new FileSelectedMsg(file))];
+  }
+  /** Move cursor up. */
+  cursorUp() {
+    if (this.files.length === 0) return this;
+    const next = Math.max(0, this.cursor - 1);
+    return this.with({ cursor: next });
+  }
+  /** Move cursor down. */
+  cursorDown() {
+    if (this.files.length === 0) return this;
+    const next = Math.min(this.files.length - 1, this.cursor + 1);
+    return this.with({ cursor: next });
+  }
+  /** Jump to first entry. */
+  gotoTop() {
+    if (this.files.length === 0) return this;
+    return this.with({ cursor: 0 });
+  }
+  /** Jump to last entry. */
+  gotoBottom() {
+    if (this.files.length === 0) return this;
+    return this.with({ cursor: this.files.length - 1 });
+  }
+  /** Toggle hidden file visibility. */
+  toggleHidden() {
+    const model = this.with({ showHidden: !this.showHidden, cursor: 0 });
+    return model.refresh();
+  }
+  /** Tea init hook; triggers directory read. */
+  init() {
+    const [, cmd] = this.refresh();
+    return cmd;
+  }
+  /** Tea update handler. */
+  update(msgObj) {
+    if (msgObj instanceof DirReadMsg) {
+      if (msgObj.error) {
+        return [
+          this.with({
+            files: [],
+            cursor: 0,
+            selectedFile: null
+          }),
+          null
+        ];
+      }
+      const files = msgObj.files;
+      const cursor = Math.min(this.cursor, Math.max(0, files.length - 1));
+      return [
+        this.with({
+          currentDir: msgObj.path,
+          files,
+          cursor,
+          selectedFile: files[cursor] ?? null
+        }),
+        null
+      ];
+    }
+    if (msgObj instanceof tea.KeyMsg) {
+      if (key.matches(msgObj, this.keyMap.up)) return [this.cursorUp(), null];
+      if (key.matches(msgObj, this.keyMap.down)) return [this.cursorDown(), null];
+      if (key.matches(msgObj, this.keyMap.gotoTop)) return [this.gotoTop(), null];
+      if (key.matches(msgObj, this.keyMap.gotoBottom))
+        return [this.gotoBottom(), null];
+      if (key.matches(msgObj, this.keyMap.toggleHidden)) return this.toggleHidden();
+      if (key.matches(msgObj, this.keyMap.back)) return this.back();
+      if (key.matches(msgObj, this.keyMap.open)) return this.enter();
+      if (key.matches(msgObj, this.keyMap.select)) return this.select();
+    }
+    return [this, null];
+  }
+  /** Render the file list. */
+  view() {
+    const lines = [];
+    const header = this.styles.status.render(this.currentDir);
+    lines.push(header);
+    if (this.files.length === 0) {
+      lines.push(this.styles.status.render("(empty)"));
+      return lines.join("\n");
+    }
+    for (const [index, file] of this.files.entries()) {
+      const isSelected = index === this.cursor;
+      const style = file.isDir ? this.styles.directory : this.styles.file;
+      const base = file.isHidden ? this.styles.hidden : style;
+      const name = base.render(file.name);
+      const cursor = isSelected ? this.styles.cursor.render("\u27A4 ") : "  ";
+      const line = isSelected ? this.styles.selected.render(cursor + name) : cursor + name;
+      lines.push(line);
+    }
+    return lines.join("\n");
+  }
+  with(patch) {
+    return new _FilepickerModel({
+      currentDir: this.currentDir,
+      files: this.files,
+      cursor: this.cursor,
+      selectedFile: this.selectedFile,
+      showHidden: this.showHidden,
+      showPermissions: this.showPermissions,
+      showSize: this.showSize,
+      dirFirst: this.dirFirst,
+      height: this.height,
+      allowedTypes: this.allowedTypes,
+      styles: this.styles,
+      keyMap: this.keyMap,
+      filesystem: this.filesystem,
+      path: this.path,
+      ...patch
+    });
+  }
+};
+
+exports.DirReadMsg = DirReadMsg;
+exports.FileSelectedMsg = FileSelectedMsg;
+exports.FilepickerModel = FilepickerModel;
+exports.defaultKeyMap = defaultKeyMap;
+exports.isHiddenUnix = isHiddenUnix;
+exports.readDirectory = readDirectory;
+exports.sortFiles = sortFiles;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fs.ts","../src/keymap.ts","../src/messages.ts","../src/model.ts"],"names":["newBinding","Style","msg","KeyMsg","matches"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { FileSystemAdapter, PathAdapter } from '@boba-cli/machine'\nimport type { FileInfo } from './types.js'\n\n/**\n * Read a directory and return file info entries.\n * @public\n */\nexport async function readDirectory(\n  filesystem: FileSystemAdapter,\n  pathAdapter: PathAdapter,\n  path: string,\n  showHidden: boolean,\n  dirFirst = true,\n): Promise<FileInfo[]> {\n  const result = await filesystem.readdir(path, { withFileTypes: true })\n\n  // Type guard to ensure we got DirectoryEntry[]\n  if (typeof result[0] === 'string') {\n    throw new Error('Expected DirectoryEntry array but got string array')\n  }\n\n  const entries = result as Array<{\n    readonly name: string\n    isDirectory(): boolean\n    isFile(): boolean\n    isSymbolicLink(): boolean\n  }>\n\n  const files: FileInfo[] = []\n\n  for (const entry of entries) {\n    const isHidden = isHiddenUnix(entry.name)\n    if (!showHidden && isHidden) continue\n\n    const fullPath = pathAdapter.join(path, entry.name)\n    const stats = await filesystem.stat(fullPath)\n\n    files.push({\n      name: entry.name,\n      path: fullPath,\n      isDir: entry.isDirectory(),\n      isHidden,\n      size: stats.size,\n      mode: stats.mode,\n    })\n  }\n\n  return files.sort((a, b) => sortFiles(a, b, dirFirst))\n}\n\n/**\n * Sort directories first then alphabetical.\n * @public\n */\nexport function sortFiles(a: FileInfo, b: FileInfo, dirFirst = true): number {\n  if (dirFirst) {\n    if (a.isDir && !b.isDir) return -1\n    if (!a.isDir && b.isDir) return 1\n  }\n  return a.name.localeCompare(b.name)\n}\n\n/**\n * Hidden file detection (Unix-style).\n * @public\n */\nexport function isHiddenUnix(name: string): boolean {\n  return name.startsWith('.')\n}\n","import { newBinding } from '@boba-cli/key'\nimport type { FilepickerKeyMap } from './types.js'\n\n/** Default filepicker keymap. @public */\nexport const defaultKeyMap: FilepickerKeyMap = {\n  up: newBinding({ keys: ['up', 'k'] }),\n  down: newBinding({ keys: ['down', 'j'] }),\n  select: newBinding({ keys: ['enter'] }),\n  back: newBinding({ keys: ['backspace', 'h', 'left'] }),\n  open: newBinding({ keys: ['right', 'l'] }),\n  toggleHidden: newBinding({ keys: ['.'] }),\n  pageUp: newBinding({ keys: ['pgup', 'u'] }),\n  pageDown: newBinding({ keys: ['pgdown', 'd'] }),\n  gotoTop: newBinding({ keys: ['home', 'g'] }),\n  gotoBottom: newBinding({ keys: ['end', 'G'] }),\n  shortHelp() {\n    return [this.up, this.down, this.select, this.back]\n  },\n  fullHelp() {\n    return [\n      [this.up, this.down, this.pageUp, this.pageDown],\n      [this.select, this.open, this.back, this.toggleHidden],\n      [this.gotoTop, this.gotoBottom],\n    ]\n  },\n}\n","import type { FileInfo } from './types.js'\n\n/** Directory listing finished (success or failure). @public */\nexport class DirReadMsg {\n  readonly _tag = 'filepicker-dir-read'\n\n  constructor(\n    public readonly path: string,\n    public readonly files: FileInfo[],\n    public readonly error?: Error,\n  ) {}\n}\n\n/** A file or directory was selected. @public */\nexport class FileSelectedMsg {\n  readonly _tag = 'filepicker-file-selected'\n\n  constructor(public readonly file: FileInfo) {}\n}\n","import { Style } from '@boba-cli/chapstick'\nimport { matches } from '@boba-cli/key'\nimport { msg, type Cmd, type Msg, KeyMsg } from '@boba-cli/tea'\nimport type { FileSystemAdapter, PathAdapter } from '@boba-cli/machine'\nimport { readDirectory } from './fs.js'\nimport { defaultKeyMap } from './keymap.js'\nimport { DirReadMsg, FileSelectedMsg } from './messages.js'\nimport type {\n  FileInfo,\n  FilepickerKeyMap,\n  FilepickerOptions,\n  FilepickerStyles,\n} from './types.js'\n\ntype FilepickerState = {\n  currentDir: string\n  files: FileInfo[]\n  cursor: number\n  selectedFile: FileInfo | null\n  showHidden: boolean\n  showPermissions: boolean\n  showSize: boolean\n  dirFirst: boolean\n  height: number\n  allowedTypes: string[]\n  styles: FilepickerStyles\n  keyMap: FilepickerKeyMap\n  filesystem: FileSystemAdapter\n  path: PathAdapter\n}\n\nfunction defaultStyles(): FilepickerStyles {\n  return {\n    directory: new Style().bold(true),\n    file: new Style(),\n    hidden: new Style().italic(true),\n    selected: new Style().background('#303030').foreground('#ffffff'),\n    cursor: new Style().bold(true),\n    status: new Style().italic(true),\n  }\n}\n\nfunction filterByType(files: FileInfo[], allowed: string[]): FileInfo[] {\n  if (!allowed || allowed.length === 0) return files\n  return files.filter((f) => {\n    if (f.isDir) return true\n    return allowed.some((ext) => f.name.endsWith(ext))\n  })\n}\n\n/**\n * File system picker with navigation and selection.\n * @public\n */\nexport class FilepickerModel {\n  readonly currentDir: string\n  readonly files: FileInfo[]\n  readonly cursor: number\n  readonly selectedFile: FileInfo | null\n  readonly showHidden: boolean\n  readonly showPermissions: boolean\n  readonly showSize: boolean\n  readonly dirFirst: boolean\n  readonly height: number\n  readonly allowedTypes: string[]\n  readonly styles: FilepickerStyles\n  readonly keyMap: FilepickerKeyMap\n  readonly filesystem: FileSystemAdapter\n  readonly path: PathAdapter\n\n  private constructor(state: FilepickerState) {\n    this.currentDir = state.currentDir\n    this.files = state.files\n    this.cursor = state.cursor\n    this.selectedFile = state.selectedFile\n    this.showHidden = state.showHidden\n    this.showPermissions = state.showPermissions\n    this.showSize = state.showSize\n    this.dirFirst = state.dirFirst\n    this.height = state.height\n    this.allowedTypes = state.allowedTypes\n    this.styles = state.styles\n    this.keyMap = state.keyMap\n    this.filesystem = state.filesystem\n    this.path = state.path\n  }\n\n  /** Create a new model and command to read the directory. */\n  static new(options: FilepickerOptions): [FilepickerModel, Cmd<Msg>] {\n    const styles = { ...defaultStyles(), ...(options.styles ?? {}) }\n    const model = new FilepickerModel({\n      currentDir: options.currentDir ?? options.filesystem.cwd(),\n      files: [],\n      cursor: 0,\n      selectedFile: null,\n      showHidden: options.showHidden ?? false,\n      showPermissions: options.showPermissions ?? false,\n      showSize: options.showSize ?? false,\n      dirFirst: options.dirFirst ?? true,\n      height: options.height ?? 0,\n      allowedTypes: options.allowedTypes ?? [],\n      styles,\n      keyMap: options.keyMap ?? defaultKeyMap,\n      filesystem: options.filesystem,\n      path: options.path,\n    })\n    return model.refresh()\n  }\n\n  /** Current selected file (if any). */\n  selected(): FileInfo | undefined {\n    return this.files[this.cursor]\n  }\n\n  /** Go to the parent directory. */\n  back(): [FilepickerModel, Cmd<Msg>] {\n    const parent = this.path.dirname(this.currentDir)\n    const model = this.with({ currentDir: parent, cursor: 0 })\n    return model.refresh()\n  }\n\n  /** Enter the highlighted directory, or select a file. */\n  enter(): [FilepickerModel, Cmd<Msg>] {\n    const file = this.selected()\n    if (!file) return [this, null]\n    if (file.isDir) {\n      const model = this.with({\n        currentDir: file.path,\n        cursor: 0,\n        selectedFile: null,\n      })\n      return model.refresh()\n    }\n    return this.select()\n  }\n\n  /** Refresh the current directory listing. */\n  refresh(): [FilepickerModel, Cmd<Msg>] {\n    const cmd: Cmd<Msg> = async () => {\n      try {\n        const files = await readDirectory(\n          this.filesystem,\n          this.path,\n          this.currentDir,\n          this.showHidden,\n          this.dirFirst,\n        )\n        const filtered = filterByType(files, this.allowedTypes)\n        return new DirReadMsg(this.currentDir, filtered)\n      } catch (error) {\n        return new DirReadMsg(this.currentDir, [], error as Error)\n      }\n    }\n    return [this, cmd]\n  }\n\n  /** Select the current file. */\n  select(): [FilepickerModel, Cmd<Msg>] {\n    const file = this.selected()\n    if (!file) return [this, null]\n    const model = this.with({ selectedFile: file })\n    return [model, msg(new FileSelectedMsg(file))]\n  }\n\n  /** Move cursor up. */\n  cursorUp(): FilepickerModel {\n    if (this.files.length === 0) return this\n    const next = Math.max(0, this.cursor - 1)\n    return this.with({ cursor: next })\n  }\n\n  /** Move cursor down. */\n  cursorDown(): FilepickerModel {\n    if (this.files.length === 0) return this\n    const next = Math.min(this.files.length - 1, this.cursor + 1)\n    return this.with({ cursor: next })\n  }\n\n  /** Jump to first entry. */\n  gotoTop(): FilepickerModel {\n    if (this.files.length === 0) return this\n    return this.with({ cursor: 0 })\n  }\n\n  /** Jump to last entry. */\n  gotoBottom(): FilepickerModel {\n    if (this.files.length === 0) return this\n    return this.with({ cursor: this.files.length - 1 })\n  }\n\n  /** Toggle hidden file visibility. */\n  toggleHidden(): [FilepickerModel, Cmd<Msg>] {\n    const model = this.with({ showHidden: !this.showHidden, cursor: 0 })\n    return model.refresh()\n  }\n\n  /** Tea init hook; triggers directory read. */\n  init(): Cmd<Msg> {\n    const [, cmd] = this.refresh()\n    return cmd\n  }\n\n  /** Tea update handler. */\n  update(msgObj: Msg): [FilepickerModel, Cmd<Msg>] {\n    if (msgObj instanceof DirReadMsg) {\n      if (msgObj.error) {\n        // Keep state but surface the error via status text\n        return [\n          this.with({\n            files: [],\n            cursor: 0,\n            selectedFile: null,\n          }),\n          null,\n        ]\n      }\n      const files = msgObj.files\n      const cursor = Math.min(this.cursor, Math.max(0, files.length - 1))\n      return [\n        this.with({\n          currentDir: msgObj.path,\n          files,\n          cursor,\n          selectedFile: files[cursor] ?? null,\n        }),\n        null,\n      ]\n    }\n\n    if (msgObj instanceof KeyMsg) {\n      if (matches(msgObj, this.keyMap.up)) return [this.cursorUp(), null]\n      if (matches(msgObj, this.keyMap.down)) return [this.cursorDown(), null]\n      if (matches(msgObj, this.keyMap.gotoTop)) return [this.gotoTop(), null]\n      if (matches(msgObj, this.keyMap.gotoBottom))\n        return [this.gotoBottom(), null]\n      if (matches(msgObj, this.keyMap.toggleHidden)) return this.toggleHidden()\n      if (matches(msgObj, this.keyMap.back)) return this.back()\n      if (matches(msgObj, this.keyMap.open)) return this.enter()\n      if (matches(msgObj, this.keyMap.select)) return this.select()\n    }\n\n    return [this, null]\n  }\n\n  /** Render the file list. */\n  view(): string {\n    const lines: string[] = []\n    const header = this.styles.status.render(this.currentDir)\n    lines.push(header)\n\n    if (this.files.length === 0) {\n      lines.push(this.styles.status.render('(empty)'))\n      return lines.join('\\n')\n    }\n\n    for (const [index, file] of this.files.entries()) {\n      const isSelected = index === this.cursor\n      const style = file.isDir ? this.styles.directory : this.styles.file\n      const base = file.isHidden ? this.styles.hidden : style\n      const name = base.render(file.name)\n      const cursor = isSelected ? this.styles.cursor.render('➤ ') : '  '\n      const line = isSelected\n        ? this.styles.selected.render(cursor + name)\n        : cursor + name\n      lines.push(line)\n    }\n\n    return lines.join('\\n')\n  }\n\n  private with(patch: Partial<FilepickerState>): FilepickerModel {\n    return new FilepickerModel({\n      currentDir: this.currentDir,\n      files: this.files,\n      cursor: this.cursor,\n      selectedFile: this.selectedFile,\n      showHidden: this.showHidden,\n      showPermissions: this.showPermissions,\n      showSize: this.showSize,\n      dirFirst: this.dirFirst,\n      height: this.height,\n      allowedTypes: this.allowedTypes,\n      styles: this.styles,\n      keyMap: this.keyMap,\n      filesystem: this.filesystem,\n      path: this.path,\n      ...patch,\n    })\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,142 @@
+import { FileSystemAdapter, PathAdapter } from '@boba-cli/machine';
+import { Style } from '@boba-cli/chapstick';
+import { KeyMap } from '@boba-cli/help';
+import { Binding } from '@boba-cli/key';
+import { Cmd, Msg } from '@boba-cli/tea';
+
+/** Metadata for a file system entry. @public */
+interface FileInfo {
+    name: string;
+    path: string;
+    isDir: boolean;
+    isHidden: boolean;
+    size: number;
+    mode: number;
+}
+/** Keyboard bindings for the filepicker. @public */
+interface FilepickerKeyMap extends KeyMap {
+    up: Binding;
+    down: Binding;
+    select: Binding;
+    back: Binding;
+    open: Binding;
+    toggleHidden: Binding;
+    pageUp: Binding;
+    pageDown: Binding;
+    gotoTop: Binding;
+    gotoBottom: Binding;
+    shortHelp(): Binding[];
+    fullHelp(): Binding[][];
+}
+/** Style hooks for rendering the file list. @public */
+interface FilepickerStyles {
+    directory: Style;
+    file: Style;
+    hidden: Style;
+    selected: Style;
+    cursor: Style;
+    status: Style;
+}
+/** Options for constructing a {@link FilepickerModel}. @public */
+interface FilepickerOptions {
+    /** FileSystem adapter for file operations */
+    filesystem: FileSystemAdapter;
+    /** Path adapter for path operations */
+    path: PathAdapter;
+    currentDir?: string;
+    allowedTypes?: string[];
+    showHidden?: boolean;
+    showPermissions?: boolean;
+    showSize?: boolean;
+    dirFirst?: boolean;
+    height?: number;
+    styles?: Partial<FilepickerStyles>;
+    keyMap?: FilepickerKeyMap;
+}
+
+/**
+ * Read a directory and return file info entries.
+ * @public
+ */
+declare function readDirectory(filesystem: FileSystemAdapter, pathAdapter: PathAdapter, path: string, showHidden: boolean, dirFirst?: boolean): Promise<FileInfo[]>;
+/**
+ * Sort directories first then alphabetical.
+ * @public
+ */
+declare function sortFiles(a: FileInfo, b: FileInfo, dirFirst?: boolean): number;
+/**
+ * Hidden file detection (Unix-style).
+ * @public
+ */
+declare function isHiddenUnix(name: string): boolean;
+
+/** Default filepicker keymap. @public */
+declare const defaultKeyMap: FilepickerKeyMap;
+
+/** Directory listing finished (success or failure). @public */
+declare class DirReadMsg {
+    readonly path: string;
+    readonly files: FileInfo[];
+    readonly error?: Error | undefined;
+    readonly _tag = "filepicker-dir-read";
+    constructor(path: string, files: FileInfo[], error?: Error | undefined);
+}
+/** A file or directory was selected. @public */
+declare class FileSelectedMsg {
+    readonly file: FileInfo;
+    readonly _tag = "filepicker-file-selected";
+    constructor(file: FileInfo);
+}
+
+/**
+ * File system picker with navigation and selection.
+ * @public
+ */
+declare class FilepickerModel {
+    readonly currentDir: string;
+    readonly files: FileInfo[];
+    readonly cursor: number;
+    readonly selectedFile: FileInfo | null;
+    readonly showHidden: boolean;
+    readonly showPermissions: boolean;
+    readonly showSize: boolean;
+    readonly dirFirst: boolean;
+    readonly height: number;
+    readonly allowedTypes: string[];
+    readonly styles: FilepickerStyles;
+    readonly keyMap: FilepickerKeyMap;
+    readonly filesystem: FileSystemAdapter;
+    readonly path: PathAdapter;
+    private constructor();
+    /** Create a new model and command to read the directory. */
+    static new(options: FilepickerOptions): [FilepickerModel, Cmd<Msg>];
+    /** Current selected file (if any). */
+    selected(): FileInfo | undefined;
+    /** Go to the parent directory. */
+    back(): [FilepickerModel, Cmd<Msg>];
+    /** Enter the highlighted directory, or select a file. */
+    enter(): [FilepickerModel, Cmd<Msg>];
+    /** Refresh the current directory listing. */
+    refresh(): [FilepickerModel, Cmd<Msg>];
+    /** Select the current file. */
+    select(): [FilepickerModel, Cmd<Msg>];
+    /** Move cursor up. */
+    cursorUp(): FilepickerModel;
+    /** Move cursor down. */
+    cursorDown(): FilepickerModel;
+    /** Jump to first entry. */
+    gotoTop(): FilepickerModel;
+    /** Jump to last entry. */
+    gotoBottom(): FilepickerModel;
+    /** Toggle hidden file visibility. */
+    toggleHidden(): [FilepickerModel, Cmd<Msg>];
+    /** Tea init hook; triggers directory read. */
+    init(): Cmd<Msg>;
+    /** Tea update handler. */
+    update(msgObj: Msg): [FilepickerModel, Cmd<Msg>];
+    /** Render the file list. */
+    view(): string;
+    private with;
+}
+
+export { DirReadMsg, type FileInfo, FileSelectedMsg, type FilepickerKeyMap, FilepickerModel, type FilepickerOptions, type FilepickerStyles, defaultKeyMap, isHiddenUnix, readDirectory, sortFiles };

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import { FileSystemAdapter, PathAdapter } from '@boba-cli/machine';
+import { Style } from '@boba-cli/chapstick';
+import { KeyMap } from '@boba-cli/help';
+import { Binding } from '@boba-cli/key';
+import { Cmd, Msg } from '@boba-cli/tea';
+
+/** Metadata for a file system entry. @public */
+interface FileInfo {
+    name: string;
+    path: string;
+    isDir: boolean;
+    isHidden: boolean;
+    size: number;
+    mode: number;
+}
+/** Keyboard bindings for the filepicker. @public */
+interface FilepickerKeyMap extends KeyMap {
+    up: Binding;
+    down: Binding;
+    select: Binding;
+    back: Binding;
+    open: Binding;
+    toggleHidden: Binding;
+    pageUp: Binding;
+    pageDown: Binding;
+    gotoTop: Binding;
+    gotoBottom: Binding;
+    shortHelp(): Binding[];
+    fullHelp(): Binding[][];
+}
+/** Style hooks for rendering the file list. @public */
+interface FilepickerStyles {
+    directory: Style;
+    file: Style;
+    hidden: Style;
+    selected: Style;
+    cursor: Style;
+    status: Style;
+}
+/** Options for constructing a {@link FilepickerModel}. @public */
+interface FilepickerOptions {
+    /** FileSystem adapter for file operations */
+    filesystem: FileSystemAdapter;
+    /** Path adapter for path operations */
+    path: PathAdapter;
+    currentDir?: string;
+    allowedTypes?: string[];
+    showHidden?: boolean;
+    showPermissions?: boolean;
+    showSize?: boolean;
+    dirFirst?: boolean;
+    height?: number;
+    styles?: Partial<FilepickerStyles>;
+    keyMap?: FilepickerKeyMap;
+}
+
+/**
+ * Read a directory and return file info entries.
+ * @public
+ */
+declare function readDirectory(filesystem: FileSystemAdapter, pathAdapter: PathAdapter, path: string, showHidden: boolean, dirFirst?: boolean): Promise<FileInfo[]>;
+/**
+ * Sort directories first then alphabetical.
+ * @public
+ */
+declare function sortFiles(a: FileInfo, b: FileInfo, dirFirst?: boolean): number;
+/**
+ * Hidden file detection (Unix-style).
+ * @public
+ */
+declare function isHiddenUnix(name: string): boolean;
+
+/** Default filepicker keymap. @public */
+declare const defaultKeyMap: FilepickerKeyMap;
+
+/** Directory listing finished (success or failure). @public */
+declare class DirReadMsg {
+    readonly path: string;
+    readonly files: FileInfo[];
+    readonly error?: Error | undefined;
+    readonly _tag = "filepicker-dir-read";
+    constructor(path: string, files: FileInfo[], error?: Error | undefined);
+}
+/** A file or directory was selected. @public */
+declare class FileSelectedMsg {
+    readonly file: FileInfo;
+    readonly _tag = "filepicker-file-selected";
+    constructor(file: FileInfo);
+}
+
+/**
+ * File system picker with navigation and selection.
+ * @public
+ */
+declare class FilepickerModel {
+    readonly currentDir: string;
+    readonly files: FileInfo[];
+    readonly cursor: number;
+    readonly selectedFile: FileInfo | null;
+    readonly showHidden: boolean;
+    readonly showPermissions: boolean;
+    readonly showSize: boolean;
+    readonly dirFirst: boolean;
+    readonly height: number;
+    readonly allowedTypes: string[];
+    readonly styles: FilepickerStyles;
+    readonly keyMap: FilepickerKeyMap;
+    readonly filesystem: FileSystemAdapter;
+    readonly path: PathAdapter;
+    private constructor();
+    /** Create a new model and command to read the directory. */
+    static new(options: FilepickerOptions): [FilepickerModel, Cmd<Msg>];
+    /** Current selected file (if any). */
+    selected(): FileInfo | undefined;
+    /** Go to the parent directory. */
+    back(): [FilepickerModel, Cmd<Msg>];
+    /** Enter the highlighted directory, or select a file. */
+    enter(): [FilepickerModel, Cmd<Msg>];
+    /** Refresh the current directory listing. */
+    refresh(): [FilepickerModel, Cmd<Msg>];
+    /** Select the current file. */
+    select(): [FilepickerModel, Cmd<Msg>];
+    /** Move cursor up. */
+    cursorUp(): FilepickerModel;
+    /** Move cursor down. */
+    cursorDown(): FilepickerModel;
+    /** Jump to first entry. */
+    gotoTop(): FilepickerModel;
+    /** Jump to last entry. */
+    gotoBottom(): FilepickerModel;
+    /** Toggle hidden file visibility. */
+    toggleHidden(): [FilepickerModel, Cmd<Msg>];
+    /** Tea init hook; triggers directory read. */
+    init(): Cmd<Msg>;
+    /** Tea update handler. */
+    update(msgObj: Msg): [FilepickerModel, Cmd<Msg>];
+    /** Render the file list. */
+    view(): string;
+    private with;
+}
+
+export { DirReadMsg, type FileInfo, FileSelectedMsg, type FilepickerKeyMap, FilepickerModel, type FilepickerOptions, type FilepickerStyles, defaultKeyMap, isHiddenUnix, readDirectory, sortFiles };

package/dist/index.js

@@ -0,0 +1,309 @@
+import { newBinding, matches } from '@boba-cli/key';
+import { Style } from '@boba-cli/chapstick';
+import { msg, KeyMsg } from '@boba-cli/tea';
+
+// src/fs.ts
+async function readDirectory(filesystem, pathAdapter, path, showHidden, dirFirst = true) {
+  const result = await filesystem.readdir(path, { withFileTypes: true });
+  if (typeof result[0] === "string") {
+    throw new Error("Expected DirectoryEntry array but got string array");
+  }
+  const entries = result;
+  const files = [];
+  for (const entry of entries) {
+    const isHidden = isHiddenUnix(entry.name);
+    if (!showHidden && isHidden) continue;
+    const fullPath = pathAdapter.join(path, entry.name);
+    const stats = await filesystem.stat(fullPath);
+    files.push({
+      name: entry.name,
+      path: fullPath,
+      isDir: entry.isDirectory(),
+      isHidden,
+      size: stats.size,
+      mode: stats.mode
+    });
+  }
+  return files.sort((a, b) => sortFiles(a, b, dirFirst));
+}
+function sortFiles(a, b, dirFirst = true) {
+  if (dirFirst) {
+    if (a.isDir && !b.isDir) return -1;
+    if (!a.isDir && b.isDir) return 1;
+  }
+  return a.name.localeCompare(b.name);
+}
+function isHiddenUnix(name) {
+  return name.startsWith(".");
+}
+var defaultKeyMap = {
+  up: newBinding({ keys: ["up", "k"] }),
+  down: newBinding({ keys: ["down", "j"] }),
+  select: newBinding({ keys: ["enter"] }),
+  back: newBinding({ keys: ["backspace", "h", "left"] }),
+  open: newBinding({ keys: ["right", "l"] }),
+  toggleHidden: newBinding({ keys: ["."] }),
+  pageUp: newBinding({ keys: ["pgup", "u"] }),
+  pageDown: newBinding({ keys: ["pgdown", "d"] }),
+  gotoTop: newBinding({ keys: ["home", "g"] }),
+  gotoBottom: newBinding({ keys: ["end", "G"] }),
+  shortHelp() {
+    return [this.up, this.down, this.select, this.back];
+  },
+  fullHelp() {
+    return [
+      [this.up, this.down, this.pageUp, this.pageDown],
+      [this.select, this.open, this.back, this.toggleHidden],
+      [this.gotoTop, this.gotoBottom]
+    ];
+  }
+};
+
+// src/messages.ts
+var DirReadMsg = class {
+  constructor(path, files, error) {
+    this.path = path;
+    this.files = files;
+    this.error = error;
+  }
+  _tag = "filepicker-dir-read";
+};
+var FileSelectedMsg = class {
+  constructor(file) {
+    this.file = file;
+  }
+  _tag = "filepicker-file-selected";
+};
+function defaultStyles() {
+  return {
+    directory: new Style().bold(true),
+    file: new Style(),
+    hidden: new Style().italic(true),
+    selected: new Style().background("#303030").foreground("#ffffff"),
+    cursor: new Style().bold(true),
+    status: new Style().italic(true)
+  };
+}
+function filterByType(files, allowed) {
+  if (!allowed || allowed.length === 0) return files;
+  return files.filter((f) => {
+    if (f.isDir) return true;
+    return allowed.some((ext) => f.name.endsWith(ext));
+  });
+}
+var FilepickerModel = class _FilepickerModel {
+  currentDir;
+  files;
+  cursor;
+  selectedFile;
+  showHidden;
+  showPermissions;
+  showSize;
+  dirFirst;
+  height;
+  allowedTypes;
+  styles;
+  keyMap;
+  filesystem;
+  path;
+  constructor(state) {
+    this.currentDir = state.currentDir;
+    this.files = state.files;
+    this.cursor = state.cursor;
+    this.selectedFile = state.selectedFile;
+    this.showHidden = state.showHidden;
+    this.showPermissions = state.showPermissions;
+    this.showSize = state.showSize;
+    this.dirFirst = state.dirFirst;
+    this.height = state.height;
+    this.allowedTypes = state.allowedTypes;
+    this.styles = state.styles;
+    this.keyMap = state.keyMap;
+    this.filesystem = state.filesystem;
+    this.path = state.path;
+  }
+  /** Create a new model and command to read the directory. */
+  static new(options) {
+    const styles = { ...defaultStyles(), ...options.styles ?? {} };
+    const model = new _FilepickerModel({
+      currentDir: options.currentDir ?? options.filesystem.cwd(),
+      files: [],
+      cursor: 0,
+      selectedFile: null,
+      showHidden: options.showHidden ?? false,
+      showPermissions: options.showPermissions ?? false,
+      showSize: options.showSize ?? false,
+      dirFirst: options.dirFirst ?? true,
+      height: options.height ?? 0,
+      allowedTypes: options.allowedTypes ?? [],
+      styles,
+      keyMap: options.keyMap ?? defaultKeyMap,
+      filesystem: options.filesystem,
+      path: options.path
+    });
+    return model.refresh();
+  }
+  /** Current selected file (if any). */
+  selected() {
+    return this.files[this.cursor];
+  }
+  /** Go to the parent directory. */
+  back() {
+    const parent = this.path.dirname(this.currentDir);
+    const model = this.with({ currentDir: parent, cursor: 0 });
+    return model.refresh();
+  }
+  /** Enter the highlighted directory, or select a file. */
+  enter() {
+    const file = this.selected();
+    if (!file) return [this, null];
+    if (file.isDir) {
+      const model = this.with({
+        currentDir: file.path,
+        cursor: 0,
+        selectedFile: null
+      });
+      return model.refresh();
+    }
+    return this.select();
+  }
+  /** Refresh the current directory listing. */
+  refresh() {
+    const cmd = async () => {
+      try {
+        const files = await readDirectory(
+          this.filesystem,
+          this.path,
+          this.currentDir,
+          this.showHidden,
+          this.dirFirst
+        );
+        const filtered = filterByType(files, this.allowedTypes);
+        return new DirReadMsg(this.currentDir, filtered);
+      } catch (error) {
+        return new DirReadMsg(this.currentDir, [], error);
+      }
+    };
+    return [this, cmd];
+  }
+  /** Select the current file. */
+  select() {
+    const file = this.selected();
+    if (!file) return [this, null];
+    const model = this.with({ selectedFile: file });
+    return [model, msg(new FileSelectedMsg(file))];
+  }
+  /** Move cursor up. */
+  cursorUp() {
+    if (this.files.length === 0) return this;
+    const next = Math.max(0, this.cursor - 1);
+    return this.with({ cursor: next });
+  }
+  /** Move cursor down. */
+  cursorDown() {
+    if (this.files.length === 0) return this;
+    const next = Math.min(this.files.length - 1, this.cursor + 1);
+    return this.with({ cursor: next });
+  }
+  /** Jump to first entry. */
+  gotoTop() {
+    if (this.files.length === 0) return this;
+    return this.with({ cursor: 0 });
+  }
+  /** Jump to last entry. */
+  gotoBottom() {
+    if (this.files.length === 0) return this;
+    return this.with({ cursor: this.files.length - 1 });
+  }
+  /** Toggle hidden file visibility. */
+  toggleHidden() {
+    const model = this.with({ showHidden: !this.showHidden, cursor: 0 });
+    return model.refresh();
+  }
+  /** Tea init hook; triggers directory read. */
+  init() {
+    const [, cmd] = this.refresh();
+    return cmd;
+  }
+  /** Tea update handler. */
+  update(msgObj) {
+    if (msgObj instanceof DirReadMsg) {
+      if (msgObj.error) {
+        return [
+          this.with({
+            files: [],
+            cursor: 0,
+            selectedFile: null
+          }),
+          null
+        ];
+      }
+      const files = msgObj.files;
+      const cursor = Math.min(this.cursor, Math.max(0, files.length - 1));
+      return [
+        this.with({
+          currentDir: msgObj.path,
+          files,
+          cursor,
+          selectedFile: files[cursor] ?? null
+        }),
+        null
+      ];
+    }
+    if (msgObj instanceof KeyMsg) {
+      if (matches(msgObj, this.keyMap.up)) return [this.cursorUp(), null];
+      if (matches(msgObj, this.keyMap.down)) return [this.cursorDown(), null];
+      if (matches(msgObj, this.keyMap.gotoTop)) return [this.gotoTop(), null];
+      if (matches(msgObj, this.keyMap.gotoBottom))
+        return [this.gotoBottom(), null];
+      if (matches(msgObj, this.keyMap.toggleHidden)) return this.toggleHidden();
+      if (matches(msgObj, this.keyMap.back)) return this.back();
+      if (matches(msgObj, this.keyMap.open)) return this.enter();
+      if (matches(msgObj, this.keyMap.select)) return this.select();
+    }
+    return [this, null];
+  }
+  /** Render the file list. */
+  view() {
+    const lines = [];
+    const header = this.styles.status.render(this.currentDir);
+    lines.push(header);
+    if (this.files.length === 0) {
+      lines.push(this.styles.status.render("(empty)"));
+      return lines.join("\n");
+    }
+    for (const [index, file] of this.files.entries()) {
+      const isSelected = index === this.cursor;
+      const style = file.isDir ? this.styles.directory : this.styles.file;
+      const base = file.isHidden ? this.styles.hidden : style;
+      const name = base.render(file.name);
+      const cursor = isSelected ? this.styles.cursor.render("\u27A4 ") : "  ";
+      const line = isSelected ? this.styles.selected.render(cursor + name) : cursor + name;
+      lines.push(line);
+    }
+    return lines.join("\n");
+  }
+  with(patch) {
+    return new _FilepickerModel({
+      currentDir: this.currentDir,
+      files: this.files,
+      cursor: this.cursor,
+      selectedFile: this.selectedFile,
+      showHidden: this.showHidden,
+      showPermissions: this.showPermissions,
+      showSize: this.showSize,
+      dirFirst: this.dirFirst,
+      height: this.height,
+      allowedTypes: this.allowedTypes,
+      styles: this.styles,
+      keyMap: this.keyMap,
+      filesystem: this.filesystem,
+      path: this.path,
+      ...patch
+    });
+  }
+};
+
+export { DirReadMsg, FileSelectedMsg, FilepickerModel, defaultKeyMap, isHiddenUnix, readDirectory, sortFiles };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fs.ts","../src/keymap.ts","../src/messages.ts","../src/model.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { FileSystemAdapter, PathAdapter } from '@boba-cli/machine'\nimport type { FileInfo } from './types.js'\n\n/**\n * Read a directory and return file info entries.\n * @public\n */\nexport async function readDirectory(\n  filesystem: FileSystemAdapter,\n  pathAdapter: PathAdapter,\n  path: string,\n  showHidden: boolean,\n  dirFirst = true,\n): Promise<FileInfo[]> {\n  const result = await filesystem.readdir(path, { withFileTypes: true })\n\n  // Type guard to ensure we got DirectoryEntry[]\n  if (typeof result[0] === 'string') {\n    throw new Error('Expected DirectoryEntry array but got string array')\n  }\n\n  const entries = result as Array<{\n    readonly name: string\n    isDirectory(): boolean\n    isFile(): boolean\n    isSymbolicLink(): boolean\n  }>\n\n  const files: FileInfo[] = []\n\n  for (const entry of entries) {\n    const isHidden = isHiddenUnix(entry.name)\n    if (!showHidden && isHidden) continue\n\n    const fullPath = pathAdapter.join(path, entry.name)\n    const stats = await filesystem.stat(fullPath)\n\n    files.push({\n      name: entry.name,\n      path: fullPath,\n      isDir: entry.isDirectory(),\n      isHidden,\n      size: stats.size,\n      mode: stats.mode,\n    })\n  }\n\n  return files.sort((a, b) => sortFiles(a, b, dirFirst))\n}\n\n/**\n * Sort directories first then alphabetical.\n * @public\n */\nexport function sortFiles(a: FileInfo, b: FileInfo, dirFirst = true): number {\n  if (dirFirst) {\n    if (a.isDir && !b.isDir) return -1\n    if (!a.isDir && b.isDir) return 1\n  }\n  return a.name.localeCompare(b.name)\n}\n\n/**\n * Hidden file detection (Unix-style).\n * @public\n */\nexport function isHiddenUnix(name: string): boolean {\n  return name.startsWith('.')\n}\n","import { newBinding } from '@boba-cli/key'\nimport type { FilepickerKeyMap } from './types.js'\n\n/** Default filepicker keymap. @public */\nexport const defaultKeyMap: FilepickerKeyMap = {\n  up: newBinding({ keys: ['up', 'k'] }),\n  down: newBinding({ keys: ['down', 'j'] }),\n  select: newBinding({ keys: ['enter'] }),\n  back: newBinding({ keys: ['backspace', 'h', 'left'] }),\n  open: newBinding({ keys: ['right', 'l'] }),\n  toggleHidden: newBinding({ keys: ['.'] }),\n  pageUp: newBinding({ keys: ['pgup', 'u'] }),\n  pageDown: newBinding({ keys: ['pgdown', 'd'] }),\n  gotoTop: newBinding({ keys: ['home', 'g'] }),\n  gotoBottom: newBinding({ keys: ['end', 'G'] }),\n  shortHelp() {\n    return [this.up, this.down, this.select, this.back]\n  },\n  fullHelp() {\n    return [\n      [this.up, this.down, this.pageUp, this.pageDown],\n      [this.select, this.open, this.back, this.toggleHidden],\n      [this.gotoTop, this.gotoBottom],\n    ]\n  },\n}\n","import type { FileInfo } from './types.js'\n\n/** Directory listing finished (success or failure). @public */\nexport class DirReadMsg {\n  readonly _tag = 'filepicker-dir-read'\n\n  constructor(\n    public readonly path: string,\n    public readonly files: FileInfo[],\n    public readonly error?: Error,\n  ) {}\n}\n\n/** A file or directory was selected. @public */\nexport class FileSelectedMsg {\n  readonly _tag = 'filepicker-file-selected'\n\n  constructor(public readonly file: FileInfo) {}\n}\n","import { Style } from '@boba-cli/chapstick'\nimport { matches } from '@boba-cli/key'\nimport { msg, type Cmd, type Msg, KeyMsg } from '@boba-cli/tea'\nimport type { FileSystemAdapter, PathAdapter } from '@boba-cli/machine'\nimport { readDirectory } from './fs.js'\nimport { defaultKeyMap } from './keymap.js'\nimport { DirReadMsg, FileSelectedMsg } from './messages.js'\nimport type {\n  FileInfo,\n  FilepickerKeyMap,\n  FilepickerOptions,\n  FilepickerStyles,\n} from './types.js'\n\ntype FilepickerState = {\n  currentDir: string\n  files: FileInfo[]\n  cursor: number\n  selectedFile: FileInfo | null\n  showHidden: boolean\n  showPermissions: boolean\n  showSize: boolean\n  dirFirst: boolean\n  height: number\n  allowedTypes: string[]\n  styles: FilepickerStyles\n  keyMap: FilepickerKeyMap\n  filesystem: FileSystemAdapter\n  path: PathAdapter\n}\n\nfunction defaultStyles(): FilepickerStyles {\n  return {\n    directory: new Style().bold(true),\n    file: new Style(),\n    hidden: new Style().italic(true),\n    selected: new Style().background('#303030').foreground('#ffffff'),\n    cursor: new Style().bold(true),\n    status: new Style().italic(true),\n  }\n}\n\nfunction filterByType(files: FileInfo[], allowed: string[]): FileInfo[] {\n  if (!allowed || allowed.length === 0) return files\n  return files.filter((f) => {\n    if (f.isDir) return true\n    return allowed.some((ext) => f.name.endsWith(ext))\n  })\n}\n\n/**\n * File system picker with navigation and selection.\n * @public\n */\nexport class FilepickerModel {\n  readonly currentDir: string\n  readonly files: FileInfo[]\n  readonly cursor: number\n  readonly selectedFile: FileInfo | null\n  readonly showHidden: boolean\n  readonly showPermissions: boolean\n  readonly showSize: boolean\n  readonly dirFirst: boolean\n  readonly height: number\n  readonly allowedTypes: string[]\n  readonly styles: FilepickerStyles\n  readonly keyMap: FilepickerKeyMap\n  readonly filesystem: FileSystemAdapter\n  readonly path: PathAdapter\n\n  private constructor(state: FilepickerState) {\n    this.currentDir = state.currentDir\n    this.files = state.files\n    this.cursor = state.cursor\n    this.selectedFile = state.selectedFile\n    this.showHidden = state.showHidden\n    this.showPermissions = state.showPermissions\n    this.showSize = state.showSize\n    this.dirFirst = state.dirFirst\n    this.height = state.height\n    this.allowedTypes = state.allowedTypes\n    this.styles = state.styles\n    this.keyMap = state.keyMap\n    this.filesystem = state.filesystem\n    this.path = state.path\n  }\n\n  /** Create a new model and command to read the directory. */\n  static new(options: FilepickerOptions): [FilepickerModel, Cmd<Msg>] {\n    const styles = { ...defaultStyles(), ...(options.styles ?? {}) }\n    const model = new FilepickerModel({\n      currentDir: options.currentDir ?? options.filesystem.cwd(),\n      files: [],\n      cursor: 0,\n      selectedFile: null,\n      showHidden: options.showHidden ?? false,\n      showPermissions: options.showPermissions ?? false,\n      showSize: options.showSize ?? false,\n      dirFirst: options.dirFirst ?? true,\n      height: options.height ?? 0,\n      allowedTypes: options.allowedTypes ?? [],\n      styles,\n      keyMap: options.keyMap ?? defaultKeyMap,\n      filesystem: options.filesystem,\n      path: options.path,\n    })\n    return model.refresh()\n  }\n\n  /** Current selected file (if any). */\n  selected(): FileInfo | undefined {\n    return this.files[this.cursor]\n  }\n\n  /** Go to the parent directory. */\n  back(): [FilepickerModel, Cmd<Msg>] {\n    const parent = this.path.dirname(this.currentDir)\n    const model = this.with({ currentDir: parent, cursor: 0 })\n    return model.refresh()\n  }\n\n  /** Enter the highlighted directory, or select a file. */\n  enter(): [FilepickerModel, Cmd<Msg>] {\n    const file = this.selected()\n    if (!file) return [this, null]\n    if (file.isDir) {\n      const model = this.with({\n        currentDir: file.path,\n        cursor: 0,\n        selectedFile: null,\n      })\n      return model.refresh()\n    }\n    return this.select()\n  }\n\n  /** Refresh the current directory listing. */\n  refresh(): [FilepickerModel, Cmd<Msg>] {\n    const cmd: Cmd<Msg> = async () => {\n      try {\n        const files = await readDirectory(\n          this.filesystem,\n          this.path,\n          this.currentDir,\n          this.showHidden,\n          this.dirFirst,\n        )\n        const filtered = filterByType(files, this.allowedTypes)\n        return new DirReadMsg(this.currentDir, filtered)\n      } catch (error) {\n        return new DirReadMsg(this.currentDir, [], error as Error)\n      }\n    }\n    return [this, cmd]\n  }\n\n  /** Select the current file. */\n  select(): [FilepickerModel, Cmd<Msg>] {\n    const file = this.selected()\n    if (!file) return [this, null]\n    const model = this.with({ selectedFile: file })\n    return [model, msg(new FileSelectedMsg(file))]\n  }\n\n  /** Move cursor up. */\n  cursorUp(): FilepickerModel {\n    if (this.files.length === 0) return this\n    const next = Math.max(0, this.cursor - 1)\n    return this.with({ cursor: next })\n  }\n\n  /** Move cursor down. */\n  cursorDown(): FilepickerModel {\n    if (this.files.length === 0) return this\n    const next = Math.min(this.files.length - 1, this.cursor + 1)\n    return this.with({ cursor: next })\n  }\n\n  /** Jump to first entry. */\n  gotoTop(): FilepickerModel {\n    if (this.files.length === 0) return this\n    return this.with({ cursor: 0 })\n  }\n\n  /** Jump to last entry. */\n  gotoBottom(): FilepickerModel {\n    if (this.files.length === 0) return this\n    return this.with({ cursor: this.files.length - 1 })\n  }\n\n  /** Toggle hidden file visibility. */\n  toggleHidden(): [FilepickerModel, Cmd<Msg>] {\n    const model = this.with({ showHidden: !this.showHidden, cursor: 0 })\n    return model.refresh()\n  }\n\n  /** Tea init hook; triggers directory read. */\n  init(): Cmd<Msg> {\n    const [, cmd] = this.refresh()\n    return cmd\n  }\n\n  /** Tea update handler. */\n  update(msgObj: Msg): [FilepickerModel, Cmd<Msg>] {\n    if (msgObj instanceof DirReadMsg) {\n      if (msgObj.error) {\n        // Keep state but surface the error via status text\n        return [\n          this.with({\n            files: [],\n            cursor: 0,\n            selectedFile: null,\n          }),\n          null,\n        ]\n      }\n      const files = msgObj.files\n      const cursor = Math.min(this.cursor, Math.max(0, files.length - 1))\n      return [\n        this.with({\n          currentDir: msgObj.path,\n          files,\n          cursor,\n          selectedFile: files[cursor] ?? null,\n        }),\n        null,\n      ]\n    }\n\n    if (msgObj instanceof KeyMsg) {\n      if (matches(msgObj, this.keyMap.up)) return [this.cursorUp(), null]\n      if (matches(msgObj, this.keyMap.down)) return [this.cursorDown(), null]\n      if (matches(msgObj, this.keyMap.gotoTop)) return [this.gotoTop(), null]\n      if (matches(msgObj, this.keyMap.gotoBottom))\n        return [this.gotoBottom(), null]\n      if (matches(msgObj, this.keyMap.toggleHidden)) return this.toggleHidden()\n      if (matches(msgObj, this.keyMap.back)) return this.back()\n      if (matches(msgObj, this.keyMap.open)) return this.enter()\n      if (matches(msgObj, this.keyMap.select)) return this.select()\n    }\n\n    return [this, null]\n  }\n\n  /** Render the file list. */\n  view(): string {\n    const lines: string[] = []\n    const header = this.styles.status.render(this.currentDir)\n    lines.push(header)\n\n    if (this.files.length === 0) {\n      lines.push(this.styles.status.render('(empty)'))\n      return lines.join('\\n')\n    }\n\n    for (const [index, file] of this.files.entries()) {\n      const isSelected = index === this.cursor\n      const style = file.isDir ? this.styles.directory : this.styles.file\n      const base = file.isHidden ? this.styles.hidden : style\n      const name = base.render(file.name)\n      const cursor = isSelected ? this.styles.cursor.render('➤ ') : '  '\n      const line = isSelected\n        ? this.styles.selected.render(cursor + name)\n        : cursor + name\n      lines.push(line)\n    }\n\n    return lines.join('\\n')\n  }\n\n  private with(patch: Partial<FilepickerState>): FilepickerModel {\n    return new FilepickerModel({\n      currentDir: this.currentDir,\n      files: this.files,\n      cursor: this.cursor,\n      selectedFile: this.selectedFile,\n      showHidden: this.showHidden,\n      showPermissions: this.showPermissions,\n      showSize: this.showSize,\n      dirFirst: this.dirFirst,\n      height: this.height,\n      allowedTypes: this.allowedTypes,\n      styles: this.styles,\n      keyMap: this.keyMap,\n      filesystem: this.filesystem,\n      path: this.path,\n      ...patch,\n    })\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@boba-cli/filepicker",
+  "description": "File system browser component for Boba terminal UIs.",
+  "version": "0.1.0-alpha.2",
+  "dependencies": {
+    "@boba-cli/chapstick": "0.1.0-alpha.2",
+    "@boba-cli/help": "0.1.0-alpha.2",
+    "@boba-cli/key": "0.1.0-alpha.1",
+    "@boba-cli/machine": "0.1.0-alpha.1",
+    "@boba-cli/tea": "0.1.0-alpha.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.2",
+    "typescript": "5.8.2",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "check:api-report": "pnpm run generate:api-report",
+    "check:eslint": "pnpm run lint",
+    "generate:api-report": "api-extractor run --local",
+    "lint": "eslint \"{src,test}/**/*.{ts,tsx}\"",
+    "test": "vitest run"
+  }
+}