@elevasis/ui 2.6.0 → 2.8.0

package/dist/index.js

@@ -1,14 +1,14 @@
 import './chunk-XCYKC6OZ.js';
 export { useAvailablePresets } from './chunk-VNUOQQNY.js';
 export { AGENT_CONSTANTS, CONTAINER_CONSTANTS, SHARED_VIZ_CONSTANTS, STATUS_COLORS, TIMELINE_CONSTANTS, WORKFLOW_CONSTANTS, calculateBarPosition, formatDuration, getEdgeColor, getEdgeOpacity, getResourceStatusColor, getStatusColors, getStatusIcon, shouldAnimateEdge, useAgentIterationData, useExecutionPath, useMergedExecution, useReactFlowAgent, useTimelineData, useUnifiedWorkflowLayout, useWorkflowStepsLayout } from './chunk-XA34RETF.js';
-export { ApiKeyService, CredentialService, DeploymentService, OrganizationMembershipService, WebhookEndpointService, filterByDomainFilters, milestoneKeys, noteKeys, projectKeys, taskKeys, useActivateDeployment, useActivityFilters, useCommandViewDomainFilters, useCreateApiKey, useCreateCredential, useCreateProject as useCreateDeliveryProject, useCreateMilestone, useCreateNote, useCreateWebhookEndpoint, useCredentials, useDeactivateDeployment, useDeactivateMembership, useDeleteApiKey, useDeleteCredential, useDeleteProject as useDeleteDeliveryProject, useDeleteTask as useDeleteDeliveryTask, useDeleteDeployment, useDeleteMilestone, useDeleteWebhookEndpoint, useExecutionLogsFilters, useListApiKeys, useListDeployments, useListWebhookEndpoints, useMilestones, useOrganizationMembers, useProject, useProjectNotes, useProjects, useReactivateMembership, useResourceSearch, useResourcesDomainFilters, useStatusFilter, useTasks, useTimeRangeDates, useUpdateApiKey, useUpdateCredential, useUpdateProject as useUpdateDeliveryProject, useUpdateMemberConfig, useUpdateMilestone, useUpdateWebhookEndpoint, useUserMemberships, useVisibleResources } from './chunk-DQJM7T2N.js';
-export { OperationsService, acquisitionListKeys, calibrationKeys, companyKeys, contactKeys, dealKeys, dealNoteKeys, dealTaskKeys, executionsKeys, isSessionCapable, operationsKeys, scheduleKeys, sessionsKeys, sortData, useActivities, useActivityTrend, useAllCalibrationProjects, useArchiveSession, useArchivedLogs, useBatchDelete, useBatchTelemetry, useBatchedResourcesHealth, useBulkDeleteExecutions, useBusinessImpact, useCalibrationProject, useCalibrationProjects, useCalibrationRun, useCalibrationRunFull, useCalibrationRuns, useCalibrationSSE, useCancelExecution, useCancelSchedule, useCheckpointTasks, useCommandQueue, useCommandQueueTotals, useCommandViewData, useCommandViewLayout, useCommandViewStats, useCommandViewStore, useCompanies, useCompany, useCompleteDealTask, useContact, useContacts, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateCompany, useCreateContact, useCreateDealNote, useCreateDealTask, useCreateList, useCreateProject, useCreateRun, useCreateSchedule, useCreateSession, useDashboardMetrics, useDealDetail, useDealNotes, useDealTasks, useDealTasksDue, useDeals, useDeleteCompanies, useDeleteContacts, useDeleteDeal, useDeleteExecution, useDeleteList, useDeleteProject, useDeleteRun, useDeleteSchedule, useDeleteSession, useDeleteTask, useDeploymentDocs, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorNotification, useExecuteAsync, useExecuteRun, useExecuteWorkflow, useExecution, useExecutionHealth, useExecutionLogSSE, useExecutionLogs, useExecutionPanelState, useExecutions, useGetExecutionHistory, useGetSchedule, useGradeRun, useGraphStats, useList, useListExecutions, useListProgress, useListSchedules, useLists, useListsTelemetry, useMarkAllAsRead, useMarkAsRead, useNotificationCount as useNotificationCountSSE, useNotifications, usePaginationState, usePatchTask, usePauseSchedule, useRecentExecutionsByResource, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResourceErrors, useResourceExecutions, useResources, useResourcesHealth, useResumeSchedule, useRetryExecution, useSSEConnection, useScheduledTasks, useSession, useSessionExecution, useSessionExecutions, useSessionMessages, useSessionWebSocket, useSessions, useSortedData, useSubmitAction, useSuccessNotification, useSyncDealStage, useTableSelection, useTableSort, useTestNotification, useTopFailingResources, useUnresolveError, useUnresolvedErrors, useUpdateAnchor, useUpdateCompany, useUpdateContact, useUpdateList, useUpdateListConfig, useUpdateProject, useUpdateSchedule, useWarningNotification } from './chunk-POFDRPDI.js';
+import './chunk-7M2VOCYN.js';
+export { ApiKeyService, CredentialService, DeploymentService, OperationsService, OrganizationMembershipService, WebhookEndpointService, acquisitionListKeys, calibrationKeys, companyKeys, contactKeys, dealKeys, dealNoteKeys, dealTaskKeys, executionsKeys, filterByDomainFilters, isSessionCapable, milestoneKeys, noteKeys, operationsKeys, projectKeys, scheduleKeys, sessionsKeys, sortData, taskKeys, useActivateDeployment, useActivities, useActivityFilters, useActivityTrend, useAllCalibrationProjects, useArchiveSession, useArchivedLogs, useBatchDelete, useBatchTelemetry, useBatchedResourcesHealth, useBulkDeleteExecutions, useBusinessImpact, useCalibrationProject, useCalibrationProjects, useCalibrationRun, useCalibrationRunFull, useCalibrationRuns, useCalibrationSSE, useCancelExecution, useCancelSchedule, useCheckpointTasks, useCommandQueue, useCommandQueueTotals, useCommandViewData, useCommandViewDomainFilters, useCommandViewLayout, useCommandViewStats, useCommandViewStore, useCompanies, useCompany, useCompleteDealTask, useContact, useContacts, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateApiKey, useCreateCompany, useCreateContact, useCreateCredential, useCreateDealNote, useCreateDealTask, useCreateProject2 as useCreateDeliveryProject, useCreateList, useCreateMilestone, useCreateNote, useCreateProject, useCreateRun, useCreateSchedule, useCreateSession, useCreateWebhookEndpoint, useCredentials, useDashboardMetrics, useDeactivateDeployment, useDeactivateMembership, useDealDetail, useDealNotes, useDealTasks, useDealTasksDue, useDeals, useDeleteApiKey, useDeleteCompanies, useDeleteContacts, useDeleteCredential, useDeleteDeal, useDeleteProject2 as useDeleteDeliveryProject, useDeleteTask2 as useDeleteDeliveryTask, useDeleteDeployment, useDeleteExecution, useDeleteList, useDeleteMilestone, useDeleteProject, useDeleteRun, useDeleteSchedule, useDeleteSession, useDeleteTask, useDeleteWebhookEndpoint, useDeploymentDocs, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorNotification, useExecuteAsync, useExecuteRun, useExecuteWorkflow, useExecution, useExecutionHealth, useExecutionLogSSE, useExecutionLogs, useExecutionLogsFilters, useExecutionPanelState, useExecutions, useGetExecutionHistory, useGetSchedule, useGradeRun, useGraphStats, useList, useListApiKeys, useListDeployments, useListExecutions, useListProgress, useListSchedules, useListWebhookEndpoints, useLists, useListsTelemetry, useMarkAllAsRead, useMarkAsRead, useMilestones, useNotificationCount as useNotificationCountSSE, useNotifications, useOrganizationMembers, usePaginationState, usePatchTask, usePauseSchedule, useProject, useProjectNotes, useProjects, useReactivateMembership, useRecentExecutionsByResource, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResourceErrors, useResourceExecutions, useResourceSearch, useResources, useResourcesDomainFilters, useResourcesHealth, useResumeSchedule, useRetryExecution, useSSEConnection, useScheduledTasks, useSession, useSessionExecution, useSessionExecutions, useSessionMessages, useSessionWebSocket, useSessions, useSortedData, useStatusFilter, useSubmitAction, useSuccessNotification, useSyncDealStage, useTableSelection, useTableSort, useTasks, useTestNotification, useTimeRangeDates, useTopFailingResources, useUnresolveError, useUnresolvedErrors, useUpdateAnchor, useUpdateApiKey, useUpdateCompany, useUpdateContact, useUpdateCredential, useUpdateProject2 as useUpdateDeliveryProject, useUpdateList, useUpdateListConfig, useUpdateMemberConfig, useUpdateMilestone, useUpdateProject, useUpdateSchedule, useUpdateWebhookEndpoint, useUserMemberships, useVisibleResources, useWarningNotification } from './chunk-4PHPENKX.js';
 export { observabilityKeys, useErrorTrends } from './chunk-LXHZYSMQ.js';
 export { GRAPH_CONSTANTS, calculateGraphHeight, useConnectionHighlight, useDirectedChainHighlighting, useFitViewTrigger, useGraphHighlighting, useNodeSelection } from './chunk-22UVE3RA.js';
-export { ElevasisUIProvider } from './chunk-4GZ6VZWO.js';
+export { ElevasisUIProvider, createTestFeaturesProvider } from './chunk-YCHZ4U5V.js';
 export { PresetsProvider, TOKEN_VAR_MAP, componentThemes, createCssVariablesResolver, generateShades, getPreset, mantineThemeOverride, PRESETS as presets, usePresetsContext } from './chunk-47YILFON.js';
 import './chunk-CYXZHBP4.js';
-export { ElevasisCoreProvider, ElevasisFeaturesProvider, FeatureShell, NotificationProvider, createUseFeatureAccess, useElevasisFeatures, useNotificationAdapter, useOptionalElevasisFeatures } from './chunk-O4PMRC6J.js';
+export { ElevasisCoreProvider, ElevasisFeaturesProvider, FEATURE_KEY_ALIASES, FeatureShell, NotificationProvider, createFeatureAccessHook, createUseFeatureAccess, useElevasisFeatures, useNotificationAdapter, useOptionalElevasisFeatures } from './chunk-OPT74SGF.js';
 import './chunk-RX4UWZZR.js';
 import './chunk-Y3D3WFJG.js';
 import './chunk-3KMDHCAR.js';

package/dist/initialization/index.d.ts

@@ -2619,13 +2619,14 @@ type SupabaseUserProfile = Tables<'users'>;
 /**
  * Per-user-per-org config (stored in org_memberships.config)
  * Controls which features a specific member can access within their org
- * Valid feature keys: operations, monitoring, acquisition, calibration, seo
+ * Valid feature keys: operations, monitoring, acquisition, delivery, calibration, seo
  */
 interface MembershipFeatureConfig {
     features?: {
         operations?: boolean;
         monitoring?: boolean;
         acquisition?: boolean;
+        delivery?: boolean;
         calibration?: boolean;
         seo?: boolean;
     };

package/dist/layout/index.d.ts

@@ -426,6 +426,64 @@ interface SubshellNavItemProps {
 }
 declare const SubshellNavItem: React$1.FC<SubshellNavItemProps>;
 
+/**
+ * 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 SubshellNavListProps {
+    /** Array of nav items to render. */
+    items: NavItem[];
+}
+/**
+ * Renders a list of {@link NavItem} entries as {@link SubshellNavItem} components,
+ * deriving active state from the current router path via {@link useRouterContext}.
+ *
+ * Use this when composing a custom sidebar middle that needs to render one of the
+ * exported item arrays (e.g. `CRM_ITEMS`, `DELIVERY_PROJECT_ITEMS`) inside a
+ * custom layout.
+ *
+ * @example
+ * import { SubshellNavList, SubshellSidebarSection } from '@elevasis/ui/layout'
+ * import { CRM_ITEMS } from '@elevasis/ui/features/crm'
+ *
+ * const MyCrmMiddle = () => (
+ *   <Stack gap={0} style={{ flex: 1, overflowY: 'auto' }}>
+ *     <Stack gap={0} p="sm">
+ *       <SubshellNavList items={CRM_ITEMS} />
+ *     </Stack>
+ *   </Stack>
+ * )
+ */
+declare const SubshellNavList: React$1.FC<SubshellNavListProps>;
+
 interface SubshellSidebarSectionProps {
     /** Icon component to display on the left */
     icon: ComponentType<{
@@ -475,5 +533,5 @@ declare const TopbarContainer: ({ children }: {
     children: React.ReactNode;
 }) => react_jsx_runtime.JSX.Element;
 
-export { AmbientBloomGrid, AppBackground, AppShellCenteredContainer, AppShellContainer, AppShellContentContainer, AppShellError, AppShellLoader, AppShellRightSideContainer, AppShellRightSideOuterContainer, AppTopbarAdjusterWrapper, CollapsibleSidebarGroup, CyberBackground, CyberParticles, FilmGrain, FloatingMotes, FloatingOrbs, LinksGroup, PageContainer, PerspectiveGrid, RadiantGlow, Sidebar, SidebarContext, SidebarProvider, SubshellContainer, SubshellContentContainer, SubshellLoader, SubshellNavItem, SubshellRightSideContainer, SubshellSidebar, SubshellSidebarSection, Topbar, TopbarContainer, Vignette, WaveBackground, sidebarBottomSectionCollapsedHeight, sidebarBottomSectionHeight, sidebarCollapsedWidth, sidebarGroupChevronSize, sidebarHoverDelay, sidebarIconInnerSize, sidebarIconSize, sidebarIconStroke, sidebarItemGap, sidebarItemHeight, sidebarItemPadding, sidebarSectionPadding, sidebarSubLinkIndent, sidebarSubLinkPaddingX, sidebarSubLinkPaddingY, sidebarToggleIconSize, sidebarTransitionDuration, sidebarWidth, subshellNavItemIconSize, subsidebarWidth, topbarHeight, useSidebar, useSidebarCollapse };
-export type { CollapsibleSidebarGroupProps, CyberVariant, LinkItem, LinksGroupProps, SidebarNestedProps, SubshellContainerProps, SubshellContentContainerProps, SubshellNavItemProps, SubshellRightSideContainerProps, SubshellSidebarContainerProps, SubshellSidebarProps, SubshellSidebarSectionProps, TopbarProps, WaveVariant };
+export { AmbientBloomGrid, AppBackground, AppShellCenteredContainer, AppShellContainer, AppShellContentContainer, AppShellError, AppShellLoader, AppShellRightSideContainer, AppShellRightSideOuterContainer, AppTopbarAdjusterWrapper, CollapsibleSidebarGroup, CyberBackground, CyberParticles, FilmGrain, FloatingMotes, FloatingOrbs, LinksGroup, PageContainer, PerspectiveGrid, RadiantGlow, Sidebar, SidebarContext, SidebarProvider, SubshellContainer, SubshellContentContainer, SubshellLoader, SubshellNavItem, SubshellNavList, SubshellRightSideContainer, SubshellSidebar, SubshellSidebarSection, Topbar, TopbarContainer, Vignette, WaveBackground, sidebarBottomSectionCollapsedHeight, sidebarBottomSectionHeight, sidebarCollapsedWidth, sidebarGroupChevronSize, sidebarHoverDelay, sidebarIconInnerSize, sidebarIconSize, sidebarIconStroke, sidebarItemGap, sidebarItemHeight, sidebarItemPadding, sidebarSectionPadding, sidebarSubLinkIndent, sidebarSubLinkPaddingX, sidebarSubLinkPaddingY, sidebarToggleIconSize, sidebarTransitionDuration, sidebarWidth, subshellNavItemIconSize, subsidebarWidth, topbarHeight, useSidebar, useSidebarCollapse };
+export type { CollapsibleSidebarGroupProps, CyberVariant, LinkItem, LinksGroupProps, NavItem, SidebarNestedProps, SubshellContainerProps, SubshellContentContainerProps, SubshellNavItemProps, SubshellNavListProps, SubshellRightSideContainerProps, SubshellSidebarContainerProps, SubshellSidebarProps, SubshellSidebarSectionProps, TopbarProps, WaveVariant };

package/dist/layout/index.js

@@ -1,4 +1,4 @@
-export { AppShellContainer, AppShellContentContainer, AppShellRightSideContainer, AppShellRightSideOuterContainer, AppTopbarAdjusterWrapper, CyberParticles, LinksGroup, Sidebar, SidebarContext, SidebarProvider, Topbar, TopbarContainer, Vignette, subsidebarWidth, useSidebar, useSidebarCollapse } from '../chunk-SMJLS23U.js';
+export { AppShellContainer, AppShellContentContainer, AppShellRightSideContainer, AppShellRightSideOuterContainer, AppTopbarAdjusterWrapper, CyberParticles, LinksGroup, Sidebar, SidebarContext, SidebarProvider, SubshellNavList, Topbar, TopbarContainer, Vignette, subsidebarWidth, useSidebar, useSidebarCollapse } from '../chunk-NYMKWGKN.js';
 export { CollapsibleSidebarGroup, SubshellLoader } from '../chunk-IDACMRGQ.js';
 export { PageContainer } from '../chunk-BZZCNLT6.js';
 export { SubshellNavItem, SubshellSidebarSection } from '../chunk-27COZ5AH.js';

package/dist/organization/index.d.ts

@@ -14,13 +14,14 @@ import { UseBoundStore, StoreApi } from 'zustand';
 /**
  * Per-user-per-org config (stored in org_memberships.config)
  * Controls which features a specific member can access within their org
- * Valid feature keys: operations, monitoring, acquisition, calibration, seo
+ * Valid feature keys: operations, monitoring, acquisition, delivery, calibration, seo
  */
 interface MembershipFeatureConfig {
     features?: {
         operations?: boolean;
         monitoring?: boolean;
         acquisition?: boolean;
+        delivery?: boolean;
         calibration?: boolean;
         seo?: boolean;
     };

package/dist/provider/index.d.ts

@@ -311,16 +311,179 @@ declare const SurfaceDefinitionSchema = z.object({
   parentId: ModelIdSchema.optional()
 })
 
-declare const OrganizationModelSchema = z.object({
-  version: z.literal(1).default(1),
-  domains: z.array(SemanticDomainSchema).default([]),
-  branding: OrganizationModelBrandingSchema,
-  features: OrganizationModelFeaturesSchema,
-  navigation: OrganizationModelNavigationSchema,
-  crm: OrganizationModelCrmSchema,
-  leadGen: OrganizationModelLeadGenSchema,
-  delivery: OrganizationModelDeliverySchema,
-  resourceMappings: z.array(ResourceMappingSchema).default([])
+declare const OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ctx) => {
+  const domainsById = collectIds(model.domains, ctx, ['domains'], 'Domain')
+  const surfacesById = collectIds(model.navigation.surfaces, ctx, ['navigation', 'surfaces'], 'Surface')
+  collectIds(model.navigation.groups, ctx, ['navigation', 'groups'], 'Navigation group')
+  collectIds(model.resourceMappings, ctx, ['resourceMappings'], 'Resource mapping')
+
+  const resourceMappingsByResourceId = new Map<string, (typeof model.resourceMappings)[number]>()
+  model.resourceMappings.forEach((resourceMapping, index) => {
+    if (resourceMappingsByResourceId.has(resourceMapping.resourceId)) {
+      addIssue(
+        ctx,
+        ['resourceMappings', index, 'resourceId'],
+        `Resource mapping resourceId "${resourceMapping.resourceId}" must be unique`
+      )
+      return
+    }
+
+    resourceMappingsByResourceId.set(resourceMapping.resourceId, resourceMapping)
+  })
+
+  if (model.navigation.defaultSurfaceId && !surfacesById.has(model.navigation.defaultSurfaceId)) {
+    addIssue(
+      ctx,
+      ['navigation', 'defaultSurfaceId'],
+      `Default surface "${model.navigation.defaultSurfaceId}" must reference a declared navigation surface`
+    )
+  }
+
+  model.navigation.groups.forEach((group, groupIndex) => {
+    group.surfaceIds.forEach((surfaceId, surfaceIndex) => {
+      if (!surfacesById.has(surfaceId)) {
+        addIssue(
+          ctx,
+          ['navigation', 'groups', groupIndex, 'surfaceIds', surfaceIndex],
+          `Navigation group "${group.id}" references unknown surface "${surfaceId}"`
+        )
+      }
+    })
+  })
+
+  model.domains.forEach((domain, domainIndex) => {
+    domain.surfaceIds.forEach((surfaceId, surfaceIndex) => {
+      const surface = surfacesById.get(surfaceId)
+      if (!surface) {
+        addIssue(
+          ctx,
+          ['domains', domainIndex, 'surfaceIds', surfaceIndex],
+          `Domain "${domain.id}" references unknown surface "${surfaceId}"`
+        )
+        return
+      }
+
+      if (!surface.domainIds.includes(domain.id)) {
+        addIssue(
+          ctx,
+          ['domains', domainIndex, 'surfaceIds', surfaceIndex],
+          `Domain "${domain.id}" references surface "${surfaceId}" but that surface does not include domain "${domain.id}"`
+        )
+      }
+    })
+
+    domain.resourceIds.forEach((resourceId, resourceIndex) => {
+      const resourceMapping = resourceMappingsByResourceId.get(resourceId)
+      if (!resourceMapping) {
+        addIssue(
+          ctx,
+          ['domains', domainIndex, 'resourceIds', resourceIndex],
+          `Domain "${domain.id}" references unknown resource "${resourceId}"`
+        )
+        return
+      }
+
+      if (!resourceMapping.domainIds.includes(domain.id)) {
+        addIssue(
+          ctx,
+          ['domains', domainIndex, 'resourceIds', resourceIndex],
+          `Domain "${domain.id}" references resource "${resourceId}" but that resource mapping does not include domain "${domain.id}"`
+        )
+      }
+    })
+  })
+
+  model.navigation.surfaces.forEach((surface, surfaceIndex) => {
+    if (surface.parentId && !surfacesById.has(surface.parentId)) {
+      addIssue(
+        ctx,
+        ['navigation', 'surfaces', surfaceIndex, 'parentId'],
+        `Surface "${surface.id}" references unknown parent surface "${surface.parentId}"`
+      )
+    }
+
+    surface.domainIds.forEach((domainId, domainIndex) => {
+      const domain = domainsById.get(domainId)
+      if (!domain) {
+        addIssue(
+          ctx,
+          ['navigation', 'surfaces', surfaceIndex, 'domainIds', domainIndex],
+          `Surface "${surface.id}" references unknown domain "${domainId}"`
+        )
+        return
+      }
+
+      if (!domain.surfaceIds.includes(surface.id)) {
+        addIssue(
+          ctx,
+          ['navigation', 'surfaces', surfaceIndex, 'domainIds', domainIndex],
+          `Surface "${surface.id}" references domain "${domainId}" but that domain does not include surface "${surface.id}"`
+        )
+      }
+    })
+
+    surface.resourceIds.forEach((resourceId, resourceIndex) => {
+      const resourceMapping = resourceMappingsByResourceId.get(resourceId)
+      if (!resourceMapping) {
+        addIssue(
+          ctx,
+          ['navigation', 'surfaces', surfaceIndex, 'resourceIds', resourceIndex],
+          `Surface "${surface.id}" references unknown resource "${resourceId}"`
+        )
+        return
+      }
+
+      if (!resourceMapping.surfaceIds.includes(surface.id)) {
+        addIssue(
+          ctx,
+          ['navigation', 'surfaces', surfaceIndex, 'resourceIds', resourceIndex],
+          `Surface "${surface.id}" references resource "${resourceId}" but that resource mapping does not include surface "${surface.id}"`
+        )
+      }
+    })
+  })
+
+  model.resourceMappings.forEach((resourceMapping, resourceIndex) => {
+    resourceMapping.domainIds.forEach((domainId, domainIndex) => {
+      const domain = domainsById.get(domainId)
+      if (!domain) {
+        addIssue(
+          ctx,
+          ['resourceMappings', resourceIndex, 'domainIds', domainIndex],
+          `Resource mapping "${resourceMapping.id}" references unknown domain "${domainId}"`
+        )
+        return
+      }
+
+      if (!domain.resourceIds.includes(resourceMapping.resourceId)) {
+        addIssue(
+          ctx,
+          ['resourceMappings', resourceIndex, 'domainIds', domainIndex],
+          `Resource mapping "${resourceMapping.id}" references domain "${domainId}" but that domain does not include resource "${resourceMapping.resourceId}"`
+        )
+      }
+    })
+
+    resourceMapping.surfaceIds.forEach((surfaceId, surfaceIndex) => {
+      const surface = surfacesById.get(surfaceId)
+      if (!surface) {
+        addIssue(
+          ctx,
+          ['resourceMappings', resourceIndex, 'surfaceIds', surfaceIndex],
+          `Resource mapping "${resourceMapping.id}" references unknown surface "${surfaceId}"`
+        )
+        return
+      }
+
+      if (!surface.resourceIds.includes(resourceMapping.resourceId)) {
+        addIssue(
+          ctx,
+          ['resourceMappings', resourceIndex, 'surfaceIds', surfaceIndex],
+          `Resource mapping "${resourceMapping.id}" references surface "${surfaceId}" but that surface does not include resource "${resourceMapping.resourceId}"`
+        )
+      }
+    })
+  })
 })
 
 type OrganizationModel = z.infer<typeof OrganizationModelSchema>
@@ -375,20 +538,37 @@ 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;
 }
-type ShellModuleDefinition = FeatureModule;
 interface ResolvedFeatureAccess {
     featureKey: string;
-    label?: string;
     enabled: boolean;
 }
 interface ResolvedFeatureSemantics {
@@ -406,7 +586,6 @@ type ShellNavSource = 'app' | 'feature';
 interface ResolvedShellNavItem extends FeatureNavEntry {
     placement: ShellNavPlacement;
     source: ShellNavSource;
-    shellModuleKey?: string;
     accessFeatureKey?: string;
 }
 interface ResolvedShellModel {
@@ -425,7 +604,6 @@ interface ResolvedShellRouteMatch {
     navLink?: FeatureNavLink;
 }
 interface ShellRuntime {
-    shellModel: ResolvedShellModel;
     resolveRoute: (path: string) => ResolvedShellRouteMatch;
 }
 interface OrganizationGraphFeatureBridge {
@@ -438,9 +616,6 @@ interface OrganizationGraphContextValue {
     surfaceType?: OrganizationModelSurface['surfaceType'];
     featureKey?: OrganizationModelFeatureKey;
 }
-interface FeatureRegistry {
-    features: FeatureModule[];
-}
 interface ElevasisFeaturesProviderProps {
     features: FeatureModule[];
     organizationModel?: OrganizationModel;
@@ -536,5 +711,13 @@ interface ElevasisUIProviderProps extends Omit<ElevasisCoreProviderProps, 'theme
 }
 declare function ElevasisUIProvider({ theme, children, ...coreProps }: ElevasisUIProviderProps): react_jsx_runtime.JSX.Element;
 
-export { AppearanceProvider, ElevasisCoreProvider, ElevasisFeaturesProvider, ElevasisServiceProvider, ElevasisUIProvider, FeatureShell, NotificationProvider, useAppearance, useElevasisFeatures, useElevasisServices, useNotificationAdapter, useOptionalElevasisFeatures };
-export type { ApiKeyConfig, AppShellOverrides, AppearanceConfig, AuthConfig, AuthKitConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisFeaturesContextValue, ElevasisFeaturesProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, FeatureModule, FeatureNavEntry, FeatureNavLink, FeatureRegistry, FeatureSidebarComponent, NotificationAdapter, OrganizationGraphContextValue, OrganizationGraphFeatureBridge, PresetName, ResolvedFeatureAccess, ResolvedFeatureModule, ResolvedFeatureSemantics, ResolvedShellModel, ResolvedShellNavItem, ResolvedShellRouteMatch, ShellModuleDefinition, ShellNavPlacement, ShellNavSource, ShellRouteMatchStatus, ShellRuntime, WithSchemes };
+interface CreateTestFeaturesProviderOptions {
+    organizationModel?: OrganizationModel;
+    features?: FeatureModule[];
+}
+declare function createTestFeaturesProvider({ organizationModel, features }?: CreateTestFeaturesProviderOptions): ({ children }: {
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+
+export { AppearanceProvider, ElevasisCoreProvider, ElevasisFeaturesProvider, ElevasisServiceProvider, ElevasisUIProvider, FeatureShell, NotificationProvider, createTestFeaturesProvider, useAppearance, useElevasisFeatures, useElevasisServices, useNotificationAdapter, useOptionalElevasisFeatures };
+export type { ApiKeyConfig, AppShellOverrides, AppearanceConfig, AuthConfig, AuthKitConfig, CreateTestFeaturesProviderOptions, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisFeaturesContextValue, ElevasisFeaturesProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, FeatureModule, FeatureNavEntry, FeatureNavLink, FeatureSidebarComponent, NotificationAdapter, OrganizationGraphContextValue, OrganizationGraphFeatureBridge, PresetName, ResolvedFeatureAccess, ResolvedFeatureModule, ResolvedFeatureSemantics, ResolvedShellModel, ResolvedShellNavItem, ResolvedShellRouteMatch, ShellNavPlacement, ShellNavSource, ShellRouteMatchStatus, ShellRuntime, WithSchemes };

package/dist/provider/index.js

@@ -1,7 +1,7 @@
-export { ElevasisUIProvider } from '../chunk-4GZ6VZWO.js';
+export { ElevasisUIProvider, createTestFeaturesProvider } from '../chunk-YCHZ4U5V.js';
 import '../chunk-47YILFON.js';
 import '../chunk-CYXZHBP4.js';
-export { ElevasisCoreProvider, ElevasisFeaturesProvider, FeatureShell, NotificationProvider, useElevasisFeatures, useNotificationAdapter, useOptionalElevasisFeatures } from '../chunk-O4PMRC6J.js';
+export { ElevasisCoreProvider, ElevasisFeaturesProvider, FeatureShell, NotificationProvider, useElevasisFeatures, useNotificationAdapter, useOptionalElevasisFeatures } from '../chunk-OPT74SGF.js';
 import '../chunk-RX4UWZZR.js';
 import '../chunk-Y3D3WFJG.js';
 import '../chunk-3KMDHCAR.js';