@elevasis/ui 2.7.0 → 2.8.1

package/dist/components/index.d.ts

@@ -6984,68 +6984,6 @@ interface SortState {
     direction: SortDirection;
 }
 
-interface ActivityFilters$1 {
-    activityType?: ActivityType | 'all';
-    status?: ActivityStatus | 'all';
-    search?: string;
-}
-
-interface ExecutionLogsFilters$1 {
-    resourceId: string | undefined;
-    status: 'all' | ExecutionStatus;
-    resourceStatus: 'all' | 'dev' | 'prod';
-}
-
-interface CreateApiKeyResponse {
-    id: string;
-    key: string;
-    message: string;
-}
-
-/**
- * GET /api/credentials - List credentials
- */
-declare const ListCredentialsResponseSchema = z.object({
-  credentials: z.array(
-    z.object({
-      id: UuidSchema,
-      name: z.string(),
-      type: z.string(),
-      provider: z.string().nullable(), // OAuth provider or null for non-OAuth
-      createdAt: z.string().datetime()
-    })
-  )
-})
-
-/** API response type for a single credential list item */
-type CredentialListItem = z.infer<typeof ListCredentialsResponseSchema>['credentials'][number]
-
-interface CreateCredentialResponse {
-    id: string;
-    name: string;
-    type: string;
-}
-
-/**
- * Response shape for a single webhook endpoint.
- * NOT strict — response schemas allow extra fields for forward compatibility.
- */
-declare const WebhookEndpointResponseSchema = z.object({
-  id: UuidSchema,
-  organizationId: UuidSchema,
-  key: z.string(),
-  name: z.string(),
-  description: z.string().nullable(),
-  resourceId: z.string().nullable(),
-  status: WebhookEndpointStatusSchema,
-  lastTriggeredAt: z.string().datetime().nullable(),
-  requestCount: z.number().int().min(0),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime()
-})
-
-type WebhookEndpointResponse = z.infer<typeof WebhookEndpointResponseSchema>
-
 interface DocFile {
     path: string;
     frontmatter: {
@@ -7168,6 +7106,68 @@ interface CommandViewGraph$1 {
     edges: CommandViewEdge$1[];
 }
 
+interface CreateApiKeyResponse {
+    id: string;
+    key: string;
+    message: string;
+}
+
+/**
+ * GET /api/credentials - List credentials
+ */
+declare const ListCredentialsResponseSchema = z.object({
+  credentials: z.array(
+    z.object({
+      id: UuidSchema,
+      name: z.string(),
+      type: z.string(),
+      provider: z.string().nullable(), // OAuth provider or null for non-OAuth
+      createdAt: z.string().datetime()
+    })
+  )
+})
+
+/** API response type for a single credential list item */
+type CredentialListItem = z.infer<typeof ListCredentialsResponseSchema>['credentials'][number]
+
+interface CreateCredentialResponse {
+    id: string;
+    name: string;
+    type: string;
+}
+
+/**
+ * Response shape for a single webhook endpoint.
+ * NOT strict — response schemas allow extra fields for forward compatibility.
+ */
+declare const WebhookEndpointResponseSchema = z.object({
+  id: UuidSchema,
+  organizationId: UuidSchema,
+  key: z.string(),
+  name: z.string(),
+  description: z.string().nullable(),
+  resourceId: z.string().nullable(),
+  status: WebhookEndpointStatusSchema,
+  lastTriggeredAt: z.string().datetime().nullable(),
+  requestCount: z.number().int().min(0),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime()
+})
+
+type WebhookEndpointResponse = z.infer<typeof WebhookEndpointResponseSchema>
+
+interface ActivityFilters$1 {
+    activityType?: ActivityType | 'all';
+    status?: ActivityStatus | 'all';
+    search?: string;
+}
+
+interface ExecutionLogsFilters$1 {
+    resourceId: string | undefined;
+    status: 'all' | ExecutionStatus;
+    resourceStatus: 'all' | 'dev' | 'prod';
+}
+
 interface SortableHeaderProps {
     column: string;
     children: React.ReactNode;
@@ -8637,11 +8637,51 @@ interface DealDrawerProps {
 }
 declare function DealDrawer({ deal, config, opened, onClose, renderActions }: DealDrawerProps): react_jsx_runtime.JSX.Element | null;
 
-declare const CrmSidebar: () => react_jsx_runtime.JSX.Element;
+interface CrmSidebarProps {
+    /** Replace the default `CrmSidebarMiddle` with custom middle content. Leave unset for the default layout. */
+    children?: ReactNode;
+}
+declare const CrmSidebar: ({ children }?: CrmSidebarProps) => react_jsx_runtime.JSX.Element;
 
 declare const CrmSidebarTop: () => react_jsx_runtime.JSX.Element;
 
-declare const CrmSidebarMiddle: () => react_jsx_runtime.JSX.Element;
+/**
+ * Shared nav-item shape used by feature sidebar middle components.
+ *
+ * Matches the subset of {@link SubshellNavItemProps} that the existing
+ * hardcoded item arrays use. Consumers import this type alongside the
+ * exported item arrays (e.g. `CRM_ITEMS`) to type their custom arrays.
+ *
+ * @example
+ * import { NavItem, CRM_ITEMS } from '@elevasis/ui/features/crm'
+ *
+ * const customItems: NavItem[] = [
+ *   ...CRM_ITEMS,
+ *   { label: 'Reports', to: '/crm/reports', icon: IconFileText, exact: false },
+ * ]
+ */
+interface NavItem {
+    /** Display label for the nav entry. */
+    label: string;
+    /** Route path the item links to. */
+    to: string;
+    /** Tabler icon component (or any component accepting `size` + `style`). */
+    icon: ComponentType<{
+        size?: number;
+        style?: React.CSSProperties;
+    }>;
+    /**
+     * When `true`, the item is only active when the path matches exactly.
+     * When `false`, it is active for any path that starts with `to`.
+     */
+    exact: boolean;
+}
+
+interface CrmSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link CRM_ITEMS}. */
+    items?: NavItem[];
+}
+declare const CrmSidebarMiddle: ({ items }?: CrmSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 interface PipelineStageSummary {
     stage: DealStage;
@@ -8777,14 +8817,33 @@ interface FeatureNavEntry {
 }
 type FeatureSidebarComponent = ComponentType;
 interface FeatureModule {
+    /** Unique stable identifier for this feature (e.g. `'crm'`, `'delivery'`). */
     key: string;
-    label?: string;
+    /** Feature key used for access-flag gating in the organization model. */
     accessFeatureKey: OrganizationModelFeatureKey;
+    /**
+     * Semantic domain identifiers contributed by this feature.
+     * Merged with surface-derived domain IDs during resolution.
+     */
     domainIds?: OrganizationModelSemanticDomain['id'][];
+    /**
+     * Capability identifiers contributed by this feature.
+     * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
+     * Not queried at runtime — kept for semantic graph completeness so that
+     * capability membership is fully represented in the resolved model even when
+     * a surface does not declare it directly.
+     */
     capabilityIds?: string[];
+    /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
     navEntry?: FeatureNavEntry;
+    /** Sidebar component rendered when a matching subshell route is active. */
     sidebar?: FeatureSidebarComponent;
+    /** Route path prefixes that activate this feature's sidebar and subshell context. */
     subshellRoutes?: string[];
+    /**
+     * Operations-only bridge surface connecting this feature to the organization graph.
+     * Ignored by all other features. Only one manifest in the registry should set this.
+     */
     organizationGraph?: OrganizationGraphFeatureBridge;
 }
 interface OrganizationGraphFeatureBridge {
@@ -8802,11 +8861,19 @@ interface DealDetailPageProps {
 }
 declare function DealDetailPage({ dealId, renderActions, onDealLoaded }: DealDetailPageProps): react_jsx_runtime.JSX.Element;
 
-declare const LeadGenSidebar: () => react_jsx_runtime.JSX.Element;
+interface LeadGenSidebarProps {
+    /** Replace the default `LeadGenSidebarMiddle` with custom middle content. Leave unset for the default layout. */
+    children?: ReactNode;
+}
+declare const LeadGenSidebar: ({ children }?: LeadGenSidebarProps) => react_jsx_runtime.JSX.Element;
 
 declare const LeadGenSidebarTop: () => react_jsx_runtime.JSX.Element;
 
-declare const LeadGenSidebarMiddle: () => react_jsx_runtime.JSX.Element;
+interface LeadGenSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link LEAD_GEN_ITEMS}. */
+    items?: NavItem[];
+}
+declare const LeadGenSidebarMiddle: ({ items }?: LeadGenSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 declare const leadGenManifest: FeatureModule;
 
@@ -8888,15 +8955,25 @@ interface TaskCardProps {
 }
 declare function TaskCard({ task }: TaskCardProps): react_jsx_runtime.JSX.Element;
 
-declare const ProjectsSidebar: () => react_jsx_runtime.JSX.Element;
+interface ProjectsSidebarProps {
+    /** Replace the default `ProjectsSidebarMiddle` with custom middle content. Leave unset for the default layout. */
+    children?: ReactNode;
+}
+declare const ProjectsSidebar: ({ children }?: ProjectsSidebarProps) => react_jsx_runtime.JSX.Element;
 
 declare const ProjectsSidebarTop: () => react_jsx_runtime.JSX.Element;
 
 interface ProjectsSidebarMiddleProps {
     currentPath?: string;
     onNavigate?: (to: string) => void;
-}
-declare const ProjectsSidebarMiddle: ({ currentPath, onNavigate }?: ProjectsSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
+    /** Override the project section items. Defaults to {@link DELIVERY_PROJECT_ITEMS}. */
+    projectItems?: NavItem[];
+    /** Override the work section items. Defaults to {@link DELIVERY_WORK_ITEMS}. */
+    workItems?: NavItem[];
+    /** Override the communication section items. Defaults to {@link DELIVERY_COMMUNICATION_ITEMS}. */
+    communicationItems?: NavItem[];
+}
+declare const ProjectsSidebarMiddle: ({ currentPath, onNavigate, projectItems, workItems, communicationItems }?: ProjectsSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 declare const deliveryManifest: FeatureModule;
 

package/dist/components/index.js

@@ -1,16 +1,16 @@
-import '../chunk-SMJLS23U.js';
+import '../chunk-NYMKWGKN.js';
 import { useBreadcrumbs } from '../chunk-MG3NF7QL.js';
-export { AllTasksPage, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors } from '../chunk-X4HUZINF.js';
-export { LEAD_GEN_ROUTE_LINKS, LIST_TEMPLATE_OPTIONS, LeadGenCompaniesPage, LeadGenContactsPage, LeadGenDeliverabilityPage, LeadGenListDetailPage, LeadGenListsPage, LeadGenOverviewPage, LeadGenRouteShell, LeadGenSidebar, LeadGenSidebarMiddle, LeadGenSidebarTop, buildListConfig, getEnrichmentColor, getStatusColor, leadGenManifest, useDeleteLists } from '../chunk-T6R3V4GW.js';
-export { ActionModal, AgentDefinitionDisplay, AgentExecutionLogs, BaseExecutionLogs, BaseExecutionLogsHeader, BaseExecutionLogsStates, CheckpointGroup, CollapsibleJsonSection, CommandQueueSidebar, CommandQueueSidebarMiddle, CommandQueueSidebarTop, CommandQueueTaskRow, ConfigCard, ContentSections, ContextUsageBadge, ContractDisplay, ExecutionErrorSection, FormFieldRenderer, LogEntry, LogGroup, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, OperationsSidebar, OperationsSidebarMiddle, OperationsSidebarTop, ResourceDefinitionSection, ResourceErrorState, ResourceFilter, ResourceHeader, ResourceNotFoundState, SessionMemory, ToolsListDisplay, WorkflowDefinitionDisplay, WorkflowExecutionLogs, getExecutionStatusConfig, getIcon, getLogLevelConfig, iconMap, operationsManifest, useNewKnowledgeMapLayout } from '../chunk-IFH4L6CR.js';
+export { AllTasksPage, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors } from '../chunk-AQQYVAFK.js';
+export { LEAD_GEN_ROUTE_LINKS, LIST_TEMPLATE_OPTIONS, LeadGenCompaniesPage, LeadGenContactsPage, LeadGenDeliverabilityPage, LeadGenListDetailPage, LeadGenListsPage, LeadGenOverviewPage, LeadGenRouteShell, LeadGenSidebar, LeadGenSidebarMiddle, LeadGenSidebarTop, buildListConfig, getEnrichmentColor, getStatusColor, leadGenManifest, useDeleteLists } from '../chunk-4JPW5U5I.js';
+export { ActionModal, AgentDefinitionDisplay, AgentExecutionLogs, BaseExecutionLogs, BaseExecutionLogsHeader, BaseExecutionLogsStates, CheckpointGroup, CollapsibleJsonSection, CommandQueueSidebar, CommandQueueSidebarMiddle, CommandQueueSidebarTop, CommandQueueTaskRow, ConfigCard, ContentSections, ContextUsageBadge, ContractDisplay, ExecutionErrorSection, FormFieldRenderer, LogEntry, LogGroup, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, OperationsSidebar, OperationsSidebarMiddle, OperationsSidebarTop, ResourceDefinitionSection, ResourceErrorState, ResourceFilter, ResourceHeader, ResourceNotFoundState, SessionMemory, ToolsListDisplay, WorkflowDefinitionDisplay, WorkflowExecutionLogs, getExecutionStatusConfig, getIcon, getLogLevelConfig, iconMap, operationsManifest, useNewKnowledgeMapLayout } from '../chunk-F5QSLYUB.js';
 import '../chunk-ROSMICXG.js';
 import { SubshellLoader, CollapsibleSidebarGroup } from '../chunk-IDACMRGQ.js';
-import { NotificationList } from '../chunk-SBND6P3L.js';
-export { ActivityCard, ActivityFilters as ActivityFiltersBar, ActivityTable, BusinessImpactCard, CostBreakdownCard, CostByModelTable, CostMetricsCard, ErrorAnalysisCard, ErrorBreakdownTable, ExecutionBreakdownTable, ExecutionHealthCard, ExecutionLogsFilters as ExecutionLogsFilterBar, ExecutionLogsTable, NotificationItem, NotificationList, monitoringManifest } from '../chunk-SBND6P3L.js';
-export { ResourceHealthPanel } from '../chunk-VGBMSGYC.js';
-export { SEOSidebar, SEOSidebarMiddle, SEOSidebarTop, seoManifest } from '../chunk-YIWLA2B6.js';
-export { CreateCredentialModal, CredentialList, CredentialSettings, MembershipFeaturePanel, MembershipStatusBadge, OAuthConnectModal, OrganizationMembershipsList, WebhookUrlDisplayModal, settingsManifest } from '../chunk-6FDGVZFL.js';
-export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../chunk-HRIJZKFL.js';
+import { NotificationList } from '../chunk-ZZ35VSNF.js';
+export { ActivityCard, ActivityFilters as ActivityFiltersBar, ActivityTable, BusinessImpactCard, CostBreakdownCard, CostByModelTable, CostMetricsCard, ErrorAnalysisCard, ErrorBreakdownTable, ExecutionBreakdownTable, ExecutionHealthCard, ExecutionLogsFilters as ExecutionLogsFilterBar, ExecutionLogsTable, NotificationItem, NotificationList, monitoringManifest } from '../chunk-ZZ35VSNF.js';
+export { ResourceHealthPanel } from '../chunk-7PDDPNQS.js';
+export { SEOSidebar, SEOSidebarMiddle, SEOSidebarTop, seoManifest } from '../chunk-C2OFFC7J.js';
+export { CreateCredentialModal, CredentialList, CredentialSettings, MembershipFeaturePanel, MembershipStatusBadge, OAuthConnectModal, OrganizationMembershipsList, WebhookUrlDisplayModal, settingsManifest } from '../chunk-KGEYEUR5.js';
+export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../chunk-UE5QQDCR.js';
 export { SortableHeader, TableSelectionToolbar } from '../chunk-TUMSNGTX.js';
 import { PageContainer } from '../chunk-BZZCNLT6.js';
 import { SubshellNavItem } from '../chunk-27COZ5AH.js';
@@ -18,23 +18,23 @@ import { FilterBar } from '../chunk-PDHTXPSF.js';
 export { FilterBar } from '../chunk-PDHTXPSF.js';
 import { CustomModal } from '../chunk-GBMNCNHX.js';
 export { ConfirmationInputModal, ConfirmationModal, CustomModal } from '../chunk-GBMNCNHX.js';
-import { BaseNode, useGraphTheme, BaseEdge, GraphBackground, GraphLegend, GraphFitViewButton } from '../chunk-Z5RHDI7T.js';
-export { AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, BaseEdge, BaseNode, EmptyVisualizer, ExecutionStats, ExecutionStatusBadge, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, VisualizerContainer, WorkflowExecutionTimeline, getGraphBackgroundStyles, useGraphBackgroundStyles, useGraphTheme } from '../chunk-Z5RHDI7T.js';
+import { BaseNode, useGraphTheme, BaseEdge, GraphBackground, GraphLegend, GraphFitViewButton } from '../chunk-CTWYIRKW.js';
+export { AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, BaseEdge, BaseNode, EmptyVisualizer, ExecutionStats, ExecutionStatusBadge, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, VisualizerContainer, WorkflowExecutionTimeline, getGraphBackgroundStyles, useGraphBackgroundStyles, useGraphTheme } from '../chunk-CTWYIRKW.js';
 export { ResourceHealthChart, getHealthColor } from '../chunk-LGKLC5MG.js';
 import '../chunk-KFICYU6S.js';
 import { AppShellLoader } from '../chunk-YEX4MQSY.js';
 import '../chunk-VNUOQQNY.js';
 export { CONTAINER_CONSTANTS, SHARED_VIZ_CONSTANTS } from '../chunk-XA34RETF.js';
-import { useUpdateApiKey, useDeleteApiKey, useCreateApiKey, useListApiKeys, useActivateDeployment, useDeactivateDeployment, useDeleteDeployment, useListDeployments } from '../chunk-TENLM2GN.js';
-import { useCommandViewLayout, usePaginationState, useDeploymentDocs, useResources, useCreateSchedule, useListSchedules, usePauseSchedule, useResumeSchedule, useCancelSchedule, useDeleteSchedule, useDealNotes, useCreateDealNote, useDeals, useSyncDealStage, dealKeys, useMarkAllAsRead, useNotifications, showErrorNotification, showSuccessNotification, showApiErrorNotification } from '../chunk-V6Z2U6ZV.js';
-export { showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification } from '../chunk-V6Z2U6ZV.js';
+import '../chunk-7M2VOCYN.js';
+import { useCommandViewLayout, useUpdateApiKey, useDeleteApiKey, useCreateApiKey, useListApiKeys, usePaginationState, useActivateDeployment, useDeactivateDeployment, useDeleteDeployment, useListDeployments, useDeploymentDocs, useResources, useCreateSchedule, useListSchedules, usePauseSchedule, useResumeSchedule, useCancelSchedule, useDeleteSchedule, useDealNotes, useCreateDealNote, useDeals, useSyncDealStage, dealKeys, useMarkAllAsRead, useNotifications, showErrorNotification, showSuccessNotification, showApiErrorNotification } from '../chunk-4PHPENKX.js';
+export { showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification } from '../chunk-4PHPENKX.js';
 import '../chunk-LXHZYSMQ.js';
 import { Graph_module_css_default, useDirectedChainHighlighting, useNodeSelection, GRAPH_CONSTANTS } from '../chunk-22UVE3RA.js';
 export { Graph_module_css_default as graphStyles } from '../chunk-22UVE3RA.js';
-import '../chunk-N6GYYWY3.js';
+import '../chunk-YCHZ4U5V.js';
 import '../chunk-47YILFON.js';
 import '../chunk-CYXZHBP4.js';
-import '../chunk-SPMKW4VO.js';
+import '../chunk-OPT74SGF.js';
 import { SubshellContainer, SubshellSidebar, SubshellRightSideContainer, SubshellContentContainer } from '../chunk-RX4UWZZR.js';
 import { ListSkeleton, EmptyState, PageTitleCaption, StatCard, CenteredErrorState, CardHeader, ActivityTimeline } from '../chunk-Y3D3WFJG.js';
 export { APIErrorAlert, ActivityTimeline, CardHeader, CenteredErrorState, CollapsibleSection, ContextViewer, CustomSelector, DetailCardSkeleton, ElevasisLoader, EmptyState, FeatureUnavailableState, GlowDot, JsonViewer, ListSkeleton, PageNotFound, PageTitleCaption, ResourceCard, StatCard, StatCardSkeleton, StatsCardSkeleton, StatusBadge, TabCountBadge, TimeRangeSelector, TrendIndicator, catalogItemToResourceDefinition } from '../chunk-Y3D3WFJG.js';

package/dist/features/auth/index.d.ts

@@ -2708,7 +2708,7 @@ interface FeatureGuardProps {
     deniedMessage?: string;
     /**
      * The `useFeatureAccess` hook instance to use for feature flag resolution.
-     * Must be created via `createUseFeatureAccess` from `@repo/ui/hooks`.
+     * Must be created via `createFeatureAccessHook` from `@repo/ui/hooks`.
      */
     useFeatureAccess: UseFeatureAccessHook;
 }
@@ -2716,7 +2716,7 @@ interface FeatureGuardProps {
  * Route guard that restricts access to a named feature.
  *
  * Reads feature flags from the provided `useFeatureAccess` hook instance
- * (created via `createUseFeatureAccess` from `@repo/ui/hooks`). When the
+ * (created via `createFeatureAccessHook` from `@repo/ui/hooks`). When the
  * feature is not allowed, shows a Mantine notification and redirects to '/'.
  *
  * The `restrictedBy === 'membership'` branch surfaces a personal access
@@ -2725,7 +2725,7 @@ interface FeatureGuardProps {
  * @example
  * ```tsx
  * // In your app, create the hook once:
- * export const useFeatureAccess = createUseFeatureAccess({ useInitialization, useOrganization })
+ * export const useFeatureAccess = createFeatureAccessHook({ useInitialization, useOrganization })
  *
  * // Then use the guard:
  * function MonitoringLayout() {

package/dist/features/crm/index.d.ts

@@ -1,12 +1,53 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { z } from 'zod';
 import { ReactNode, ComponentType } from 'react';
+import { z } from 'zod';
 
-declare const CrmSidebar: () => react_jsx_runtime.JSX.Element;
+interface CrmSidebarProps {
+    /** Replace the default `CrmSidebarMiddle` with custom middle content. Leave unset for the default layout. */
+    children?: ReactNode;
+}
+declare const CrmSidebar: ({ children }?: CrmSidebarProps) => react_jsx_runtime.JSX.Element;
 
 declare const CrmSidebarTop: () => react_jsx_runtime.JSX.Element;
 
-declare const CrmSidebarMiddle: () => react_jsx_runtime.JSX.Element;
+/**
+ * Shared nav-item shape used by feature sidebar middle components.
+ *
+ * Matches the subset of {@link SubshellNavItemProps} that the existing
+ * hardcoded item arrays use. Consumers import this type alongside the
+ * exported item arrays (e.g. `CRM_ITEMS`) to type their custom arrays.
+ *
+ * @example
+ * import { NavItem, CRM_ITEMS } from '@elevasis/ui/features/crm'
+ *
+ * const customItems: NavItem[] = [
+ *   ...CRM_ITEMS,
+ *   { label: 'Reports', to: '/crm/reports', icon: IconFileText, exact: false },
+ * ]
+ */
+interface NavItem {
+    /** Display label for the nav entry. */
+    label: string;
+    /** Route path the item links to. */
+    to: string;
+    /** Tabler icon component (or any component accepting `size` + `style`). */
+    icon: ComponentType<{
+        size?: number;
+        style?: React.CSSProperties;
+    }>;
+    /**
+     * When `true`, the item is only active when the path matches exactly.
+     * When `false`, it is active for any path that starts with `to`.
+     */
+    exact: boolean;
+}
+
+declare const CRM_ITEMS: NavItem[];
+interface CrmSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link CRM_ITEMS}. */
+    items?: NavItem[];
+}
+declare const CrmSidebarMiddle: ({ items }?: CrmSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 type Json = string | number | boolean | null | {
     [key: string]: Json | undefined;
@@ -2821,14 +2862,33 @@ interface FeatureNavEntry {
 }
 type FeatureSidebarComponent = ComponentType;
 interface FeatureModule {
+    /** Unique stable identifier for this feature (e.g. `'crm'`, `'delivery'`). */
     key: string;
-    label?: string;
+    /** Feature key used for access-flag gating in the organization model. */
     accessFeatureKey: OrganizationModelFeatureKey;
+    /**
+     * Semantic domain identifiers contributed by this feature.
+     * Merged with surface-derived domain IDs during resolution.
+     */
     domainIds?: OrganizationModelSemanticDomain['id'][];
+    /**
+     * Capability identifiers contributed by this feature.
+     * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
+     * Not queried at runtime — kept for semantic graph completeness so that
+     * capability membership is fully represented in the resolved model even when
+     * a surface does not declare it directly.
+     */
     capabilityIds?: string[];
+    /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
     navEntry?: FeatureNavEntry;
+    /** Sidebar component rendered when a matching subshell route is active. */
     sidebar?: FeatureSidebarComponent;
+    /** Route path prefixes that activate this feature's sidebar and subshell context. */
     subshellRoutes?: string[];
+    /**
+     * Operations-only bridge surface connecting this feature to the organization graph.
+     * Ignored by all other features. Only one manifest in the registry should set this.
+     */
     organizationGraph?: OrganizationGraphFeatureBridge;
 }
 interface OrganizationGraphFeatureBridge {
@@ -2853,5 +2913,5 @@ interface DealDetailPageProps {
 }
 declare function DealDetailPage({ dealId, renderActions, onDealLoaded }: DealDetailPageProps): react_jsx_runtime.JSX.Element;
 
-export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity };
-export type { ActivityFeedWidgetProps, RecentActivityEntry as CrmActivityEntry, CrmActivityKind, CrmOverviewProps, CrmQuickMetrics, MyTasksPanelProps, PipelineFunnelWidgetProps, PipelineStageSummary, QuickCreateActionsProps, SavedViewPreset, SavedViewsPanelProps, TasksDueWidgetProps };
+export { ActivityFeedWidget, CRM_ITEMS, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity };
+export type { ActivityFeedWidgetProps, RecentActivityEntry as CrmActivityEntry, CrmActivityKind, CrmOverviewProps, CrmQuickMetrics, CrmSidebarMiddleProps, MyTasksPanelProps, PipelineFunnelWidgetProps, PipelineStageSummary, QuickCreateActionsProps, SavedViewPreset, SavedViewsPanelProps, TasksDueWidgetProps };

package/dist/features/crm/index.js

@@ -1,17 +1,17 @@
-export { ActivityFeedWidget, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../../chunk-HRIJZKFL.js';
+export { ActivityFeedWidget, CRM_ITEMS, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, DEAL_STAGE_COLORS, DEAL_STAGE_OPTIONS, DealDetailPage, DealsListPage, MetricsStrip, MyTasksPanel, PIPELINE_FUNNEL_ORDER, PipelineFunnelWidget, QuickCreateActions, SAVED_VIEW_PRESETS, SavedViewsPanel, TasksDueWidget, crmManifest, formatDealStageLabel, useCrmPipelineSummary, useCrmQuickMetrics, useRecentCrmActivity } from '../../chunk-UE5QQDCR.js';
 import '../../chunk-TUMSNGTX.js';
 import '../../chunk-BZZCNLT6.js';
 import '../../chunk-27COZ5AH.js';
 import '../../chunk-PDHTXPSF.js';
 import '../../chunk-GBMNCNHX.js';
-import '../../chunk-TENLM2GN.js';
-import '../../chunk-V6Z2U6ZV.js';
+import '../../chunk-7M2VOCYN.js';
+import '../../chunk-4PHPENKX.js';
 import '../../chunk-LXHZYSMQ.js';
 import '../../chunk-22UVE3RA.js';
-import '../../chunk-N6GYYWY3.js';
+import '../../chunk-YCHZ4U5V.js';
 import '../../chunk-47YILFON.js';
 import '../../chunk-CYXZHBP4.js';
-import '../../chunk-SPMKW4VO.js';
+import '../../chunk-OPT74SGF.js';
 import '../../chunk-RX4UWZZR.js';
 import '../../chunk-Y3D3WFJG.js';
 import '../../chunk-3KMDHCAR.js';

package/dist/features/dashboard/index.js

@@ -1,16 +1,16 @@
-export { Dashboard, OperationsOverview, RecentExecutionsByResource, ResourceOverview, UnresolvedErrorsTeaser } from '../../chunk-Z5RHDI7T.js';
+export { Dashboard, OperationsOverview, RecentExecutionsByResource, ResourceOverview, UnresolvedErrorsTeaser } from '../../chunk-CTWYIRKW.js';
 import '../../chunk-LGKLC5MG.js';
 import '../../chunk-KFICYU6S.js';
 import '../../chunk-YEX4MQSY.js';
 import '../../chunk-XA34RETF.js';
-import '../../chunk-TENLM2GN.js';
-import '../../chunk-V6Z2U6ZV.js';
+import '../../chunk-7M2VOCYN.js';
+import '../../chunk-4PHPENKX.js';
 import '../../chunk-LXHZYSMQ.js';
 import '../../chunk-22UVE3RA.js';
-import '../../chunk-N6GYYWY3.js';
+import '../../chunk-YCHZ4U5V.js';
 import '../../chunk-47YILFON.js';
 import '../../chunk-CYXZHBP4.js';
-import '../../chunk-SPMKW4VO.js';
+import '../../chunk-OPT74SGF.js';
 import '../../chunk-RX4UWZZR.js';
 import '../../chunk-Y3D3WFJG.js';
 import '../../chunk-3KMDHCAR.js';

package/dist/features/delivery/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentType } from 'react';
 import { z } from 'zod';
-import { ComponentType } from 'react';
 
 interface HealthStatusCardProps {
     status: string;
@@ -2580,15 +2580,60 @@ interface TaskCardProps {
 }
 declare function TaskCard({ task }: TaskCardProps): react_jsx_runtime.JSX.Element;
 
-declare const ProjectsSidebar: () => react_jsx_runtime.JSX.Element;
+interface ProjectsSidebarProps {
+    /** Replace the default `ProjectsSidebarMiddle` with custom middle content. Leave unset for the default layout. */
+    children?: ReactNode;
+}
+declare const ProjectsSidebar: ({ children }?: ProjectsSidebarProps) => react_jsx_runtime.JSX.Element;
 
 declare const ProjectsSidebarTop: () => react_jsx_runtime.JSX.Element;
 
+/**
+ * Shared nav-item shape used by feature sidebar middle components.
+ *
+ * Matches the subset of {@link SubshellNavItemProps} that the existing
+ * hardcoded item arrays use. Consumers import this type alongside the
+ * exported item arrays (e.g. `CRM_ITEMS`) to type their custom arrays.
+ *
+ * @example
+ * import { NavItem, CRM_ITEMS } from '@elevasis/ui/features/crm'
+ *
+ * const customItems: NavItem[] = [
+ *   ...CRM_ITEMS,
+ *   { label: 'Reports', to: '/crm/reports', icon: IconFileText, exact: false },
+ * ]
+ */
+interface NavItem {
+    /** Display label for the nav entry. */
+    label: string;
+    /** Route path the item links to. */
+    to: string;
+    /** Tabler icon component (or any component accepting `size` + `style`). */
+    icon: ComponentType<{
+        size?: number;
+        style?: React.CSSProperties;
+    }>;
+    /**
+     * When `true`, the item is only active when the path matches exactly.
+     * When `false`, it is active for any path that starts with `to`.
+     */
+    exact: boolean;
+}
+
+declare const DELIVERY_PROJECT_ITEMS: NavItem[];
+declare const DELIVERY_WORK_ITEMS: NavItem[];
+declare const DELIVERY_COMMUNICATION_ITEMS: NavItem[];
 interface ProjectsSidebarMiddleProps {
     currentPath?: string;
     onNavigate?: (to: string) => void;
+    /** Override the project section items. Defaults to {@link DELIVERY_PROJECT_ITEMS}. */
+    projectItems?: NavItem[];
+    /** Override the work section items. Defaults to {@link DELIVERY_WORK_ITEMS}. */
+    workItems?: NavItem[];
+    /** Override the communication section items. Defaults to {@link DELIVERY_COMMUNICATION_ITEMS}. */
+    communicationItems?: NavItem[];
 }
-declare const ProjectsSidebarMiddle: ({ currentPath, onNavigate }?: ProjectsSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
+declare const ProjectsSidebarMiddle: ({ currentPath, onNavigate, projectItems, workItems, communicationItems }?: ProjectsSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
 
 declare const SemanticDomainSchema = DisplayMetadataSchema.extend({
   id: ModelIdSchema,
@@ -2629,14 +2674,33 @@ interface FeatureNavEntry {
 }
 type FeatureSidebarComponent = ComponentType;
 interface FeatureModule {
+    /** Unique stable identifier for this feature (e.g. `'crm'`, `'delivery'`). */
     key: string;
-    label?: string;
+    /** Feature key used for access-flag gating in the organization model. */
     accessFeatureKey: OrganizationModelFeatureKey;
+    /**
+     * Semantic domain identifiers contributed by this feature.
+     * Merged with surface-derived domain IDs during resolution.
+     */
     domainIds?: OrganizationModelSemanticDomain['id'][];
+    /**
+     * Capability identifiers contributed by this feature.
+     * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
+     * Not queried at runtime — kept for semantic graph completeness so that
+     * capability membership is fully represented in the resolved model even when
+     * a surface does not declare it directly.
+     */
     capabilityIds?: string[];
+    /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
     navEntry?: FeatureNavEntry;
+    /** Sidebar component rendered when a matching subshell route is active. */
     sidebar?: FeatureSidebarComponent;
+    /** Route path prefixes that activate this feature's sidebar and subshell context. */
     subshellRoutes?: string[];
+    /**
+     * Operations-only bridge surface connecting this feature to the organization graph.
+     * Ignored by all other features. Only one manifest in the registry should set this.
+     */
     organizationGraph?: OrganizationGraphFeatureBridge;
 }
 interface OrganizationGraphFeatureBridge {
@@ -2669,5 +2733,5 @@ declare const noteTypeColors: Record<string, string>;
 declare function formatStatusLabel(status: string): string;
 declare function calculateProgress(completed: number, total: number): number;
 
-export { AllTasksPage, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors };
+export { AllTasksPage, DELIVERY_COMMUNICATION_ITEMS, DELIVERY_PROJECT_ITEMS, DELIVERY_WORK_ITEMS, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors };
 export type { ProjectsSidebarMiddleProps };

package/dist/features/delivery/index.js

@@ -1,17 +1,17 @@
-export { AllTasksPage, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors } from '../../chunk-X4HUZINF.js';
+export { AllTasksPage, DELIVERY_COMMUNICATION_ITEMS, DELIVERY_PROJECT_ITEMS, DELIVERY_WORK_ITEMS, HealthStatusCard, MilestoneTimeline, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, TaskCard, UpcomingMilestonesPage, calculateProgress, deliveryManifest, formatStatusLabel, milestoneStatusColors, noteTypeColors, projectStatusColors, taskStatusColors, taskTypeColors } from '../../chunk-AQQYVAFK.js';
 import '../../chunk-TUMSNGTX.js';
 import '../../chunk-BZZCNLT6.js';
 import '../../chunk-27COZ5AH.js';
 import '../../chunk-PDHTXPSF.js';
 import '../../chunk-GBMNCNHX.js';
-import '../../chunk-TENLM2GN.js';
-import '../../chunk-V6Z2U6ZV.js';
+import '../../chunk-7M2VOCYN.js';
+import '../../chunk-4PHPENKX.js';
 import '../../chunk-LXHZYSMQ.js';
 import '../../chunk-22UVE3RA.js';
-import '../../chunk-N6GYYWY3.js';
+import '../../chunk-YCHZ4U5V.js';
 import '../../chunk-47YILFON.js';
 import '../../chunk-CYXZHBP4.js';
-import '../../chunk-SPMKW4VO.js';
+import '../../chunk-OPT74SGF.js';
 import '../../chunk-RX4UWZZR.js';
 import '../../chunk-Y3D3WFJG.js';
 import '../../chunk-3KMDHCAR.js';