craft-native 0.0.37

package/dist/components/native.d.ts

@@ -0,0 +1,728 @@
+/**
+ * Craft Native UI Components
+ * Type-safe bindings for native platform UI components
+ * @module @craft-native/components/native
+ */
+/**
+ * Base component props
+ */
+export interface ComponentProps {
+    /** Unique component ID */
+    id?: string;
+    /** CSS class names */
+    className?: string;
+    /** Inline styles */
+    style?: Record<string, any>;
+    /** Hidden state */
+    hidden?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Tooltip text */
+    tooltip?: string;
+}
+/**
+ * Component instance
+ */
+export interface ComponentInstance {
+    /** Component ID */
+    id: string;
+    /** Component type */
+    type: string;
+    /** Update component properties */
+    update(props: Record<string, any>): Promise<void>;
+    /** Destroy component */
+    destroy(): Promise<void>;
+    /** Show component */
+    show(): Promise<void>;
+    /** Hide component */
+    hide(): Promise<void>;
+    /** Focus component */
+    focus(): Promise<void>;
+    /** Register event handler */
+    on(event: string, handler: Function): () => void;
+}
+/**
+ * Split view orientation
+ */
+export type SplitViewOrientation = 'horizontal' | 'vertical';
+/**
+ * Split view divider style
+ */
+export type SplitViewDividerStyle = 'thin' | 'thick' | 'paneSplitter';
+/**
+ * Split view configuration
+ */
+export interface SplitViewConfig extends ComponentProps {
+    /** Split orientation */
+    orientation?: SplitViewOrientation;
+    /** Divider style */
+    dividerStyle?: SplitViewDividerStyle;
+    /** Initial divider position (percentage or pixels) */
+    position?: number;
+    /** Minimum position for each pane */
+    minPositions?: [number, number];
+    /** Maximum position for each pane */
+    maxPositions?: [number, number];
+    /** Autosave position with key */
+    autosaveName?: string;
+}
+/**
+ * Create a native split view
+ */
+export declare function createSplitView(config?: SplitViewConfig): Promise<SplitViewInstance>;
+/**
+ * Split view instance
+ */
+export declare class SplitViewInstance implements ComponentInstance {
+    id: string;
+    type: string;
+    private _config;
+    private _listeners;
+    constructor(id: string, config: SplitViewConfig);
+    private _setupListeners;
+    private _emit;
+    on(event: string, handler: Function): () => void;
+    update(props: Partial<SplitViewConfig>): Promise<void>;
+    destroy(): Promise<void>;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+    focus(): Promise<void>;
+    /**
+     * Set divider position
+     */
+    setPosition(position: number, animated?: boolean): Promise<void>;
+    /**
+     * Get current divider position
+     */
+    getPosition(): Promise<number>;
+    /**
+     * Collapse a pane
+     */
+    collapsePane(index: 0 | 1): Promise<void>;
+    /**
+     * Expand a pane
+     */
+    expandPane(index: 0 | 1): Promise<void>;
+}
+/**
+ * File browser configuration
+ */
+export interface FileBrowserConfig extends ComponentProps {
+    /** Root path to browse */
+    rootPath?: string;
+    /** Show hidden files */
+    showHidden?: boolean;
+    /** Selection mode */
+    selectionMode?: 'single' | 'multiple' | 'none';
+    /** File filter */
+    fileFilter?: Array<{
+        name: string;
+        extensions: string[];
+    }>;
+    /** Show path bar */
+    showPathBar?: boolean;
+    /** Show toolbar */
+    showToolbar?: boolean;
+    /** Show sidebar */
+    showSidebar?: boolean;
+    /** Show preview */
+    showPreview?: boolean;
+    /** View mode */
+    viewMode?: 'list' | 'icon' | 'column' | 'gallery';
+    /** Sort by */
+    sortBy?: 'name' | 'date' | 'size' | 'kind';
+    /** Sort order */
+    sortOrder?: 'ascending' | 'descending';
+    /** Allow directory selection */
+    allowDirectorySelection?: boolean;
+    /** Allow file creation */
+    allowFileCreation?: boolean;
+}
+/**
+ * File browser selection
+ */
+export interface FileBrowserSelection {
+    /** Selected file paths */
+    paths: string[];
+    /** Selected file info */
+    files: Array<{
+        path: string;
+        name: string;
+        isDirectory: boolean;
+        size: number;
+        modified: Date;
+    }>;
+}
+/**
+ * Create a native file browser
+ */
+export declare function createFileBrowser(config?: FileBrowserConfig): Promise<FileBrowserInstance>;
+/**
+ * File browser instance
+ */
+export declare class FileBrowserInstance implements ComponentInstance {
+    id: string;
+    type: string;
+    private _config;
+    private _listeners;
+    constructor(id: string, config: FileBrowserConfig);
+    private _setupListeners;
+    private _emit;
+    on(event: string, handler: Function): () => void;
+    update(props: Partial<FileBrowserConfig>): Promise<void>;
+    destroy(): Promise<void>;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+    focus(): Promise<void>;
+    /**
+     * Get current selection
+     */
+    getSelection(): Promise<FileBrowserSelection>;
+    /**
+     * Set selection
+     */
+    setSelection(paths: string[]): Promise<void>;
+    /**
+     * Navigate to path
+     */
+    navigateTo(path: string): Promise<void>;
+    /**
+     * Go back in history
+     */
+    goBack(): Promise<void>;
+    /**
+     * Go forward in history
+     */
+    goForward(): Promise<void>;
+    /**
+     * Go to parent directory
+     */
+    goUp(): Promise<void>;
+    /**
+     * Refresh content
+     */
+    refresh(): Promise<void>;
+    /**
+     * Create new folder
+     */
+    createFolder(name: string): Promise<string>;
+    /**
+     * Delete selected files
+     */
+    deleteSelection(moveToTrash?: boolean): Promise<void>;
+    /**
+     * Get current path
+     */
+    getCurrentPath(): Promise<string>;
+}
+/**
+ * Outline item
+ */
+export interface OutlineItem {
+    /** Item ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Icon */
+    icon?: string;
+    /** Children */
+    children?: OutlineItem[];
+    /** Expanded state */
+    expanded?: boolean;
+    /** Selectable */
+    selectable?: boolean;
+    /** Editable */
+    editable?: boolean;
+    /** Draggable */
+    draggable?: boolean;
+    /** Custom data */
+    data?: Record<string, any>;
+}
+/**
+ * Outline view configuration
+ */
+export interface OutlineViewConfig extends ComponentProps {
+    /** Items */
+    items?: OutlineItem[];
+    /** Allow multiple selection */
+    multiSelect?: boolean;
+    /** Allow reordering */
+    allowReorder?: boolean;
+    /** Show expand buttons */
+    showExpandButtons?: boolean;
+    /** Row height */
+    rowHeight?: number;
+    /** Indent per level */
+    indentation?: number;
+}
+/**
+ * Create a native outline view (tree view)
+ */
+export declare function createOutlineView(config?: OutlineViewConfig): Promise<OutlineViewInstance>;
+/**
+ * Outline view instance
+ */
+export declare class OutlineViewInstance implements ComponentInstance {
+    id: string;
+    type: string;
+    private _config;
+    private _listeners;
+    constructor(id: string, config: OutlineViewConfig);
+    private _setupListeners;
+    private _emit;
+    on(event: string, handler: Function): () => void;
+    update(props: Partial<OutlineViewConfig>): Promise<void>;
+    destroy(): Promise<void>;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+    focus(): Promise<void>;
+    /**
+     * Set items
+     */
+    setItems(items: OutlineItem[]): Promise<void>;
+    /**
+     * Add item
+     */
+    addItem(item: OutlineItem, parentId?: string, index?: number): Promise<void>;
+    /**
+     * Update item
+     */
+    updateItem(itemId: string, updates: Partial<OutlineItem>): Promise<void>;
+    /**
+     * Remove item
+     */
+    removeItem(itemId: string): Promise<void>;
+    /**
+     * Expand item
+     */
+    expandItem(itemId: string): Promise<void>;
+    /**
+     * Collapse item
+     */
+    collapseItem(itemId: string): Promise<void>;
+    /**
+     * Select item
+     */
+    selectItem(itemId: string): Promise<void>;
+    /**
+     * Get selection
+     */
+    getSelection(): Promise<string[]>;
+    /**
+     * Scroll to item
+     */
+    scrollToItem(itemId: string): Promise<void>;
+}
+/**
+ * Table column configuration
+ */
+export interface TableColumn {
+    /** Column ID */
+    id: string;
+    /** Column header title */
+    title: string;
+    /** Column width */
+    width?: number;
+    /** Minimum width */
+    minWidth?: number;
+    /** Maximum width */
+    maxWidth?: number;
+    /** Resizable */
+    resizable?: boolean;
+    /** Sortable */
+    sortable?: boolean;
+    /** Sort direction */
+    sortDirection?: 'ascending' | 'descending' | null;
+    /** Hidden */
+    hidden?: boolean;
+    /** Alignment */
+    alignment?: 'left' | 'center' | 'right';
+    /** Editable */
+    editable?: boolean;
+}
+/**
+ * Table row
+ */
+export interface TableRow {
+    /** Row ID */
+    id: string;
+    /** Column values (column ID -> value) */
+    values: Record<string, any>;
+    /** Row selected */
+    selected?: boolean;
+    /** Row disabled */
+    disabled?: boolean;
+    /** Custom data */
+    data?: Record<string, any>;
+}
+/**
+ * Table view configuration
+ */
+export interface TableViewConfig extends ComponentProps {
+    /** Columns */
+    columns?: TableColumn[];
+    /** Rows */
+    rows?: TableRow[];
+    /** Allow column reordering */
+    allowColumnReorder?: boolean;
+    /** Allow row selection */
+    allowSelection?: boolean;
+    /** Allow multiple selection */
+    multiSelect?: boolean;
+    /** Alternating row colors */
+    alternatingRows?: boolean;
+    /** Show column headers */
+    showHeaders?: boolean;
+    /** Row height */
+    rowHeight?: number;
+    /** Grid lines */
+    gridLines?: 'none' | 'horizontal' | 'vertical' | 'both';
+}
+/**
+ * Create a native table view
+ */
+export declare function createTableView(config?: TableViewConfig): Promise<TableViewInstance>;
+/**
+ * Table view instance
+ */
+export declare class TableViewInstance implements ComponentInstance {
+    id: string;
+    type: string;
+    private _config;
+    private _listeners;
+    constructor(id: string, config: TableViewConfig);
+    private _setupListeners;
+    private _emit;
+    on(event: string, handler: Function): () => void;
+    update(props: Partial<TableViewConfig>): Promise<void>;
+    destroy(): Promise<void>;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+    focus(): Promise<void>;
+    /**
+     * Set columns
+     */
+    setColumns(columns: TableColumn[]): Promise<void>;
+    /**
+     * Set rows
+     */
+    setRows(rows: TableRow[]): Promise<void>;
+    /**
+     * Add row
+     */
+    addRow(row: TableRow, index?: number): Promise<void>;
+    /**
+     * Update row
+     */
+    updateRow(rowId: string, values: Record<string, any>): Promise<void>;
+    /**
+     * Remove row
+     */
+    removeRow(rowId: string): Promise<void>;
+    /**
+     * Get selection
+     */
+    getSelection(): Promise<string[]>;
+    /**
+     * Select rows
+     */
+    selectRows(rowIds: string[]): Promise<void>;
+    /**
+     * Sort by column
+     */
+    sortBy(columnId: string, direction: 'ascending' | 'descending'): Promise<void>;
+    /**
+     * Scroll to row
+     */
+    scrollToRow(rowId: string): Promise<void>;
+}
+/**
+ * Quick Look configuration
+ */
+export interface QuickLookConfig {
+    /** File path to preview */
+    path: string;
+    /** Panel position */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /** Panel size */
+    size?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Show Quick Look preview for a file
+ */
+export declare function showQuickLook(config: QuickLookConfig): Promise<void>;
+/**
+ * Hide Quick Look preview
+ */
+export declare function hideQuickLook(): Promise<void>;
+/**
+ * Check if Quick Look is available for a file
+ */
+export declare function canQuickLook(path: string): Promise<boolean>;
+/**
+ * Color picker configuration
+ */
+export interface ColorPickerConfig {
+    /** Initial color (hex, rgb, or named) */
+    color?: string;
+    /** Show alpha slider */
+    showAlpha?: boolean;
+    /** Mode */
+    mode?: 'wheel' | 'sliders' | 'palette' | 'list';
+    /** Title */
+    title?: string;
+}
+/**
+ * Show native color picker
+ */
+export declare function showColorPicker(config?: ColorPickerConfig): Promise<string | null>;
+/**
+ * Font picker configuration
+ */
+export interface FontPickerConfig {
+    /** Initial font */
+    font?: {
+        family: string;
+        size: number;
+        weight?: string;
+        style?: string;
+    };
+    /** Title */
+    title?: string;
+    /** Show size picker */
+    showSize?: boolean;
+    /** Show weight picker */
+    showWeight?: boolean;
+    /** Show style picker */
+    showStyle?: boolean;
+}
+/**
+ * Font result
+ */
+export interface FontResult {
+    family: string;
+    size: number;
+    weight?: string;
+    style?: string;
+}
+/**
+ * Show native font picker
+ */
+export declare function showFontPicker(config?: FontPickerConfig): Promise<FontResult | null>;
+/**
+ * Date picker configuration
+ */
+export interface DatePickerConfig {
+    /** Initial date */
+    date?: Date | string;
+    /** Minimum date */
+    minDate?: Date | string;
+    /** Maximum date */
+    maxDate?: Date | string;
+    /** Date format */
+    format?: string;
+    /** Show time picker */
+    showTime?: boolean;
+    /** Calendar style */
+    style?: 'default' | 'graphical';
+}
+/**
+ * Show native date picker
+ */
+export declare function showDatePicker(config?: DatePickerConfig): Promise<Date | null>;
+/**
+ * Progress indicator configuration
+ */
+export interface ProgressConfig extends ComponentProps {
+    /** Progress value (0-1 for determinate, undefined for indeterminate) */
+    value?: number;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Show as percentage text */
+    showText?: boolean;
+    /** Inline styles */
+    style?: Record<string, any>;
+    /** Size */
+    size?: 'small' | 'regular' | 'large';
+    /** Progress style variant */
+    progressStyle?: 'bar' | 'spinning' | 'circular';
+}
+/**
+ * Create a progress indicator
+ */
+export declare function createProgress(config?: ProgressConfig): Promise<ProgressInstance>;
+/**
+ * Progress instance
+ */
+export declare class ProgressInstance implements ComponentInstance {
+    id: string;
+    type: string;
+    private _config;
+    private _listeners;
+    constructor(id: string, config: ProgressConfig);
+    on(event: string, handler: Function): () => void;
+    update(props: Partial<ProgressConfig>): Promise<void>;
+    destroy(): Promise<void>;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+    focus(): Promise<void>;
+    /**
+     * Set progress value
+     */
+    setValue(value: number): Promise<void>;
+    /**
+     * Start indeterminate animation
+     */
+    startAnimation(): Promise<void>;
+    /**
+     * Stop animation
+     */
+    stopAnimation(): Promise<void>;
+}
+/**
+ * Toolbar item
+ */
+export interface ToolbarItem {
+    /** Item ID */
+    id: string;
+    /** Item type */
+    type?: 'button' | 'toggle' | 'segment' | 'search' | 'space' | 'flexibleSpace' | 'separator' | 'group';
+    /** Label */
+    label?: string;
+    /** Icon (SF Symbol or path) */
+    icon?: string;
+    /** Tooltip */
+    tooltip?: string;
+    /** Enabled */
+    enabled?: boolean;
+    /** Selected (for toggle) */
+    selected?: boolean;
+    /** Min width (for search) */
+    minWidth?: number;
+    /** Max width (for search) */
+    maxWidth?: number;
+    /** Segments (for segment control) */
+    segments?: Array<{
+        id: string;
+        label?: string;
+        icon?: string;
+    }>;
+    /** Items (for group) */
+    items?: ToolbarItem[];
+}
+/**
+ * Toolbar configuration
+ */
+export interface ToolbarConfig {
+    /** Toolbar items */
+    items?: ToolbarItem[];
+    /** Default item identifiers */
+    defaultItems?: string[];
+    /** Allow customization */
+    allowsCustomization?: boolean;
+    /** Display mode */
+    displayMode?: 'default' | 'iconOnly' | 'labelOnly' | 'iconAndLabel';
+    /** Size mode */
+    sizeMode?: 'default' | 'small' | 'regular';
+    /** Show separator below toolbar */
+    showBottomBorder?: boolean;
+}
+/**
+ * Set window toolbar
+ */
+export declare function setToolbar(config: ToolbarConfig): Promise<void>;
+/**
+ * Update toolbar item
+ */
+export declare function updateToolbarItem(itemId: string, updates: Partial<ToolbarItem>): Promise<void>;
+/**
+ * Show/hide toolbar
+ */
+export declare function setToolbarVisible(visible: boolean): Promise<void>;
+/**
+ * Touch Bar item
+ */
+export interface TouchBarItem {
+    /** Item ID */
+    id: string;
+    /** Item type */
+    type: 'button' | 'label' | 'slider' | 'colorPicker' | 'popover' | 'group' | 'segmentedControl' | 'scrubber' | 'spacer';
+    /** Label text */
+    label?: string;
+    /** Icon */
+    icon?: string;
+    /** Background color */
+    backgroundColor?: string;
+    /** Text color */
+    textColor?: string;
+    /** Enabled */
+    enabled?: boolean;
+    /** Width */
+    width?: number;
+    /** Items (for group/popover) */
+    items?: TouchBarItem[];
+    /** Segments (for segmented control) */
+    segments?: Array<{
+        id: string;
+        label?: string;
+        icon?: string;
+    }>;
+    /** Min value (for slider) */
+    min?: number;
+    /** Max value (for slider) */
+    max?: number;
+    /** Value (for slider) */
+    value?: number;
+    /** Spacer size */
+    size?: 'small' | 'large' | 'flexible';
+}
+/**
+ * Touch Bar configuration
+ */
+export interface TouchBarConfig {
+    /** Touch Bar items */
+    items?: TouchBarItem[];
+    /** Escape item */
+    escapeItem?: TouchBarItem;
+}
+/**
+ * Set Touch Bar
+ */
+export declare function setTouchBar(config: TouchBarConfig): Promise<void>;
+/**
+ * Update Touch Bar item
+ */
+export declare function updateTouchBarItem(itemId: string, updates: Partial<TouchBarItem>): Promise<void>;
+declare const nativeComponents: {
+    createSplitView: typeof createSplitView;
+    SplitViewInstance: typeof SplitViewInstance;
+    createFileBrowser: typeof createFileBrowser;
+    FileBrowserInstance: typeof FileBrowserInstance;
+    createOutlineView: typeof createOutlineView;
+    OutlineViewInstance: typeof OutlineViewInstance;
+    createTableView: typeof createTableView;
+    TableViewInstance: typeof TableViewInstance;
+    showQuickLook: typeof showQuickLook;
+    hideQuickLook: typeof hideQuickLook;
+    canQuickLook: typeof canQuickLook;
+    showColorPicker: typeof showColorPicker;
+    showFontPicker: typeof showFontPicker;
+    showDatePicker: typeof showDatePicker;
+    createProgress: typeof createProgress;
+    ProgressInstance: typeof ProgressInstance;
+    setToolbar: typeof setToolbar;
+    updateToolbarItem: typeof updateToolbarItem;
+    setToolbarVisible: typeof setToolbarVisible;
+    setTouchBar: typeof setTouchBar;
+    updateTouchBarItem: typeof updateTouchBarItem;
+};
+export default nativeComponents;
+//# sourceMappingURL=native.d.ts.map