@xemahq/ui-kernel 0.1.7 → 0.1.8

package/dist/lib/biome-host/agent-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=agent-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validation.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/agent-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/agent-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=agent-validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validation.js","sourceRoot":"","sources":["../../../src/lib/biome-host/agent-validation.ts"],"names":[],"mappings":";;;AAkGA,4DAgGC;AA1KD,IAAY,6BAcX;AAdD,WAAY,6BAA6B;IAMvC,gDAAe,CAAA;IAOf,oDAAmB,CAAA;AACrB,CAAC,EAdW,6BAA6B,6CAA7B,6BAA6B,QAcxC;AAGD,IAAY,yBAeX;AAfD,WAAY,yBAAyB;IAEnC,wEAA2C,CAAA;IAE3C,gEAAmC,CAAA;IAKnC,yDAA4B,CAAA;IAK5B,sEAAyC,CAAA;AAC3C,CAAC,EAfW,yBAAyB,yCAAzB,yBAAyB,QAepC;AA0BD,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,SAAgB,wBAAwB,CACtC,MAAgC,EAChC,OAAwC;IAExC,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAMlD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;YACvD,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;gBAC7B,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAChC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3C,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,yBAAyB,CAAC,kBAAkB;YAClD,QAAQ,EAAE,6BAA6B,CAAC,KAAK;YAC7C,QAAQ,EAAE,MAAM;YAChB,OAAO,EACL,eAAe,IAAI,MAAM,KAAK,8CAA8C;gBAC5E,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iDAAiD;gBACrE,2DAA2D;SAC9D,CAAC,CAAC;IACL,CAAC;IAMD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;gBAC7B,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAChC,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,yBAAyB,CAAC,cAAc;YAC9C,QAAQ,EAAE,6BAA6B,CAAC,KAAK;YAC7C,QAAQ,EAAE,MAAM;YAChB,OAAO,EACL,WAAW,KAAK,wCAAwC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC7E,+DAA+D;gBAC/D,qDAAqD;SACxD,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACjD,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,yBAAyB,CAAC,WAAW;oBAC3C,QAAQ,EAAE,6BAA6B,CAAC,OAAO;oBAC/C,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,OAAO,EACL,UAAU,KAAK,CAAC,EAAE,YAAY,KAAK,CAAC,EAAE,mBAAmB,KAAK,CAAC,IAAI,KAAK;wBACxE,uDAAuD;wBACvD,4DAA4D;wBAC5D,iDAAiD;iBACpD,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAID,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,yBAAyB,CAAC,iBAAiB;oBACjD,QAAQ,EAAE,6BAA6B,CAAC,OAAO;oBAC/C,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,OAAO,EACL,UAAU,KAAK,CAAC,EAAE,YAAY,KAAK,CAAC,EAAE,6BAA6B;wBACnE,IAAI,KAAK,CAAC,IAAI,2BAA2B,KAAK,uBAAuB;wBACrE,sCAAsC,KAAK,eAAe;iBAC7D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAGD,SAAS,UAAU,CAAC,KAAa,EAAE,GAAW;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAGD,SAAS,eAAe,CACtB,WAAoC;IAEpC,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -11,10 +11,12 @@ export interface NavItemContribution {
     readonly section?: string;
     readonly weight?: number;
 }
+export type RouteAccess = 'member' | 'org-admin' | 'platform-admin';
 export interface RouteContribution {
     readonly path: string;
     readonly element: () => ReactNode;
-    readonly projectScoped?: boolean;
+    readonly projectScoped: boolean;
+    readonly access?: RouteAccess;
 }
 export interface PanelContribution {
     readonly slot: string;

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;AAED,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAElC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;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;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"}

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

@@ -7,5 +7,5 @@ export * from './session-profiles';
 export * from './host-sources';
 export * from './nav';
 export * from './biome-mode';
-export * from './composition-validation';
+export * from './agent-validation';
 //# sourceMappingURL=index.d.ts.map

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,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,0BAA0B,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,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"}

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

@@ -23,5 +23,5 @@ __exportStar(require("./session-profiles"), exports);
 __exportStar(require("./host-sources"), exports);
 __exportStar(require("./nav"), exports);
 __exportStar(require("./biome-mode"), exports);
-__exportStar(require("./composition-validation"), exports);
+__exportStar(require("./agent-validation"), exports);
 //# sourceMappingURL=index.js.map

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,8DAA4C;AAC5C,mDAAiC;AACjC,0DAAwC;AACxC,qDAAmC;AACnC,iDAA+B;AAC/B,wCAAsB;AACtB,+CAA6B;AAC7B,2DAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/biome-host/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAcA,mDAAiC;AACjC,gDAA8B;AAC9B,8DAA4C;AAC5C,mDAAiC;AACjC,0DAAwC;AACxC,qDAAmC;AACnC,iDAA+B;AAC/B,wCAAsB;AACtB,+CAA6B;AAC7B,qDAAmC"}

package/dist/registry/index.d.ts

@@ -1,5 +1,5 @@
 export * from './lib/extension-points';
-export * from './lib/composition-validation-host';
+export * from './lib/agent-validation-host';
 export * from './lib/biome-slot';
 export * from './lib/biomes-enabled-context';
 export * from './lib/session-selectors';

package/dist/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}

package/dist/registry/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/extension-points"), exports);
-__exportStar(require("./lib/composition-validation-host"), exports);
+__exportStar(require("./lib/agent-validation-host"), exports);
 __exportStar(require("./lib/biome-slot"), exports);
 __exportStar(require("./lib/biomes-enabled-context"), exports);
 __exportStar(require("./lib/session-selectors"), exports);

package/dist/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,oEAAkD;AAClD,mDAAiC;AACjC,+DAA6C;AAC7C,0DAAwC;AACxC,gEAA8C;AAC9C,iEAA+C;AAC/C,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,8DAA4C;AAC5C,mDAAiC;AACjC,+DAA6C;AAC7C,0DAAwC;AACxC,gEAA8C;AAC9C,iEAA+C;AAC/C,mDAAiC"}

package/dist/registry/lib/agent-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=agent-validation-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validation-host.d.ts","sourceRoot":"","sources":["../../../src/registry/lib/agent-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/agent-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=agent-validation-host.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validation-host.js","sourceRoot":"","sources":["../../../src/registry/lib/agent-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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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",
@@ -35,7 +35,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@xemahq/kernel-contracts": "^0.3.0",
+    "@xemahq/kernel-contracts": "^0.8.0",
     "clsx": "^2.1.1",
     "tailwind-merge": "^2.5.4",
     "@xemahq/registry": "0.1.3"

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

@@ -33,13 +33,33 @@ export interface NavItemContribution {
   readonly weight?: number;
 }
 
+/**
+ * Access tier required to render a route. The host resolver enforces it
+ * 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.
+ */
+export type RouteAccess = 'member' | 'org-admin' | 'platform-admin';
+
 export interface RouteContribution {
   /** React-router path. May include params. */
   readonly path: string;
   /** Element factory — host calls it inside the route tree. */
   readonly element: () => ReactNode;
-  /** Whether the route is project-scoped (mounted under /projects/:projectId). */
-  readonly projectScoped?: boolean;
+  /**
+   * Whether the route is project-scoped (mounted under /projects/:projectId)
+   * or org-scoped (mounted at the org root). REQUIRED — the host nav resolver
+   * partitions the rail strictly by this flag and drops any nav item whose
+   * route can't be matched (fail-loud). A silent default would re-introduce the
+   * "project pages showing at org level" class of bug, so every route MUST
+   * declare its scope explicitly.
+   */
+  readonly projectScoped: boolean;
+  /**
+   * Access tier required to render this route. The host resolver enforces it
+   * declaratively. Defaults to `'member'` when omitted.
+   */
+  readonly access?: RouteAccess;
 }
 
 /**

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

@@ -21,4 +21,4 @@ export * from './session-profiles';
 export * from './host-sources';
 export * from './nav';
 export * from './biome-mode';
-export * from './composition-validation';
+export * from './agent-validation';

package/src/registry/index.ts

@@ -1,5 +1,5 @@
 export * from './lib/extension-points';
-export * from './lib/composition-validation-host';
+export * from './lib/agent-validation-host';
 export * from './lib/biome-slot';
 export * from './lib/biomes-enabled-context';
 export * from './lib/session-selectors';

package/src/registry/lib/extension-points.ts

@@ -18,7 +18,7 @@
  *      readable via the host bridge's location").
  *   2. Mount `<BiomeSlot name={HostExtensionSlots.X} />` in the host
  *      page.
- *   3. Document the slot in `data/docs/public/biomes/04-frontend-extensions.md`.
+ *   3. Document the slot in the xema-docs repo (`content/biomes/04-frontend-extensions.md`).
  *
  * Removing a host slot is a breaking change — bump the kernel package
  * major version.