@elevasis/ui 2.20.0 → 2.22.0

package/dist/provider/index.d.ts

@@ -279,6 +279,22 @@ declare function ElevasisCoreProvider({ auth, queryClient, apiUrl, onError, noti
  */
 type TimeRange = '1h' | '24h' | '7d' | '30d';
 
+declare const FeatureSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    path: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodString>;
+    uiPosition: z.ZodOptional<z.ZodEnum<{
+        "sidebar-primary": "sidebar-primary";
+        "sidebar-bottom": "sidebar-bottom";
+    }>>;
+    requiresAdmin: z.ZodOptional<z.ZodBoolean>;
+    devOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
 declare const OrganizationModelSchema: z.ZodObject<{
     version: z.ZodDefault<z.ZodLiteral<1>>;
     features: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -286,12 +302,15 @@ declare const OrganizationModelSchema: z.ZodObject<{
         label: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         enabled: z.ZodDefault<z.ZodBoolean>;
-        color: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
-        entityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        surfaceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        resourceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        capabilityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        color: z.ZodOptional<z.ZodString>;
+        uiPosition: z.ZodOptional<z.ZodEnum<{
+            "sidebar-primary": "sidebar-primary";
+            "sidebar-bottom": "sidebar-bottom";
+        }>>;
+        requiresAdmin: z.ZodOptional<z.ZodBoolean>;
+        devOnly: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
     branding: z.ZodObject<{
         organizationName: z.ZodString;
@@ -303,22 +322,23 @@ declare const OrganizationModelSchema: z.ZodObject<{
             dark: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    navigation: z.ZodObject<{
+    navigation: z.ZodDefault<z.ZodObject<{
         defaultSurfaceId: z.ZodOptional<z.ZodString>;
         surfaces: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
             path: z.ZodString;
             surfaceType: z.ZodEnum<{
-                list: "list";
                 settings: "settings";
                 page: "page";
                 dashboard: "dashboard";
                 graph: "graph";
                 detail: "detail";
+                list: "list";
             }>;
             description: z.ZodOptional<z.ZodString>;
             enabled: z.ZodDefault<z.ZodBoolean>;
+            devOnly: z.ZodOptional<z.ZodBoolean>;
             icon: z.ZodOptional<z.ZodString>;
             featureId: z.ZodOptional<z.ZodString>;
             featureIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -333,7 +353,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             placement: z.ZodString;
             surfaceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
     sales: z.ZodObject<{
         entityId: z.ZodString;
         defaultPipelineId: z.ZodString;
@@ -352,9 +372,9 @@ declare const OrganizationModelSchema: z.ZodObject<{
                 semanticClass: z.ZodEnum<{
                     open: "open";
                     active: "active";
+                    nurturing: "nurturing";
                     closed_won: "closed_won";
                     closed_lost: "closed_lost";
-                    nurturing: "nurturing";
                 }>;
                 surfaceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
                 resourceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -515,12 +535,12 @@ declare const OrganizationModelSchema: z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
             semanticClass: z.ZodEnum<{
-                execution: "execution";
-                schedule: "schedule";
-                queue: "queue";
                 "delivery.project": "delivery.project";
                 "delivery.milestone": "delivery.milestone";
                 "delivery.task": "delivery.task";
+                queue: "queue";
+                execution: "execution";
+                schedule: "schedule";
                 "schedule.run": "schedule.run";
                 request: "request";
             }>;
@@ -532,74 +552,20 @@ declare const OrganizationModelSchema: z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
             semanticClass: z.ZodEnum<{
+                queue: "queue";
+                executions: "executions";
                 sessions: "sessions";
                 notifications: "notifications";
                 schedules: "schedules";
-                executions: "executions";
-                queue: "queue";
             }>;
             featureId: z.ZodOptional<z.ZodString>;
             supportedStatusSemanticClass: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
-    resourceMappings: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        color: z.ZodOptional<z.ZodString>;
-        icon: z.ZodOptional<z.ZodString>;
-        id: z.ZodString;
-        resourceId: z.ZodString;
-        resourceType: z.ZodEnum<{
-            agent: "agent";
-            workflow: "workflow";
-            trigger: "trigger";
-            integration: "integration";
-            external: "external";
-            human_checkpoint: "human_checkpoint";
-        }>;
-        featureIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        entityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        surfaceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        capabilityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        techStack: z.ZodOptional<z.ZodObject<{
-            platform: z.ZodString;
-            purpose: z.ZodString;
-            credentialStatus: z.ZodEnum<{
-                pending: "pending";
-                configured: "configured";
-                expired: "expired";
-                missing: "missing";
-            }>;
-            isSystemOfRecord: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-
-declare const SurfaceDefinitionSchema: z.ZodObject<{
-    id: z.ZodString;
-    label: z.ZodString;
-    path: z.ZodString;
-    surfaceType: z.ZodEnum<{
-        list: "list";
-        settings: "settings";
-        page: "page";
-        dashboard: "dashboard";
-        graph: "graph";
-        detail: "detail";
-    }>;
-    description: z.ZodOptional<z.ZodString>;
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    icon: z.ZodOptional<z.ZodString>;
-    featureId: z.ZodOptional<z.ZodString>;
-    featureIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    entityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    resourceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    capabilityIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    parentId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
 type OrganizationModel = z.infer<typeof OrganizationModelSchema>;
-type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>;
+type OrganizationModelFeature = z.infer<typeof FeatureSchema>;
 
 interface FetchEventSourceWithTokenRefreshOptions {
     url: string;
@@ -623,46 +589,28 @@ interface SSEConnectionManagerLike {
     }>;
 }
 
-interface FeatureNavLink {
-    label: string;
-    link: string;
-    featureKey?: string;
-    onClick?: () => void;
-    links?: FeatureNavLink[];
-}
-interface FeatureNavEntry {
-    label: string;
-    icon: ComponentType;
-    link?: string;
-    featureKey?: string;
-    requiresAdmin?: boolean;
-    dataOnboardingTourId?: string;
-    links?: FeatureNavLink[];
-}
 type FeatureSidebarComponent = ComponentType;
+type FeatureIconComponent = ComponentType<{
+    size?: number;
+    stroke?: number;
+}>;
+type FeatureSidebarWidthResolver = number | ((context: {
+    currentPath: string;
+}) => number);
 interface FeatureModule {
-    /** Unique stable identifier for this feature (e.g. `'crm'`, `'projects'`). */
+    /** Unique stable identifier for this feature module. */
     key: string;
-    /** Feature ID used for access-flag gating — must match the `id` of a feature in the organization model. */
+    /** Organization Model feature id this module presents. */
     featureId: string;
-    /**
-     * 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.
-     */
+    /** Capability identifiers contributed by this feature module. */
     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. */
+    /** Icon used when this feature node appears in shell navigation. */
+    icon?: FeatureIconComponent;
+    /** Sidebar component rendered when this feature's subtree 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.
-     */
+    /** Optional shell sidebar width override. Defaults to 250px. */
+    sidebarWidth?: FeatureSidebarWidthResolver;
+    /** Operations-only bridge connecting this feature to the organization graph node. */
     organizationGraph?: OrganizationGraphFeatureBridge;
 }
 interface ResolvedFeatureAccess {
@@ -671,52 +619,47 @@ interface ResolvedFeatureAccess {
 }
 interface ResolvedFeatureSemantics {
     capabilityIds: string[];
-    surfaceIds: string[];
-    surfaces: OrganizationModelSurface[];
 }
 interface ResolvedFeatureModule extends FeatureModule {
     access: ResolvedFeatureAccess;
     semantics: ResolvedFeatureSemantics;
 }
-type ShellNavPlacement = 'primary' | 'bottom';
-type ShellNavSource = 'app' | 'feature';
-interface ResolvedShellNavItem extends FeatureNavEntry {
-    placement: ShellNavPlacement;
-    source: ShellNavSource;
-    featureId?: string;
+interface ResolvedShellFeature extends OrganizationModelFeature {
+    iconComponent?: FeatureIconComponent;
 }
 interface ResolvedShellModel {
-    navItems: ResolvedShellNavItem[];
-}
-interface AppShellOverrides {
-    primaryNavItems?: FeatureNavEntry[];
-    bottomNavItems?: FeatureNavEntry[];
+    features: readonly ResolvedShellFeature[];
+    findByPath: (path: string) => ResolvedShellFeature | undefined;
+    findById: (id: string) => ResolvedShellFeature | undefined;
+    childrenOf: (id: string) => ResolvedShellFeature[];
+    ancestorsOf: (id: string) => ResolvedShellFeature[];
+    parentOf: (id: string) => ResolvedShellFeature | undefined;
+    topLevel: () => ResolvedShellFeature[];
+    uiPositionFor: (id: string) => OrganizationModelFeature['uiPosition'] | undefined;
+    requiresAdminFor: (id: string) => boolean;
+    devOnlyFor: (id: string) => boolean;
 }
 type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched';
 interface ResolvedShellRouteMatch {
     status: ShellRouteMatchStatus;
     path: string;
     feature?: ResolvedFeatureModule;
-    navItem?: ResolvedShellNavItem;
-    navLink?: FeatureNavLink;
+    node?: ResolvedShellFeature;
 }
 interface ShellRuntime {
     resolveRoute: (path: string) => ResolvedShellRouteMatch;
 }
 interface OrganizationGraphFeatureBridge {
-    surfaceId: string;
+    featureId: string;
 }
 interface OrganizationGraphContextValue {
     available: boolean;
-    surfaceId?: string;
-    surfacePath?: string;
-    surfaceType?: OrganizationModelSurface['surfaceType'];
     featureId?: string;
+    featurePath?: string;
 }
 interface ElevasisFeaturesProviderProps {
     features: FeatureModule[];
     organizationModel?: OrganizationModel;
-    appShellOverrides?: AppShellOverrides;
     timeRange?: TimeRange;
     operationsApiUrl?: string;
     operationsSSEManager?: SSEConnectionManagerLike;
@@ -744,7 +687,7 @@ interface ElevasisFeaturesContextValue {
 
 declare function useElevasisFeatures(): ElevasisFeaturesContextValue;
 declare function useOptionalElevasisFeatures(): ElevasisFeaturesContextValue | null;
-declare function ElevasisFeaturesProvider({ features, organizationModel, appShellOverrides, timeRange, operationsApiUrl, operationsSSEManager, deliveryApiUrl, deliverySSEManager, disabledSubsectionPaths, children }: ElevasisFeaturesProviderProps): react_jsx_runtime.JSX.Element;
+declare function ElevasisFeaturesProvider({ features, organizationModel, timeRange, operationsApiUrl, operationsSSEManager, deliveryApiUrl, deliverySSEManager, disabledSubsectionPaths, children }: ElevasisFeaturesProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function FeatureShell({ children }: {
     children: ReactNode;
@@ -821,4 +764,4 @@ declare function createTestFeaturesProvider({ organizationModel, features }?: Cr
 }) => 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 };
+export type { ApiKeyConfig, AppearanceConfig, AuthConfig, AuthKitConfig, CreateTestFeaturesProviderOptions, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisFeaturesContextValue, ElevasisFeaturesProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, FeatureIconComponent, FeatureModule, FeatureSidebarComponent, NotificationAdapter, OrganizationGraphContextValue, OrganizationGraphFeatureBridge, PresetName, ResolvedFeatureAccess, ResolvedFeatureModule, ResolvedFeatureSemantics, ResolvedShellFeature, ResolvedShellModel, ResolvedShellRouteMatch, ShellRouteMatchStatus, ShellRuntime, WithSchemes };

package/dist/provider/index.js

@@ -1,24 +1,25 @@
-export { createTestFeaturesProvider } from '../chunk-Q4QJOSVS.js';
-export { ElevasisUIProvider } from '../chunk-TO7QXDBX.js';
-import '../chunk-Q5HC6ENG.js';
+export { createTestFeaturesProvider } from '../chunk-ZBCTB5CA.js';
+export { ElevasisUIProvider } from '../chunk-3HEUGBOT.js';
+import '../chunk-XOTJNW4Q.js';
 import '../chunk-WLOQ4IBG.js';
-export { ElevasisFeaturesProvider, FeatureShell, useElevasisFeatures, useOptionalElevasisFeatures } from '../chunk-LR5CRY5A.js';
-export { ElevasisCoreProvider, NotificationProvider, useNotificationAdapter } from '../chunk-OUYH2SBS.js';
-import '../chunk-RX4UWZZR.js';
-import '../chunk-BHR7IV72.js';
+export { FeatureShell } from '../chunk-AXXTN44Z.js';
+export { ElevasisCoreProvider, NotificationProvider, useNotificationAdapter } from '../chunk-LVUCBY7X.js';
+export { ElevasisFeaturesProvider, useElevasisFeatures, useOptionalElevasisFeatures } from '../chunk-LJWV4TWV.js';
+import '../chunk-TKAYX2SP.js';
+import '../chunk-XUYBOO32.js';
 import '../chunk-SZHARWKU.js';
 import '../chunk-3KMDHCAR.js';
 import '../chunk-NYBEU5TE.js';
-import '../chunk-R7OJCNL3.js';
+import '../chunk-T6INEVX6.js';
 import '../chunk-2IFYDILW.js';
 import '../chunk-Q7DJKLEN.js';
-import '../chunk-7YQKVWSD.js';
+import '../chunk-SQ5JGELM.js';
 import '../chunk-6IA2OMAE.js';
 export { AppearanceProvider, useAppearance } from '../chunk-QJ2KCHKX.js';
 import '../chunk-HQ7M6PBW.js';
 import '../chunk-DT3QYZVU.js';
 import '../chunk-RNP5R5I3.js';
-import '../chunk-OD7GWIZS.js';
+import '../chunk-SGXXJE52.js';
 import '../chunk-KRWALB24.js';
 import '../chunk-SLH2QLKV.js';
 import '../chunk-DK2HVHCY.js';