@xemahq/ui-kernel 0.25.0 → 0.26.0

package/README.md

@@ -1,49 +1,15 @@
-<p align="center">
-<svg width="680" height="120" viewBox="0 0 680 120" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="@xemahq/ui-kernel">
-  <rect width="680" height="120" rx="14" fill="#0B1020"/>
-  <g transform="translate(28,34)">
-    <path d="M26 0 L52 15 L52 45 L26 60 L0 45 L0 15 Z" fill="#8B5CF6" opacity="0.18"/>
-    <path d="M26 12 L41 21 L41 39 L26 48 L11 39 L11 21 Z" fill="#8B5CF6"/>
-  </g>
-  <text x="92" y="52" font-family="ui-monospace,SFMono-Regular,Menlo,monospace" font-size="22" fill="#F8FAFC" font-weight="700">@xemahq/ui-kernel</text>
-  <text x="92" y="80" font-family="ui-sans-serif,system-ui,sans-serif" font-size="15" fill="#94A3B8">Host-agnostic UI kernel for the Xema frontend</text>
-  <text x="652" y="105" text-anchor="end" font-family="ui-sans-serif,system-ui,sans-serif" font-size="12" fill="#475569">xema.dev</text>
-</svg>
-</p>
-
-<p align="center">
-  <a href="https://xema.dev">Website</a> &middot;
-  <a href="https://www.npmjs.com/package/@xemahq/ui-kernel">npm</a>
-</p>
-
-<p align="center">
-  <img alt="npm" src="https://img.shields.io/npm/v/%40xemahq%2Fui-kernel?color=2563eb&label=npm">
-  <img alt="license" src="https://img.shields.io/npm/l/%40xemahq%2Fui-kernel?color=10b981">
-  <img alt="types" src="https://img.shields.io/npm/types/%40xemahq%2Fui-kernel?color=3178c6">
-</p>
-
 # @xemahq/ui-kernel
 
 > Host-agnostic UI kernel for the Xema frontend
 
 ## Overview
 
-The host-framework-agnostic UI kernel every frontend biome composes against. It
-defines the system bus — the orchestration contract for capability invocation,
-cross-biome intents, the command palette, deeplinks, and window management — and
-the biome-host contract surface, including the frontend-biome and host-bridge
-shapes, the singleton biome registry, and session contributions. React is the
-shared component model, but the kernel carries no router, bundler, or
-host-specific wiring; concrete host adapters live in separate packages. The
-system bus is pure orchestration — it never authorizes; policy is enforced by
-the backend.
+The host-agnostic UI kernel that Xema frontend biomes are built on. It provides `defineWebBiome` for declaring pages, the biome registry, the system bus for capability invocation, intents, the command palette and deeplinks, and the shared design system under `@xemahq/ui-kernel/ui`. The bus only orchestrates; the backend enforces policy.
 
 ## When to use it
 
-- Use it to author a frontend biome against the shared host contracts and
-  register it with the biome registry.
-- Reach for the system bus to dispatch capability invocations, intents, or
-  deeplinks across biomes.
+- You are authoring a frontend biome and registering it with the host.
+- You need the shared components so a biome looks identical to built-in ones.
 
 ## Installation
 
@@ -53,10 +19,6 @@ pnpm add @xemahq/ui-kernel
 
 ## Usage
 
-Author a web biome with `defineWebBiome` — a declarative page list where each
-`slug` single-sources both the nav route and the route path, and each page
-declares its menu `category` (the host owns where that category renders):
-
 ```tsx
 import { defineWebBiome } from '@xemahq/ui-kernel';
 import { Layers } from 'lucide-react';
@@ -76,45 +38,24 @@ export default defineWebBiome({
 });
 ```
 
-The helper emits the nav item + route (wrapping the lazily-loaded page in a
-`<Suspense>` boundary) and passes through `init`/`panels`/`session` for bespoke
-biomes. Pass a per-page `id` to keep a short nav id distinct from the route
-slug, or `navHidden: true` to register a route with no nav item.
+Each page's `slug` sets both its nav route and its path. Use a per-page `id` for a short nav id, or `navHidden: true` for a route with no nav item.
 
-Lower-level building blocks are also exported:
+Lower-level pieces:
 
 ```ts
 import { buildSystemBus, biomeRegistry } from '@xemahq/ui-kernel';
 
 const bus = buildSystemBus(hostPorts);
-
-// Register a frontend biome so the host can render its contributions:
 biomeRegistry.registerBiome(myBiome);
 ```
 
-## UI components
-
-Build your pages with the shared design system from `@xemahq/ui-kernel/ui` so a
-third-party biome renders pixel-identical to a built-in one (they resolve
-against the host theme at render):
-
-```tsx
-import {
-  Button, Badge, Input, Select, Dialog, Card, Tabs, Table, // primitives
-  PageShell, PageHeader, EmptyState, ErrorCard, StateCard, LoadingState, AsyncBoundary,
-  StatusBadge, ScopeBadge, ConfirmDeleteDialog, FormStepper, AsyncCombobox,
-  getStatusStyle, cn,
-} from '@xemahq/ui-kernel/ui';
-```
-
-Host-service hooks (toast, error copy, URL-backed page state) come from the
-`HostBridge` — e.g. `useMutationWithErrorToast`, `usePageState` from
-`@xemahq/ui-kernel` — so biomes never import host internals directly.
+Components come from `@xemahq/ui-kernel/ui` (for example `Button`, `Card`, `Table`, `PageShell`). Host hooks such as `useMutationWithErrorToast` and `usePageState` come from `@xemahq/ui-kernel`.
 
 ## Peer requirements
 
-- `react` — the shared component model.
-- `@tanstack/react-query` — async state for host data hooks.
+- `react` `^18.3.1`
+- `@tanstack/react-query` `^5.0.0`
+- `@xemahq/contracts` `>=0.4.0`
 
 ## License
 

package/dist/registry/index.d.ts

@@ -1,7 +1,11 @@
 export * from './lib/extension-points';
 export * from './lib/agent-validation-host';
 export * from './lib/biome-slot';
-export * from './lib/biome-applicability-context';
+export * from './lib/biome-presence';
+export * from './lib/biome-presence-context';
+export * from './lib/biome-presence-error-card';
+export * from './lib/biome-presence-error-title';
+export * from './lib/biome-presence-gate';
 export * from './lib/biomes-enabled-context';
 export * from './lib/session-selectors';
 export * from './lib/session-context-builder';

package/dist/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}

package/dist/registry/index.js

@@ -1,7 +1,11 @@
 export * from './lib/extension-points';
 export * from './lib/agent-validation-host';
 export * from './lib/biome-slot';
-export * from './lib/biome-applicability-context';
+export * from './lib/biome-presence';
+export * from './lib/biome-presence-context';
+export * from './lib/biome-presence-error-card';
+export * from './lib/biome-presence-error-title';
+export * from './lib/biome-presence-gate';
 export * from './lib/biomes-enabled-context';
 export * from './lib/session-selectors';
 export * from './lib/session-context-builder';

package/dist/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}

package/dist/registry/lib/biome-presence-context.d.ts

@@ -0,0 +1,8 @@
+import type { BiomePresenceAnswer, BiomePresenceLookup } from './biome-presence';
+export declare const BiomePresenceContext: import("react").Context<BiomePresenceLookup | null>;
+export declare class MissingBiomePresenceProviderError extends Error {
+    constructor();
+}
+export declare function useBiomePresenceLookup(): BiomePresenceLookup;
+export declare function useBiomePresence(biomeId: string): BiomePresenceAnswer;
+//# sourceMappingURL=biome-presence-context.d.ts.map

package/dist/registry/lib/biome-presence-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-context.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AA4BjF,eAAO,MAAM,oBAAoB,qDAAkD,CAAC;AAIpF,qBAAa,iCAAkC,SAAQ,KAAK;;CAS3D;AAOD,wBAAgB,sBAAsB,IAAI,mBAAmB,CAM5D;AAOD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAErE"}

package/dist/registry/lib/biome-presence-context.js

@@ -0,0 +1,22 @@
+import { createContext, useContext } from 'react';
+export const BiomePresenceContext = createContext(null);
+BiomePresenceContext.displayName = 'BiomePresenceContext';
+export class MissingBiomePresenceProviderError extends Error {
+    constructor() {
+        super('No BiomePresenceContext provider: BiomeSlot, BiomePresenceGate and useBiomePresence ' +
+            'need the host to mount <BiomePresenceContext.Provider> with its installed-set lookup ' +
+            'above them.');
+        this.name = 'MissingBiomePresenceProviderError';
+    }
+}
+export function useBiomePresenceLookup() {
+    const lookup = useContext(BiomePresenceContext);
+    if (lookup === null) {
+        throw new MissingBiomePresenceProviderError();
+    }
+    return lookup;
+}
+export function useBiomePresence(biomeId) {
+    return useBiomePresenceLookup()(biomeId);
+}
+//# sourceMappingURL=biome-presence-context.js.map

package/dist/registry/lib/biome-presence-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-context.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA8BlD,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAC;AACpF,oBAAoB,CAAC,WAAW,GAAG,sBAAsB,CAAC;AAG1D,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IAC1D;QACE,KAAK,CACH,sFAAsF;YACpF,uFAAuF;YACvF,aAAa,CAChB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;IAClD,CAAC;CACF;AAOD,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,iCAAiC,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,sBAAsB,EAAE,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/registry/lib/biome-presence-error-card.d.ts

@@ -0,0 +1,8 @@
+import { type BiomePresenceError } from './biome-presence';
+import type { ReactElement } from 'react';
+export interface BiomePresenceErrorCardProps {
+    readonly biomeId: string;
+    readonly answer: BiomePresenceError;
+}
+export declare function BiomePresenceErrorCard({ biomeId, answer, }: BiomePresenceErrorCardProps): ReactElement;
+//# sourceMappingURL=biome-presence-error-card.d.ts.map

package/dist/registry/lib/biome-presence-error-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-error-card.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-error-card.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAMD,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,MAAM,GACP,EAAE,2BAA2B,GAAG,YAAY,CAE5C"}

package/dist/registry/lib/biome-presence-error-card.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { biomePresenceErrorTitle } from './biome-presence-error-title';
+import ErrorCard from '../../ui/chrome/ErrorCard';
+export function BiomePresenceErrorCard({ biomeId, answer, }) {
+    return _jsx(ErrorCard, { title: biomePresenceErrorTitle(biomeId, answer.reason), error: answer.error });
+}
+//# sourceMappingURL=biome-presence-error-card.js.map

package/dist/registry/lib/biome-presence-error-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-error-card.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-error-card.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,SAAS,MAAM,2BAA2B,CAAC;AAalD,MAAM,UAAU,sBAAsB,CAAC,EACrC,OAAO,EACP,MAAM,GACsB;IAC5B,OAAO,KAAC,SAAS,IAAC,KAAK,EAAE,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,GAAI,CAAC;AACpG,CAAC"}

package/dist/registry/lib/biome-presence-error-title.d.ts

@@ -0,0 +1,3 @@
+import { BiomePresenceErrorReason } from './biome-presence';
+export declare function biomePresenceErrorTitle(biomeId: string, reason: BiomePresenceErrorReason): string;
+//# sourceMappingURL=biome-presence-error-title.d.ts.map

package/dist/registry/lib/biome-presence-error-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-error-title.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-error-title.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAY5D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAEjG"}

package/dist/registry/lib/biome-presence-error-title.js

@@ -0,0 +1,10 @@
+import { BiomePresenceErrorReason } from './biome-presence';
+const TITLE_BY_REASON = {
+    [BiomePresenceErrorReason.LookupFailed]: (biomeId) => `Couldn't check whether ${biomeId} is installed`,
+    [BiomePresenceErrorReason.ProviderUnavailable]: (biomeId) => `${biomeId} is installed but unavailable`,
+    [BiomePresenceErrorReason.AuthorizationDenied]: (biomeId) => `You don't have access to check whether ${biomeId} is installed`,
+};
+export function biomePresenceErrorTitle(biomeId, reason) {
+    return TITLE_BY_REASON[reason](biomeId);
+}
+//# sourceMappingURL=biome-presence-error-title.js.map

package/dist/registry/lib/biome-presence-error-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-error-title.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-error-title.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,eAAe,GAA4E;IAC/F,CAAC,wBAAwB,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CACnD,0BAA0B,OAAO,eAAe;IAClD,CAAC,wBAAwB,CAAC,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAC1D,GAAG,OAAO,+BAA+B;IAC3C,CAAC,wBAAwB,CAAC,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAC1D,0CAA0C,OAAO,eAAe;CACnE,CAAC;AAGF,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,MAAgC;IACvF,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/registry/lib/biome-presence-gate.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement, ReactNode } from 'react';
+export interface BiomePresenceGateProps {
+    readonly biomeId: string;
+    readonly children: ReactNode;
+    readonly loading?: ReactNode;
+}
+export declare function BiomePresenceGate({ biomeId, children, loading, }: BiomePresenceGateProps): ReactElement | null;
+//# sourceMappingURL=biome-presence-gate.d.ts.map

package/dist/registry/lib/biome-presence-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-gate.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-gate.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;CAC9B;AAWD,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,QAAQ,EACR,OAAO,GACR,EAAE,sBAAsB,GAAG,YAAY,GAAG,IAAI,CAY9C"}

package/dist/registry/lib/biome-presence-gate.js

@@ -0,0 +1,19 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { BiomePresence } from './biome-presence';
+import { useBiomePresence } from './biome-presence-context';
+import { BiomePresenceErrorCard } from './biome-presence-error-card';
+import LoadingState from '../../ui/chrome/LoadingState';
+export function BiomePresenceGate({ biomeId, children, loading, }) {
+    const answer = useBiomePresence(biomeId);
+    switch (answer.presence) {
+        case BiomePresence.Installed:
+            return _jsx(_Fragment, { children: children });
+        case BiomePresence.Loading:
+            return _jsx(_Fragment, { children: loading ?? _jsx(LoadingState, {}) });
+        case BiomePresence.Absent:
+            return null;
+        case BiomePresence.Error:
+            return _jsx(BiomePresenceErrorCard, { biomeId: biomeId, answer: answer });
+    }
+}
+//# sourceMappingURL=biome-presence-gate.js.map

package/dist/registry/lib/biome-presence-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence-gate.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence-gate.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,YAAY,MAAM,8BAA8B,CAAC;AAsBxD,MAAM,UAAU,iBAAiB,CAAC,EAChC,OAAO,EACP,QAAQ,EACR,OAAO,GACgB;IACvB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,aAAa,CAAC,SAAS;YAC1B,OAAO,4BAAG,QAAQ,GAAI,CAAC;QACzB,KAAK,aAAa,CAAC,OAAO;YACxB,OAAO,4BAAG,OAAO,IAAI,KAAC,YAAY,KAAG,GAAI,CAAC;QAC5C,KAAK,aAAa,CAAC,MAAM;YACvB,OAAO,IAAI,CAAC;QACd,KAAK,aAAa,CAAC,KAAK;YACtB,OAAO,KAAC,sBAAsB,IAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAI,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/registry/lib/biome-presence.d.ts

@@ -0,0 +1,28 @@
+export declare enum BiomePresence {
+    Loading = "loading",
+    Installed = "installed",
+    Absent = "absent",
+    Error = "error"
+}
+export declare enum BiomePresenceErrorReason {
+    LookupFailed = "lookup_failed",
+    ProviderUnavailable = "provider_unavailable",
+    AuthorizationDenied = "authorization_denied"
+}
+export interface BiomePresenceLoading {
+    readonly presence: BiomePresence.Loading;
+}
+export interface BiomePresenceInstalled {
+    readonly presence: BiomePresence.Installed;
+}
+export interface BiomePresenceAbsent {
+    readonly presence: BiomePresence.Absent;
+}
+export interface BiomePresenceError {
+    readonly presence: BiomePresence.Error;
+    readonly reason: BiomePresenceErrorReason;
+    readonly error: unknown;
+}
+export type BiomePresenceAnswer = BiomePresenceLoading | BiomePresenceInstalled | BiomePresenceAbsent | BiomePresenceError;
+export type BiomePresenceLookup = (biomeId: string) => BiomePresenceAnswer;
+//# sourceMappingURL=biome-presence.d.ts.map

package/dist/registry/lib/biome-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence.ts"],"names":[],"mappings":"AA+BA,oBAAY,aAAa;IAEvB,OAAO,YAAY;IAEnB,SAAS,cAAc;IAEvB,MAAM,WAAW;IAEjB,KAAK,UAAU;CAChB;AAGD,oBAAY,wBAAwB;IAElC,YAAY,kBAAkB;IAE9B,mBAAmB,yBAAyB;IAE5C,mBAAmB,yBAAyB;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAE1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAGD,MAAM,MAAM,mBAAmB,GAC3B,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,GACnB,kBAAkB,CAAC;AAGvB,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,CAAC"}

package/dist/registry/lib/biome-presence.js

@@ -0,0 +1,14 @@
+export var BiomePresence;
+(function (BiomePresence) {
+    BiomePresence["Loading"] = "loading";
+    BiomePresence["Installed"] = "installed";
+    BiomePresence["Absent"] = "absent";
+    BiomePresence["Error"] = "error";
+})(BiomePresence || (BiomePresence = {}));
+export var BiomePresenceErrorReason;
+(function (BiomePresenceErrorReason) {
+    BiomePresenceErrorReason["LookupFailed"] = "lookup_failed";
+    BiomePresenceErrorReason["ProviderUnavailable"] = "provider_unavailable";
+    BiomePresenceErrorReason["AuthorizationDenied"] = "authorization_denied";
+})(BiomePresenceErrorReason || (BiomePresenceErrorReason = {}));
+//# sourceMappingURL=biome-presence.js.map

package/dist/registry/lib/biome-presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-presence.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-presence.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IAEvB,oCAAmB,CAAA;IAEnB,wCAAuB,CAAA;IAEvB,kCAAiB,CAAA;IAEjB,gCAAe,CAAA;AACjB,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAGD,MAAM,CAAN,IAAY,wBAOX;AAPD,WAAY,wBAAwB;IAElC,0DAA8B,CAAA;IAE9B,wEAA4C,CAAA;IAE5C,wEAA4C,CAAA;AAC9C,CAAC,EAPW,wBAAwB,KAAxB,wBAAwB,QAOnC"}

package/dist/registry/lib/biome-slot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"biome-slot.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-slot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAMpD,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAqBD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAqCpE"}
+{"version":3,"file":"biome-slot.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-slot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAWhE,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAwBD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAkEpE"}

package/dist/registry/lib/biome-slot.js

@@ -1,21 +1,42 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Fragment } from 'react';
-import { useBiomeApplicability } from './biome-applicability-context';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment, useContext } from 'react';
+import { BiomePresence } from './biome-presence';
+import { BiomePresenceContext, MissingBiomePresenceProviderError, } from './biome-presence-context';
+import { BiomePresenceErrorCard } from './biome-presence-error-card';
 import { useBiomesEnabled } from './biomes-enabled-context';
 import { biomeRegistry, useBiomeRegistryRevision } from '../../index';
 export function BiomeSlot(props) {
     useBiomeRegistryRevision();
     const enabled = useBiomesEnabled();
-    const applies = useBiomeApplicability();
+    const presenceOf = useContext(BiomePresenceContext);
     if (!enabled) {
         return props.fallback ?? null;
     }
-    const entries = biomeRegistry
-        .panelEntriesForSlot(props.name)
-        .filter((entry) => applies(entry.biomeId));
-    if (entries.length === 0) {
-        return props.fallback ?? null;
+    if (presenceOf === null) {
+        throw new MissingBiomePresenceProviderError();
+    }
+    const installed = [];
+    const failed = [];
+    let unresolved = false;
+    for (const entry of biomeRegistry.panelEntriesForSlot(props.name)) {
+        const answer = presenceOf(entry.biomeId);
+        switch (answer.presence) {
+            case BiomePresence.Installed:
+                installed.push({ key: entry.panel.id, node: _jsx(_Fragment, { children: entry.panel.render() }) });
+                break;
+            case BiomePresence.Error:
+                failed.push({ key: entry.panel.id, biomeId: entry.biomeId, answer });
+                break;
+            case BiomePresence.Loading:
+                unresolved = true;
+                break;
+            case BiomePresence.Absent:
+                break;
+        }
+    }
+    if (installed.length === 0 && failed.length === 0) {
+        return unresolved ? null : (props.fallback ?? null);
     }
-    return (_jsx(Fragment, { children: entries.map((entry) => (_jsx(Fragment, { children: entry.panel.render() }, entry.panel.id))) }));
+    return (_jsxs(Fragment, { children: [installed.map(({ key, node }) => (_jsx(Fragment, { children: node }, key))), failed.map(({ key, biomeId, answer }) => (_jsx(BiomePresenceErrorCard, { biomeId: biomeId, answer: answer }, key)))] }));
 }
 //# sourceMappingURL=biome-slot.js.map

package/dist/registry/lib/biome-slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"biome-slot.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-slot.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAqB,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AA4BtE,MAAM,UAAU,SAAS,CAAC,KAAqB;IAE7C,wBAAwB,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAInC,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IAChC,CAAC;IAcD,MAAM,OAAO,GAAG,aAAa;SAC1B,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC;SAC/B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IAChC,CAAC;IACD,OAAO,CACL,KAAC,QAAQ,cACN,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACtB,KAAC,QAAQ,cAAuB,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAArC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAmC,CACjE,CAAC,GACO,CACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"biome-slot.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-slot.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAqB,MAAM,OAAO,CAAC;AAEhE,OAAO,EAAE,aAAa,EAA2B,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AA+BtE,MAAM,UAAU,SAAS,CAAC,KAAqB;IAE7C,wBAAwB,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAMnC,MAAM,UAAU,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IAChC,CAAC;IACD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,iCAAiC,EAAE,CAAC;IAChD,CAAC;IAmBD,MAAM,SAAS,GAA4D,EAAE,CAAC;IAC9E,MAAM,MAAM,GAA8F,EAAE,CAAC;IAC7G,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,aAAa,CAAC,SAAS;gBAC1B,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,4BAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAI,EAAE,CAAC,CAAC;gBAC3E,MAAM;YACR,KAAK,aAAa,CAAC,KAAK;gBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACrE,MAAM;YACR,KAAK,aAAa,CAAC,OAAO;gBACxB,UAAU,GAAG,IAAI,CAAC;gBAClB,MAAM;YACR,KAAK,aAAa,CAAC,MAAM;gBACvB,MAAM;QACV,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CACL,MAAC,QAAQ,eACN,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAChC,KAAC,QAAQ,cAAY,IAAI,IAAV,GAAG,CAAmB,CACtC,CAAC,EACD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CACxC,KAAC,sBAAsB,IAAW,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,IAArC,GAAG,CAAsC,CACvE,CAAC,IACO,CACZ,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "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.",
+  "description": "Host-framework-agnostic UI kernel for Xema. 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.",
   "keywords": [
     "xema",
     "xema-platform",
@@ -50,7 +50,7 @@
     "@radix-ui/react-switch": "^1.2.5",
     "@radix-ui/react-tabs": "^1.1.12",
     "@radix-ui/react-tooltip": "^1.2.7",
-    "@xemahq/registry": "^0.1.4",
+    "@xemahq/registry": "^0.1.7",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.462.0",
@@ -74,14 +74,14 @@
     "@types/node": "25.2.3",
     "@types/react": "^18.3.30",
     "@types/react-dom": "^18.3.7",
-    "@xemahq/contracts": "^0.75.0",
+    "@xemahq/contracts": "^0.86.0",
     "eslint": "^9.39.4",
     "prettier": "3.6.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "5.9.3",
     "vitest": "^3.2.4",
-    "@xemahq/eslint-config": "0.13.0"
+    "@xemahq/eslint-config": "0.14.1"
   },
   "exports": {
     ".": {
@@ -119,6 +119,6 @@
     "typecheck": "tsc -p tsconfig.lint.json --noEmit"
   },
   "xemaRelease": {
-    "sourceDigest": "sha256:532fe368e3a30f6d1ba2a687296d7fc7143e1d7f6fe21e8f0591db7d8a8a50ed"
+    "sourceDigest": "sha256:2cf465cfa890df410258d5fbb90287f63096f7a31b5d20456b54a1d3082c3cb0"
   }
 }

package/dist/registry/lib/biome-applicability-context.d.ts

@@ -1,4 +0,0 @@
-export type BiomeApplicability = (biomeId: string) => boolean;
-export declare const BiomeApplicabilityContext: import("react").Context<BiomeApplicability>;
-export declare function useBiomeApplicability(): BiomeApplicability;
-//# sourceMappingURL=biome-applicability-context.d.ts.map

package/dist/registry/lib/biome-applicability-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"biome-applicability-context.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/biome-applicability-context.ts"],"names":[],"mappings":"AAwCA,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAI9D,eAAO,MAAM,yBAAyB,6CACoB,CAAC;AAG3D,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D"}

package/dist/registry/lib/biome-applicability-context.js

@@ -1,8 +0,0 @@
-import { createContext, useContext } from 'react';
-const APPLIES_TO_EVERYTHING = () => true;
-export const BiomeApplicabilityContext = createContext(APPLIES_TO_EVERYTHING);
-BiomeApplicabilityContext.displayName = 'BiomeApplicabilityContext';
-export function useBiomeApplicability() {
-    return useContext(BiomeApplicabilityContext);
-}
-//# sourceMappingURL=biome-applicability-context.js.map

package/dist/registry/lib/biome-applicability-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"biome-applicability-context.js","sourceRoot":"","sources":["../../../src/registry/lib/biome-applicability-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA0ClD,MAAM,qBAAqB,GAAuB,GAAG,EAAE,CAAC,IAAI,CAAC;AAE7D,MAAM,CAAC,MAAM,yBAAyB,GACpC,aAAa,CAAqB,qBAAqB,CAAC,CAAC;AAC3D,yBAAyB,CAAC,WAAW,GAAG,2BAA2B,CAAC;AAEpE,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAC/C,CAAC"}