@xemahq/ui-kernel 0.1.12 → 0.3.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './lib/system-bus';
 export * from './lib/biome-host';
+export * from './lib/capabilities';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/system-bus"), exports);
 __exportStar(require("./lib/biome-host"), exports);
+__exportStar(require("./lib/capabilities"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,mDAAiC;AACjC,qDAAmC"}

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

@@ -0,0 +1,2 @@
+export declare function getUserFacingErrorMessage(error: unknown, fallback?: string): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/errors.ts"],"names":[],"mappings":"AA0MA,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,QAAQ,SAA4C,GACnD,MAAM,CAcR"}

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

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserFacingErrorMessage = getUserFacingErrorMessage;
+function collapseWhitespace(value) {
+    return value.split(/\s+/).join(' ').trim();
+}
+function getGenericErrorMessage(message, fallback) {
+    const normalized = collapseWhitespace(message);
+    if (/failed to fetch/i.test(normalized)) {
+        return 'Could not reach the service. Check your connection and try again.';
+    }
+    return normalized || fallback;
+}
+function normalizeValidationMessage(rawMessage) {
+    const parts = rawMessage
+        .split(',')
+        .map((part) => collapseWhitespace(part))
+        .filter(Boolean);
+    if (parts.length === 0) {
+        return 'Some required fields are missing or invalid. Please review your input and try again.';
+    }
+    const preview = parts.slice(0, 2).join('; ');
+    const suffix = parts.length > 2 ? '; and more.' : '.';
+    return `Some required fields are missing or invalid (${preview}${suffix})`;
+}
+function isApiClientErrorLike(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const record = error;
+    return (record['name'] === 'ApiClientError' &&
+        typeof record['statusCode'] === 'number' &&
+        typeof record['message'] === 'string');
+}
+function isOrvalClientErrorLike(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const record = error;
+    return (record['name'] === 'ClientError' &&
+        typeof record['status'] === 'number' &&
+        typeof record['message'] === 'string' &&
+        Object.hasOwn(record, 'body'));
+}
+function readStringList(value) {
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    if (value.some((entry) => typeof entry !== 'string')) {
+        return null;
+    }
+    return value;
+}
+function normalizeWorkflowWalletMissingMessage(envelope) {
+    if (envelope.code !== 'WORKFLOW_WALLET_NOT_FOUND') {
+        return null;
+    }
+    const missing = readStringList(envelope.details?.['missing']);
+    if (missing === null || missing.length === 0) {
+        return 'One or more required wallets are missing for this project.';
+    }
+    return `Missing wallet${missing.length > 1 ? 's' : ''}: ${missing.join(', ')}. Add ${missing.length > 1 ? 'them' : 'it'} in Project Settings -> Wallets.`;
+}
+function getApiClientErrorMessage(error, fallback) {
+    if (error.statusCode === 0) {
+        return collapseWhitespace(error.message) || fallback;
+    }
+    if (error.statusCode === 400) {
+        const raw = collapseWhitespace(error.message);
+        if (raw.includes(' must ') || raw.includes('regular expression')) {
+            return normalizeValidationMessage(raw);
+        }
+        return raw || 'The request is invalid. Please check your input and try again.';
+    }
+    if (error.statusCode === 401) {
+        return 'Your session expired. Please sign in again.';
+    }
+    if (error.statusCode === 403) {
+        return 'You do not have permission to perform this action.';
+    }
+    if (error.statusCode === 404) {
+        return 'The requested resource was not found.';
+    }
+    if (error.statusCode >= 500) {
+        return 'The service is temporarily unavailable. Please try again in a moment.';
+    }
+    return collapseWhitespace(error.message) || fallback;
+}
+function getOrvalClientErrorMessage(error, fallback) {
+    if (error.status >= 500) {
+        return 'The service is temporarily unavailable. Please try again in a moment.';
+    }
+    if (error.status === 409) {
+        const body = error.body;
+        if (body && typeof body === 'object') {
+            const record = body;
+            if (record['error'] === 'session_busy') {
+                return 'Your last message is still running. Wait for the agent to finish, then try again.';
+            }
+        }
+    }
+    const body = error.body;
+    if (body && typeof body === 'object') {
+        const record = body;
+        const payload = (() => {
+            const message = record['message'];
+            if (message && typeof message === 'object') {
+                return message;
+            }
+            return {
+                code: typeof record['code'] === 'string' ? record['code'] : undefined,
+                message: typeof record['message'] === 'string' ? record['message'] : undefined,
+                details: record['details'] && typeof record['details'] === 'object'
+                    ? record['details']
+                    : undefined,
+            };
+        })();
+        const workflowWalletMessage = normalizeWorkflowWalletMissingMessage(payload);
+        if (workflowWalletMessage !== null) {
+            return workflowWalletMessage;
+        }
+        if (typeof payload.message === 'string' && payload.message.trim().length > 0) {
+            return collapseWhitespace(payload.message);
+        }
+        if (typeof record['message'] === 'string' && record['message'].trim().length > 0) {
+            return collapseWhitespace(record['message']);
+        }
+    }
+    return getGenericErrorMessage(error.message, fallback);
+}
+function getUserFacingErrorMessage(error, fallback = 'Something went wrong. Please try again.') {
+    if (typeof error === 'string') {
+        return collapseWhitespace(error) || fallback;
+    }
+    if (isApiClientErrorLike(error)) {
+        return getApiClientErrorMessage(error, fallback);
+    }
+    if (isOrvalClientErrorLike(error)) {
+        return getOrvalClientErrorMessage(error, fallback);
+    }
+    if (error instanceof Error) {
+        return getGenericErrorMessage(error.message, fallback);
+    }
+    return fallback;
+}
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -1,6 +1,8 @@
 import type { QueryClient } from '@tanstack/react-query';
 import { type ReactNode } from 'react';
+import type { CapabilityPort } from '../capabilities';
 import type { SystemBus } from '../system-bus';
+import type { RealtimeSource } from './realtime-port';
 export interface HostBridgeNavigation {
     push(path: string): void;
     replace(path: string): void;
@@ -28,6 +30,9 @@ export interface HostBridgeToast {
 export interface HostBridgeRequestContext {
     readonly correlationId: string;
 }
+export interface HostBridgeErrors {
+    getUserFacingErrorMessage(error: unknown, fallback?: string): string;
+}
 export interface PageBackTarget {
     readonly to: string;
     readonly label?: string;
@@ -52,6 +57,9 @@ export interface HostBridge {
     readonly requestContext: HostBridgeRequestContext;
     readonly pageMeta: HostBridgePageMeta;
     readonly system: SystemBus;
+    readonly capabilities: CapabilityPort;
+    readonly realtime?: RealtimeSource;
+    readonly errors?: HostBridgeErrors;
 }
 export declare const HostBridgeContext: import("react").Context<HostBridge | null>;
 export declare function useHostBridge(): HostBridge;

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

@@ -1 +1 @@
-{"version":3,"file":"host-bridge.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/host-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAa/C,MAAM,WAAW,oBAAoB;IAEnC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAK5B,WAAW,IAAI,YAAY,CAAC;IAe5B,cAAc,CACZ,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAC9E,CAAC,CAAC;IAaP,eAAe,IAAI,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAE7B,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAE/B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAE1B,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAE9B,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAc3B,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAQ/D,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAO9B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAQD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,MAAM,WAAW,QAAQ;IAEvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAEjC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAEnC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;CACjC;AAaD,MAAM,WAAW,kBAAkB;IAMjC,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;IAOlD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAStC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,eAAO,MAAM,iBAAiB,4CAAyC,CAAC;AAQxE,wBAAgB,aAAa,IAAI,UAAU,CAS1C"}
+{"version":3,"file":"host-bridge.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/host-bridge.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../../../src/lib/biome-host/host-bridge.ts"],"names":[],"mappings":";;;AA2MA,sCASC;AAlND,iCAAkE;AAiMrD,QAAA,iBAAiB,GAAG,IAAA,qBAAa,EAAoB,IAAI,CAAC,CAAC;AACxE,yBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC;AAOpD,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,yBAAiB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,gFAAgF;YAC9E,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../../../src/lib/biome-host/host-bridge.ts"],"names":[],"mappings":";;;AAiQA,sCASC;AAxQD,iCAAkE;AAuPrD,QAAA,iBAAiB,GAAG,IAAA,qBAAa,EAAoB,IAAI,CAAC,CAAC;AACxE,yBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC;AAOpD,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,yBAAiB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,gFAAgF;YAC9E,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -12,4 +12,8 @@ export * from './host-sources';
 export * from './nav';
 export * from './biome-mode';
 export * from './agent-validation';
+export * from './realtime-port';
+export * from './realtime-hooks';
+export * from './errors';
+export * from './response-envelope';
 //# 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,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"}
+{"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"}

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

@@ -28,4 +28,8 @@ __exportStar(require("./host-sources"), exports);
 __exportStar(require("./nav"), exports);
 __exportStar(require("./biome-mode"), exports);
 __exportStar(require("./agent-validation"), exports);
+__exportStar(require("./realtime-port"), exports);
+__exportStar(require("./realtime-hooks"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./response-envelope"), 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,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"}
+{"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"}

package/dist/lib/biome-host/realtime-hooks.d.ts

@@ -0,0 +1,5 @@
+import type { RealtimeCloudEvent, RealtimeConnectionState, RealtimeScope } from './realtime-port';
+export declare function useCloudEvent(eventType: string, handler: (event: RealtimeCloudEvent) => void): void;
+export declare function useRealtimeStatus(): RealtimeConnectionState;
+export declare function useEventScope(scope: RealtimeScope): void;
+//# sourceMappingURL=realtime-hooks.d.ts.map

package/dist/lib/biome-host/realtime-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/realtime-hooks.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EAEd,MAAM,iBAAiB,CAAC;AAiCzB,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC3C,IAAI,CAGN;AAGD,wBAAgB,iBAAiB,IAAI,uBAAuB,CAG3D;AAOD,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAGxD"}

package/dist/lib/biome-host/realtime-hooks.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCloudEvent = useCloudEvent;
+exports.useRealtimeStatus = useRealtimeStatus;
+exports.useEventScope = useEventScope;
+const host_bridge_1 = require("./host-bridge");
+function requireRealtime(realtime) {
+    if (!realtime) {
+        throw new Error('useCloudEvent/useRealtimeStatus/useEventScope require a realtime ' +
+            'transport, but the host has not wired `bridge.realtime`. The host ' +
+            'must provide a RealtimeSource (e.g. backed by @xemahq/realtime-client) ' +
+            'on the HostBridge to use kernel realtime hooks.');
+    }
+    return realtime;
+}
+function useCloudEvent(eventType, handler) {
+    const bridge = (0, host_bridge_1.useHostBridge)();
+    requireRealtime(bridge.realtime).useCloudEvent(eventType, handler);
+}
+function useRealtimeStatus() {
+    const bridge = (0, host_bridge_1.useHostBridge)();
+    return requireRealtime(bridge.realtime).useRealtimeStatus();
+}
+function useEventScope(scope) {
+    const bridge = (0, host_bridge_1.useHostBridge)();
+    requireRealtime(bridge.realtime).useEventScope(scope);
+}
+//# sourceMappingURL=realtime-hooks.js.map

package/dist/lib/biome-host/realtime-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-hooks.js","sourceRoot":"","sources":["../../../src/lib/biome-host/realtime-hooks.ts"],"names":[],"mappings":";;AAmDA,sCAMC;AAGD,8CAGC;AAOD,sCAGC;AA7DD,+CAA8C;AAc9C,SAAS,eAAe,CAAC,QAAoC;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,oEAAoE;YACpE,yEAAyE;YACzE,iDAAiD,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAeD,SAAgB,aAAa,CAC3B,SAAiB,EACjB,OAA4C;IAE5C,MAAM,MAAM,GAAG,IAAA,2BAAa,GAAE,CAAC;IAC/B,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACrE,CAAC;AAGD,SAAgB,iBAAiB;IAC/B,MAAM,MAAM,GAAG,IAAA,2BAAa,GAAE,CAAC;IAC/B,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,iBAAiB,EAAE,CAAC;AAC9D,CAAC;AAOD,SAAgB,aAAa,CAAC,KAAoB;IAChD,MAAM,MAAM,GAAG,IAAA,2BAAa,GAAE,CAAC;IAC/B,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/lib/biome-host/realtime-port.d.ts

@@ -0,0 +1,30 @@
+export interface RealtimeCloudEvent {
+    id?: string;
+    type: string;
+    source?: string;
+    subject?: string;
+    data?: unknown;
+    ehorgid: string;
+    ehprojectid?: string;
+    ehuserid?: string;
+    ehglobalseq?: string;
+    ehorgseq?: string;
+    ehprojectseq?: string;
+    ehsessionseq?: string;
+    __hint?: unknown;
+}
+export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+export interface RealtimeConnectionState {
+    readonly status: RealtimeStatus;
+    readonly connectionId?: string;
+}
+export interface RealtimeScope {
+    readonly kind: 'project' | 'session';
+    readonly id: string;
+}
+export interface RealtimeSource {
+    useCloudEvent(eventType: string, handler: (event: RealtimeCloudEvent) => void): void;
+    useRealtimeStatus(): RealtimeConnectionState;
+    useEventScope(scope: RealtimeScope): void;
+}
+//# sourceMappingURL=realtime-port.d.ts.map

package/dist/lib/biome-host/realtime-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-port.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/realtime-port.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,kBAAkB;IAEjC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,QAAQ,CAAC;AAGb,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,WAAW,cAAc;IAO7B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IAErF,iBAAiB,IAAI,uBAAuB,CAAC;IAM7C,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAC3C"}

package/dist/lib/biome-host/realtime-port.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=realtime-port.js.map

package/dist/lib/biome-host/realtime-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-port.js","sourceRoot":"","sources":["../../../src/lib/biome-host/realtime-port.ts"],"names":[],"mappings":""}

package/dist/lib/biome-host/response-envelope.d.ts

@@ -0,0 +1,3 @@
+export declare function unwrapList<T>(value: unknown): T[];
+export declare function unwrapData<T>(value: unknown): T;
+//# sourceMappingURL=response-envelope.d.ts.map

package/dist/lib/biome-host/response-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-envelope.d.ts","sourceRoot":"","sources":["../../../src/lib/biome-host/response-envelope.ts"],"names":[],"mappings":"AA+BA,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAYjD;AAeD,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAU/C"}

package/dist/lib/biome-host/response-envelope.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapList = unwrapList;
+exports.unwrapData = unwrapData;
+function unwrapList(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value !== null &&
+        typeof value === 'object' &&
+        Array.isArray(value.data)) {
+        return value.data;
+    }
+    return [];
+}
+function unwrapData(value) {
+    if (value !== null &&
+        typeof value === 'object' &&
+        'data' in value &&
+        !('pagination' in value)) {
+        return value.data;
+    }
+    return value;
+}
+//# sourceMappingURL=response-envelope.js.map

package/dist/lib/biome-host/response-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-envelope.js","sourceRoot":"","sources":["../../../src/lib/biome-host/response-envelope.ts"],"names":[],"mappings":";;AA+BA,gCAYC;AAeD,gCAUC;AArCD,SAAgB,UAAU,CAAI,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAY,CAAC;IACtB,CAAC;IACD,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAE,KAA4B,CAAC,IAAI,CAAC,EACjD,CAAC;QACD,OAAQ,KAAuB,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAeD,SAAgB,UAAU,CAAI,KAAc;IAC1C,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAK,KAAiC;QAC5C,CAAC,CAAC,YAAY,IAAK,KAAiC,CAAC,EACrD,CAAC;QACD,OAAQ,KAAqB,CAAC,IAAI,CAAC;IACrC,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/lib/capabilities/capability-provider.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+import type { CapabilityPort, MeCapabilitiesSnapshot } from './types';
+export interface CapabilityContextValue {
+    readonly snapshot: MeCapabilitiesSnapshot | undefined;
+    readonly isLoading: boolean;
+    readonly error: unknown;
+}
+export interface CapabilityProviderProps {
+    readonly children: ReactNode;
+    readonly port?: CapabilityPort;
+    readonly orgId?: string | null;
+}
+export declare function CapabilityProvider(props: CapabilityProviderProps): JSX.Element;
+export declare function useCapabilityContext(): CapabilityContextValue;
+//# sourceMappingURL=capability-provider.d.ts.map

package/dist/lib/capabilities/capability-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-provider.d.ts","sourceRoot":"","sources":["../../../src/lib/capabilities/capability-provider.tsx"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlE,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAStE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAYD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAM7B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAM/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAgBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,GAAG,CAAC,OAAO,CAiB9E;AAOD,wBAAgB,oBAAoB,IAAI,sBAAsB,CAU7D"}

package/dist/lib/capabilities/capability-provider.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityProvider = CapabilityProvider;
+exports.useCapabilityContext = useCapabilityContext;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_query_1 = require("@tanstack/react-query");
+const react_1 = require("react");
+const host_bridge_1 = require("../biome-host/host-bridge");
+const CapabilityContext = (0, react_1.createContext)(null);
+CapabilityContext.displayName = 'CapabilityContext';
+const CAPABILITIES_QUERY_ROOT = ['xema', 'capabilities', 'me'];
+function CapabilityProvider(props) {
+    const bridge = (0, host_bridge_1.useHostBridge)();
+    const port = props.port ?? bridge.capabilities;
+    const orgId = props.orgId !== undefined ? props.orgId : bridge.auth.getOrgId();
+    const query = (0, react_query_1.useQuery)({
+        queryKey: [...CAPABILITIES_QUERY_ROOT, orgId],
+        queryFn: () => port.list(orgId ? { orgId } : undefined),
+    });
+    const value = {
+        snapshot: query.data,
+        isLoading: query.isLoading,
+        error: query.error,
+    };
+    return (0, jsx_runtime_1.jsx)(CapabilityContext.Provider, { value: value, children: props.children });
+}
+function useCapabilityContext() {
+    const ctx = (0, react_1.useContext)(CapabilityContext);
+    if (!ctx) {
+        throw new Error('[xema-ui-kernel] useCapability()/useCapabilities() called outside ' +
+            '<CapabilityProvider>. The host (or biome shell) must mount the ' +
+            'capability provider above any capability-gated subtree.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=capability-provider.js.map

package/dist/lib/capabilities/capability-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-provider.js","sourceRoot":"","sources":["../../../src/lib/capabilities/capability-provider.tsx"],"names":[],"mappings":";;AA4DA,gDAiBC;AAOD,oDAUC;;AA9FD,uDAAiD;AACjD,iCAAkE;AAElE,2DAA0D;AAiB1D,MAAM,iBAAiB,GAAG,IAAA,qBAAa,EAAgC,IAAI,CAAC,CAAC;AAC7E,iBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC;AAOpD,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAU,CAAC;AAgCxE,SAAgB,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,MAAM,GAAG,IAAA,2BAAa,GAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAE/E,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAyB;QAC7C,QAAQ,EAAE,CAAC,GAAG,uBAAuB,EAAE,KAAK,CAAC;QAC7C,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KACxD,CAAC,CAAC;IAEH,MAAM,KAAK,GAA2B;QACpC,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;IAEF,OAAO,uBAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,KAAK,CAAC,QAAQ,GAA8B,CAAC;AACjG,CAAC;AAOD,SAAgB,oBAAoB;IAClC,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,iEAAiE;YACjE,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/capabilities/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './capability-provider';
+export * from './use-capability';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/capabilities/index.ts"],"names":[],"mappings":"AAaA,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/lib/capabilities/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./capability-provider"), exports);
+__exportStar(require("./use-capability"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/capabilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAaA,0CAAwB;AACxB,wDAAsC;AACtC,mDAAiC"}

package/dist/lib/capabilities/types.d.ts

@@ -0,0 +1,18 @@
+import type { ExecutionEnvironmentKind } from '@xemahq/kernel-contracts/execution-environment';
+export interface CapabilityEntry {
+    readonly ref: string;
+    readonly environments: ExecutionEnvironmentKind[];
+    readonly approvalRequired: boolean;
+}
+export interface MeCapabilitiesSnapshot {
+    readonly subjectId: string;
+    readonly orgId: string;
+    readonly capabilities: CapabilityEntry[];
+}
+export interface CapabilityPort {
+    list(options?: {
+        orgId?: string;
+        environment?: ExecutionEnvironmentKind;
+    }): Promise<MeCapabilitiesSnapshot>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/capabilities/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/capabilities/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAY/F,MAAM,WAAW,eAAe;IAK9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAKrB,QAAQ,CAAC,YAAY,EAAE,wBAAwB,EAAE,CAAC;IAMlD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAMD,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,CAAC;CAC1C;AAWD,MAAM,WAAW,cAAc;IAW7B,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,wBAAwB,CAAC;KACxC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACrC"}

package/dist/lib/capabilities/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/capabilities/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/capabilities/types.ts"],"names":[],"mappings":""}

package/dist/lib/capabilities/use-capability.d.ts

@@ -0,0 +1,18 @@
+import type { ExecutionEnvironmentKind } from '@xemahq/kernel-contracts/execution-environment';
+import type { MeCapabilitiesSnapshot } from './types';
+export interface UseCapabilityOptions {
+    readonly environment?: ExecutionEnvironmentKind;
+}
+export interface CapabilityDecision {
+    readonly allowed: boolean;
+    readonly approvalRequired: boolean;
+    readonly isLoading: boolean;
+    readonly error: unknown;
+}
+export declare function useCapability(ref: string, opts?: UseCapabilityOptions): CapabilityDecision;
+export declare function useCapabilities(): {
+    snapshot: MeCapabilitiesSnapshot | undefined;
+    isLoading: boolean;
+    error: unknown;
+};
+//# sourceMappingURL=use-capability.d.ts.map

package/dist/lib/capabilities/use-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-capability.d.ts","sourceRoot":"","sources":["../../../src/lib/capabilities/use-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAG/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IAKnC,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED,MAAM,WAAW,kBAAkB;IAMjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAM1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAcD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAa1F;AAOD,wBAAgB,eAAe,IAAI;IACjC,QAAQ,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAGA"}

package/dist/lib/capabilities/use-capability.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCapability = useCapability;
+exports.useCapabilities = useCapabilities;
+const capability_provider_1 = require("./capability-provider");
+function useCapability(ref, opts) {
+    const { snapshot, isLoading, error } = (0, capability_provider_1.useCapabilityContext)();
+    const entry = snapshot?.capabilities.find((c) => c.ref === ref);
+    const inEnvironment = !!entry && (!opts?.environment || entry.environments.includes(opts.environment));
+    return {
+        allowed: inEnvironment && !entry.approvalRequired,
+        approvalRequired: inEnvironment && entry.approvalRequired,
+        isLoading,
+        error,
+    };
+}
+function useCapabilities() {
+    const ctx = (0, capability_provider_1.useCapabilityContext)();
+    return { snapshot: ctx.snapshot, isLoading: ctx.isLoading, error: ctx.error };
+}
+//# sourceMappingURL=use-capability.js.map

package/dist/lib/capabilities/use-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-capability.js","sourceRoot":"","sources":["../../../src/lib/capabilities/use-capability.ts"],"names":[],"mappings":";;AA4CA,sCAaC;AAOD,0CAOC;AArED,+DAA0F;AA0C1F,SAAgB,aAAa,CAAC,GAAW,EAAE,IAA2B;IACpE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAA,0CAAoB,GAAE,CAAC;IAE9D,MAAM,KAAK,GAAG,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAChE,MAAM,aAAa,GACjB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAEnF,OAAO;QACL,OAAO,EAAE,aAAa,IAAI,CAAC,KAAK,CAAC,gBAAgB;QACjD,gBAAgB,EAAE,aAAa,IAAI,KAAK,CAAC,gBAAgB;QACzD,SAAS;QACT,KAAK;KACN,CAAC;AACJ,CAAC;AAOD,SAAgB,eAAe;IAK7B,MAAM,GAAG,GAA2B,IAAA,0CAAoB,GAAE,CAAC;IAC3D,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;AAChF,CAAC"}

package/dist/ui/chrome/AsyncBoundary.d.ts

@@ -0,0 +1,22 @@
+import type { LucideIcon } from 'lucide-react';
+import type { ReactNode } from 'react';
+import { type ErrorMessageFormatter } from './ErrorCard';
+import { type LoadingStateVariant } from './LoadingState';
+interface AsyncBoundaryEmpty {
+    icon: LucideIcon;
+    title: string;
+    description?: ReactNode;
+}
+interface AsyncBoundaryProps {
+    isLoading: boolean;
+    error?: Error | string | unknown | null;
+    isEmpty?: boolean;
+    empty?: AsyncBoundaryEmpty;
+    onRetry?: () => void;
+    loadingVariant?: LoadingStateVariant;
+    formatError?: ErrorMessageFormatter;
+    children: ReactNode;
+}
+export default function AsyncBoundary({ isLoading, error, isEmpty, empty, onRetry, loadingVariant, formatError, children, }: Readonly<AsyncBoundaryProps>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=AsyncBoundary.d.ts.map

package/dist/ui/chrome/AsyncBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncBoundary.d.ts","sourceRoot":"","sources":["../../../src/ui/chrome/AsyncBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpE,OAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE,UAAU,kBAAkB;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,UAAU,kBAAkB;IAE1B,SAAS,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAKxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAE3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAUD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,SAAS,EACT,KAAK,EACL,OAAO,EACP,KAAK,EACL,OAAO,EACP,cAAc,EACd,WAAW,EACX,QAAQ,GACT,EAAE,QAAQ,CAAC,kBAAkB,CAAC,+BAc9B"}