craft-native 0.0.37

package/dist/api/process.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Craft Process API
+ * Provides process management and system information
+ */
+export declare const env: Record<string, string | undefined>;
+/**
+ * Current platform
+ */
+export type Platform = 'darwin' | 'macos' | 'win32' | 'windows' | 'linux' | 'ios' | 'android' | 'unknown';
+/**
+ * Get current platform
+ */
+export declare function getPlatform(): Platform;
+/**
+ * Check if running on desktop
+ */
+export declare function isDesktop(): boolean;
+/**
+ * Check if running on mobile
+ */
+export declare function isMobile(): boolean;
+/**
+ * Check if running in Craft environment
+ */
+export declare function isCraft(): boolean;
+/**
+ * System information
+ */
+export interface SystemInfo {
+    platform: Platform;
+    arch: string;
+    osVersion: string;
+    hostname: string;
+    cpuCount: number;
+    totalMemory: number;
+    freeMemory: number;
+    uptime: number;
+}
+/**
+ * Get system information
+ */
+export declare function getSystemInfo(): Promise<SystemInfo>;
+/**
+ * Execute shell command (requires Craft environment)
+ */
+export interface ExecOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+    maxBuffer?: number;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+/**
+ * Spawn a child process
+ */
+export interface SpawnOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    /**
+     * Run the command through a shell. The Craft bridge translates this
+     * automatically (cmd.exe on Windows, /bin/sh elsewhere). On the Node
+     * fallback the command is rewritten to `cmd.exe /c <cmd>` on win32.
+     */
+    shell?: boolean;
+}
+export declare class ChildProcess {
+    private command;
+    private args;
+    private options;
+    private processId;
+    private onStdoutHandlers;
+    private onStderrHandlers;
+    private onExitHandlers;
+    private domListeners;
+    private exited;
+    constructor(command: string, args?: string[], options?: SpawnOptions);
+    private addDomListener;
+    private removeDomListeners;
+    /** Pid assigned by the native bridge, or null before start(). */
+    get pid(): string | null;
+    /**
+     * Start the process
+     */
+    start(): Promise<void>;
+    /**
+     * Write to stdin
+     */
+    write(data: string): Promise<void>;
+    /**
+     * Kill the process
+     */
+    kill(signal?: string): Promise<void>;
+    /**
+     * Listen for stdout data
+     */
+    onStdout(handler: (data: string) => void): () => void;
+    /**
+     * Listen for stderr data
+     */
+    onStderr(handler: (data: string) => void): () => void;
+    /**
+     * Listen for exit
+     */
+    onExit(handler: (code: number) => void): () => void;
+}
+/**
+ * Spawn a child process
+ */
+export declare function spawn(command: string, args?: string[], options?: SpawnOptions): ChildProcess;
+/**
+ * Get current working directory
+ */
+export declare function cwd(): string;
+/**
+ * Get home directory
+ */
+export declare function homeDir(): Promise<string>;
+/**
+ * Get temp directory
+ */
+export declare function tempDir(): Promise<string>;
+/**
+ * Exit the application. Prefers the native bridge's `app.quit()` so the
+ * platform can flush state; falls back to `process.exit` in Node-like
+ * environments. Accepts a non-zero code on the Node fallback so callers can
+ * signal failure to a parent shell.
+ */
+export declare function exit(code?: number): void;
+/**
+ * Get command line arguments
+ */
+export declare function argv(): string[];
+/**
+ * Open URL or file in default application.
+ *
+ * Uses `child_process.execFile` (no shell) so a target like
+ * `https://example.com; rm -rf ~` cannot be reinterpreted by a shell.
+ *
+ * On Windows we explicitly invoke `cmd.exe /c start "" <target>` rather
+ * than calling `start` directly — `start` is a `cmd.exe` builtin, not an
+ * executable, so the previous implementation would fail with ENOENT. The
+ * empty `""` is the literal `start` window-title argument; `start` would
+ * otherwise interpret a quoted path as the title and never open it.
+ */
+export declare function open(target: string): Promise<void>;
+declare const processApi: {
+    env: typeof env;
+    getPlatform: typeof getPlatform;
+    isDesktop: typeof isDesktop;
+    isMobile: typeof isMobile;
+    isCraft: typeof isCraft;
+    getSystemInfo: typeof getSystemInfo;
+    exec: typeof exec;
+    spawn: typeof spawn;
+    cwd: typeof cwd;
+    homeDir: typeof homeDir;
+    tempDir: typeof tempDir;
+    exit: typeof exit;
+    argv: typeof argv;
+    open: typeof open;
+};
+export default processApi;
+//# sourceMappingURL=process.d.ts.map

package/dist/api/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/api/process.ts"],"names":[],"mappings":"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"}

package/dist/api/sidebar.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Cross-Platform Native Sidebar API
+ * @description Unified sidebar component that renders with native styling
+ * on macOS, Windows, and Linux.
+ * @module @craft-native/api/sidebar
+ */
+export interface SidebarItem {
+    id: string;
+    label: string;
+    icon?: string;
+    badge?: string | number;
+    selected?: boolean;
+    children?: SidebarItem[];
+    expanded?: boolean;
+    enabled?: boolean;
+    tintColor?: string;
+    tooltip?: string;
+}
+export interface SidebarSection {
+    id: string;
+    title?: string;
+    items: SidebarItem[];
+    collapsible?: boolean;
+    collapsed?: boolean;
+}
+export interface SidebarConfig {
+    /** Sidebar width in pixels */
+    width?: number;
+    /** Sections with grouped items */
+    sections?: SidebarSection[];
+    /** Flat list of items (no sections) */
+    items?: SidebarItem[];
+    /** Show search field */
+    showSearch?: boolean;
+    /** Search placeholder */
+    searchPlaceholder?: string;
+    /**
+     * Milliseconds to debounce search input. Set to `0` for instant search.
+     * Default 80ms — fast enough to feel live, slow enough that fast typists
+     * don't fire one bridge call per keystroke.
+     */
+    searchDebounceMs?: number;
+    /** Header title */
+    headerTitle?: string;
+    /** Header subtitle */
+    headerSubtitle?: string;
+    /** Allow resizing */
+    resizable?: boolean;
+    /** Platform-specific style overrides */
+    platform?: {
+        macos?: MacOSSidebarConfig;
+        windows?: WindowsSidebarConfig;
+        linux?: LinuxSidebarConfig;
+    };
+}
+export interface MacOSSidebarConfig {
+    /** Use vibrancy effect */
+    vibrancy?: boolean;
+    /** Material type for vibrancy */
+    material?: 'sidebar' | 'headerView' | 'menu' | 'popover';
+    /** Position traffic lights in sidebar (Settings/Tahoe style) */
+    trafficLightsInSidebar?: boolean;
+    /** Hide titlebar separator */
+    hideTitlebarSeparator?: boolean;
+}
+export interface WindowsSidebarConfig {
+    /** Use Mica/Acrylic material */
+    material?: 'mica' | 'acrylic' | 'none';
+    /** Use Windows 11 rounded corners */
+    rounded?: boolean;
+}
+export interface LinuxSidebarConfig {
+    /** GTK theme variant */
+    theme?: 'adwaita' | 'breeze' | 'auto';
+}
+export interface SidebarSelectEvent {
+    itemId: string;
+    sectionId?: string;
+    item: SidebarItem;
+}
+export interface SidebarSearchEvent {
+    query: string;
+}
+export declare class Sidebar {
+    private config;
+    private element;
+    private onSelectHandler?;
+    private onSearchHandler?;
+    private listenerCleanups;
+    constructor(config?: SidebarConfig);
+    /** Render the sidebar and return HTML + CSS */
+    render(): {
+        html: string;
+        css: string;
+    };
+    /** Mount sidebar to a container element */
+    mount(container?: HTMLElement | string): void;
+    /** Update configuration and re-render */
+    update(config: Partial<SidebarConfig>): void;
+    /** Tear down listeners and remove the sidebar from the DOM. */
+    destroy(): void;
+    private detachEventListeners;
+    /** Select an item programmatically */
+    selectItem(itemId: string): void;
+    /** Register selection handler */
+    onSelect(handler: (event: SidebarSelectEvent) => void): void;
+    /** Register search handler */
+    onSearch(handler: (event: SidebarSearchEvent) => void): void;
+    private attachEventListeners;
+    private findItem;
+}
+/** Create a sidebar with platform-appropriate defaults */
+export declare function createSidebar(config?: SidebarConfig): Sidebar;
+/** Create a file-browser style sidebar (Finder/Explorer) */
+export declare function createFileSidebar(sections?: SidebarSection[]): Sidebar;
+/** Create a settings/preferences style sidebar */
+export declare function createSettingsSidebar(items: SidebarItem[]): Sidebar;
+export declare const sidebar: {
+    create: typeof createSidebar;
+    file: typeof createFileSidebar;
+    settings: typeof createSettingsSidebar;
+    Sidebar: typeof Sidebar;
+};
+export default sidebar;
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/api/sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/api/sidebar.ts"],"names":[],"mappings":"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"}