@stacksjs/desktop 0.2.112 → 0.2.114

package/dist/packaging.d.ts

@@ -0,0 +1,23 @@
+export type { PackageConfig, PackageResult } from 'craft-native';
+/**
+ * Packaging and code signing.
+ *
+ * Craft owns the native side of this — building the `.app`, the DMG, the MSI,
+ * the Linux packages, and the signed `.pkg` the Mac App Store accepts. This
+ * module re-exports it so an app reaches packaging through the same import as
+ * the rest of the desktop API, rather than depending on Craft directly.
+ *
+ * @example
+ * ```typescript
+ * import { packageApp } from '@stacksjs/stx/desktop'
+ *
+ * await packageApp({
+ *   name: 'Barista',
+ *   version: '0.1.0',
+ *   binaryPath: './dist/barista',
+ *   bundleId: 'org.stacksjs.barista',
+ *   macos: { menuBarOnly: true, dmg: true },
+ * })
+ * ```
+ */
+export { pack, packageApp } from 'craft-native';

package/dist/test-utils.js

@@ -1,4 +1,49 @@
 // @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/test-utils.ts
@@ -105,4 +150,4 @@ export {
   findCall
 };
 
-//# debugId=112673127C3680E664756E2164756E21
+//# debugId=A2381B1EFA0ECC1764756E2164756E21

package/dist/test-utils.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "/**\n * Test utilities — install a mock `window.craft` namespace + capture\n * every call against it. Apps consuming this package can `import {\n * installMockBridge } from '@stacksjs/desktop/test-utils'` to hand\n * their unit tests the same harness this package uses internally.\n *\n * The mock auto-vivifies namespaces on access — `craft.fs.readFile`\n * works without pre-declaring `fs`. Methods return a Promise resolving\n * to whatever was queued via `whenCalled`, defaulting to `undefined`.\n *\n * Tests should follow the install / call / assert / uninstall cycle:\n * ```ts\n * import { installMockBridge, findCall } from '@stacksjs/desktop/test-utils'\n * import { fs } from '@stacksjs/desktop'\n *\n * const bridge = installMockBridge()\n * bridge.whenCalled('fs', 'readFile', { data: 'hello' })\n * expect(await fs.readFile('/x')).toBe('hello')\n * expect(findCall(bridge.calls, 'fs', 'readFile')!.args).toEqual(['/x'])\n * bridge.uninstall()\n * ```\n *\n * Polyfills `window.addEventListener` / `dispatchEvent` for runners\n * (very-happy-dom, jsdom older versions) that don't ship them by\n * default — facade tests rely on those for event-based facades.\n */\n\nensureWindowEventTarget()\n\nfunction ensureWindowEventTarget(): void {\n  if (typeof window === 'undefined') return\n  const w = window as any\n  if (typeof w.addEventListener === 'function' && typeof w.dispatchEvent === 'function') return\n\n  const listeners = new Map<string, Set<EventListener>>()\n\n  w.addEventListener = (name: string, cb: EventListener): void => {\n    let set = listeners.get(name)\n    if (!set) {\n      set = new Set()\n      listeners.set(name, set)\n    }\n    set.add(cb)\n  }\n\n  w.removeEventListener = (name: string, cb: EventListener): void => {\n    listeners.get(name)?.delete(cb)\n  }\n\n  w.dispatchEvent = (event: Event): boolean => {\n    const set = listeners.get(event.type)\n    if (set) {\n      for (const fn of set) {\n        try { fn(event) } catch { /* swallow listener errors during tests */ }\n      }\n    }\n    return true\n  }\n}\n\nexport interface CapturedCall {\n  ns: string\n  method: string\n  args: unknown[]\n}\n\nexport interface MockBridgeHandle {\n  /** Calls captured since the bridge was installed. */\n  calls: CapturedCall[]\n  /**\n   * Queue the response from `window.craft[ns][method]`. The mock\n   * walks: explicit return → matched response handler → default.\n   */\n  whenCalled: (\n    ns: string,\n    method: string,\n    response: unknown | ((...args: unknown[]) => unknown)\n  ) => void\n  /** Remove the mock and restore whatever was on window.craft before. */\n  uninstall: () => void\n}\n\nexport function installMockBridge(initialNamespaces: string[] = []): MockBridgeHandle {\n  const calls: CapturedCall[] = []\n  const responses = new Map<string, unknown | ((...args: unknown[]) => unknown)>()\n\n  // If the production bridge IIFE has already loaded — flagged via\n  // `__craft_bridge_loaded` — treat the existing window.craft as\n  // \"no real previous.\" Otherwise restoring it on uninstall would\n  // leak the production facade into \"no bridge\" assertions in\n  // subsequent tests.\n  const previousRaw = (window as any).craft\n  const previous = previousRaw && previousRaw.__craft_bridge_loaded ? undefined : previousRaw\n\n  function makeMethod(ns: string, method: string) {\n    return (...args: unknown[]) => {\n      calls.push({ ns, method, args })\n      const key = `${ns}:${method}`\n      if (responses.has(key)) {\n        const r = responses.get(key)\n        const resolved = typeof r === 'function'\n          ? (r as (...a: unknown[]) => unknown)(...args)\n          : r\n        return Promise.resolve(resolved)\n      }\n      return Promise.resolve(undefined)\n    }\n  }\n\n  function makeNamespace(ns: string): Record<string, unknown> {\n    return new Proxy({} as Record<string, unknown>, {\n      get(_target, prop: string) {\n        if (typeof prop !== 'string') return undefined\n        // Some non-method properties may be read synchronously (e.g.\n        // theme.get returns an object, not a promise). Allow callers\n        // to register those by passing a zero-arg function — we\n        // recognize the shape and return the value synchronously.\n        if (responses.has(`${ns}:${prop}`)) {\n          const r = responses.get(`${ns}:${prop}`)\n          if (typeof r === 'function' && r.length === 0) {\n            return () => {\n              calls.push({ ns, method: prop, args: [] })\n              return (r as () => unknown)()\n            }\n          }\n        }\n        return makeMethod(ns, prop)\n      },\n    })\n  }\n\n  const root = new Proxy({} as Record<string, unknown>, {\n    get(_target, prop: string) {\n      if (typeof prop !== 'string') return undefined\n      return makeNamespace(prop)\n    },\n    has(_target, prop) {\n      if (typeof prop !== 'string') return false\n      if (initialNamespaces.length === 0) return true\n      return initialNamespaces.includes(prop)\n    },\n  })\n\n  ;(window as any).craft = root\n\n  return {\n    calls,\n    whenCalled(ns, method, response) {\n      responses.set(`${ns}:${method}`, response)\n    },\n    uninstall() {\n      if (previous === undefined) {\n        delete (window as any).craft\n      }\n      else {\n        ;(window as any).craft = previous\n      }\n    },\n  }\n}\n\n/** Helper — find the first captured call matching `ns` + `method`. */\nexport function findCall(\n  calls: CapturedCall[],\n  ns: string,\n  method: string,\n): CapturedCall | undefined {\n  return calls.find(c => c.ns === ns && c.method === method)\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "112673127C3680E664756E2164756E21",
+  "mappings": "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",
+  "debugId": "A2381B1EFA0ECC1764756E2164756E21",
   "names": []
 }

package/dist/types.d.ts

@@ -58,6 +58,9 @@ export declare interface WindowOptions {
   frameless?: boolean
   titlebarHidden?: boolean
   backgroundColor?: string
+  systemTray?: boolean
+  hideDockIcon?: boolean
+  devTools?: boolean
   nativeSidebar?: boolean
   sidebarWidth?: number
   sidebarConfig?: SidebarConfig

package/dist/window.d.ts

@@ -32,11 +32,19 @@ export declare function getWindow(id: string): WindowInstance | null;
  * Close all active windows
  */
 export declare function closeAllWindows(): void;
+/**
+ * Translate window options into Craft binary arguments.
+ *
+ * craft-native is a thin wrapper around this command line, so the same options
+ * describe a window whether the JS package is installed or not.
+ */
+export declare function craftWindowArguments(url: string, options?: WindowOptions): string[];
 /**
  * Create a native window with URL
  *
- * Uses ts-craft to create native desktop windows. Falls back to returning null
- * if ts-craft is not available.
+ * Prefers the craft-native package for its richer typings, and falls back to
+ * spawning the Craft binary directly when it isn't installed — the binary is
+ * what craft-native drives anyway, so an app needs only one of the two.
  *
  * ## Window Control
  *
@@ -57,20 +65,20 @@ export declare function closeAllWindows(): void;
  *
  * @param url - URL to load in the window
  * @param options - Window configuration options
- * @returns WindowInstance if successful, null if ts-craft unavailable
+ * @returns WindowInstance if successful, null if no Craft runtime is available
  */
 export declare function createWindow(url: string, options?: WindowOptions): Promise<WindowInstance | null>;
 /**
  * Open a development server window
  * This is specifically for the stx dev server --native flag
  *
- * Uses ts-craft to create a native window, falls back to browser if unavailable.
+ * Uses craft-native to create a native window, falls back to browser if unavailable.
  */
 export declare function openDevWindow(port: number, options?: WindowOptions): Promise<boolean>;
 /**
  * Create a window with HTML content
  *
- * Uses ts-craft to display HTML content in a native window.
+ * Uses craft-native to display HTML content in a native window.
  */
 export declare function createWindowWithHTML(html: string, options?: WindowOptions): Promise<WindowInstance | null>;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/desktop",
   "type": "module",
-  "version": "0.2.112",
+  "version": "0.2.114",
   "description": "Native desktop application framework for stx (powered by Craft)",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -54,12 +54,7 @@
     "test:coverage": "bun test --coverage --preload ../../test-utils/happy-dom.ts",
     "typecheck": "bun tsc --noEmit"
   },
-  "peerDependencies": {
-    "craft": "*"
-  },
-  "peerDependenciesMeta": {
-    "craft": {
-      "optional": true
-    }
+  "dependencies": {
+    "craft-native": ">=0.0.37"
   }
 }