@floegence/floe-webapp-core 0.48.6 → 0.50.0

package/dist/components/ui/index.d.ts

@@ -22,7 +22,8 @@ export { DirectoryPicker, type DirectoryPickerProps } from './DirectoryPicker';
 export { DirectoryInput, type DirectoryInputProps, type DirectoryInputSize, } from './DirectoryInput';
 export { FileSavePicker, type FileSavePickerProps } from './FileSavePicker';
 export { FileOpenPicker, normalizeFileOpenSelection, updateFileOpenSelection, type FileOpenPickerProps, type FileOpenPickerSelectionMode, } from './FileOpenPicker';
-export { type BasePickerProps, type PickerEnsurePath, type PickerEnsurePathOptions, type PickerPathResolveResult, type PickerPathResolveStatus, type PickerPathNavigateReason, } from './picker/PickerBase';
+export { type BasePickerProps, type PickerPanelProps } from './picker/PickerBase';
+export { createFilesystemPickerDataSource, parsePickerPath, formatPickerPath, PickerNavigationError, type PickerRoot, type PickerPathContext, type PickerDataProps, type PickerDirectoryLoader, type PickerCopy, type FilesystemPickerDataSource, } from './picker/PickerNavigation';
 export { QuoteBlock, type QuoteBlockProps } from './QuoteBlock';
 export { HighlightBlock, InfoBlock, WarningBlock, SuccessBlock, ErrorBlock, NoteBlock, TipBlock, type HighlightBlockProps, type HighlightVariant, } from './HighlightBlock';
 export { ProcessingIndicator, type ProcessingIndicatorProps, type ProcessingIndicatorVariant, type ProcessingIndicatorStatus, } from './ProcessingIndicator';

package/dist/components/ui/picker/PickerBase.d.ts

@@ -1,185 +1,67 @@
-/**
- * Shared internals for DirectoryPicker, FileOpenPicker, and FileSavePicker.
- * NOT exported from the package entry — these are implementation details.
- */
 import { type Accessor, type JSX } from 'solid-js';
-import type { FileItem } from '../../file-browser/types';
-/**
- * Base props shared by the directory and file pickers.
- * Provides consistent API for file tree navigation.
- */
-export interface BasePickerProps {
-    /** Whether the picker dialog is open */
+import { parsePickerPath, type FilesystemPickerDataSource, type PickerDataProps } from './PickerNavigation';
+export interface PickerPanelProps extends PickerDataProps {
+    disabled?: boolean;
+    /** Props for the actual constrained scrolling viewport, including host interaction markers. */
+    scrollViewportProps?: JSX.HTMLAttributes<HTMLDivElement>;
+    treeMaxHeight?: string;
+    onCreateFolder?: (parentPath: string, name: string) => Promise<void>;
+}
+export interface BasePickerProps extends PickerPanelProps {
     open: boolean;
-    /** Callback when open state changes */
     onOpenChange: (open: boolean) => void;
-    /** Full file tree data */
-    files: FileItem[];
-    /** Initial directory path (default: '/') */
-    initialPath?: string;
-    /** Dialog title - can be a string or JSX element for custom headers */
     title?: string | JSX.Element;
-    /** Confirm button text */
     confirmText?: string;
-    /** Cancel button text (default: 'Cancel') */
     cancelText?: string;
-    /**
-     * Callback when user creates a new folder.
-     * When provided, a "New Folder" button is shown.
-     */
-    onCreateFolder?: (parentPath: string, name: string) => Promise<void>;
-    /**
-     * Callback when user expands a directory.
-     * Use this to dynamically load children for the expanded directory.
-     * The path parameter is the internal tree path (not the display path).
-     */
-    onExpand?: (path: string) => void | Promise<void>;
-    /**
-     * Async resolver used when a navigation target may exist outside the current
-     * in-memory tree snapshot. A ready result guarantees the target path and its
-     * ancestor chain are now represented in `files`.
-     */
-    ensurePath?: PickerEnsurePath;
-    /** Filter which directories are selectable (return false to grey-out) */
-    filter?: (item: FileItem) => boolean;
-    /** Label for the home/root directory (default: 'Root') */
-    homeLabel?: string;
-    /**
-     * Real filesystem path of the home directory (e.g. '/home/user').
-     * When set, paths display with real filesystem paths.
-     */
-    homePath?: string;
-    /** Additional CSS class */
     class?: string;
 }
-export declare function normalizePath(path: string): string;
-/**
- * Returns ancestor paths (excluding root and the path itself).
- * e.g. "/a/b/c" → ["/a", "/a/b"]
- */
-export declare function getAncestorPaths(path: string): string[];
-/** Get parent path of a given path */
-export declare function getParentPath(path: string): string;
-/** Build a path → FileItem map for all folders in the tree */
-export declare function useFolderIndex(files: Accessor<FileItem[]>): Accessor<Map<string, FileItem>>;
-export interface UsePickerTreeOptions {
-    initialPath?: string | Accessor<string | undefined>;
-    open: Accessor<boolean>;
-    files: Accessor<FileItem[]>;
-    filter?: (item: FileItem) => boolean;
-    /** Additional reset logic when the dialog opens */
-    onReset?: (initialPath: string) => void;
-    /**
-     * Callback when user expands a directory.
-     * Use this to dynamically load children for the expanded directory.
-     */
-    onExpand?: (path: string) => void | Promise<void>;
-    /** Async resolver that ensures a target path exists in the current tree snapshot. */
-    ensurePath?: PickerEnsurePath;
-    /** Label for the home/root directory in tree and breadcrumb (default: 'Root'). Supports accessor for reactivity. */
-    homeLabel?: string | Accessor<string | undefined>;
-    /**
-     * Real filesystem path of the home directory (e.g. '/home/user').
-     * When set, the path input bar and display paths will show real filesystem
-     * paths instead of internal tree-relative paths. Supports accessor for reactivity.
-     */
-    homePath?: string | Accessor<string | undefined>;
-}
-export interface PickerTreeState {
-    selectedPath: Accessor<string>;
-    setSelectedPath: (path: string) => void;
-    expandedPaths: Accessor<Set<string>>;
-    toggleExpand: (path: string) => void;
+export declare function pickerCopy(config: PickerDataProps): {
+    path: string;
+    go: string;
+    roots: string;
+    root: string;
+    showHidden: string;
+    loading: string;
+    retry: string;
+    empty: string;
+    emptyFiles: string;
+    invalidPath: string;
+    missingPath: string;
+    unavailableContext: string;
+    loadFailed: string;
+    currentDirectory: string;
+    newFolder: string;
+    folderName: string;
+    create: string;
+    cancel: string;
+    fileName: string;
+    fileNameRequired: string;
+    noFilesSelected: string;
+    selectionLimit: string;
+    selectedCount: (count: number) => string;
+};
+export declare function pickerErrorMessage(props: PickerDataProps, error: unknown): string;
+/** One owner for dialog and embedded pickers. Identity changes close the previous session first. */
+export declare function usePickerNavigation(props: PickerDataProps, open: Accessor<boolean>, onValidated?: (path: string) => void, onReset?: () => void): {
+    context: Accessor<import("./PickerNavigation").PickerPathContext | null>;
+    currentPath: Accessor<string>;
+    entries: Accessor<readonly import("../..").FileItem[]>;
     pathInput: Accessor<string>;
-    setPathInput: (value: string) => void;
-    pathPending: Accessor<boolean>;
-    pathInputError: Accessor<string>;
-    setPathInputError: (value: string) => void;
-    folderIndex: Accessor<Map<string, FileItem>>;
-    rootFolders: Accessor<FileItem[]>;
-    isValidPath: (path: string) => boolean;
-    isSelectable: (item: FileItem) => boolean;
-    handleSelectFolder: (item: FileItem) => void;
-    handleSelectRoot: () => void;
-    handlePathInputGo: () => void;
-    handlePathInputKeyDown: (e: KeyboardEvent) => void;
-    expandToPath: (path: string) => void;
-    navigateToPath: (path: string, options: PickerEnsurePathOptions) => Promise<PickerPathResolveResult>;
-    breadcrumbSegments: Accessor<{
-        name: string;
-        path: string;
-    }[]>;
-    handleBreadcrumbClick: (path: string) => void;
-    /** Home label for display (reactive) */
-    homeLabel: Accessor<string>;
-    /** Convert internal tree path to display (real filesystem) path */
-    toDisplayPath: (internalPath: string) => string;
-    /** Monotonic counter used to reveal the selected row after async navigation. */
-    revealNonce: Accessor<number>;
-}
-export type PickerPathResolveStatus = 'ready' | 'missing' | 'error';
-export type PickerPathNavigateReason = 'open' | 'path-input' | 'tree-expand' | 'tree-select' | 'breadcrumb';
-export interface PickerEnsurePathOptions {
-    reason: PickerPathNavigateReason;
-}
-export interface PickerPathResolveResult {
-    status: PickerPathResolveStatus;
-    resolvedPath: string;
-    message?: string;
-}
-export type PickerEnsurePath = (path: string, options: PickerEnsurePathOptions) => PickerPathResolveResult | Promise<PickerPathResolveResult>;
-export declare function resolvePickerInitialPath(initialPath: string | undefined, homePath: string | undefined): string;
-export declare function usePickerTree(opts: UsePickerTreeOptions): PickerTreeState;
-export interface NewFolderSectionProps {
-    parentPath: Accessor<string>;
-    onCreateFolder: (parentPath: string, name: string) => Promise<void>;
-    /** Optional function to convert internal path to display path */
-    toDisplayPath?: (internalPath: string) => string;
-}
-export declare function NewFolderSection(props: NewFolderSectionProps): JSX.Element;
-export interface PathInputBarProps {
-    value: Accessor<string>;
-    onInput: (value: string) => void;
-    pending?: Accessor<boolean>;
-    error: Accessor<string>;
-    onGo: () => void;
-    onKeyDown: (e: KeyboardEvent) => void;
-    placeholder?: string;
-}
-export declare function PathInputBar(props: PathInputBarProps): JSX.Element;
-export interface PickerBreadcrumbProps {
-    segments: Accessor<{
-        name: string;
-        path: string;
-    }[]>;
-    onClick: (path: string) => void;
-}
-export declare function PickerBreadcrumb(props: PickerBreadcrumbProps): JSX.Element;
-export interface PickerFolderTreeProps {
-    rootFolders: Accessor<FileItem[]>;
-    selectedPath: Accessor<string>;
-    expandedPaths: Accessor<Set<string>>;
-    revealNonce?: Accessor<number>;
-    onToggle: (path: string) => void;
-    onSelect: (item: FileItem) => void;
-    onSelectRoot: () => void;
-    isSelectable: (item: FileItem) => boolean;
-    class?: string;
-    style?: JSX.CSSProperties;
-    emptyText?: string;
-    /** Label for the home/root directory (default: 'Root'). Supports accessor for reactivity. */
-    homeLabel?: string | Accessor<string>;
-}
-export declare function PickerFolderTree(props: PickerFolderTreeProps): JSX.Element;
-export interface PickerTreeNodeProps {
-    item: FileItem;
-    depth: number;
-    selectedPath: Accessor<string>;
-    expandedPaths: Accessor<Set<string>>;
-    revealNonce?: Accessor<number>;
-    onToggle: (path: string) => void;
-    onSelect: (item: FileItem) => void;
-    isSelectable: (item: FileItem) => boolean;
-    registerRow: (path: string, el: HTMLButtonElement | null) => void;
-}
-export declare function PickerTreeNode(props: PickerTreeNodeProps): JSX.Element;
+    pending: Accessor<boolean>;
+    error: Accessor<unknown>;
+    showHidden: Accessor<boolean>;
+    active: Accessor<boolean>;
+    valid: () => boolean;
+    open: (path?: string) => Promise<void>;
+    close: () => void;
+    navigate: (rawPath: string) => Promise<boolean>;
+    setPathInput(value: string): void;
+    setShowHidden(value: boolean): Promise<void>;
+    retry(): Promise<void>;
+};
+/** Absolute directory navigation shared by all picker presentations. */
+export declare function PickerPanel(props: PickerPanelProps & {
+    source: FilesystemPickerDataSource;
+}): JSX.Element;
+export declare const normalizePath: typeof parsePickerPath;
+export { pickerParentPath as getParentPath } from './PickerNavigation';