@xemahq/ui-kernel 0.2.0 → 0.4.0

package/dist/lib/biome-host/response-envelope.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapList = unwrapList;
+exports.unwrapData = unwrapData;
+function unwrapList(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value !== null &&
+        typeof value === 'object' &&
+        Array.isArray(value.data)) {
+        return value.data;
+    }
+    return [];
+}
+function unwrapData(value) {
+    if (value !== null &&
+        typeof value === 'object' &&
+        'data' in value &&
+        !('pagination' in value)) {
+        return value.data;
+    }
+    return value;
+}
+//# sourceMappingURL=response-envelope.js.map

package/dist/lib/biome-host/response-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-envelope.js","sourceRoot":"","sources":["../../../src/lib/biome-host/response-envelope.ts"],"names":[],"mappings":";;AA+BA,gCAYC;AAeD,gCAUC;AArCD,SAAgB,UAAU,CAAI,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAY,CAAC;IACtB,CAAC;IACD,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAE,KAA4B,CAAC,IAAI,CAAC,EACjD,CAAC;QACD,OAAQ,KAAuB,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAeD,SAAgB,UAAU,CAAI,KAAc;IAC1C,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAK,KAAiC;QAC5C,CAAC,CAAC,YAAY,IAAK,KAAiC,CAAC,EACrD,CAAC;QACD,OAAQ,KAAqB,CAAC,IAAI,CAAC;IACrC,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/registry/lib/composition-validation-host.d.ts

@@ -0,0 +1,3 @@
+import { type CompositionDiagnostic, type FrontendBiome } from '../../index';
+export declare function validateHostBiomeComposition(biomes: readonly FrontendBiome[]): readonly CompositionDiagnostic[];
+//# sourceMappingURL=composition-validation-host.d.ts.map

package/dist/registry/lib/composition-validation-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-validation-host.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/composition-validation-host.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAC;AAkBrB,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,SAAS,qBAAqB,EAAE,CAElC"}

package/dist/registry/lib/composition-validation-host.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateHostBiomeComposition = validateHostBiomeComposition;
+const index_1 = require("../../index");
+const extension_points_1 = require("./extension-points");
+const HOST_SLOT_IDS = new Set(Object.values(extension_points_1.HostExtensionSlots));
+function validateHostBiomeComposition(biomes) {
+    return (0, index_1.validateBiomeComposition)(biomes, { knownSlots: HOST_SLOT_IDS });
+}
+//# sourceMappingURL=composition-validation-host.js.map

package/dist/registry/lib/composition-validation-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-validation-host.js","sourceRoot":"","sources":["../../../src/registry/lib/composition-validation-host.ts"],"names":[],"mappings":";;AAgCA,oEAIC;AA1BD,uCAIqB;AAErB,yDAAwD;AAOxD,MAAM,aAAa,GAAwB,IAAI,GAAG,CAChD,MAAM,CAAC,MAAM,CAAC,qCAAkB,CAAC,CAClC,CAAC;AAOF,SAAgB,4BAA4B,CAC1C,MAAgC;IAEhC,OAAO,IAAA,gCAAwB,EAAC,MAAM,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;AACzE,CAAC"}

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

@@ -1 +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"}
+{"version":3,"file":"SessionWorkspaceShell.d.ts","sourceRoot":"","sources":["../../../src/session/shell/SessionWorkspaceShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAI7E,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,+BAsE5B"}

package/dist/session/shell/SessionWorkspaceShell.js

@@ -5,11 +5,14 @@ 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 min-w-0 flex-1 flex-col overflow-hidden", children: [(0, jsx_runtime_1.jsx)("div", { className: "relative min-h-0 min-w-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 })] }))] }));
+    const leftPaneStyle = hasPreviewSlot
+        ? {
+            '--sws-min-left': `${minLeftPaneWidth}px`,
+            '--sws-chat-pct': `${chatPanePercent}%`,
+        }
+        : undefined;
+    return ((0, jsx_runtime_1.jsxs)("div", { ref: splitContainerRef, className: (0, cn_1.cn)('relative flex h-full w-full flex-col overflow-hidden lg:flex-row', isResizing && 'cursor-col-resize'), children: [!previewFullscreen && ((0, jsx_runtime_1.jsx)("div", { className: (0, cn_1.cn)('flex w-full min-h-0 flex-col overflow-hidden bg-paper', hasPreviewSlot
+                    ? 'flex-1 lg:h-full lg:w-[var(--sws-chat-pct)] lg:min-w-[var(--sws-min-left)] lg:flex-none'
+                    : 'h-full'), style: leftPaneStyle, children: (0, jsx_runtime_1.jsxs)("div", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden", children: [(0, jsx_runtime_1.jsx)("div", { className: "relative min-h-0 min-w-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-h-0 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

@@ -1 +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,sDAAsD,aACnE,gCAAK,SAAS,EAAC,iCAAiC,YAAE,QAAQ,GAAO,EAChE,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"}
+{"version":3,"file":"SessionWorkspaceShell.js","sourceRoot":"","sources":["../../../src/session/shell/SessionWorkspaceShell.tsx"],"names":[],"mappings":";;AAiEA,sDAiFC;;AAhJD,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;IAM5C,MAAM,aAAa,GAA8B,cAAc;QAC7D,CAAC,CAAE;YACC,gBAAgB,EAAE,GAAG,gBAAgB,IAAI;YACzC,gBAAgB,EAAE,GAAG,eAAe,GAAG;SACtB;QACrB,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,CACL,iCACE,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,IAAA,OAAE,EACX,kEAAkE,EAClE,UAAU,IAAI,mBAAmB,CAClC,aAEA,CAAC,iBAAiB,IAAI,CACrB,gCACE,SAAS,EAAE,IAAA,OAAE,EACX,uDAAuD,EACvD,cAAc;oBACZ,CAAC,CAAC,yFAAyF;oBAC3F,CAAC,CAAC,QAAQ,CACb,EACD,KAAK,EAAE,aAAa,YAEpB,iCAAK,SAAS,EAAC,sDAAsD,aACnE,gCAAK,SAAS,EAAC,iCAAiC,YAAE,QAAQ,GAAO,EAChE,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,+DAA+D,aAC3E,eAAe,EAChB,gCAAK,SAAS,EAAC,gCAAgC,YAAE,WAAW,GAAO,IAC/D,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/chrome/ErrorCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorCard.d.ts","sourceRoot":"","sources":["../../../src/ui/chrome/ErrorCard.tsx"],"names":[],"mappings":"AAWA,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAYjF,UAAU,cAAc;IACtB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAMrB,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,KAAK,EACL,KAA8B,EAC9B,OAAO,EACP,WAAgC,EAChC,eAA0D,GAC3D,EAAE,cAAc,+BAyBhB"}
+{"version":3,"file":"ErrorCard.d.ts","sourceRoot":"","sources":["../../../src/ui/chrome/ErrorCard.tsx"],"names":[],"mappings":"AAaA,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAKjF,UAAU,cAAc;IACtB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAMrB,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,KAAK,EACL,KAA8B,EAC9B,OAAO,EACP,WAAgC,EAChC,eAA0D,GAC3D,EAAE,cAAc,+BAyBhB"}

package/dist/ui/chrome/ErrorCard.js

@@ -3,17 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ErrorCard;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const lucide_react_1 = require("lucide-react");
+const errors_1 = require("../../lib/biome-host/errors");
 const button_1 = require("../primitives/button");
 const card_1 = require("../primitives/card");
-const defaultFormatError = (error, fallback) => {
-    if (typeof error === 'string') {
-        return error || fallback;
-    }
-    if (error instanceof Error && error.message) {
-        return error.message;
-    }
-    return fallback;
-};
+const defaultFormatError = (error, fallback) => (0, errors_1.getUserFacingErrorMessage)(error, fallback);
 function ErrorCard({ error, title = 'Something went wrong', onRetry, formatError = defaultFormatError, fallbackMessage = 'Unable to load this content right now.', }) {
     const message = formatError(error, fallbackMessage);
     return ((0, jsx_runtime_1.jsx)(card_1.Card, { className: "border-destructive/25 bg-destructive/[0.03] rounded-xl", children: (0, jsx_runtime_1.jsxs)(card_1.CardContent, { className: "flex flex-col items-center py-14 text-center", children: [(0, jsx_runtime_1.jsx)("div", { className: "h-14 w-14 rounded-2xl bg-destructive/10 flex items-center justify-center mb-4", children: (0, jsx_runtime_1.jsx)(lucide_react_1.AlertCircle, { className: "h-6 w-6 text-destructive" }) }), (0, jsx_runtime_1.jsx)("p", { className: "text-subtitle font-semibold text-ink", children: title }), (0, jsx_runtime_1.jsx)("p", { className: "text-body-1 text-ink-3 mt-2 max-w-md leading-relaxed", children: message }), onRetry && ((0, jsx_runtime_1.jsxs)(button_1.Button, { size: "sm", variant: "outline", onClick: onRetry, className: "mt-5 gap-2 h-10 border-destructive/20 text-destructive hover:bg-destructive/5", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.RefreshCw, { className: "h-4 w-4" }), "Retry"] }))] }) }));

package/dist/ui/chrome/ErrorCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorCard.js","sourceRoot":"","sources":["../../../src/ui/chrome/ErrorCard.tsx"],"names":[],"mappings":";;AAoCA,4BA+BC;;AAnED,+CAAsD;AAEtD,iDAA8C;AAC9C,6CAAuD;AAUvD,MAAM,kBAAkB,GAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,IAAI,QAAQ,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAeF,SAAwB,SAAS,CAAC,EAChC,KAAK,EACL,KAAK,GAAG,sBAAsB,EAC9B,OAAO,EACP,WAAW,GAAG,kBAAkB,EAChC,eAAe,GAAG,wCAAwC,GAC3C;IACf,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAEpD,OAAO,CACL,uBAAC,WAAI,IAAC,SAAS,EAAC,wDAAwD,YACtE,wBAAC,kBAAW,IAAC,SAAS,EAAC,8CAA8C,aACnE,gCAAK,SAAS,EAAC,+EAA+E,YAC5F,uBAAC,0BAAW,IAAC,SAAS,EAAC,0BAA0B,GAAG,GAChD,EACN,8BAAG,SAAS,EAAC,sCAAsC,YAAE,KAAK,GAAK,EAC/D,8BAAG,SAAS,EAAC,sDAAsD,YAAE,OAAO,GAAK,EAChF,OAAO,IAAI,CACV,wBAAC,eAAM,IACL,IAAI,EAAC,IAAI,EACT,OAAO,EAAC,SAAS,EACjB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAC,+EAA+E,aAEzF,uBAAC,wBAAS,IAAC,SAAS,EAAC,SAAS,GAAG,aAE1B,CACV,IACW,GACT,CACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ErrorCard.js","sourceRoot":"","sources":["../../../src/ui/chrome/ErrorCard.tsx"],"names":[],"mappings":";;AA+BA,4BA+BC;;AA9DD,+CAAsD;AAEtD,wDAAwE;AACxE,iDAA8C;AAC9C,6CAAuD;AAWvD,MAAM,kBAAkB,GAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CACpE,IAAA,kCAAyB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAe7C,SAAwB,SAAS,CAAC,EAChC,KAAK,EACL,KAAK,GAAG,sBAAsB,EAC9B,OAAO,EACP,WAAW,GAAG,kBAAkB,EAChC,eAAe,GAAG,wCAAwC,GAC3C;IACf,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAEpD,OAAO,CACL,uBAAC,WAAI,IAAC,SAAS,EAAC,wDAAwD,YACtE,wBAAC,kBAAW,IAAC,SAAS,EAAC,8CAA8C,aACnE,gCAAK,SAAS,EAAC,+EAA+E,YAC5F,uBAAC,0BAAW,IAAC,SAAS,EAAC,0BAA0B,GAAG,GAChD,EACN,8BAAG,SAAS,EAAC,sCAAsC,YAAE,KAAK,GAAK,EAC/D,8BAAG,SAAS,EAAC,sDAAsD,YAAE,OAAO,GAAK,EAChF,OAAO,IAAI,CACV,wBAAC,eAAM,IACL,IAAI,EAAC,IAAI,EACT,OAAO,EAAC,SAAS,EACjB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAC,+EAA+E,aAEzF,uBAAC,wBAAS,IAAC,SAAS,EAAC,SAAS,GAAG,aAE1B,CACV,IACW,GACT,CACR,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "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",

package/src/lib/biome-host/define-web-biome.ts

@@ -0,0 +1,161 @@
+/**
+ * `defineWebBiome` — the authoring helper for `target: 'web'` biomes.
+ *
+ * Every web biome used to hand-repeat the same ~30 lines: one
+ * `lazy(() => import('./pages/X'))` per page, a `navItems` array, and a
+ * parallel `routes` array — writing the slug TWICE (once as `navItem.route`,
+ * once as `route.path`), the classic source of "nav points at a path no route
+ * serves" bugs.
+ *
+ * `defineWebBiome` collapses that to one declarative page list. Each
+ * {@link WebBiomePage} single-sources its `slug` for BOTH the nav route and the
+ * route path, so they can never drift. The helper emits one nav item (unless
+ * `navHidden`) and one route per page, wrapping the lazily-loaded page in a
+ * `<Suspense fallback={null}>` boundary via {@link lazyRoute}.
+ *
+ * Authors declare WHAT each surface is (`category`) and let the HOST own WHERE
+ * it renders in the global menu — preferring `category` over the legacy
+ * `section`/`weight`. `init`/`dispose`/`panels`/`session`/`outputRenderers`
+ * pass through to the `FrontendBiome` untouched, so bespoke biomes (one-shot
+ * registrations, slot fillers, session contributions) still use this helper.
+ *
+ * Host-framework-agnostic: pure React (`lazy`/`Suspense`/`createElement` via
+ * `lazyRoute`), no router and no Next.js.
+ *
+ * @example
+ *   export default defineWebBiome({
+ *     id: 'spaces-web',
+ *     displayName: 'Spaces',
+ *     pages: [
+ *       {
+ *         slug: 'system/spaces',
+ *         label: 'Spaces',
+ *         icon: Layers,
+ *         category: 'knowledge',
+ *         load: () => import('./pages/SpacesPage'),
+ *       },
+ *     ],
+ *   });
+ */
+
+import { lazyRoute } from './biome-builders';
+
+import type {
+  FrontendBiome,
+  FrontendBiomeFactory,
+  NavItemContribution,
+  RouteAccess,
+  RouteContribution,
+} from './frontend-biome';
+import type { ComponentType } from 'react';
+
+export interface WebBiomePage {
+  /**
+   * Single source of truth for BOTH the nav route AND the route path — the
+   * helper sets `navItem.route === route.path === slug`, so they can never
+   * diverge. May include `:param` segments (e.g. `system/concepts/:slug`).
+   */
+  readonly slug: string;
+  /**
+   * Stable nav-item id used for active-state matching + analytics. Defaults to
+   * {@link slug} when omitted — pass it explicitly only to preserve a
+   * pre-existing short id (e.g. `grants`) that differs from the route slug
+   * (`system/grants`). Must be unique across the biome's pages.
+   */
+  readonly id?: string;
+  /** Displayed nav label. */
+  readonly label: string;
+  /** Optional nav icon. Typed to match {@link NavItemContribution.icon}. */
+  readonly icon?: ComponentType<{ className?: string | undefined }>;
+  /**
+   * Host menu category — the biome's INTENT (`primary` | `build` | `operate` |
+   * `knowledge` | `admin` | `account`). The host maps it to a concrete rail
+   * group + order. Prefer this over `weight`.
+   */
+  readonly category?: string;
+  /**
+   * Route scope. `'org'` (default) mounts at the org root; `'project'` mounts
+   * under `/projects/:projectId`. Maps to {@link RouteContribution.projectScoped}.
+   */
+  readonly scope?: 'org' | 'project';
+  /** Access tier required to render the route. Defaults to `'member'`. */
+  readonly access?: RouteAccess;
+  /** Dynamic import of the page module (`() => import('./pages/X')`). */
+  readonly load: () => Promise<{ default: ComponentType<unknown> }>;
+  /**
+   * Optional legacy intra-category sort weight. Prefer host-owned `category`
+   * ordering; retained only as a tiebreak for un-migrated taxonomies.
+   */
+  readonly weight?: number;
+  /**
+   * When true the route is registered but NO nav item is emitted — for hidden
+   * surfaces such as a `:param` detail route reached only by deeplink.
+   */
+  readonly navHidden?: boolean;
+}
+
+export interface DefineWebBiomeOptions {
+  /** Stable biome id; matches `xema-biome.json` `xema.id`. */
+  readonly id: string;
+  /** Displayed name. */
+  readonly displayName: string;
+  /** One-shot initializer; passed through to {@link FrontendBiome.init}. */
+  readonly init?: FrontendBiome['init'];
+  /** Teardown counterpart; passed through to {@link FrontendBiome.dispose}. */
+  readonly dispose?: FrontendBiome['dispose'];
+  /** The biome's pages — one nav item (unless `navHidden`) + one route each. */
+  readonly pages: readonly WebBiomePage[];
+  /** Slot fillers; passed through to {@link FrontendBiome.panels}. */
+  readonly panels?: FrontendBiome['panels'];
+  /** Session-shell contributions; passed through to {@link FrontendBiome.session}. */
+  readonly session?: FrontendBiome['session'];
+  /** Output renderers; passed through to {@link FrontendBiome.outputRenderers}. */
+  readonly outputRenderers?: FrontendBiome['outputRenderers'];
+}
+
+/**
+ * Build the `FrontendBiomeFactory` a web biome default-exports. See the
+ * module doc-comment for the rationale and an example.
+ */
+export function defineWebBiome(
+  options: DefineWebBiomeOptions,
+): FrontendBiomeFactory {
+  return () => {
+    const navItems: NavItemContribution[] = [];
+    const routes: RouteContribution[] = [];
+
+    for (const page of options.pages) {
+      routes.push({
+        path: page.slug,
+        projectScoped: page.scope === 'project',
+        element: lazyRoute(page.load),
+        ...(page.access ? { access: page.access } : {}),
+      });
+
+      if (!page.navHidden) {
+        navItems.push({
+          id: page.id ?? page.slug,
+          label: page.label,
+          route: page.slug,
+          ...(page.icon ? { icon: page.icon } : {}),
+          ...(page.category !== undefined ? { category: page.category } : {}),
+          ...(page.weight !== undefined ? { weight: page.weight } : {}),
+        });
+      }
+    }
+
+    return {
+      id: options.id,
+      displayName: options.displayName,
+      navItems,
+      routes,
+      ...(options.init ? { init: options.init } : {}),
+      ...(options.dispose ? { dispose: options.dispose } : {}),
+      ...(options.panels ? { panels: options.panels } : {}),
+      ...(options.session ? { session: options.session } : {}),
+      ...(options.outputRenderers
+        ? { outputRenderers: options.outputRenderers }
+        : {}),
+    };
+  };
+}

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

@@ -0,0 +1,220 @@
+/**
+ * Canonical user-facing error decoder — ONE implementation biomes, the host
+ * shell, and the kernel's {@link ErrorCard} default all share.
+ *
+ * Biomes were each re-implementing "pull a human message off an error"
+ * (envelope shapes, status-code copy, "failed to fetch"). This is the single
+ * host-agnostic decoder. It is a PURE function: no fetch, no i18n, no config,
+ * no `instanceof` against host classes. It recognises the two error shapes the
+ * Xema frontend produces by their structural signature:
+ *
+ *   - the host's `ApiClientError` (`name === 'ApiClientError'`, `statusCode`,
+ *     `message`, optional `errorType`), thrown by the hand-rolled HTTP client;
+ *   - Orval's generated `ClientError` (`name === 'ClientError'`, `status`,
+ *     `message`, `body`), thrown by the generated clients. Its `body` carries
+ *     the backend `{ message, code, details }` envelope (and the workflow
+ *     wallet-missing / `session_busy` special cases).
+ *
+ * Hosts that previously kept their own `getUserFacingErrorMessage` should
+ * re-export THIS one (or delete theirs and import it) so there is a single
+ * decoder. {@link ErrorCard} defaults to it, so biomes get envelope-aware copy
+ * without wiring anything.
+ */
+
+function collapseWhitespace(value: string): string {
+  return value.split(/\s+/).join(' ').trim();
+}
+
+function getGenericErrorMessage(message: string, fallback: string): string {
+  const normalized = collapseWhitespace(message);
+  if (/failed to fetch/i.test(normalized)) {
+    return 'Could not reach the service. Check your connection and try again.';
+  }
+  return normalized || fallback;
+}
+
+function normalizeValidationMessage(rawMessage: string): string {
+  const parts = rawMessage
+    .split(',')
+    .map((part) => collapseWhitespace(part))
+    .filter(Boolean);
+
+  if (parts.length === 0) {
+    return 'Some required fields are missing or invalid. Please review your input and try again.';
+  }
+
+  const preview = parts.slice(0, 2).join('; ');
+  const suffix = parts.length > 2 ? '; and more.' : '.';
+  return `Some required fields are missing or invalid (${preview}${suffix})`;
+}
+
+/** Structural signature of the host's `ApiClientError`. */
+interface ApiClientErrorLike {
+  readonly name: string;
+  readonly statusCode: number;
+  readonly message: string;
+  readonly errorType?: string;
+}
+
+function isApiClientErrorLike(error: unknown): error is ApiClientErrorLike {
+  if (!error || typeof error !== 'object') {
+    return false;
+  }
+  const record = error as Record<string, unknown>;
+  return (
+    record['name'] === 'ApiClientError' &&
+    typeof record['statusCode'] === 'number' &&
+    typeof record['message'] === 'string'
+  );
+}
+
+/** Structural signature of an Orval-generated `ClientError`. */
+interface OrvalClientErrorLike {
+  readonly name: string;
+  readonly status: number;
+  readonly message: string;
+  readonly body: unknown;
+}
+
+function isOrvalClientErrorLike(error: unknown): error is OrvalClientErrorLike {
+  if (!error || typeof error !== 'object') {
+    return false;
+  }
+  const record = error as Record<string, unknown>;
+  return (
+    record['name'] === 'ClientError' &&
+    typeof record['status'] === 'number' &&
+    typeof record['message'] === 'string' &&
+    Object.hasOwn(record, 'body')
+  );
+}
+
+interface WorkflowErrorEnvelope {
+  readonly code?: string;
+  readonly message?: string;
+  readonly details?: Record<string, unknown>;
+}
+
+function readStringList(value: unknown): string[] | null {
+  if (!Array.isArray(value)) {
+    return null;
+  }
+  if (value.some((entry) => typeof entry !== 'string')) {
+    return null;
+  }
+  return value;
+}
+
+function normalizeWorkflowWalletMissingMessage(envelope: WorkflowErrorEnvelope): string | null {
+  if (envelope.code !== 'WORKFLOW_WALLET_NOT_FOUND') {
+    return null;
+  }
+  const missing = readStringList(envelope.details?.['missing']);
+  if (missing === null || missing.length === 0) {
+    return 'One or more required wallets are missing for this project.';
+  }
+  return `Missing wallet${missing.length > 1 ? 's' : ''}: ${missing.join(', ')}. Add ${
+    missing.length > 1 ? 'them' : 'it'
+  } in Project Settings -> Wallets.`;
+}
+
+function getApiClientErrorMessage(error: ApiClientErrorLike, fallback: string): string {
+  if (error.statusCode === 0) {
+    return collapseWhitespace(error.message) || fallback;
+  }
+  if (error.statusCode === 400) {
+    const raw = collapseWhitespace(error.message);
+    if (raw.includes(' must ') || raw.includes('regular expression')) {
+      return normalizeValidationMessage(raw);
+    }
+    return raw || 'The request is invalid. Please check your input and try again.';
+  }
+  if (error.statusCode === 401) {
+    return 'Your session expired. Please sign in again.';
+  }
+  if (error.statusCode === 403) {
+    return 'You do not have permission to perform this action.';
+  }
+  if (error.statusCode === 404) {
+    return 'The requested resource was not found.';
+  }
+  if (error.statusCode >= 500) {
+    return 'The service is temporarily unavailable. Please try again in a moment.';
+  }
+  return collapseWhitespace(error.message) || fallback;
+}
+
+function getOrvalClientErrorMessage(error: OrvalClientErrorLike, fallback: string): string {
+  if (error.status >= 500) {
+    return 'The service is temporarily unavailable. Please try again in a moment.';
+  }
+  // session-api refuses mutations while a prompt turn is in flight; the 409
+  // body is `{ error: 'session_busy', retryAfterTurnDone: true }`. Surface a
+  // clear retry hint instead of the generic "Conflict" copy.
+  if (error.status === 409) {
+    const body = error.body;
+    if (body && typeof body === 'object') {
+      const record = body as Record<string, unknown>;
+      if (record['error'] === 'session_busy') {
+        return 'Your last message is still running. Wait for the agent to finish, then try again.';
+      }
+    }
+  }
+  const body = error.body;
+  if (body && typeof body === 'object') {
+    const record = body as Record<string, unknown>;
+    const payload: WorkflowErrorEnvelope = (() => {
+      const message = record['message'];
+      if (message && typeof message === 'object') {
+        return message as WorkflowErrorEnvelope;
+      }
+      return {
+        code: typeof record['code'] === 'string' ? record['code'] : undefined,
+        message: typeof record['message'] === 'string' ? record['message'] : undefined,
+        details:
+          record['details'] && typeof record['details'] === 'object'
+            ? (record['details'] as Record<string, unknown>)
+            : undefined,
+      };
+    })();
+
+    const workflowWalletMessage = normalizeWorkflowWalletMissingMessage(payload);
+    if (workflowWalletMessage !== null) {
+      return workflowWalletMessage;
+    }
+    if (typeof payload.message === 'string' && payload.message.trim().length > 0) {
+      return collapseWhitespace(payload.message);
+    }
+    if (typeof record['message'] === 'string' && record['message'].trim().length > 0) {
+      return collapseWhitespace(record['message']);
+    }
+  }
+  return getGenericErrorMessage(error.message, fallback);
+}
+
+/**
+ * Decode any thrown value into a human, user-facing message. The single decoder
+ * for biomes, the host shell, and {@link ErrorCard}'s default.
+ *
+ * @param error Any thrown value (string, `Error`, `ApiClientError`, Orval
+ *   `ClientError`, or unknown).
+ * @param fallback Copy returned when nothing better can be extracted.
+ */
+export function getUserFacingErrorMessage(
+  error: unknown,
+  fallback = 'Something went wrong. Please try again.',
+): string {
+  if (typeof error === 'string') {
+    return collapseWhitespace(error) || fallback;
+  }
+  if (isApiClientErrorLike(error)) {
+    return getApiClientErrorMessage(error, fallback);
+  }
+  if (isOrvalClientErrorLike(error)) {
+    return getOrvalClientErrorMessage(error, fallback);
+  }
+  if (error instanceof Error) {
+    return getGenericErrorMessage(error.message, fallback);
+  }
+  return fallback;
+}

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

@@ -27,9 +27,27 @@ export interface NavItemContribution {
    * className it computes from its own theme.
    */
   readonly icon?: ComponentType<{ className?: string | undefined }>;
-  /** Section grouping key (matches host nav-registry sections). */
+  /**
+   * Semantic menu category the biome declares its INTENT to live in (e.g.
+   * `build`, `operate`, `knowledge`, `account`). The HOST owns the menu
+   * information-architecture: it maps a category to a concrete rail group,
+   * heading, and order. Authors declare WHAT a surface is, not WHERE in the
+   * global menu it renders — so the platform can re-organise the menu without
+   * editing every biome. Prefer this over `section`/`weight`. When omitted,
+   * the host falls back to its own taxonomy (keyed on the nav-item id) and,
+   * last, to the legacy `section`.
+   */
+  readonly category?: string;
+  /**
+   * @deprecated Legacy direct section-heading placement. The host now owns
+   * grouping via `category` + its taxonomy; retained only until every biome
+   * declares a `category`. Do NOT use in new biomes.
+   */
   readonly section?: string;
-  /** Sort weight within the section (lower first). Defaults to 100. */
+  /**
+   * @deprecated Legacy intra-section sort weight. Ordering is host-owned per
+   * category now. Retained only for un-migrated biomes.
+   */
   readonly weight?: number;
 }
 

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

@@ -5,6 +5,8 @@ import { createContext, useContext, type ReactNode } from 'react';
 import type { CapabilityPort } from '../capabilities';
 import type { SystemBus } from '../system-bus';
 
+import type { RealtimeSource } from './realtime-port';
+
 /**
  * `HostBridge` is the host-agnostic abstraction every frontend biome
  * receives at registration time. It decouples biome code from any
@@ -113,6 +115,26 @@ export interface HostBridgeRequestContext {
   readonly correlationId: string;
 }
 
+/**
+ * Error-decoding surface — the canonical "turn a thrown value into a
+ * user-facing message" decoder, exposed on the bridge so biomes use ONE
+ * implementation instead of each re-deriving envelope/status-code copy.
+ *
+ * The decoder is a PURE function (no host context), so the kernel also ships it
+ * directly as {@link getUserFacingErrorMessage} and {@link ErrorCard} defaults
+ * to it. It is ALSO hung off the bridge so a host can override it with a
+ * shell-specific decoder (extra error codes, i18n) without every biome wiring a
+ * prop — the bridge value is the single override point.
+ */
+export interface HostBridgeErrors {
+  /**
+   * Decode any thrown value into a user-facing message. `fallback` is returned
+   * when nothing better can be extracted. Defaults (in the kernel default
+   * bridge wiring) to {@link getUserFacingErrorMessage}.
+   */
+  getUserFacingErrorMessage(error: unknown, fallback?: string): string;
+}
+
 /**
  * Where the topbar's leading back-button takes you. Pages that have a
  * meaningful "parent context" register this; pages without one omit it
@@ -201,6 +223,28 @@ export interface HostBridge {
    * `<CapabilityProvider>` + `useCapability()` (see `../capabilities`).
    */
   readonly capabilities: CapabilityPort;
+  /**
+   * Realtime (CloudEvents over SSE) port. The HOST injects a concrete
+   * {@link RealtimeSource} backed by its realtime transport
+   * (`@xemahq/realtime-client`); biomes reach it through the kernel
+   * `useCloudEvent` / `useRealtimeStatus` / `useEventScope` hooks so biome code
+   * never imports the SSE client directly — same decoupling as `navigation`.
+   *
+   * OPTIONAL: a host without a realtime transport simply omits it; the kernel
+   * `useCloudEvent`/`useRealtimeStatus`/`useEventScope` hooks fail fast with an
+   * actionable error if a biome uses them before the host wires `bridge.realtime`.
+   */
+  readonly realtime?: RealtimeSource;
+  /**
+   * Error-decoding surface — the canonical user-facing error decoder. Defaults
+   * (in the kernel default bridge wiring) to {@link getUserFacingErrorMessage};
+   * a host MAY override it. Biomes + {@link ErrorCard} read ONE decoder instead
+   * of each re-deriving message extraction.
+   *
+   * OPTIONAL: when omitted, consumers fall back to the kernel default
+   * {@link getUserFacingErrorMessage} (which ErrorCard already uses directly).
+   */
+  readonly errors?: HostBridgeErrors;
 }
 
 export const HostBridgeContext = createContext<HostBridge | null>(null);

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

@@ -18,6 +18,7 @@ export * from './biome-navigation';
 export * from './biome-scope';
 export * from './biome-scoped-query';
 export * from './biome-builders';
+export * from './define-web-biome';
 export * from './create-biome-orval-config';
 export * from './biome-registry';
 export * from './session-contributions';
@@ -26,3 +27,7 @@ export * from './host-sources';
 export * from './nav';
 export * from './biome-mode';
 export * from './agent-validation';
+export * from './realtime-port';
+export * from './realtime-hooks';
+export * from './errors';
+export * from './response-envelope';