@bridgething/client 0.12.0 → 0.14.0

package/dist/settings-protocol.d.ts

@@ -0,0 +1,259 @@
+import type { ConfigEntry, ConfigField, DocEntry } from '@bridgething/lib';
+import type { WebappBlobEntry } from '@bridgething/lib/gateway';
+import type { Theme } from './theme.js';
+export type { ConfigEntry, ConfigField, DocEntry } from '@bridgething/lib';
+export type { WebappBlobEntry } from '@bridgething/lib/gateway';
+export type { Theme, ThemeColor, ThemeFont, ThemeScheme, ThemeText } from './theme.js';
+export type SettingsContext = {
+    webappId: string;
+    name: string;
+    version: string;
+    deviceId: string;
+    theme?: Theme;
+};
+export type BodyKind = 'text' | 'base64';
+export type WireBody = {
+    kind: BodyKind;
+    data: string;
+};
+export type WireHeader = [name: string, value: string];
+export type FetchVerbRequest = {
+    url: string;
+    method?: string;
+    headers?: WireHeader[];
+    body?: WireBody;
+    timeoutMs?: number;
+};
+export type FetchVerbReply = {
+    status: number;
+    headers: WireHeader[];
+    body: WireBody;
+};
+export type AuthorizeVerbRequest = {
+    url: string;
+};
+export type AuthorizeVerbReply = {
+    url: string;
+};
+export type KeyRequest = {
+    key: string;
+};
+export type KeyValueRequest = {
+    key: string;
+    value: string;
+};
+export type KeyValue = {
+    key: string;
+    value: string | null;
+};
+export type PickKind = 'image' | 'video' | 'any';
+export type PickVerbRequest = {
+    kind: PickKind;
+    cover?: [width: number, height: number];
+};
+export type PickedMedia = {
+    handle: string;
+    mime: string;
+    size: number;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+    preview?: string;
+};
+export type BlobCreateRequest = {
+    mime: string;
+};
+export type BlobHandleReply = {
+    handle: string;
+};
+export type BlobAppendRequest = {
+    handle: string;
+    data: string;
+};
+export type BlobAppendReply = {
+    handle: string;
+    size: number;
+};
+export type BlobPutRequest = {
+    key: string;
+    handle: string;
+};
+export type ByteProgress = {
+    sent: number;
+    total: number;
+};
+export type SettingsVerbs = {
+    context: {
+        request: void;
+        reply: SettingsContext;
+    };
+    'config.fields': {
+        request: void;
+        reply: ConfigField[];
+    };
+    'config.list': {
+        request: void;
+        reply: ConfigEntry[];
+    };
+    'config.set': {
+        request: KeyValueRequest;
+        reply: KeyValue;
+    };
+    'config.delete': {
+        request: KeyRequest;
+        reply: KeyValue;
+    };
+    'doc.get': {
+        request: KeyRequest;
+        reply: KeyValue;
+    };
+    'doc.list': {
+        request: void;
+        reply: DocEntry[];
+    };
+    'doc.set': {
+        request: KeyValueRequest;
+        reply: KeyValue;
+    };
+    'doc.delete': {
+        request: KeyRequest;
+        reply: {
+            key: string;
+            value: null;
+        };
+    };
+    fetch: {
+        request: FetchVerbRequest;
+        reply: FetchVerbReply;
+    };
+    'auth.authorize': {
+        request: AuthorizeVerbRequest;
+        reply: AuthorizeVerbReply;
+    };
+    pick: {
+        request: PickVerbRequest;
+        reply: PickedMedia | null;
+    };
+    'blob.create': {
+        request: BlobCreateRequest;
+        reply: BlobHandleReply;
+    };
+    'blob.append': {
+        request: BlobAppendRequest;
+        reply: BlobAppendReply;
+    };
+    'blob.put': {
+        request: BlobPutRequest;
+        reply: WebappBlobEntry;
+        progress: ByteProgress;
+    };
+    'blob.delete': {
+        request: KeyRequest;
+        reply: {
+            key: string;
+        };
+    };
+    'blob.list': {
+        request: void;
+        reply: WebappBlobEntry[];
+    };
+};
+export type SettingsVerb = keyof SettingsVerbs;
+export type SettingsPayload<V extends SettingsVerb> = SettingsVerbs[V]['request'];
+export type SettingsResult<V extends SettingsVerb> = SettingsVerbs[V]['reply'];
+export type SettingsProgress<V extends SettingsVerb> = SettingsVerbs[V] extends {
+    progress: infer P;
+} ? P : never;
+export type SettingsRequest = {
+    [V in SettingsVerb]: {
+        id: number;
+        verb: V;
+        payload?: SettingsPayload<V>;
+        epoch?: number;
+    };
+}[SettingsVerb] | {
+    id: number;
+    verb: 'done';
+    epoch?: number;
+} | {
+    id: number;
+    verb: 'release';
+    epoch: number;
+} | {
+    id: number;
+    verb: 'resize';
+    payload: {
+        height: number;
+    };
+};
+export type SettingsReply = {
+    id: number;
+    ok: true;
+    value: unknown;
+    epoch?: number;
+} | {
+    id: number;
+    ok: false;
+    error: string;
+};
+export type SettingsNotice = {
+    event: 'docChanged';
+    key: string;
+    value: string | null;
+} | {
+    event: 'themeChanged';
+    theme: Theme;
+} | {
+    event: 'refresh';
+    context: SettingsContext;
+};
+export type SettingsEvent = SettingsNotice | {
+    event: 'contextChanged';
+    context: SettingsContext;
+    epoch: number;
+} | ({
+    event: 'progress';
+    id: number;
+} & ByteProgress);
+export type SettingsMessage = SettingsReply | SettingsEvent;
+export type SettingsHost = {
+    [V in SettingsVerb]: (payload: SettingsPayload<V>, report: (progress: SettingsProgress<V>) => void) => Promise<SettingsResult<V>>;
+} & {
+    done(): void;
+};
+export type SettingsSessionOptions<T> = {
+    target: T | null;
+    bind: (target: T) => SettingsHost;
+    deliver: (message: SettingsMessage) => void;
+    explain?: (err: unknown) => string;
+    resize?: (height: number) => void;
+};
+export type SettingsSession<T> = {
+    readonly target: T | null;
+    readonly closed: boolean;
+    receive(raw: unknown): void;
+    retarget(target: T, context: SettingsContext): void;
+    notify(notice: SettingsNotice): void;
+    close(): void;
+};
+export declare const UNKNOWN_VERB = "unknown settings bridge verb";
+export declare const NO_SETTINGS_TARGET = "no app is selected for settings";
+export declare const UNKNOWN_SETTINGS_EPOCH = "settings bridge request names an epoch this page was never given or released";
+export declare const PICK_BUSY = "busy: a pick is already in flight";
+export declare const MAX_COVER_EDGE = 4294967295;
+export declare const BLOB_CHUNK_BYTES: number;
+export type BlobData = Blob | ArrayBuffer | ArrayBufferView;
+export declare function base64FromBytes(bytes: Uint8Array): string;
+export declare function blobChunks(data: BlobData): AsyncGenerator<Uint8Array>;
+export declare const DEFAULT_SETTINGS_KEY = "default";
+export type LoadedSettingsPage = {
+    target: string | null;
+    key: string;
+    stamp: string | null;
+};
+export type SettingsSwitch = 'stay' | 'refresh' | 'retarget' | 'load';
+export declare function settingsPageKey(target: string, settingsHash: string | null | undefined): string;
+export declare function settingsSwitch(loaded: LoadedSettingsPage, target: string, key: string, stamp: string): SettingsSwitch;
+export declare function decodeSettingsMessage(raw: unknown): SettingsMessage | null;
+export declare function openSettingsSession<T>(options: SettingsSessionOptions<T>): SettingsSession<T>;
+//# sourceMappingURL=settings-protocol.d.ts.map

package/dist/settings-protocol.d.ts.map

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

package/dist/settings-protocol.js

@@ -0,0 +1,216 @@
+export const UNKNOWN_VERB = 'unknown settings bridge verb';
+export const NO_SETTINGS_TARGET = 'no app is selected for settings';
+export const UNKNOWN_SETTINGS_EPOCH = 'settings bridge request names an epoch this page was never given or released';
+export const PICK_BUSY = 'busy: a pick is already in flight';
+export const MAX_COVER_EDGE = 0xffff_ffff;
+export const BLOB_CHUNK_BYTES = 256 * 1024;
+export function base64FromBytes(bytes) {
+    const chunk = 0x8000;
+    let binary = '';
+    for (let at = 0; at < bytes.length; at += chunk) {
+        binary += String.fromCharCode(...bytes.subarray(at, at + chunk));
+    }
+    return btoa(binary);
+}
+export async function* blobChunks(data) {
+    if (data instanceof Blob) {
+        for (let at = 0; at < data.size; at += BLOB_CHUNK_BYTES) {
+            yield new Uint8Array(await data.slice(at, at + BLOB_CHUNK_BYTES).arrayBuffer());
+        }
+        return;
+    }
+    const bytes = ArrayBuffer.isView(data)
+        ? new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
+        : new Uint8Array(data);
+    for (let at = 0; at < bytes.length; at += BLOB_CHUNK_BYTES)
+        yield bytes.subarray(at, at + BLOB_CHUNK_BYTES);
+}
+export const DEFAULT_SETTINGS_KEY = 'default';
+export function settingsPageKey(target, settingsHash) {
+    return settingsHash ? `${target}#${settingsHash}` : DEFAULT_SETTINGS_KEY;
+}
+export function settingsSwitch(loaded, target, key, stamp) {
+    if (loaded.key !== key)
+        return 'load';
+    if (loaded.target !== target)
+        return key === DEFAULT_SETTINGS_KEY ? 'retarget' : 'load';
+    return loaded.stamp === stamp ? 'stay' : 'refresh';
+}
+function text(fields, name) {
+    const value = fields[name];
+    if (typeof value !== 'string')
+        throw new Error(`settings bridge payload needs a string ${name}`);
+    return value;
+}
+const PICK_KINDS = ['image', 'video', 'any'];
+function pickKind(fields) {
+    const kind = text(fields, 'kind');
+    if (!PICK_KINDS.includes(kind)) {
+        throw new Error(`settings bridge pick kind must be one of ${PICK_KINDS.join(', ')}`);
+    }
+    return kind;
+}
+function edge(value) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1 || value > MAX_COVER_EDGE) {
+        throw new Error(`settings bridge pick cover edges must be whole numbers from 1 to ${MAX_COVER_EDGE}`);
+    }
+    return value;
+}
+function pick(fields) {
+    const cover = fields.cover;
+    if (cover === undefined || cover === null)
+        return { kind: pickKind(fields) };
+    if (!Array.isArray(cover) || cover.length !== 2) {
+        throw new Error('settings bridge pick cover must be [width, height]');
+    }
+    return { kind: pickKind(fields), cover: [edge(cover[0]), edge(cover[1])] };
+}
+const none = () => undefined;
+const key = (fields) => ({ key: text(fields, 'key') });
+const keyValue = (fields) => ({ key: text(fields, 'key'), value: text(fields, 'value') });
+const PAYLOADS = {
+    context: none,
+    'config.fields': none,
+    'config.list': none,
+    'config.set': keyValue,
+    'config.delete': key,
+    'doc.get': key,
+    'doc.list': none,
+    'doc.set': keyValue,
+    'doc.delete': key,
+    fetch: fields => ({ ...fields, url: text(fields, 'url') }),
+    'auth.authorize': fields => ({ url: text(fields, 'url') }),
+    pick,
+    'blob.create': fields => ({ mime: text(fields, 'mime') }),
+    'blob.append': fields => ({ handle: text(fields, 'handle'), data: text(fields, 'data') }),
+    'blob.put': fields => ({ key: text(fields, 'key'), handle: text(fields, 'handle') }),
+    'blob.delete': key,
+    'blob.list': none,
+};
+function isVerb(verb) {
+    return Object.prototype.hasOwnProperty.call(PAYLOADS, verb);
+}
+function invoke(host, verb, fields, report) {
+    const handler = host[verb];
+    return handler(PAYLOADS[verb](fields), report);
+}
+function describe(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function decodeSettingsMessage(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed === 'object' && parsed !== null ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function decodeSettingsRequest(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    let request;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        request = parsed;
+    }
+    catch {
+        return null;
+    }
+    const { id, verb, payload, epoch } = request;
+    if (typeof id !== 'number' || typeof verb !== 'string')
+        return null;
+    return {
+        id,
+        verb,
+        fields: typeof payload === 'object' && payload !== null ? payload : {},
+        epoch: typeof epoch === 'number' ? epoch : 0,
+    };
+}
+export function openSettingsSession(options) {
+    const explain = options.explain ?? describe;
+    let target = options.target;
+    let current = 0;
+    const hosts = new Map([[0, target === null ? null : options.bind(target)]]);
+    let closed = false;
+    const deliver = (message) => {
+        if (!closed)
+            options.deliver(message);
+    };
+    const receive = (raw) => {
+        if (closed)
+            return;
+        const request = decodeSettingsRequest(raw);
+        if (!request)
+            return;
+        const { id, verb, fields } = request;
+        const now = current;
+        if (verb === 'done') {
+            if (request.epoch === now)
+                hosts.get(now)?.done();
+            return;
+        }
+        if (verb === 'release') {
+            if (request.epoch < now)
+                hosts.delete(request.epoch);
+            return;
+        }
+        if (verb === 'resize') {
+            const { height } = fields;
+            if (typeof height === 'number' && height > 0)
+                options.resize?.(height);
+            return;
+        }
+        void (async () => {
+            try {
+                if (!isVerb(verb))
+                    throw new Error(`${UNKNOWN_VERB}: ${verb}`);
+                const at = verb === 'context' ? now : request.epoch;
+                const bound = hosts.get(at);
+                if (bound === undefined)
+                    throw new Error(UNKNOWN_SETTINGS_EPOCH);
+                if (bound === null)
+                    throw new Error(NO_SETTINGS_TARGET);
+                const report = ({ sent, total }) => deliver({ event: 'progress', id, sent, total });
+                const value = await invoke(bound, verb, fields, report);
+                if (verb !== 'context')
+                    deliver({ id, ok: true, value });
+                else if (current === now)
+                    deliver({ id, ok: true, value, epoch: now });
+                else
+                    receive(raw);
+            }
+            catch (err) {
+                deliver({ id, ok: false, error: explain(err) });
+            }
+        })();
+    };
+    return {
+        get target() {
+            return target;
+        },
+        get closed() {
+            return closed;
+        },
+        receive,
+        retarget(next, context) {
+            if (closed)
+                return;
+            target = next;
+            current += 1;
+            hosts.set(current, options.bind(next));
+            deliver({ event: 'contextChanged', context, epoch: current });
+        },
+        notify(notice) {
+            deliver(notice);
+        },
+        close() {
+            closed = true;
+        },
+    };
+}
+//# sourceMappingURL=settings-protocol.js.map

package/dist/settings-protocol.js.map

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

package/dist/settings.d.ts

@@ -1,45 +1,23 @@
-import type { ConfigEntry, ConfigField, DocEntry } from '@bridgething/lib';
-export type { ConfigEntry, ConfigField, DocEntry } from '@bridgething/lib';
-export type SettingsContext = {
-    webappId: string;
-    name: string;
-    version: string;
-    deviceId: string;
-};
-export type BodyKind = 'text' | 'base64';
-export type WireBody = {
-    kind: BodyKind;
-    data: string;
-};
-export type WireHeader = [name: string, value: string];
-export type FetchVerbRequest = {
-    url: string;
-    method?: string;
-    headers?: WireHeader[];
-    body?: WireBody;
-    timeoutMs?: number;
-};
-export type FetchVerbReply = {
-    status: number;
-    headers: WireHeader[];
-    body: WireBody;
-};
-export type AuthorizeVerbRequest = {
-    url: string;
-};
-export type AuthorizeVerbReply = {
-    url: string;
-};
+import { type BlobData, type ConfigEntry, type ConfigField, type DocEntry, type KeyValue, type PickKind, type PickedMedia, type SettingsContext, type Theme, type WebappBlobEntry } from './settings-protocol.js';
+export type { AuthorizeVerbReply, AuthorizeVerbRequest, BlobData, BodyKind, ByteProgress, ConfigEntry, ConfigField, DocEntry, FetchVerbReply, FetchVerbRequest, KeyValue, PickKind, PickedMedia, SettingsContext, Theme, ThemeColor, ThemeFont, ThemeScheme, ThemeText, WebappBlobEntry, WireBody, WireHeader, } from './settings-protocol.js';
 export type SettingsRequestInit = RequestInit & {
     timeoutMs?: number;
 };
 export type FetchErrorKind = 'network' | 'timeout' | 'invalid_url';
 export type AuthorizeErrorKind = 'cancelled' | 'busy' | 'unsupported';
-export type KeyValue = {
-    key: string;
-    value: string | null;
+export type BlobErrorKind = 'unsupported' | 'disconnected' | 'too_large' | 'quota_exceeded' | 'storage_full' | 'not_media' | 'unknown_handle' | 'busy' | 'no_gesture' | 'failed';
+export type PickOptions = {
+    kind: PickKind;
+    cover?: [width: number, height: number];
+};
+export type BlobProgressListener = (sent: number, total: number) => void;
+export type BlobPutOptions = {
+    onProgress?: BlobProgressListener;
 };
 export type DocChangedListener = (key: string, value: string | null) => void;
+export type ThemeChangedListener = (theme: Theme) => void;
+export type ContextChangedListener = (context: SettingsContext, previous: SettingsContext | null) => void;
+export type RefreshListener = (context: SettingsContext) => void;
 declare global {
     interface Window {
         ReactNativeWebView?: {
@@ -52,13 +30,27 @@ export declare class SettingsFetchError extends Error {
     readonly kind: FetchErrorKind;
     constructor(kind: FetchErrorKind, message: string);
 }
+export declare class BlobError extends Error {
+    readonly kind: BlobErrorKind;
+    constructor(kind: BlobErrorKind, message: string);
+}
 export declare class AuthorizeError extends Error {
     readonly kind: AuthorizeErrorKind;
     constructor(kind: AuthorizeErrorKind, message: string);
 }
+export type ConfigVerbs = {
+    fields(): Promise<ConfigField[]>;
+    list(): Promise<ConfigEntry[]>;
+    set(key: string, value: string): Promise<KeyValue>;
+    delete(key: string): Promise<KeyValue>;
+};
+export type PinnedConfigVerbs = ConfigVerbs & {
+    release(): void;
+};
 export declare const settings: {
     context(): Promise<SettingsContext>;
     config: {
+        pin(): PinnedConfigVerbs;
         fields(): Promise<ConfigField[]>;
         list(): Promise<ConfigEntry[]>;
         set(key: string, value: string): Promise<KeyValue>;
@@ -78,7 +70,18 @@ export declare const settings: {
     auth: {
         authorize(url: string | URL): Promise<URL>;
     };
+    pick(options: PickOptions): Promise<PickedMedia | null>;
+    blob: {
+        create(mime: string): Promise<string>;
+        append(handle: string, data: BlobData): Promise<number>;
+        put(key: string, handle: string, options?: BlobPutOptions): Promise<WebappBlobEntry>;
+        delete(key: string): Promise<void>;
+        list(): Promise<WebappBlobEntry[]>;
+    };
     onDocChanged(listener: DocChangedListener): () => void;
+    onThemeChanged(listener: ThemeChangedListener): () => void;
+    onContextChanged(listener: ContextChangedListener): () => void;
+    onRefresh(listener: RefreshListener): () => void;
     done(): void;
 };
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,EAGb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,EAKpB,KAAK,KAAK,EACV,KAAK,eAAe,EAGrB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,eAAe,EACf,KAAK,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,wBAAwB,CAAC;AAUhC,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;AACtE,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,MAAM,GACN,YAAY,GACZ,QAAQ,CAAC;AACb,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG;IAAE,UAAU,CAAC,EAAE,oBAAoB,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAC1D,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;AAC1G,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;AASjE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE;YAAE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAC;QAC7D,4BAA4B,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KACvD;CACF;AA4HD,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,cAAc;gBAApB,IAAI,EAAE,cAAc,EACpC,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,SAAU,SAAQ,KAAK;aAEhB,IAAI,EAAE,aAAa;gBAAnB,IAAI,EAAE,aAAa,EACnC,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAAE,kBAAkB;gBAAxB,IAAI,EAAE,kBAAkB,EACxC,OAAO,EAAE,MAAM;CAKlB;AAiID,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxC,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC;AAWlE,eAAO,MAAM,QAAQ;eACF,OAAO,CAAC,eAAe,CAAC;;eAOhC,iBAAiB;kBAxBhB,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,OAAO,CAAC,WAAW,EAAE,CAAC;iBACrB,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;oBACtC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;;;iBA0C3B,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;gBAG3B,OAAO,CAAC,QAAQ,EAAE,CAAC;iBAGlB,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;oBAGtC,MAAM,GAAG,OAAO,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,IAAI,CAAA;SAAE,CAAC;;iBAIzC,WAAW,GAAG,GAAG,SAAS,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;oBASpE,MAAM,IAAI;;uBASH,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;;kBASpC,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;;qBAQlC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;uBAGtB,MAAM,QAAQ,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;iBAOpD,MAAM,UAAU,MAAM,YAAW,cAAc,GAAQ,OAAO,CAAC,eAAe,CAAC;oBAGtE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAGhC,OAAO,CAAC,eAAe,EAAE,CAAC;;2BAIb,kBAAkB,GAAG,MAAM,IAAI;6BAM7B,oBAAoB,GAAG,MAAM,IAAI;+BAM/B,sBAAsB,GAAG,MAAM,IAAI;wBAM1C,eAAe,GAAG,MAAM,IAAI;YAMxC,IAAI;CAGb,CAAC"}