@xemahq/ui-kernel 0.9.0 → 0.9.2

package/dist/vista/vista-payloads.js

@@ -0,0 +1,302 @@
+import { validateCaptureFields } from '../ui/capture/field-spec-validate';
+function asRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function optionalString(value) {
+    if (value === undefined)
+        return undefined;
+    return typeof value === 'string' ? value : null;
+}
+function exactlyOne(a, b) {
+    const left = typeof a === 'string' ? a : undefined;
+    const right = typeof b === 'string' ? b : undefined;
+    if ((left === undefined) === (right === undefined))
+        return null;
+    return left === undefined ? { b: right } : { a: left };
+}
+export function validateTextPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    const source = exactlyOne(record.content, record.path);
+    if (source === null)
+        return null;
+    const language = optionalString(record.language);
+    if (language === null)
+        return null;
+    const base = source.a === undefined ? { path: source.b } : { content: source.a };
+    return language === undefined ? base : { ...base, language };
+}
+export function validateBlobPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    const source = exactlyOne(record.url, record.path);
+    if (source === null)
+        return null;
+    const alt = optionalString(record.alt);
+    if (alt === null)
+        return null;
+    const contentType = optionalString(record.contentType);
+    if (contentType === null)
+        return null;
+    const payload = source.a === undefined ? { path: source.b } : { url: source.a };
+    if (alt !== undefined)
+        payload.alt = alt;
+    if (contentType !== undefined)
+        payload.contentType = contentType;
+    return payload;
+}
+const PREVIEW_DEVICES = [
+    'desktop',
+    'tablet',
+    'mobile',
+    'presentation',
+    'a4',
+];
+export function validateUrlPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (typeof record.url !== 'string' || record.url.length === 0)
+        return null;
+    const payload = { url: record.url };
+    if (record.device !== undefined) {
+        if (!PREVIEW_DEVICES.includes(record.device))
+            return null;
+        payload.device = record.device;
+    }
+    if (record.reloadNonce !== undefined) {
+        if (typeof record.reloadNonce !== 'number')
+            return null;
+        payload.reloadNonce = record.reloadNonce;
+    }
+    return payload;
+}
+const SRI_TOKEN = /^sha384-[A-Za-z0-9+/]+={0,2}$/;
+export function validateHtmlPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    const hasDocument = typeof record.document === 'string';
+    const hasChunk = typeof record.compiledOutput === 'string';
+    if (hasDocument === hasChunk)
+        return null;
+    if (hasDocument)
+        return { document: record.document };
+    if (typeof record.integrity !== 'string' || !SRI_TOKEN.test(record.integrity))
+        return null;
+    const styleCss = optionalString(record.styleCss);
+    if (styleCss === null)
+        return null;
+    const payload = {
+        compiledOutput: record.compiledOutput,
+        integrity: record.integrity,
+    };
+    return styleCss === undefined ? payload : { ...payload, styleCss };
+}
+export function validateJsonPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (!('data' in record))
+        return null;
+    return { data: record.data };
+}
+export function validateTablePayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (!Array.isArray(record.columns) || !Array.isArray(record.rows))
+        return null;
+    if (!record.columns.every((c) => typeof c === 'string'))
+        return null;
+    if (!record.rows.every((r) => Array.isArray(r)))
+        return null;
+    return {
+        columns: record.columns,
+        rows: record.rows,
+    };
+}
+export var VistaChartKind;
+(function (VistaChartKind) {
+    VistaChartKind["Bar"] = "bar";
+    VistaChartKind["Line"] = "line";
+    VistaChartKind["Donut"] = "donut";
+})(VistaChartKind || (VistaChartKind = {}));
+const CHART_KINDS = Object.values(VistaChartKind);
+export function validateChartPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (typeof record.kind !== 'string' || !CHART_KINDS.includes(record.kind))
+        return null;
+    if (typeof record.title !== 'string' || record.title.length === 0)
+        return null;
+    if (!Array.isArray(record.series) || record.series.length === 0)
+        return null;
+    const series = [];
+    for (const entry of record.series) {
+        const row = asRecord(entry);
+        if (row === null || typeof row.name !== 'string')
+            return null;
+        if (!Array.isArray(row.points))
+            return null;
+        const points = [];
+        for (const point of row.points) {
+            const p = asRecord(point);
+            if (p === null || typeof p.label !== 'string')
+                return null;
+            if (typeof p.value !== 'number')
+                return null;
+            points.push({ label: p.label, value: p.value });
+        }
+        series.push({ name: row.name, points });
+    }
+    return {
+        kind: record.kind,
+        title: record.title,
+        series: series,
+    };
+}
+export const validateDiffPayload = validateTextPayload;
+export function validateFilesPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (!Array.isArray(record.files))
+        return null;
+    const files = [];
+    for (const entry of record.files) {
+        const row = asRecord(entry);
+        if (row === null || typeof row.path !== 'string')
+            return null;
+        const file = {
+            path: row.path,
+        };
+        if (row.add !== undefined) {
+            if (typeof row.add !== 'number')
+                return null;
+            file.add = row.add;
+        }
+        if (row.del !== undefined) {
+            if (typeof row.del !== 'number')
+                return null;
+            file.del = row.del;
+        }
+        files.push(file);
+    }
+    return { files };
+}
+export function validateBiomeRoutePayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    return typeof record.deeplink === 'string' && record.deeplink.length > 0
+        ? { deeplink: record.deeplink }
+        : null;
+}
+export function validateObjectPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    return typeof record.ref === 'string' && record.ref.length > 0
+        ? { ref: record.ref }
+        : null;
+}
+export function validateGraphPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    const anchorRef = optionalString(record.anchorRef);
+    if (anchorRef === null)
+        return null;
+    if (record.depth !== undefined && typeof record.depth !== 'number')
+        return null;
+    const payload = {};
+    if (anchorRef !== undefined)
+        payload.anchorRef = anchorRef;
+    if (record.depth !== undefined)
+        payload.depth = record.depth;
+    return payload;
+}
+export function validateWebPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    return typeof record.href === 'string' && record.href.startsWith('/')
+        ? { href: record.href }
+        : null;
+}
+const VISTA_FORM_REF_PATTERN = /^[A-Za-z0-9_-]{1,256}$/;
+export function isValidVistaFormRef(value) {
+    return typeof value === 'string' && VISTA_FORM_REF_PATTERN.test(value);
+}
+export function validateFormPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (!isValidVistaFormRef(record.ref)) {
+        return null;
+    }
+    if (typeof record.purpose !== 'string')
+        return null;
+    if ('submitUrl' in record || 'statusUrl' in record)
+        return null;
+    const fields = validateCaptureFields(record.fields);
+    if (fields === null)
+        return null;
+    const heading = optionalString(record.heading);
+    if (heading === null)
+        return null;
+    const submitLabel = optionalString(record.submitLabel);
+    if (submitLabel === null)
+        return null;
+    let launch;
+    if (record.launch !== undefined) {
+        const raw_ = asRecord(record.launch);
+        if (raw_ === null)
+            return null;
+        if ('url' in raw_)
+            return null;
+        if (typeof raw_.path !== 'string' ||
+            !raw_.path.startsWith('/') ||
+            raw_.path.startsWith('//') ||
+            raw_.path.includes('\\')) {
+            return null;
+        }
+        if (typeof raw_.label !== 'string' || raw_.label.length === 0)
+            return null;
+        const hint = optionalString(raw_.hint);
+        if (hint === null)
+            return null;
+        launch =
+            hint === undefined
+                ? { path: raw_.path, label: raw_.label }
+                : { path: raw_.path, label: raw_.label, hint };
+    }
+    const payload = { ref: record.ref, purpose: record.purpose, fields };
+    if (heading !== undefined)
+        payload.heading = heading;
+    if (submitLabel !== undefined)
+        payload.submitLabel = submitLabel;
+    if (launch !== undefined)
+        payload.launch = launch;
+    return payload;
+}
+export function validateAppPayload(raw) {
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    if (typeof record.appId !== 'string' || record.appId.length === 0)
+        return null;
+    const path = optionalString(record.path);
+    if (path === null)
+        return null;
+    return path === undefined
+        ? { appId: record.appId }
+        : { appId: record.appId, path };
+}
+//# sourceMappingURL=vista-payloads.js.map

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

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

package/dist/vista/vista-tabs-manifest.d.ts

@@ -0,0 +1,17 @@
+import { SurfaceKind } from '@xemahq/kernel-contracts/surface';
+export declare const DECLARABLE_SURFACE_KINDS: readonly SurfaceKind[];
+export interface VistaTabSpec {
+    readonly path: string;
+    readonly kind: SurfaceKind;
+    readonly label?: string;
+}
+export interface VistaTabsManifest {
+    readonly version: 1;
+    readonly tabs: readonly VistaTabSpec[];
+    readonly selectedPath?: string;
+}
+export interface VistaTabsManifestOptions {
+    readonly pathPrefix: string;
+}
+export declare function parseVistaTabsManifest(raw: string, { pathPrefix }: VistaTabsManifestOptions): VistaTabsManifest | null;
+//# sourceMappingURL=vista-tabs-manifest.d.ts.map

package/dist/vista/vista-tabs-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vista-tabs-manifest.d.ts","sourceRoot":"","sources":["../../src/vista/vista-tabs-manifest.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAU/D,eAAO,MAAM,wBAAwB,EAAE,SAAS,WAAW,EAS1D,CAAC;AAGF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAEvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAGD,MAAM,WAAW,wBAAwB;IAKvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AA8BD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,EAAE,UAAU,EAAE,EAAE,wBAAwB,GACvC,iBAAiB,GAAG,IAAI,CAsB1B"}

package/dist/vista/vista-tabs-manifest.js

@@ -0,0 +1,60 @@
+import { SurfaceKind } from '@xemahq/kernel-contracts/surface';
+import { surfaceKindForPath } from './vista-model';
+export const DECLARABLE_SURFACE_KINDS = [
+    SurfaceKind.Html,
+    SurfaceKind.Markdown,
+    SurfaceKind.Code,
+    SurfaceKind.Json,
+    SurfaceKind.Diff,
+    SurfaceKind.Pdf,
+    SurfaceKind.Image,
+    SurfaceKind.Media,
+];
+function parseEntry(entry, pathPrefix) {
+    if (!entry || typeof entry !== 'object')
+        return null;
+    const record = entry;
+    if (typeof record.path !== 'string')
+        return null;
+    if (!record.path.startsWith(pathPrefix))
+        return null;
+    if (record.path.includes('..'))
+        return null;
+    const kind = typeof record.kind === 'string'
+        ? record.kind
+        : surfaceKindForPath(record.path);
+    if (!DECLARABLE_SURFACE_KINDS.includes(kind))
+        return null;
+    const label = typeof record.label === 'string' ? record.label : undefined;
+    return label === undefined
+        ? { path: record.path, kind }
+        : { path: record.path, kind, label };
+}
+export function parseVistaTabsManifest(raw, { pathPrefix }) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const record = parsed;
+    if (record.version !== 1)
+        return null;
+    if (!Array.isArray(record.tabs))
+        return null;
+    const tabs = [];
+    for (const entry of record.tabs) {
+        const tab = parseEntry(entry, pathPrefix);
+        if (tab === null)
+            return null;
+        tabs.push(tab);
+    }
+    const selectedPath = typeof record.selectedPath === 'string' ? record.selectedPath : undefined;
+    return selectedPath === undefined
+        ? { version: 1, tabs }
+        : { version: 1, tabs, selectedPath };
+}
+//# sourceMappingURL=vista-tabs-manifest.js.map

package/dist/vista/vista-tabs-manifest.js.map

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

package/dist/vista/vista-tools.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { VistaTabsController } from './use-vista-tabs';
+export declare enum VistaToolName {
+    Open = "vista_open",
+    Update = "vista_update",
+    Close = "vista_close",
+    List = "vista_list"
+}
+export declare const VistaOpenArgsSchema: z.ZodType<import("@xemahq/kernel-contracts/surface").VistaSurface, unknown, z.core.$ZodTypeInternals<import("@xemahq/kernel-contracts/surface").VistaSurface, unknown>>;
+export type VistaOpenArgs = z.infer<typeof VistaOpenArgsSchema>;
+export declare const VistaUpdateArgsSchema: z.ZodObject<{
+    tabId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type VistaUpdateArgs = z.infer<typeof VistaUpdateArgsSchema>;
+export declare const VistaCloseArgsSchema: z.ZodObject<{
+    tabId: z.ZodString;
+}, z.core.$strip>;
+export type VistaCloseArgs = z.infer<typeof VistaCloseArgsSchema>;
+export declare const VistaListArgsSchema: z.ZodObject<{}, z.core.$strip>;
+export type VistaListArgs = z.infer<typeof VistaListArgsSchema>;
+export declare enum VistaToolError {
+    NoPanel = "no-panel",
+    InvalidArgs = "invalid-args",
+    UnknownTool = "unknown-tool",
+    UnknownTab = "unknown-tab",
+    TabRefused = "tab-refused"
+}
+export type VistaToolResult<TValue = unknown> = {
+    readonly ok: true;
+    readonly value: TValue;
+} | {
+    readonly ok: false;
+    readonly error: VistaToolError;
+    readonly detail?: string;
+};
+export declare const VistaToolResultSchema: z.ZodType<VistaToolResult>;
+export declare function dispatchVistaTool(controller: VistaTabsController | null, tool: string, args: unknown): VistaToolResult;
+//# sourceMappingURL=vista-tools.d.ts.map

package/dist/vista/vista-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vista-tools.d.ts","sourceRoot":"","sources":["../../src/vista/vista-tools.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAqB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,oBAAY,aAAa;IACvB,IAAI,eAAe;IACnB,MAAM,iBAAiB;IACvB,KAAK,gBAAgB;IACrB,IAAI,eAAe;CACpB;AAUD,eAAO,MAAM,mBAAmB,yKAAqB,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAWhE,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,eAAO,MAAM,oBAAoB;;iBAAyC,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,eAAO,MAAM,mBAAmB,gCAAe,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,oBAAY,cAAc;IAExB,OAAO,aAAa;IAEpB,WAAW,iBAAiB;IAE5B,WAAW,iBAAiB;IAE5B,UAAU,gBAAgB;IAM1B,UAAU,gBAAgB;CAC3B;AAGD,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,OAAO,IACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAQN,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAO3D,CAAC;AAWH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,mBAAmB,GAAG,IAAI,EACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,eAAe,CAsDjB"}

package/dist/vista/vista-tools.js

@@ -0,0 +1,113 @@
+import { VistaSurfaceSchema } from '@xemahq/kernel-contracts/surface';
+import { z } from 'zod';
+export var VistaToolName;
+(function (VistaToolName) {
+    VistaToolName["Open"] = "vista_open";
+    VistaToolName["Update"] = "vista_update";
+    VistaToolName["Close"] = "vista_close";
+    VistaToolName["List"] = "vista_list";
+})(VistaToolName || (VistaToolName = {}));
+export const VistaOpenArgsSchema = VistaSurfaceSchema;
+export const VistaUpdateArgsSchema = z.object({
+    tabId: z.string().min(1),
+    title: z.string().min(1).optional(),
+    payload: z.unknown().optional(),
+    pinned: z.boolean().optional(),
+});
+export const VistaCloseArgsSchema = z.object({ tabId: z.string().min(1) });
+export const VistaListArgsSchema = z.object({});
+export var VistaToolError;
+(function (VistaToolError) {
+    VistaToolError["NoPanel"] = "no-panel";
+    VistaToolError["InvalidArgs"] = "invalid-args";
+    VistaToolError["UnknownTool"] = "unknown-tool";
+    VistaToolError["UnknownTab"] = "unknown-tab";
+    VistaToolError["TabRefused"] = "tab-refused";
+})(VistaToolError || (VistaToolError = {}));
+export const VistaToolResultSchema = z.union([
+    z.object({ ok: z.literal(true), value: z.unknown() }),
+    z.object({
+        ok: z.literal(false),
+        error: z.nativeEnum(VistaToolError),
+        detail: z.string().optional(),
+    }),
+]);
+export function dispatchVistaTool(controller, tool, args) {
+    if (controller === null) {
+        return { ok: false, error: VistaToolError.NoPanel };
+    }
+    switch (tool) {
+        case VistaToolName.Open: {
+            const parsed = VistaOpenArgsSchema.safeParse(args);
+            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)
+                return invalid(parsed.error);
+            const { tabId, ...patch } = parsed.data;
+            const refusal = refusalFor(controller, tabId);
+            if (refusal !== null)
+                return refusal;
+            if (!controller.update(tabId, patch)) {
+                return {
+                    ok: false,
+                    error: VistaToolError.TabRefused,
+                    detail: `Tab "${tabId}" is host-owned; its content is driven by the host, not by vista_update.`,
+                };
+            }
+            return { ok: true, value: { updated: true } };
+        }
+        case VistaToolName.Close: {
+            const parsed = VistaCloseArgsSchema.safeParse(args);
+            if (!parsed.success)
+                return invalid(parsed.error);
+            const { tabId } = parsed.data;
+            const refusal = refusalFor(controller, tabId);
+            if (refusal !== null)
+                return refusal;
+            if (!controller.close(tabId)) {
+                return {
+                    ok: false,
+                    error: VistaToolError.TabRefused,
+                    detail: `Tab "${tabId}" is pinned and cannot be closed.`,
+                };
+            }
+            return { ok: true, value: { closed: true } };
+        }
+        case VistaToolName.List: {
+            const parsed = VistaListArgsSchema.safeParse(args ?? {});
+            if (!parsed.success)
+                return invalid(parsed.error);
+            return { ok: true, value: { tabs: controller.list() } };
+        }
+        default:
+            return {
+                ok: false,
+                error: VistaToolError.UnknownTool,
+                detail: `'${tool}' is not a Vista tool.`,
+            };
+    }
+}
+function refusalFor(controller, tabId) {
+    if (controller.list().some((tab) => tab.tabId === tabId)) {
+        return null;
+    }
+    return {
+        ok: false,
+        error: VistaToolError.UnknownTab,
+        detail: `No tab "${tabId}" is open.`,
+    };
+}
+function invalid(error) {
+    return {
+        ok: false,
+        error: VistaToolError.InvalidArgs,
+        detail: error.issues
+            .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)
+            .join('; '),
+    };
+}
+//# sourceMappingURL=vista-tools.js.map

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

@@ -0,0 +1 @@
+{"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.9.0",
+  "version": "0.9.2",
   "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.",
@@ -51,7 +51,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.3",
+    "@xemahq/registry": "^0.1.4",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.462.0",
@@ -63,7 +63,7 @@
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
     "react": "^18.3.1",
-    "@xemahq/kernel-contracts": ">=0.13.0"
+    "@xemahq/kernel-contracts": ">=0.55.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query": {
@@ -77,7 +77,7 @@
     "prettier": "3.6.2",
     "react": "^18.3.1",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.48.0"
+    "@xemahq/kernel-contracts": "^0.59.0"
   },
   "exports": {
     ".": {

package/src/index.ts

@@ -2,6 +2,11 @@ export * from './lib/system-bus';
 export * from './lib/biome-host';
 export * from './lib/capabilities';
 
+// The shared closed-first-party + open-biome contribution registry core (and
+// its versioned/validated renderable flavour). Every plane that lets a biome
+// contribute into a set the platform also ships builtins for is built on this.
+export * from './lib/contribution-registry';
+
 // Guided-capture UX kit (B5). Also available at the `@xemahq/ui-kernel/ui`
 // subpath alongside the rest of the shared UI surface; re-exported here so the
 // capture primitives are reachable from the package root too.

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

@@ -44,7 +44,10 @@ export function lazyRoute(
   fallback: ReactNode = null,
 ): () => ReactNode {
   const Lazy = lazy(importFn);
-  return () => createElement(Suspense, { fallback }, createElement(Lazy));
+  const LazyRoute = () =>
+    createElement(Suspense, { fallback }, createElement(Lazy));
+  LazyRoute.displayName = 'LazyRoute';
+  return LazyRoute;
 }
 
 export interface SinglePageBiomeRoute {