@qontinui/navigation 0.1.1 → 0.1.3

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,28 +154,52 @@ 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).
+ * ---------------------------------------------------------------------------
+ * The Terminal page is now the primary surface — most users live there running
+ * Claude Code / shell sessions. The previous IA (RUN / OBSERVE / LEARN / BUILD /
+ * WRAPPERS / CONFIGURE / SCHEDULE) was organised around the older
+ * setup→verification→agentic→completion workflow-loop paradigm and surfaced
+ * ~25 items by default, burying the handful a session-driven user touches daily.
+ *
+ * The new IA applies progressive disclosure:
+ *   - WORKSPACE / REVIEW / SYSTEM  — the daily set, expanded by default.
+ *   - SPEND / AUTOMATE / BUILD / INSIGHTS / CONFIGURE / DEV — collapsed; the
+ *     legacy workflow-builder + monitoring + accumulated-intelligence long tail,
+ *     all still one disclosure-click away (nothing is removed; every route and
+ *     tab id is preserved so deep-links and tab-activation keep resolving).
+ *
+ * Both platforms share this structure; per-item `platforms`/`productMode`
+ * filters yield the right view for each (web has no Terminal; runner has no
+ * Dashboard/Runners, etc.).
  */
 
-declare const RUN_ITEMS: NavigationItem[];
-declare const RUN_GROUP: NavigationGroup;
+declare const WORKSPACE_ITEMS: NavigationItem[];
+declare const WORKSPACE_GROUP: NavigationGroup;
 declare const SESSION_ITEMS: NavigationItem[];
 declare const RUNS_ITEMS: NavigationItem[];
-declare const OBSERVE_ITEMS: NavigationItem[];
-declare const OBSERVE_GROUP: NavigationGroup;
-declare const LEARN_ITEMS: NavigationItem[];
-declare const LEARN_GROUP: NavigationGroup;
+declare const REVIEW_ITEMS: NavigationItem[];
+declare const REVIEW_GROUP: NavigationGroup;
+declare const SPEND_ITEMS: NavigationItem[];
+declare const SPEND_GROUP: NavigationGroup;
+declare const AUTOMATE_ITEMS: NavigationItem[];
+declare const AUTOMATE_GROUP: NavigationGroup;
 declare const BUILD_ITEMS: NavigationItem[];
 declare const BUILD_GROUP: NavigationGroup;
-declare const WRAPPERS_ITEMS: NavigationItem[];
-declare const WRAPPERS_GROUP: NavigationGroup;
+declare const INSIGHTS_ITEMS: NavigationItem[];
+declare const INSIGHTS_GROUP: NavigationGroup;
 declare const CONFIGURE_ITEMS: NavigationItem[];
 declare const CONFIGURE_GROUP: NavigationGroup;
-declare const SCHEDULE_ITEMS: NavigationItem[];
-declare const SCHEDULE_GROUP: NavigationGroup;
 declare const DEV_ITEMS: NavigationItem[];
 declare const DEV_GROUP: NavigationGroup;
 declare const SETTINGS_ITEMS: NavigationItem[];
@@ -173,6 +207,9 @@ declare const SYSTEM_ITEMS: NavigationItem[];
 declare const SYSTEM_GROUP: NavigationGroup;
 /**
  * All navigation groups in order.
+ *
+ * Order is deliberate: the expanded daily set (WORKSPACE, REVIEW) leads;
+ * the collapsed legacy/long-tail groups follow; SYSTEM anchors the bottom.
  */
 declare const NAVIGATION_GROUPS: NavigationGroup[];
 /**
@@ -236,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.
@@ -414,4 +465,4 @@ interface NavigationItemShellProps {
  */
 declare function NavigationItemShell({ item, onActivate, children, }: NavigationItemShellProps): React.ReactElement;
 
-export { BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, type IconName, LEARN_GROUP, LEARN_ITEMS, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, OBSERVE_GROUP, OBSERVE_ITEMS, type Platform, RUNS_ITEMS, RUN_GROUP, RUN_ITEMS, SCHEDULE_GROUP, SCHEDULE_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, 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 };
+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,28 +154,52 @@ 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).
+ * ---------------------------------------------------------------------------
+ * The Terminal page is now the primary surface — most users live there running
+ * Claude Code / shell sessions. The previous IA (RUN / OBSERVE / LEARN / BUILD /
+ * WRAPPERS / CONFIGURE / SCHEDULE) was organised around the older
+ * setup→verification→agentic→completion workflow-loop paradigm and surfaced
+ * ~25 items by default, burying the handful a session-driven user touches daily.
+ *
+ * The new IA applies progressive disclosure:
+ *   - WORKSPACE / REVIEW / SYSTEM  — the daily set, expanded by default.
+ *   - SPEND / AUTOMATE / BUILD / INSIGHTS / CONFIGURE / DEV — collapsed; the
+ *     legacy workflow-builder + monitoring + accumulated-intelligence long tail,
+ *     all still one disclosure-click away (nothing is removed; every route and
+ *     tab id is preserved so deep-links and tab-activation keep resolving).
+ *
+ * Both platforms share this structure; per-item `platforms`/`productMode`
+ * filters yield the right view for each (web has no Terminal; runner has no
+ * Dashboard/Runners, etc.).
  */
 
-declare const RUN_ITEMS: NavigationItem[];
-declare const RUN_GROUP: NavigationGroup;
+declare const WORKSPACE_ITEMS: NavigationItem[];
+declare const WORKSPACE_GROUP: NavigationGroup;
 declare const SESSION_ITEMS: NavigationItem[];
 declare const RUNS_ITEMS: NavigationItem[];
-declare const OBSERVE_ITEMS: NavigationItem[];
-declare const OBSERVE_GROUP: NavigationGroup;
-declare const LEARN_ITEMS: NavigationItem[];
-declare const LEARN_GROUP: NavigationGroup;
+declare const REVIEW_ITEMS: NavigationItem[];
+declare const REVIEW_GROUP: NavigationGroup;
+declare const SPEND_ITEMS: NavigationItem[];
+declare const SPEND_GROUP: NavigationGroup;
+declare const AUTOMATE_ITEMS: NavigationItem[];
+declare const AUTOMATE_GROUP: NavigationGroup;
 declare const BUILD_ITEMS: NavigationItem[];
 declare const BUILD_GROUP: NavigationGroup;
-declare const WRAPPERS_ITEMS: NavigationItem[];
-declare const WRAPPERS_GROUP: NavigationGroup;
+declare const INSIGHTS_ITEMS: NavigationItem[];
+declare const INSIGHTS_GROUP: NavigationGroup;
 declare const CONFIGURE_ITEMS: NavigationItem[];
 declare const CONFIGURE_GROUP: NavigationGroup;
-declare const SCHEDULE_ITEMS: NavigationItem[];
-declare const SCHEDULE_GROUP: NavigationGroup;
 declare const DEV_ITEMS: NavigationItem[];
 declare const DEV_GROUP: NavigationGroup;
 declare const SETTINGS_ITEMS: NavigationItem[];
@@ -173,6 +207,9 @@ declare const SYSTEM_ITEMS: NavigationItem[];
 declare const SYSTEM_GROUP: NavigationGroup;
 /**
  * All navigation groups in order.
+ *
+ * Order is deliberate: the expanded daily set (WORKSPACE, REVIEW) leads;
+ * the collapsed legacy/long-tail groups follow; SYSTEM anchors the bottom.
  */
 declare const NAVIGATION_GROUPS: NavigationGroup[];
 /**
@@ -236,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.
@@ -414,4 +465,4 @@ interface NavigationItemShellProps {
  */
 declare function NavigationItemShell({ item, onActivate, children, }: NavigationItemShellProps): React.ReactElement;
 
-export { BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, type IconName, LEARN_GROUP, LEARN_ITEMS, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, OBSERVE_GROUP, OBSERVE_ITEMS, type Platform, RUNS_ITEMS, RUN_GROUP, RUN_ITEMS, SCHEDULE_GROUP, SCHEDULE_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, 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 };
+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 };