@xemahq/ui-kernel 0.6.0 → 0.6.1

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.6.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

@@ -44,8 +44,10 @@ import type {
   FrontendBiome,
   FrontendBiomeFactory,
   NavItemContribution,
+  PageChrome,
   RouteAccess,
   RouteContribution,
+  RouteScope,
 } from './frontend-biome';
 import type { ComponentType } from 'react';
 
@@ -75,11 +77,24 @@ export interface WebBiomePage {
   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;
+  /**
+   * Whether the host wraps the page in its application shell. Defaults to
+   * `'host'`; `'none'` renders with no app rail, topbar, or org switcher.
+   */
+  readonly chrome?: PageChrome;
   /** Dynamic import of the page module (`() => import('./pages/X')`). */
   readonly load: () => Promise<{ default: ComponentType<unknown> }>;
   /**
@@ -108,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.
@@ -115,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[] = [];
@@ -124,10 +187,14 @@ 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,

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

@@ -44,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 RouteAccess = 'member' | 'org-admin' | 'platform-admin';
+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 PageChrome = 'host' | 'none';
 
 export interface RouteContribution {
   /** React-router path. May include params. */
@@ -63,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;
 }
 
 /**
@@ -182,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};

package/src/lib/biome-host/i18n-hooks.ts

@@ -0,0 +1,50 @@
+/**
+ * Kernel-side i18n hooks. Biomes call these INSTEAD of importing an i18n library
+ * or the host's locale provider directly, so biome code stays decoupled from the
+ * i18n implementation — the same decoupling `useHostBridge` provides for
+ * navigation / auth / realtime / capabilities.
+ *
+ * Each hook reads the host-injected {@link I18nSource} off `bridge.i18n` and
+ * delegates straight through. The host owns the authoritative locale + catalog
+ * loading; the kernel owns only the contract + this thin delegation.
+ */
+
+import { useHostBridge } from './host-bridge';
+import type { I18nSource, Translator } from './i18n-port';
+
+/**
+ * Resolve the host-injected i18n source, failing fast with an actionable message
+ * if the host has not wired `bridge.i18n`. `bridge.i18n` is an optional port (a
+ * host without localization omits it), so the kernel hooks must not silently
+ * no-op — a biome that calls them expects translated copy.
+ */
+function requireI18n(i18n: I18nSource | undefined): I18nSource {
+  if (!i18n) {
+    throw new Error(
+      'useT/useLocale require an i18n source, but the host has not wired ' +
+        '`bridge.i18n`. The host must provide an I18nSource (locale + catalogs) ' +
+        'on the HostBridge to use kernel i18n hooks.',
+    );
+  }
+  return i18n;
+}
+
+/**
+ * A {@link Translator} for the active locale, scoped to an optional namespace.
+ * Call at render; the returned `t(key, params?)` interpolates `{name}` tokens.
+ *
+ * @example
+ *   const t = useT('radar');
+ *   return <h1>{t('title')}</h1>;              // radar.title
+ *   return <p>{t('greeting', { name })}</p>;   // "Hello, {name}"
+ */
+export function useT(namespace?: string): Translator {
+  const bridge = useHostBridge();
+  return requireI18n(bridge.i18n).useTranslator(namespace);
+}
+
+/** The active BCP-47 locale tag (e.g. `"pt-PT"`) for date/number formatting. */
+export function useLocale(): string {
+  const bridge = useHostBridge();
+  return requireI18n(bridge.i18n).useLocale();
+}

package/src/lib/biome-host/i18n-port.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+
+import { makeTranslator } from './i18n-port';
+
+const en = {
+  title: 'Dashboard',
+  greeting: 'Hello, {name}',
+  radar: { title: 'Radar', empty: 'No leads yet' },
+} as const;
+
+describe('makeTranslator', () => {
+  it('resolves flat and nested dot-path keys', () => {
+    const t = makeTranslator(en);
+    expect(t('title')).toBe('Dashboard');
+    expect(t('radar.title')).toBe('Radar');
+  });
+
+  it('interpolates {name} placeholders', () => {
+    const t = makeTranslator(en);
+    expect(t('greeting', { name: 'Ada' })).toBe('Hello, Ada');
+  });
+
+  it('leaves an unknown placeholder verbatim (visible authoring bug)', () => {
+    const t = makeTranslator({ msg: 'Hi {who}' });
+    expect(t('msg', {})).toBe('Hi {who}');
+  });
+
+  it('applies a namespace prefix', () => {
+    const t = makeTranslator(en, { namespace: 'radar' });
+    expect(t('title')).toBe('Radar');
+    expect(t('empty')).toBe('No leads yet');
+  });
+
+  it('returns the raw key for a missing message (never blank, never throws)', () => {
+    const t = makeTranslator(en);
+    expect(t('does.not.exist')).toBe('does.not.exist');
+  });
+
+  it('falls back message-by-message to the default-locale catalog', () => {
+    const pt = { title: 'Painel' }; // partial locale — no greeting
+    const t = makeTranslator(pt, { fallback: en });
+    expect(t('title')).toBe('Painel'); // primary wins
+    expect(t('greeting', { name: 'Ada' })).toBe('Hello, Ada'); // fallback fills the gap
+  });
+
+  it('coerces numeric params to strings', () => {
+    const t = makeTranslator({ count: '{n} items' });
+    expect(t('count', { n: 3 })).toBe('3 items');
+  });
+});