@elevasis/ui 2.25.3 → 2.25.5

package/dist/provider/index.d.ts

@@ -3707,6 +3707,9 @@ interface SSEConnectionManagerLike {
     }>;
 }
 
+type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
+    knowledge?: OrganizationModel['knowledge'];
+};
 type FeatureSidebarComponent = ComponentType;
 type FeatureIconComponent = ComponentType<{
     size?: number;
@@ -3777,7 +3780,7 @@ interface OrganizationGraphContextValue {
 }
 interface ElevasisFeaturesProviderProps {
     features: FeatureModule[];
-    organizationModel?: OrganizationModel;
+    organizationModel?: ElevasisOrganizationModel;
     timeRange?: TimeRange;
     operationsApiUrl?: string;
     operationsSSEManager?: SSEConnectionManagerLike;

package/dist/provider/index.js

@@ -1,15 +1,15 @@
-export { createTestFeaturesProvider } from '../chunk-PNLJIPV5.js';
+export { createTestFeaturesProvider } from '../chunk-VMJVQAFZ.js';
 export { ElevasisUIProvider } from '../chunk-MU4VPAMR.js';
 import '../chunk-QIW6OCEI.js';
 import '../chunk-WLOQ4IBG.js';
-export { FeatureShell } from '../chunk-IYIZYMIE.js';
-export { CrmActionsProvider, ElevasisCoreProvider, ListActionsProvider, NotificationProvider, useCrmActions, useListActions, useNotificationAdapter } from '../chunk-JMI7L7Y7.js';
-export { ElevasisFeaturesProvider, useElevasisFeatures, useOptionalElevasisFeatures } from '../chunk-4ZFBVND2.js';
+export { FeatureShell } from '../chunk-TAIX4NO3.js';
 import '../chunk-TKAYX2SP.js';
 import '../chunk-U36X6NZM.js';
+import '../chunk-NYBEU5TE.js';
+export { CrmActionsProvider, ElevasisCoreProvider, ListActionsProvider, NotificationProvider, useCrmActions, useListActions, useNotificationAdapter } from '../chunk-JMI7L7Y7.js';
 import '../chunk-SZHARWKU.js';
+export { ElevasisFeaturesProvider, useElevasisFeatures, useOptionalElevasisFeatures } from '../chunk-V3HUIZJX.js';
 import '../chunk-3KMDHCAR.js';
-import '../chunk-NYBEU5TE.js';
 import '../chunk-T6INEVX6.js';
 import '../chunk-2IFYDILW.js';
 import '../chunk-Q7DJKLEN.js';

package/dist/provider/published.css

@@ -156,15 +156,32 @@
 .mantine-Select-option:hover {
   background-color: var(--color-surface-hover) !important;
 }
-[data-mantine-color-scheme=dark] .mantine-Tabs-root {
+[data-mantine-color-scheme] .mantine-Tabs-root {
+  --tabs-color: var(--color-primary);
   --tab-border-color: var(--color-border);
+  --tab-hover-color: color-mix(in srgb, var(--color-surface-hover) 70%, transparent);
+}
+[data-mantine-color-scheme] .mantine-Tabs-list::before {
+  border-color: var(--color-border);
+}
+[data-mantine-color-scheme] .mantine-Tabs-tab {
+  color: var(--color-text);
+  border-color: transparent;
+  background-color: transparent;
+  transition:
+    background-color var(--duration-fast) var(--easing),
+    border-color var(--duration-fast) var(--easing),
+    color var(--duration-fast) var(--easing);
 }
 [data-mantine-color-scheme] .mantine-Tabs-tab:not([data-active]):hover {
-  background-color: color-mix(in srgb, var(--color-surface-hover) 70%, transparent);
+  background-color: var(--tab-hover-color);
+  border-color: var(--color-border);
 }
 [data-mantine-color-scheme] .mantine-Tabs-tab[data-active],
 [data-mantine-color-scheme] .mantine-Tabs-tab[data-active]:hover {
+  color: var(--color-text);
   background-color: transparent;
+  border-color: var(--color-primary);
 }
 .mantine-Pagination-control:not([data-active]) {
   background: var(--color-surface);

package/dist/provider/published.d.ts

@@ -3670,6 +3670,9 @@ interface SSEConnectionManagerLike {
     }>;
 }
 
+type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
+    knowledge?: OrganizationModel['knowledge'];
+};
 type FeatureSidebarComponent = ComponentType;
 type FeatureIconComponent = ComponentType<{
     size?: number;
@@ -3740,7 +3743,7 @@ interface OrganizationGraphContextValue {
 }
 interface ElevasisFeaturesProviderProps {
     features: FeatureModule[];
-    organizationModel?: OrganizationModel;
+    organizationModel?: ElevasisOrganizationModel;
     timeRange?: TimeRange;
     operationsApiUrl?: string;
     operationsSSEManager?: SSEConnectionManagerLike;

package/dist/provider/published.js

@@ -1,11 +1,11 @@
-export { FeatureShell } from '../chunk-IYIZYMIE.js';
-export { ElevasisCoreProvider, NotificationProvider, useNotificationAdapter } from '../chunk-JMI7L7Y7.js';
-export { ElevasisFeaturesProvider, useElevasisFeatures, useOptionalElevasisFeatures } from '../chunk-4ZFBVND2.js';
+export { FeatureShell } from '../chunk-TAIX4NO3.js';
 import '../chunk-TKAYX2SP.js';
 import '../chunk-U36X6NZM.js';
+import '../chunk-NYBEU5TE.js';
+export { ElevasisCoreProvider, NotificationProvider, useNotificationAdapter } from '../chunk-JMI7L7Y7.js';
 import '../chunk-SZHARWKU.js';
+export { ElevasisFeaturesProvider, useElevasisFeatures, useOptionalElevasisFeatures } from '../chunk-V3HUIZJX.js';
 import '../chunk-3KMDHCAR.js';
-import '../chunk-NYBEU5TE.js';
 import '../chunk-T6INEVX6.js';
 import '../chunk-2IFYDILW.js';
 import '../chunk-Q7DJKLEN.js';

package/dist/vite-plugin-knowledge/index.d.ts

@@ -0,0 +1,37 @@
+import { Plugin } from 'vite';
+
+/**
+ * @elevasis/ui Vite plugin for knowledge bodies codegen.
+ *
+ * Runs the knowledge-bodies codegen at the following trigger points:
+ *   - buildStart: cold start (covers both `vite dev` and `vite build`)
+ *   - handleHotUpdate: file changes under packages/core/src/organization-model/
+ *
+ * Usage in vite.config.ts:
+ *
+ *   import { knowledgePlugin } from '@repo/ui/vite-plugin-knowledge'
+ *   // or (after publish):
+ *   import { knowledgePlugin } from '@elevasis/ui/vite-plugin-knowledge'
+ *
+ *   export default defineConfig({
+ *     plugins: [knowledgePlugin()],
+ *   })
+ *
+ * Wave 5a wires this into apps/command-center/vite.config.ts.
+ */
+
+interface KnowledgePluginOptions {
+    /**
+     * Absolute path to the monorepo root.
+     * Defaults to auto-detected from this file's location (packages/ui/src/vite-plugin-knowledge/).
+     * Override when the plugin is used from a project where the monorepo root differs.
+     */
+    monorepoRoot?: string;
+}
+/**
+ * Vite plugin: knowledge bodies codegen + HMR.
+ */
+declare function knowledgePlugin(options?: KnowledgePluginOptions): Plugin;
+
+export { knowledgePlugin };
+export type { KnowledgePluginOptions };

package/dist/vite-plugin-knowledge/index.js

@@ -0,0 +1,67 @@
+import '../chunk-I2KLQ2HA.js';
+import { spawnSync } from 'child_process';
+import { resolve } from 'path';
+
+function defaultMonorepoRoot() {
+  return resolve(import.meta.dirname, "..", "..", "..", "..");
+}
+function generatedBodiesPath(monorepoRoot) {
+  return resolve(monorepoRoot, "packages", "ui", "src", "knowledge", "_generated", "knowledge-bodies.tsx");
+}
+function runCodegen(monorepoRoot, logger) {
+  const scriptPath = resolve(monorepoRoot, "packages", "ui", "scripts", "generate-knowledge-bodies.ts");
+  logger.info("[knowledge-plugin] Regenerating knowledge bodies...");
+  const result = spawnSync("pnpm", ["--filter", "@repo/ui", "exec", "tsx", scriptPath], {
+    stdio: "inherit",
+    cwd: monorepoRoot,
+    shell: process.platform === "win32"
+  });
+  if (result.error) {
+    logger.error(`[knowledge-plugin] Codegen spawn failed: ${result.error.message}`);
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`[knowledge-plugin] Codegen exited with status ${result.status}`);
+  }
+  logger.info("[knowledge-plugin] Knowledge bodies regenerated.");
+}
+function knowledgePlugin(options = {}) {
+  const monorepoRoot = options.monorepoRoot ?? defaultMonorepoRoot();
+  let resolvedConfig;
+  let watchRoot;
+  return {
+    name: "elevasis:knowledge-bodies",
+    configResolved(config) {
+      resolvedConfig = config;
+      watchRoot = resolve(monorepoRoot, "packages", "core", "src", "organization-model");
+    },
+    buildStart() {
+      const logger = resolvedConfig?.logger ?? {
+        info: (msg) => console.log(msg),
+        error: (msg) => console.error(msg)
+      };
+      runCodegen(monorepoRoot, logger);
+      if (resolvedConfig?.command === "serve") {
+        this.addWatchFile(watchRoot);
+      }
+    },
+    handleHotUpdate({ file, server }) {
+      const isOrgModelChange = file.startsWith(watchRoot);
+      if (!isOrgModelChange) return;
+      const logger = server.config.logger;
+      try {
+        runCodegen(monorepoRoot, logger);
+      } catch (err) {
+        server.config.logger.error(`[knowledge-plugin] Codegen failed: ${String(err)}`);
+        return;
+      }
+      const bodiesModule = server.moduleGraph.getModuleById(generatedBodiesPath(monorepoRoot));
+      if (bodiesModule) {
+        server.moduleGraph.invalidateModule(bodiesModule);
+        server.hot.send({ type: "full-reload" });
+      }
+    }
+  };
+}
+
+export { knowledgePlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/ui",
-  "version": "2.25.3",
+  "version": "2.25.5",
   "description": "UI components and platform-aware hooks for building custom frontends on the Elevasis platform",
   "type": "module",
   "license": "MIT",
@@ -35,8 +35,8 @@
     "msw": "^2.11.0",
     "vitest": "^3.2.4",
     "@repo/core": "0.15.1",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "dependencies": {
     "@dagrejs/dagre": "^1.1.4",
@@ -84,6 +84,10 @@
       "types": "./dist/features/crm/index.d.ts",
       "import": "./dist/features/crm/index.js"
     },
+    "./features/knowledge": {
+      "types": "./dist/features/knowledge/index.d.ts",
+      "import": "./dist/features/knowledge/index.js"
+    },
     "./features/dashboard": {
       "types": "./dist/features/dashboard/index.d.ts",
       "import": "./dist/features/dashboard/index.js"
@@ -152,6 +156,14 @@
       "types": "./dist/execution/index.d.ts",
       "import": "./dist/execution/index.js"
     },
+    "./knowledge": {
+      "types": "./dist/knowledge/index.d.ts",
+      "import": "./dist/knowledge/index.js"
+    },
+    "./vite-plugin-knowledge": {
+      "types": "./dist/vite-plugin-knowledge/index.d.ts",
+      "import": "./dist/vite-plugin-knowledge/index.js"
+    },
     "./router": {
       "types": "./dist/router/index.d.ts",
       "import": "./dist/router/index.js"

package/src/knowledge/README.md

@@ -0,0 +1,31 @@
+# @elevasis/ui/knowledge
+
+Read-only browser primitives for the Organization Model knowledge graph.
+
+## Surface
+
+| Export                                                                 | Purpose                                                                             |
+| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `KnowledgeBrowser`                                                     | Composed default surface: tree + list+detail + search.                              |
+| `KnowledgeTree`                                                        | By-feature primary tree.                                                            |
+| `KnowledgeNodeList`                                                    | Flat list of node summary cards.                                                    |
+| `KnowledgeNodeView`                                                    | Single-node detail view: title, kind badge, summary, MDX body, edge sidecar.        |
+| `KnowledgeSearchBar`                                                   | Client-side search over `_generated/knowledge-search-index.json`.                   |
+| `KnowledgeSidebarMiddle`                                               | Sidebar middle section. Mirrors `CrmSidebarMiddle`.                                 |
+| `KNOWLEDGE_ITEMS`                                                      | Default sidebar nav items.                                                          |
+| `KnowledgeMDXProvider`, `useKnowledgeAllowlist`, `KNOWLEDGE_ALLOWLIST` | MDX runtime allowlist (`Card`, `Cards`, `Step`, `Steps`, `Callout`, `Tab`, `Tabs`). |
+| `KNOWLEDGE_BODIES`                                                     | Build-time-compiled MDX components keyed by node id.                                |
+
+## Customization tiers
+
+1. **Default** — mount `knowledgeManifest` from `@elevasis/ui/features/knowledge`.
+2. **Extend** — pass `extraComponents` to `KnowledgeMDXProvider` or compose around `KnowledgeSidebarMiddle` + `KNOWLEDGE_ITEMS`.
+3. **Replace** — call `@elevasis/core/knowledge` queries directly from project-owned routes.
+
+## Codegen
+
+`KNOWLEDGE_BODIES` and the search index are regenerated by `pnpm scaffold:sync` (or `pnpm knowledge:generate` to run only the knowledge step). Source: `DEFAULT_ORGANIZATION_MODEL.knowledge.nodes` from `@repo/core`.
+
+The Vite plugin at `@elevasis/ui/vite-plugin-knowledge` re-runs codegen on `buildStart` and watches the OM source dir for HMR.
+
+Phase 1 is read-only. Phase 2 will move bodies into Supabase and ship via `mdx-bundler`.