@qontinui/navigation 0.1.2 → 0.1.4

package/dist/index.cjs

@@ -69,6 +69,7 @@ __export(index_exports, {
   getNavigationGroups: () => getNavigationGroups,
   getProductMode: () => getProductMode,
   getRunnerNavigation: () => getRunnerNavigation,
+  getShowHiddenItems: () => getShowHiddenItems,
   getWebNavigation: () => getWebNavigation,
   isDevelopmentMode: () => isDevelopmentMode,
   isGroupExpanded: () => isGroupExpanded,
@@ -82,6 +83,7 @@ __export(index_exports, {
   serializeState: () => serializeState,
   setDevelopmentMode: () => setDevelopmentMode,
   setProductMode: () => setProductMode,
+  setShowHiddenItems: () => setShowHiddenItems,
   useNavigationItem: () => useNavigationItem
 });
 module.exports = __toCommonJS(index_exports);
@@ -314,14 +316,18 @@ var AUTOMATE_ITEMS = [
     label: "Scheduled Tasks",
     icon: "Calendar",
     description: "Manage scheduled automation",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only feature — has no web page (web route 404s).
+    platforms: ["runner"]
   },
   {
     id: "triggers",
     label: "Triggers",
     icon: "Zap",
     description: "Event-driven workflow automation",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only feature — has no web page (web route 404s).
+    platforms: ["runner"]
   },
   {
     id: "watchers",
@@ -347,7 +353,11 @@ var BUILD_ITEMS = [
     description: "Build phase-based automation workflows",
     route: "/build/workflows",
     color: "var(--brand-secondary)",
-    productMode: "ai"
+    productMode: "ai",
+    // Advanced surface — demoted from the default nav now that the Terminal is
+    // the primary entry point. Reached via the Terminal "save as workflow"
+    // disclosure or by opting into "Show advanced automation features".
+    hidden: true
   },
   {
     id: "dag-workflow-editor",
@@ -357,7 +367,8 @@ var BUILD_ITEMS = [
     route: "/build/dag-editor",
     color: "#6366f1",
     platforms: ["runner"],
-    productMode: "ai"
+    productMode: "ai",
+    hidden: true
   },
   {
     id: "step-builders",
@@ -366,7 +377,8 @@ var BUILD_ITEMS = [
     description: "Build and browse step templates",
     route: "/build/templates",
     color: "var(--brand-secondary)",
-    productMode: "ai"
+    productMode: "ai",
+    hidden: true
   },
   {
     id: "library",
@@ -411,7 +423,9 @@ var BUILD_ITEMS = [
     description: "Visual GUI automation \u2014 build state machines and inspect runs",
     route: "/vga",
     color: "var(--brand-secondary)",
-    productMode: "both"
+    // Visual GUI automation belongs to Visual mode, not AI Dev (removed from
+    // the AI Dev sidebar on both runner and web).
+    productMode: "visual"
   },
   {
     id: "orchestration-loop",
@@ -420,7 +434,8 @@ var BUILD_ITEMS = [
     description: "Iterative workflow loop with pipeline mode (build/reflect/fix)",
     route: "/orchestration-loop",
     color: "#8B5CF6",
-    platforms: ["runner"]
+    platforms: ["runner"],
+    hidden: true
   },
   {
     id: "demo-video",
@@ -499,7 +514,9 @@ var INSIGHTS_ITEMS = [
     label: "Reflection",
     icon: "RotateCcw",
     description: "Reflection fix effectiveness and history",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only feature — has no web page (web route 404s).
+    platforms: ["runner"]
   },
   {
     id: "architecture",
@@ -1016,10 +1033,20 @@ function setProductMode(mode) {
 function getProductMode() {
   return _productMode;
 }
+var _showHiddenItems = false;
+function setShowHiddenItems(show) {
+  _showHiddenItems = show;
+}
+function getShowHiddenItems() {
+  return _showHiddenItems;
+}
 function isItemAvailable(item, platform) {
   if (item.hiddenInProd && !isDevelopmentMode()) {
     return false;
   }
+  if (item.hidden && !_showHiddenItems) {
+    return false;
+  }
   if (_productMode && item.productMode && item.productMode !== "both" && item.productMode !== _productMode) {
     return false;
   }
@@ -1357,6 +1384,7 @@ function NavigationItemShell({
   getNavigationGroups,
   getProductMode,
   getRunnerNavigation,
+  getShowHiddenItems,
   getWebNavigation,
   isDevelopmentMode,
   isGroupExpanded,
@@ -1370,5 +1398,6 @@ function NavigationItemShell({
   serializeState,
   setDevelopmentMode,
   setProductMode,
+  setShowHiddenItems,
   useNavigationItem
 });

package/dist/index.d.cts

@@ -40,6 +40,16 @@ interface NavigationItem {
     shortcut?: string;
     /** Hide from navigation in production (visible in dev mode with a badge) */
     hiddenInProd?: boolean;
+    /**
+     * Hide from the default navigation as an "advanced" surface. Unlike
+     * `hiddenInProd` (which keys off dev/prod), `hidden` items stay out of the
+     * sidebar until the user opts in via the "Show advanced automation features"
+     * setting (wired through `setShowHiddenItems(true)`). The route/tab id is
+     * still registered, so deep-links and programmatic tab-activation continue
+     * to resolve. Used to demote the workflow-authoring surfaces (workflow
+     * builder, DAG editor, orchestration loop, step builders) now that the
+     * Terminal is the primary entry point. */
+    hidden?: boolean;
     /** Product mode visibility - "ai", "visual", or "both" (default: shown in all modes) */
     productMode?: "ai" | "visual" | "both";
     /** URL path for web routing (e.g., "/build/workflows") */
@@ -144,10 +154,14 @@ type NavigationAction = {
  * Shared navigation group definitions for Qontinui applications.
  * These define the structure and hierarchy of the sidebar navigation.
  *
- * Each item can have three orthogonal visibility dimensions:
+ * Each item can have four orthogonal visibility dimensions:
  *   - platform:    "runner" | "web" | both (default) — which app shows the item
  *   - productMode: "ai" | "visual" | "both" | undefined (default=both) — which product mode
  *   - hiddenInProd: true — dev-only items hidden in production
+ *   - hidden: true — "advanced" surfaces (the workflow-authoring tools) kept
+ *     out of the default sidebar until the user opts in via "Show advanced
+ *     automation features" (setShowHiddenItems). Route/tab id stays registered,
+ *     so deep-links (e.g. the Terminal "save as workflow" disclosure) resolve.
  *
  * ---------------------------------------------------------------------------
  * Terminal-centric information architecture (2026-06).
@@ -259,6 +273,20 @@ declare function setProductMode(mode: ProductMode): void;
  * Get the current product mode filter.
  */
 declare function getProductMode(): ProductMode;
+/**
+ * Set whether items flagged `hidden: true` should be shown.
+ *
+ * Defaults to false, so "advanced" surfaces (the workflow-authoring tools)
+ * are kept out of the default sidebar. Each app wires this to a persisted
+ * "Show advanced automation features" setting (Settings → General). Toggling
+ * it on restores the items without affecting their route/tab registration —
+ * deep-links resolve regardless of this flag.
+ */
+declare function setShowHiddenItems(show: boolean): void;
+/**
+ * Whether `hidden` items are currently shown.
+ */
+declare function getShowHiddenItems(): boolean;
 /**
  * Filter a navigation item based on platform.
  * Returns true if the item should be shown on the given platform.
@@ -437,4 +465,4 @@ interface NavigationItemShellProps {
  */
 declare function NavigationItemShell({ item, onActivate, children, }: NavigationItemShellProps): React.ReactElement;
 
-export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_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 };
+export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_ITEMS, createInitialState, deserializeState, filterGroupForPlatform, filterGroupsForPlatform, filterItemsForPlatform, findItemById, getAllItems, getChildrenForPlatform, getChildrenItems, getItemGroup, getNavigationGroups, getProductMode, getRunnerNavigation, getShowHiddenItems, getWebNavigation, isDevelopmentMode, isGroupExpanded, isItemActive, isItemAvailable, isItemExpanded, isSecondaryOpenFor, isValidIconName, navigationActions, navigationReducer, serializeState, setDevelopmentMode, setProductMode, setShowHiddenItems, useNavigationItem };

package/dist/index.d.ts

@@ -40,6 +40,16 @@ interface NavigationItem {
     shortcut?: string;
     /** Hide from navigation in production (visible in dev mode with a badge) */
     hiddenInProd?: boolean;
+    /**
+     * Hide from the default navigation as an "advanced" surface. Unlike
+     * `hiddenInProd` (which keys off dev/prod), `hidden` items stay out of the
+     * sidebar until the user opts in via the "Show advanced automation features"
+     * setting (wired through `setShowHiddenItems(true)`). The route/tab id is
+     * still registered, so deep-links and programmatic tab-activation continue
+     * to resolve. Used to demote the workflow-authoring surfaces (workflow
+     * builder, DAG editor, orchestration loop, step builders) now that the
+     * Terminal is the primary entry point. */
+    hidden?: boolean;
     /** Product mode visibility - "ai", "visual", or "both" (default: shown in all modes) */
     productMode?: "ai" | "visual" | "both";
     /** URL path for web routing (e.g., "/build/workflows") */
@@ -144,10 +154,14 @@ type NavigationAction = {
  * Shared navigation group definitions for Qontinui applications.
  * These define the structure and hierarchy of the sidebar navigation.
  *
- * Each item can have three orthogonal visibility dimensions:
+ * Each item can have four orthogonal visibility dimensions:
  *   - platform:    "runner" | "web" | both (default) — which app shows the item
  *   - productMode: "ai" | "visual" | "both" | undefined (default=both) — which product mode
  *   - hiddenInProd: true — dev-only items hidden in production
+ *   - hidden: true — "advanced" surfaces (the workflow-authoring tools) kept
+ *     out of the default sidebar until the user opts in via "Show advanced
+ *     automation features" (setShowHiddenItems). Route/tab id stays registered,
+ *     so deep-links (e.g. the Terminal "save as workflow" disclosure) resolve.
  *
  * ---------------------------------------------------------------------------
  * Terminal-centric information architecture (2026-06).
@@ -259,6 +273,20 @@ declare function setProductMode(mode: ProductMode): void;
  * Get the current product mode filter.
  */
 declare function getProductMode(): ProductMode;
+/**
+ * Set whether items flagged `hidden: true` should be shown.
+ *
+ * Defaults to false, so "advanced" surfaces (the workflow-authoring tools)
+ * are kept out of the default sidebar. Each app wires this to a persisted
+ * "Show advanced automation features" setting (Settings → General). Toggling
+ * it on restores the items without affecting their route/tab registration —
+ * deep-links resolve regardless of this flag.
+ */
+declare function setShowHiddenItems(show: boolean): void;
+/**
+ * Whether `hidden` items are currently shown.
+ */
+declare function getShowHiddenItems(): boolean;
 /**
  * Filter a navigation item based on platform.
  * Returns true if the item should be shown on the given platform.
@@ -437,4 +465,4 @@ interface NavigationItemShellProps {
  */
 declare function NavigationItemShell({ item, onActivate, children, }: NavigationItemShellProps): React.ReactElement;
 
-export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_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 };
+export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_ITEMS, createInitialState, deserializeState, filterGroupForPlatform, filterGroupsForPlatform, filterItemsForPlatform, findItemById, getAllItems, getChildrenForPlatform, getChildrenItems, getItemGroup, getNavigationGroups, getProductMode, getRunnerNavigation, getShowHiddenItems, getWebNavigation, isDevelopmentMode, isGroupExpanded, isItemActive, isItemAvailable, isItemExpanded, isSecondaryOpenFor, isValidIconName, navigationActions, navigationReducer, serializeState, setDevelopmentMode, setProductMode, setShowHiddenItems, useNavigationItem };

package/dist/index.js

@@ -226,14 +226,18 @@ var AUTOMATE_ITEMS = [
     label: "Scheduled Tasks",
     icon: "Calendar",
     description: "Manage scheduled automation",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only feature — has no web page (web route 404s).
+    platforms: ["runner"]
   },
   {
     id: "triggers",
     label: "Triggers",
     icon: "Zap",
     description: "Event-driven workflow automation",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only feature — has no web page (web route 404s).
+    platforms: ["runner"]
   },
   {
     id: "watchers",
@@ -259,7 +263,11 @@ var BUILD_ITEMS = [
     description: "Build phase-based automation workflows",
     route: "/build/workflows",
     color: "var(--brand-secondary)",
-    productMode: "ai"
+    productMode: "ai",
+    // Advanced surface — demoted from the default nav now that the Terminal is
+    // the primary entry point. Reached via the Terminal "save as workflow"
+    // disclosure or by opting into "Show advanced automation features".
+    hidden: true
   },
   {
     id: "dag-workflow-editor",
@@ -269,7 +277,8 @@ var BUILD_ITEMS = [
     route: "/build/dag-editor",
     color: "#6366f1",
     platforms: ["runner"],
-    productMode: "ai"
+    productMode: "ai",
+    hidden: true
   },
   {
     id: "step-builders",
@@ -278,7 +287,8 @@ var BUILD_ITEMS = [
     description: "Build and browse step templates",
     route: "/build/templates",
     color: "var(--brand-secondary)",
-    productMode: "ai"
+    productMode: "ai",
+    hidden: true
   },
   {
     id: "library",
@@ -323,7 +333,9 @@ var BUILD_ITEMS = [
     description: "Visual GUI automation \u2014 build state machines and inspect runs",
     route: "/vga",
     color: "var(--brand-secondary)",
-    productMode: "both"
+    // Visual GUI automation belongs to Visual mode, not AI Dev (removed from
+    // the AI Dev sidebar on both runner and web).
+    productMode: "visual"
   },
   {
     id: "orchestration-loop",
@@ -332,7 +344,8 @@ var BUILD_ITEMS = [
     description: "Iterative workflow loop with pipeline mode (build/reflect/fix)",
     route: "/orchestration-loop",
     color: "#8B5CF6",
-    platforms: ["runner"]
+    platforms: ["runner"],
+    hidden: true
   },
   {
     id: "demo-video",
@@ -411,7 +424,9 @@ var INSIGHTS_ITEMS = [
     label: "Reflection",
     icon: "RotateCcw",
     description: "Reflection fix effectiveness and history",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only feature — has no web page (web route 404s).
+    platforms: ["runner"]
   },
   {
     id: "architecture",
@@ -928,10 +943,20 @@ function setProductMode(mode) {
 function getProductMode() {
   return _productMode;
 }
+var _showHiddenItems = false;
+function setShowHiddenItems(show) {
+  _showHiddenItems = show;
+}
+function getShowHiddenItems() {
+  return _showHiddenItems;
+}
 function isItemAvailable(item, platform) {
   if (item.hiddenInProd && !isDevelopmentMode()) {
     return false;
   }
+  if (item.hidden && !_showHiddenItems) {
+    return false;
+  }
   if (_productMode && item.productMode && item.productMode !== "both" && item.productMode !== _productMode) {
     return false;
   }
@@ -1268,6 +1293,7 @@ export {
   getNavigationGroups,
   getProductMode,
   getRunnerNavigation,
+  getShowHiddenItems,
   getWebNavigation,
   isDevelopmentMode,
   isGroupExpanded,
@@ -1281,5 +1307,6 @@ export {
   serializeState,
   setDevelopmentMode,
   setProductMode,
+  setShowHiddenItems,
   useNavigationItem
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/navigation",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Shared navigation structure for Qontinui applications",
   "type": "module",
   "main": "dist/index.cjs",
@@ -10,7 +10,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts && test -s dist/index.d.ts",
+    "build": "tsup src/index.ts --format cjs,esm --dts && node -e \"if(!require('fs').statSync('dist/index.d.ts').size)process.exit(1)\"",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",