@xemahq/ui-kernel 0.10.0 → 0.11.1

package/dist/vista/vista-tools.js

@@ -39,18 +39,21 @@ export function dispatchVistaTool(controller, tool, args) {
     switch (tool) {
         case VistaToolName.Open: {
             const parsed = VistaOpenArgsSchema.safeParse(args);
-            if (!parsed.success)
+            if (!parsed.success) {
                 return invalid(parsed.error);
+            }
             return { ok: true, value: { tabId: controller.open(parsed.data) } };
         }
         case VistaToolName.Update: {
             const parsed = VistaUpdateArgsSchema.safeParse(args);
-            if (!parsed.success)
+            if (!parsed.success) {
                 return invalid(parsed.error);
+            }
             const { tabId, ...patch } = parsed.data;
             const refusal = refusalFor(controller, tabId);
-            if (refusal !== null)
+            if (refusal !== null) {
                 return refusal;
+            }
             if (!controller.update(tabId, patch)) {
                 return {
                     ok: false,
@@ -62,12 +65,14 @@ export function dispatchVistaTool(controller, tool, args) {
         }
         case VistaToolName.Close: {
             const parsed = VistaCloseArgsSchema.safeParse(args);
-            if (!parsed.success)
+            if (!parsed.success) {
                 return invalid(parsed.error);
+            }
             const { tabId } = parsed.data;
             const refusal = refusalFor(controller, tabId);
-            if (refusal !== null)
+            if (refusal !== null) {
                 return refusal;
+            }
             if (!controller.close(tabId)) {
                 return {
                     ok: false,
@@ -79,8 +84,9 @@ export function dispatchVistaTool(controller, tool, args) {
         }
         case VistaToolName.List: {
             const parsed = VistaListArgsSchema.safeParse(args ?? {});
-            if (!parsed.success)
+            if (!parsed.success) {
                 return invalid(parsed.error);
+            }
             return { ok: true, value: { tabs: controller.list() } };
         }
         default:

package/dist/vista/vista-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"vista-tools.js","sourceRoot":"","sources":["../../src/vista/vista-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vista-tools.js","sourceRoot":"","sources":["../../src/vista/vista-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "type": "module",
   "sideEffects": false,
   "description": "Host-framework-agnostic UI kernel for the Xema OS. Defines the SystemBus orchestration contract (capability.invoke, cross-biome intents, command palette, xema:// deeplinks, window manager) AND the biome-host contract surface (FrontendBiome/FrontendBiomeFactory, HostBridge, the singleton biomeRegistry, session contributions) that every frontend biome composes against. No Vite, Next.js, or React-Router — React itself IS allowed as the shared component model (the contracts traffic in ReactNode/ComponentType and a React context). Concrete host adapters (router/auth/toast wiring) live in separate packages that consume this kernel. The SystemBus is pure orchestration: it never authorizes, the backend capability-router enforces all policy.",
@@ -74,10 +74,13 @@
     "@tanstack/react-query": "^5.100.13",
     "@types/node": "25.2.3",
     "@types/react": "^18.3.30",
+    "@types/react-dom": "^18.3.7",
+    "@xemahq/kernel-contracts": "^8.0.0",
     "prettier": "3.6.2",
     "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.60.0"
+    "vitest": "^3.2.4"
   },
   "exports": {
     ".": {
@@ -109,9 +112,9 @@
   "scripts": {
     "clean": "rm -rf dist",
     "build": "tsc -p tsconfig.json",
-    "test": "echo '[ui-kernel] *.{test,spec} files run under host-web vitest (this package carries no vitest dep by design — see tsconfig exclude). Write tests with vitest; the frontend-bridge sync fails on a node:test file.'",
+    "test": "echo '[ui-kernel] *.{test,spec} files RUN under host-web vitest (this package has no vitest runner config). vitest is a devDependency here for TYPES only, so tsc typechecks the specs in the repo that owns them.'",
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
-    "lint": "tsc -p tsconfig.lint.json --noEmit",
+    "lint": "eslint .",
     "typecheck": "tsc -p tsconfig.lint.json --noEmit"
   }
 }

package/src/lib/biome-host/agent-validation.ts

@@ -82,11 +82,17 @@ export interface ValidateBiomeCompositionOptions {
  */
 function biomeOwnedSlotOwner(slot: string): string | null {
   const slashIndex = slot.indexOf('/');
-  if (slashIndex <= 0) return null; // no slash, or leading slash (empty owner)
-  if (slot.indexOf('/', slashIndex + 1) !== -1) return null; // more than one slash
+  if (slashIndex <= 0) {
+    return null;
+  } // no slash, or leading slash (empty owner)
+  if (slot.indexOf('/', slashIndex + 1) !== -1) {
+    return null;
+  } // more than one slash
   const owner = slot.slice(0, slashIndex);
   const name = slot.slice(slashIndex + 1);
-  if (owner.length === 0 || name.length === 0) return null;
+  if (owner.length === 0 || name.length === 0) {
+    return null;
+  }
   return owner;
 }
 
@@ -113,12 +119,17 @@ export function validateBiomeComposition(
       const scope = route.projectScoped ? 'project' : 'root';
       const key = `${scope}:${route.path}`;
       const owners = routeOwners.get(key);
-      if (owners) owners.push(biome.id);
-      else routeOwners.set(key, [biome.id]);
+      if (owners) {
+        owners.push(biome.id);
+      } else {
+        routeOwners.set(key, [biome.id]);
+      }
     }
   }
   for (const [key, owners] of routeOwners) {
-    if (owners.length < 2) continue;
+    if (owners.length < 2) {
+      continue;
+    }
     const [scope, path] = splitFirst(key, ':');
     diagnostics.push({
       code: CompositionDiagnosticCode.DuplicateRoutePath,
@@ -139,12 +150,17 @@ export function validateBiomeComposition(
   for (const biome of biomes) {
     for (const navItem of biome.navItems ?? []) {
       const owners = navOwners.get(navItem.id);
-      if (owners) owners.push(biome.id);
-      else navOwners.set(navItem.id, [biome.id]);
+      if (owners) {
+        owners.push(biome.id);
+      } else {
+        navOwners.set(navItem.id, [biome.id]);
+      }
     }
   }
   for (const [navId, owners] of navOwners) {
-    if (owners.length < 2) continue;
+    if (owners.length < 2) {
+      continue;
+    }
     diagnostics.push({
       code: CompositionDiagnosticCode.DuplicateNavId,
       severity: CompositionDiagnosticSeverity.Error,
@@ -159,7 +175,9 @@ export function validateBiomeComposition(
   // ── Panel slots: known-slot + dependency-closure ─────────────────────
   for (const biome of biomes) {
     for (const panel of biome.panels ?? []) {
-      if (options.knownSlots.has(panel.slot)) continue;
+      if (options.knownSlots.has(panel.slot)) {
+        continue;
+      }
       const owner = biomeOwnedSlotOwner(panel.slot);
       if (owner === null) {
         diagnostics.push({
@@ -197,7 +215,9 @@ export function validateBiomeComposition(
 /** Split on the first occurrence of `sep` into a `[head, tail]` pair. */
 function splitFirst(value: string, sep: string): [string, string] {
   const idx = value.indexOf(sep);
-  if (idx === -1) return [value, ''];
+  if (idx === -1) {
+    return [value, ''];
+  }
   return [value.slice(0, idx), value.slice(idx + sep.length)];
 }
 
@@ -206,10 +226,14 @@ function sortDiagnostics(
   diagnostics: CompositionDiagnostic[],
 ): CompositionDiagnostic[] {
   return diagnostics.slice().sort((a, b) => {
-    if (a.code !== b.code) return a.code.localeCompare(b.code);
+    if (a.code !== b.code) {
+      return a.code.localeCompare(b.code);
+    }
     const ai = a.biomeIds.join(',');
     const bi = b.biomeIds.join(',');
-    if (ai !== bi) return ai.localeCompare(bi);
+    if (ai !== bi) {
+      return ai.localeCompare(bi);
+    }
     return a.message.localeCompare(b.message);
   });
 }

package/src/lib/biome-host/biome-registry.ts

@@ -36,7 +36,10 @@ import type { HostBridge } from './host-bridge';
  * register/unregister/bootstrap call is a no-op — a single flag controls
  * the entire surface.
  */
-class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: string }> {
+class FrontendBiomeRegistry extends Registry<
+  string,
+  FrontendBiome & { key: string }
+> {
   private revisionCount = 0;
   private readonly listeners = new Set<() => void>();
   /**
@@ -54,7 +57,9 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
   }
 
   registerBiome(biome: FrontendBiome): void {
-    if (!this.enabled) return;
+    if (!this.enabled) {
+      return;
+    }
     this.register({ ...biome, key: biome.id });
     this.revisionCount += 1;
     this.notify();
@@ -67,14 +72,20 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
    */
   async runInit(biomeId: string, bridge: HostBridge): Promise<void> {
     const entry = this.get(biomeId);
-    if (!entry || !entry.init) return;
-    if (this.initialized.has(biomeId)) return;
+    if (!entry || !entry.init) {
+      return;
+    }
+    if (this.initialized.has(biomeId)) {
+      return;
+    }
     this.initialized.add(biomeId);
     await entry.init({ bridge, biomeId });
   }
 
   unregisterBiome(id: string): boolean {
-    if (!this.enabled) return false;
+    if (!this.enabled) {
+      return false;
+    }
     const entry = this.get(id);
     const removed = this.unregister(id);
     if (removed) {
@@ -86,7 +97,10 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
         // because the biome is being torn down anyway.
         void Promise.resolve(entry.dispose()).catch((error: unknown) => {
           // Surface for devtools without crashing the unregister flow.
-          console.error(`[xema-ui-kernel] dispose() failed for '${id}':`, error);
+          console.error(
+            `[xema-ui-kernel] dispose() failed for '${id}':`,
+            error,
+          );
         });
       }
       this.notify();
@@ -103,7 +117,9 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
   }
 
   setEnabled(enabled: boolean): void {
-    if (this.enabled === enabled) return;
+    if (this.enabled === enabled) {
+      return;
+    }
     this.enabled = enabled;
     if (!enabled) {
       // When master-disabling, drop any previously-registered biomes so
@@ -140,11 +156,15 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
   }
 
   panelsForSlot(slot: string): readonly PanelContribution[] {
-    if (!this.enabled) return [];
+    if (!this.enabled) {
+      return [];
+    }
     const out: PanelContribution[] = [];
     for (const biome of this.list()) {
       for (const panel of biome.panels ?? []) {
-        if (panel.slot === slot) out.push(panel);
+        if (panel.slot === slot) {
+          out.push(panel);
+        }
       }
     }
     return out.sort((a, b) => (a.weight ?? 100) - (b.weight ?? 100));
@@ -167,7 +187,9 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
    * rejected contribution is never dropped silently.
    */
   outputRenderers(): ReadonlyMap<string, OutputRendererContribution> {
-    if (!this.enabled) return new Map<string, OutputRendererContribution>();
+    if (!this.enabled) {
+      return new Map<string, OutputRendererContribution>();
+    }
     // `onDuplicate` fires SYNCHRONOUSLY from inside `register()`, so this
     // cursor always names the biome whose contribution was rejected — the
     // contribution object itself does not carry its owner.
@@ -200,6 +222,17 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
 
 export const biomeRegistry = new FrontendBiomeRegistry();
 
+function isFrontendBiome(value: unknown): value is FrontendBiome {
+  return (
+    value !== null &&
+    typeof value === 'object' &&
+    'id' in value &&
+    typeof value.id === 'string' &&
+    'displayName' in value &&
+    typeof value.displayName === 'string'
+  );
+}
+
 /**
  * Register an already-built `FrontendBiome` instance. Prefer
  * `registerFrontendBiome(factory, bridge)` for biomes shipped via
@@ -222,9 +255,11 @@ export function registerFrontendBiome(
   factory: FrontendBiomeFactory,
   bridge: HostBridge,
 ): void {
-  if (!biomeRegistry.isEnabled()) return;
-  const biome = factory(bridge);
-  if (!biome || typeof biome !== 'object' || typeof biome.id !== 'string') {
+  if (!biomeRegistry.isEnabled()) {
+    return;
+  }
+  const biome: unknown = factory(bridge);
+  if (!isFrontendBiome(biome)) {
     throw new Error(
       '[xema-ui-kernel] FrontendBiomeFactory returned a non-FrontendBiome value. ' +
         'A biome module must default-export `(bridge) => FrontendBiome`.',

package/src/lib/biome-host/biome-scope-hooks.ts

@@ -11,7 +11,9 @@ export interface RequiredProjectScope {
 }
 
 function normalize(value: string | null | undefined): string | null {
-  if (typeof value !== 'string') return null;
+  if (typeof value !== 'string') {
+    return null;
+  }
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : null;
 }

package/src/lib/biome-host/biome-scoped-query.ts

@@ -18,10 +18,7 @@ import {
   type UseQueryResult,
 } from '@tanstack/react-query';
 
-import {
-  useProjectScope,
-  type ProjectScope,
-} from './biome-scope-hooks';
+import { useProjectScope, type ProjectScope } from './biome-scope-hooks';
 
 /**
  * The canonical Xema-platform tenant header. Every platform biome-api reads it
@@ -38,8 +35,12 @@ const PROJECT_HEADER = 'X-Project-Id';
  */
 export function buildScopedRequestInit(scope: ProjectScope): RequestInit {
   const headers: Record<string, string> = {};
-  if (scope.orgId) headers[ORG_HEADER] = scope.orgId;
-  if (scope.projectId) headers[PROJECT_HEADER] = scope.projectId;
+  if (scope.orgId) {
+    headers[ORG_HEADER] = scope.orgId;
+  }
+  if (scope.projectId) {
+    headers[PROJECT_HEADER] = scope.projectId;
+  }
   return { headers };
 }
 

package/src/lib/biome-host/frontend-biome.ts

@@ -1,6 +1,6 @@
-import type { ComponentType, ReactNode } from 'react';
 import type { HostBridge } from './host-bridge';
 import type { SessionContributions } from './session-contributions';
+import type { ComponentType, ReactNode } from 'react';
 
 /**
  * Runtime contribution types a `target: 'web'` biome composes. Web

package/src/lib/biome-host/host-bridge.ts

@@ -1,12 +1,10 @@
-import type { QueryClient } from '@tanstack/react-query';
-
 import { createContext, useContext, type ReactNode } from 'react';
 
 import type { CapabilityPort } from '../capabilities';
 import type { SystemBus } from '../system-bus';
-
 import type { I18nSource } from './i18n-port';
 import type { RealtimeSource } from './realtime-port';
+import type { QueryClient } from '@tanstack/react-query';
 
 /**
  * `HostBridge` is the host-agnostic abstraction every frontend biome
@@ -44,7 +42,10 @@ export interface HostBridgeNavigation {
    * declares it is the matched route.
    */
   useRouteParams<
-    T extends Record<string, string | undefined> = Record<string, string | undefined>,
+    T extends Record<string, string | undefined> = Record<
+      string,
+      string | undefined
+    >,
   >(): T;
   /**
    * Hook returning the current URL query string as a read-only

package/src/lib/biome-host/i18n-hooks.ts

@@ -10,6 +10,7 @@
  */
 
 import { useHostBridge } from './host-bridge';
+
 import type { I18nSource, Translator } from './i18n-port';
 
 /**

package/src/lib/biome-host/realtime-hooks.ts

@@ -11,6 +11,7 @@
  */
 
 import { useHostBridge } from './host-bridge';
+
 import type {
   RealtimeCloudEvent,
   RealtimeConnectionState,

package/src/lib/biome-host/session-contributions.ts

@@ -20,9 +20,9 @@
  * `<biome-id>/<contribution>` so cross-biome collisions surface
  * deterministically at registration time (`RegistryDuplicateKeyError`).
  */
+import type { HostBridge } from './host-bridge';
 import type { ComponentType, ReactNode } from 'react';
 
-import type { HostBridge } from './host-bridge';
 /**
  * Read-only snapshot of the session the contribution is evaluated
  * against. Passed into every `appliesTo` predicate and every render

package/src/lib/biome-host/use-mutation-with-error-toast.ts

@@ -68,10 +68,12 @@ export function useMutationWithErrorToast<
       if (successTitle !== null && successTitle !== undefined) {
         bridge.toast.success(successTitle, successDescription);
       }
-      if (userOnSuccess) userOnSuccess(data, variables, context, mutation);
+      if (userOnSuccess) {
+        userOnSuccess(data, variables, context, mutation);
+      }
     },
     onError: (error: TError) => {
-      if (errorTitle !== null && errorTitle !== undefined) {
+      if (errorTitle !== undefined) {
         const shouldSuppressToast = customOnError?.(error) === true;
         if (!shouldSuppressToast) {
           const errorMessage = decodeError(

package/src/lib/biome-host/use-page-state.ts

@@ -25,9 +25,12 @@ function buildPath(pathname: string, params: URLSearchParams): string {
 }
 
 function serializeValue<T>(value: T): string {
-  if (typeof value === 'string') return value;
-  if (typeof value === 'number' || typeof value === 'boolean')
+  if (typeof value === 'string') {
+    return value;
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') {
     return String(value);
+  }
   return JSON.stringify(value);
 }
 
@@ -43,7 +46,9 @@ function deserializePrimitive<T>(
   rawValue: string,
   defaultValue: T,
 ): T | undefined {
-  if (typeof defaultValue === 'string') return rawValue as T;
+  if (typeof defaultValue === 'string') {
+    return rawValue as T;
+  }
 
   if (typeof defaultValue === 'number') {
     const numericValue = Number(rawValue);
@@ -51,8 +56,12 @@ function deserializePrimitive<T>(
   }
 
   if (typeof defaultValue === 'boolean') {
-    if (rawValue === 'true') return true as T;
-    if (rawValue === 'false') return false as T;
+    if (rawValue === 'true') {
+      return true as T;
+    }
+    if (rawValue === 'false') {
+      return false as T;
+    }
     return defaultValue;
   }
 
@@ -60,10 +69,14 @@ function deserializePrimitive<T>(
 }
 
 function deserializeValue<T>(rawValue: string | null, defaultValue: T): T {
-  if (rawValue === null) return defaultValue;
+  if (rawValue === null) {
+    return defaultValue;
+  }
 
   const primitive = deserializePrimitive(rawValue, defaultValue);
-  if (primitive !== undefined) return primitive;
+  if (primitive !== undefined) {
+    return primitive;
+  }
 
   // Default is null/undefined or a complex type (array/object). The value was
   // written via JSON.stringify in serializeValue, so attempt to parse it back.
@@ -74,9 +87,13 @@ function deserializeValue<T>(rawValue: string | null, defaultValue: T): T {
     return parsedValue as T;
   }
 
-  if (defaultValue === null || defaultValue === undefined) return rawValue as T;
+  if (defaultValue === null || defaultValue === undefined) {
+    return rawValue as T;
+  }
 
-  if (parsedValue !== undefined) return parsedValue as T;
+  if (parsedValue !== undefined) {
+    return parsedValue as T;
+  }
 
   if (Array.isArray(defaultValue)) {
     return rawValue ? ([rawValue] as unknown as T) : defaultValue;
@@ -218,7 +235,7 @@ export function useBatchPageState(): (
     (updates: Record<string, string | null>) => {
       const next = new URLSearchParams(searchParams);
       for (const [key, value] of Object.entries(updates)) {
-        if (value === null || value === undefined) {
+        if (value === null) {
           next.delete(key);
         } else {
           next.set(key, value);

package/src/lib/capabilities/capability-provider.tsx

@@ -1,13 +1,13 @@
 import { useQuery } from '@tanstack/react-query';
-import type { ReactNode } from 'react';
 
-import { useHostBridge } from '../biome-host/host-bridge';
 import {
   CapabilityContext,
   type CapabilityContextValue,
 } from './capability-context';
+import { useHostBridge } from '../biome-host/host-bridge';
 
 import type { CapabilityPort, MeCapabilitiesSnapshot } from './types';
+import type { ReactNode } from 'react';
 
 /**
  * Stable query-key root for the capability snapshot. Folded with the active
@@ -46,10 +46,13 @@ export interface CapabilityProviderProps {
  * Rendering is fail-soft (callers can show a loading state), but failures are
  * SURFACED via `error` rather than masquerading as an empty capability set.
  */
-export function CapabilityProvider(props: CapabilityProviderProps): JSX.Element {
+export function CapabilityProvider(
+  props: CapabilityProviderProps,
+): JSX.Element {
   const bridge = useHostBridge();
   const port = props.port ?? bridge.capabilities;
-  const orgId = props.orgId !== undefined ? props.orgId : bridge.auth.getOrgId();
+  const orgId =
+    props.orgId !== undefined ? props.orgId : bridge.auth.getOrgId();
 
   const query = useQuery<MeCapabilitiesSnapshot>({
     queryKey: [...CAPABILITIES_QUERY_ROOT, orgId],
@@ -62,5 +65,9 @@ export function CapabilityProvider(props: CapabilityProviderProps): JSX.Element
     error: query.error,
   };
 
-  return <CapabilityContext.Provider value={value}>{props.children}</CapabilityContext.Provider>;
+  return (
+    <CapabilityContext.Provider value={value}>
+      {props.children}
+    </CapabilityContext.Provider>
+  );
 }

package/src/lib/capabilities/use-capability.ts

@@ -1,10 +1,10 @@
-import type { ExecutionEnvironmentKind } from '@xemahq/kernel-contracts/execution-environment';
-
 import {
   useCapabilityContext,
   type CapabilityContextValue,
 } from './capability-context';
+
 import type { MeCapabilitiesSnapshot } from './types';
+import type { ExecutionEnvironmentKind } from '@xemahq/kernel-contracts/execution-environment';
 
 export interface UseCapabilityOptions {
   /**
@@ -45,12 +45,16 @@ export interface CapabilityDecision {
  * On error, `allowed` is `false` and `error` is set; the hook never silently
  * degrades a failed fetch into a confident denial.
  */
-export function useCapability(ref: string, opts?: UseCapabilityOptions): CapabilityDecision {
+export function useCapability(
+  ref: string,
+  opts?: UseCapabilityOptions,
+): CapabilityDecision {
   const { snapshot, isLoading, error } = useCapabilityContext();
 
   const entry = snapshot?.capabilities.find((c) => c.ref === ref);
   const inEnvironment =
-    !!entry && (!opts?.environment || entry.environments.includes(opts.environment));
+    !!entry &&
+    (!opts?.environment || entry.environments.includes(opts.environment));
 
   return {
     allowed: inEnvironment && !entry.approvalRequired,

package/src/lib/contribution-registry/contribution-registry.ts

@@ -134,7 +134,9 @@ export function createContributionRegistry<TEntry>(
       target.set(kind, entry);
       return;
     }
-    if (existing === entry) return;
+    if (existing === entry) {
+      return;
+    }
     if (duplicatePolicy === DuplicateContributionPolicy.FirstWins) {
       // `onDuplicate` is guaranteed present under this policy (checked above).
       (onDuplicate as (k: string, e: TEntry, r: TEntry) => void)(