@xemahq/ui-kernel 0.11.0 → 0.11.1

package/dist/ui/chrome/page-shell.d.ts

@@ -22,6 +22,6 @@ interface PageShellProps {
     backTo?: PageBackTarget;
     topbarActions?: ReactNode;
 }
-export default function PageShell({ icon: _Icon, title, description, children, actions, tabs, activeTab, onTabChange, maxWidth, embedded, eyebrow, backTo, topbarActions, }: Readonly<PageShellProps>): import("react").JSX.Element;
+export default function PageShell(props: Readonly<PageShellProps>): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=page-shell.d.ts.map

package/dist/ui/chrome/page-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-shell.d.ts","sourceRoot":"","sources":["../../../src/ui/chrome/page-shell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,UAAU,MAAM;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,MAAM,CAAC,EAAE,cAAc,CAAC;IAOxB,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAQD,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,IAAI,EAAE,KAAK,EACX,KAAK,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,MAAM,EACN,aAAa,GACd,EAAE,QAAQ,CAAC,cAAc,CAAC,+BA+H1B"}
+{"version":3,"file":"page-shell.d.ts","sourceRoot":"","sources":["../../../src/ui/chrome/page-shell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,UAAU,MAAM;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,MAAM,CAAC,EAAE,cAAc,CAAC;IAOxB,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAsBD,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,+BAMhE"}

package/dist/ui/chrome/page-shell.js

@@ -3,7 +3,15 @@ import { FileQuestion } from 'lucide-react';
 import EmptyState from './EmptyState';
 import { useHostBridge } from '../../lib/biome-host';
 import { Tabs, TabsList, TabsTrigger } from '../primitives/tabs';
-export default function PageShell({ icon: _Icon, title, description, children, actions, tabs, activeTab, onTabChange, maxWidth, embedded, eyebrow, backTo, topbarActions, }) {
+export default function PageShell(props) {
+    return props.embedded ? (_jsx(EmbeddedPageShell, { ...props })) : (_jsx(FullPageShell, { ...props }));
+}
+function EmbeddedPageShell({ children, actions, tabs, activeTab, onTabChange, }) {
+    {
+        return (_jsxs("div", { className: "flex h-full min-h-0 flex-col bg-paper", children: [(tabs && tabs.length > 0) || actions ? (_jsx("div", { className: "shrink-0 border-b border-rule bg-paper-elev/40", children: _jsxs("div", { className: "flex items-center gap-3 px-4 py-2 lg:px-6", children: [tabs && tabs.length > 0 && (_jsx(Tabs, { value: activeTab, onValueChange: onTabChange, className: "flex-1 min-w-0", children: _jsx("div", { className: "overflow-x-auto", children: _jsx(TabsList, { className: "h-7 bg-transparent p-0 gap-0", children: tabs.map((tab) => (_jsxs(TabsTrigger, { value: tab.value, className: "rounded-none border-b-2 border-transparent px-2 py-1 text-body-2 font-medium text-ink-3 transition-colors data-[state=active]:border-primary data-[state=active]:text-ink data-[state=active]:bg-transparent data-[state=active]:shadow-none", children: [tab.label, tab.count !== undefined && (_jsx("span", { className: "ml-1.5 text-caption tabular-nums opacity-70", children: tab.count })), tab.indicator && (_jsx("span", { className: "ml-1.5 inline-block h-1.5 w-1.5 rounded-full bg-warning" }))] }, tab.value))) }) }) })), !tabs && _jsx("div", { className: "flex-1" }), actions && (_jsx("div", { className: "flex items-center gap-2 shrink-0", children: actions }))] }) })) : null, _jsx("div", { className: "flex-1 overflow-auto min-h-0", children: _jsx("div", { className: "flex h-full min-h-0 flex-col px-4 pb-4 pt-3 lg:px-6", children: children }) })] }));
+    }
+}
+function FullPageShell({ title, description, children, actions, tabs, activeTab, onTabChange, maxWidth, eyebrow, backTo, topbarActions, }) {
     useHostBridge().pageMeta.usePageMeta({
         title,
         description,
@@ -11,9 +19,6 @@ export default function PageShell({ icon: _Icon, title, description, children, a
         backTo,
         topbarActions,
     });
-    if (embedded) {
-        return (_jsxs("div", { className: "flex h-full min-h-0 flex-col bg-paper", children: [(tabs && tabs.length > 0) || actions ? (_jsx("div", { className: "shrink-0 border-b border-rule bg-paper-elev/40", children: _jsxs("div", { className: "flex items-center gap-3 px-4 py-2 lg:px-6", children: [tabs && tabs.length > 0 && (_jsx(Tabs, { value: activeTab, onValueChange: onTabChange, className: "flex-1 min-w-0", children: _jsx("div", { className: "overflow-x-auto", children: _jsx(TabsList, { className: "h-7 bg-transparent p-0 gap-0", children: tabs.map((tab) => (_jsxs(TabsTrigger, { value: tab.value, className: "rounded-none border-b-2 border-transparent px-2 py-1 text-body-2 font-medium text-ink-3 transition-colors data-[state=active]:border-primary data-[state=active]:text-ink data-[state=active]:bg-transparent data-[state=active]:shadow-none", children: [tab.label, tab.count !== undefined && (_jsx("span", { className: "ml-1.5 text-caption tabular-nums opacity-70", children: tab.count })), tab.indicator && (_jsx("span", { className: "ml-1.5 inline-block h-1.5 w-1.5 rounded-full bg-warning" }))] }, tab.value))) }) }) })), !tabs && _jsx("div", { className: "flex-1" }), actions && (_jsx("div", { className: "flex items-center gap-2 shrink-0", children: actions }))] }) })) : null, _jsx("div", { className: "flex-1 overflow-auto min-h-0", children: _jsx("div", { className: "flex h-full min-h-0 flex-col px-4 pb-4 pt-3 lg:px-6", children: children }) })] }));
-    }
     return (_jsxs("div", { className: `flex h-full min-h-0 flex-col ${maxWidth ?? ''}`, children: [(tabs || actions) && (_jsx("div", { className: "shrink-0 border-b border-border/50 px-4 sm:px-5 lg:px-8", children: _jsxs("div", { className: "flex min-h-[34px] flex-col gap-2 py-1.5 sm:flex-row sm:items-center sm:gap-3 sm:py-0", children: [tabs && tabs.length > 0 && (_jsx(Tabs, { value: activeTab, onValueChange: onTabChange, className: "flex-1 min-w-0", children: _jsx("div", { className: "overflow-x-auto", children: _jsx(TabsList, { className: "h-7 bg-transparent p-0 gap-0", children: tabs.map((tab) => (_jsxs(TabsTrigger, { value: tab.value, className: "whitespace-nowrap rounded-none border-b-2 border-transparent px-2.5 py-1.5 text-caption font-medium text-ink-3/90 transition-colors data-[state=active]:border-primary data-[state=active]:bg-transparent data-[state=active]:text-ink data-[state=active]:shadow-none hover:text-ink", children: [tab.label, tab.count !== undefined && (_jsx("span", { className: "ml-1.5 text-caption tabular-nums opacity-60", children: tab.count })), tab.indicator && (_jsx("span", { className: "ml-1.5 inline-block h-1.5 w-1.5 rounded-full bg-warning" }))] }, tab.value))) }) }) })), !tabs && _jsx("div", { className: "flex-1" }), actions && (_jsx("div", { className: "flex w-full flex-wrap items-center gap-2 sm:w-auto sm:shrink-0 sm:justify-end", children: actions }))] }) })), _jsx("div", { className: "flex min-h-0 flex-1 flex-col overflow-auto px-4 pb-5 pt-4 sm:px-6 sm:pb-6 sm:pt-5", children: children || (_jsx(EmptyState, { icon: FileQuestion, title: "Nothing to show yet", description: "This page has no content to display. Check back once the workspace has data." })) })] }));
 }
 //# sourceMappingURL=page-shell.js.map

package/dist/ui/chrome/page-shell.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "type": "module",
   "sideEffects": false,
   "description": "Host-framework-agnostic UI kernel for the Xema OS. Defines the SystemBus orchestration contract (capability.invoke, cross-biome intents, command palette, xema:// deeplinks, window manager) AND the biome-host contract surface (FrontendBiome/FrontendBiomeFactory, HostBridge, the singleton biomeRegistry, session contributions) that every frontend biome composes against. No Vite, Next.js, or React-Router — React itself IS allowed as the shared component model (the contracts traffic in ReactNode/ComponentType and a React context). Concrete host adapters (router/auth/toast wiring) live in separate packages that consume this kernel. The SystemBus is pure orchestration: it never authorizes, the backend capability-router enforces all policy.",
@@ -74,10 +74,13 @@
     "@tanstack/react-query": "^5.100.13",
     "@types/node": "25.2.3",
     "@types/react": "^18.3.30",
+    "@types/react-dom": "^18.3.7",
+    "@xemahq/kernel-contracts": "^8.0.0",
     "prettier": "3.6.2",
     "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^5.0.0"
+    "vitest": "^3.2.4"
   },
   "exports": {
     ".": {
@@ -109,7 +112,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.'",
+    "test": "echo '[ui-kernel] *.{test,spec} files RUN under host-web vitest (this package has no vitest runner config). vitest is a devDependency here for TYPES only, so tsc typechecks the specs in the repo that owns them.'",
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "lint": "eslint .",
     "typecheck": "tsc -p tsconfig.lint.json --noEmit"

package/src/ui/chrome/page-shell.spec.tsx

@@ -0,0 +1,117 @@
+/**
+ * An EMBEDDED PageShell must not touch the topbar.
+ *
+ * ── THE DEFECT ────────────────────────────────────────────────────────────
+ *
+ * `embedded` means "the host page already owns the topbar — render only my
+ * body". But `usePageMeta` was called UNCONDITIONALLY, above the `embedded`
+ * check, and the page-meta store is a STACK: "nested pages can push their own
+ * meta; on unmount the outer meta is restored".
+ *
+ * So an embedded shell pushed its own `title`, `description`, `eyebrow`,
+ * `backTo` and `topbarActions` OVER its host's — the precise opposite of what
+ * embedding means. The host's title and back button silently became the
+ * child's for as long as the child was mounted, and the page-meta contract
+ * ("never render a back button inside the page body… move it into
+ * usePageMeta") made that the ONLY back affordance on screen, so it pointed at
+ * the wrong parent.
+ *
+ * A hook cannot be called conditionally, so the fix is structural: `PageShell`
+ * calls no hooks and only chooses between two components. These tests pin the
+ * OBSERVABLE property — whether meta is registered — not the file layout, so
+ * any future refactor that reintroduces the push fails them.
+ *
+ * Runs under the host-web vitest mirror (this package carries no vitest dep).
+ */
+import { FileQuestion } from 'lucide-react';
+import { renderToStaticMarkup } from 'react-dom/server';
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+
+
+const registered: unknown[] = [];
+
+// The kernel reaches the page-meta store through the HostBridge singleton,
+// never a host import — so the bridge is the seam to observe.
+vi.mock('../../lib/biome-host/host-bridge', async () => {
+  const actual = await vi.importActual<Record<string, unknown>>(
+    '../../lib/biome-host/host-bridge',
+  );
+  return {
+    ...actual,
+    useHostBridge: () => ({
+      pageMeta: {
+        usePageMeta: (meta: unknown) => {
+          registered.push(meta);
+        },
+      },
+    }),
+  };
+});
+
+const { default: PageShell } = await import('./page-shell');
+
+beforeEach(() => {
+  registered.length = 0;
+});
+
+const META = {
+  icon: FileQuestion,
+  title: 'Child Title',
+  description: 'Child description',
+  eyebrow: 'Child eyebrow',
+  backTo: { to: '/child-parent', label: 'Child parent' },
+} as const;
+
+describe('PageShell page-meta ownership', () => {
+  it('registers NOTHING when embedded — the host owns the topbar', () => {
+    // THE BUG, directly. Before the fix this registered the child's meta,
+    // replacing the host's title and back button on a stack-based store.
+    renderToStaticMarkup(
+      <PageShell {...META} embedded>
+        <p>body</p>
+      </PageShell>,
+    );
+    expect(registered).toEqual([]);
+  });
+
+  it('registers its meta when NOT embedded — a full page owns its topbar', () => {
+    // The other half: the fix must not silence the normal case.
+    renderToStaticMarkup(
+      <PageShell {...META}>
+        <p>body</p>
+      </PageShell>,
+    );
+    expect(registered).toHaveLength(1);
+    expect(registered[0]).toMatchObject({
+      title: 'Child Title',
+      description: 'Child description',
+      eyebrow: 'Child eyebrow',
+      backTo: { to: '/child-parent' },
+    });
+  });
+
+  it('still renders the embedded body — not registering is not "render nothing"', () => {
+    const html = renderToStaticMarkup(
+      <PageShell {...META} embedded>
+        <p>embedded-body-marker</p>
+      </PageShell>,
+    );
+    expect(html).toContain('embedded-body-marker');
+  });
+
+  it('renders the embedded sub-tab strip, which is the child’s own chrome', () => {
+    // Embedding suppresses the TOPBAR meta, not the child's in-body tabs.
+    const html = renderToStaticMarkup(
+      <PageShell
+        {...META}
+        embedded
+        tabs={[{ value: 'a', label: 'Alpha' }]}
+        activeTab="a"
+      >
+        <p>body</p>
+      </PageShell>,
+    );
+    expect(html).toContain('Alpha');
+    expect(registered).toEqual([]);
+  });
+});

package/src/ui/chrome/page-shell.tsx

@@ -44,37 +44,41 @@ interface PageShellProps {
  * page-meta store) and renders an optional tab strip + action row above the
  * scrollable content canvas. Host-framework-agnostic: reaches the page-meta
  * store through the kernel `HostBridge` singleton, never a host import.
+ *
+ * ── WHY THIS DISPATCHES INSTEAD OF BRANCHING ──────────────────────────────
+ *
+ * `embedded` means "the host page already owns the topbar — render only my
+ * body". But `usePageMeta` used to be called UNCONDITIONALLY, above the
+ * `embedded` check, and the page-meta store is a STACK ("nested pages can push
+ * their own meta; on unmount the outer meta is restored"). So an embedded shell
+ * pushed its own title, description, eyebrow, backTo and topbarActions OVER its
+ * host's — the precise opposite of what embedding means. The host's back button
+ * and title silently became the child's for as long as the child was mounted.
+ *
+ * A hook cannot be called conditionally, so the fix is structural: this
+ * component calls NO hooks and only chooses. The embedded variant never reaches
+ * the page-meta hook because it is a different component, not a later branch.
  */
-export default function PageShell({
-  icon: _Icon,
-  title,
-  description,
+export default function PageShell(props: Readonly<PageShellProps>) {
+  return props.embedded ? (
+    <EmbeddedPageShell {...props} />
+  ) : (
+    <FullPageShell {...props} />
+  );
+}
+
+/**
+ * Embedded body. Registers NO page meta — the host page owns the topbar.
+ * Renders only the child content plus an optional sub-tab strip + actions.
+ */
+function EmbeddedPageShell({
   children,
   actions,
   tabs,
   activeTab,
   onTabChange,
-  maxWidth,
-  embedded,
-  eyebrow,
-  backTo,
-  topbarActions,
 }: Readonly<PageShellProps>) {
-  // Single source of truth for the topbar title. Pages that bypass
-  // PageShell call the page-meta hook directly; PageShell wraps the same
-  // hook so consumers don't need to register meta twice.
-  useHostBridge().pageMeta.usePageMeta({
-    title,
-    description,
-    eyebrow,
-    backTo,
-    topbarActions,
-  });
-  if (embedded) {
-    // Embedded mode: the host page already provides the title + tabs +
-    // context, so we render ONLY the child content + any sub-tab strip +
-    // actions inline. This eliminates the legacy duplicate icon-and-title
-    // row that previously stole vertical space.
+  {
     return (
       <div className="flex h-full min-h-0 flex-col bg-paper">
         {(tabs && tabs.length > 0) || actions ? (
@@ -126,6 +130,34 @@ export default function PageShell({
       </div>
     );
   }
+}
+
+/**
+ * Full page. Owns the topbar meta for the route it renders.
+ */
+function FullPageShell({
+  title,
+  description,
+  children,
+  actions,
+  tabs,
+  activeTab,
+  onTabChange,
+  maxWidth,
+  eyebrow,
+  backTo,
+  topbarActions,
+}: Readonly<PageShellProps>) {
+  // Single source of truth for the topbar title. Pages that bypass
+  // PageShell call the page-meta hook directly; PageShell wraps the same
+  // hook so consumers don't need to register meta twice.
+  useHostBridge().pageMeta.usePageMeta({
+    title,
+    description,
+    eyebrow,
+    backTo,
+    topbarActions,
+  });
 
   return (
     <div className={`flex h-full min-h-0 flex-col ${maxWidth ?? ''}`}>