ssovee-os-web-ui 0.1.21 → 0.1.23

package/dist/sdk.cjs

@@ -0,0 +1,265 @@
+'use strict';
+
+var react = require('react');
+var uaParserJs = require('ua-parser-js');
+
+// src/hooks/useDeviceSupport.tsx
+var useDeviceSupport = () => {
+  const [isSupported, setIsSupported] = react.useState(true);
+  react.useEffect(() => {
+    function checkSupport() {
+      const ua = typeof window !== "undefined" ? window.navigator.userAgent : "";
+      const width = typeof window !== "undefined" ? window.innerWidth : 1920;
+      const height = typeof window !== "undefined" ? window.innerHeight : 1080;
+      const isTouch = typeof window !== "undefined" ? "ontouchstart" in window : false;
+      const isMobile = /Mobi|Android|iPhone|iPod/.test(ua) && width <= 767;
+      const isTablet = /iPad|Tablet|Android/.test(ua) && !/Mobile/.test(ua) || isTouch && width >= 600 && width <= 1024;
+      const isTabletPortrait = isTablet && width < height;
+      const isTabletLandscape = isTablet && width > height && width >= 1024 && width <= 1366;
+      const isLaptop = width >= 1024 && !isMobile && (!isTablet || isTabletLandscape);
+      if (isMobile) {
+        setIsSupported(false);
+      } else if (isTabletPortrait) {
+        setIsSupported(false);
+      } else if (isTabletLandscape) {
+        setIsSupported(true);
+      } else if (isLaptop) {
+        setIsSupported(true);
+      } else {
+        setIsSupported(true);
+      }
+    }
+    checkSupport();
+    window.addEventListener("resize", checkSupport);
+    return () => window.removeEventListener("resize", checkSupport);
+  }, []);
+  return isSupported;
+};
+var soundMap = {
+  click: "/sounds/click-tone.wav",
+  alert: "/sounds/error-tone.wav",
+  notification: "/sounds/notification-tone.wav",
+  error: "/sounds/error-tone.wav",
+  success: "/sounds/success-tone.wav",
+  swipe: "/sounds/swipe-tone.wav"
+};
+var useSound = () => {
+  const playSound = react.useCallback((type) => {
+    if (typeof window === "undefined" || typeof window.Audio === "undefined") {
+      return;
+    }
+    const soundSrc = soundMap[type];
+    const audio = new window.Audio(soundSrc);
+    audio.play().catch((err) => {
+      console.error("Sound playback failed:", err);
+    });
+  }, []);
+  return { playSound };
+};
+var useGridClasses = (windowSize, gridRules) => {
+  const deviceType = react.useMemo(() => {
+    if (windowSize.width <= 640) return "mobile";
+    if (windowSize.width <= 1024) return "tablet";
+    return "desktop";
+  }, [windowSize]);
+  const gridClasses = react.useMemo(() => {
+    const classes = {};
+    for (const element in gridRules) {
+      const classRules = gridRules[element];
+      const colSpan = classRules["col-span"][deviceType];
+      classes[element] = `col-span-${deviceType}-${colSpan}`;
+    }
+    return classes;
+  }, [deviceType, gridRules]);
+  return { gridClasses, deviceType };
+};
+var useGridClasses_default = useGridClasses;
+
+// src/utils/constants.ts
+var globalKeyboardShortcuts = [
+  {
+    command: "toggle_theme",
+    shortcut: ["Ctrl", "Shift", "M"],
+    usage: "Toggle between light and dark theme"
+  },
+  {
+    command: "app_switcher",
+    shortcut: ["Ctrl", "Shift", "S"],
+    usage: "Switch between open apps"
+  },
+  {
+    command: "exit_app",
+    shortcut: ["Ctrl", "E"],
+    usage: "Exit or quit the application"
+  },
+  {
+    command: "maximize_app",
+    shortcut: ["Ctrl", "ArrowUp"],
+    usage: "Maximize the application window"
+  },
+  {
+    command: "minimize_app",
+    shortcut: ["Ctrl", "ArrowDown"],
+    usage: "Minimize the application window"
+  },
+  {
+    command: "global_search",
+    shortcut: ["Ctrl", "Shift", "K"],
+    usage: "Open global search"
+  },
+  {
+    command: "toggle_search_mode",
+    shortcut: ["Ctrl", "Shift", "L"],
+    usage: "Enable AI and Voice command (start/stop voice input in search)"
+  },
+  {
+    command: "toggle_control_center",
+    shortcut: ["Ctrl", "Shift", "O"],
+    usage: "Toggle control center panel or drawer"
+  },
+  {
+    command: "arrow_up",
+    shortcut: ["ArrowUp"],
+    usage: "Navigate up in lists, menus and options"
+  },
+  {
+    command: "arrow_down",
+    shortcut: ["ArrowDown"],
+    usage: "Navigate down in lists, menus and options"
+  },
+  {
+    command: "escape_button_action",
+    shortcut: ["Escape"],
+    usage: "Close or go back from any open alert, popup, search, or control center"
+  },
+  {
+    command: "enter_button_action",
+    shortcut: ["Enter"],
+    usage: "Select or confirm the currently focused item"
+  },
+  {
+    command: "toggle_filters",
+    shortcut: ["Ctrl", "Shift", "U"],
+    usage: "To open or close filters of any current active app"
+  },
+  {
+    command: "focus_search",
+    shortcut: ["Ctrl", "k"],
+    usage: "Focus on current app search"
+  },
+  {
+    command: "toggle_all_apps",
+    shortcut: ["Ctrl", "Shift", "A"],
+    usage: "Toggle showing all available apps and plugins"
+  }
+];
+var keyMap = {
+  mac: {
+    ctrl: "\u2318",
+    alt: "\u2325",
+    shift: "\u21E7",
+    enter: "\u23CE",
+    backspace: "\u232B",
+    arrowup: "\u2191",
+    arrowdown: "\u2193"
+  },
+  windows: {
+    ctrl: "Ctrl",
+    alt: "Alt",
+    shift: "Shift",
+    enter: "Enter",
+    backspace: "Backspace",
+    arrowup: "\u2191",
+    arrowdown: "\u2193"
+  },
+  linux: {
+    ctrl: "Ctrl",
+    alt: "Alt",
+    shift: "Shift",
+    enter: "Enter",
+    backspace: "Backspace",
+    arrowup: "\u2191",
+    arrowdown: "\u2193"
+  }
+};
+var detectOS = () => {
+  const parser = new uaParserJs.UAParser();
+  const osName = parser.getOS().name?.toLowerCase() || "";
+  if (osName.includes("mac")) return "mac";
+  if (osName.includes("windows")) return "windows";
+  if (osName.includes("linux")) return "linux";
+  return "windows";
+};
+var normalizeKey = (key) => key.toLowerCase();
+var matchShortcut = (event, shortcut, os) => {
+  const keySet = new Set(shortcut.map(normalizeKey));
+  const pressed = [];
+  if (os === "mac") {
+    if (event.metaKey) pressed.push("ctrl");
+  } else {
+    if (event.ctrlKey) pressed.push("ctrl");
+  }
+  if (event.altKey) pressed.push("alt");
+  if (event.shiftKey) pressed.push("shift");
+  if (event.key && !["Control", "Meta", "Alt", "Shift"].includes(event.key)) {
+    pressed.push(normalizeKey(event.key));
+  }
+  if (pressed.length !== shortcut.length) return false;
+  return pressed.every((k) => keySet.has(k));
+};
+var useShortcutFormatter = () => {
+  const [os, setOS] = react.useState("windows");
+  const listenersRef = react.useRef(/* @__PURE__ */ new Map());
+  react.useEffect(() => {
+    setOS(detectOS());
+  }, []);
+  react.useEffect(() => {
+    const handleKeyDown = (event) => {
+      for (const shortcut of globalKeyboardShortcuts) {
+        if (matchShortcut(event, shortcut.shortcut, os)) {
+          const listeners = listenersRef.current.get(shortcut.command);
+          if (listeners) {
+            event.preventDefault();
+            listeners.forEach((cb) => cb(event));
+          }
+        }
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [os]);
+  const formatKeys = (keys = []) => {
+    return keys.map((key) => keyMap[os][key.toLowerCase()] || key.toUpperCase()).join(" + ");
+  };
+  const getShortcutByCommand = (command) => {
+    const found = globalKeyboardShortcuts.find((s) => s.command === command);
+    return found ? found.shortcut : [""];
+  };
+  const addShortcutListener = (command, listener) => {
+    if (!listenersRef.current.has(command)) {
+      listenersRef.current.set(command, /* @__PURE__ */ new Set());
+    }
+    listenersRef.current.get(command).add(listener);
+  };
+  const removeShortcutListener = (command, listener) => {
+    if (listenersRef.current.has(command)) {
+      listenersRef.current.get(command).delete(listener);
+    }
+  };
+  return {
+    formatKeys,
+    getShortcutByCommand,
+    addShortcutListener,
+    removeShortcutListener
+  };
+};
+var useShortcutFormatter_default = useShortcutFormatter;
+
+exports.useDeviceSupport = useDeviceSupport;
+exports.useGridClasses = useGridClasses_default;
+exports.useShortcutFormatter = useShortcutFormatter_default;
+exports.useSound = useSound;
+//# sourceMappingURL=sdk.cjs.map
+//# sourceMappingURL=sdk.cjs.map

package/dist/sdk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useDeviceSupport.tsx","../src/hooks/useSound.tsx","../src/hooks/useGridClasses.tsx","../src/utils/constants.ts","../src/hooks/useShortcutFormatter.tsx"],"names":["useState","useEffect","useCallback","useMemo","UAParser","useRef"],"mappings":"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","file":"sdk.cjs","sourcesContent":["import { useEffect, useState } from \"react\";\n\n// Helper function to detect device type and orientation\nexport const useDeviceSupport = () => {\n  const [isSupported, setIsSupported] = useState(true);\n\n  useEffect(() => {\n    function checkSupport() {\n      // Get user agent and screen info\n      const ua =\n        typeof window !== \"undefined\" ? window.navigator.userAgent : \"\";\n      const width = typeof window !== \"undefined\" ? window.innerWidth : 1920;\n      const height = typeof window !== \"undefined\" ? window.innerHeight : 1080;\n      const isTouch =\n        typeof window !== \"undefined\" ? \"ontouchstart\" in window : false;\n\n      // Mobile detection (iOS/Android phones)\n      const isMobile = /Mobi|Android|iPhone|iPod/.test(ua) && width <= 767;\n\n      // Tablet detection (portrait/landscape)\n      const isTablet =\n        (/iPad|Tablet|Android/.test(ua) && !/Mobile/.test(ua)) ||\n        (isTouch && width >= 600 && width <= 1024);\n      // Tablet portrait: width < height, width <= 1024, height > width\n      const isTabletPortrait = isTablet && width < height;\n      // Tablet landscape: width > height, width <= 1366, width >= 1024\n      const isTabletLandscape =\n        isTablet && width > height && width >= 1024 && width <= 1366;\n\n      // Laptop: width >= 1024 (landscape), not touch or not tablet\n      const isLaptop =\n        width >= 1024 && !isMobile && (!isTablet || isTabletLandscape);\n\n      // Support logic:\n      // - Mobile: Not supported\n      // - Tablet portrait: Not supported\n      // - Tablet landscape: Supported\n      // - Laptop: Supported\n\n      if (isMobile) {\n        setIsSupported(false);\n      } else if (isTabletPortrait) {\n        setIsSupported(false);\n      } else if (isTabletLandscape) {\n        setIsSupported(true);\n      } else if (isLaptop) {\n        setIsSupported(true);\n      } else {\n        // Default: allow desktop\n        setIsSupported(true);\n      }\n    }\n\n    checkSupport();\n    window.addEventListener(\"resize\", checkSupport);\n    return () => window.removeEventListener(\"resize\", checkSupport);\n  }, []);\n\n  return isSupported;\n};\n","import { useCallback } from \"react\";\n\ntype SoundType =\n  | \"click\"\n  | \"error\"\n  | \"success\"\n  | \"alert\"\n  | \"notification\"\n  | \"swipe\";\n\nconst soundMap: Record<SoundType, string> = {\n  click: \"/sounds/click-tone.wav\",\n  alert: \"/sounds/error-tone.wav\",\n  notification: \"/sounds/notification-tone.wav\",\n  error: \"/sounds/error-tone.wav\",\n  success: \"/sounds/success-tone.wav\",\n  swipe: \"/sounds/swipe-tone.wav\",\n};\n\nexport const useSound = () => {\n  const playSound = useCallback((type: SoundType) => {\n    if (typeof window === \"undefined\" || typeof window.Audio === \"undefined\") {\n      return;\n    }\n\n    const soundSrc = soundMap[type];\n    const audio = new window.Audio(soundSrc);\n    audio.play().catch((err) => {\n      console.error(\"Sound playback failed:\", err);\n    });\n  }, []);\n\n  return { playSound };\n};\n","import { useMemo } from \"react\";\n\nconst useGridClasses = (\n  windowSize: { width: number; height: number },\n  gridRules: Record<string, Record<string, Record<string, string>>>\n) => {\n  const deviceType: \"mobile\" | \"tablet\" | \"desktop\" = useMemo(() => {\n    if (windowSize.width <= 640) return \"mobile\"; // For mobile (width <= 640px)\n    if (windowSize.width <= 1024) return \"tablet\"; // For tablet (width <= 1024px)\n    return \"desktop\"; // For desktop (width > 1024px)\n  }, [windowSize]);\n\n  const gridClasses: Record<string, string> = useMemo(() => {\n    const classes: Record<string, string> = {};\n    for (const element in gridRules) {\n      const classRules = gridRules[element];\n      // Check for device-specific class (col-span-{deviceType}-{col-span})\n      const colSpan = classRules[\"col-span\"][deviceType];\n      classes[element] = `col-span-${deviceType}-${colSpan}`;\n    }\n    return classes;\n  }, [deviceType, gridRules]);\n\n  return { gridClasses, deviceType };\n};\n\nexport default useGridClasses;\n","export type Shortcut = {\n  command: string;\n  shortcut: string[];\n  usage: string;\n};\n\nexport const globalKeyboardShortcuts: Shortcut[] = [\n  {\n    command: \"toggle_theme\",\n    shortcut: [\"Ctrl\", \"Shift\", \"M\"],\n    usage: \"Toggle between light and dark theme\",\n  },\n  {\n    command: \"app_switcher\",\n    shortcut: [\"Ctrl\", \"Shift\", \"S\"],\n    usage: \"Switch between open apps\",\n  },\n  {\n    command: \"exit_app\",\n    shortcut: [\"Ctrl\", \"E\"],\n    usage: \"Exit or quit the application\",\n  },\n  {\n    command: \"maximize_app\",\n    shortcut: [\"Ctrl\", \"ArrowUp\"],\n    usage: \"Maximize the application window\",\n  },\n  {\n    command: \"minimize_app\",\n    shortcut: [\"Ctrl\", \"ArrowDown\"],\n    usage: \"Minimize the application window\",\n  },\n  {\n    command: \"global_search\",\n    shortcut: [\"Ctrl\", \"Shift\", \"K\"],\n    usage: \"Open global search\",\n  },\n  {\n    command: \"toggle_search_mode\",\n    shortcut: [\"Ctrl\", \"Shift\", \"L\"],\n    usage: \"Enable AI and Voice command (start/stop voice input in search)\",\n  },\n  {\n    command: \"toggle_control_center\",\n    shortcut: [\"Ctrl\", \"Shift\", \"O\"],\n    usage: \"Toggle control center panel or drawer\",\n  },\n  {\n    command: \"arrow_up\",\n    shortcut: [\"ArrowUp\"],\n    usage: \"Navigate up in lists, menus and options\",\n  },\n  {\n    command: \"arrow_down\",\n    shortcut: [\"ArrowDown\"],\n    usage: \"Navigate down in lists, menus and options\",\n  },\n  {\n    command: \"escape_button_action\",\n    shortcut: [\"Escape\"],\n    usage: \"Close or go back from any open alert, popup, search, or control center\",\n  },\n  {\n    command: \"enter_button_action\",\n    shortcut: [\"Enter\"],\n    usage: \"Select or confirm the currently focused item\",\n  },\n  {\n    command: \"toggle_filters\",\n    shortcut: [\"Ctrl\", \"Shift\", \"U\"],\n    usage: \"To open or close filters of any current active app\",\n  },\n  {\n    command: \"focus_search\",\n    shortcut: [\"Ctrl\", \"k\"],\n    usage: \"Focus on current app search\",\n  },\n  {\n    command: \"toggle_all_apps\",\n    shortcut: [\"Ctrl\", \"Shift\", \"A\"],\n    usage: \"Toggle showing all available apps and plugins\",\n  },\n];","import { globalKeyboardShortcuts } from \"../utils/constants\";\nimport { useState, useEffect, useRef } from \"react\";\nimport { UAParser } from \"ua-parser-js\";\n\ntype OS = \"mac\" | \"windows\" | \"linux\";\n\ntype KeyMap = {\n  [key in OS]: {\n    [key: string]: string;\n  };\n};\n\nconst keyMap: KeyMap = {\n  mac: {\n    ctrl: \"⌘\",\n    alt: \"⌥\",\n    shift: \"⇧\",\n    enter: \"⏎\",\n    backspace: \"⌫\",\n    arrowup: \"↑\",\n    arrowdown: \"↓\",\n  },\n  windows: {\n    ctrl: \"Ctrl\",\n    alt: \"Alt\",\n    shift: \"Shift\",\n    enter: \"Enter\",\n    backspace: \"Backspace\",\n    arrowup: \"↑\",\n    arrowdown: \"↓\",\n  },\n  linux: {\n    ctrl: \"Ctrl\",\n    alt: \"Alt\",\n    shift: \"Shift\",\n    enter: \"Enter\",\n    backspace: \"Backspace\",\n    arrowup: \"↑\",\n    arrowdown: \"↓\",\n  },\n};\n\nconst detectOS = (): OS => {\n  const parser = new UAParser();\n  const osName = parser.getOS().name?.toLowerCase() || \"\";\n\n  if (osName.includes(\"mac\")) return \"mac\";\n  if (osName.includes(\"windows\")) return \"windows\";\n  if (osName.includes(\"linux\")) return \"linux\";\n  return \"windows\"; // fallback\n};\n\ntype UseShortcutFormatterReturn = {\n  formatKeys: (keys: string[]) => string;\n  getShortcutByCommand: (command: string) => string[];\n  addShortcutListener: (\n    command: string,\n    listener: (e: KeyboardEvent) => void\n  ) => void;\n  removeShortcutListener: (\n    command: string,\n    listener: (e: KeyboardEvent) => void\n  ) => void;\n};\n\nconst normalizeKey = (key: string) => key.toLowerCase();\n\nconst matchShortcut = (event: KeyboardEvent, shortcut: string[], os: OS) => {\n  // Normalize keys for comparison\n  const keySet = new Set(shortcut.map(normalizeKey));\n  // Map event to normalized keys\n  const pressed: string[] = [];\n  if (os === \"mac\") {\n    if (event.metaKey) pressed.push(\"ctrl\");\n  } else {\n    if (event.ctrlKey) pressed.push(\"ctrl\");\n  }\n  if (event.altKey) pressed.push(\"alt\");\n  if (event.shiftKey) pressed.push(\"shift\");\n  // The main key\n  if (event.key && ![\"Control\", \"Meta\", \"Alt\", \"Shift\"].includes(event.key)) {\n    pressed.push(normalizeKey(event.key));\n  }\n  // Compare sets\n  if (pressed.length !== shortcut.length) return false;\n  return pressed.every((k) => keySet.has(k));\n};\n\nconst useShortcutFormatter = (): UseShortcutFormatterReturn => {\n  const [os, setOS] = useState<OS>(\"windows\");\n  const listenersRef = useRef<Map<string, Set<(e: KeyboardEvent) => void>>>(new Map());\n\n  useEffect(() => {\n    setOS(detectOS());\n  }, []);\n\n  useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      for (const shortcut of globalKeyboardShortcuts) {\n        if (matchShortcut(event, shortcut.shortcut, os)) {\n          const listeners = listenersRef.current.get(shortcut.command);\n          if (listeners) {\n            event.preventDefault(); // Prevent browser defaults for matched shortcuts\n            listeners.forEach((cb) => cb(event));\n          }\n        }\n      }\n    };\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", handleKeyDown);\n    };\n  }, [os]);\n\n  const formatKeys = (keys: string[] = []): string => {\n    return keys\n      .map((key) => keyMap[os][key.toLowerCase()] || key.toUpperCase())\n      .join(\" + \");\n  };\n\n  const getShortcutByCommand = (command: string): string[] => {\n    const found = globalKeyboardShortcuts.find((s) => s.command === command);\n    return found ? found.shortcut : [\"\"];\n  };\n\n  const addShortcutListener = (command: string, listener: (e: KeyboardEvent) => void) => {\n    if (!listenersRef.current.has(command)) {\n      listenersRef.current.set(command, new Set());\n    }\n    listenersRef.current.get(command)!.add(listener);\n  };\n\n  const removeShortcutListener = (command: string, listener: (e: KeyboardEvent) => void) => {\n    if (listenersRef.current.has(command)) {\n      listenersRef.current.get(command)!.delete(listener);\n    }\n  };\n\n  return {\n    formatKeys,\n    getShortcutByCommand,\n    addShortcutListener,\n    removeShortcutListener,\n  };\n};\n\nexport default useShortcutFormatter;\n"]}

package/dist/sdk.d.cts

@@ -0,0 +1,24 @@
+declare const useGridClasses: (windowSize: {
+    width: number;
+    height: number;
+}, gridRules: Record<string, Record<string, Record<string, string>>>) => {
+    gridClasses: Record<string, string>;
+    deviceType: "mobile" | "tablet" | "desktop";
+};
+
+type UseShortcutFormatterReturn = {
+    formatKeys: (keys: string[]) => string;
+    getShortcutByCommand: (command: string) => string[];
+    addShortcutListener: (command: string, listener: (e: KeyboardEvent) => void) => void;
+    removeShortcutListener: (command: string, listener: (e: KeyboardEvent) => void) => void;
+};
+declare const useShortcutFormatter: () => UseShortcutFormatterReturn;
+
+declare const useDeviceSupport: () => boolean;
+
+type SoundType = "click" | "error" | "success" | "alert" | "notification" | "swipe";
+declare const useSound: () => {
+    playSound: (type: SoundType) => void;
+};
+
+export { useDeviceSupport, useGridClasses, useShortcutFormatter, useSound };

package/dist/sdk.d.ts

@@ -0,0 +1,24 @@
+declare const useGridClasses: (windowSize: {
+    width: number;
+    height: number;
+}, gridRules: Record<string, Record<string, Record<string, string>>>) => {
+    gridClasses: Record<string, string>;
+    deviceType: "mobile" | "tablet" | "desktop";
+};
+
+type UseShortcutFormatterReturn = {
+    formatKeys: (keys: string[]) => string;
+    getShortcutByCommand: (command: string) => string[];
+    addShortcutListener: (command: string, listener: (e: KeyboardEvent) => void) => void;
+    removeShortcutListener: (command: string, listener: (e: KeyboardEvent) => void) => void;
+};
+declare const useShortcutFormatter: () => UseShortcutFormatterReturn;
+
+declare const useDeviceSupport: () => boolean;
+
+type SoundType = "click" | "error" | "success" | "alert" | "notification" | "swipe";
+declare const useSound: () => {
+    playSound: (type: SoundType) => void;
+};
+
+export { useDeviceSupport, useGridClasses, useShortcutFormatter, useSound };

package/dist/sdk.js

@@ -0,0 +1,260 @@
+import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
+import { UAParser } from 'ua-parser-js';
+
+// src/hooks/useDeviceSupport.tsx
+var useDeviceSupport = () => {
+  const [isSupported, setIsSupported] = useState(true);
+  useEffect(() => {
+    function checkSupport() {
+      const ua = typeof window !== "undefined" ? window.navigator.userAgent : "";
+      const width = typeof window !== "undefined" ? window.innerWidth : 1920;
+      const height = typeof window !== "undefined" ? window.innerHeight : 1080;
+      const isTouch = typeof window !== "undefined" ? "ontouchstart" in window : false;
+      const isMobile = /Mobi|Android|iPhone|iPod/.test(ua) && width <= 767;
+      const isTablet = /iPad|Tablet|Android/.test(ua) && !/Mobile/.test(ua) || isTouch && width >= 600 && width <= 1024;
+      const isTabletPortrait = isTablet && width < height;
+      const isTabletLandscape = isTablet && width > height && width >= 1024 && width <= 1366;
+      const isLaptop = width >= 1024 && !isMobile && (!isTablet || isTabletLandscape);
+      if (isMobile) {
+        setIsSupported(false);
+      } else if (isTabletPortrait) {
+        setIsSupported(false);
+      } else if (isTabletLandscape) {
+        setIsSupported(true);
+      } else if (isLaptop) {
+        setIsSupported(true);
+      } else {
+        setIsSupported(true);
+      }
+    }
+    checkSupport();
+    window.addEventListener("resize", checkSupport);
+    return () => window.removeEventListener("resize", checkSupport);
+  }, []);
+  return isSupported;
+};
+var soundMap = {
+  click: "/sounds/click-tone.wav",
+  alert: "/sounds/error-tone.wav",
+  notification: "/sounds/notification-tone.wav",
+  error: "/sounds/error-tone.wav",
+  success: "/sounds/success-tone.wav",
+  swipe: "/sounds/swipe-tone.wav"
+};
+var useSound = () => {
+  const playSound = useCallback((type) => {
+    if (typeof window === "undefined" || typeof window.Audio === "undefined") {
+      return;
+    }
+    const soundSrc = soundMap[type];
+    const audio = new window.Audio(soundSrc);
+    audio.play().catch((err) => {
+      console.error("Sound playback failed:", err);
+    });
+  }, []);
+  return { playSound };
+};
+var useGridClasses = (windowSize, gridRules) => {
+  const deviceType = useMemo(() => {
+    if (windowSize.width <= 640) return "mobile";
+    if (windowSize.width <= 1024) return "tablet";
+    return "desktop";
+  }, [windowSize]);
+  const gridClasses = useMemo(() => {
+    const classes = {};
+    for (const element in gridRules) {
+      const classRules = gridRules[element];
+      const colSpan = classRules["col-span"][deviceType];
+      classes[element] = `col-span-${deviceType}-${colSpan}`;
+    }
+    return classes;
+  }, [deviceType, gridRules]);
+  return { gridClasses, deviceType };
+};
+var useGridClasses_default = useGridClasses;
+
+// src/utils/constants.ts
+var globalKeyboardShortcuts = [
+  {
+    command: "toggle_theme",
+    shortcut: ["Ctrl", "Shift", "M"],
+    usage: "Toggle between light and dark theme"
+  },
+  {
+    command: "app_switcher",
+    shortcut: ["Ctrl", "Shift", "S"],
+    usage: "Switch between open apps"
+  },
+  {
+    command: "exit_app",
+    shortcut: ["Ctrl", "E"],
+    usage: "Exit or quit the application"
+  },
+  {
+    command: "maximize_app",
+    shortcut: ["Ctrl", "ArrowUp"],
+    usage: "Maximize the application window"
+  },
+  {
+    command: "minimize_app",
+    shortcut: ["Ctrl", "ArrowDown"],
+    usage: "Minimize the application window"
+  },
+  {
+    command: "global_search",
+    shortcut: ["Ctrl", "Shift", "K"],
+    usage: "Open global search"
+  },
+  {
+    command: "toggle_search_mode",
+    shortcut: ["Ctrl", "Shift", "L"],
+    usage: "Enable AI and Voice command (start/stop voice input in search)"
+  },
+  {
+    command: "toggle_control_center",
+    shortcut: ["Ctrl", "Shift", "O"],
+    usage: "Toggle control center panel or drawer"
+  },
+  {
+    command: "arrow_up",
+    shortcut: ["ArrowUp"],
+    usage: "Navigate up in lists, menus and options"
+  },
+  {
+    command: "arrow_down",
+    shortcut: ["ArrowDown"],
+    usage: "Navigate down in lists, menus and options"
+  },
+  {
+    command: "escape_button_action",
+    shortcut: ["Escape"],
+    usage: "Close or go back from any open alert, popup, search, or control center"
+  },
+  {
+    command: "enter_button_action",
+    shortcut: ["Enter"],
+    usage: "Select or confirm the currently focused item"
+  },
+  {
+    command: "toggle_filters",
+    shortcut: ["Ctrl", "Shift", "U"],
+    usage: "To open or close filters of any current active app"
+  },
+  {
+    command: "focus_search",
+    shortcut: ["Ctrl", "k"],
+    usage: "Focus on current app search"
+  },
+  {
+    command: "toggle_all_apps",
+    shortcut: ["Ctrl", "Shift", "A"],
+    usage: "Toggle showing all available apps and plugins"
+  }
+];
+var keyMap = {
+  mac: {
+    ctrl: "\u2318",
+    alt: "\u2325",
+    shift: "\u21E7",
+    enter: "\u23CE",
+    backspace: "\u232B",
+    arrowup: "\u2191",
+    arrowdown: "\u2193"
+  },
+  windows: {
+    ctrl: "Ctrl",
+    alt: "Alt",
+    shift: "Shift",
+    enter: "Enter",
+    backspace: "Backspace",
+    arrowup: "\u2191",
+    arrowdown: "\u2193"
+  },
+  linux: {
+    ctrl: "Ctrl",
+    alt: "Alt",
+    shift: "Shift",
+    enter: "Enter",
+    backspace: "Backspace",
+    arrowup: "\u2191",
+    arrowdown: "\u2193"
+  }
+};
+var detectOS = () => {
+  const parser = new UAParser();
+  const osName = parser.getOS().name?.toLowerCase() || "";
+  if (osName.includes("mac")) return "mac";
+  if (osName.includes("windows")) return "windows";
+  if (osName.includes("linux")) return "linux";
+  return "windows";
+};
+var normalizeKey = (key) => key.toLowerCase();
+var matchShortcut = (event, shortcut, os) => {
+  const keySet = new Set(shortcut.map(normalizeKey));
+  const pressed = [];
+  if (os === "mac") {
+    if (event.metaKey) pressed.push("ctrl");
+  } else {
+    if (event.ctrlKey) pressed.push("ctrl");
+  }
+  if (event.altKey) pressed.push("alt");
+  if (event.shiftKey) pressed.push("shift");
+  if (event.key && !["Control", "Meta", "Alt", "Shift"].includes(event.key)) {
+    pressed.push(normalizeKey(event.key));
+  }
+  if (pressed.length !== shortcut.length) return false;
+  return pressed.every((k) => keySet.has(k));
+};
+var useShortcutFormatter = () => {
+  const [os, setOS] = useState("windows");
+  const listenersRef = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    setOS(detectOS());
+  }, []);
+  useEffect(() => {
+    const handleKeyDown = (event) => {
+      for (const shortcut of globalKeyboardShortcuts) {
+        if (matchShortcut(event, shortcut.shortcut, os)) {
+          const listeners = listenersRef.current.get(shortcut.command);
+          if (listeners) {
+            event.preventDefault();
+            listeners.forEach((cb) => cb(event));
+          }
+        }
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [os]);
+  const formatKeys = (keys = []) => {
+    return keys.map((key) => keyMap[os][key.toLowerCase()] || key.toUpperCase()).join(" + ");
+  };
+  const getShortcutByCommand = (command) => {
+    const found = globalKeyboardShortcuts.find((s) => s.command === command);
+    return found ? found.shortcut : [""];
+  };
+  const addShortcutListener = (command, listener) => {
+    if (!listenersRef.current.has(command)) {
+      listenersRef.current.set(command, /* @__PURE__ */ new Set());
+    }
+    listenersRef.current.get(command).add(listener);
+  };
+  const removeShortcutListener = (command, listener) => {
+    if (listenersRef.current.has(command)) {
+      listenersRef.current.get(command).delete(listener);
+    }
+  };
+  return {
+    formatKeys,
+    getShortcutByCommand,
+    addShortcutListener,
+    removeShortcutListener
+  };
+};
+var useShortcutFormatter_default = useShortcutFormatter;
+
+export { useDeviceSupport, useGridClasses_default as useGridClasses, useShortcutFormatter_default as useShortcutFormatter, useSound };
+//# sourceMappingURL=sdk.js.map
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useDeviceSupport.tsx","../src/hooks/useSound.tsx","../src/hooks/useGridClasses.tsx","../src/utils/constants.ts","../src/hooks/useShortcutFormatter.tsx"],"names":["useState","useEffect"],"mappings":"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","file":"sdk.js","sourcesContent":["import { useEffect, useState } from \"react\";\n\n// Helper function to detect device type and orientation\nexport const useDeviceSupport = () => {\n  const [isSupported, setIsSupported] = useState(true);\n\n  useEffect(() => {\n    function checkSupport() {\n      // Get user agent and screen info\n      const ua =\n        typeof window !== \"undefined\" ? window.navigator.userAgent : \"\";\n      const width = typeof window !== \"undefined\" ? window.innerWidth : 1920;\n      const height = typeof window !== \"undefined\" ? window.innerHeight : 1080;\n      const isTouch =\n        typeof window !== \"undefined\" ? \"ontouchstart\" in window : false;\n\n      // Mobile detection (iOS/Android phones)\n      const isMobile = /Mobi|Android|iPhone|iPod/.test(ua) && width <= 767;\n\n      // Tablet detection (portrait/landscape)\n      const isTablet =\n        (/iPad|Tablet|Android/.test(ua) && !/Mobile/.test(ua)) ||\n        (isTouch && width >= 600 && width <= 1024);\n      // Tablet portrait: width < height, width <= 1024, height > width\n      const isTabletPortrait = isTablet && width < height;\n      // Tablet landscape: width > height, width <= 1366, width >= 1024\n      const isTabletLandscape =\n        isTablet && width > height && width >= 1024 && width <= 1366;\n\n      // Laptop: width >= 1024 (landscape), not touch or not tablet\n      const isLaptop =\n        width >= 1024 && !isMobile && (!isTablet || isTabletLandscape);\n\n      // Support logic:\n      // - Mobile: Not supported\n      // - Tablet portrait: Not supported\n      // - Tablet landscape: Supported\n      // - Laptop: Supported\n\n      if (isMobile) {\n        setIsSupported(false);\n      } else if (isTabletPortrait) {\n        setIsSupported(false);\n      } else if (isTabletLandscape) {\n        setIsSupported(true);\n      } else if (isLaptop) {\n        setIsSupported(true);\n      } else {\n        // Default: allow desktop\n        setIsSupported(true);\n      }\n    }\n\n    checkSupport();\n    window.addEventListener(\"resize\", checkSupport);\n    return () => window.removeEventListener(\"resize\", checkSupport);\n  }, []);\n\n  return isSupported;\n};\n","import { useCallback } from \"react\";\n\ntype SoundType =\n  | \"click\"\n  | \"error\"\n  | \"success\"\n  | \"alert\"\n  | \"notification\"\n  | \"swipe\";\n\nconst soundMap: Record<SoundType, string> = {\n  click: \"/sounds/click-tone.wav\",\n  alert: \"/sounds/error-tone.wav\",\n  notification: \"/sounds/notification-tone.wav\",\n  error: \"/sounds/error-tone.wav\",\n  success: \"/sounds/success-tone.wav\",\n  swipe: \"/sounds/swipe-tone.wav\",\n};\n\nexport const useSound = () => {\n  const playSound = useCallback((type: SoundType) => {\n    if (typeof window === \"undefined\" || typeof window.Audio === \"undefined\") {\n      return;\n    }\n\n    const soundSrc = soundMap[type];\n    const audio = new window.Audio(soundSrc);\n    audio.play().catch((err) => {\n      console.error(\"Sound playback failed:\", err);\n    });\n  }, []);\n\n  return { playSound };\n};\n","import { useMemo } from \"react\";\n\nconst useGridClasses = (\n  windowSize: { width: number; height: number },\n  gridRules: Record<string, Record<string, Record<string, string>>>\n) => {\n  const deviceType: \"mobile\" | \"tablet\" | \"desktop\" = useMemo(() => {\n    if (windowSize.width <= 640) return \"mobile\"; // For mobile (width <= 640px)\n    if (windowSize.width <= 1024) return \"tablet\"; // For tablet (width <= 1024px)\n    return \"desktop\"; // For desktop (width > 1024px)\n  }, [windowSize]);\n\n  const gridClasses: Record<string, string> = useMemo(() => {\n    const classes: Record<string, string> = {};\n    for (const element in gridRules) {\n      const classRules = gridRules[element];\n      // Check for device-specific class (col-span-{deviceType}-{col-span})\n      const colSpan = classRules[\"col-span\"][deviceType];\n      classes[element] = `col-span-${deviceType}-${colSpan}`;\n    }\n    return classes;\n  }, [deviceType, gridRules]);\n\n  return { gridClasses, deviceType };\n};\n\nexport default useGridClasses;\n","export type Shortcut = {\n  command: string;\n  shortcut: string[];\n  usage: string;\n};\n\nexport const globalKeyboardShortcuts: Shortcut[] = [\n  {\n    command: \"toggle_theme\",\n    shortcut: [\"Ctrl\", \"Shift\", \"M\"],\n    usage: \"Toggle between light and dark theme\",\n  },\n  {\n    command: \"app_switcher\",\n    shortcut: [\"Ctrl\", \"Shift\", \"S\"],\n    usage: \"Switch between open apps\",\n  },\n  {\n    command: \"exit_app\",\n    shortcut: [\"Ctrl\", \"E\"],\n    usage: \"Exit or quit the application\",\n  },\n  {\n    command: \"maximize_app\",\n    shortcut: [\"Ctrl\", \"ArrowUp\"],\n    usage: \"Maximize the application window\",\n  },\n  {\n    command: \"minimize_app\",\n    shortcut: [\"Ctrl\", \"ArrowDown\"],\n    usage: \"Minimize the application window\",\n  },\n  {\n    command: \"global_search\",\n    shortcut: [\"Ctrl\", \"Shift\", \"K\"],\n    usage: \"Open global search\",\n  },\n  {\n    command: \"toggle_search_mode\",\n    shortcut: [\"Ctrl\", \"Shift\", \"L\"],\n    usage: \"Enable AI and Voice command (start/stop voice input in search)\",\n  },\n  {\n    command: \"toggle_control_center\",\n    shortcut: [\"Ctrl\", \"Shift\", \"O\"],\n    usage: \"Toggle control center panel or drawer\",\n  },\n  {\n    command: \"arrow_up\",\n    shortcut: [\"ArrowUp\"],\n    usage: \"Navigate up in lists, menus and options\",\n  },\n  {\n    command: \"arrow_down\",\n    shortcut: [\"ArrowDown\"],\n    usage: \"Navigate down in lists, menus and options\",\n  },\n  {\n    command: \"escape_button_action\",\n    shortcut: [\"Escape\"],\n    usage: \"Close or go back from any open alert, popup, search, or control center\",\n  },\n  {\n    command: \"enter_button_action\",\n    shortcut: [\"Enter\"],\n    usage: \"Select or confirm the currently focused item\",\n  },\n  {\n    command: \"toggle_filters\",\n    shortcut: [\"Ctrl\", \"Shift\", \"U\"],\n    usage: \"To open or close filters of any current active app\",\n  },\n  {\n    command: \"focus_search\",\n    shortcut: [\"Ctrl\", \"k\"],\n    usage: \"Focus on current app search\",\n  },\n  {\n    command: \"toggle_all_apps\",\n    shortcut: [\"Ctrl\", \"Shift\", \"A\"],\n    usage: \"Toggle showing all available apps and plugins\",\n  },\n];","import { globalKeyboardShortcuts } from \"../utils/constants\";\nimport { useState, useEffect, useRef } from \"react\";\nimport { UAParser } from \"ua-parser-js\";\n\ntype OS = \"mac\" | \"windows\" | \"linux\";\n\ntype KeyMap = {\n  [key in OS]: {\n    [key: string]: string;\n  };\n};\n\nconst keyMap: KeyMap = {\n  mac: {\n    ctrl: \"⌘\",\n    alt: \"⌥\",\n    shift: \"⇧\",\n    enter: \"⏎\",\n    backspace: \"⌫\",\n    arrowup: \"↑\",\n    arrowdown: \"↓\",\n  },\n  windows: {\n    ctrl: \"Ctrl\",\n    alt: \"Alt\",\n    shift: \"Shift\",\n    enter: \"Enter\",\n    backspace: \"Backspace\",\n    arrowup: \"↑\",\n    arrowdown: \"↓\",\n  },\n  linux: {\n    ctrl: \"Ctrl\",\n    alt: \"Alt\",\n    shift: \"Shift\",\n    enter: \"Enter\",\n    backspace: \"Backspace\",\n    arrowup: \"↑\",\n    arrowdown: \"↓\",\n  },\n};\n\nconst detectOS = (): OS => {\n  const parser = new UAParser();\n  const osName = parser.getOS().name?.toLowerCase() || \"\";\n\n  if (osName.includes(\"mac\")) return \"mac\";\n  if (osName.includes(\"windows\")) return \"windows\";\n  if (osName.includes(\"linux\")) return \"linux\";\n  return \"windows\"; // fallback\n};\n\ntype UseShortcutFormatterReturn = {\n  formatKeys: (keys: string[]) => string;\n  getShortcutByCommand: (command: string) => string[];\n  addShortcutListener: (\n    command: string,\n    listener: (e: KeyboardEvent) => void\n  ) => void;\n  removeShortcutListener: (\n    command: string,\n    listener: (e: KeyboardEvent) => void\n  ) => void;\n};\n\nconst normalizeKey = (key: string) => key.toLowerCase();\n\nconst matchShortcut = (event: KeyboardEvent, shortcut: string[], os: OS) => {\n  // Normalize keys for comparison\n  const keySet = new Set(shortcut.map(normalizeKey));\n  // Map event to normalized keys\n  const pressed: string[] = [];\n  if (os === \"mac\") {\n    if (event.metaKey) pressed.push(\"ctrl\");\n  } else {\n    if (event.ctrlKey) pressed.push(\"ctrl\");\n  }\n  if (event.altKey) pressed.push(\"alt\");\n  if (event.shiftKey) pressed.push(\"shift\");\n  // The main key\n  if (event.key && ![\"Control\", \"Meta\", \"Alt\", \"Shift\"].includes(event.key)) {\n    pressed.push(normalizeKey(event.key));\n  }\n  // Compare sets\n  if (pressed.length !== shortcut.length) return false;\n  return pressed.every((k) => keySet.has(k));\n};\n\nconst useShortcutFormatter = (): UseShortcutFormatterReturn => {\n  const [os, setOS] = useState<OS>(\"windows\");\n  const listenersRef = useRef<Map<string, Set<(e: KeyboardEvent) => void>>>(new Map());\n\n  useEffect(() => {\n    setOS(detectOS());\n  }, []);\n\n  useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      for (const shortcut of globalKeyboardShortcuts) {\n        if (matchShortcut(event, shortcut.shortcut, os)) {\n          const listeners = listenersRef.current.get(shortcut.command);\n          if (listeners) {\n            event.preventDefault(); // Prevent browser defaults for matched shortcuts\n            listeners.forEach((cb) => cb(event));\n          }\n        }\n      }\n    };\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", handleKeyDown);\n    };\n  }, [os]);\n\n  const formatKeys = (keys: string[] = []): string => {\n    return keys\n      .map((key) => keyMap[os][key.toLowerCase()] || key.toUpperCase())\n      .join(\" + \");\n  };\n\n  const getShortcutByCommand = (command: string): string[] => {\n    const found = globalKeyboardShortcuts.find((s) => s.command === command);\n    return found ? found.shortcut : [\"\"];\n  };\n\n  const addShortcutListener = (command: string, listener: (e: KeyboardEvent) => void) => {\n    if (!listenersRef.current.has(command)) {\n      listenersRef.current.set(command, new Set());\n    }\n    listenersRef.current.get(command)!.add(listener);\n  };\n\n  const removeShortcutListener = (command: string, listener: (e: KeyboardEvent) => void) => {\n    if (listenersRef.current.has(command)) {\n      listenersRef.current.get(command)!.delete(listener);\n    }\n  };\n\n  return {\n    formatKeys,\n    getShortcutByCommand,\n    addShortcutListener,\n    removeShortcutListener,\n  };\n};\n\nexport default useShortcutFormatter;\n"]}