Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -8,7 +8,7 @@ Current scope:
- Record current file paths and backing libraries.
- Mark adapter candidates for later `packages/ui` migration.
This inventory does not move components. App code should keep its current imports until a category-specific migration introduces real `@toolctrl/ui/*` adapter exports.
This inventory does not move components. App code should keep its current imports until a category-specific migration introduces real `@hivegrid/ui/*` adapter exports.
Files:
@@ -6,24 +6,24 @@ The boilerplate ships three UI adapter packages under `packages/`:
| Package | Purpose | Current state |
| --- | --- | --- |
| `@toolctrl/ui-app` | App-shell registries (sidebar, breadcrumb, mobile shell, portals) | Skeleton + registry types, no concrete component bindings. |
| `@toolctrl/ui-subframe` | Subframe (design-tool) component placeholder bridge | Placeholder factory only — `createSubframePlaceholder()` returns `{ status: "empty" }`. |
| `@toolctrl/ui-mock` | Fixture-driven mock surface for visual/hot-swap testing | Has `createHotSwapDrillPage()` and is consumed by `scripts/verify-ui-hot-swap.ts`. |
| `@hivegrid/ui-app` | App-shell registries (sidebar, breadcrumb, mobile shell, portals) | Skeleton + registry types, no concrete component bindings. |
| `@hivegrid/ui-subframe` | Subframe (design-tool) component placeholder bridge | Placeholder factory only — `createSubframePlaceholder()` returns `{ status: "empty" }`. |
| `@hivegrid/ui-mock` | Fixture-driven mock surface for visual/hot-swap testing | Has `createHotSwapDrillPage()` and is consumed by `scripts/verify-ui-hot-swap.ts`. |
`packages/foundation` and `packages/view-models` provide the contract these adapters compose against.
## What is NOT wired
- `@toolctrl/ui-subframe` is still a placeholder bridge — no real design-source binding.
- Outside the activation reference route (see below), `apps/web/app/routes/**` does not render through any `@toolctrl/ui-*` registry — concrete components still live in `apps/web/app/components/`.
- The majority of consumer surfaces (admin shell, tenant dashboard, marketing) have not been refactored to consume from `@toolctrl/ui-app`'s page registry.
- `@hivegrid/ui-subframe` is still a placeholder bridge — no real design-source binding.
- Outside the activation reference route (see below), `apps/web/app/routes/**` does not render through any `@hivegrid/ui-*` registry — concrete components still live in `apps/web/app/components/`.
- The majority of consumer surfaces (admin shell, tenant dashboard, marketing) have not been refactored to consume from `@hivegrid/ui-app`'s page registry.
## What IS wired (activation reference)
A minimal hot-swap activation now lives in `apps/web`:
- `apps/web/package.json` depends on `@toolctrl/ui-app`, `@toolctrl/ui-mock`, `@toolctrl/foundation`, `@toolctrl/view-models`.
- `apps/web/app/components/ui/hot-swap/HotSwapPageRenderer.tsx` bridges the descriptor shape from `@toolctrl/ui-mock` to RR7 JSX using `createShellRegistries()` from `@toolctrl/ui-app`.
- `apps/web/package.json` depends on `@hivegrid/ui-app`, `@hivegrid/ui-mock`, `@hivegrid/foundation`, `@hivegrid/view-models`.
- `apps/web/app/components/ui/hot-swap/HotSwapPageRenderer.tsx` bridges the descriptor shape from `@hivegrid/ui-mock` to RR7 JSX using `createShellRegistries()` from `@hivegrid/ui-app`.
- `apps/web/app/routes/hot-swap-demo.tsx` renders `createHotSwapDrillPage()` through the renderer. The route is gated to `NODE_ENV !== "production"` so production surface area is unchanged.
- `apps/web/app/components/ui/hot-swap/HotSwapPageRenderer.test.tsx` asserts the descriptor → DOM mapping (sidebar, breadcrumbs, header, cards, activity).
@@ -35,7 +35,7 @@ The adapter packages were introduced in the Phase-C boundary work to lock down w
Until an activation milestone explicitly enables Subframe (or another design source), the registries stay as a structural placeholder. The cost of registering them in `apps/web` without a real binding would be:
- pulling `@toolctrl/foundation` + `@toolctrl/view-models` into the web bundle for no consumer,
- pulling `@hivegrid/foundation` + `@hivegrid/view-models` into the web bundle for no consumer,
- adding registry warm-up code paths to SSR + hot-swap tests with no real fixture to exercise,
- noise in the hot-swap verifier (`verify:ui-hot-swap`) that would have to allowlist “empty registry” permanently.
@@ -49,9 +49,9 @@ Activate the hot-swap path when **at least one** is true:
## Activation checklist
1. ✓ Add `@toolctrl/ui-app`, `@toolctrl/ui-mock`, `@toolctrl/foundation`, `@toolctrl/view-models` to `apps/web/package.json` `dependencies`. — done.
2. ✓ Pick one low-risk route and refactor it to consume from `@toolctrl/ui-app`'s page registry. — done at `apps/web/app/routes/hot-swap-demo.tsx`, dev-only.
3. ☐ Add `@toolctrl/ui-subframe` to `apps/web/package.json` once it becomes a non-empty bridge.
1. ✓ Add `@hivegrid/ui-app`, `@hivegrid/ui-mock`, `@hivegrid/foundation`, `@hivegrid/view-models` to `apps/web/package.json` `dependencies`. — done.
2. ✓ Pick one low-risk route and refactor it to consume from `@hivegrid/ui-app`'s page registry. — done at `apps/web/app/routes/hot-swap-demo.tsx`, dev-only.
3. ☐ Add `@hivegrid/ui-subframe` to `apps/web/package.json` once it becomes a non-empty bridge.
4. ☐ Promote the mock fixture in `packages/ui-mock/src/index.ts` (`createHotSwapDrillPage`) to a non-mock descriptor source once a design tool is wired.
5. ☐ Refactor a second real consumer surface (admin shell or tenant dashboard) through the renderer to prove cross-surface reuse.
6. ☐ Update `docs/ui-inventory/surface-map.md` to claim the new surfaces as hot-swappable.
@@ -1,7 +1,7 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://toolctrl.local/ui-inventory.schema.json",
"title": "Toolctrl UI Inventory",
"$id": "https://hivegrid.local/ui-inventory.schema.json",
"title": "HiveGrid UI Inventory",
"type": "object",
"additionalProperties": false,
"required": ["schemaVersion", "notes", "components"],
@@ -43,26 +43,29 @@ Machine-readable map: `docs/ui-inventory/surfaces.json`.
| UI ID | Source | Purpose |
| --- | --- | --- |
| `ui.nav.app.dashboard` | `AppSidebar.tsx` | Tenant dashboard. |
| `ui.nav.app.search` | `AppSidebar.tsx` | Tenant global search. |
| `ui.nav.app.automation` | `AppSidebar.tsx` | Tenant automation engine. |
| `ui.nav.app.crm` | `AppSidebar.tsx` | Tenant CRM. |
| `ui.nav.app.leads` | `AppSidebar.tsx` | Tenant lead inbox. |
| `ui.nav.app.projects` | `AppSidebar.tsx` | Tenant projects and pipelines. |
| `ui.nav.app.forms` | `AppSidebar.tsx` | Tenant forms and form-builder. |
| `ui.nav.app.settings` | `AppSidebar.tsx` | Tenant settings. |
| `ui.nav.app.switchToAdmin` | `AppSidebar.tsx` | Tenant-to-admin switch. |
| `ui.nav.admin.dashboard` | `AdminSidebar.tsx` | Admin dashboard. |
| `ui.nav.admin.accounts` | `AdminSidebar.tsx` | Accounts and users. |
| `ui.nav.admin.analytics` | `AdminSidebar.tsx` | Analytics. |
| `ui.nav.admin.entities` | `AdminSidebar.tsx` | Entity builder/runtime. |
| `ui.nav.admin.workflows` | `AdminSidebar.tsx` | Workflow plugin candidate. |
| `ui.nav.admin.api` | `AdminSidebar.tsx` | API key area. |
| `ui.nav.admin.events` | `AdminSidebar.tsx` | Events. |
| `ui.nav.admin.auditTrails` | `AdminSidebar.tsx` | Audit trails. |
| `ui.nav.admin.audit` | `AdminSidebar.tsx` | Audit & Events. |
| `ui.nav.admin.audit.viewer` | `AdminSidebar.tsx` | Audit viewer. |
| `ui.nav.admin.audit.trails` | `AdminSidebar.tsx` | Audit trails. |
| `ui.nav.admin.audit.events` | `AdminSidebar.tsx` | Events. |
| `ui.nav.admin.notifications` | `AdminSidebar.tsx` | Notifications. |
| `ui.nav.admin.featureFlags` | `AdminSidebar.tsx` | Feature flags. |
| `ui.nav.admin.navigation` | `AdminSidebar.tsx` | Navigation configuration. |
| `ui.nav.admin.portals` | `AdminSidebar.tsx` | Portals plugin candidate. |
| `ui.nav.admin.prompts` | `AdminSidebar.tsx` | Prompt builder plugin candidate. |
| `ui.nav.admin.emailMarketing` | `AdminSidebar.tsx` | Email marketing plugin candidate. |
| `ui.nav.admin.knowledgeBase` | `AdminSidebar.tsx` | Knowledge base plugin candidate. |
| `ui.nav.admin.helpDesk` | `AdminSidebar.tsx` | Help desk plugin candidate. |
| `ui.nav.admin.onboarding` | `AdminSidebar.tsx` | Onboarding. |
| `ui.nav.admin.metrics` | `AdminSidebar.tsx` | Metrics. |
| `ui.nav.admin.settings` | `AdminSidebar.tsx` | Admin settings. |
| `ui.nav.admin.switchToApp` | `AdminSidebar.tsx` | Admin-to-app switch. |
| `ui.nav.docs.introduction` | `DocsSidebar.ts` | Docs introduction. |
@@ -5,481 +5,810 @@
"id": "ui.surface.shell",
"kind": "surface",
"label": "Authenticated shell",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "SidebarProvider",
"notes": ["Root authenticated shell surface for app, admin and docs layouts."]
"notes": [
"Root authenticated shell surface for app, admin and docs layouts."
]
},
{
"id": "ui.surface.shell.inset",
"kind": "surface",
"label": "Authenticated shell inset",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "SidebarInset",
"notes": ["Inset area that contains the shell header and main content."]
"notes": [
"Inset area that contains the shell header and main content."
]
},
{
"id": "ui.surface.app.sidebar",
"kind": "surface",
"label": "Tenant app sidebar",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.tsx", "apps/web/app/application/sidebar/AppSidebar.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.tsx",
"apps/web/app/application/sidebar/AppSidebar.tsx"
],
"renderer": "ShadcnAppSidebar",
"notes": ["Use for prompts that target the tenant sidebar container."]
"notes": [
"Use for prompts that target the tenant sidebar container."
]
},
{
"id": "ui.surface.admin.sidebar",
"kind": "surface",
"label": "Admin sidebar",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.tsx", "apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.tsx",
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "ShadcnAppSidebar",
"notes": ["Use for prompts that target the admin sidebar container."]
"notes": [
"Use for prompts that target the admin sidebar container."
]
},
{
"id": "ui.surface.docs.sidebar",
"kind": "surface",
"label": "Docs sidebar",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.tsx", "apps/web/app/application/sidebar/DocsSidebar.ts"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/app-sidebar.tsx",
"apps/web/app/application/sidebar/DocsSidebar.ts"
],
"renderer": "ShadcnAppSidebar",
"notes": ["Use for prompts that target documentation navigation."]
"notes": [
"Use for prompts that target documentation navigation."
]
},
{
"id": "ui.surface.shell.header",
"kind": "surface",
"label": "Shell header",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"
],
"renderer": "ShadcnSidebarLayout",
"notes": ["Top authenticated shell bar containing sidebar trigger, breadcrumb and right actions."]
"notes": [
"Top authenticated shell bar containing sidebar trigger, breadcrumb and right actions."
]
},
{
"id": "ui.surface.shell.breadcrumb",
"kind": "surface",
"label": "Shell breadcrumb area",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"
],
"renderer": "ShadcnSidebarLayout",
"notes": ["Left header area after the sidebar trigger."]
"notes": [
"Left header area after the sidebar trigger."
]
},
{
"id": "ui.surface.shell.breadcrumb.current",
"kind": "surface",
"label": "Current breadcrumb page",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"
],
"renderer": "BreadcrumbPage",
"notes": ["Current page title inside the shell breadcrumb."]
"notes": [
"Current page title inside the shell breadcrumb."
]
},
{
"id": "ui.surface.shell.main",
"kind": "surface",
"label": "Shell main content",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx"
],
"renderer": "main",
"notes": ["Authenticated page content host."]
"notes": [
"Authenticated page content host."
]
},
{
"id": "ui.surface.shell.navActions",
"kind": "surface",
"label": "Header right action area",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx", "apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx",
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Right side of header with search, notifications, AI, profile/more actions."]
"notes": [
"Right side of header with search, notifications, AI, profile/more actions."
]
},
{
"id": "ui.surface.shell.aiAssistant.dialog",
"kind": "surface",
"label": "AI assistant dialog",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "DialogContent",
"notes": ["Dialog surface for AI assistant chat."]
"notes": [
"Dialog surface for AI assistant chat."
]
},
{
"id": "ui.surface.shell.feedback.dialog",
"kind": "surface",
"label": "Feedback dialog",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx", "apps/web/app/components/ui/modals/Modal.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx",
"apps/web/app/components/ui/modals/Modal.tsx"
],
"renderer": "Modal",
"notes": ["Dialog surface for tenant feedback."]
"notes": [
"Dialog surface for tenant feedback."
]
},
{
"id": "ui.surface.commandPalette.portal",
"kind": "surface",
"label": "Command palette portal",
"sourceFiles": ["apps/web/app/components/ui/commandPalettes/CommandPalette.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/components/ui/commandPalettes/CommandPalette.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "KBarPortal",
"notes": ["Portal host for global command palette overlays."]
"notes": [
"Portal host for global command palette overlays."
]
},
{
"id": "ui.surface.commandPalette.search",
"kind": "surface",
"label": "Command palette search",
"sourceFiles": ["apps/web/app/components/ui/commandPalettes/CommandPalette.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/components/ui/commandPalettes/CommandPalette.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "KBarSearch",
"notes": ["Search input inside the global command palette."]
"notes": [
"Search input inside the global command palette."
]
},
{
"id": "ui.surface.commandPalette.results",
"kind": "surface",
"label": "Command palette results",
"sourceFiles": ["apps/web/app/components/ui/commandPalettes/CommandPalette.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/components/ui/commandPalettes/CommandPalette.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "KBarResults",
"notes": ["Scrollable result list inside the global command palette."]
"notes": [
"Scrollable result list inside the global command palette."
]
},
{
"id": "ui.surface.commandPalette.row",
"kind": "surface",
"label": "Command palette row",
"sourceFiles": ["apps/web/app/components/ui/commandPalettes/CommandPalette.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/components/ui/commandPalettes/CommandPalette.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "CommandPaletteResult",
"notes": ["Individual selectable command palette result row."]
"notes": [
"Individual selectable command palette result row."
]
},
{
"id": "ui.action.shell.sidebarTrigger",
"kind": "action",
"label": "Sidebar trigger",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx", "apps/web/app/components/ui/sidebar.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/ShadcnSidebarLayout.tsx",
"apps/web/app/components/ui/sidebar.tsx"
],
"renderer": "SidebarTrigger",
"notes": ["Collapses or opens the shell sidebar."]
"notes": [
"Collapses or opens the shell sidebar."
]
},
{
"id": "ui.action.shell.search",
"kind": "action",
"label": "Header search",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx", "apps/web/app/components/layouts/buttons/SearchButton.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx",
"apps/web/app/components/layouts/buttons/SearchButton.tsx"
],
"renderer": "NavActions/SearchButton",
"notes": ["Opens command palette/search."]
"notes": [
"Opens command palette/search."
]
},
{
"id": "ui.action.shell.aiAssistant",
"kind": "action",
"label": "AI assistant button",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Opens AI assistant dialog when available."]
"notes": [
"Opens AI assistant dialog when available."
]
},
{
"id": "ui.action.shell.aiAssistant.expand",
"kind": "action",
"label": "AI assistant expand",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Expands dialog chat into full chat route."]
"notes": [
"Expands dialog chat into full chat route."
]
},
{
"id": "ui.action.shell.aiAssistant.close",
"kind": "action",
"label": "AI assistant close",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Closes AI assistant dialog."]
"notes": [
"Closes AI assistant dialog."
]
},
{
"id": "ui.action.shell.notifications",
"kind": "action",
"label": "Notifications",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Novu-backed notifications trigger."]
"notes": [
"Novu-backed notifications trigger."
]
},
{
"id": "ui.action.shell.onboarding",
"kind": "action",
"label": "Onboarding",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "OnboardingButton",
"notes": ["Opens onboarding flow when enabled."]
"notes": [
"Opens onboarding flow when enabled."
]
},
{
"id": "ui.action.shell.feedback",
"kind": "action",
"label": "Feedback",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "AddFeedbackButton",
"notes": ["Opens tenant feedback dialog."]
"notes": [
"Opens tenant feedback dialog."
]
},
{
"id": "ui.action.shell.chatSupport",
"kind": "action",
"label": "Chat support",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Opens external support chat when configured."]
"notes": [
"Opens external support chat when configured."
]
},
{
"id": "ui.action.shell.more",
"kind": "action",
"label": "More actions",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx", "apps/web/app/components/layouts/sidebars/shadcn/nav-quick-links.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx",
"apps/web/app/components/layouts/sidebars/shadcn/nav-quick-links.tsx"
],
"renderer": "PopoverTrigger/SidebarMenuButton",
"notes": ["Header or quick-link overflow actions."]
"notes": [
"Header or quick-link overflow actions."
]
},
{
"id": "ui.action.shell.profile",
"kind": "action",
"label": "Profile",
"sourceFiles": ["apps/web/app/components/layouts/buttons/ProfileButton.tsx", "apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/buttons/ProfileButton.tsx",
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "ProfileButton/NavActions",
"notes": ["User profile or profile menu action."]
"notes": [
"User profile or profile menu action."
]
},
{
"id": "ui.action.shell.subscription",
"kind": "action",
"label": "Subscription",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Subscription CTA or menu action."]
"notes": [
"Subscription CTA or menu action."
]
},
{
"id": "ui.action.shell.signOut",
"kind": "action",
"label": "Sign out",
"sourceFiles": ["apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"],
"sourceFiles": [
"apps/web/app/components/layouts/sidebars/shadcn/nav-actions.tsx"
],
"renderer": "NavActions",
"notes": ["Sign-out action in overflow menu."]
"notes": [
"Sign-out action in overflow menu."
]
},
{
"id": "ui.nav.app.dashboard",
"kind": "nav",
"label": "Tenant dashboard nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant dashboard sidebar item."]
"notes": [
"Tenant dashboard sidebar item."
]
},
{
"id": "ui.nav.app.notifications",
"kind": "nav",
"label": "Tenant notifications nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant notification center sidebar item."]
"notes": [
"Tenant notification center sidebar item."
]
},
{
"id": "ui.nav.app.search",
"kind": "nav",
"label": "Tenant global search nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant global search sidebar item."
]
},
{
"id": "ui.nav.app.automation",
"kind": "nav",
"label": "Tenant automation",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "SidebarItem",
"notes": [
"R-P12a typed automation engine entry."
]
},
{
"id": "ui.nav.app.crm",
"kind": "nav",
"label": "Tenant CRM nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant CRM sidebar item."]
"notes": [
"Tenant CRM sidebar item."
]
},
{
"id": "ui.nav.app.leads",
"kind": "nav",
"label": "Tenant lead inbox nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant lead inbox sidebar item."
]
},
{
"id": "ui.nav.app.projects",
"kind": "nav",
"label": "Tenant projects nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant projects and pipelines sidebar item."
]
},
{
"id": "ui.nav.app.emailMarketing",
"kind": "nav",
"label": "Tenant email marketing nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant email marketing sidebar item."]
"notes": [
"Tenant email marketing sidebar item."
]
},
{
"id": "ui.nav.app.emails",
"kind": "nav",
"label": "Tenant email inbox nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant mailbox-sync inbox sidebar item (VA-P23)."
]
},
{
"id": "ui.nav.app.calendar",
"kind": "nav",
"label": "Tenant calendar nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant calendar sidebar item (AK-P16a)."
]
},
{
"id": "ui.nav.app.bookings",
"kind": "nav",
"label": "Tenant bookings nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant bookings sidebar item (AK-P16b)."
]
},
{
"id": "ui.nav.app.forms",
"kind": "nav",
"label": "Tenant forms nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": [
"Tenant forms and form-builder sidebar item (AK-P16c)."
]
},
{
"id": "ui.nav.app.api",
"kind": "nav",
"label": "Tenant API nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant API keys sidebar item."]
"notes": [
"Tenant API keys sidebar item."
]
},
{
"id": "ui.nav.app.workflowEngine",
"kind": "nav",
"label": "Tenant workflow engine nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant workflow engine sidebar item."]
"notes": [
"Tenant workflow engine sidebar item."
]
},
{
"id": "ui.nav.app.credits",
"kind": "nav",
"label": "Tenant credits nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx", "apps/web/app/application/ui/uiRegistry.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx",
"apps/web/app/application/ui/uiRegistry.ts"
],
"renderer": "AppSidebar/NavMain",
"notes": ["Tenant credits sidebar item."]
"notes": [
"Tenant credits sidebar item."
]
},
{
"id": "ui.nav.app.settings",
"kind": "nav",
"label": "Tenant settings nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx"
],
"renderer": "AppSidebar/NavSecondary",
"notes": ["Tenant settings sidebar item."]
"notes": [
"Tenant settings sidebar item."
]
},
{
"id": "ui.nav.app.switchToAdmin",
"kind": "nav",
"label": "Switch to admin nav",
"sourceFiles": ["apps/web/app/application/sidebar/AppSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AppSidebar.tsx"
],
"renderer": "AppSidebar/NavSecondary",
"notes": ["Tenant sidebar admin switch item."]
"notes": [
"Tenant sidebar admin switch item."
]
},
{
"id": "ui.nav.admin.dashboard",
"kind": "nav",
"label": "Admin dashboard nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin dashboard sidebar item."]
"notes": [
"Admin dashboard sidebar item."
]
},
{
"id": "ui.nav.admin.accounts",
"kind": "nav",
"label": "Admin accounts nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin accounts and users sidebar item."]
},
{
"id": "ui.nav.admin.analytics",
"kind": "nav",
"label": "Admin analytics nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin analytics sidebar item."]
"notes": [
"Admin accounts and users sidebar item."
]
},
{
"id": "ui.nav.admin.entities",
"kind": "nav",
"label": "Admin entities nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin entities sidebar item."]
},
{
"id": "ui.nav.admin.workflows",
"kind": "nav",
"label": "Admin workflows nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate workflow sidebar item."]
"notes": [
"Admin entities sidebar item."
]
},
{
"id": "ui.nav.admin.api",
"kind": "nav",
"label": "Admin API nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin API keys sidebar item."]
"notes": [
"Admin API keys sidebar item."
]
},
{
"id": "ui.nav.admin.events",
"id": "ui.nav.admin.audit.viewer",
"kind": "nav",
"label": "Admin events nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"label": "Admin audit viewer nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin events sidebar item."]
"notes": [
"Admin audit viewer child item under Audit & Events."
]
},
{
"id": "ui.nav.admin.auditTrails",
"id": "ui.nav.admin.audit.trails",
"kind": "nav",
"label": "Admin audit trails nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin audit trail sidebar item."]
"notes": [
"Admin audit trail child item under Audit & Events."
]
},
{
"id": "ui.nav.admin.audit.events",
"kind": "nav",
"label": "Admin events nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": [
"Admin events child item under Audit & Events."
]
},
{
"id": "ui.nav.admin.audit",
"kind": "nav",
"label": "Admin Audit & Events nav",
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": [
"Admin Audit & Events sidebar item (AK-P3)."
]
},
{
"id": "ui.nav.admin.notifications",
"kind": "nav",
"label": "Admin notifications nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin notifications sidebar item."]
"notes": [
"Admin notifications sidebar item."
]
},
{
"id": "ui.nav.admin.featureFlags",
"kind": "nav",
"label": "Admin feature flags nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin feature flags sidebar item."]
"notes": [
"Admin feature flags sidebar item."
]
},
{
"id": "ui.nav.admin.navigation",
"kind": "nav",
"label": "Admin navigation nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin navigation/sidebar configuration item."]
},
{
"id": "ui.nav.admin.portals",
"kind": "nav",
"label": "Admin portals nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate portals sidebar item."]
"notes": [
"Admin navigation/sidebar configuration item."
]
},
{
"id": "ui.nav.admin.prompts",
"kind": "nav",
"label": "Admin prompts nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate prompts sidebar item."]
"notes": [
"Disabled plugin-candidate prompts sidebar item."
]
},
{
"id": "ui.nav.admin.emailMarketing",
"kind": "nav",
"label": "Admin email marketing nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate email marketing sidebar item."]
"notes": [
"Disabled plugin-candidate email marketing sidebar item."
]
},
{
"id": "ui.nav.admin.marketing",
"kind": "nav",
"label": "Admin marketing nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate marketing sidebar item."]
"notes": [
"Disabled plugin-candidate marketing sidebar item."
]
},
{
"id": "ui.nav.admin.knowledgeBase",
"kind": "nav",
"label": "Admin knowledge base nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate knowledge base sidebar item."]
"notes": [
"Disabled plugin-candidate knowledge base sidebar item."
]
},
{
"id": "ui.nav.admin.helpDesk",
"kind": "nav",
"label": "Admin help desk nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Disabled plugin-candidate help desk sidebar item."]
},
{
"id": "ui.nav.admin.onboarding",
"kind": "nav",
"label": "Admin onboarding nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin onboarding sidebar item."]
},
{
"id": "ui.nav.admin.metrics",
"kind": "nav",
"label": "Admin metrics nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin metrics sidebar item."]
"notes": [
"Disabled plugin-candidate help desk sidebar item."
]
},
{
"id": "ui.nav.admin.settings",
"kind": "nav",
"label": "Admin settings nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin settings sidebar item."]
"notes": [
"Admin settings sidebar item."
]
},
{
"id": "ui.nav.admin.switchToApp",
"kind": "nav",
"label": "Switch to app nav",
"sourceFiles": ["apps/web/app/application/sidebar/AdminSidebar.tsx"],
"sourceFiles": [
"apps/web/app/application/sidebar/AdminSidebar.tsx"
],
"renderer": "AdminSidebar/NavMain",
"notes": ["Admin sidebar app switch item."]
"notes": [
"Admin sidebar app switch item."
]
},
{
"id": "ui.nav.docs.introduction",
"kind": "nav",
"label": "Docs introduction nav",
"sourceFiles": ["apps/web/app/application/sidebar/DocsSidebar.ts"],
"sourceFiles": [
"apps/web/app/application/sidebar/DocsSidebar.ts"
],
"renderer": "DocsSidebar/NavMain",
"notes": ["Docs introduction navigation item."]
"notes": [
"Docs introduction navigation item."
]
}
]
}
@@ -1,7 +1,7 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://toolctrl.local/ui-surfaces.schema.json",
"title": "Toolctrl UI Surface Map",
"$id": "https://hivegrid.local/ui-surfaces.schema.json",
"title": "HiveGrid UI Surface Map",
"type": "object",
"additionalProperties": false,
"required": ["schemaVersion", "surfaces"],