@stacksjs/desktop 0.2.127 → 0.2.128

package/dist/focus.d.ts

@@ -6,6 +6,11 @@
  * not at the moment a meeting starts.
  */
 export declare function hasFocusShortcuts(...names: string[]): Promise<boolean>;
+/**
+ * Like `hasFocusShortcuts`, but distinguishes "not installed" from "could not
+ * check". Prefer this anywhere the answer drives a setup prompt.
+ */
+export declare function focusShortcutsReady(...names: string[]): Promise<boolean | 'unknown'>;
 export declare const focus: FocusAPI;
 export declare interface FocusStatus {
   supported: boolean
@@ -15,23 +20,41 @@ export declare interface FocusStatus {
 export declare interface FocusShortcutOptions {
   onShortcut?: string
   offShortcut?: string
+  strategy?: FocusStrategy
 }
 export declare interface FocusResult {
   ok: boolean
-  strategy?: 'shortcut'
+  strategy?: 'shortcut' | 'url'
   exitCode?: number
+  dispatched?: boolean
   shortcut?: string
   error?: string
 }
+export declare interface FocusShortcutList {
+  canList: boolean
+  shortcuts: string[]
+}
 export declare interface FocusAPI {
   getStatus: () => Promise<FocusStatus>
   requestAuthorization: () => Promise<FocusAuthorization>
   setEnabled: (enabled: boolean, options?: FocusShortcutOptions) => Promise<FocusResult>
   runShortcut: (name: string) => Promise<FocusResult>
   listShortcuts: () => Promise<string[]>
+  listShortcutsResult: () => Promise<FocusShortcutList>
 }
 /**
  * Mirrors `INFocusStatusAuthorizationStatus`. `unsupported` is Craft's own
  * value for platforms where the framework isn't present at all.
  */
 export type FocusAuthorization = 'notDetermined' | 'restricted' | 'denied' | 'authorized' | 'unsupported';
+/**
+ * How the shortcut is run.
+ *
+ * `cli` execs `/usr/bin/shortcuts` and reports the shortcut's real exit
+ * status. `url` opens `shortcuts://run-shortcut`, the only route the App
+ * Sandbox permits — but it is fire-and-forget: LaunchServices confirms it
+ * handed the URL over, never that the shortcut ran. `auto` picks `url` under
+ * sandbox and `cli` everywhere else, so a real status is used where one
+ * exists.
+ */
+export type FocusStrategy = 'auto' | 'cli' | 'url';

package/dist/index.d.ts

@@ -214,8 +214,10 @@ export type {
   FocusAPI,
   FocusAuthorization,
   FocusResult,
+  FocusShortcutList,
   FocusShortcutOptions,
   FocusStatus,
+  FocusStrategy,
 } from './focus';
 export type {
   LocalServerAPI,
@@ -588,7 +590,7 @@ export {
 // =============================================================================
 // Focus / Do Not Disturb
 // =============================================================================
-export { focus, hasFocusShortcuts } from './focus';
+export { focus, focusShortcutsReady, hasFocusShortcuts } from './focus';
 // =============================================================================
 // Local HTTP Server (OAuth callbacks)
 // =============================================================================

package/dist/index.js

@@ -5858,6 +5858,12 @@ var focus = {
     if (!hasBridge("focus"))
       return [];
     return await window.craft.focus.listShortcuts();
+  },
+  async listShortcutsResult() {
+    if (!hasBridge("focus"))
+      return { canList: false, shortcuts: [] };
+    const r = await window.craft.focus.listShortcutsResult();
+    return { canList: Boolean(r?.canList), shortcuts: r?.shortcuts || [] };
   }
 };
 async function hasFocusShortcuts(...names) {
@@ -5866,6 +5872,15 @@ async function hasFocusShortcuts(...names) {
   const installed = new Set(await focus.listShortcuts());
   return names.every((name) => installed.has(name));
 }
+async function focusShortcutsReady(...names) {
+  if (names.length === 0)
+    return false;
+  const { canList, shortcuts } = await focus.listShortcutsResult();
+  if (!canList)
+    return "unknown";
+  const installed = new Set(shortcuts);
+  return names.every((name) => installed.has(name));
+}
 // src/local-server.ts
 var localServer = {
   async start(port = 0, host = "127.0.0.1") {
@@ -6457,6 +6472,7 @@ export {
   formatRemainingTime,
   formatDuration,
   formatCompact,
+  focusShortcutsReady,
   focus,
   fileAssociations,
   dragOut,
@@ -6538,4 +6554,4 @@ export {
   AVAILABLE_COMPONENTS
 };
 
-//# debugId=E90C218C8E34E21564756E2164756E21
+//# debugId=4BACEAAC5AF2924164756E2164756E21