craft-native 0.0.112 → 0.0.115

package/dist/types.d.ts

@@ -32,7 +32,7 @@
  * Windows Hello        |   -   |   -   |    ✓    |  -  |    -
  * Toast Notifications  |   -   |   -   |    ✓    |  -  |    -
  * Biometrics           |   -   |   -   |    -    |  ✓  |    ✓
- * Haptic Feedback      |   -   |   -   |    -    |  ✓  |    ✓
+ * Haptic Feedback      |   ✓   |   -   |    -    |  ✓  |    ✓
  * Secure Storage       |   -   |   -   |    -    |  ✓  |    ✓
  * Location             |   -   |   -   |    -    |  ✓  |    ✓
  * Share Sheet          |   -   |   -   |    -    |  ✓  |    ✓
@@ -45,6 +45,10 @@
  * Work Manager         |   -   |   -   |    -    |  -  |    ✓
  * Predictive Back      |   -   |   -   |    -    |  -  |    ✓
  *
+ * Haptic Feedback on macOS is the Force Touch trackpad (NSHapticFeedbackManager):
+ * the same `haptics.*` calls, played only while a finger is on the trackpad and
+ * the app is active. Linux and Windows have no haptics API to call.
+ *
  * Mobile-only bridge APIs (window.craft, defined in types/craft.d.ts):
  *   AR (ARKit/ARCore), ML (Core ML/ML Kit), Deep Links, OTA Updates,
  *   Widgets, Auth Persistence, Contacts, Calendar, Health/Fitness,
@@ -1204,6 +1208,22 @@ export interface CraftBridgeAPI {
      * Screen-sharing and screen-recording detection (macOS)
      */
     screenSharing?: CraftScreenSharingAPI;
+    /**
+     * Trigger one haptic tap on a Force Touch trackpad (macOS), as
+     * `window.craft.haptic` does on iOS and Android.
+     *
+     * Resolves `true` once AppKit has taken the call, which is not a promise
+     * anything was felt: AppKit plays feedback only while a finger is on the
+     * trackpad and the app is active. Rejects `PLATFORM_NOT_SUPPORTED` on Linux
+     * and Windows.
+     */
+    haptic?: (style?: string) => Promise<boolean>;
+    /**
+     * Haptic feedback with the shape the mobile bridges give it (macOS: Force
+     * Touch trackpad). Use `haptics` from `craft-native` rather than this
+     * directly. See `CraftHapticsAPI`.
+     */
+    haptics?: CraftHapticsAPI;
     /**
      * System-wide hotkeys (macOS).
      *
@@ -1547,6 +1567,25 @@ export interface ScreenSharingState {
     };
     sources: ScreenSharingSource[];
 }
+/**
+ * `window.craft.haptics` in a desktop window.
+ *
+ * Feedback, not a capability check: on a host with nothing to play (Linux,
+ * Windows) every method resolves without doing anything, as the mobile
+ * bridges do for an app built without haptics. Use `craft.haptic()` to find
+ * out instead.
+ *
+ * A trackpad has three patterns, not the phone's range, so styles are folded:
+ * `selection` plays Alignment, `heavy` and `error` play LevelChange, and
+ * everything else plays Generic.
+ */
+export interface CraftHapticsAPI {
+    impact(style?: string): Promise<void>;
+    notification(type?: 'success' | 'warning' | 'error'): Promise<void>;
+    selection(): Promise<void>;
+    /** One tap if the pattern fires at all: a trackpad tap has no duration. */
+    vibrate(pattern?: number[]): Promise<void>;
+}
 /**
  * Screen-sharing detection. Matches the sharing *indicator* a conferencing app
  * shows while a share is live, never the mere presence of the app — see
@@ -1604,6 +1643,47 @@ export interface CraftFileSystemAPI {
      * @param path - Path to check
      */
     exists(path: string): Promise<boolean>;
+    /**
+     * Watch a file or directory (desktop bridge). Resolves once native has
+     * registered the watch; `callback` hears the `craft:fs:change` events for
+     * this watch only. On macOS each watch is an FSEvents stream; it lasts
+     * until `unwatch`, until the page navigates, or until its window is
+     * destroyed, and the path must exist (`NOT_FOUND` otherwise). Rejects with
+     * `PLATFORM_NOT_SUPPORTED` on Linux and Windows.
+     * @param path - Path to watch
+     * @param callback - Called with each change to this watch
+     * @param options - `recursive` defaults to false
+     */
+    watch?: (path: string, callback?: (event: CraftFsWatchEvent) => void, options?: {
+        recursive?: boolean;
+    }) => Promise<CraftFsWatchHandle>;
+    /**
+     * Stop a watch by its id. The same as the handle's `unwatch()`.
+     * @param id - The `id` of the handle `watch` resolved with
+     */
+    unwatch?: (id: string) => Promise<void>;
+}
+/**
+ * One change to a watched path, as the `craft:fs:change` event's detail.
+ */
+export interface CraftFsWatchEvent {
+    /** The id of the watch it belongs to */
+    id: string;
+    /**
+     * What happened. Both ends of a rename report `rename`; the old name is the
+     * one that no longer exists.
+     */
+    type: 'create' | 'modify' | 'delete' | 'rename';
+    /** The path that changed */
+    path: string;
+}
+/**
+ * A registered watch. `unwatch()` stops it; calling it again does nothing.
+ */
+export interface CraftFsWatchHandle {
+    /** The id the page generated and native registered the watch under */
+    id: string;
+    unwatch(): Promise<void>;
 }
 /**
  * Database API (SQLite)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "craft-native",
-  "version": "0.0.112",
+  "version": "0.0.115",
   "type": "module",
   "description": "Build desktop apps with web languages - TypeScript SDK for Craft",
   "author": "Chris Breuer <chris@stacksjs.org>",