@xemahq/ui-kernel 0.1.4

package/dist/registry/lib/session-selectors.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSessionSlashCommands = useSessionSlashCommands;
+exports.useSessionDrawerTabs = useSessionDrawerTabs;
+exports.useActivityRenderer = useActivityRenderer;
+exports.useToolCallRenderer = useToolCallRenderer;
+exports.useSessionMutationBars = useSessionMutationBars;
+exports.useSessionHeaderChips = useSessionHeaderChips;
+exports.useSessionAttachmentClasses = useSessionAttachmentClasses;
+const react_1 = require("react");
+const index_1 = require("../../index");
+function sortByWeight(items) {
+    return [...items].sort((a, b) => {
+        const aw = a.weight ?? a.order ?? 100;
+        const bw = b.weight ?? b.order ?? 100;
+        if (aw !== bw)
+            return aw - bw;
+        return a.id.localeCompare(b.id);
+    });
+}
+function applies(item, args) {
+    const predicate = item.appliesTo;
+    return predicate == null ? true : predicate(...args);
+}
+function useSessionSlashCommands(session) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const out = [];
+        for (const biome of index_1.biomeRegistry.list()) {
+            for (const cmd of biome.session?.slashCommands ?? []) {
+                if (!applies(cmd, [session]))
+                    continue;
+                out.push(cmd);
+            }
+        }
+        return Object.freeze(sortByWeight(out));
+    }, [revision, session]);
+}
+function useSessionDrawerTabs(session) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const out = [];
+        for (const biome of index_1.biomeRegistry.list()) {
+            for (const tab of biome.session?.secondaryDrawerTabs ?? []) {
+                if (!applies(tab, [session]))
+                    continue;
+                out.push(tab);
+            }
+        }
+        return Object.freeze(sortByWeight(out));
+    }, [revision, session]);
+}
+function useActivityRenderer(session, event) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const candidates = [];
+        for (const biome of index_1.biomeRegistry.list()) {
+            for (const r of biome.session?.activityRenderers ?? []) {
+                if (r.entryKind !== event.kind)
+                    continue;
+                if (!applies(r, [{ session, event }]))
+                    continue;
+                candidates.push(r);
+            }
+        }
+        if (candidates.length === 0)
+            return null;
+        return sortByWeight(candidates)[0] ?? null;
+    }, [revision, session, event]);
+}
+function matchToolName(toolName, eventName) {
+    if (toolName === eventName)
+        return 'exact';
+    if (toolName.endsWith('.*') && eventName.startsWith(toolName.slice(0, -1)))
+        return 'glob';
+    return 'none';
+}
+function collectToolCallCandidates(session, event) {
+    const exact = [];
+    const glob = [];
+    for (const biome of index_1.biomeRegistry.list()) {
+        for (const r of biome.session?.toolCallRenderers ?? []) {
+            const match = matchToolName(r.toolName, event.name);
+            if (match === 'none')
+                continue;
+            if (!applies(r, [{ session, event }]))
+                continue;
+            if (match === 'exact')
+                exact.push(r);
+            else
+                glob.push(r);
+        }
+    }
+    return { exact, glob };
+}
+function useToolCallRenderer(session, event) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const { exact, glob } = collectToolCallCandidates(session, event);
+        if (exact.length > 0)
+            return sortByWeight(exact)[0] ?? null;
+        if (glob.length > 0)
+            return sortByWeight(glob)[0] ?? null;
+        return null;
+    }, [revision, session, event]);
+}
+function useSessionMutationBars(session) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const out = [];
+        for (const biome of index_1.biomeRegistry.list()) {
+            for (const bar of biome.session?.mutationBars ?? []) {
+                if (!applies(bar, [session]))
+                    continue;
+                out.push(bar);
+            }
+        }
+        return Object.freeze(sortByWeight(out));
+    }, [revision, session]);
+}
+function useSessionHeaderChips(session) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const out = [];
+        for (const biome of index_1.biomeRegistry.list()) {
+            for (const chip of biome.session?.headerChips ?? []) {
+                if (!applies(chip, [session]))
+                    continue;
+                out.push(chip);
+            }
+        }
+        return Object.freeze(sortByWeight(out));
+    }, [revision, session]);
+}
+function useSessionAttachmentClasses(session) {
+    const revision = (0, index_1.useBiomeRegistryRevision)();
+    return (0, react_1.useMemo)(() => {
+        const out = [];
+        for (const biome of index_1.biomeRegistry.list()) {
+            for (const cls of biome.session?.attachmentClasses ?? []) {
+                if (!applies(cls, [session]))
+                    continue;
+                out.push(cls);
+            }
+        }
+        return Object.freeze(sortByWeight(out));
+    }, [revision, session]);
+}
+//# sourceMappingURL=session-selectors.js.map

package/dist/registry/lib/session-selectors.js.map

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

package/dist/session/comments/CommentRail.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+export interface RailComment {
+    readonly id: string;
+    readonly body: string;
+    readonly quotedText?: string;
+    readonly resolved: boolean;
+    readonly authorLabel?: string;
+}
+export declare function CommentRail({ comments, title, emptyHint, composerSlot, headerSlot, onResolve, resolvingId, renderResolveIcon, renderResolvedIcon, }: {
+    readonly comments: readonly RailComment[];
+    readonly title?: string;
+    readonly emptyHint?: ReactNode;
+    readonly composerSlot?: ReactNode;
+    readonly headerSlot?: ReactNode;
+    readonly onResolve?: (id: string) => void;
+    readonly resolvingId?: string | null;
+    readonly renderResolveIcon?: (busy: boolean) => ReactNode;
+    readonly renderResolvedIcon?: () => ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=CommentRail.d.ts.map

package/dist/session/comments/CommentRail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentRail.d.ts","sourceRoot":"","sources":["../../../src/session/comments/CommentRail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAiBD,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,KAAkB,EAClB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,EAAE;IACD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,SAAS,CAAC;CAC/C,+BAmDA"}

package/dist/session/comments/CommentRail.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommentRail = CommentRail;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cn_1 = require("../lib/cn");
+function CommentRail({ comments, title = 'Comments', emptyHint, composerSlot, headerSlot, onResolve, resolvingId, renderResolveIcon, renderResolvedIcon, }) {
+    const open = comments.filter((c) => !c.resolved);
+    const resolved = comments.filter((c) => c.resolved);
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "flex h-full min-h-0 flex-col gap-2 bg-paper p-3 text-[12px]", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2", children: [(0, jsx_runtime_1.jsx)("span", { className: "font-medium text-ink", children: title }), open.length > 0 && ((0, jsx_runtime_1.jsx)("span", { className: "rounded-full bg-ink/10 px-2 py-0.5 text-[11px] text-ink-2", children: open.length })), headerSlot] }), composerSlot, comments.length === 0 && !composerSlot && emptyHint && ((0, jsx_runtime_1.jsx)("div", { className: "text-ink-3", children: emptyHint })), (0, jsx_runtime_1.jsxs)("div", { className: "flex min-h-0 flex-1 flex-col gap-2 overflow-auto pr-1", children: [open.map((comment) => ((0, jsx_runtime_1.jsx)(CommentRow, { comment: comment, onResolve: onResolve, busy: resolvingId === comment.id, renderResolveIcon: renderResolveIcon, renderResolvedIcon: renderResolvedIcon }, comment.id))), resolved.length > 0 && ((0, jsx_runtime_1.jsx)("div", { className: "mt-1 text-[11px] uppercase tracking-wide text-ink-3", children: "Resolved" })), resolved.map((comment) => ((0, jsx_runtime_1.jsx)(CommentRow, { comment: comment, onResolve: onResolve, busy: resolvingId === comment.id, renderResolveIcon: renderResolveIcon, renderResolvedIcon: renderResolvedIcon }, comment.id)))] })] }));
+}
+function CommentRow({ comment, onResolve, busy, renderResolveIcon, renderResolvedIcon, }) {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, cn_1.cn)('rounded-md border p-2', comment.resolved
+            ? 'border-rule/60 bg-paper-elev/30 opacity-70'
+            : 'border-rule/70 bg-paper-elev/40'), children: [comment.quotedText && ((0, jsx_runtime_1.jsxs)("div", { className: "mb-1 border-l-2 border-[hsl(var(--comment-anchor))] pl-2 text-[11px] italic text-ink-3", children: ["\u201C", comment.quotedText.slice(0, 120), comment.quotedText.length > 120 ? '…' : '', "\u201D"] })), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-start justify-between gap-2", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-0.5", children: [comment.authorLabel && ((0, jsx_runtime_1.jsx)("span", { className: "text-[11px] font-medium text-ink-2", children: comment.authorLabel })), (0, jsx_runtime_1.jsx)("span", { className: "whitespace-pre-wrap text-ink", children: comment.body })] }), !comment.resolved && onResolve && ((0, jsx_runtime_1.jsx)("button", { type: "button", title: "Resolve", disabled: busy, onClick: () => onResolve(comment.id), className: "flex h-6 w-6 shrink-0 items-center justify-center rounded text-ink-3 hover:bg-ink/5 hover:text-ink disabled:opacity-50", children: renderResolveIcon ? renderResolveIcon(busy) : busy ? '…' : '✓' })), comment.resolved && renderResolvedIcon && ((0, jsx_runtime_1.jsx)("span", { className: "shrink-0 text-ink-3", children: renderResolvedIcon() }))] })] }));
+}
+//# sourceMappingURL=CommentRail.js.map

package/dist/session/comments/CommentRail.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,4 @@
+export { cn } from './lib/cn';
+export { SessionWorkspaceShell } from './shell/SessionWorkspaceShell';
+export { CommentRail, type RailComment } from './comments/CommentRail';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommentRail = exports.SessionWorkspaceShell = exports.cn = void 0;
+var cn_1 = require("./lib/cn");
+Object.defineProperty(exports, "cn", { enumerable: true, get: function () { return cn_1.cn; } });
+var SessionWorkspaceShell_1 = require("./shell/SessionWorkspaceShell");
+Object.defineProperty(exports, "SessionWorkspaceShell", { enumerable: true, get: function () { return SessionWorkspaceShell_1.SessionWorkspaceShell; } });
+var CommentRail_1 = require("./comments/CommentRail");
+Object.defineProperty(exports, "CommentRail", { enumerable: true, get: function () { return CommentRail_1.CommentRail; } });
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":";;;AAAA,+BAA8B;AAArB,wFAAA,EAAE,OAAA;AACX,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAC9B,sDAAuE;AAA9D,0GAAA,WAAW,OAAA"}

package/dist/session/lib/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/session/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../../src/session/lib/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAQ7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/session/lib/cn.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cn = cn;
+const clsx_1 = require("clsx");
+const tailwind_merge_1 = require("tailwind-merge");
+function cn(...inputs) {
+    return (0, tailwind_merge_1.twMerge)((0, clsx_1.clsx)(inputs));
+}
+//# sourceMappingURL=cn.js.map

package/dist/session/lib/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../../src/session/lib/cn.ts"],"names":[],"mappings":";;AAQA,gBAEC;AAVD,+BAA6C;AAC7C,mDAAyC;AAOzC,SAAgB,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,IAAA,wBAAO,EAAC,IAAA,WAAI,EAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/session/shell/SessionWorkspaceShell.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode, MouseEvent, RefObject } from 'react';
+interface SessionWorkspaceShellProps {
+    readonly splitContainerRef: RefObject<HTMLDivElement>;
+    readonly chatPanePercent: number;
+    readonly isResizing: boolean;
+    readonly startResize: (event: MouseEvent<HTMLElement>) => void;
+    readonly chatSlot: ReactNode;
+    readonly previewSlot: ReactNode;
+    readonly rightHeaderSlot?: ReactNode;
+    readonly chatFooterSlot?: ReactNode;
+    readonly previewFullscreen?: boolean;
+    readonly minLeftPaneWidth?: number;
+}
+export declare function SessionWorkspaceShell({ splitContainerRef, chatPanePercent, isResizing, startResize, chatSlot, previewSlot, rightHeaderSlot, chatFooterSlot, previewFullscreen, minLeftPaneWidth, }: SessionWorkspaceShellProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=SessionWorkspaceShell.d.ts.map

package/dist/session/shell/SessionWorkspaceShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionWorkspaceShell.d.ts","sourceRoot":"","sources":["../../../src/session/shell/SessionWorkspaceShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAI9D,UAAU,0BAA0B;IAKlC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAEtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAG/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAQ7B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAMhC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC;IAMrC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC;IAMpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAGrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAiBD,wBAAgB,qBAAqB,CAAC,EACpC,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAyB,EACzB,gBAAsB,GACvB,EAAE,0BAA0B,+BAgE5B"}

package/dist/session/shell/SessionWorkspaceShell.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionWorkspaceShell = SessionWorkspaceShell;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cn_1 = require("../lib/cn");
+function SessionWorkspaceShell({ splitContainerRef, chatPanePercent, isResizing, startResize, chatSlot, previewSlot, rightHeaderSlot, chatFooterSlot, previewFullscreen = false, minLeftPaneWidth = 320, }) {
+    const hasPreviewSlot = previewSlot !== null;
+    return ((0, jsx_runtime_1.jsxs)("div", { ref: splitContainerRef, className: (0, cn_1.cn)('relative flex h-full w-full overflow-hidden', isResizing && 'cursor-col-resize'), children: [!previewFullscreen && ((0, jsx_runtime_1.jsx)("div", { className: (0, cn_1.cn)('flex h-full w-full flex-col overflow-hidden bg-paper', hasPreviewSlot ? 'lg:flex-none' : ''), style: hasPreviewSlot
+                    ? {
+                        minWidth: `${minLeftPaneWidth}px`,
+                        width: `${chatPanePercent}%`,
+                    }
+                    : undefined, children: (0, jsx_runtime_1.jsxs)("div", { className: "flex min-h-0 flex-1 flex-col overflow-hidden", children: [(0, jsx_runtime_1.jsx)("div", { className: "relative min-h-0 flex-1", children: chatSlot }), chatFooterSlot] }) })), !previewFullscreen && hasPreviewSlot && ((0, jsx_runtime_1.jsx)("div", { className: "relative hidden w-px shrink-0 bg-rule/30 lg:block", children: (0, jsx_runtime_1.jsx)("button", { type: "button", onMouseDown: startResize, "aria-label": "Resize chat and preview panels", title: "Drag to resize", className: "group absolute inset-y-0 left-1/2 w-2 -translate-x-1/2 cursor-col-resize", children: (0, jsx_runtime_1.jsx)("span", { "aria-hidden": true, className: "absolute inset-y-0 left-1/2 w-px -translate-x-1/2 bg-transparent transition-colors group-hover:bg-primary/40" }) }) })), hasPreviewSlot && ((0, jsx_runtime_1.jsxs)("div", { className: "flex min-w-0 flex-1 flex-col overflow-hidden bg-paper", children: [rightHeaderSlot, (0, jsx_runtime_1.jsx)("div", { className: "min-h-0 flex-1 overflow-hidden", children: previewSlot })] }))] }));
+}
+//# sourceMappingURL=SessionWorkspaceShell.js.map

package/dist/session/shell/SessionWorkspaceShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionWorkspaceShell.js","sourceRoot":"","sources":["../../../src/session/shell/SessionWorkspaceShell.tsx"],"names":[],"mappings":";;AAiEA,sDA2EC;;AA1ID,kCAA+B;AA+D/B,SAAgB,qBAAqB,CAAC,EACpC,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,GAAG,KAAK,EACzB,gBAAgB,GAAG,GAAG,GACK;IAI3B,MAAM,cAAc,GAAG,WAAW,KAAK,IAAI,CAAC;IAC5C,OAAO,CACL,iCACE,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,IAAA,OAAE,EACX,6CAA6C,EAC7C,UAAU,IAAI,mBAAmB,CAClC,aAEA,CAAC,iBAAiB,IAAI,CACrB,gCACE,SAAS,EAAE,IAAA,OAAE,EACX,sDAAsD,EACtD,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CACrC,EACD,KAAK,EACH,cAAc;oBACZ,CAAC,CAAC;wBACE,QAAQ,EAAE,GAAG,gBAAgB,IAAI;wBACjC,KAAK,EAAE,GAAG,eAAe,GAAG;qBAC7B;oBACH,CAAC,CAAC,SAAS,YAGf,iCAAK,SAAS,EAAC,8CAA8C,aAC3D,gCAAK,SAAS,EAAC,yBAAyB,YAAE,QAAQ,GAAO,EACxD,cAAc,IACX,GACF,CACP,EAEA,CAAC,iBAAiB,IAAI,cAAc,IAAI,CACvC,gCAAK,SAAS,EAAC,mDAAmD,YAKhE,mCACE,IAAI,EAAC,QAAQ,EACb,WAAW,EAAE,WAAW,gBACb,gCAAgC,EAC3C,KAAK,EAAC,gBAAgB,EACtB,SAAS,EAAC,0EAA0E,YAEpF,sDAEE,SAAS,EAAC,8GAA8G,GACxH,GACK,GACL,CACP,EAEA,cAAc,IAAI,CACjB,iCAAK,SAAS,EAAC,uDAAuD,aACnE,eAAe,EAChB,gCAAK,SAAS,EAAC,gCAAgC,YAAE,WAAW,GAAO,IAC/D,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@xemahq/ui-kernel",
+  "version": "0.1.4",
+  "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.",
+  "keywords": [
+    "xema",
+    "xema-platform",
+    "xema-ui-kernel",
+    "system-bus",
+    "biome",
+    "capability",
+    "deeplink",
+    "intents"
+  ],
+  "homepage": "https://docs.xema.dev/biomes",
+  "bugs": {
+    "url": "https://github.com/xema-dev/xema-monorepo/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-monorepo.git",
+    "directory": "packages/ui/xema-ui-kernel"
+  },
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@xemahq/kernel-contracts": "^0.2.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.5.4",
+    "@xemahq/registry": "0.1.1"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^18.3.1"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.100.13",
+    "@types/node": "25.2.3",
+    "@types/react": "^18.3.30",
+    "prettier": "3.6.2",
+    "react": "^18.3.1",
+    "typescript": "5.9.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*/index.d.ts",
+      "xema-source": "./src/*/index.ts",
+      "default": "./dist/*/index.js"
+    },
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "lint": "tsc -p tsconfig.lint.json --noEmit",
+    "typecheck": "tsc -p tsconfig.lint.json --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './lib/system-bus';
+export * from './lib/biome-host';

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

@@ -0,0 +1,6 @@
+/**
+ * Master switch for the biome subsystem. A host passes `'disabled'` to opt
+ * the whole biome runtime out (no biomes load / register) — e.g. for a
+ * minimal shell or a degraded mode. Framework-agnostic.
+ */
+export type BiomesMode = 'enabled' | 'disabled';

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

@@ -0,0 +1,245 @@
+import { Registry } from '@xemahq/registry';
+import { useSyncExternalStore } from 'react';
+
+import type {
+  FrontendBiome,
+  FrontendBiomeFactory,
+  OutputRendererContribution,
+  PanelContribution,
+} from './frontend-biome';
+import type { HostBridge } from './host-bridge';
+
+/**
+ * Singleton frontend biome registry. Populated at app bootstrap by
+ * `registerFrontendBiome()` (factory form) or `registerFrontendBiomeInstance()`
+ * (already-built form). Bootstrap order: fetch enabled biome ids from
+ * `GET /platform/biomes/web`, dynamically `import()` each biome module
+ * from the auto-generated loader map (`xema:web-biome-loaders`), then
+ * call its default export with the host's concrete `HostBridge` and
+ * register the result.
+ *
+ * Reactivity: components consume registry data via `useBiomeRegistryRevision()`
+ * (or `<BiomeSlot>` / `useBiomeRoutes()` which use it internally) so a
+ * re-render fires automatically when a biome registers or unregisters —
+ * no race between Sidebar mount and async bootstrap, no manual subscription
+ * wiring per consumer.
+ *
+ * Master-disable: hosts that embed `@xemahq/ui-kernel` without
+ * participating in Xema's biome ecosystem flip
+ * `biomeRegistry.setEnabled(false)` (typically via
+ * `<BiomeHostProvider biomes="disabled">`). When disabled, every
+ * register/unregister/bootstrap call is a no-op — a single flag controls
+ * the entire surface.
+ */
+class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: string }> {
+  private revisionCount = 0;
+  private readonly listeners = new Set<() => void>();
+  /**
+   * Biome ids whose `init()` callback has been invoked. Tracked
+   * separately from the registry entries so `init()` runs exactly once
+   * per biome per SPA session even if `registerBiome` is called
+   * multiple times (HMR, strict-mode double-mount, retries). Biome
+   * authors get an at-most-once execution guarantee.
+   */
+  private readonly initialized = new Set<string>();
+  private enabled = true;
+
+  constructor() {
+    super({ name: 'FrontendBiomeRegistry' });
+  }
+
+  registerBiome(biome: FrontendBiome): void {
+    if (!this.enabled) return;
+    this.register({ ...biome, key: biome.id });
+    this.revisionCount += 1;
+    this.notify();
+  }
+
+  /**
+   * Invoke a biome's `init()` callback exactly once per SPA session.
+   * The caller (bootstrap) is responsible for catching/logging promise
+   * rejections — the registry intentionally does not swallow them.
+   */
+  async runInit(biomeId: string, bridge: HostBridge): Promise<void> {
+    const entry = this.get(biomeId);
+    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;
+    const entry = this.get(id);
+    const removed = this.unregister(id);
+    if (removed) {
+      this.revisionCount += 1;
+      this.initialized.delete(id);
+      if (entry?.dispose) {
+        // Fire-and-forget; teardown errors are logged by callers but
+        // never block the unregister path — disposal is best-effort
+        // because the biome is being torn down anyway.
+        void Promise.resolve(entry.dispose()).catch((error: unknown) => {
+          // Surface for devtools without crashing the unregister flow.
+          // eslint-disable-next-line no-console
+          console.error(`[xema-ui-kernel] dispose() failed for '${id}':`, error);
+        });
+      }
+      this.notify();
+    }
+    return removed;
+  }
+
+  /**
+   * Snapshot of currently-registered biome ids. Useful for the admin UI
+   * to detect "registered in this session" vs "enabled in catalog".
+   */
+  snapshot(): readonly string[] {
+    return this.list().map((b) => b.id);
+  }
+
+  setEnabled(enabled: boolean): void {
+    if (this.enabled === enabled) return;
+    this.enabled = enabled;
+    if (!enabled) {
+      // When master-disabling, drop any previously-registered biomes so
+      // BiomeSlot/useBiomeRoutes consumers re-render to empty.
+      const had = this.size() > 0;
+      this.clear();
+      this.initialized.clear();
+      if (had) {
+        this.revisionCount += 1;
+        this.notify();
+      }
+    }
+  }
+
+  isEnabled(): boolean {
+    return this.enabled;
+  }
+
+  revision(): number {
+    return this.revisionCount;
+  }
+
+  /**
+   * Subscribe to revision-counter changes. Returns an unsubscribe
+   * function. Used internally by `useBiomeRegistryRevision()` (via
+   * `useSyncExternalStore`) so components automatically re-render when
+   * a biome is added or removed.
+   */
+  subscribe(listener: () => void): () => void {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+
+  panelsForSlot(slot: string): readonly PanelContribution[] {
+    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);
+      }
+    }
+    return out.sort((a, b) => (a.weight ?? 100) - (b.weight ?? 100));
+  }
+
+  /**
+   * Flatten every registered biome's `outputRenderers[]` contributions
+   * into a `(outputKind → factory)` map. The host's renderer registry
+   * overlays this on top of the built-in set so biome-defined kinds
+   * light up the moment the biome's frontend loads. Duplicate kinds
+   * across biomes are surfaced as a console error and the first
+   * registration wins (deterministic + fail-loud, not silent).
+   */
+  outputRenderers(): ReadonlyMap<string, OutputRendererContribution> {
+    const out = new Map<string, OutputRendererContribution>();
+    if (!this.enabled) return out;
+    for (const biome of this.list()) {
+      for (const entry of biome.outputRenderers ?? []) {
+        if (out.has(entry.outputKind)) {
+          console.error(
+            `[xema-ui-kernel] duplicate outputRenderer for kind '${entry.outputKind}' ` +
+              `from biome '${biome.id}'; first registration wins.`,
+          );
+          continue;
+        }
+        out.set(entry.outputKind, entry);
+      }
+    }
+    return out;
+  }
+
+  private notify(): void {
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+}
+
+export const biomeRegistry = new FrontendBiomeRegistry();
+
+/**
+ * Register an already-built `FrontendBiome` instance. Prefer
+ * `registerFrontendBiome(factory, bridge)` for biomes shipped via
+ * the factory contract.
+ */
+export function registerFrontendBiomeInstance(biome: FrontendBiome): void {
+  biomeRegistry.registerBiome(biome);
+}
+
+/**
+ * Invoke a `FrontendBiomeFactory` with the host's `HostBridge` and
+ * register the resulting `FrontendBiome`. This is the standard
+ * registration path for biomes shipped as workspace packages.
+ *
+ * Fail-fast: a factory that returns a non-`FrontendBiome` value, or
+ * that produces a duplicate id, propagates the underlying registry
+ * error — no swallowing.
+ */
+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') {
+    throw new Error(
+      '[xema-ui-kernel] FrontendBiomeFactory returned a non-FrontendBiome value. ' +
+        'A biome module must default-export `(bridge) => FrontendBiome`.',
+    );
+  }
+  biomeRegistry.registerBiome(biome);
+}
+
+/**
+ * Unregister a biome by id. Triggered by the admin UI's runtime
+ * disable flow so BiomeSlot / useBiomeRoutes consumers reflow without
+ * a page reload. Returns `true` if a registration was removed.
+ */
+export function unregisterFrontendBiome(id: string): boolean {
+  return biomeRegistry.unregisterBiome(id);
+}
+
+/**
+ * React hook that subscribes the calling component to the biome
+ * registry's revision counter. Returns the current revision (a number
+ * that increments by 1 on every biome registration or unregistration).
+ * Use the return value as a `useMemo` dep when computing data derived
+ * from the registry — the memo recomputes on every change.
+ *
+ * Implemented with `useSyncExternalStore` so it integrates cleanly with
+ * React 18 concurrent rendering and SSR.
+ *
+ * `<BiomeSlot>` uses this hook internally so any host page that mounts
+ * a slot re-renders automatically when biomes arrive or leave.
+ */
+export function useBiomeRegistryRevision(): number {
+  return useSyncExternalStore(
+    (listener) => biomeRegistry.subscribe(listener),
+    () => biomeRegistry.revision(),
+    () => biomeRegistry.revision(),
+  );
+}