@moldable-ai/ui 0.2.18 → 0.2.20

package/dist/lib/native-hardware/global-shortcuts.d.ts

@@ -0,0 +1,86 @@
+import { type NativeHardwareBridgeOptions } from './bridge';
+import type { NativeHardwareRequestEnvelope, NativeHardwareResultEnvelope } from './types';
+export declare const NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE: "moldable:native-global-shortcuts";
+export declare const NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE: "moldable:native-global-shortcuts-result";
+export declare const NATIVE_GLOBAL_SHORTCUT_EVENT_TYPE: "moldable:native-global-shortcut-event";
+export declare const NATIVE_GLOBAL_SHORTCUT_MAX_LENGTH = 128;
+export declare const NATIVE_GLOBAL_SHORTCUT_MAX_PER_APP = 32;
+export type MoldableGlobalShortcutState = 'Pressed' | 'Released';
+export interface MoldableGlobalShortcutEvent {
+    registrationId: string;
+    shortcut: string;
+    state: MoldableGlobalShortcutState;
+}
+export type MoldableGlobalShortcutHandler = (event: MoldableGlobalShortcutEvent) => void;
+export interface MoldableGlobalShortcutRegistration {
+    readonly registrationId: string;
+    readonly shortcut: string;
+    unregister(options?: NativeHardwareBridgeOptions): Promise<void>;
+}
+export interface NativeGlobalShortcutRegistrationInput {
+    registrationId: string;
+    shortcut: string;
+}
+export type NativeGlobalShortcutRequest = NativeHardwareRequestEnvelope<typeof NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE, {
+    capability: 'global-shortcuts';
+    action: 'register';
+    registrationId: string;
+    shortcut: string;
+} | {
+    capability: 'global-shortcuts';
+    action: 'unregister';
+    registrationId: string;
+} | {
+    capability: 'global-shortcuts';
+    action: 'unregisterAll';
+} | {
+    capability: 'global-shortcuts';
+    action: 'registerAll';
+    registrations: NativeGlobalShortcutRegistrationInput[];
+} | {
+    capability: 'global-shortcuts';
+    action: 'isRegistered';
+    shortcut: string;
+} | {
+    capability: 'global-shortcuts';
+    action: 'setSuspended';
+    suspended: boolean;
+} | {
+    capability: 'global-shortcuts';
+    action: 'isSuspended';
+}>;
+export interface NativeGlobalShortcutRegistrationResult {
+    registered: true;
+    registrationId: string;
+    shortcut: string;
+}
+export interface NativeGlobalShortcutUnregisterResult {
+    unregistered: true;
+    registrationId: string;
+}
+export interface NativeGlobalShortcutUnregisterAllResult {
+    unregisteredCount: number;
+}
+export interface NativeGlobalShortcutRegisterAllResult {
+    registered: true;
+    registrations: NativeGlobalShortcutRegistrationResult[];
+}
+export interface NativeGlobalShortcutIsRegisteredResult {
+    registered: boolean;
+    shortcut: string;
+}
+export interface NativeGlobalShortcutSuspendedResult {
+    suspended: boolean;
+}
+export type NativeGlobalShortcutResult = NativeHardwareResultEnvelope<typeof NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, NativeGlobalShortcutRegistrationResult | NativeGlobalShortcutUnregisterResult | NativeGlobalShortcutUnregisterAllResult | NativeGlobalShortcutRegisterAllResult | NativeGlobalShortcutIsRegisteredResult | NativeGlobalShortcutSuspendedResult>;
+export declare function isMoldableGlobalShortcut(value: unknown): value is string;
+export declare function registerMoldableGlobalShortcut(shortcut: string, handler: MoldableGlobalShortcutHandler, options?: NativeHardwareBridgeOptions): Promise<MoldableGlobalShortcutRegistration>;
+export declare function registerAllMoldableGlobalShortcuts(shortcuts: readonly string[], handler: MoldableGlobalShortcutHandler, options?: NativeHardwareBridgeOptions): Promise<MoldableGlobalShortcutRegistration[]>;
+export declare function isMoldableGlobalShortcutRegistered(shortcut: string, options?: NativeHardwareBridgeOptions): Promise<boolean>;
+export declare function setMoldableGlobalShortcutsSuspended(suspended: boolean, options?: NativeHardwareBridgeOptions): Promise<void>;
+export declare function areMoldableGlobalShortcutsSuspended(options?: NativeHardwareBridgeOptions): Promise<boolean>;
+export declare function unregisterMoldableGlobalShortcut(registrationId: string, options?: NativeHardwareBridgeOptions): Promise<void>;
+export declare function unregisterAllMoldableGlobalShortcuts(options?: NativeHardwareBridgeOptions): Promise<NativeGlobalShortcutUnregisterAllResult>;
+/** Test-only reset for module-level event delivery state. */
+export declare function resetMoldableGlobalShortcutClientForTests(): void;
+//# sourceMappingURL=global-shortcuts.d.ts.map

package/dist/lib/native-hardware/global-shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-shortcuts.d.ts","sourceRoot":"","sources":["../../../src/lib/native-hardware/global-shortcuts.ts"],"names":[],"mappings":"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"}

package/dist/lib/native-hardware/global-shortcuts.js

@@ -0,0 +1,351 @@
+import { NativeHardwareBridgeError, callNativeHardwareBridge, } from './bridge';
+export const NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE = 'moldable:native-global-shortcuts';
+export const NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE = 'moldable:native-global-shortcuts-result';
+export const NATIVE_GLOBAL_SHORTCUT_EVENT_TYPE = 'moldable:native-global-shortcut-event';
+export const NATIVE_GLOBAL_SHORTCUT_MAX_LENGTH = 128;
+export const NATIVE_GLOBAL_SHORTCUT_MAX_PER_APP = 32;
+const MODIFIERS = new Set([
+    'alt',
+    'altgr',
+    'capslock',
+    'cmd',
+    'cmdorctrl',
+    'command',
+    'commandorcontrol',
+    'control',
+    'ctrl',
+    'fn',
+    'fnlock',
+    'hyper',
+    'meta',
+    'numlock',
+    'option',
+    'scrolllock',
+    'shift',
+    'super',
+    'symbol',
+    'symbollock',
+]);
+const handlers = new Map();
+const pendingEvents = new Map();
+const MAX_PENDING_REGISTRATIONS = 64;
+let listeningWindow = null;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function isMoldableGlobalShortcut(value) {
+    if (typeof value !== 'string' || value !== value.trim())
+        return false;
+    if (value.length < 3 || value.length > NATIVE_GLOBAL_SHORTCUT_MAX_LENGTH) {
+        return false;
+    }
+    if (/\s/u.test(value) ||
+        [...value].some((character) => {
+            const code = character.charCodeAt(0);
+            return code <= 31 || code === 127;
+        })) {
+        return false;
+    }
+    const parts = value.split('+');
+    if (parts.length < 2 || parts.length > 8)
+        return false;
+    if (parts.some((part) => !/^[A-Za-z0-9]{1,32}$/u.test(part)))
+        return false;
+    const normalized = parts.map((part) => part.toLowerCase());
+    if (new Set(normalized).size !== normalized.length)
+        return false;
+    if (!normalized.slice(0, -1).every((part) => MODIFIERS.has(part))) {
+        return false;
+    }
+    return !MODIFIERS.has(normalized[normalized.length - 1] ?? '');
+}
+function isGlobalShortcutEvent(value) {
+    return (isRecord(value) &&
+        value.type === NATIVE_GLOBAL_SHORTCUT_EVENT_TYPE &&
+        typeof value.registrationId === 'string' &&
+        value.registrationId.length > 0 &&
+        isMoldableGlobalShortcut(value.shortcut) &&
+        (value.state === 'Pressed' || value.state === 'Released'));
+}
+function handleShortcutMessage(event) {
+    if (event.source !== window.parent || !isGlobalShortcutEvent(event.data)) {
+        return;
+    }
+    const handler = handlers.get(event.data.registrationId);
+    if (handler) {
+        try {
+            handler({
+                registrationId: event.data.registrationId,
+                shortcut: event.data.shortcut,
+                state: event.data.state,
+            });
+        }
+        catch {
+            // One app callback must not break delivery for other registrations.
+        }
+        return;
+    }
+    if (!pendingEvents.has(event.data.registrationId) &&
+        pendingEvents.size >= MAX_PENDING_REGISTRATIONS) {
+        return;
+    }
+    const queued = pendingEvents.get(event.data.registrationId) ?? [];
+    if (queued.length < 4)
+        queued.push(event.data);
+    pendingEvents.set(event.data.registrationId, queued);
+}
+function ensureGlobalShortcutListener() {
+    if (typeof window === 'undefined' || listeningWindow === window)
+        return;
+    if (listeningWindow) {
+        listeningWindow.removeEventListener('message', handleShortcutMessage);
+    }
+    window.addEventListener('message', handleShortcutMessage);
+    listeningWindow = window;
+}
+function bindHandler(registrationId, handler) {
+    handlers.set(registrationId, handler);
+    const queued = pendingEvents.get(registrationId) ?? [];
+    pendingEvents.delete(registrationId);
+    for (const event of queued) {
+        try {
+            handler({
+                registrationId: event.registrationId,
+                shortcut: event.shortcut,
+                state: event.state,
+            });
+        }
+        catch {
+            // Callback errors do not change a successfully created registration.
+        }
+    }
+}
+function invalidShortcutError() {
+    return new NativeHardwareBridgeError({
+        code: 'invalid_request',
+        message: 'A global shortcut must contain modifiers and one key, for example CommandOrControl+Shift+P.',
+        retryable: false,
+    });
+}
+function canonicalShortcut(shortcut) {
+    const aliases = {
+        cmd: 'meta',
+        command: 'meta',
+        cmdorctrl: 'commandorcontrol',
+        ctrl: 'control',
+        option: 'alt',
+    };
+    return shortcut
+        .split('+')
+        .map((part) => aliases[part.toLowerCase()] ?? part.toLowerCase())
+        .join('+');
+}
+function makeRegistrationId() {
+    if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {
+        return `native-shortcut-${crypto.randomUUID()}`;
+    }
+    return `native-shortcut-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+function makeRegistration(result) {
+    let active = true;
+    return {
+        registrationId: result.registrationId,
+        shortcut: result.shortcut,
+        async unregister(unregisterOptions = {}) {
+            if (!active)
+                return;
+            await unregisterMoldableGlobalShortcut(result.registrationId, unregisterOptions);
+            active = false;
+        },
+    };
+}
+export async function registerMoldableGlobalShortcut(shortcut, handler, options = {}) {
+    if (!isMoldableGlobalShortcut(shortcut) || typeof handler !== 'function') {
+        throw invalidShortcutError();
+    }
+    ensureGlobalShortcutListener();
+    const registrationId = makeRegistrationId();
+    let result;
+    try {
+        result =
+            await callNativeHardwareBridge({
+                type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+                capability: 'global-shortcuts',
+                action: 'register',
+                registrationId,
+                shortcut,
+            }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+        if (result.registered !== true ||
+            result.registrationId !== registrationId ||
+            result.shortcut !== shortcut) {
+            throw new NativeHardwareBridgeError({
+                code: 'invalid_response',
+                message: 'Moldable returned an invalid global shortcut registration.',
+                details: result,
+                retryable: false,
+            });
+        }
+    }
+    catch (error) {
+        if (error instanceof NativeHardwareBridgeError &&
+            (error.code === 'timeout' ||
+                error.code === 'aborted' ||
+                error.code === 'invalid_response')) {
+            void unregisterMoldableGlobalShortcut(registrationId).catch(() => {
+                // App-view teardown remains the final cleanup boundary.
+            });
+        }
+        throw error;
+    }
+    bindHandler(result.registrationId, handler);
+    return makeRegistration(result);
+}
+export async function registerAllMoldableGlobalShortcuts(shortcuts, handler, options = {}) {
+    if (!Array.isArray(shortcuts) ||
+        shortcuts.length === 0 ||
+        shortcuts.length > NATIVE_GLOBAL_SHORTCUT_MAX_PER_APP ||
+        typeof handler !== 'function' ||
+        !shortcuts.every(isMoldableGlobalShortcut) ||
+        new Set(shortcuts.map(canonicalShortcut)).size !== shortcuts.length) {
+        throw invalidShortcutError();
+    }
+    ensureGlobalShortcutListener();
+    const registrations = shortcuts.map((shortcut) => ({
+        registrationId: makeRegistrationId(),
+        shortcut,
+    }));
+    let result;
+    try {
+        result =
+            await callNativeHardwareBridge({
+                type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+                capability: 'global-shortcuts',
+                action: 'registerAll',
+                registrations,
+            }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+        if (result.registered !== true ||
+            !Array.isArray(result.registrations) ||
+            result.registrations.length !== registrations.length ||
+            result.registrations.some((registered, index) => {
+                const requested = registrations[index];
+                return (registered.registered !== true ||
+                    registered.registrationId !== requested?.registrationId ||
+                    registered.shortcut !== requested.shortcut);
+            })) {
+            throw new NativeHardwareBridgeError({
+                code: 'invalid_response',
+                message: 'Moldable returned invalid global shortcut registrations.',
+                details: result,
+                retryable: false,
+            });
+        }
+    }
+    catch (error) {
+        if (error instanceof NativeHardwareBridgeError &&
+            (error.code === 'timeout' ||
+                error.code === 'aborted' ||
+                error.code === 'host_error' ||
+                error.code === 'invalid_response')) {
+            void Promise.allSettled(registrations.map((registration) => unregisterMoldableGlobalShortcut(registration.registrationId)));
+        }
+        throw error;
+    }
+    for (const registration of result.registrations) {
+        bindHandler(registration.registrationId, handler);
+    }
+    return result.registrations.map(makeRegistration);
+}
+export async function isMoldableGlobalShortcutRegistered(shortcut, options = {}) {
+    if (!isMoldableGlobalShortcut(shortcut))
+        throw invalidShortcutError();
+    const result = await callNativeHardwareBridge({
+        type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+        capability: 'global-shortcuts',
+        action: 'isRegistered',
+        shortcut,
+    }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+    if (typeof result.registered !== 'boolean' || result.shortcut !== shortcut) {
+        throw new NativeHardwareBridgeError({
+            code: 'invalid_response',
+            message: 'Moldable returned an invalid global shortcut status.',
+            details: result,
+            retryable: false,
+        });
+    }
+    return result.registered;
+}
+export async function setMoldableGlobalShortcutsSuspended(suspended, options = {}) {
+    if (typeof suspended !== 'boolean') {
+        throw new NativeHardwareBridgeError({
+            code: 'invalid_request',
+            message: 'Global shortcut suspension must be a boolean.',
+            retryable: false,
+        });
+    }
+    const result = await callNativeHardwareBridge({
+        type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+        capability: 'global-shortcuts',
+        action: 'setSuspended',
+        suspended,
+    }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+    if (result.suspended !== suspended) {
+        throw new NativeHardwareBridgeError({
+            code: 'invalid_response',
+            message: 'Moldable returned an invalid global shortcut suspension state.',
+            details: result,
+            retryable: false,
+        });
+    }
+}
+export async function areMoldableGlobalShortcutsSuspended(options = {}) {
+    const result = await callNativeHardwareBridge({
+        type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+        capability: 'global-shortcuts',
+        action: 'isSuspended',
+    }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+    if (typeof result.suspended !== 'boolean') {
+        throw new NativeHardwareBridgeError({
+            code: 'invalid_response',
+            message: 'Moldable returned an invalid global shortcut suspension state.',
+            details: result,
+            retryable: false,
+        });
+    }
+    return result.suspended;
+}
+export async function unregisterMoldableGlobalShortcut(registrationId, options = {}) {
+    if (registrationId.trim().length === 0 || registrationId.length > 128) {
+        throw new NativeHardwareBridgeError({
+            code: 'invalid_request',
+            message: 'A valid global shortcut registration ID is required.',
+            retryable: false,
+        });
+    }
+    await callNativeHardwareBridge({
+        type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+        capability: 'global-shortcuts',
+        action: 'unregister',
+        registrationId,
+    }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+    handlers.delete(registrationId);
+    pendingEvents.delete(registrationId);
+}
+export async function unregisterAllMoldableGlobalShortcuts(options = {}) {
+    const result = await callNativeHardwareBridge({
+        type: NATIVE_GLOBAL_SHORTCUT_REQUEST_TYPE,
+        capability: 'global-shortcuts',
+        action: 'unregisterAll',
+    }, NATIVE_GLOBAL_SHORTCUT_RESULT_TYPE, options);
+    handlers.clear();
+    pendingEvents.clear();
+    return result;
+}
+/** Test-only reset for module-level event delivery state. */
+export function resetMoldableGlobalShortcutClientForTests() {
+    if (listeningWindow) {
+        listeningWindow.removeEventListener('message', handleShortcutMessage);
+    }
+    listeningWindow = null;
+    handlers.clear();
+    pendingEvents.clear();
+}

package/dist/lib/native-hardware/haptics.d.ts

@@ -0,0 +1,25 @@
+import { type NativeHardwareBridgeOptions } from './bridge';
+export declare const NATIVE_HAPTICS_REQUEST_TYPE: "moldable:native-haptics";
+export declare const NATIVE_HAPTICS_RESULT_TYPE: "moldable:native-haptics-result";
+export type MoldableHapticPattern = 'generic' | 'alignment' | 'level-change';
+export interface MoldableHapticAvailability {
+    /** Compatibility alias for apiAvailable. */
+    available: boolean;
+    /** Whether the host can submit feedback requests to the operating system. */
+    apiAvailable: boolean;
+    /** Physical haptic hardware cannot be detected reliably by the macOS API. */
+    hardwareStatus: 'unknown' | 'unavailable';
+    patterns: MoldableHapticPattern[];
+    reason?: string;
+}
+export interface MoldableHapticResult {
+    /** Compatibility alias indicating that the OS accepted the request. */
+    performed: true;
+    accepted: true;
+    /** macOS does not report whether compatible hardware produced feedback. */
+    physicalFeedback: 'unknown';
+    pattern: MoldableHapticPattern;
+}
+export declare function getMoldableHapticAvailability(options?: NativeHardwareBridgeOptions): Promise<MoldableHapticAvailability>;
+export declare function performMoldableHapticFeedback(pattern?: MoldableHapticPattern, options?: NativeHardwareBridgeOptions): Promise<MoldableHapticResult>;
+//# sourceMappingURL=haptics.d.ts.map

package/dist/lib/native-hardware/haptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../../../src/lib/native-hardware/haptics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,UAAU,CAAA;AAEjB,eAAO,MAAM,2BAA2B,EAAG,yBAAkC,CAAA;AAC7E,eAAO,MAAM,0BAA0B,EACrC,gCAAyC,CAAA;AAE3C,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAA;AAE5E,MAAM,WAAW,0BAA0B;IACzC,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAA;IAClB,6EAA6E;IAC7E,YAAY,EAAE,OAAO,CAAA;IACrB,6EAA6E;IAC7E,cAAc,EAAE,SAAS,GAAG,aAAa,CAAA;IACzC,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,SAAS,EAAE,IAAI,CAAA;IACf,QAAQ,EAAE,IAAI,CAAA;IACd,2EAA2E;IAC3E,gBAAgB,EAAE,SAAS,CAAA;IAC3B,OAAO,EAAE,qBAAqB,CAAA;CAC/B;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CAUrC;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,qBAAiC,EAC1C,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAW/B"}

package/dist/lib/native-hardware/haptics.js

@@ -0,0 +1,18 @@
+import { callNativeHardwareBridge, } from './bridge';
+export const NATIVE_HAPTICS_REQUEST_TYPE = 'moldable:native-haptics';
+export const NATIVE_HAPTICS_RESULT_TYPE = 'moldable:native-haptics-result';
+export function getMoldableHapticAvailability(options = {}) {
+    return callNativeHardwareBridge({
+        type: NATIVE_HAPTICS_REQUEST_TYPE,
+        capability: 'haptics',
+        action: 'getAvailability',
+    }, NATIVE_HAPTICS_RESULT_TYPE, options);
+}
+export function performMoldableHapticFeedback(pattern = 'generic', options = {}) {
+    return callNativeHardwareBridge({
+        type: NATIVE_HAPTICS_REQUEST_TYPE,
+        capability: 'haptics',
+        action: 'perform',
+        pattern,
+    }, NATIVE_HAPTICS_RESULT_TYPE, options);
+}

package/dist/lib/native-hardware/hid-native.d.ts

@@ -0,0 +1,26 @@
+import type { MoldableHidDevice, MoldableHidInputReportEvent } from './hid';
+import { type MoldableNativeDeviceDescriptor } from './native-device-io';
+export declare class NativeMoldableHidDevice extends EventTarget implements MoldableHidDevice {
+    readonly descriptor: MoldableNativeDeviceDescriptor;
+    readonly vendorId: number;
+    readonly productId: number;
+    readonly productName: string;
+    private handle?;
+    private closing?;
+    private inputPump?;
+    private readonly lifecycle;
+    constructor(descriptor: MoldableNativeDeviceDescriptor);
+    get opened(): boolean;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    forget(): Promise<void>;
+    sendReport(reportId: number, data: BufferSource): Promise<void>;
+    sendFeatureReport(reportId: number, data: BufferSource): Promise<void>;
+    receiveFeatureReport(reportId: number): Promise<DataView>;
+    listen(listener: (event: MoldableHidInputReportEvent) => void, signal?: AbortSignal): () => void;
+    private startInputPump;
+    private readLoop;
+    private execute;
+}
+export declare function isNativeMoldableHidDevice(device: MoldableHidDevice): device is NativeMoldableHidDevice;
+//# sourceMappingURL=hid-native.d.ts.map

package/dist/lib/native-hardware/hid-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid-native.d.ts","sourceRoot":"","sources":["../../../src/lib/native-hardware/hid-native.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,OAAO,CAAA;AAC3E,OAAO,EACL,KAAK,8BAA8B,EAMpC,MAAM,oBAAoB,CAAA;AAM3B,qBAAa,uBACX,SAAQ,WACR,YAAW,iBAAiB;IAUhB,QAAQ,CAAC,UAAU,EAAE,8BAA8B;IAR/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;gBAEnC,UAAU,EAAE,8BAA8B;IAO/D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAW/D,MAAM,CACJ,QAAQ,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,EACtD,MAAM,CAAC,EAAE,WAAW,GACnB,MAAM,IAAI;IAiBb,OAAO,CAAC,cAAc;YASR,QAAQ;YA6DR,OAAO;CA+BtB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,GACxB,MAAM,IAAI,uBAAuB,CAEnC"}