craft-native 0.0.55 → 0.0.74

package/dist/api/index.d.ts

@@ -2,37 +2,40 @@
  * Craft API Modules
  * Native APIs available in Craft applications
  */
-export { windowManager, win, window, createWindow, Window } from './window';
-export type { WindowPosition, WindowSize, WindowBounds, WindowState, WindowCreateOptions, WindowEventType, WindowEventMap, WindowEventHandler } from './window';
-export { trayManager, tray, SystemTray, MenubarApp, createMenubarApp, buildMenu, separator, menuItem, checkbox, submenu } from './tray';
-export type { MenuItem, TrayClickEvent, TrayOptions, MenubarAppConfig, TrayEventType, TrayEventMap, TrayEventHandler } from './tray';
-export { appManager, app, quit, hide, show, focus, hideDockIcon, showDockIcon, setBadge, getInfo, getVersion, getName, getPath, isDarkMode, getLocale, notify, registerShortcut, unregisterShortcut } from './app';
-export type { AppInfo, SystemPreferences, DisplayInfo, BadgeOptions, NotificationOptions, AppEventType, AppEventMap, AppEventHandler, ShortcutHandler } from './app';
-export { fs, readBinaryFile, writeBinaryFile, stat, copy, move, watch } from './fs';
-export type { FileStats } from './fs';
-export { db, openDatabase, Database, KeyValueStore } from './db';
-export type { ExecuteResult, TableColumn } from './db';
-export { http, HttpClient, WebSocketClient, createClient, HttpError } from './http';
-export type { HttpClientOptions, RequestOptions, HttpResponse, WebSocketOptions } from './http';
-export { crypto, uuid, randomString, hmac, timingSafeEqual, hashPassword, verifyPassword } from './crypto';
-export { env, getPlatform, isDesktop, isMobile, isCraft, getSystemInfo, exec, spawn, ChildProcess, cwd, homeDir, tempDir, exit, argv, open } from './process';
-export type { Platform, SystemInfo, ExecOptions, ExecResult, SpawnOptions } from './process';
-export { device, haptics, permissions, camera, biometrics, secureStorage, location, share, lifecycle, notifications, notifications as notification } from './mobile';
-export type { DeviceInfo, DeviceCapabilities, HapticStyle, HapticNotificationType, PermissionType, PermissionStatus, CameraOptions as MobileCameraOptions, PhotoResult, BiometricType, Location, LocationOptions, ShareOptions, AppState, NotificationOptions as MobileNotificationOptions } from './mobile';
-export { carplay, appClips, liveActivities, sharePlay, storeKit, appIntents, tipKit, focusFilters } from './ios-advanced';
-export type { CarPlayTemplateType, CarPlayListItem, CarPlayGridItem, CarPlayTemplate, AppClipInvocation, LiveActivityContentState, LiveActivityAttributes, LiveActivityConfig, SharePlaySessionState, SharePlayParticipant, SharePlayActivity, ProductType, Product, Transaction, IntentParameterType, IntentParameter, AppIntent, TipDisplayFrequency, Tip, FocusStatus, FocusFilter } from './ios-advanced';
-export { materialYou, photoPicker, workManager, foregroundService, predictiveBack, appLanguage, widgets as androidWidgets, playBilling } from './android-advanced';
-export type { MaterialYouColors, PhotoPickerMediaType, PhotoPickerResult, WorkConstraints, WorkRequest, WorkInfo, ForegroundServiceType, ForegroundNotification, BackEvent, WidgetSizeClass, WidgetConfig, WidgetData, PlayProduct, PlayPurchase } from './android-advanced';
-export { touchBar, desktopWidgets, stageManager, handoff, sidecar, spotlight, quickActions, shareExtension, windowManagement } from './macos-advanced';
-export type { TouchBarItemType, TouchBarButton, TouchBarLabel, TouchBarSlider, TouchBarColorPicker, TouchBarScrubber, TouchBarSegmentedControl, TouchBarPopover, TouchBarSpacer, TouchBarGroup, TouchBarItem, WidgetFamily, WidgetTimelineEntry, WidgetConfiguration, UserActivity, SidecarDevice, SpotlightItem, QuickAction, WindowTabGroup } from './macos-advanced';
-export { jumpList, taskbarProgress, toastNotifications, windowsHello, windowsWidgets, msixUpdate, shareTarget, startupTask, secondaryTiles } from './windows-advanced';
-export type { JumpListTask, JumpListCategory, TaskbarProgressState, ToastAction, ToastInput, ToastContent, WindowsHelloAvailability, WidgetTemplateType, WindowsWidgetContent, PackageVersion, UpdateInfo, SharedDataItem, SecondaryTile } from './windows-advanced';
-export { dialog, openFile, openFolder, saveFile, showAlert, showConfirm, showPrompt } from './dialog';
-export type { FileFilter, OpenDialogOptions, SaveDialogOptions, AlertStyle, AlertOptions, ConfirmOptions, OpenDialogResult, SaveDialogResult } from './dialog';
-export { clipboard, writeText, readText, writeHTML, readHTML } from './clipboard';
-export type { ClipboardFormat, ClipboardData } from './clipboard';
-export { media } from './media';
-export type { MediaDeviceInfo, CameraOptions as MediaCameraOptions, MicrophoneOptions, MediaStreamOptions } from './media';
-export { Sidebar, createSidebar, createFileSidebar, createSettingsSidebar, sidebar } from './sidebar';
-export type { SidebarItem, SidebarSection, SidebarConfig, MacOSSidebarConfig, WindowsSidebarConfig, LinuxSidebarConfig, SidebarSelectEvent, SidebarSearchEvent } from './sidebar';
-//# sourceMappingURL=index.d.ts.map
+export { windowManager, win, window, createWindow, Window } from './window.js';
+export type { WindowPosition, WindowSize, WindowBounds, WindowState, WindowCreateOptions, WindowEventType, WindowEventMap, WindowEventHandler } from './window.js';
+export { trayManager, tray, SystemTray, MenubarApp, createMenubarApp, buildMenu, separator, menuItem, checkbox, submenu } from './tray.js';
+export type { MenuItem, TrayClickEvent, TrayOptions, MenubarAppConfig, TrayEventType, TrayEventMap, TrayEventHandler } from './tray.js';
+export { appManager, app, quit, hide, show, focus, hideDockIcon, showDockIcon, setBadge, getInfo, getVersion, getName, getPath, isDarkMode, getLocale, notify, registerShortcut, unregisterShortcut } from './app.js';
+export type { AppInfo, SystemPreferences, DisplayInfo, BadgeOptions, NotificationOptions, AppEventType, AppEventMap, AppEventHandler, ShortcutHandler } from './app.js';
+export { fs, readBinaryFile, writeBinaryFile, stat, copy, move, watch } from './fs.js';
+export type { FileStats } from './fs.js';
+export { db, openDatabase, Database, KeyValueStore } from './db.js';
+export type { ExecuteResult, TableColumn } from './db.js';
+export { http, HttpClient, WebSocketClient, createClient, HttpError } from './http.js';
+export type { HttpClientOptions, RequestOptions, HttpResponse, WebSocketOptions } from './http.js';
+export { crypto, uuid, randomString, hmac, timingSafeEqual, hashPassword, verifyPassword } from './crypto.js';
+export { env, getPlatform, isDesktop, isMobile, isCraft, getSystemInfo, exec, spawn, ChildProcess, cwd, homeDir, tempDir, exit, argv, open } from './process.js';
+export type { Platform, SystemInfo, ExecOptions, ExecResult, SpawnOptions } from './process.js';
+export { device, haptics, permissions, camera, biometrics, secureStorage, location, share, lifecycle, notifications, notifications as notification } from './mobile.js';
+export type { DeviceInfo, DeviceCapabilities, HapticStyle, HapticNotificationType, PermissionType, PermissionStatus, CameraOptions as MobileCameraOptions, PhotoResult, BiometricType, Location, LocationOptions, ShareOptions, AppState, NotificationOptions as MobileNotificationOptions } from './mobile.js';
+export { carplay, appClips, liveActivities, sharePlay, storeKit, appIntents, tipKit, focusFilters } from './ios-advanced.js';
+export type { CarPlayTemplateType, CarPlayListItem, CarPlayGridItem, CarPlayTemplate, AppClipInvocation, LiveActivityContentState, LiveActivityAttributes, LiveActivityConfig, SharePlaySessionState, SharePlayParticipant, SharePlayActivity, ProductType, Product, Transaction, IntentParameterType, IntentParameter, AppIntent, TipDisplayFrequency, Tip, FocusStatus, FocusFilter } from './ios-advanced.js';
+export { materialYou, photoPicker, workManager, foregroundService, predictiveBack, appLanguage, widgets as androidWidgets, playBilling } from './android-advanced.js';
+export type { MaterialYouColors, PhotoPickerMediaType, PhotoPickerResult, WorkConstraints, WorkRequest, WorkInfo, ForegroundServiceType, ForegroundNotification, BackEvent, WidgetSizeClass, WidgetConfig, WidgetData, PlayProduct, PlayPurchase } from './android-advanced.js';
+export { touchBar, desktopWidgets, stageManager, handoff, sidecar, spotlight, quickActions, shareExtension, windowManagement } from './macos-advanced.js';
+export type { TouchBarItemType, TouchBarButton, TouchBarLabel, TouchBarSlider, TouchBarColorPicker, TouchBarScrubber, TouchBarSegmentedControl, TouchBarPopover, TouchBarSpacer, TouchBarGroup, TouchBarItem, WidgetFamily, WidgetTimelineEntry, WidgetConfiguration, UserActivity, SidecarDevice, SpotlightItem, QuickAction, WindowTabGroup } from './macos-advanced.js';
+export { jumpList, taskbarProgress, toastNotifications, windowsHello, windowsWidgets, msixUpdate, shareTarget, startupTask, secondaryTiles } from './windows-advanced.js';
+export type { JumpListTask, JumpListCategory, TaskbarProgressState, ToastAction, ToastInput, ToastContent, WindowsHelloAvailability, WidgetTemplateType, WindowsWidgetContent, PackageVersion, UpdateInfo, SharedDataItem, SecondaryTile } from './windows-advanced.js';
+export { dialog, openFile, openFolder, saveFile, showAlert, showConfirm, showPrompt } from './dialog.js';
+export type { FileFilter, OpenDialogOptions, SaveDialogOptions, AlertStyle, AlertOptions, ConfirmOptions, OpenDialogResult, SaveDialogResult } from './dialog.js';
+export { clipboard, writeText, readText, writeHTML, readHTML } from './clipboard.js';
+export type { ClipboardFormat, ClipboardData } from './clipboard.js';
+export { media } from './media.js';
+export type { MediaDeviceInfo, CameraOptions as MediaCameraOptions, MicrophoneOptions, MediaStreamOptions } from './media.js';
+export { Sidebar, createSidebar, createFileSidebar, createSettingsSidebar, sidebar } from './sidebar.js';
+export type { SidebarItem, SidebarSection, SidebarConfig, MacOSSidebarConfig, WindowsSidebarConfig, LinuxSidebarConfig, SidebarSelectEvent, SidebarSearchEvent } from './sidebar.js';
+export { spaces, createSpacesSidebar, hasNativeSpaces } from './spaces.js';
+export type { SpaceDescriptor, SpacesSidebarOptions, SpacesSidebarHandle, NativeUIAPI } from './spaces.js';
+export { gestures, onSwipe, hasNativeGestures } from './gestures.js';
+export type { SwipeAxis, SwipePhase, SwipeEvent, SwipeListener, Unsubscribe } from './gestures.js';

package/dist/api/ios-advanced.d.ts

@@ -271,7 +271,7 @@ export declare const liveActivities: {
     /**
      * End a Live Activity.
      */
-    end(activityId: string, finalContentState?: LiveActivityContentState, dismissalPolicy?: "immediate" | "default" | "after"): Promise<void>;
+    end(activityId: string, finalContentState?: LiveActivityContentState, dismissalPolicy?: 'immediate' | 'default' | 'after'): Promise<void>;
     /**
      * Get all active Live Activities.
      */
@@ -503,11 +503,11 @@ export declare const storeKit: {
      * Get subscription status.
      */
     getSubscriptionStatus(groupId: string): Promise<{
-        state: "subscribed" | "expired" | "inBillingRetry" | "inGracePeriod" | "revoked";
+        state: 'subscribed' | 'expired' | 'inBillingRetry' | 'inGracePeriod' | 'revoked';
         renewalInfo?: {
             willAutoRenew: boolean;
             autoRenewProductId: string;
-            expirationIntent?: "cancelled" | "billingError" | "priceIncrease" | "productNotAvailable";
+            expirationIntent?: 'cancelled' | 'billingError' | 'priceIncrease' | 'productNotAvailable';
         };
     } | null>;
     /**
@@ -521,7 +521,7 @@ export declare const storeKit: {
     /**
      * Present refund request sheet.
      */
-    beginRefundRequest(transactionId: string): Promise<"success" | "userCancelled" | "failed">;
+    beginRefundRequest(transactionId: string): Promise<'success' | 'userCancelled' | 'failed'>;
     /**
      * Listen for transaction updates.
      */
@@ -706,7 +706,7 @@ export declare const tipKit: {
      */
     configure(options: {
         displayFrequency?: TipDisplayFrequency;
-        datastoreLocation?: "applicationDefault" | "groupContainer";
+        datastoreLocation?: 'applicationDefault' | 'groupContainer';
     }): Promise<void>;
     /**
      * Register a tip.
@@ -793,7 +793,7 @@ export declare const focusFilters: {
     /**
      * Check Focus authorization status.
      */
-    getAuthorizationStatus(): Promise<"notDetermined" | "denied" | "authorized">;
+    getAuthorizationStatus(): Promise<'notDetermined' | 'denied' | 'authorized'>;
     /**
      * Request Focus authorization.
      */
@@ -830,4 +830,3 @@ declare const iosAdvanced: {
     focusFilters: typeof focusFilters;
 };
 export default iosAdvanced;
-//# sourceMappingURL=ios-advanced.d.ts.map

package/dist/api/macos-advanced.d.ts

@@ -240,7 +240,7 @@ export declare const desktopWidgets: {
     }) => Promise<{
         entries: WidgetTimelineEntry[];
         policy: {
-            type: "atEnd" | "never" | "after";
+            type: 'atEnd' | 'never' | 'after';
             date?: Date;
         };
     }>): void;
@@ -590,7 +590,7 @@ export declare const shareExtension: {
      * Handle receiving shared items.
      */
     onReceive(handler: (items: Array<{
-        type: "text" | "url" | "image" | "file";
+        type: 'text' | 'url' | 'image' | 'file';
         text?: string;
         url?: string;
         filePath?: string;
@@ -718,4 +718,3 @@ declare const macosAdvanced: {
     windowManagement: typeof windowManagement;
 };
 export default macosAdvanced;
-//# sourceMappingURL=macos-advanced.d.ts.map

package/dist/api/media.d.ts

@@ -230,4 +230,3 @@ export declare const media: {
     _buildAudioConstraints(options: MicrophoneOptions): MediaTrackConstraints;
 };
 export default media;
-//# sourceMappingURL=media.d.ts.map

package/dist/api/mobile.d.ts

@@ -86,6 +86,8 @@ export interface DeviceCapabilities {
     bluetooth: boolean;
     /** Has GPS */
     gps: boolean;
+    /** Can continue location recording in the background */
+    backgroundLocation?: boolean;
     /** Has accelerometer */
     accelerometer: boolean;
     /** Has gyroscope */
@@ -459,6 +461,16 @@ export interface LocationOptions {
     /** Maximum age of cached position in milliseconds */
     maximumAge?: number;
 }
+export interface LocationRecordingState {
+    id: string | null;
+    active: boolean;
+    paused: boolean;
+    startedAt: number | null;
+    sampleCount?: number;
+}
+export interface LocationRecordingResult extends LocationRecordingState {
+    locations: Location[];
+}
 /**
  * Location API.
  *
@@ -499,6 +511,12 @@ export declare const location: {
      * @param watchId - Watch ID returned from watchPosition
      */
     clearWatch(watchId: number): void;
+    startRecording(options?: LocationOptions): Promise<LocationRecordingState>;
+    pauseRecording(): Promise<LocationRecordingState>;
+    resumeRecording(): Promise<LocationRecordingState>;
+    stopRecording(): Promise<LocationRecordingResult>;
+    getRecordingState(): Promise<LocationRecordingState>;
+    readRecording(): Promise<Location[]>;
 };
 /**
  * Share options.
@@ -642,6 +660,89 @@ export declare const notifications: {
      */
     setBadge(count: number): Promise<void>;
 };
+export interface NetworkStatus {
+    type: 'wifi' | 'cellular' | 'ethernet' | 'none' | 'unknown';
+    isConnected: boolean;
+}
+export declare const keepAwake: {
+    enable(): Promise<void>;
+    disable(): Promise<void>;
+};
+export declare const deepLinks: {
+    getInitialURL(): Promise<string | null>;
+    onLink(callback: (url: string) => void): () => void;
+};
+export declare function normalizeDeepLinkURL(value: unknown): string | null;
+export declare const network: {
+    getStatus(): Promise<NetworkStatus>;
+    onChange(callback: (status: NetworkStatus) => void): () => void;
+};
+export declare const appReview: {
+    request(): Promise<boolean>;
+};
+export declare const pushNotifications: {
+    register(): Promise<string>;
+    onToken(callback: (token: string) => void): () => void;
+    onNotification(callback: (data: Record<string, unknown>) => void): () => void;
+};
+export type HealthDataType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts';
+export interface HealthDataOptions {
+    startDate?: number;
+    endDate?: number;
+}
+export interface HealthDataResult {
+    value: number;
+    unit: string;
+}
+export type HealthWorkoutType = 'running' | 'walking' | 'hiking' | 'cycling';
+export interface HealthWorkoutLocation {
+    latitude: number;
+    longitude: number;
+    altitude?: number;
+    accuracy?: number;
+    timestamp: number;
+}
+export interface HealthWorkout {
+    activityId: string;
+    type: HealthWorkoutType;
+    startDate: number;
+    endDate: number;
+    distanceMeters?: number;
+    activeEnergyCalories?: number;
+    locations?: HealthWorkoutLocation[];
+}
+export interface HealthWorkoutResult {
+    id: string;
+}
+export declare const health: {
+    requestAuthorization(types: HealthDataType[]): Promise<boolean>;
+    getData(type: HealthDataType, options?: HealthDataOptions): Promise<HealthDataResult>;
+    saveWorkout(workout: HealthWorkout): Promise<HealthWorkoutResult>;
+};
+export interface LiveActivityState {
+    status?: string;
+    distanceMeters?: number;
+    durationSeconds?: number;
+    progress?: number;
+}
+export interface LiveActivityOptions extends LiveActivityState {
+    activityId: string;
+    title: string;
+}
+export declare const liveActivities: {
+    start(options: LiveActivityOptions): Promise<{
+        id: string;
+    }>;
+    update(state: LiveActivityState): Promise<void>;
+    end(): Promise<void>;
+};
+export declare const watchConnectivity: {
+    send(message: Record<string, unknown>): Promise<Record<string, unknown>>;
+    updateContext(context: Record<string, unknown>): Promise<void>;
+    isReachable(): Promise<boolean>;
+    onMessage(callback: (message: Record<string, unknown>) => void): () => void;
+    onReachabilityChange(callback: (reachable: boolean) => void): () => void;
+};
 declare const mobile: {
     device: typeof device;
     haptics: typeof haptics;
@@ -653,6 +754,13 @@ declare const mobile: {
     share: typeof share;
     lifecycle: typeof lifecycle;
     notifications: typeof notifications;
+    keepAwake: typeof keepAwake;
+    deepLinks: typeof deepLinks;
+    network: typeof network;
+    appReview: typeof appReview;
+    pushNotifications: typeof pushNotifications;
+    health: typeof health;
+    liveActivities: typeof liveActivities;
+    watchConnectivity: typeof watchConnectivity;
 };
 export default mobile;
-//# sourceMappingURL=mobile.d.ts.map

package/dist/api/process.d.ts

@@ -165,4 +165,3 @@ declare const processApi: {
     open: typeof open;
 };
 export default processApi;
-//# sourceMappingURL=process.d.ts.map

package/dist/api/sidebar.d.ts

@@ -4,25 +4,9 @@
  * 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 type { SidebarItem, SidebarSection } from '../sidebar-types.js';
+export { isSidebarItemDisabled } from '../sidebar-types.js';
+import type { SidebarItem, SidebarSection } from '../sidebar-types.js';
 export interface SidebarConfig {
     /** Sidebar width in pixels */
     width?: number;
@@ -122,4 +106,3 @@ export declare const sidebar: {
     Sidebar: typeof Sidebar;
 };
 export default sidebar;
-//# sourceMappingURL=sidebar.d.ts.map

package/dist/api/spaces.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Native switcher for Arc-style sidebar spaces
+ * @description Publishes a space list to a real control in the window chrome —
+ * an NSSegmentedControl in the titlebar on macOS — and reports back what the
+ * user picks.
+ *
+ * This is a *switcher*, not a second sidebar. The spaces, their rows and the
+ * swipe stay in the webview (see `@stacksjs/components`' `<Sidebar :spaces>`);
+ * only the chrome control is native. That is also why it does not collide with
+ * `api/sidebar`'s one-native-sidebar-per-window rule: a window can have both.
+ * @module @craft-native/api/spaces
+ */
+export interface SpaceDescriptor {
+    /** Stable id. Also what comes back from `onSpaceChange`. */
+    id: string;
+    /** Shown on the native control. Falls back to `id`. */
+    label?: string;
+    /** SF Symbol name, where the host can render one. */
+    icon?: string;
+    /**
+     * Accent colour as `#rrggbb`. The host tints the selected segment with it so
+     * the window chrome agrees with the pane instead of staying neutral grey
+     * while the sidebar is deep blue.
+     */
+    tint?: string;
+}
+export interface SpacesSidebarOptions {
+    /** Supply one to keep a stable id across reloads; generated otherwise. */
+    id?: string;
+    /**
+     * Fewer than two and the native control stays hidden — one space renders as a
+     * single selected segment naming the space the user is already in. It is
+     * hidden rather than destroyed, so a later `setSpaces` with two or more
+     * brings it straight back.
+     */
+    spaces?: SpaceDescriptor[];
+    /** Which space opens selected. Defaults to the first. */
+    activeSpace?: string;
+}
+export interface SpacesSidebarHandle {
+    readonly id: string;
+    /** Fires when the user picks a space in the native control. */
+    onSpaceChange: (listener: (spaceId: string) => void) => SpacesSidebarHandle;
+    /**
+     * Replace the list. The active space is preserved **by id** when it survives
+     * the replacement, so reordering or inserting does not silently move the user
+     * to a different space.
+     */
+    setSpaces: (spaces: SpaceDescriptor[]) => SpacesSidebarHandle;
+    /** Follow a switch that happened in the webview, e.g. a swipe. */
+    setActiveSpace: (spaceId: string) => SpacesSidebarHandle;
+    destroy: () => void;
+}
+export interface NativeUIAPI {
+    createSpacesSidebar?: (options?: SpacesSidebarOptions) => SpacesSidebarHandle;
+}
+/**
+ * Whether this host can put a native space switcher in the window chrome.
+ *
+ * Unlike `hasNativeGestures`, this one is meaningful: `createSpacesSidebar` is
+ * only defined where the native UI bridge exists, so a `false` here really does
+ * mean the web rail should render itself.
+ */
+export declare function hasNativeSpaces(): boolean;
+/**
+ * Create the native switcher, or return `null` in a plain browser so callers
+ * can fall back to their own rail without a try/catch.
+ *
+ * @example
+ * ```ts
+ * const switcher = createSpacesSidebar({
+ *   spaces: profiles.map(p => ({ id: p.id, label: p.name, tint: p.tint })),
+ *   activeSpace: active.id,
+ * })
+ * switcher?.onSpaceChange(id => goToProfile(id))
+ * ```
+ */
+export declare function createSpacesSidebar(options?: SpacesSidebarOptions): SpacesSidebarHandle | null;
+/** Namespace form, for `import { spaces } from 'craft-native'`. */
+export declare const spaces: {
+    hasNativeSpaces: () => boolean;
+    createSpacesSidebar: (options?: SpacesSidebarOptions) => SpacesSidebarHandle | null;
+};

package/dist/api/tray.d.ts

@@ -368,9 +368,9 @@ declare class TrayManager {
     /** Register menu action on main tray */
     onMenuAction: (actionId: string, handler: () => void) => (() => void);
     /** Register click handler on main tray */
-    onClick: (handler: TrayEventHandler<"click">) => (() => void);
+    onClick: (handler: TrayEventHandler<'click'>) => (() => void);
     /** Register right-click handler on main tray */
-    onRightClick: (handler: TrayEventHandler<"right-click">) => (() => void);
+    onRightClick: (handler: TrayEventHandler<'right-click'>) => (() => void);
     /** Toggle window on click */
     onClickToggleWindow: () => (() => void);
 }
@@ -407,4 +407,3 @@ export declare function checkbox(label: string, checked: boolean, options?: Omit
  */
 export declare function submenu(label: string, items: MenuItem[], options?: Omit<MenuItem, 'label' | 'type' | 'submenu'>): MenuItem;
 export default trayManager;
-//# sourceMappingURL=tray.d.ts.map

package/dist/api/window.d.ts

@@ -447,7 +447,7 @@ declare class WindowManager {
     /** Set current window background color */
     setBackgroundColor: (color: string) => Promise<void>;
     /** Set current window vibrancy (macOS) */
-    setVibrancy: (vibrancy: WindowCreateOptions["vibrancy"] | null) => Promise<void>;
+    setVibrancy: (vibrancy: WindowCreateOptions['vibrancy'] | null) => Promise<void>;
     /** Set current window resizable */
     setResizable: (resizable: boolean) => Promise<void>;
     /** Start moving current window from a native pointer event */
@@ -477,4 +477,3 @@ export declare const window: WindowManager;
 export declare function createWindow(_options?: WindowCreateOptions): Promise<Window>;
 export declare function createWindow(_html: string, _options?: WindowCreateOptions): Promise<Window>;
 export default windowManager;
-//# sourceMappingURL=window.d.ts.map

package/dist/api/windows-advanced.d.ts

@@ -133,7 +133,7 @@ export declare const taskbarProgress: {
     flash(options?: {
         count?: number;
         interval?: number;
-        flags?: "all" | "caption" | "tray";
+        flags?: 'all' | 'caption' | 'tray';
     }): Promise<void>;
     /**
      * Stop flashing.
@@ -310,7 +310,7 @@ export declare const toastNotifications: {
      */
     onDismissed(handler: (args: {
         tag?: string;
-        reason: "user" | "application" | "timeout";
+        reason: 'user' | 'application' | 'timeout';
     }) => void): void;
 };
 /**
@@ -354,7 +354,7 @@ export declare const windowsHello: {
      */
     authenticate(message: string): Promise<{
         success: boolean;
-        error?: "canceled" | "notConfigured" | "notAllowed" | "unknown";
+        error?: 'canceled' | 'notConfigured' | 'notAllowed' | 'unknown';
     }>;
     /**
      * Create a Windows Hello credential.
@@ -610,11 +610,11 @@ export declare const startupTask: {
     /**
      * Get current startup state.
      */
-    getState(): Promise<"disabled" | "disabledByUser" | "enabled" | "disabledByPolicy" | "enabledByPolicy">;
+    getState(): Promise<'disabled' | 'disabledByUser' | 'enabled' | 'disabledByPolicy' | 'enabledByPolicy'>;
     /**
      * Request enabling startup.
      */
-    request(): Promise<"disabled" | "disabledByUser" | "enabled" | "disabledByPolicy" | "enabledByPolicy">;
+    request(): Promise<'disabled' | 'disabledByUser' | 'enabled' | 'disabledByPolicy' | 'enabledByPolicy'>;
     /**
      * Disable startup.
      */
@@ -694,7 +694,7 @@ export declare const secondaryTiles: {
     /**
      * Update tile badge.
      */
-    updateBadge(tileId: string, value: number | "none" | "activity" | "alert" | "attention" | "available" | "away" | "busy" | "newMessage" | "paused" | "playing" | "unavailable" | "error"): Promise<void>;
+    updateBadge(tileId: string, value: number | 'none' | 'activity' | 'alert' | 'attention' | 'available' | 'away' | 'busy' | 'newMessage' | 'paused' | 'playing' | 'unavailable' | 'error'): Promise<void>;
     /**
      * Clear tile notification.
      */
@@ -716,4 +716,3 @@ declare const windowsAdvanced: {
     secondaryTiles: typeof secondaryTiles;
 };
 export default windowsAdvanced;
-//# sourceMappingURL=windows-advanced.d.ts.map

package/dist/assets/index.d.ts

@@ -66,4 +66,3 @@ export declare class AssetOptimizer {
 }
 export declare function assetsCommand(args: string[]): Promise<void>;
 export default AssetOptimizer;
-//# sourceMappingURL=index.d.ts.map

package/dist/binary-resolver.d.ts

@@ -30,10 +30,32 @@
  *   `process.env.CRAFT_BIN`, or the bare `'craft'` for PATH lookup.
  */
 export declare function resolveCraftBinary(explicit?: string): string;
+/**
+ * Set on the child environment whenever the CLI spawns what it believes is
+ * the native binary.
+ *
+ * `resolveCraftBinary()` returns the bare string `'craft'` and lets the OS
+ * resolve it, which is the pantry contract and stays that way. But `craft` on
+ * PATH is not always the native binary: install the SDK with a package manager
+ * that publishes a `bin` entry and PATH may resolve `craft` to this very CLI
+ * (`~/.bun/bin/craft`, a `#!/usr/bin/env bun` script). Spawning that re-enters
+ * the TypeScript entry point with native-binary flags, and the user sees
+ * `Unknown option --url` for an option they never typed.
+ *
+ * Probing for the binary elsewhere would answer it, but that is exactly the
+ * path-matrix behaviour the pantry contract exists to remove. So instead the
+ * spawn is marked, and a CLI that starts up already marked knows it *is* the
+ * thing that was spawned, and says so.
+ */
+export declare const CRAFT_CLI_SPAWN_MARKER = "CRAFT_CLI_SPAWNED_FROM";
+/**
+ * The message for that case. Names the offending PATH entry, because the whole
+ * difficulty of the original report was that nothing pointed at PATH at all.
+ */
+export declare function craftBinaryIsCliShimMessage(spawnedFrom: string): string;
 /**
  * Build a deterministic, pantry-aware error for the case where the
  * spawn errored with ENOENT (binary not found on PATH). Used as the
  * `process.on('error', …)` handler in both the SDK and the CLI.
  */
 export declare function craftBinaryNotFoundMessage(triedPath: string): string;
-//# sourceMappingURL=binary-resolver.d.ts.map

package/dist/bridge/android.d.ts

@@ -571,4 +571,3 @@ export declare const android: {
     NativeComponents: AndroidNativeComponents;
 };
 export default android;
-//# sourceMappingURL=android.d.ts.map

package/dist/bridge/core.d.ts

@@ -230,40 +230,6 @@ export interface BridgeMethod<P = void, R = void> {
 export type InferParams<T> = T extends BridgeMethod<infer P, unknown> ? P : never;
 export type InferResult<T> = T extends BridgeMethod<unknown, infer R> ? R : never;
 export declare function createTypedBridge<T extends Record<string, BridgeMethod<any, any>>>(bridge: NativeBridge): { [K in keyof T]: (params: InferParams<T[K]>) => Promise<InferResult<T[K]>>; };
-export interface MenuItem {
-    id: string;
-    label: string;
-    accelerator?: string;
-    type?: 'normal' | 'separator' | 'checkbox' | 'radio';
-    checked?: boolean;
-    enabled?: boolean;
-    visible?: boolean;
-    icon?: string;
-    submenu?: MenuItem[];
-}
-export declare class NativeMenus {
-    private bridge;
-    constructor(bridge: NativeBridge);
-    /**
-     * Set application menu
-     */
-    setApplicationMenu(menu: MenuItem[]): Promise<void>;
-    /**
-     * Show context menu
-     */
-    showContextMenu(menu: MenuItem[], position?: {
-        x: number;
-        y: number;
-    }): Promise<string | null>;
-    /**
-     * Update menu item
-     */
-    updateMenuItem(id: string, updates: Partial<MenuItem>): Promise<void>;
-    /**
-     * Listen for menu item clicks
-     */
-    onMenuClick(callback: (id: string) => void): () => void;
-}
 export interface OpenDialogOptions {
     title?: string;
     defaultPath?: string;
@@ -455,7 +421,6 @@ export declare function createBridge(config?: BridgeConfig): NativeBridge;
  * created any pending work.
  */
 export declare function resetGlobalBridge(): void;
-export declare function getMenus(): NativeMenus;
 export declare function getDialogs(): NativeDialogs;
 export declare function getComponents(): NativeComponentBridge;
 declare const bridgeCore: {
@@ -463,14 +428,11 @@ declare const bridgeCore: {
     BridgeError: typeof BridgeError;
     BridgeErrorCodes: typeof BridgeErrorCodes;
     createTypedBridge: typeof createTypedBridge;
-    NativeMenus: typeof NativeMenus;
     NativeDialogs: typeof NativeDialogs;
     NativeComponentBridge: typeof NativeComponentBridge;
     getBridge: typeof getBridge;
     createBridge: typeof createBridge;
-    getMenus: typeof getMenus;
     getDialogs: typeof getDialogs;
     getComponents: typeof getComponents;
 };
 export default bridgeCore;
-//# sourceMappingURL=core.d.ts.map

package/dist/bridge/ids.d.ts

@@ -15,4 +15,3 @@ export declare function secureUUID(): string;
  * Returns a prefixed, secure ID, e.g. `webview_3f7a…`.
  */
 export declare function secureId(prefix: string): string;
-//# sourceMappingURL=ids.d.ts.map

package/dist/bridge/ios.d.ts

@@ -525,4 +525,3 @@ export declare const ios: {
     AppLifecycle: IOSAppLifecycle;
 };
 export default ios;
-//# sourceMappingURL=ios.d.ts.map

package/dist/bridge/webkit-pending.d.ts

@@ -47,4 +47,3 @@ export declare function webkitRequest<T>(bucket: string, message: unknown, optio
  * error. Used by the test suite to assert that we don't leak closures.
  */
 export declare function _drainPendingForTests(error?: Error): number;
-//# sourceMappingURL=webkit-pending.d.ts.map