@visulima/vis 1.0.0-alpha.2 → 1.0.0-alpha.4

package/dist/tui/components/TaskStore.d.ts

@@ -0,0 +1,80 @@
+import type { Task, TaskResult } from "@visulima/task-runner";
+import type { TaskRowData } from "./TaskRow.d.ts";
+export interface TaskState {
+    /** Auto-exit countdown in seconds. null = not counting. */
+    autoExitCountdown: number | null;
+    /** Number of tasks completed from cache. */
+    cached: number;
+    /** Total completed tasks. */
+    completed: number;
+    /** All tasks finished — triggers summary/countdown. */
+    done: boolean;
+    /** Timestamp when all tasks completed (Date.now). null while running. */
+    endTime: number | null;
+    /** Number of failed tasks. */
+    failed: number;
+    /** Whether the filter input bar is active. */
+    filterActive: boolean;
+    /** Current filter text (empty = no filter). */
+    filterText: string;
+    /** Which panel currently has keyboard focus. */
+    focusedPanel: "output" | "tasks";
+    /** Whether interactive input mode is active for the current task. */
+    interactiveMode: boolean;
+    /** Accumulated terminal output per task. */
+    outputs: Map<string, string>;
+    /** Up to 2 pinned task IDs for output panes. */
+    pinnedTaskIds: [string | null, string | null];
+    /** Whether a rerun has been requested by the user. */
+    rerunRequested: boolean;
+    /** Task ID requested for single-task retry (null = none). */
+    retryTaskId: string | null;
+    /** All task rows with current status. */
+    rows: TaskRowData[];
+    /** Currently highlighted task index in the list. */
+    selectedIndex: number;
+    /** Command start timestamp (Date.now). */
+    startTime: number;
+    /** Status filter for task list: "all", "failed", "running", "passed". */
+    statusFilter: "all" | "failed" | "passed" | "running";
+    /** Number of successfully completed tasks. */
+    succeeded: number;
+    /** Current view mode: list (full width), split (list + output), fullscreen (output only). */
+    viewMode: "fullscreen" | "list" | "split";
+}
+type Listener = () => void;
+export declare class TaskStore {
+    #private;
+    constructor(tasks: Task[]);
+    getSnapshot: () => TaskState;
+    subscribe: (listener: Listener) => () => void;
+    startTasks(started: Task[]): void;
+    endTasks(results: TaskResult[]): void;
+    addOutput(taskId: string, output: string): void;
+    /** Replace the full output for a task (used by PTY mode where ANSI sequences update in place). */
+    setOutput(taskId: string, content: string): void;
+    markDone(): void;
+    /** Update elapsed times for running tasks. Called every 100ms. */
+    tick(): void;
+    setSelectedIndex(index: number): void;
+    setFocusedPanel(panel: "output" | "tasks"): void;
+    setFilter(text: string): void;
+    setFilterActive(active: boolean): void;
+    pinTask(slot: 0 | 1, taskId: string | null): void;
+    clearPins(): void;
+    /** Request retry of a single failed task. */
+    requestRetry(taskId: string): void;
+    /** Acknowledge the retry request (called by lifecycle after re-launching). */
+    acknowledgeRetry(): string | null;
+    /** Toggle interactive input mode for the current task. */
+    setInteractiveMode(active: boolean): void;
+    /** Set the current view mode. */
+    setViewMode(mode: "fullscreen" | "list" | "split"): void;
+    /** Set status filter for the task list. */
+    setStatusFilter(filter: "all" | "failed" | "passed" | "running"): void;
+    /** Request a rerun — resets all task state back to pending. */
+    requestRerun(): void;
+    /** Acknowledge the rerun request (called by lifecycle after re-launching tasks). */
+    acknowledgeRerun(): void;
+}
+export {};

package/dist/tui/components/VisTaskRunnerApp.d.ts

@@ -0,0 +1,17 @@
+import type { Task } from "@visulima/task-runner";
+import React from "react";
+import type { StdinEntry } from "../types.d.ts";
+import type { TaskStore } from "./TaskStore.d.ts";
+interface VisTaskRunnerAppProps {
+    /** 0 = no auto-exit (default), >0 = countdown seconds */
+    autoExitSeconds: number;
+    parallelSlots: number;
+    projectNames: string[];
+    /** Registry of stdin entries keyed by task ID, for interactive input. */
+    stdinRegistry: Map<string, StdinEntry>;
+    store: TaskStore;
+    targets: string[];
+    tasks: Task[];
+}
+declare const VisTaskRunnerApp: ({ autoExitSeconds, parallelSlots, projectNames, stdinRegistry, store, targets, tasks }: VisTaskRunnerAppProps) => React.JSX.Element;
+export default VisTaskRunnerApp;

package/dist/tui/components/devcontainer/DevcontainerStore.d.ts

@@ -0,0 +1,66 @@
+import type { PackageManager } from "./catalogs/mount-suggestions.d.ts";
+import type { DevcontainerConfig, MountEntry, SectionId } from "./types.d.ts";
+export interface DevcontainerState {
+    /** The configuration being edited. */
+    config: DevcontainerConfig;
+    /** Detected package manager from the workspace. */
+    detectedPm: PackageManager | null;
+    /** Search text for extensions section. */
+    extensionSearch: string;
+    /** Search text for features section. */
+    featureSearch: string;
+    /** Whether any field is being actively edited via TextInput. */
+    fieldEditing: boolean;
+    /** Which field is focused within the current section. */
+    fieldIndex: number;
+    /** Whether the original file contained JSONC comments (warning on save). */
+    hadComments: boolean;
+    /** Whether config has been changed since load/save. */
+    isDirty: boolean;
+    /** Create or edit mode. */
+    mode: "create" | "edit";
+    /** Original config for diffing (null in create mode). */
+    originalConfig: DevcontainerConfig | null;
+    /** Currently active tab/section. */
+    section: SectionId;
+    /** Whether to show the template selector dialog. */
+    showTemplateSelector: boolean;
+    /** Suggested mounts based on PM and features. */
+    suggestedMounts: MountEntry[];
+    /** Selected template index in the selector. */
+    templateIndex: number;
+}
+type Listener = () => void;
+export declare class DevcontainerStore {
+    #private;
+    constructor(config: DevcontainerConfig | null, hadComments: boolean, detectedPm?: PackageManager | null);
+    getSnapshot: () => DevcontainerState;
+    subscribe: (listener: Listener) => () => void;
+    setSection(section: SectionId): void;
+    nextSection(): void;
+    previousSection(): void;
+    setFieldIndex(index: number): void;
+    setFieldEditing(editing: boolean): void;
+    setTemplateIndex(index: number): void;
+    applyTemplate(templateId: string): void;
+    dismissTemplateSelector(): void;
+    updateConfig(partial: Partial<DevcontainerConfig>): void;
+    toggleFeature(featureId: string): void;
+    setFeatureSearch(search: string): void;
+    addPort(port: number | string): void;
+    removePort(index: number): void;
+    toggleExtension(extensionId: string): void;
+    setExtensionSearch(search: string): void;
+    addEnvVar(target: "container" | "remote", key: string, value: string): void;
+    removeEnvVar(target: "container" | "remote", key: string): void;
+    addMount(mount: MountEntry): void;
+    removeMount(index: number): void;
+    /** Add all currently suggested mounts to the config. */
+    applySuggestedMounts(): void;
+    setLifecycleCommand(hook: "onCreateCommand" | "postAttachCommand" | "postCreateCommand" | "postStartCommand", command: string): void;
+    markClean(): void;
+    getJsonPreview(): string;
+    /** Return a cleaned config with empty/undefined fields stripped. */
+    cleanConfig(): DevcontainerConfig;
+}
+export {};

package/dist/tui/components/devcontainer/VisDevcontainerApp.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type { DevcontainerStore } from "./DevcontainerStore.d.ts";
+import type { DevcontainerConfig } from "./types.d.ts";
+interface VisDevcontainerAppProps {
+    readonly onSave: (config: DevcontainerConfig) => void;
+    readonly store: DevcontainerStore;
+}
+declare const VisDevcontainerApp: ({ onSave, store }: VisDevcontainerAppProps) => React.JSX.Element;
+export default VisDevcontainerApp;

package/dist/tui/components/devcontainer/catalogs/extensions.d.ts

@@ -0,0 +1,8 @@
+export type ExtensionCategory = "debugging" | "formatting" | "git" | "language" | "linting" | "other" | "testing";
+export interface ExtensionCatalogEntry {
+    category: ExtensionCategory;
+    description: string;
+    id: string;
+    name: string;
+}
+export declare const EXTENSION_CATALOG: ExtensionCatalogEntry[];

package/dist/tui/components/devcontainer/catalogs/features.d.ts

@@ -0,0 +1,8 @@
+export type FeatureCategory = "cloud" | "database" | "language" | "other" | "tool";
+export interface FeatureCatalogEntry {
+    category: FeatureCategory;
+    description: string;
+    id: string;
+    name: string;
+}
+export declare const FEATURE_CATALOG: FeatureCatalogEntry[];

package/dist/tui/components/devcontainer/catalogs/filters.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionCatalogEntry } from "./extensions.d.ts";
+import type { FeatureCatalogEntry } from "./features.d.ts";
+export declare const filterFeatures: (searchText: string) => FeatureCatalogEntry[];
+export declare const filterExtensions: (searchText: string) => ExtensionCatalogEntry[];

package/dist/tui/components/devcontainer/catalogs/mount-suggestions.d.ts

@@ -0,0 +1,19 @@
+import type { MountEntry } from "../types.d.ts";
+export type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
+/**
+ * Suggested mounts based on detected package manager.
+ */
+export declare const PM_MOUNTS: Record<PackageManager, MountEntry[]>;
+/**
+ * Feature-specific mount suggestions.
+ * Key is a substring of the feature ID to match.
+ */
+export declare const FEATURE_MOUNTS: {
+    featureMatch: string;
+    mounts: MountEntry[];
+}[];
+/**
+ * Get suggested mounts based on the package manager and enabled features.
+ * Returns only mounts that are not already in the current config.
+ */
+export declare const getSuggestedMounts: (pm: PackageManager | null, enabledFeatures: Record<string, Record<string, unknown> | string>, currentMounts: Array<MountEntry | string>) => MountEntry[];

package/dist/tui/components/devcontainer/catalogs/templates.d.ts

@@ -0,0 +1,8 @@
+import type { DevcontainerConfig } from "../types.d.ts";
+export interface DevcontainerTemplate {
+    config: DevcontainerConfig;
+    description: string;
+    id: string;
+    name: string;
+}
+export declare const TEMPLATES: DevcontainerTemplate[];

package/dist/tui/components/devcontainer/devcontainer-io.d.ts

@@ -0,0 +1,14 @@
+import type { DevcontainerConfig } from "./types.d.ts";
+export interface ReadResult {
+    config: DevcontainerConfig;
+    hadComments: boolean;
+}
+/**
+ * Read and parse .devcontainer/devcontainer.json with JSONC support.
+ * Returns null if the file doesn't exist.
+ */
+export declare const readDevcontainerJson: (workspaceRoot: string) => ReadResult | null;
+/**
+ * Write devcontainer.json to disk, creating the directory if needed.
+ */
+export declare const writeDevcontainerJson: (workspaceRoot: string, config: DevcontainerConfig, outputPath?: string) => void;

package/dist/tui/components/devcontainer/sections/DockerComposeSection.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+interface DockerComposeSectionProps {
+    readonly config: DevcontainerConfig;
+    readonly fieldEditing: boolean;
+    readonly fieldIndex: number;
+    readonly onUpdate: (partial: Partial<DevcontainerConfig>) => void;
+}
+declare const DockerComposeSection: ({ config, fieldEditing, fieldIndex, onUpdate }: DockerComposeSectionProps) => React.JSX.Element;
+export declare const COMPOSE_FIELD_COUNT: number;
+export default DockerComposeSection;

package/dist/tui/components/devcontainer/sections/EnvironmentSection.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+interface EnvironmentSectionProps {
+    readonly config: DevcontainerConfig;
+    readonly fieldIndex: number;
+}
+/**
+ * Layout:
+ *   fieldIndex 0..containerCount-1  → containerEnv entries
+ *   fieldIndex containerCount       → "+ Add container env..." row
+ *   fieldIndex containerCount+1..   → remoteEnv entries
+ *   fieldIndex last                 → "+ Add remote env..." row
+ */
+declare const EnvironmentSection: ({ config, fieldIndex }: EnvironmentSectionProps) => React.JSX.Element;
+export declare const getEnvFieldCount: (config: DevcontainerConfig) => number;
+export default EnvironmentSection;

package/dist/tui/components/devcontainer/sections/ExtensionsSection.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+interface ExtensionsSectionProps {
+    readonly config: DevcontainerConfig;
+    readonly fieldIndex: number;
+    readonly scrollOffset: number;
+    readonly searchText: string;
+    readonly viewportHeight: number;
+}
+declare const ExtensionsSection: ({ config, fieldIndex, scrollOffset, searchText, viewportHeight }: ExtensionsSectionProps) => React.JSX.Element;
+export default ExtensionsSection;

package/dist/tui/components/devcontainer/sections/FeaturesSection.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+interface FeaturesSectionProps {
+    readonly config: DevcontainerConfig;
+    readonly fieldIndex: number;
+    readonly scrollOffset: number;
+    readonly searchText: string;
+    readonly viewportHeight: number;
+}
+declare const FeaturesSection: ({ config, fieldIndex, scrollOffset, searchText, viewportHeight }: FeaturesSectionProps) => React.JSX.Element;
+export default FeaturesSection;

package/dist/tui/components/devcontainer/sections/GeneralSection.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+interface GeneralSectionProps {
+    readonly config: DevcontainerConfig;
+    readonly fieldEditing: boolean;
+    readonly fieldIndex: number;
+    readonly onUpdate: (partial: Partial<DevcontainerConfig>) => void;
+}
+declare const GeneralSection: ({ config, fieldEditing, fieldIndex, onUpdate }: GeneralSectionProps) => React.JSX.Element;
+export declare const GENERAL_FIELD_COUNT: number;
+export declare const GENERAL_BOOLEAN_FIELDS: readonly ("privileged" | "overrideCommand")[];
+export default GeneralSection;

package/dist/tui/components/devcontainer/sections/LifecycleSection.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+declare const HOOKS: readonly ["postCreateCommand", "postStartCommand", "postAttachCommand", "onCreateCommand"];
+type LifecycleHook = (typeof HOOKS)[number];
+interface LifecycleSectionProps {
+    readonly config: DevcontainerConfig;
+    readonly fieldEditing: boolean;
+    readonly fieldIndex: number;
+    readonly onSetCommand: (hook: LifecycleHook, command: string) => void;
+}
+declare const LifecycleSection: ({ config, fieldEditing, fieldIndex, onSetCommand }: LifecycleSectionProps) => React.JSX.Element;
+export declare const LIFECYCLE_FIELD_COUNT: number;
+export default LifecycleSection;

package/dist/tui/components/devcontainer/sections/MountsSection.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+import type { PackageManager } from "../catalogs/mount-suggestions.d.ts";
+import type { DevcontainerConfig, MountEntry } from "../types.d.ts";
+interface MountsSectionProps {
+    readonly addingMount: boolean;
+    readonly config: DevcontainerConfig;
+    readonly detectedPm: PackageManager | null;
+    readonly fieldIndex: number;
+    readonly mountPhase: "source" | "target" | "type";
+    readonly mountSource: string;
+    readonly mountTarget: string;
+    readonly mountType: "bind" | "tmpfs" | "volume";
+    readonly suggestedMounts: MountEntry[];
+}
+declare const MountsSection: ({ addingMount, config, detectedPm, fieldIndex, mountPhase, mountSource, mountTarget, mountType, suggestedMounts, }: MountsSectionProps) => React.JSX.Element;
+export default MountsSection;

package/dist/tui/components/devcontainer/sections/PortsSection.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import type { DevcontainerConfig } from "../types.d.ts";
+interface PortsSectionProps {
+    readonly addingPort: boolean;
+    readonly addPortValue: string;
+    readonly config: DevcontainerConfig;
+    readonly fieldIndex: number;
+}
+declare const PortsSection: ({ addingPort, addPortValue, config, fieldIndex }: PortsSectionProps) => React.JSX.Element;
+export default PortsSection;

package/dist/tui/components/devcontainer/sections/PreviewPanel.d.ts

@@ -0,0 +1,11 @@
+import type { ScrollViewRef } from "@visulima/tui";
+import React from "react";
+interface PreviewPanelProps {
+    readonly focused: boolean;
+    readonly hadComments: boolean;
+    readonly jsonPreview: string;
+    readonly mode: "create" | "edit";
+    readonly scrollRef: React.RefObject<ScrollViewRef>;
+}
+declare const PreviewPanel: ({ focused, hadComments, jsonPreview, mode, scrollRef }: PreviewPanelProps) => React.JSX.Element;
+export default PreviewPanel;

package/dist/tui/components/devcontainer/types.d.ts

@@ -0,0 +1,53 @@
+export interface DevcontainerBuild {
+    args?: Record<string, string>;
+    context?: string;
+    dockerfile?: string;
+}
+export interface PortAttributes {
+    label?: string;
+    onAutoForward?: "ignore" | "notify" | "openBrowser" | "openPreview" | "silent";
+    protocol?: "http" | "https";
+}
+export interface MountEntry {
+    source: string;
+    target: string;
+    type: "bind" | "tmpfs" | "volume";
+}
+export interface DevcontainerConfig {
+    build?: DevcontainerBuild;
+    capAdd?: string[];
+    containerEnv?: Record<string, string>;
+    containerUser?: string;
+    customizations?: {
+        jetbrains?: {
+            plugins?: string[];
+        };
+        vscode?: {
+            extensions?: string[];
+            settings?: Record<string, unknown>;
+        };
+    };
+    dockerComposeFile?: string | string[];
+    features?: Record<string, Record<string, unknown> | string>;
+    forwardPorts?: Array<number | string>;
+    image?: string;
+    mounts?: Array<MountEntry | string>;
+    name?: string;
+    onCreateCommand?: string | string[];
+    overrideCommand?: boolean;
+    postAttachCommand?: string | string[];
+    postCreateCommand?: string | string[];
+    postStartCommand?: string | string[];
+    portsAttributes?: Record<string, PortAttributes>;
+    privileged?: boolean;
+    remoteEnv?: Record<string, string>;
+    remoteUser?: string;
+    runServices?: string[];
+    securityOpt?: string[];
+    service?: string;
+    shutdownAction?: string;
+    workspaceFolder?: string;
+    workspaceMount?: string;
+}
+export type SectionId = "compose" | "environment" | "extensions" | "features" | "general" | "lifecycle" | "mounts" | "ports";
+export declare const SECTION_ORDER: readonly SectionId[];

package/dist/tui/components/devcontainer/validate.d.ts

@@ -0,0 +1,16 @@
+import type { DevcontainerConfig } from "./types.d.ts";
+export interface ValidationIssue {
+    field: string;
+    message: string;
+}
+export interface ValidationResult {
+    errors: ValidationIssue[];
+    suggestions: ValidationIssue[];
+    valid: boolean;
+    warnings: ValidationIssue[];
+}
+/**
+ * Validate a devcontainer.json configuration.
+ * Returns errors (invalid config), warnings (deprecated/suspicious), and suggestions.
+ */
+export declare const validateConfig: (config: DevcontainerConfig) => ValidationResult;

package/dist/tui/components/graph/GraphStore.d.ts

@@ -0,0 +1,42 @@
+import type { ProjectGraph, ProjectGraphDependency } from "@visulima/task-runner";
+export type GraphFilterType = "all" | "app" | "lib";
+export interface GraphNode {
+    deps: ProjectGraphDependency[];
+    name: string;
+    reverseDeps: string[];
+    type: string;
+}
+export interface GraphState {
+    /** All nodes. */
+    allNodes: GraphNode[];
+    /** Whether the text filter input is active. */
+    filterActive: boolean;
+    /** Current filter text. */
+    filterText: string;
+    /** Filter by project type. */
+    filterType: GraphFilterType;
+    /** Which panel has keyboard focus. */
+    focusedPanel: "detail" | "list";
+    /** Currently highlighted entry index in the filtered list. */
+    selectedIndex: number;
+}
+type Listener = () => void;
+export declare class GraphStore {
+    #private;
+    constructor(projectGraph: ProjectGraph);
+    getSnapshot: () => GraphState;
+    subscribe: (listener: Listener) => () => void;
+    getFilteredNodes(): GraphNode[];
+    getStats(): {
+        apps: number;
+        deps: number;
+        libs: number;
+        total: number;
+    };
+    setSelectedIndex(index: number): void;
+    setFocusedPanel(panel: "detail" | "list"): void;
+    setFilterType(type: GraphFilterType): void;
+    setFilter(text: string): void;
+    setFilterActive(active: boolean): void;
+}
+export {};

package/dist/tui/components/graph/ProjectDetailPanel.d.ts

@@ -0,0 +1,10 @@
+import type { ScrollViewRef } from "@visulima/tui";
+import React from "react";
+import type { GraphNode } from "./GraphStore.d.ts";
+interface ProjectDetailPanelProps {
+    focused: boolean;
+    node: GraphNode | null;
+    scrollRef?: React.RefObject<ScrollViewRef>;
+}
+declare const ProjectDetailPanel: ({ focused, node, scrollRef }: ProjectDetailPanelProps) => React.JSX.Element;
+export default ProjectDetailPanel;

package/dist/tui/components/graph/ProjectListPanel.d.ts

@@ -0,0 +1,20 @@
+import React from "react";
+import type { GraphFilterType, GraphNode } from "./GraphStore.d.ts";
+interface ProjectListPanelProps {
+    filterActive: boolean;
+    filterText: string;
+    filterType: GraphFilterType;
+    focused: boolean;
+    nodes: GraphNode[];
+    scrollOffset: number;
+    selectedIndex: number;
+    stats: {
+        apps: number;
+        deps: number;
+        libs: number;
+        total: number;
+    };
+    viewportHeight: number;
+}
+declare const ProjectListPanel: ({ filterActive, filterText, filterType, focused, nodes, scrollOffset, selectedIndex, stats, viewportHeight, }: ProjectListPanelProps) => React.JSX.Element;
+export default ProjectListPanel;

package/dist/tui/components/graph/VisGraphApp.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { GraphStore } from "./GraphStore.d.ts";
+interface VisGraphAppProps {
+    autoExitSeconds?: number;
+    store: GraphStore;
+}
+declare const VisGraphApp: ({ autoExitSeconds, store }: VisGraphAppProps) => React.JSX.Element;
+export default VisGraphApp;

package/dist/tui/components/optimize/OptimizeDetailPanel.d.ts

@@ -0,0 +1,9 @@
+import type { ScrollViewRef } from "@visulima/tui";
+import type { OptimizeEntry } from "./OptimizeStore.d.ts";
+interface OptimizeDetailPanelProps {
+    entry: OptimizeEntry | null;
+    focused: boolean;
+    scrollRef?: React.RefObject<ScrollViewRef>;
+}
+declare const OptimizeDetailPanel: ({ entry, focused, scrollRef }: OptimizeDetailPanelProps) => React.JSX.Element;
+export default OptimizeDetailPanel;

package/dist/tui/components/optimize/OptimizeListPanel.d.ts

@@ -0,0 +1,16 @@
+import type { FilterType, OptimizeEntry } from "./OptimizeStore.d.ts";
+interface OptimizeListPanelProps {
+    checkedEntries: Set<string>;
+    entries: OptimizeEntry[];
+    filterActive: boolean;
+    filterText: string;
+    filterType: FilterType;
+    focused: boolean;
+    isDryRun: boolean;
+    scrollOffset: number;
+    selectedIndex: number;
+    totalEntries: number;
+    viewportHeight: number;
+}
+declare const OptimizeListPanel: ({ checkedEntries, entries, filterActive, filterText, filterType, focused, isDryRun, scrollOffset, selectedIndex, totalEntries, viewportHeight, }: OptimizeListPanelProps) => React.JSX.Element;
+export default OptimizeListPanel;

package/dist/tui/components/optimize/OptimizeStore.d.ts

@@ -0,0 +1,50 @@
+/** An optimization entry that can be either an e18e module replacement or a Socket.dev override. */
+interface OptimizeEntry {
+    /** Category for filtering and display. */
+    category: "micro-utility" | "native" | "preferred" | "socket";
+    /** Whether a codemod is available for this entry (e18e only). */
+    hasCodemod: boolean;
+    /** The override spec for socket entries (e.g., "npm:@socketregistry/is-regex@^1"). */
+    overrideSpec?: string;
+    /** The original package name. */
+    packageName: string;
+    /** Human-readable replacement target description. */
+    replacement: string;
+}
+type FilterType = "all" | "micro-utility" | "native" | "preferred" | "socket";
+interface OptimizeState {
+    applyProgress: {
+        current: number;
+        total: number;
+    } | null;
+    checkedEntries: Set<string>;
+    entries: OptimizeEntry[];
+    error: string | null;
+    filterActive: boolean;
+    filterText: string;
+    filterType: FilterType;
+    focusedPanel: "detail" | "list";
+    phase: "applying" | "browsing" | "done" | "error";
+    selectedIndex: number;
+}
+type Listener = () => void;
+declare class OptimizeStore {
+    #private;
+    constructor(entries: OptimizeEntry[]);
+    getSnapshot: () => OptimizeState;
+    subscribe: (listener: Listener) => () => void;
+    getFilteredEntries: () => OptimizeEntry[];
+    select(index: number): void;
+    toggleCheck(packageName: string): void;
+    toggleAll(): void;
+    setFilter(type: FilterType): void;
+    setFilterText(text: string): void;
+    setFilterActive(active: boolean): void;
+    setFocusedPanel(panel: "detail" | "list"): void;
+    setPhase(phase: OptimizeState["phase"]): void;
+    setProgress(current: number, total: number): void;
+    setError(error: string): void;
+    getCheckedEntries(): OptimizeEntry[];
+}
+export type { FilterType, OptimizeEntry, OptimizeState };
+export { OptimizeStore };

package/dist/tui/components/optimize/VisOptimizeApp.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { OptimizeStore } from "./OptimizeStore.d.ts";
+interface VisOptimizeAppProps {
+    isDryRun: boolean;
+    store: OptimizeStore;
+}
+declare const VisOptimizeApp: ({ isDryRun, store }: VisOptimizeAppProps) => React.JSX.Element;
+export default VisOptimizeApp;

package/dist/tui/components/optimize/constants.d.ts

@@ -0,0 +1,7 @@
+/** Category colors for the optimize TUI — shared between list and detail panels. */
+declare const CATEGORY_COLORS: Record<string, string>;
+/** Short labels for category badges in the list panel. */
+declare const CATEGORY_LABELS: Record<string, string>;
+/** Human-readable descriptions for each optimization category. */
+declare const CATEGORY_DESCRIPTIONS: Record<string, string>;
+export { CATEGORY_COLORS, CATEGORY_DESCRIPTIONS, CATEGORY_LABELS };

package/dist/tui/components/update/PackageDetailPanel.d.ts

@@ -0,0 +1,12 @@
+import type { ScrollViewRef } from "@visulima/tui";
+import type { AiRecommendation } from "../../../ai-analysis.d.ts";
+import type { OutdatedEntry } from "../../../catalog.d.ts";
+interface PackageDetailPanelProps {
+    changelogUrl?: string;
+    entry: OutdatedEntry | null;
+    focused: boolean;
+    recommendation?: AiRecommendation;
+    scrollRef?: React.RefObject<ScrollViewRef>;
+}
+declare const PackageDetailPanel: ({ changelogUrl, entry, focused, recommendation, scrollRef }: PackageDetailPanelProps) => React.JSX.Element;
+export default PackageDetailPanel;