@qontinui/navigation 0.1.1

package/dist/index.js

@@ -0,0 +1,1276 @@
+// src/groups.ts
+var TOP_LEVEL_ITEMS = [
+  {
+    id: "visual-dashboard",
+    label: "Dashboard",
+    icon: "LayoutDashboard",
+    description: "Visual automation dashboard",
+    route: "/tools/visual-automation",
+    color: "#10B981",
+    productMode: "visual"
+  }
+];
+var TOP_LEVEL_GROUP = {
+  id: "top-level",
+  label: "",
+  items: TOP_LEVEL_ITEMS,
+  defaultExpanded: true
+};
+var RUN_ITEMS = [
+  {
+    id: "prompt-home",
+    label: "Home",
+    icon: "Sparkles",
+    description: "Tell the runner what to do in plain English",
+    route: "/prompt-home",
+    color: "#8B5CF6",
+    productMode: "ai"
+  },
+  {
+    id: "gui-automation",
+    label: "Execute",
+    icon: "Play",
+    description: "Run and schedule workflows",
+    route: "/execute",
+    color: "#10B981",
+    productMode: "visual"
+  },
+  {
+    id: "active",
+    label: "Active",
+    icon: "Activity",
+    description: "Monitor active executions",
+    route: "/runs/active",
+    color: "#4A90D9",
+    productMode: "ai"
+  },
+  {
+    id: "terminal",
+    label: "Terminal",
+    icon: "Terminal",
+    description: "Terminal, Claude Code sessions, and workflow generation",
+    route: "/terminal",
+    color: "#9CA3AF",
+    productMode: "ai",
+    platforms: ["runner"]
+  },
+  {
+    id: "orchestration-loop",
+    label: "Orchestration",
+    icon: "Repeat",
+    description: "Iterative workflow loop with pipeline mode (build/reflect/fix)",
+    route: "/orchestration-loop",
+    color: "#8B5CF6",
+    platforms: ["runner"]
+  },
+  {
+    id: "productivity",
+    label: "Productivity",
+    icon: "ClipboardList",
+    description: "Plan/task board, coordinator dashboard, and knowledge browser",
+    route: "/productivity",
+    color: "#F59E0B",
+    platforms: ["runner"]
+  },
+  {
+    id: "wrappers",
+    label: "Wrappers",
+    icon: "Package",
+    description: "Wrapper configurations and manifest management",
+    route: "/wrappers",
+    color: "#F59E0B",
+    platforms: ["runner"]
+  }
+];
+var RUN_GROUP = {
+  id: "run",
+  label: "RUN",
+  items: RUN_ITEMS,
+  defaultExpanded: true
+};
+var SESSION_ITEMS = [
+  {
+    id: "run-recap",
+    label: "Summary",
+    icon: "ClipboardCheck",
+    description: "Overview, AI summary, and run details",
+    route: "/runs/summary",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-actions",
+    label: "Actions",
+    icon: "Zap",
+    description: "Action execution log",
+    route: "/runs/actions",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-image",
+    label: "Image Recognition",
+    icon: "Image",
+    description: "Visual recognition results",
+    route: "/runs/image-recognition",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-findings",
+    label: "Findings",
+    icon: "FileText",
+    description: "Detected findings and issues",
+    route: "/runs/findings",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-state-explorer",
+    label: "State Explorer",
+    icon: "FileSearch",
+    description: "State exploration results",
+    route: "/runs/state-exploration",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-tests",
+    label: "Test Results",
+    icon: "TestTube",
+    description: "Playwright test results",
+    route: "/runs/test-results",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-ai-output",
+    label: "AI Output",
+    icon: "Bot",
+    description: "AI conversation and responses",
+    route: "/runs/ai-output",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-statistics",
+    label: "Statistics",
+    icon: "BarChart3",
+    description: "Performance metrics",
+    route: "/runs/statistics",
+    color: "#4A90D9"
+  },
+  {
+    id: "run-ai-data",
+    label: "AI Data View",
+    icon: "Database",
+    description: "Structured AI data",
+    route: "/runs/ai-data",
+    color: "#4A90D9"
+  }
+];
+var RUNS_ITEMS = [
+  {
+    id: "runs-history",
+    label: "History",
+    icon: "History",
+    description: "Run history browser",
+    route: "/runs",
+    color: "#4A90D9",
+    platforms: ["web"]
+  }
+];
+var OBSERVE_ITEMS = [
+  {
+    id: "runs",
+    label: "Runs",
+    icon: "History",
+    description: "Browse and manage all runs",
+    hasChildren: true,
+    selectsFirstChild: false,
+    route: "/runs",
+    color: "#4A90D9",
+    productMode: "ai"
+  },
+  {
+    id: "run-findings",
+    label: "Findings",
+    icon: "FileText",
+    description: "Review findings and HITL questions across runs",
+    route: "/runs/findings",
+    color: "#4A90D9",
+    productMode: "ai"
+  },
+  {
+    id: "error-monitor",
+    label: "Error Monitor",
+    icon: "AlertCircle",
+    description: "Monitor and fix application errors from log sources",
+    route: "/tools/error-monitor",
+    color: "#4A90D9",
+    productMode: "ai"
+  },
+  {
+    id: "processes",
+    label: "Processes",
+    icon: "Cpu",
+    description: "Manage and monitor spawned child processes",
+    color: "#06B6D4",
+    productMode: "ai"
+  },
+  {
+    id: "activity-timeline",
+    label: "Activity Timeline",
+    icon: "Activity",
+    description: "Searchable capture history \u2014 everything seen on screen during automation",
+    route: "/observe/activity-timeline",
+    color: "#06B6D4",
+    platforms: ["runner"]
+  },
+  {
+    id: "automation-health",
+    label: "Automation Health",
+    icon: "Activity",
+    description: "UI Bridge automation quality, selector reliability, and improvement recommendations",
+    color: "#10B981",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "llm-analytics",
+    label: "LLM Analytics",
+    icon: "CreditCard",
+    description: "Token usage, cost breakdown, and provider latency analytics",
+    color: "#D97706",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "cost-control",
+    label: "Cost Control",
+    icon: "ShieldAlert",
+    description: "Real-time budget tracking, circuit breakers, and cost anomaly detection",
+    color: "#EF4444",
+    platforms: ["runner"],
+    productMode: "ai"
+  }
+];
+var OBSERVE_GROUP = {
+  id: "observe",
+  label: "OBSERVE",
+  items: OBSERVE_ITEMS,
+  defaultExpanded: false
+};
+var LEARN_ITEMS = [
+  {
+    id: "memory",
+    label: "Memory",
+    icon: "Brain",
+    description: "Cross-session observation memory from past runs",
+    route: "/observe/memory",
+    color: "#8B5CF6",
+    productMode: "ai"
+  },
+  {
+    id: "knowledge-explorer",
+    label: "Knowledge",
+    icon: "Globe",
+    description: "Search external knowledge sources and view acquisition stats \u2014 web search, vulnerability intelligence, API docs",
+    route: "/observe/knowledge",
+    color: "#F97316",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "decision-trail",
+    label: "Decision Trail",
+    icon: "ListChecks",
+    description: "Architectural decision history \u2014 what was decided, why, and what alternatives were considered",
+    route: "/observe/decision-trail",
+    color: "#8B5CF6",
+    productMode: "ai",
+    platforms: ["runner"]
+  },
+  {
+    id: "session-recap",
+    label: "Session Recap",
+    icon: "GitBranch",
+    description: "Semantic dependency map of what was built \u2014 files, types, endpoints, and how they connect",
+    route: "/observe/session-recap",
+    color: "#8B5CF6",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "reflection",
+    label: "Reflection",
+    icon: "RotateCcw",
+    description: "Reflection fix effectiveness and history",
+    productMode: "ai"
+  },
+  {
+    id: "architecture",
+    label: "Architecture",
+    icon: "GitBranch",
+    description: "Component dependency graph and SDK project architecture",
+    productMode: "ai"
+  },
+  {
+    id: "api-surface",
+    label: "API Surface",
+    icon: "Network",
+    description: "Interactive map of every endpoint, command, query, and their connections",
+    color: "#06B6D4",
+    platforms: ["runner"]
+  },
+  {
+    id: "development-intelligence",
+    label: "Dev Intelligence",
+    icon: "Brain",
+    description: "Coverage gap analysis, complexity scoring, drift detection, and dead feature identification",
+    route: "/observe/development-intelligence",
+    color: "#8B5CF6",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "project-explainer",
+    label: "Explainer",
+    icon: "BookOpen",
+    description: "Hierarchical explainer for any project: overview, per-cluster narratives, and per-page deep dives with embedded architecture diagrams. AI side panel for asking questions while reading.",
+    route: "/observe/explainer",
+    color: "#06B6D4",
+    platforms: ["runner"]
+  }
+];
+var LEARN_GROUP = {
+  id: "learn",
+  label: "LEARN",
+  items: LEARN_ITEMS,
+  defaultExpanded: false
+};
+var BUILD_ITEMS = [
+  {
+    id: "unified-workflow-builder",
+    label: "Workflows",
+    icon: "Sparkles",
+    description: "Build phase-based automation workflows",
+    route: "/build/workflows",
+    color: "var(--brand-secondary)",
+    productMode: "ai"
+  },
+  {
+    id: "dag-workflow-editor",
+    label: "DAG Editor",
+    icon: "GitBranch",
+    description: "Visual DAG workflow editor with YAML syntax and graph visualization",
+    route: "/build/dag-editor",
+    color: "#6366f1",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "step-builders",
+    label: "Step Builders",
+    icon: "Layers",
+    description: "Build and browse step templates",
+    route: "/build/templates",
+    color: "var(--brand-secondary)",
+    productMode: "ai"
+  },
+  {
+    id: "library",
+    label: "Library",
+    icon: "BookOpen",
+    description: "Browse saved automation assets",
+    route: "/library",
+    color: "var(--brand-secondary)",
+    productMode: "ai"
+  },
+  {
+    id: "state-machine",
+    label: "UI Bridge States",
+    icon: "Network",
+    description: "Build state machines from UI Bridge SDK apps",
+    route: "/automation-builder/ui-bridge-states",
+    color: "var(--brand-secondary)",
+    productMode: "ai"
+  },
+  {
+    id: "specs",
+    label: "Specs",
+    icon: "ClipboardCheck",
+    description: "Manage and generate UI Bridge page specs for testing and automation",
+    route: "/build/specs",
+    color: "var(--brand-secondary)",
+    productMode: "ai"
+  },
+  {
+    id: "vga",
+    label: "Visual GUI",
+    icon: "Target",
+    description: "Visual GUI automation \u2014 build state machines and inspect runs",
+    route: "/vga",
+    color: "var(--brand-secondary)",
+    productMode: "both"
+  },
+  {
+    id: "demo-video",
+    label: "Demo Videos",
+    icon: "Video",
+    description: "Generate demo videos from UI Bridge page specs with AI narration",
+    route: "/build/demo-videos",
+    color: "var(--brand-secondary)",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "product-tours",
+    label: "Product Tours",
+    icon: "MousePointer2",
+    description: "Generate interactive product tours that auto-demonstrate features",
+    route: "/build/product-tours",
+    color: "var(--brand-secondary)",
+    platforms: ["runner"],
+    productMode: "ai"
+  }
+];
+var BUILD_GROUP = {
+  id: "build",
+  label: "BUILD",
+  items: BUILD_ITEMS,
+  defaultExpanded: false
+};
+var WRAPPERS_ITEMS = [
+  {
+    id: "wrappers",
+    label: "Wrappers",
+    icon: "Package",
+    description: "Install and manage wrapper extensions",
+    route: "/wrappers",
+    color: "#06B6D4",
+    platforms: ["runner"]
+  }
+];
+var WRAPPERS_GROUP = {
+  id: "wrappers",
+  label: "WRAPPERS",
+  items: WRAPPERS_ITEMS,
+  defaultExpanded: true
+};
+var CONFIGURE_ITEMS = [
+  {
+    id: "config-findings",
+    label: "Findings",
+    icon: "Tag",
+    description: "Configure finding patterns",
+    route: "/configure/finding-rules",
+    color: "#FFD700",
+    productMode: "ai"
+  },
+  {
+    id: "config-hooks",
+    label: "Lifecycle Hooks",
+    icon: "Webhook",
+    description: "Configure execution event triggers",
+    productMode: "ai"
+  },
+  {
+    id: "config-ui-bridge",
+    label: "UI Bridge",
+    icon: "Plug",
+    description: "Manage UI Bridge integrations for external apps",
+    productMode: "ai"
+  }
+];
+var CONFIGURE_GROUP = {
+  id: "configure",
+  label: "CONFIGURE",
+  items: CONFIGURE_ITEMS,
+  defaultExpanded: false
+};
+var SCHEDULE_ITEMS = [
+  {
+    id: "triggers",
+    label: "Triggers",
+    icon: "Zap",
+    description: "Event-driven workflow automation",
+    productMode: "ai"
+  },
+  {
+    id: "tasks",
+    label: "Scheduled Tasks",
+    icon: "Calendar",
+    description: "Manage scheduled automation",
+    productMode: "ai"
+  },
+  {
+    id: "watchers",
+    label: "Watchers",
+    icon: "Eye",
+    description: "Scheduled reactive agents that monitor the activity timeline",
+    route: "/observe/watchers",
+    color: "#06B6D4",
+    platforms: ["runner"]
+  },
+  {
+    id: "event-history",
+    label: "Event History",
+    icon: "Radio",
+    description: "Workflow event bus, queue status, circuit breaker",
+    hiddenInProd: true,
+    productMode: "ai"
+  }
+];
+var SCHEDULE_GROUP = {
+  id: "schedule",
+  label: "SCHEDULE",
+  items: SCHEDULE_ITEMS,
+  defaultExpanded: false
+};
+var DEV_ITEMS = [
+  {
+    id: "generator-eval",
+    label: "Generator Eval",
+    icon: "FlaskConical",
+    description: "Evaluate and improve workflow generation accuracy",
+    hiddenInProd: true,
+    color: "#8B5CF6",
+    productMode: "ai"
+  },
+  {
+    id: "autoresearch",
+    label: "Autoresearch",
+    icon: "FlaskConical",
+    description: "Compare workflow architectures with statistical A/B testing",
+    hiddenInProd: true,
+    color: "#8B5CF6",
+    productMode: "ai",
+    platforms: ["runner"]
+  },
+  {
+    id: "meta-optimizer",
+    label: "Meta-Optimizer",
+    icon: "Sparkles",
+    description: "Review and apply AI-generated recommendations to improve prompts, architecture, and generation rules",
+    hiddenInProd: true,
+    color: "#D97706",
+    productMode: "ai",
+    platforms: ["runner"]
+  },
+  {
+    id: "online-learning",
+    label: "Online Learning",
+    icon: "Brain",
+    description: "Monitor bandit model routing, drift detection, step credit attribution, and strategy evolution",
+    hiddenInProd: true,
+    color: "#06B6D4",
+    productMode: "ai",
+    platforms: ["runner"]
+  },
+  {
+    id: "skills",
+    label: "Skills",
+    icon: "Zap",
+    description: "Review and approve auto-extracted procedural skills learned from successful workflow runs",
+    hiddenInProd: true,
+    color: "#F59E0B",
+    productMode: "ai",
+    platforms: ["runner"]
+  },
+  {
+    id: "image-quality-tests",
+    label: "Image Quality",
+    icon: "Image",
+    description: "View and manage image quality test images",
+    hiddenInProd: true,
+    color: "#8B5CF6",
+    platforms: ["runner"],
+    productMode: "ai"
+  },
+  {
+    id: "accessibility-explorer",
+    label: "Accessibility",
+    icon: "Accessibility",
+    description: "Inspect and interact with native desktop accessibility trees via UIA, AT-SPI, or AX APIs",
+    color: "#06B6D4",
+    platforms: ["runner"]
+  }
+];
+var DEV_GROUP = {
+  id: "dev",
+  label: "DEV",
+  items: DEV_ITEMS,
+  defaultExpanded: false
+};
+var SETTINGS_ITEMS = [
+  {
+    id: "settings-account",
+    label: "Account",
+    icon: "User",
+    description: "User account settings",
+    route: "/settings/account",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-ai",
+    label: "AI Providers",
+    icon: "Bot",
+    description: "Configure AI providers and models",
+    route: "/settings/ai",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-agentic",
+    label: "Advanced AI",
+    icon: "Brain",
+    description: "Memory compression, retry, and task routing",
+    route: "/settings/agentic",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-self-healing",
+    label: "Self-Healing",
+    icon: "ShieldCheck",
+    description: "Self-healing automation settings",
+    route: "/settings/self-healing",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-world-state-verifier",
+    label: "World State Verifier",
+    icon: "Eye",
+    description: "VLM judge for agentic action verification (CUA-WSM)",
+    route: "/settings/world-state-verifier",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-playwright",
+    label: "Playwright",
+    icon: "FlaskConical",
+    description: "Playwright configuration",
+    route: "/settings/playwright",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-mobile",
+    label: "Mobile",
+    icon: "Monitor",
+    description: "Mobile device (ADB) settings",
+    route: "/settings/mobile",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-discovery",
+    label: "App Discovery",
+    icon: "Radar",
+    description: "Custom ports for the UI Bridge app scanner",
+    route: "/settings/discovery",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-mcp",
+    label: "MCP Servers",
+    icon: "Wifi",
+    description: "Model Context Protocol server configuration",
+    route: "/settings/mcp",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-log-sources",
+    label: "Log Sources",
+    icon: "FolderOpen",
+    description: "Global log source configuration with AI selection",
+    route: "/settings/log-sources",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-general",
+    label: "General",
+    icon: "Wrench",
+    description: "General application settings",
+    route: "/settings/general",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-storage",
+    label: "Storage",
+    icon: "HardDrive",
+    description: "Data storage settings",
+    route: "/settings/storage",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-backup",
+    label: "Backup",
+    icon: "Archive",
+    description: "Backup and restore",
+    route: "/settings/backup",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-instances",
+    label: "Runner Instances",
+    icon: "Server",
+    description: "Spawn placement and per-instance configs",
+    route: "/settings/instances",
+    color: "#FFD700",
+    platforms: ["runner"]
+  },
+  {
+    id: "settings-updates",
+    label: "Updates",
+    icon: "Download",
+    description: "Check for updates",
+    route: "/settings/updates",
+    color: "#FFD700"
+  },
+  {
+    id: "settings-security",
+    label: "Security",
+    icon: "ShieldAlert",
+    description: "Sandboxing, policies, and audit",
+    route: "/settings/security",
+    color: "#FFD700",
+    platforms: ["runner"]
+  },
+  {
+    id: "settings-debug",
+    label: "Debug",
+    icon: "FlaskConical",
+    description: "Debug and diagnostics",
+    route: "/settings/debug",
+    color: "#FFD700"
+  }
+];
+var SYSTEM_ITEMS = [
+  {
+    id: "runners",
+    label: "Runners",
+    icon: "Server",
+    description: "Connected desktop runners",
+    platforms: ["web"],
+    route: "/runners",
+    color: "#10B981"
+  },
+  {
+    id: "settings",
+    label: "Settings",
+    icon: "Settings",
+    hasChildren: true,
+    selectsFirstChild: true,
+    description: "Application settings",
+    route: "/settings",
+    color: "#FFD700"
+  },
+  {
+    id: "help",
+    label: "Help",
+    icon: "HelpCircle",
+    description: "Documentation and support",
+    route: "/help",
+    color: "#9CA3AF"
+  }
+];
+var SYSTEM_GROUP = {
+  id: "system",
+  label: "SYSTEM",
+  items: SYSTEM_ITEMS,
+  defaultExpanded: true
+};
+var NAVIGATION_GROUPS = [
+  TOP_LEVEL_GROUP,
+  RUN_GROUP,
+  OBSERVE_GROUP,
+  LEARN_GROUP,
+  BUILD_GROUP,
+  WRAPPERS_GROUP,
+  CONFIGURE_GROUP,
+  SCHEDULE_GROUP,
+  DEV_GROUP,
+  SYSTEM_GROUP
+];
+var CHILDREN_MAP = {
+  runs: [...SESSION_ITEMS, ...RUNS_ITEMS],
+  settings: SETTINGS_ITEMS
+};
+function getChildrenItems(parentId) {
+  return CHILDREN_MAP[parentId] || [];
+}
+function getAllItems() {
+  const items = [];
+  for (const group of NAVIGATION_GROUPS) {
+    items.push(...group.items);
+  }
+  for (const children of Object.values(CHILDREN_MAP)) {
+    items.push(...children);
+  }
+  return items;
+}
+function findItemById(id) {
+  return getAllItems().find((item) => item.id === id);
+}
+function getItemGroup(itemId) {
+  for (const group of NAVIGATION_GROUPS) {
+    if (group.items.some((item) => item.id === itemId)) {
+      return group;
+    }
+  }
+  for (const [parentId, children] of Object.entries(CHILDREN_MAP)) {
+    if (children.some((item) => item.id === itemId)) {
+      for (const group of NAVIGATION_GROUPS) {
+        if (group.items.some((item) => item.id === parentId)) {
+          return group;
+        }
+      }
+    }
+  }
+  return void 0;
+}
+
+// src/icons.ts
+var ICON_NAMES = [
+  // Common
+  "Video",
+  "Play",
+  "Activity",
+  "History",
+  "Bot",
+  "Settings",
+  "HelpCircle",
+  "ChevronDown",
+  "ChevronRight",
+  "AlertCircle",
+  "Bug",
+  // Observe/Session
+  "ScrollText",
+  "LayoutDashboard",
+  "ClipboardCheck",
+  "Zap",
+  "Radio",
+  "Radar",
+  "Image",
+  "ClipboardList",
+  "FileText",
+  "FileSearch",
+  "TestTube",
+  "BarChart3",
+  "Database",
+  "Cloud",
+  "Accessibility",
+  // Build
+  "BookOpen",
+  "BookText",
+  "CheckCircle2",
+  "Sparkles",
+  "MousePointer2",
+  "Layers",
+  "FlaskConical",
+  "Camera",
+  "GitBranch",
+  "Network",
+  "Globe",
+  "Code",
+  "Puzzle",
+  "ShieldCheck",
+  "Wifi",
+  "Terminal",
+  "ListChecks",
+  // Configure
+  "FolderOpen",
+  "Tag",
+  "Plug",
+  // Schedule
+  "Calendar",
+  // System/Settings
+  "User",
+  "HardDrive",
+  "Wrench",
+  "Download",
+  "Archive",
+  "Monitor",
+  "Palette",
+  "Bell",
+  "Key",
+  "CreditCard",
+  "Brain",
+  "Eye",
+  "Webhook",
+  "RotateCcw",
+  "Cpu",
+  "Target",
+  "Repeat",
+  "ShieldAlert",
+  // Web / shared
+  "MessageSquare",
+  "Server",
+  "Workflow",
+  "Package"
+];
+function isValidIconName(name) {
+  return ICON_NAMES.includes(name);
+}
+
+// src/platform.ts
+var _isDevelopmentMode = false;
+function setDevelopmentMode(isDev) {
+  _isDevelopmentMode = isDev;
+}
+function isDevelopmentMode() {
+  return _isDevelopmentMode;
+}
+var _productMode = null;
+function setProductMode(mode) {
+  _productMode = mode;
+}
+function getProductMode() {
+  return _productMode;
+}
+function isItemAvailable(item, platform) {
+  if (item.hiddenInProd && !isDevelopmentMode()) {
+    return false;
+  }
+  if (_productMode && item.productMode && item.productMode !== "both" && item.productMode !== _productMode) {
+    return false;
+  }
+  if (!item.platforms || item.platforms.length === 0) {
+    return true;
+  }
+  return item.platforms.includes(platform);
+}
+function filterItemsForPlatform(items, platform) {
+  return items.filter((item) => isItemAvailable(item, platform));
+}
+function filterGroupForPlatform(group, platform) {
+  if (group.platforms && !group.platforms.includes(platform)) {
+    return { ...group, items: [] };
+  }
+  return {
+    ...group,
+    items: filterItemsForPlatform(group.items, platform)
+  };
+}
+function filterGroupsForPlatform(groups, platform) {
+  return groups.map((group) => filterGroupForPlatform(group, platform)).filter((group) => group.items.length > 0);
+}
+function getNavigationGroups(platform) {
+  return filterGroupsForPlatform(NAVIGATION_GROUPS, platform);
+}
+function getChildrenForPlatform(parentId, platform) {
+  const children = CHILDREN_MAP[parentId] || [];
+  return filterItemsForPlatform(children, platform);
+}
+function getRunnerNavigation() {
+  return getNavigationGroups("runner");
+}
+function getWebNavigation() {
+  return getNavigationGroups("web");
+}
+
+// src/state.ts
+function createInitialState(options) {
+  return {
+    activeItemId: options?.activeItemId ?? null,
+    expandedGroups: new Set(options?.expandedGroups ?? ["run", "observe", "learn", "build", "configure", "system"]),
+    expandedItems: new Set(options?.expandedItems ?? []),
+    secondarySidebar: {
+      isOpen: false,
+      parentId: null,
+      items: []
+    },
+    isCollapsed: options?.isCollapsed ?? false
+  };
+}
+function navigationReducer(state, action) {
+  switch (action.type) {
+    case "SET_ACTIVE":
+      return {
+        ...state,
+        activeItemId: action.itemId
+      };
+    case "TOGGLE_GROUP": {
+      const newExpandedGroups = new Set(state.expandedGroups);
+      if (newExpandedGroups.has(action.groupId)) {
+        newExpandedGroups.delete(action.groupId);
+      } else {
+        newExpandedGroups.add(action.groupId);
+      }
+      return {
+        ...state,
+        expandedGroups: newExpandedGroups
+      };
+    }
+    case "TOGGLE_ITEM": {
+      const newExpandedItems = new Set(state.expandedItems);
+      if (newExpandedItems.has(action.itemId)) {
+        newExpandedItems.delete(action.itemId);
+      } else {
+        newExpandedItems.add(action.itemId);
+      }
+      return {
+        ...state,
+        expandedItems: newExpandedItems
+      };
+    }
+    case "EXPAND_GROUP": {
+      const newExpandedGroups = new Set(state.expandedGroups);
+      newExpandedGroups.add(action.groupId);
+      return {
+        ...state,
+        expandedGroups: newExpandedGroups
+      };
+    }
+    case "COLLAPSE_GROUP": {
+      const newExpandedGroups = new Set(state.expandedGroups);
+      newExpandedGroups.delete(action.groupId);
+      return {
+        ...state,
+        expandedGroups: newExpandedGroups
+      };
+    }
+    case "OPEN_SECONDARY":
+      return {
+        ...state,
+        secondarySidebar: {
+          isOpen: true,
+          parentId: action.parentId,
+          items: action.items
+        }
+      };
+    case "CLOSE_SECONDARY":
+      return {
+        ...state,
+        secondarySidebar: {
+          isOpen: false,
+          parentId: null,
+          items: []
+        }
+      };
+    case "TOGGLE_SIDEBAR_COLLAPSE":
+      return {
+        ...state,
+        isCollapsed: !state.isCollapsed
+      };
+    case "SET_SIDEBAR_COLLAPSED":
+      return {
+        ...state,
+        isCollapsed: action.collapsed
+      };
+    default:
+      return state;
+  }
+}
+var navigationActions = {
+  setActive: (itemId) => ({
+    type: "SET_ACTIVE",
+    itemId
+  }),
+  toggleGroup: (groupId) => ({
+    type: "TOGGLE_GROUP",
+    groupId
+  }),
+  toggleItem: (itemId) => ({
+    type: "TOGGLE_ITEM",
+    itemId
+  }),
+  expandGroup: (groupId) => ({
+    type: "EXPAND_GROUP",
+    groupId
+  }),
+  collapseGroup: (groupId) => ({
+    type: "COLLAPSE_GROUP",
+    groupId
+  }),
+  openSecondary: (parentId, items) => ({
+    type: "OPEN_SECONDARY",
+    parentId,
+    items
+  }),
+  closeSecondary: () => ({
+    type: "CLOSE_SECONDARY"
+  }),
+  toggleSidebarCollapse: () => ({
+    type: "TOGGLE_SIDEBAR_COLLAPSE"
+  }),
+  setSidebarCollapsed: (collapsed) => ({
+    type: "SET_SIDEBAR_COLLAPSED",
+    collapsed
+  })
+};
+function isGroupExpanded(state, groupId) {
+  return state.expandedGroups.has(groupId);
+}
+function isItemExpanded(state, itemId) {
+  return state.expandedItems.has(itemId);
+}
+function isItemActive(state, itemId) {
+  return state.activeItemId === itemId;
+}
+function isSecondaryOpenFor(state, parentId) {
+  return state.secondarySidebar.isOpen && state.secondarySidebar.parentId === parentId;
+}
+function serializeState(state) {
+  return JSON.stringify({
+    activeItemId: state.activeItemId,
+    expandedGroups: Array.from(state.expandedGroups),
+    expandedItems: Array.from(state.expandedItems),
+    isCollapsed: state.isCollapsed
+  });
+}
+function deserializeState(json) {
+  try {
+    const data = JSON.parse(json);
+    return {
+      activeItemId: data.activeItemId ?? null,
+      expandedGroups: new Set(data.expandedGroups ?? []),
+      expandedItems: new Set(data.expandedItems ?? []),
+      isCollapsed: data.isCollapsed ?? false
+    };
+  } catch {
+    return null;
+  }
+}
+var STORAGE_KEYS = {
+  state: "qontinui-navigation-state",
+  collapsed: "qontinui-sidebar-collapsed",
+  expandedGroups: "qontinui-sidebar-groups",
+  activeTab: "qontinui-active-tab"
+};
+
+// src/react.tsx
+import * as React from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+var cachedUseUIElement = void 0;
+function resolveUseUIElement() {
+  if (cachedUseUIElement !== void 0) return cachedUseUIElement;
+  try {
+    const g = globalThis;
+    const maybeRequire = g.require;
+    const dynamicRequire = typeof maybeRequire === "function" ? maybeRequire : (
+      // Last-resort: build a require via Function. Works in classic Node
+      // CJS contexts; throws in bare-ESM, caught below.
+      (() => {
+        try {
+          return new Function("m", "return require(m)");
+        } catch {
+          return null;
+        }
+      })()
+    );
+    if (!dynamicRequire) {
+      cachedUseUIElement = null;
+      return null;
+    }
+    let mod;
+    try {
+      mod = dynamicRequire("@qontinui/ui-bridge/react");
+    } catch {
+      mod = dynamicRequire("@qontinui/ui-bridge");
+    }
+    const m = mod;
+    const fn = m && m.useUIElement || m && m.default && m.default.useUIElement || null;
+    cachedUseUIElement = typeof fn === "function" ? fn : null;
+  } catch {
+    cachedUseUIElement = null;
+  }
+  return cachedUseUIElement;
+}
+function useNavigationItem(item, onActivate) {
+  const activateRef = React.useRef(onActivate);
+  React.useEffect(() => {
+    activateRef.current = onActivate;
+  }, [onActivate]);
+  const useUIElementFn = resolveUseUIElement();
+  const hookFn = useUIElementFn ?? (() => void 0);
+  const handleClick = React.useCallback(() => {
+    activateRef.current();
+  }, []);
+  const options = React.useMemo(
+    () => ({
+      id: `nav:${item.id}`,
+      type: "menuitem",
+      label: item.label,
+      // Standard click action — the registry and control executor both
+      // understand this keyword. The actual handler lives in customActions
+      // so the executor can dispatch it without a DOM element reference.
+      actions: ["click"],
+      customActions: {
+        click: {
+          id: "click",
+          label: `Activate ${item.label}`,
+          description: item.description,
+          handler: handleClick
+        }
+      },
+      // Semantic hint for the Phase 1 content-element discovery pass.
+      // The registry carries this verbatim; snapshots expose it to UI
+      // Bridge clients.
+      variant: "navigation-item",
+      // Richer disambiguation hints — harmless for apps that don't use
+      // them, valuable for NL-based agents.
+      contextPath: item.description ? `navigation > ${item.label}` : void 0,
+      // Don't attempt auto-register via a ref (we don't have one here);
+      // the hook falls back to data-ui-bridge-id polling which is what the
+      // existing nav buttons already stamp.
+      autoRegister: true
+    }),
+    [item.id, item.label, item.description, handleClick]
+  );
+  hookFn(options);
+}
+function NavigationItemShell({
+  item,
+  onActivate,
+  children
+}) {
+  useNavigationItem(item, onActivate);
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+export {
+  BUILD_GROUP,
+  BUILD_ITEMS,
+  CHILDREN_MAP,
+  CONFIGURE_GROUP,
+  CONFIGURE_ITEMS,
+  DEV_GROUP,
+  DEV_ITEMS,
+  ICON_NAMES,
+  LEARN_GROUP,
+  LEARN_ITEMS,
+  NAVIGATION_GROUPS,
+  NavigationItemShell,
+  OBSERVE_GROUP,
+  OBSERVE_ITEMS,
+  RUNS_ITEMS,
+  RUN_GROUP,
+  RUN_ITEMS,
+  SCHEDULE_GROUP,
+  SCHEDULE_ITEMS,
+  SESSION_ITEMS,
+  SETTINGS_ITEMS,
+  STORAGE_KEYS,
+  SYSTEM_GROUP,
+  SYSTEM_ITEMS,
+  WRAPPERS_GROUP,
+  WRAPPERS_ITEMS,
+  createInitialState,
+  deserializeState,
+  filterGroupForPlatform,
+  filterGroupsForPlatform,
+  filterItemsForPlatform,
+  findItemById,
+  getAllItems,
+  getChildrenForPlatform,
+  getChildrenItems,
+  getItemGroup,
+  getNavigationGroups,
+  getProductMode,
+  getRunnerNavigation,
+  getWebNavigation,
+  isDevelopmentMode,
+  isGroupExpanded,
+  isItemActive,
+  isItemAvailable,
+  isItemExpanded,
+  isSecondaryOpenFor,
+  isValidIconName,
+  navigationActions,
+  navigationReducer,
+  serializeState,
+  setDevelopmentMode,
+  setProductMode,
+  useNavigationItem
+};