@stacksjs/desktop 0.2.120 → 0.2.121

package/dist/focus.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Whether every shortcut the app depends on is installed.
+ *
+ * Worth calling on launch: the shortcuts are user-created, so the honest time
+ * to discover they're missing is before the user is relying on the feature,
+ * not at the moment a meeting starts.
+ */
+export declare function hasFocusShortcuts(...names: string[]): Promise<boolean>;
+export declare const focus: FocusAPI;
+export declare interface FocusStatus {
+  supported: boolean
+  isFocused: boolean | null
+  authorization: FocusAuthorization
+}
+export declare interface FocusShortcutOptions {
+  onShortcut?: string
+  offShortcut?: string
+}
+export declare interface FocusResult {
+  ok: boolean
+  strategy?: 'shortcut'
+  exitCode?: number
+  shortcut?: string
+  error?: 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[]>
+}
+/**
+ * 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';

package/dist/index.d.ts

@@ -203,6 +203,20 @@ export type {
   LocationWatchOptions,
 } from './location';
 export type { CapturableWindow, ScreenCaptureAPI } from './screen-capture';
+export type {
+  ScreenSharingAPI,
+  ScreenSharingKind,
+  ScreenSharingSignals,
+  ScreenSharingSource,
+  ScreenSharingState,
+} from './screen-sharing';
+export type {
+  FocusAPI,
+  FocusAuthorization,
+  FocusResult,
+  FocusShortcutOptions,
+  FocusStatus,
+} from './focus';
 export type {
   LocalServerAPI,
   LocalServerRequestEvent,
@@ -562,6 +576,20 @@ export { location } from './location';
 // =============================================================================
 export { screenCapture } from './screen-capture';
 // =============================================================================
+// Screen Sharing Detection (is the screen being shared or recorded?)
+// =============================================================================
+export {
+  DEFAULT_WATCH_INTERVAL_MS,
+  MAX_WATCH_INTERVAL_MS,
+  MIN_WATCH_INTERVAL_MS,
+  screenSharing,
+  watchScreenSharing,
+} from './screen-sharing';
+// =============================================================================
+// Focus / Do Not Disturb
+// =============================================================================
+export { focus, hasFocusShortcuts } from './focus';
+// =============================================================================
 // Local HTTP Server (OAuth callbacks)
 // =============================================================================
 export { localServer } from './local-server';

package/dist/index.js

@@ -5772,6 +5772,100 @@ var screenCapture = {
     return await window.craft.screenCapture.listWindows();
   }
 };
+// src/screen-sharing.ts
+var MIN_WATCH_INTERVAL_MS = 250;
+var MAX_WATCH_INTERVAL_MS = 60000;
+var DEFAULT_WATCH_INTERVAL_MS = 2000;
+var IDLE = {
+  sharing: false,
+  signals: {
+    systemScreenShare: false,
+    remoteSession: false,
+    conferenceSharing: false,
+    screenRecording: false
+  },
+  sources: []
+};
+function idleState() {
+  return { ...IDLE, signals: { ...IDLE.signals }, sources: [] };
+}
+var screenSharing = {
+  async getState() {
+    if (!hasBridge("screenSharing"))
+      return idleState();
+    return await window.craft.screenSharing.getState();
+  },
+  async watch(intervalMs = DEFAULT_WATCH_INTERVAL_MS) {
+    const clamped = Math.min(MAX_WATCH_INTERVAL_MS, Math.max(MIN_WATCH_INTERVAL_MS, Math.round(intervalMs)));
+    if (!hasBridge("screenSharing"))
+      return clamped;
+    const r = await window.craft.screenSharing.watch(clamped);
+    return r && r.intervalMs || clamped;
+  },
+  async stop() {
+    if (!hasBridge("screenSharing"))
+      return;
+    await window.craft.screenSharing.unwatch();
+  },
+  onChange(cb) {
+    return onCraftEvent("craft:screenSharing:change", cb);
+  }
+};
+async function watchScreenSharing(cb, intervalMs = DEFAULT_WATCH_INTERVAL_MS) {
+  const off = screenSharing.onChange(cb);
+  await screenSharing.watch(intervalMs);
+  return () => {
+    off();
+    screenSharing.stop();
+  };
+}
+// src/focus.ts
+var UNSUPPORTED = { supported: false, isFocused: null, authorization: "unsupported" };
+function unavailable() {
+  return { ok: false, error: "Focus control is only available in a Craft window on macOS" };
+}
+var focus = {
+  async getStatus() {
+    if (!hasBridge("focus"))
+      return { ...UNSUPPORTED };
+    return await window.craft.focus.getStatus();
+  },
+  async requestAuthorization() {
+    if (!hasBridge("focus"))
+      return "unsupported";
+    return await window.craft.focus.requestAuthorization();
+  },
+  async setEnabled(enabled, options = {}) {
+    if (!hasBridge("focus"))
+      return unavailable();
+    const name = enabled ? options.onShortcut : options.offShortcut;
+    if (!name) {
+      return {
+        ok: false,
+        error: `focus.setEnabled: no ${enabled ? "onShortcut" : "offShortcut"} configured`
+      };
+    }
+    return await window.craft.focus.setEnabled(enabled, options);
+  },
+  async runShortcut(name) {
+    if (!hasBridge("focus"))
+      return unavailable();
+    if (!name)
+      throw new Error("focus.runShortcut: name is required");
+    return await window.craft.focus.runShortcut(name);
+  },
+  async listShortcuts() {
+    if (!hasBridge("focus"))
+      return [];
+    return await window.craft.focus.listShortcuts();
+  }
+};
+async function hasFocusShortcuts(...names) {
+  if (names.length === 0)
+    return false;
+  const installed = new Set(await focus.listShortcuts());
+  return names.every((name) => installed.has(name));
+}
 // src/local-server.ts
 var localServer = {
   async start(port = 0, host = "127.0.0.1") {
@@ -6264,6 +6358,7 @@ function isAvailable(name) {
 }
 export {
   windowEvents,
+  watchScreenSharing,
   vision,
   updater,
   unregisterHotkey,
@@ -6302,6 +6397,7 @@ export {
   setAutoLaunch,
   serviceMenu,
   serial,
+  screenSharing,
   screenCapture,
   screen,
   resolveCraftBinary2 as resolveCraftBinary,
@@ -6334,6 +6430,7 @@ export {
   isAvailable,
   isAutoLaunchEnabled,
   iap,
+  hasFocusShortcuts,
   handoff,
   globalShortcuts,
   githubReleaseAssetUrl,
@@ -6360,6 +6457,7 @@ export {
   formatRemainingTime,
   formatDuration,
   formatCompact,
+  focus,
   fileAssociations,
   dragOut,
   dismissAllAlerts,
@@ -6432,9 +6530,12 @@ export {
   TRAY_MENU_STYLES,
   TOAST_STYLES,
   MODAL_STYLES,
+  MIN_WATCH_INTERVAL_MS,
+  MAX_WATCH_INTERVAL_MS,
+  DEFAULT_WATCH_INTERVAL_MS,
   COMPONENT_STYLES,
   AutoUpdater,
   AVAILABLE_COMPONENTS
 };
 
-//# debugId=3B1F86F62D9B26A764756E2164756E21
+//# debugId=E90C218C8E34E21564756E2164756E21