@xemahq/ui-kernel 0.3.0 → 0.4.0

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

@@ -0,0 +1,22 @@
+import type { FrontendBiome } from './frontend-biome';
+export declare enum CompositionDiagnosticSeverity {
+    Error = "error",
+    Warning = "warning"
+}
+export declare enum CompositionDiagnosticCode {
+    DuplicateRoutePath = "duplicate_route_path",
+    DuplicateNavId = "duplicate_nav_id",
+    UnknownSlot = "unknown_slot",
+    OrphanedPanelSlot = "orphaned_panel_slot"
+}
+export interface CompositionDiagnostic {
+    readonly code: CompositionDiagnosticCode;
+    readonly severity: CompositionDiagnosticSeverity;
+    readonly biomeIds: readonly string[];
+    readonly message: string;
+}
+export interface ValidateBiomeCompositionOptions {
+    readonly knownSlots: ReadonlySet<string>;
+}
+export declare function validateBiomeComposition(biomes: readonly FrontendBiome[], options: ValidateBiomeCompositionOptions): readonly CompositionDiagnostic[];
+//# sourceMappingURL=composition-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composition-validation.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/composition-validation.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,oBAAY,6BAA6B;IAMvC,KAAK,UAAU;IAOf,OAAO,YAAY;CACpB;AAGD,oBAAY,yBAAyB;IAEnC,kBAAkB,yBAAyB;IAE3C,cAAc,qBAAqB;IAKnC,WAAW,iBAAiB;IAK5B,iBAAiB,wBAAwB;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;IAEjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAM9C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1C;AAwBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,OAAO,EAAE,+BAA+B,GACvC,SAAS,qBAAqB,EAAE,CA6FlC"}

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

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositionDiagnosticCode = exports.CompositionDiagnosticSeverity = void 0;
+exports.validateBiomeComposition = validateBiomeComposition;
+var CompositionDiagnosticSeverity;
+(function (CompositionDiagnosticSeverity) {
+    CompositionDiagnosticSeverity["Error"] = "error";
+    CompositionDiagnosticSeverity["Warning"] = "warning";
+})(CompositionDiagnosticSeverity || (exports.CompositionDiagnosticSeverity = CompositionDiagnosticSeverity = {}));
+var CompositionDiagnosticCode;
+(function (CompositionDiagnosticCode) {
+    CompositionDiagnosticCode["DuplicateRoutePath"] = "duplicate_route_path";
+    CompositionDiagnosticCode["DuplicateNavId"] = "duplicate_nav_id";
+    CompositionDiagnosticCode["UnknownSlot"] = "unknown_slot";
+    CompositionDiagnosticCode["OrphanedPanelSlot"] = "orphaned_panel_slot";
+})(CompositionDiagnosticCode || (exports.CompositionDiagnosticCode = CompositionDiagnosticCode = {}));
+function biomeOwnedSlotOwner(slot) {
+    const slashIndex = slot.indexOf('/');
+    if (slashIndex <= 0)
+        return null;
+    if (slot.indexOf('/', slashIndex + 1) !== -1)
+        return null;
+    const owner = slot.slice(0, slashIndex);
+    const name = slot.slice(slashIndex + 1);
+    if (owner.length === 0 || name.length === 0)
+        return null;
+    return owner;
+}
+function validateBiomeComposition(biomes, options) {
+    const diagnostics = [];
+    const biomeIds = new Set(biomes.map((b) => b.id));
+    const routeOwners = new Map();
+    for (const biome of biomes) {
+        for (const route of biome.routes ?? []) {
+            const scope = route.projectScoped ? 'project' : 'root';
+            const key = `${scope}:${route.path}`;
+            const owners = routeOwners.get(key);
+            if (owners)
+                owners.push(biome.id);
+            else
+                routeOwners.set(key, [biome.id]);
+        }
+    }
+    for (const [key, owners] of routeOwners) {
+        if (owners.length < 2)
+            continue;
+        const [scope, path] = splitFirst(key, ':');
+        diagnostics.push({
+            code: CompositionDiagnosticCode.DuplicateRoutePath,
+            severity: CompositionDiagnosticSeverity.Error,
+            biomeIds: owners,
+            message: `Route path '${path}' (${scope}-scoped) is contributed by multiple biomes: ` +
+                `${owners.join(', ')}. Each route must be unique within its scope — ` +
+                `only one would mount and the others would be unreachable.`,
+        });
+    }
+    const navOwners = new Map();
+    for (const biome of biomes) {
+        for (const navItem of biome.navItems ?? []) {
+            const owners = navOwners.get(navItem.id);
+            if (owners)
+                owners.push(biome.id);
+            else
+                navOwners.set(navItem.id, [biome.id]);
+        }
+    }
+    for (const [navId, owners] of navOwners) {
+        if (owners.length < 2)
+            continue;
+        diagnostics.push({
+            code: CompositionDiagnosticCode.DuplicateNavId,
+            severity: CompositionDiagnosticSeverity.Error,
+            biomeIds: owners,
+            message: `Nav id '${navId}' is contributed by multiple biomes: ${owners.join(', ')}. ` +
+                `Nav ids must be unique — a duplicate silently overwrites the ` +
+                `feature-route mapping and collides as a render key.`,
+        });
+    }
+    for (const biome of biomes) {
+        for (const panel of biome.panels ?? []) {
+            if (options.knownSlots.has(panel.slot))
+                continue;
+            const owner = biomeOwnedSlotOwner(panel.slot);
+            if (owner === null) {
+                diagnostics.push({
+                    code: CompositionDiagnosticCode.UnknownSlot,
+                    severity: CompositionDiagnosticSeverity.Warning,
+                    biomeIds: [biome.id],
+                    message: `Biome '${biome.id}' panel '${panel.id}' targets slot '${panel.slot}', ` +
+                        `which is neither a known host slot nor a well-formed ` +
+                        `'<owner>/<name>' biome-owned slot. It will never render — ` +
+                        `check for a typo against the host slot catalog.`,
+                });
+                continue;
+            }
+            if (!biomeIds.has(owner)) {
+                diagnostics.push({
+                    code: CompositionDiagnosticCode.OrphanedPanelSlot,
+                    severity: CompositionDiagnosticSeverity.Warning,
+                    biomeIds: [biome.id],
+                    message: `Biome '${biome.id}' panel '${panel.id}' targets biome-owned slot ` +
+                        `'${panel.slot}', but its owner biome '${owner}' is not registered. ` +
+                        `The panel will never render until '${owner}' is enabled.`,
+                });
+            }
+        }
+    }
+    return sortDiagnostics(diagnostics);
+}
+function splitFirst(value, sep) {
+    const idx = value.indexOf(sep);
+    if (idx === -1)
+        return [value, ''];
+    return [value.slice(0, idx), value.slice(idx + sep.length)];
+}
+function sortDiagnostics(diagnostics) {
+    return diagnostics.slice().sort((a, b) => {
+        if (a.code !== b.code)
+            return a.code.localeCompare(b.code);
+        const ai = a.biomeIds.join(',');
+        const bi = b.biomeIds.join(',');
+        if (ai !== bi)
+            return ai.localeCompare(bi);
+        return a.message.localeCompare(b.message);
+    });
+}
+//# sourceMappingURL=composition-validation.js.map

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

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

package/dist/lib/biome-host/define-web-biome.d.ts

@@ -0,0 +1,30 @@
+import type { FrontendBiome, FrontendBiomeFactory, RouteAccess } from './frontend-biome';
+import type { ComponentType } from 'react';
+export interface WebBiomePage {
+    readonly slug: string;
+    readonly id?: string;
+    readonly label: string;
+    readonly icon?: ComponentType<{
+        className?: string | undefined;
+    }>;
+    readonly category?: string;
+    readonly scope?: 'org' | 'project';
+    readonly access?: RouteAccess;
+    readonly load: () => Promise<{
+        default: ComponentType<unknown>;
+    }>;
+    readonly weight?: number;
+    readonly navHidden?: boolean;
+}
+export interface DefineWebBiomeOptions {
+    readonly id: string;
+    readonly displayName: string;
+    readonly init?: FrontendBiome['init'];
+    readonly dispose?: FrontendBiome['dispose'];
+    readonly pages: readonly WebBiomePage[];
+    readonly panels?: FrontendBiome['panels'];
+    readonly session?: FrontendBiome['session'];
+    readonly outputRenderers?: FrontendBiome['outputRenderers'];
+}
+export declare function defineWebBiome(options: DefineWebBiomeOptions): FrontendBiomeFactory;
+//# sourceMappingURL=define-web-biome.d.ts.map

package/dist/lib/biome-host/define-web-biome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-web-biome.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/define-web-biome.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAEpB,WAAW,EAEZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,WAAW,YAAY;IAM3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAOtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAMlE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAK3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAEnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAKlE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAKzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAE5C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAExC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE1C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAE5C,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CAC7D;AAMD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAuCtB"}

package/dist/lib/biome-host/define-web-biome.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineWebBiome = defineWebBiome;
+const biome_builders_1 = require("./biome-builders");
+function defineWebBiome(options) {
+    return () => {
+        const navItems = [];
+        const routes = [];
+        for (const page of options.pages) {
+            routes.push({
+                path: page.slug,
+                projectScoped: page.scope === 'project',
+                element: (0, biome_builders_1.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 }
+                : {}),
+        };
+    };
+}
+//# sourceMappingURL=define-web-biome.js.map

package/dist/lib/biome-host/define-web-biome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-web-biome.js","sourceRoot":"","sources":["../../../src/lib/biome-host/define-web-biome.ts"],"names":[],"mappings":";;AAuHA,wCAyCC;AAxHD,qDAA6C;AA+E7C,SAAgB,cAAc,CAC5B,OAA8B;IAE9B,OAAO,GAAG,EAAE;QACV,MAAM,QAAQ,GAA0B,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,aAAa,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS;gBACvC,OAAO,EAAE,IAAA,0BAAS,EAAC,IAAI,CAAC,IAAI,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI;oBACxB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ;YACR,MAAM;YACN,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,OAAO,CAAC,eAAe;gBACzB,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/biome-host/frontend-biome.d.ts

@@ -8,6 +8,7 @@ export interface NavItemContribution {
     readonly icon?: ComponentType<{
         className?: string | undefined;
     }>;
+    readonly category?: string;
     readonly section?: string;
     readonly weight?: number;
 }

package/dist/lib/biome-host/frontend-biome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-biome.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/frontend-biome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAYpE,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAQvB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAElE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IASlC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAKhC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAQD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,SAAS,CAAC;IAEjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAQ7B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAOhE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAO/C,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAexC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAClE;AAYD,MAAM,WAAW,0BAA0B;IAOzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAQ5B,QAAQ,CAAC,MAAM,EAAE,MAAM,aAAa,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpE;AAaD,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,aAAa,CAAC"}
+{"version":3,"file":"frontend-biome.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/frontend-biome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAYpE,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAQvB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAWlE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAM3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAK1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IASlC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAKhC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAQD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,SAAS,CAAC;IAEjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAQ7B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAOhE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAO/C,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAexC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAClE;AAYD,MAAM,WAAW,0BAA0B;IAOzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAQ5B,QAAQ,CAAC,MAAM,EAAE,MAAM,aAAa,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpE;AAaD,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,aAAa,CAAC"}

package/dist/lib/biome-host/index.d.ts

@@ -4,6 +4,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';

package/dist/lib/biome-host/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/index.ts"],"names":[],"mappings":"AAcA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/index.ts"],"names":[],"mappings":"AAcA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC"}

package/dist/lib/biome-host/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./biome-navigation"), exports);
 __exportStar(require("./biome-scope"), exports);
 __exportStar(require("./biome-scoped-query"), exports);
 __exportStar(require("./biome-builders"), exports);
+__exportStar(require("./define-web-biome"), exports);
 __exportStar(require("./create-biome-orval-config"), exports);
 __exportStar(require("./biome-registry"), exports);
 __exportStar(require("./session-contributions"), exports);

package/dist/lib/biome-host/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/biome-host/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAcA,mDAAiC;AACjC,gDAA8B;AAC9B,qDAAmC;AACnC,gDAA8B;AAC9B,uDAAqC;AACrC,mDAAiC;AACjC,8DAA4C;AAC5C,mDAAiC;AACjC,0DAAwC;AACxC,qDAAmC;AACnC,iDAA+B;AAC/B,wCAAsB;AACtB,+CAA6B;AAC7B,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,2CAAyB;AACzB,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/biome-host/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAcA,mDAAiC;AACjC,gDAA8B;AAC9B,qDAAmC;AACnC,gDAA8B;AAC9B,uDAAqC;AACrC,mDAAiC;AACjC,qDAAmC;AACnC,8DAA4C;AAC5C,mDAAiC;AACjC,0DAAwC;AACxC,qDAAmC;AACnC,iDAA+B;AAC/B,wCAAsB;AACtB,+CAA6B;AAC7B,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,2CAAyB;AACzB,sDAAoC"}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.3.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/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/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';

package/src/session/shell/SessionWorkspaceShell.tsx

@@ -1,4 +1,4 @@
-import type { ReactNode, MouseEvent, RefObject } from 'react';
+import type { CSSProperties, ReactNode, MouseEvent, RefObject } from 'react';
 
 import { cn } from '../lib/cn';
 
@@ -79,28 +79,34 @@ export function SessionWorkspaceShell({
   // surface (Document Buddy). Hide the right pane + resize handle and
   // let the chat pane occupy the full width.
   const hasPreviewSlot = previewSlot !== null;
+  // Below `lg` the two panes stack vertically (flex-col) and each takes the
+  // full width; the chat pane's fixed width / minWidth split only applies at
+  // `lg`+ where the resize handle is available. The width values ride on CSS
+  // variables so the inline style never forces a side-by-side split on a
+  // phone (Tailwind applies them only at the `lg` breakpoint).
+  const leftPaneStyle: CSSProperties | undefined = hasPreviewSlot
+    ? ({
+        '--sws-min-left': `${minLeftPaneWidth}px`,
+        '--sws-chat-pct': `${chatPanePercent}%`,
+      } as CSSProperties)
+    : undefined;
   return (
     <div
       ref={splitContainerRef}
       className={cn(
-        'relative flex h-full w-full overflow-hidden',
+        'relative flex h-full w-full flex-col overflow-hidden lg:flex-row',
         isResizing && 'cursor-col-resize',
       )}
     >
       {!previewFullscreen && (
         <div
           className={cn(
-            'flex h-full w-full flex-col overflow-hidden bg-paper',
-            hasPreviewSlot ? 'lg:flex-none' : '',
-          )}
-          style={
+            'flex w-full min-h-0 flex-col overflow-hidden bg-paper',
             hasPreviewSlot
-              ? {
-                  minWidth: `${minLeftPaneWidth}px`,
-                  width: `${chatPanePercent}%`,
-                }
-              : undefined
-          }
+              ? '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}
         >
           <div className="flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden">
             <div className="relative min-h-0 min-w-0 flex-1">{chatSlot}</div>
@@ -131,7 +137,7 @@ export function SessionWorkspaceShell({
       )}
 
       {hasPreviewSlot && (
-        <div className="flex min-w-0 flex-1 flex-col overflow-hidden bg-paper">
+        <div className="flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden bg-paper">
           {rightHeaderSlot}
           <div className="min-h-0 flex-1 overflow-hidden">{previewSlot}</div>
         </div>