sootsim 0.1.154 → 0.1.155

package/dist-lib/menu.mjs

@@ -0,0 +1,434 @@
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+
+// src/menu.ts
+var SOOTSIM_ENGINE_EVENT_NAME = "sootsim:engine-event";
+var SOOTSIM_SHELL_COMMAND_NAME = "sootsim:shell-command";
+function buildSootSimMenuDefs(state, deviceChoices) {
+  return [
+    appMenu(),
+    fileMenu(state, deviceChoices),
+    editMenu(),
+    deviceMenu(state, deviceChoices),
+    debugMenu(),
+    windowMenu(state),
+    helpMenu()
+  ];
+}
+function appMenu() {
+  return {
+    label: "SootSim",
+    brand: true,
+    items: [
+      { label: "About SootSim", action: "about" },
+      { type: "separator" },
+      {
+        label: "Preferences...",
+        accelerator: "CmdOrCtrl+,",
+        action: "preferences",
+        browserAccelerator: true,
+        shortcutLabel: "settings",
+        showInShortcutDocs: true
+      },
+      { type: "separator" },
+      {
+        label: "Hide SootSim",
+        accelerator: "CmdOrCtrl+H",
+        action: "hide",
+        hiddenIn: "browser"
+      },
+      {
+        label: "Hide Others",
+        accelerator: "CmdOrCtrl+Alt+H",
+        action: "hide-others",
+        hiddenIn: "browser"
+      },
+      { label: "Show All", action: "unhide", hiddenIn: "browser" },
+      { type: "separator" },
+      {
+        label: "Quit SootSim",
+        accelerator: "CmdOrCtrl+Q",
+        action: "quit",
+        hiddenIn: "browser"
+      }
+    ]
+  };
+}
+function fileMenu(state, deviceChoices) {
+  return {
+    label: "File",
+    notMinimal: true,
+    items: [
+      { label: "New Window", accelerator: "CmdOrCtrl+N", action: "new-window" },
+      {
+        label: "New Simulator",
+        hiddenIn: "browser",
+        items: buildSootSimDeviceChoiceDefs(state.currentDevice, deviceChoices, {
+          action: "new-simulator"
+        })
+      },
+      {
+        label: "Close Window",
+        accelerator: "CmdOrCtrl+W",
+        action: "close-window",
+        hiddenIn: "browser"
+      },
+      { type: "separator" },
+      { label: "Save Screen", accelerator: "CmdOrCtrl+S", action: "save-screen" },
+      { label: "Copy Screen", accelerator: "CmdOrCtrl+Alt+C", action: "copy-screen" },
+      { type: "separator" },
+      {
+        label: "Record",
+        accelerator: "Ctrl+CmdOrCtrl+R",
+        action: "toggle-recording",
+        browserAccelerator: true,
+        shortcutLabel: "start/stop recording",
+        showInShortcutDocs: true
+      }
+    ]
+  };
+}
+function editMenu() {
+  return {
+    label: "Edit",
+    hiddenIn: "browser",
+    items: [
+      { label: "Undo", accelerator: "CmdOrCtrl+Z", action: "undo" },
+      { label: "Redo", accelerator: "CmdOrCtrl+Shift+Z", action: "redo" },
+      { type: "separator" },
+      { label: "Cut", accelerator: "CmdOrCtrl+X", action: "cut" },
+      { label: "Copy", accelerator: "CmdOrCtrl+C", action: "copy" },
+      { label: "Paste", accelerator: "CmdOrCtrl+V", action: "paste" },
+      { label: "Select All", accelerator: "CmdOrCtrl+A", action: "select-all" }
+    ]
+  };
+}
+function deviceMenu(state, deviceChoices) {
+  return {
+    label: "Device",
+    items: [
+      { label: "Restart", accelerator: "CmdOrCtrl+R", action: "reload" },
+      { label: "Erase All Content and Settings...", action: "erase-all" },
+      { type: "separator" },
+      {
+        label: "Home",
+        accelerator: "Shift+CmdOrCtrl+H",
+        action: "home",
+        browserAccelerator: true,
+        shortcutLabel: "go home",
+        showInShortcutDocs: true
+      },
+      {
+        label: "Lock",
+        accelerator: "CmdOrCtrl+L",
+        action: "lock",
+        shortcutLabel: "lock / unlock",
+        showInShortcutDocs: true
+      },
+      { label: "Shake", accelerator: "Ctrl+CmdOrCtrl+Z", action: "shake" },
+      {
+        label: "App Switcher",
+        accelerator: "Ctrl+Shift+CmdOrCtrl+H",
+        action: "app-switcher",
+        browserAccelerator: true,
+        shortcutLabel: "app switcher",
+        showInShortcutDocs: true
+      },
+      { type: "separator" },
+      { label: "Trigger Screenshot", action: "screenshot" },
+      { type: "separator" },
+      ...buildSootSimDeviceChoiceDefs(state.currentDevice, deviceChoices, {
+        action: "switch-device"
+      })
+    ]
+  };
+}
+function debugMenu() {
+  return {
+    label: "Debug",
+    items: [
+      {
+        label: "Toggle Devtools",
+        accelerator: "Alt+I",
+        action: "toggle-devtools",
+        browserAccelerator: true,
+        showInShortcutDocs: true
+      },
+      {
+        label: "Inspect",
+        accelerator: "CmdOrCtrl+I",
+        action: "toggle-inspect",
+        browserAccelerator: true
+      },
+      { type: "separator" },
+      {
+        label: "Open Chrome Devtools",
+        accelerator: "CmdOrCtrl+Alt+I",
+        action: "open-devtools",
+        hiddenIn: "browser",
+        shortcutLabel: "developer tools",
+        showInShortcutDocs: true
+      },
+      { type: "separator" },
+      {
+        label: "Clear Cache and Reload",
+        accelerator: "CmdOrCtrl+Shift+R",
+        action: "clear-cache"
+      },
+      { label: "Clear Local Storage", action: "clear-localstorage" },
+      { label: "Clear IndexedDB", action: "clear-indexeddb" },
+      { label: "Clear Service Workers", action: "clear-serviceworkers" },
+      { type: "separator" },
+      { label: "Open User Data Folder", action: "open-userdata", hiddenIn: "browser" }
+    ]
+  };
+}
+function windowMenu(state) {
+  return {
+    label: "Window",
+    items: [
+      {
+        label: "Minimize",
+        accelerator: "CmdOrCtrl+M",
+        action: "minimize",
+        hiddenIn: "browser"
+      },
+      {
+        label: "Close",
+        accelerator: "CmdOrCtrl+W",
+        action: "close-window",
+        hiddenIn: "browser"
+      },
+      { type: "separator" },
+      {
+        label: "Toggle Appearance",
+        accelerator: "Shift+CmdOrCtrl+A",
+        action: "toggle-appearance",
+        browserAccelerator: true,
+        shortcutLabel: "toggle appearance",
+        showInShortcutDocs: true
+      },
+      { type: "separator" },
+      {
+        label: "Show Device Bezels",
+        type: "checkbox",
+        checked: state.showBezels,
+        action: "toggle-bezels"
+      },
+      {
+        label: "Show Top Bar",
+        type: "checkbox",
+        checked: state.showTopBar,
+        enabled: state.showBezels,
+        action: "toggle-topbar"
+      },
+      {
+        label: "Screenshot",
+        type: "checkbox",
+        checked: state.screenshotMode,
+        action: "toggle-screenshot-mode",
+        hiddenIn: "electron"
+      },
+      {
+        label: "3D",
+        type: "checkbox",
+        checked: state.threeMode,
+        action: "toggle-three-mode",
+        hiddenIn: "electron"
+      },
+      {
+        label: "Stay On Top",
+        type: "checkbox",
+        checked: state.stayOnTop,
+        action: "toggle-stay-on-top",
+        hiddenIn: "browser"
+      },
+      { type: "separator" },
+      {
+        label: "Physical Size",
+        accelerator: "CmdOrCtrl+1",
+        type: "radio",
+        checked: state.scaleMode === "physical",
+        action: "scale-physical"
+      },
+      {
+        label: "Point Accurate",
+        accelerator: "CmdOrCtrl+2",
+        type: "radio",
+        checked: state.scaleMode === "point",
+        action: "scale-point"
+      },
+      {
+        label: "Pixel Accurate",
+        accelerator: "CmdOrCtrl+3",
+        type: "radio",
+        checked: state.scaleMode === "pixel",
+        action: "scale-pixel"
+      },
+      {
+        label: "Fit Screen",
+        accelerator: "CmdOrCtrl+0",
+        type: "radio",
+        checked: state.scaleMode === "fit",
+        action: "scale-fit"
+      }
+    ]
+  };
+}
+function helpMenu() {
+  return {
+    label: "Help",
+    notMinimal: true,
+    items: [
+      { label: "sootsim Website", action: "open-website" },
+      {
+        label: "Send Feedback...",
+        accelerator: "CmdOrCtrl+Shift+I",
+        action: "open-devtools-report",
+        showInShortcutDocs: true
+      },
+      { label: "Show Onboarding", action: "open-devtools-onboard" }
+    ]
+  };
+}
+function buildSootSimDeviceChoiceDefs(currentDevice, deviceChoices, options) {
+  const items = [];
+  let lastPlatform = "";
+  const isStateful = options.action === "switch-device";
+  for (const choice of deviceChoices) {
+    if (lastPlatform && choice.platform !== lastPlatform) items.push({ type: "separator" });
+    lastPlatform = choice.platform;
+    if (isStateful) {
+      items.push({
+        label: choice.label,
+        type: "radio",
+        checked: choice.model === currentDevice,
+        action: options.action,
+        actionPayload: choice.model
+      });
+    } else {
+      items.push({
+        label: choice.label,
+        action: options.action,
+        actionPayload: choice.model
+      });
+    }
+  }
+  return items;
+}
+function shouldIncludeItemForPlatform(item, platform) {
+  if (item.hiddenIn === platform) return false;
+  if (!item.accelerator || !item.action) return false;
+  if (platform === "browser") return item.browserAccelerator === true;
+  return true;
+}
+function shouldIncludeItemInDocs(item, platform) {
+  if (!item.showInShortcutDocs) return false;
+  if (platform === "browser" && !item.browserAccelerator) return false;
+  return true;
+}
+function collectMenuShortcutsFromDefs(menus, platform, includeItem) {
+  const entries = [];
+  const visit = (menuLabel, items) => {
+    for (const item of items) {
+      if (item.type === "separator") continue;
+      if (item.items?.length) visit(menuLabel, item.items);
+      if (!includeItem(item, platform)) continue;
+      const { accelerator, action } = item;
+      if (!accelerator || !action) continue;
+      entries.push({
+        menuLabel,
+        label: item.shortcutLabel ?? item.label,
+        accelerator,
+        action,
+        actionPayload: item.actionPayload
+      });
+    }
+  };
+  for (const menu of menus) {
+    if (menu.hiddenIn === platform) continue;
+    visit(menu.label, menu.items);
+  }
+  return entries;
+}
+function getMenuShortcutEntriesFromDefs(menus, platform) {
+  return collectMenuShortcutsFromDefs(menus, platform, shouldIncludeItemForPlatform);
+}
+function getMenuShortcutEntries(state, deviceChoices, platform) {
+  return getMenuShortcutEntriesFromDefs(
+    buildSootSimMenuDefs(state, deviceChoices),
+    platform
+  );
+}
+function getShortcutDocSections(state, deviceChoices, platform) {
+  return getShortcutDocSectionsFromDefs(
+    buildSootSimMenuDefs(state, deviceChoices),
+    platform
+  );
+}
+function getShortcutDocSectionsFromDefs(menus, platform) {
+  const sections = [];
+  const byMenu = /* @__PURE__ */ new Map();
+  for (const entry of collectMenuShortcutsFromDefs(
+    menus,
+    platform,
+    shouldIncludeItemInDocs
+  )) {
+    const items = byMenu.get(entry.menuLabel) ?? [];
+    items.push({
+      keys: formatAccelerator(entry.accelerator),
+      label: entry.label
+    });
+    byMenu.set(entry.menuLabel, items);
+  }
+  for (const [title, entries] of byMenu) {
+    sections.push({
+      title: title.toLowerCase(),
+      entries
+    });
+  }
+  return sections;
+}
+function formatAccelerator(accel) {
+  return accel.replace(/CmdOrCtrl\+/g, "\u2318").replace(/Ctrl\+/g, "\u2303").replace(/Alt\+/g, "\u2325").replace(/Shift\+/g, "\u21E7").replace(/Left/g, "\u2190").replace(/Right/g, "\u2192").replace(/Up/g, "\u2191").replace(/Down/g, "\u2193");
+}
+var ARROW_KEYS = {
+  Left: "arrowleft",
+  Right: "arrowright",
+  Up: "arrowup",
+  Down: "arrowdown"
+};
+function normalizeAcceleratorKey(key) {
+  return ARROW_KEYS[key] ?? key.toLowerCase();
+}
+function normalizeEventKey(key) {
+  return key.toLowerCase();
+}
+function matchesAccelerator(event, accelerator) {
+  const tokens = accelerator.split("+");
+  const keyToken = tokens[tokens.length - 1];
+  const wantsCmdOrCtrl = tokens.includes("CmdOrCtrl");
+  const wantsCtrl = tokens.includes("Ctrl");
+  const wantsAlt = tokens.includes("Alt");
+  const wantsShift = tokens.includes("Shift");
+  if (!keyToken) return false;
+  if (event.altKey !== wantsAlt) return false;
+  if (event.shiftKey !== wantsShift) return false;
+  const hasCmdOrCtrl = event.metaKey || event.ctrlKey;
+  if (wantsCmdOrCtrl && !hasCmdOrCtrl) return false;
+  if (!wantsCmdOrCtrl && event.metaKey) return false;
+  if (wantsCtrl && !event.ctrlKey) return false;
+  if (!wantsCtrl && !wantsCmdOrCtrl && event.ctrlKey) return false;
+  return normalizeEventKey(event.key) === normalizeAcceleratorKey(keyToken);
+}
+export {
+  SOOTSIM_ENGINE_EVENT_NAME,
+  SOOTSIM_SHELL_COMMAND_NAME,
+  buildSootSimDeviceChoiceDefs,
+  buildSootSimMenuDefs,
+  formatAccelerator,
+  getMenuShortcutEntries,
+  getMenuShortcutEntriesFromDefs,
+  getShortcutDocSections,
+  getShortcutDocSectionsFromDefs,
+  matchesAccelerator
+};

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.154 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.155 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sootsim",
-  "version": "0.1.154",
+  "version": "0.1.155",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",
@@ -29,6 +29,12 @@
       "source": "./src/metro-plugin.ts",
       "default": "./dist-lib/metro.cjs"
     },
+    "./menu": {
+      "source": "./src/menu.ts",
+      "bun": "./src/menu.ts",
+      "import": "./dist-lib/menu.mjs",
+      "default": "./dist-lib/menu.cjs"
+    },
     "./skills": {
       "source": "./src/skills/registry.ts",
       "default": "./dist-lib/skills.cjs"