@xemahq/ui-kernel 0.5.0 → 0.6.1

package/dist/ui/index.js

@@ -17,12 +17,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncBoundary = exports.LoadingState = exports.PageToolbar = exports.PageHeader = exports.StateCard = exports.EmptyState = exports.PageShell = exports.ConfirmDeleteDialog = exports.ScopeBadge = exports.StatusBadge = exports.ErrorCard = exports.useDebouncedValue = exports.cn = void 0;
+exports.PdfPreview = exports.AsyncBoundary = exports.LoadingState = exports.PageToolbar = exports.PageHeader = exports.StateCard = exports.EmptyState = exports.PageShell = exports.ConfirmDeleteDialog = exports.ScopeBadge = exports.StatusBadge = exports.ErrorCard = exports.APP_PRIMARY_COLOR_VAR = exports.useAppBranding = exports.AppBrandingProvider = exports.PreviewDeviceFrame = exports.useIsMobile = exports.useDebouncedValue = exports.MOBILE_BREAKPOINT = exports.cn = void 0;
 var cn_1 = require("./cn");
 Object.defineProperty(exports, "cn", { enumerable: true, get: function () { return cn_1.cn; } });
 __exportStar(require("./design-tokens"), exports);
+var breakpoints_1 = require("./breakpoints");
+Object.defineProperty(exports, "MOBILE_BREAKPOINT", { enumerable: true, get: function () { return breakpoints_1.MOBILE_BREAKPOINT; } });
 var use_debounced_value_1 = require("./hooks/use-debounced-value");
 Object.defineProperty(exports, "useDebouncedValue", { enumerable: true, get: function () { return use_debounced_value_1.useDebouncedValue; } });
+var use_is_mobile_1 = require("./hooks/use-is-mobile");
+Object.defineProperty(exports, "useIsMobile", { enumerable: true, get: function () { return use_is_mobile_1.useIsMobile; } });
 __exportStar(require("./primitives/button"), exports);
 __exportStar(require("./primitives/badge"), exports);
 __exportStar(require("./primitives/input"), exports);
@@ -50,6 +54,13 @@ __exportStar(require("./primitives/tag-multi-select"), exports);
 __exportStar(require("./primitives/sheet"), exports);
 __exportStar(require("./primitives/form-stepper"), exports);
 __exportStar(require("./primitives/async-combobox"), exports);
+var preview_device_frame_1 = require("./primitives/preview-device-frame");
+Object.defineProperty(exports, "PreviewDeviceFrame", { enumerable: true, get: function () { return preview_device_frame_1.PreviewDeviceFrame; } });
+__exportStar(require("./charts"), exports);
+var app_branding_provider_1 = require("./branding/app-branding-provider");
+Object.defineProperty(exports, "AppBrandingProvider", { enumerable: true, get: function () { return app_branding_provider_1.AppBrandingProvider; } });
+Object.defineProperty(exports, "useAppBranding", { enumerable: true, get: function () { return app_branding_provider_1.useAppBranding; } });
+Object.defineProperty(exports, "APP_PRIMARY_COLOR_VAR", { enumerable: true, get: function () { return app_branding_provider_1.APP_PRIMARY_COLOR_VAR; } });
 var ErrorCard_1 = require("./chrome/ErrorCard");
 Object.defineProperty(exports, "ErrorCard", { enumerable: true, get: function () { return __importDefault(ErrorCard_1).default; } });
 var status_badge_1 = require("./chrome/status-badge");
@@ -71,4 +82,6 @@ var LoadingState_1 = require("./chrome/LoadingState");
 Object.defineProperty(exports, "LoadingState", { enumerable: true, get: function () { return __importDefault(LoadingState_1).default; } });
 var AsyncBoundary_1 = require("./chrome/AsyncBoundary");
 Object.defineProperty(exports, "AsyncBoundary", { enumerable: true, get: function () { return __importDefault(AsyncBoundary_1).default; } });
+var pdf_preview_1 = require("./pdf/pdf-preview");
+Object.defineProperty(exports, "PdfPreview", { enumerable: true, get: function () { return pdf_preview_1.PdfPreview; } });
 //# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAYA,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AAGX,kDAAgC;AAGhC,mEAAgE;AAAvD,wHAAA,iBAAiB,OAAA;AAG1B,sDAAoC;AACpC,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,oDAAkC;AAClC,6DAA2C;AAC3C,wDAAsC;AACtC,wDAAsC;AACtC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC;AACpC,yDAAuC;AACvC,2DAAyC;AACzC,4DAA0C;AAC1C,uDAAqC;AACrC,2DAAyC;AACzC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,gEAA8C;AAC9C,qDAAmC;AACnC,4DAA0C;AAC1C,8DAA4C;AAG5C,gDAAsF;AAA7E,uHAAA,OAAO,OAAa;AAC7B,sDAA4G;AAAnG,4HAAA,OAAO,OAAe;AAC/B,oDAAmF;AAA1E,0HAAA,OAAO,OAAc;AAC9B,wEAGwC;AAFtC,6IAAA,OAAO,OAAuB;AAGhC,kDAA2D;AAAlD,wHAAA,OAAO,OAAa;AAC7B,kDAK6B;AAJ3B,yHAAA,OAAO,OAAc;AAKvB,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAClB,kDAAyE;AAAhE,yHAAA,OAAO,OAAc;AAAE,yGAAA,WAAW,OAAA;AAC3C,sDAA0F;AAAjF,6HAAA,OAAO,OAAgB;AAChC,wDAAkE;AAAzD,+HAAA,OAAO,OAAiB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAYA,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AAGX,kDAAgC;AAGhC,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAG1B,mEAAgE;AAAvD,wHAAA,iBAAiB,OAAA;AAC1B,uDAAoD;AAA3C,4GAAA,WAAW,OAAA;AAGpB,sDAAoC;AACpC,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,oDAAkC;AAClC,6DAA2C;AAC3C,wDAAsC;AACtC,wDAAsC;AACtC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC;AACpC,yDAAuC;AACvC,2DAAyC;AACzC,4DAA0C;AAC1C,uDAAqC;AACrC,2DAAyC;AACzC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,gEAA8C;AAC9C,qDAAmC;AACnC,4DAA0C;AAC1C,8DAA4C;AAC5C,0EAG2C;AAFzC,0HAAA,kBAAkB,OAAA;AAKpB,2CAAyB;AAGzB,0EAM0C;AALxC,4HAAA,mBAAmB,OAAA;AACnB,uHAAA,cAAc,OAAA;AACd,8HAAA,qBAAqB,OAAA;AAMvB,gDAAsF;AAA7E,uHAAA,OAAO,OAAa;AAC7B,sDAA4G;AAAnG,4HAAA,OAAO,OAAe;AAC/B,oDAAmF;AAA1E,0HAAA,OAAO,OAAc;AAC9B,wEAGwC;AAFtC,6IAAA,OAAO,OAAuB;AAGhC,kDAA2D;AAAlD,wHAAA,OAAO,OAAa;AAC7B,kDAK6B;AAJ3B,yHAAA,OAAO,OAAc;AAKvB,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAClB,kDAAyE;AAAhE,yHAAA,OAAO,OAAc;AAAE,yGAAA,WAAW,OAAA;AAC3C,sDAA0F;AAAjF,6HAAA,OAAO,OAAgB;AAChC,wDAAkE;AAAzD,+HAAA,OAAO,OAAiB;AAEjC,iDAAqE;AAA5D,yGAAA,UAAU,OAAA"}

package/dist/ui/pdf/pdf-preview.d.ts

@@ -0,0 +1,8 @@
+import { type JSX } from 'react';
+export interface PdfPreviewProps {
+    readonly url: string;
+    readonly title?: string;
+    readonly className?: string;
+}
+export declare function PdfPreview({ url, title, className }: PdfPreviewProps): JSX.Element;
+//# sourceMappingURL=pdf-preview.d.ts.map

package/dist/ui/pdf/pdf-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-preview.d.ts","sourceRoot":"","sources":["../../../src/ui/pdf/pdf-preview.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAkC,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAsBjE,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,UAAU,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CA2ElF"}

package/dist/ui/pdf/pdf-preview.js

@@ -0,0 +1,34 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfPreview = PdfPreview;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const lucide_react_1 = require("lucide-react");
+const react_1 = require("react");
+const react_pdf_1 = require("react-pdf");
+const cn_1 = require("../cn");
+if (!react_pdf_1.pdfjs.GlobalWorkerOptions.workerSrc) {
+    react_pdf_1.pdfjs.GlobalWorkerOptions.workerSrc = '/pdf.worker.min.mjs';
+}
+const MIN_SCALE = 0.5;
+const MAX_SCALE = 3;
+const STEP = 0.25;
+const DEFAULT_SCALE = 1;
+const clampScale = (s) => Math.min(MAX_SCALE, Math.max(MIN_SCALE, Math.round(s * 100) / 100));
+function PdfPreview({ url, title, className }) {
+    const [numPages, setNumPages] = (0, react_1.useState)(0);
+    const [scale, setScale] = (0, react_1.useState)(DEFAULT_SCALE);
+    const [error, setError] = (0, react_1.useState)(null);
+    const file = (0, react_1.useMemo)(() => ({ url }), [url]);
+    const zoomOut = (0, react_1.useCallback)(() => setScale((s) => clampScale(s - STEP)), []);
+    const zoomIn = (0, react_1.useCallback)(() => setScale((s) => clampScale(s + STEP)), []);
+    const reset = (0, react_1.useCallback)(() => setScale(DEFAULT_SCALE), []);
+    const btn = 'inline-flex h-7 w-7 items-center justify-center rounded text-neutral-600 ' +
+        'hover:bg-neutral-200/70 disabled:pointer-events-none disabled:opacity-40 ' +
+        'focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-1';
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, cn_1.cn)('flex h-[520px] flex-col overflow-hidden rounded border border-neutral-200 bg-white', className), children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-1 border-b border-neutral-200 bg-neutral-50 px-2 py-1", children: [(0, jsx_runtime_1.jsx)("button", { type: "button", onClick: zoomOut, disabled: scale <= MIN_SCALE, "aria-label": "Zoom out", className: btn, children: (0, jsx_runtime_1.jsx)(lucide_react_1.ZoomOut, { className: "h-4 w-4" }) }), (0, jsx_runtime_1.jsxs)("span", { className: "w-12 text-center text-xs tabular-nums text-neutral-500", children: [Math.round(scale * 100), "%"] }), (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: zoomIn, disabled: scale >= MAX_SCALE, "aria-label": "Zoom in", className: btn, children: (0, jsx_runtime_1.jsx)(lucide_react_1.ZoomIn, { className: "h-4 w-4" }) }), (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: reset, disabled: scale === DEFAULT_SCALE, "aria-label": "Reset zoom", className: btn, children: (0, jsx_runtime_1.jsx)(lucide_react_1.RotateCcw, { className: "h-4 w-4" }) }), title ? ((0, jsx_runtime_1.jsx)("span", { className: "ml-2 min-w-0 flex-1 truncate text-xs text-neutral-400", title: title, children: title })) : null] }), (0, jsx_runtime_1.jsx)("div", { className: "flex-1 overflow-auto bg-neutral-100 p-3", children: error ? ((0, jsx_runtime_1.jsxs)("div", { className: "p-4 text-xs text-neutral-500", children: ["Couldn't render this PDF (", error, "). Use the download affordance."] })) : ((0, jsx_runtime_1.jsx)(react_pdf_1.Document, { file: file, onLoadSuccess: ({ numPages: n }) => {
+                        setNumPages(n);
+                        setError(null);
+                    }, onLoadError: (e) => setError(e.message), loading: (0, jsx_runtime_1.jsx)("div", { className: "p-4 text-xs text-neutral-500", children: "Loading PDF\u2026" }), className: "flex flex-col items-center gap-3", children: Array.from({ length: numPages }, (_, i) => ((0, jsx_runtime_1.jsx)(react_pdf_1.Page, { pageNumber: i + 1, scale: scale, renderTextLayer: false, renderAnnotationLayer: false, className: "shadow-sm" }, i))) })) })] }));
+}
+//# sourceMappingURL=pdf-preview.js.map

package/dist/ui/pdf/pdf-preview.js.map

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

package/dist/ui/primitives/preview-device-frame.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+export type PreviewDevice = 'desktop' | 'tablet' | 'mobile' | 'presentation' | 'a4';
+interface PreviewDeviceFrameProps {
+    readonly device: PreviewDevice;
+    readonly children: ReactNode;
+}
+export declare function PreviewDeviceFrame({ device, children, }: PreviewDeviceFrameProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=preview-device-frame.d.ts.map

package/dist/ui/primitives/preview-device-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-device-frame.d.ts","sourceRoot":"","sources":["../../../src/ui/primitives/preview-device-frame.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAS1E,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,IAAI,CAAC;AAET,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAoBD,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,QAAQ,GACT,EAAE,uBAAuB,+BAmBzB"}

package/dist/ui/primitives/preview-device-frame.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreviewDeviceFrame = PreviewDeviceFrame;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const cn_1 = require("../cn");
+const BEZELS = {
+    tablet: { width: 768, height: 1024, radius: 18 },
+    mobile: { width: 390, height: 844, radius: 36 },
+};
+const PRESENTATION_VIEWPORT = { width: 1280, height: 720, radius: 20 };
+const A4_VIEWPORT = { width: 794, height: 1123, radius: 4 };
+function PreviewDeviceFrame({ device, children, }) {
+    if (device === 'desktop') {
+        return (0, jsx_runtime_1.jsx)("div", { className: "h-full w-full", children: children });
+    }
+    if (device === 'presentation') {
+        return ((0, jsx_runtime_1.jsx)(ResponsiveViewport, { bezel: PRESENTATION_VIEWPORT, aspectRatio: 16 / 9, children: children }));
+    }
+    if (device === 'a4') {
+        return ((0, jsx_runtime_1.jsx)(ResponsiveViewport, { bezel: A4_VIEWPORT, aspectRatio: 794 / 1123, children: children }));
+    }
+    return (0, jsx_runtime_1.jsx)(ScaledBezel, { bezel: BEZELS[device], children: children });
+}
+function ScaledBezel({ bezel, children }) {
+    const containerRef = (0, react_1.useRef)(null);
+    const [scale, setScale] = (0, react_1.useState)(1);
+    (0, react_1.useLayoutEffect)(() => {
+        const el = containerRef.current;
+        if (!el)
+            return;
+        const compute = () => {
+            const { clientWidth, clientHeight } = el;
+            if (clientWidth === 0 || clientHeight === 0)
+                return;
+            const margin = 24;
+            const availW = Math.max(0, clientWidth - margin);
+            const availH = Math.max(0, clientHeight - margin);
+            const next = Math.min(1, availW / bezel.width, availH / bezel.height);
+            setScale(next);
+        };
+        compute();
+        const observer = new ResizeObserver(compute);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [bezel.width, bezel.height]);
+    return ((0, jsx_runtime_1.jsx)("div", { ref: containerRef, className: "flex h-full w-full items-center justify-center overflow-hidden bg-paper-elev/60 p-2", children: (0, jsx_runtime_1.jsx)("div", { className: (0, cn_1.cn)('relative shrink-0 overflow-hidden bg-paper shadow-2xl ring-1 ring-border/75'), style: {
+                width: bezel.width,
+                height: bezel.height,
+                borderRadius: bezel.radius,
+                transform: `scale(${scale})`,
+                transformOrigin: 'center center',
+            }, children: children }) }));
+}
+function ResponsiveViewport({ bezel, aspectRatio, children, }) {
+    const containerRef = (0, react_1.useRef)(null);
+    const [size, setSize] = (0, react_1.useState)(() => ({
+        width: bezel.width,
+        height: bezel.height,
+    }));
+    (0, react_1.useLayoutEffect)(() => {
+        const el = containerRef.current;
+        if (!el)
+            return;
+        const compute = () => {
+            const { clientWidth, clientHeight } = el;
+            if (clientWidth === 0 || clientHeight === 0)
+                return;
+            const margin = 24;
+            const availW = Math.max(0, clientWidth - margin);
+            const availH = Math.max(0, clientHeight - margin);
+            const nextWidth = Math.min(availW, availH * aspectRatio);
+            const nextHeight = nextWidth / aspectRatio;
+            setSize({
+                width: Math.max(1, Math.round(nextWidth)),
+                height: Math.max(1, Math.round(nextHeight)),
+            });
+        };
+        compute();
+        const observer = new ResizeObserver(compute);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [bezel.width, bezel.height]);
+    return ((0, jsx_runtime_1.jsx)("div", { ref: containerRef, className: "flex h-full w-full items-center justify-center overflow-hidden bg-paper-elev/60 p-2", children: (0, jsx_runtime_1.jsx)("div", { className: (0, cn_1.cn)('relative shrink-0 overflow-hidden bg-paper shadow-2xl ring-1 ring-border/75'), style: {
+                width: size.width,
+                height: size.height,
+                borderRadius: bezel.radius,
+            }, children: children }) }));
+}
+//# sourceMappingURL=preview-device-frame.js.map

package/dist/ui/primitives/preview-device-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-device-frame.js","sourceRoot":"","sources":["../../../src/ui/primitives/preview-device-frame.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "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",
@@ -12,16 +12,15 @@
     "deeplink",
     "intents"
   ],
+  "license": "Apache-2.0",
+  "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
   "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",
+    "url": "git+https://github.com/xema-dev/xema-kernel-sdk.git",
     "directory": "packages/ui/xema-ui-kernel"
   },
-  "license": "Apache-2.0",
+  "bugs": "https://github.com/xema-dev/xema-kernel-sdk/issues",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -54,6 +53,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.462.0",
+    "react-pdf": "^9.1.1",
     "react-resizable-panels": "^4.9.0",
     "tailwind-merge": "^2.5.4"
   },
@@ -74,7 +74,7 @@
     "prettier": "3.6.2",
     "react": "^18.3.1",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.14.0"
+    "@xemahq/kernel-contracts": "^0.36.0"
   },
   "exports": {
     ".": {
@@ -101,6 +101,7 @@
   "scripts": {
     "clean": "rm -rf dist",
     "build": "tsc -p tsconfig.json",
+    "test": "echo '[ui-kernel] *.{test,spec} files run under host-web vitest (this package carries no vitest dep by design — see tsconfig exclude). Write tests with vitest; the frontend-bridge sync fails on a node:test file.'",
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "lint": "tsc -p tsconfig.lint.json --noEmit",
     "typecheck": "tsc -p tsconfig.lint.json --noEmit"

package/src/lib/biome-host/define-web-biome.test.js

@@ -0,0 +1,93 @@
+// Test suite for defineWebBiome's define-time scope/access validation and the
+// chrome default. Runs on Node's native test runner against the COMPILED dist
+// (CommonJS), so the package needs no jest/vitest/ts-jest toolchain — the
+// `test` script builds first, then runs this file with `node --test`.
+//
+// Covered:
+//   1. A `public` page with access `'member'` (or omitted) throws at define time.
+//   2. A `public` + access `'public'` page is accepted; its route carries no
+//      nav item and mounts with access `'public'`.
+//   3. A non-public page declaring access `'public'` throws at define time.
+//   4. `chrome` defaults to `'host'` when a page omits it; `'none'` passes through.
+
+'use strict';
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+const { defineWebBiome } = require('../../../dist/lib/biome-host/define-web-biome.js');
+
+const load = () => Promise.resolve({ default: () => null });
+const bridge = /** @type {any} */ ({});
+
+test('rejects a public page whose access is not public (member default)', () => {
+  assert.throws(
+    () =>
+      defineWebBiome({
+        id: 'test-biome',
+        displayName: 'Test',
+        pages: [{ slug: 'ext/:id', label: 'Ext', scope: 'public', load }],
+      }),
+    /a 'public' scope page MUST declare access: 'public'/,
+  );
+});
+
+test('rejects a public page with an explicit non-public access tier', () => {
+  assert.throws(
+    () =>
+      defineWebBiome({
+        id: 'test-biome',
+        displayName: 'Test',
+        pages: [
+          { slug: 'ext/:id', label: 'Ext', scope: 'public', access: 'org-admin', load },
+        ],
+      }),
+    /a 'public' scope page MUST declare access: 'public'/,
+  );
+});
+
+test('rejects a non-public page that declares access public', () => {
+  assert.throws(
+    () =>
+      defineWebBiome({
+        id: 'test-biome',
+        displayName: 'Test',
+        pages: [{ slug: 'system/x', label: 'X', access: 'public', load }],
+      }),
+    /access: 'public' is only valid on a 'public' scope page/,
+  );
+});
+
+test('accepts a public + access:public page and emits no nav item', () => {
+  const factory = defineWebBiome({
+    id: 'test-biome',
+    displayName: 'Test',
+    pages: [
+      { slug: 'ext/:id', label: 'Ext', scope: 'public', access: 'public', load },
+    ],
+  });
+  const biome = factory(bridge);
+  assert.equal(biome.routes.length, 1);
+  const route = biome.routes[0];
+  assert.equal(route.path, 'ext/:id');
+  assert.equal(route.access, 'public');
+  assert.equal(route.projectScoped, false);
+  // Public routes never enter the authenticated app rail.
+  assert.equal(biome.navItems.length, 0);
+});
+
+test('chrome defaults to host and none passes through', () => {
+  const factory = defineWebBiome({
+    id: 'test-biome',
+    displayName: 'Test',
+    pages: [
+      { slug: 'system/a', label: 'A', load },
+      { slug: 'system/b', label: 'B', chrome: 'none', load },
+    ],
+  });
+  const biome = factory(bridge);
+  const a = biome.routes.find((r) => r.path === 'system/a');
+  const b = biome.routes.find((r) => r.path === 'system/b');
+  assert.equal(a.chrome, 'host');
+  assert.equal(b.chrome, 'none');
+});

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

@@ -14,10 +14,10 @@
  * `<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.
+ * it renders in the global menu. `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.
@@ -44,8 +44,10 @@ import type {
   FrontendBiome,
   FrontendBiomeFactory,
   NavItemContribution,
+  PageChrome,
   RouteAccess,
   RouteContribution,
+  RouteScope,
 } from './frontend-biome';
 import type { ComponentType } from 'react';
 
@@ -70,23 +72,31 @@ export interface WebBiomePage {
   /**
    * 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`.
+   * group + order.
    */
   readonly category?: string;
   /**
    * Route scope. `'org'` (default) mounts at the org root; `'project'` mounts
-   * under `/projects/:projectId`. Maps to {@link RouteContribution.projectScoped}.
+   * under the canonical project-scoped route prefix; `'public'` mounts OUTSIDE
+   * the host's authenticated group (no Keycloak session, no login redirect, no
+   * org switcher). Maps to {@link RouteContribution.projectScoped} for the
+   * authenticated scopes; a `'public'` page MUST also declare
+   * `access: 'public'` (enforced at define time).
+   */
+  readonly scope?: RouteScope;
+  /**
+   * Access tier required to render the route. Defaults to `'member'`. A
+   * `'public'` page (scope `'public'`) MUST set this to `'public'`; a non-public
+   * page MUST NOT — both contradictions are rejected at define time.
    */
-  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.
+   * Whether the host wraps the page in its application shell. Defaults to
+   * `'host'`; `'none'` renders with no app rail, topbar, or org switcher.
    */
-  readonly weight?: number;
+  readonly chrome?: PageChrome;
+  /** Dynamic import of the page module (`() => import('./pages/X')`). */
+  readonly load: () => Promise<{ default: ComponentType<unknown> }>;
   /**
    * 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.
@@ -113,6 +123,47 @@ export interface DefineWebBiomeOptions {
   readonly outputRenderers?: FrontendBiome['outputRenderers'];
 }
 
+/** Default host-shell mode a page renders in when it omits `chrome`. */
+const DEFAULT_PAGE_CHROME: PageChrome = 'host';
+
+/**
+ * Reject the two `scope`/`access` contradictions at define time (module load,
+ * when the biome calls `defineWebBiome(...)` at its top level) — fail fast, do
+ * NOT silently coerce:
+ *
+ *   1. A `public` page with any `access` other than `'public'`: a public route
+ *      is un-authenticated, so a privilege tier is meaningless. The author must
+ *      set `access: 'public'` explicitly (an omitted `access` defaults to
+ *      `'member'`, which is exactly this contradiction).
+ *   2. A non-`public` page declaring `access: 'public'`: `'public'` is the
+ *      no-auth marker; an org/project route is always authenticated.
+ *
+ * `scope` defaults to `'org'` and `access` defaults to `'member'` for the
+ * purpose of this check, matching the emit defaults below.
+ */
+function assertPageScopeAccessLocked(biomeId: string, page: WebBiomePage): void {
+  const scope: RouteScope = page.scope ?? 'org';
+  const access: RouteAccess = page.access ?? 'member';
+  const where = `web biome '${biomeId}' page '${page.slug}'`;
+
+  if (scope === 'public' && access !== 'public') {
+    throw new Error(
+      `${where}: a 'public' scope page MUST declare access: 'public' ` +
+        `(got access: '${access}'). A public route is un-authenticated, so an ` +
+        `authenticated privilege tier is a contradiction. Set access: 'public' ` +
+        `or change the scope.`,
+    );
+  }
+  if (scope !== 'public' && access === 'public') {
+    throw new Error(
+      `${where}: access: 'public' is only valid on a 'public' scope page ` +
+        `(got scope: '${scope}'). '${access}' is the no-auth marker; an ` +
+        `org/project route is always authenticated. Set scope: 'public' or ` +
+        `change the access tier.`,
+    );
+  }
+}
+
 /**
  * Build the `FrontendBiomeFactory` a web biome default-exports. See the
  * module doc-comment for the rationale and an example.
@@ -120,6 +171,13 @@ export interface DefineWebBiomeOptions {
 export function defineWebBiome(
   options: DefineWebBiomeOptions,
 ): FrontendBiomeFactory {
+  // Validate every page's scope/access pairing NOW, at module load, so a
+  // contradiction surfaces the instant the biome module is imported — not
+  // lazily when the host first calls the factory.
+  for (const page of options.pages) {
+    assertPageScopeAccessLocked(options.id, page);
+  }
+
   return () => {
     const navItems: NavItemContribution[] = [];
     const routes: RouteContribution[] = [];
@@ -129,17 +187,20 @@ export function defineWebBiome(
         path: page.slug,
         projectScoped: page.scope === 'project',
         element: lazyRoute(page.load),
+        chrome: page.chrome ?? DEFAULT_PAGE_CHROME,
         ...(page.access ? { access: page.access } : {}),
       });
 
-      if (!page.navHidden) {
+      // Public routes mount OUTSIDE the authenticated group and never belong in
+      // the authenticated app rail — so they contribute no nav item regardless
+      // of `navHidden`. Authenticated pages emit a nav item unless hidden.
+      if (!page.navHidden && page.scope !== 'public') {
         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 } : {}),
         });
       }
     }

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

@@ -33,22 +33,10 @@ export interface NavItemContribution {
    * 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`.
+   * editing every biome. When omitted, the host falls back to its own
+   * taxonomy (keyed on the nav-item id).
    */
   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;
-  /**
-   * @deprecated Legacy intra-section sort weight. Ordering is host-owned per
-   * category now. Retained only for un-migrated biomes.
-   */
-  readonly weight?: number;
 }
 
 /**
@@ -56,8 +44,42 @@ export interface NavItemContribution {
  * declaratively — nav-hide is NOT a security boundary, a deeplink bypasses it.
  * Precedence (least → most privileged): `member` < `org-admin` <
  * `platform-admin`. Defaults to `member` when a route omits the field.
+ *
+ * `public` is NOT a privilege tier — it is the *no-auth* marker: a `public`
+ * route requires no Keycloak session at all and mounts OUTSIDE the host's
+ * authenticated route group. It is value-locked to `RouteScope` `'public'`
+ * (`defineWebBiome` rejects any other pairing at define time), so a route is
+ * public in BOTH senses or in neither. Closed set — a new member is a
+ * one-line change here and one `case` in the host resolver's exhaustive
+ * `hasRouteAccess` switch.
+ */
+export type RouteAccess = 'member' | 'org-admin' | 'platform-admin' | 'public';
+
+/**
+ * Where a route mounts in the host's URL/auth topology. Closed set — adding a
+ * member is a one-line change here (and the single mapping in `defineWebBiome`
+ * plus one resolver partition in the host).
+ *
+ * - `org` — mounts at the org root, inside the authenticated group.
+ * - `project` — mounts under the project-scoped route prefix, inside the
+ *   authenticated group.
+ * - `public` — mounts OUTSIDE the authenticated group; no Keycloak session,
+ *   no login redirect, no org switcher. Locked to `RouteAccess` `'public'`.
+ */
+export type RouteScope = 'org' | 'project' | 'public';
+
+/**
+ * Whether a page renders wrapped in the host application shell (app rail,
+ * topbar, org switcher) or standalone. Closed set — a new member is a one-line
+ * change here. Defaults to `'host'` when a page omits it.
+ *
+ * - `host` — the default; the host renders its chrome around the page.
+ * - `none` — the host renders the page with NO app rail, topbar, or org
+ *   switcher (a full-bleed surface). `public` routes are structurally
+ *   chromeless (their route group ships no shell); `none` also lets an
+ *   authenticated route opt out of the shell.
  */
-export type RouteAccess = 'member' | 'org-admin' | 'platform-admin';
+export type PageChrome = 'host' | 'none';
 
 export interface RouteContribution {
   /** React-router path. May include params. */
@@ -75,9 +97,16 @@ export interface RouteContribution {
   readonly projectScoped: boolean;
   /**
    * Access tier required to render this route. The host resolver enforces it
-   * declaratively. Defaults to `'member'` when omitted.
+   * declaratively. Defaults to `'member'` when omitted. `'public'` marks a
+   * no-auth route the host mounts outside its authenticated group.
    */
   readonly access?: RouteAccess;
+  /**
+   * Whether the host wraps this route in its application shell. Defaults to
+   * `'host'` when omitted; `'none'` renders the page with no app rail,
+   * topbar, or org switcher. See {@link PageChrome}.
+   */
+  readonly chrome?: PageChrome;
 }
 
 /**
@@ -194,7 +223,7 @@ export interface OutputRendererContribution {
  *
  * This factory shape keeps biome code free of any direct dependency
  * on host-shell primitives (router, auth client, toast library), which
- * is what allows the same biome package to load into a Vite SPA host
- * today and a Next.js host tomorrow.
+ * is what allows the same biome package to load into one host runtime
+ * today and a different host runtime tomorrow.
  */
 export type FrontendBiomeFactory = (bridge: HostBridge) => FrontendBiome;

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

@@ -5,6 +5,7 @@ import { createContext, useContext, type ReactNode } from 'react';
 import type { CapabilityPort } from '../capabilities';
 import type { SystemBus } from '../system-bus';
 
+import type { I18nSource } from './i18n-port';
 import type { RealtimeSource } from './realtime-port';
 
 /**
@@ -235,6 +236,18 @@ export interface HostBridge {
    * actionable error if a biome uses them before the host wires `bridge.realtime`.
    */
   readonly realtime?: RealtimeSource;
+  /**
+   * Localization port. The HOST injects a concrete {@link I18nSource} backed by
+   * its locale provider (authoritative locale from org/app/user settings +
+   * catalog loading); biomes reach it through the kernel `useT` / `useLocale`
+   * hooks so biome code never imports an i18n library directly — same decoupling
+   * as `navigation` / `realtime`.
+   *
+   * OPTIONAL: a host without localization omits it; the kernel `useT`/`useLocale`
+   * hooks fail fast with an actionable error if a biome uses them before the host
+   * wires `bridge.i18n`.
+   */
+  readonly i18n?: I18nSource;
   /**
    * Error-decoding surface — the canonical user-facing error decoder. Defaults
    * (in the kernel default bridge wiring) to {@link getUserFacingErrorMessage};