@elevasis/ui 2.25.3 → 2.25.5

package/dist/knowledge/index.d.ts

@@ -0,0 +1,633 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { z } from 'zod';
+import { ComponentType, ReactNode } from 'react';
+
+/**
+ * Command View Types
+ *
+ * Unified type definitions for the Command View graph visualization.
+ * These types are used by both backend serialization and frontend rendering.
+ *
+ * Command View shows the resource graph: agents, workflows, triggers, integrations,
+ * external resources, and human checkpoints with their relationships.
+ */
+
+/**
+ * Relationship types between resources
+ *
+ * - triggers: Resource initiates/starts another resource (orange)
+ * - uses: Resource uses an integration (teal)
+ * - approval: Resource requires human approval (yellow)
+ */
+type RelationshipType = 'triggers' | 'uses' | 'approval';
+
+declare const OrgKnowledgeNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        playbook: "playbook";
+        strategy: "strategy";
+        reference: "reference";
+    }>;
+    title: z.ZodString;
+    summary: z.ZodString;
+    body: z.ZodString;
+    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+    }, z.core.$strip>>>;
+    ownerIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+
+declare const OrganizationModelSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<1>>;
+    features: z.ZodDefault<z.ZodArray<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>>>;
+    branding: z.ZodObject<{
+        organizationName: z.ZodString;
+        productName: z.ZodString;
+        shortName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        logos: z.ZodDefault<z.ZodObject<{
+            light: z.ZodOptional<z.ZodString>;
+            dark: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    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<{
+                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>>;
+            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>>>;
+        groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            placement: z.ZodString;
+            surfaceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    sales: z.ZodObject<{
+        entityId: z.ZodString;
+        defaultPipelineId: z.ZodString;
+        pipelines: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            entityId: z.ZodString;
+            stages: 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;
+                order: z.ZodNumber;
+                semanticClass: z.ZodEnum<{
+                    open: "open";
+                    active: "active";
+                    nurturing: "nurturing";
+                    closed_won: "closed_won";
+                    closed_lost: "closed_lost";
+                }>;
+                surfaceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                resourceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    prospecting: z.ZodObject<{
+        listEntityId: z.ZodString;
+        companyEntityId: z.ZodString;
+        contactEntityId: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        companyStages: 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;
+            order: z.ZodNumber;
+        }, z.core.$strip>>;
+        contactStages: 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;
+            order: z.ZodNumber;
+        }, z.core.$strip>>;
+        defaultBuildTemplateId: z.ZodString;
+        buildTemplates: 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;
+            steps: 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;
+                primaryEntity: z.ZodEnum<{
+                    company: "company";
+                    contact: "contact";
+                }>;
+                outputs: z.ZodArray<z.ZodEnum<{
+                    company: "company";
+                    contact: "contact";
+                    export: "export";
+                }>>;
+                stageKey: z.ZodString;
+                dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                dependencyMode: z.ZodLiteral<"per-record-eligibility">;
+                capabilityKey: z.ZodString;
+                defaultBatchSize: z.ZodNumber;
+                maxBatchSize: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    projects: z.ZodObject<{
+        projectEntityId: z.ZodString;
+        milestoneEntityId: z.ZodString;
+        taskEntityId: z.ZodString;
+        projectStatuses: 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;
+            order: z.ZodNumber;
+        }, z.core.$strip>>;
+        milestoneStatuses: 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;
+            order: z.ZodNumber;
+        }, z.core.$strip>>;
+        taskStatuses: 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;
+            order: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    identity: z.ZodDefault<z.ZodObject<{
+        mission: z.ZodDefault<z.ZodString>;
+        vision: z.ZodDefault<z.ZodString>;
+        legalName: z.ZodDefault<z.ZodString>;
+        entityType: z.ZodDefault<z.ZodString>;
+        jurisdiction: z.ZodDefault<z.ZodString>;
+        industryCategory: z.ZodDefault<z.ZodString>;
+        geographicFocus: z.ZodDefault<z.ZodString>;
+        timeZone: z.ZodDefault<z.ZodString>;
+        businessHours: z.ZodDefault<z.ZodObject<{
+            monday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+            tuesday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+            wednesday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+            thursday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+            friday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+            saturday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+            sunday: z.ZodOptional<z.ZodObject<{
+                open: z.ZodString;
+                close: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        clientBrief: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    customers: z.ZodDefault<z.ZodObject<{
+        segments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodDefault<z.ZodString>;
+            description: z.ZodDefault<z.ZodString>;
+            jobsToBeDone: z.ZodDefault<z.ZodString>;
+            pains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            gains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            firmographics: z.ZodDefault<z.ZodObject<{
+                industry: z.ZodOptional<z.ZodString>;
+                companySize: z.ZodOptional<z.ZodString>;
+                region: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            valueProp: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    offerings: z.ZodDefault<z.ZodObject<{
+        products: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodDefault<z.ZodString>;
+            description: z.ZodDefault<z.ZodString>;
+            pricingModel: z.ZodDefault<z.ZodEnum<{
+                custom: "custom";
+                "one-time": "one-time";
+                subscription: "subscription";
+                "usage-based": "usage-based";
+            }>>;
+            price: z.ZodDefault<z.ZodNumber>;
+            currency: z.ZodDefault<z.ZodString>;
+            targetSegmentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deliveryFeatureId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    roles: z.ZodDefault<z.ZodObject<{
+        roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            responsibilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            reportsToId: z.ZodOptional<z.ZodString>;
+            heldBy: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    goals: z.ZodDefault<z.ZodObject<{
+        objectives: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            periodStart: z.ZodString;
+            periodEnd: z.ZodString;
+            keyResults: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                description: z.ZodString;
+                targetMetric: z.ZodString;
+                currentValue: z.ZodDefault<z.ZodNumber>;
+                targetValue: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    statuses: z.ZodDefault<z.ZodObject<{
+        entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            semanticClass: z.ZodEnum<{
+                "delivery.project": "delivery.project";
+                "delivery.milestone": "delivery.milestone";
+                "delivery.task": "delivery.task";
+                queue: "queue";
+                execution: "execution";
+                schedule: "schedule";
+                "schedule.run": "schedule.run";
+                request: "request";
+            }>;
+            category: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    operations: z.ZodDefault<z.ZodObject<{
+        entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            semanticClass: z.ZodEnum<{
+                queue: "queue";
+                executions: "executions";
+                sessions: "sessions";
+                notifications: "notifications";
+                schedules: "schedules";
+            }>;
+            featureId: z.ZodOptional<z.ZodString>;
+            supportedStatusSemanticClass: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    knowledge: z.ZodDefault<z.ZodObject<{
+        nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                playbook: "playbook";
+                strategy: "strategy";
+                reference: "reference";
+            }>;
+            title: z.ZodString;
+            summary: z.ZodString;
+            body: z.ZodString;
+            links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                nodeId: z.ZodString;
+            }, z.core.$strip>>>;
+            ownerIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+type OrganizationModel = z.infer<typeof OrganizationModelSchema>;
+type OrgKnowledgeNode = z.infer<typeof OrgKnowledgeNodeSchema>;
+
+type OrganizationGraphNodeKind = 'organization' | 'feature' | 'surface' | 'entity' | 'capability' | 'resource' | 'knowledge';
+type OrganizationGraphEdgeKind = 'contains' | 'references' | 'exposes' | 'maps_to' | 'operates-on' | 'uses' | 'governs';
+
+interface OrganizationGraphNode {
+    id: string;
+    kind: OrganizationGraphNodeKind;
+    label: string;
+    sourceId?: string;
+    description?: string;
+    enabled?: boolean;
+    featureId?: string;
+    resourceType?: 'workflow' | 'agent' | 'trigger' | 'integration' | 'external' | 'human_checkpoint';
+}
+interface OrganizationGraphEdge {
+    id: string;
+    kind: OrganizationGraphEdgeKind;
+    sourceId: string;
+    targetId: string;
+    label?: string;
+    relationshipType?: RelationshipType;
+}
+interface OrganizationGraph {
+    version: 1;
+    organizationModelVersion: OrganizationModel['version'];
+    nodes: OrganizationGraphNode[];
+    edges: OrganizationGraphEdge[];
+}
+
+interface KnowledgeBrowserProps {
+    /** Built organization graph. */
+    graph: OrganizationGraph;
+    /** All knowledge nodes (OM authoring shape). */
+    knowledgeNodes: OrgKnowledgeNode[];
+    /** Optional id of the node to render in the right pane on first mount. */
+    initialNodeId?: string;
+    /** Optional callback invoked when a graph edge chip is clicked in the node view. */
+    onNavigateToNode?: (graphNodeId: string) => void;
+}
+/**
+ * Composed default browser for the knowledge map.
+ *
+ * Layout: search bar at top; left pane is a by-feature tree; right pane shows
+ * either the search-results list (when a search is active) or the selected
+ * node detail. Read-only; mutation is out of scope for Phase 1.
+ */
+declare function KnowledgeBrowser({ graph, knowledgeNodes, initialNodeId, onNavigateToNode }: KnowledgeBrowserProps): react_jsx_runtime.JSX.Element;
+
+interface KnowledgeTreeProps {
+    /** Built organization graph — used to enumerate features and resolve `governs` edges. */
+    graph: OrganizationGraph;
+    /** All knowledge nodes (the OM authoring shape; queries need this for body/links). */
+    knowledgeNodes: OrgKnowledgeNode[];
+    /** Called when a knowledge node is selected. */
+    onSelectNode: (node: OrgKnowledgeNode) => void;
+    /** Currently selected node id (highlights the active row). */
+    selectedNodeId?: string;
+}
+/**
+ * By-feature primary tree. Renders each feature in the graph with its governing
+ * knowledge nodes nested underneath. Features with no governing nodes are
+ * omitted to keep the tree focused.
+ */
+declare function KnowledgeTree({ graph, knowledgeNodes, onSelectNode, selectedNodeId }: KnowledgeTreeProps): react_jsx_runtime.JSX.Element;
+
+interface KnowledgeNodeListProps {
+    /** Nodes to render. Usually the result of a query (byFeature, byKind, search). */
+    nodes: OrgKnowledgeNode[];
+    /** Called when the user selects a node. */
+    onSelect: (node: OrgKnowledgeNode) => void;
+    /** Id of the currently selected node (highlights the active card). */
+    selectedNodeId?: string;
+    /** Optional label shown above the list (e.g. "Playbooks" or "3 results"). */
+    label?: string;
+}
+/**
+ * Flat list of knowledge node cards.
+ *
+ * Each card shows title, kind badge, and summary. Clicking a card calls
+ * `onSelect`. The active card (matching `selectedNodeId`) is highlighted
+ * using the `--active-background` token.
+ */
+declare function KnowledgeNodeList({ nodes, onSelect, selectedNodeId, label }: KnowledgeNodeListProps): react_jsx_runtime.JSX.Element;
+
+interface KnowledgeNodeViewProps {
+    /** The knowledge node to display. */
+    node: OrgKnowledgeNode;
+    /** The organization graph — used to resolve edge relationships. */
+    graph: OrganizationGraph;
+    /**
+     * Optional callback when the user clicks a graph edge chip (e.g. to navigate
+     * to the related node or feature). The raw graph node id is passed.
+     */
+    onNavigateToNode?: (graphNodeId: string) => void;
+    /**
+     * Optional extra components to merge into the MDX allowlist for this view.
+     * Passed directly to the internal `KnowledgeMDXProvider` wrapper.
+     */
+    extraComponents?: Record<string, React.ComponentType<any>>;
+}
+/**
+ * Full single-node view: title, kind badge, summary, compiled MDX body, and
+ * an edge sidecar listing outgoing `governs` and incoming `governedBy` links.
+ *
+ * Internally wraps the MDX body in a `KnowledgeMDXProvider` so `KNOWLEDGE_BODIES`
+ * components receive the standard allowlist. Pass `extraComponents` to extend
+ * or override allowlist entries for this view only.
+ *
+ * @example
+ * ```tsx
+ * <KnowledgeNodeView
+ *   node={selectedNode}
+ *   graph={graph}
+ *   onNavigateToNode={(id) => navigate(`/knowledge/${id}`)}
+ * />
+ * ```
+ */
+declare function KnowledgeNodeView({ node, graph, onNavigateToNode, extraComponents }: KnowledgeNodeViewProps): react_jsx_runtime.JSX.Element;
+
+interface KnowledgeSearchBarProps {
+    /** All available knowledge nodes — used to resolve hit ids to nodes. */
+    knowledgeNodes: OrgKnowledgeNode[];
+    /**
+     * Called with the ranked subset of nodes matching the current query.
+     * Called with `null` when the search bar is cleared (parent restores default view).
+     */
+    onResults: (nodes: OrgKnowledgeNode[] | null) => void;
+    /** Placeholder text. Defaults to "Search knowledge…". */
+    placeholder?: string;
+}
+/**
+ * Client-side full-text search bar over the knowledge index.
+ *
+ * On mount, builds an in-memory index from `_generated/knowledge-search-index.json`
+ * (title, summary, bodyText). As the user types, calls `onResults` with ranked
+ * `OrgKnowledgeNode[]`. Clearing the input calls `onResults(null)` so the parent
+ * can restore its default tree/list view.
+ *
+ * The index is intentionally scoped to the generated snapshot — it does not
+ * re-index on `knowledgeNodes` changes at runtime (Phase 1 is read-only).
+ */
+declare function KnowledgeSearchBar({ knowledgeNodes, onResults, placeholder }: KnowledgeSearchBarProps): 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 KnowledgeSidebarMiddleProps {
+    /** Override the default nav items. Defaults to {@link KNOWLEDGE_ITEMS}. */
+    items?: NavItem[];
+}
+/**
+ * Sidebar middle section for the Knowledge feature.
+ *
+ * Mirrors the `CrmSidebarMiddle` pattern. Pass `items` to extend or replace
+ * the default nav entries (e.g. add owner-scoped sections for a specific org).
+ *
+ * @example
+ * ```tsx
+ * <KnowledgeSidebarMiddle items={[...KNOWLEDGE_ITEMS, { label: 'Runbooks', ... }]} />
+ * ```
+ */
+declare const KnowledgeSidebarMiddle: ({ items }?: KnowledgeSidebarMiddleProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Default sidebar nav items for the Knowledge feature.
+ *
+ * Mirrors the `CRM_ITEMS` shape so it can be used directly with
+ * `KnowledgeSidebarMiddle` or spread into a custom items array.
+ *
+ * @example
+ * ```ts
+ * import { KNOWLEDGE_ITEMS } from '@elevasis/ui/knowledge'
+ * const customItems: NavItem[] = [
+ *   ...KNOWLEDGE_ITEMS,
+ *   { label: 'Internal Runbooks', to: '/knowledge/by-owner/internal', icon: IconBook, exact: false },
+ * ]
+ * ```
+ */
+declare const KNOWLEDGE_ITEMS: NavItem[];
+
+/**
+ * Default v1 component allowlist for knowledge MDX bodies.
+ *
+ * Knowledge authors may use these components inside `body` strings.
+ * Code blocks (`pre` / `code`) are handled by the MDX runtime's default
+ * element mapping and do not need an explicit entry here; they receive
+ * standard Mantine `Code` / `pre` wrappers via the provider's MDX config.
+ *
+ * Consumers may extend this map via `KnowledgeMDXProvider`'s
+ * `extraComponents` prop. Extra entries override matching default keys.
+ */
+declare const KNOWLEDGE_ALLOWLIST: Record<string, ComponentType<any>>;
+
+/**
+ * The shape of the merged component map available to knowledge MDX renderers.
+ * Keys are MDX component names (e.g. "Card", "Callout"); values are React component types.
+ */
+type KnowledgeAllowlistMap = Record<string, ComponentType<any>>;
+interface KnowledgeMDXProviderProps {
+    /**
+     * Additional components to merge into the default allowlist.
+     * Extra entries take precedence over the defaults, enabling consumers
+     * to replace (e.g.) the default `Card` with a project-specific variant.
+     */
+    extraComponents?: Record<string, ComponentType<any>>;
+    children: ReactNode;
+}
+/**
+ * Provides the knowledge MDX component allowlist to its subtree via React context.
+ *
+ * Wrap any `KnowledgeNodeView` (or custom renderer that renders compiled MDX bodies)
+ * with this provider. The merged allowlist is available via `useKnowledgeAllowlist()`.
+ *
+ * Merge order: `KNOWLEDGE_ALLOWLIST` defaults, then `extraComponents` override.
+ *
+ * @example
+ * ```tsx
+ * <KnowledgeMDXProvider extraComponents={{ Card: MyCustomCard }}>
+ *   <KnowledgeNodeView node={node} />
+ * </KnowledgeMDXProvider>
+ * ```
+ */
+declare function KnowledgeMDXProvider({ extraComponents, children }: KnowledgeMDXProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Returns the merged knowledge MDX component allowlist from the nearest
+ * `KnowledgeMDXProvider` in the tree.
+ *
+ * Throws if called outside a `KnowledgeMDXProvider`.
+ *
+ * @example
+ * ```tsx
+ * const components = useKnowledgeAllowlist()
+ * const Body = KNOWLEDGE_BODIES[node.id]
+ * return <Body components={components} />
+ * ```
+ */
+declare function useKnowledgeAllowlist(): KnowledgeAllowlistMap;
+
+type KnowledgeBodyProps = {
+    components?: Record<string, ComponentType>;
+};
+declare const KNOWLEDGE_BODIES: Record<string, ComponentType<KnowledgeBodyProps>>;
+
+export { KNOWLEDGE_ALLOWLIST, KNOWLEDGE_BODIES, KNOWLEDGE_ITEMS, KnowledgeBrowser, KnowledgeMDXProvider, KnowledgeNodeList, KnowledgeNodeView, KnowledgeSearchBar, KnowledgeSidebarMiddle, KnowledgeTree, useKnowledgeAllowlist };
+export type { KnowledgeBrowserProps, KnowledgeNodeListProps, KnowledgeNodeViewProps, KnowledgeSearchBarProps, KnowledgeSidebarMiddleProps, KnowledgeTreeProps };