@brass-build/client 0.1.0

package/dist/document-commands.d.ts

@@ -0,0 +1,93 @@
+import type { DocumentHistoryResult, DocumentSettingsFocus, DocumentSettingsResult, DriveResolveResult } from './hosted-ui.js';
+import type { BranchSummary } from './documents-namespace.js';
+export interface HostedUiProvider {
+    documentHistory(docId: string, options?: {
+        branch?: string;
+    }): Promise<DocumentHistoryResult | null>;
+    documentSettings(docId: string, options?: {
+        focus?: DocumentSettingsFocus;
+    }): Promise<DocumentSettingsResult | null>;
+    refreshName?: (docId: string) => Promise<string | null>;
+    openSiblingDoc?: (docId: string, options: {
+        branch?: string;
+        version?: number;
+    }) => Promise<void>;
+    selectBranch?: (docId: string, options?: {
+        branch?: string;
+    }) => Promise<{
+        branch_id: string;
+    } | null>;
+    driveResolve?: (docId: string) => Promise<DriveResolveResult | null>;
+    acquireOrganization?: () => Promise<{
+        organization_id: string;
+    } | null>;
+    documentDownloadable?: (docId: string) => Promise<boolean | null>;
+}
+export interface Command {
+    readonly id: string;
+    readonly label: string;
+    readonly group: CommandGroup;
+    readonly surface: CommandSurface;
+    readonly enabled: boolean;
+    readonly running: boolean;
+    readonly children?: readonly Command[];
+    readonly selected?: boolean;
+    run(): Promise<void>;
+}
+export type CommandGroup = 'session' | 'document' | 'edit';
+export type CommandSurface = 'menu' | 'toolbar';
+export declare function makeLiveCommand(spec: Pick<Command, 'id' | 'group' | 'surface' | 'selected'> & {
+    label: string | (() => string);
+    isEnabled?: () => boolean;
+    impl: () => Promise<void> | void;
+}, wiring: {
+    running?: Map<string, boolean>;
+    onError: (err: unknown) => void;
+    notify?: () => void;
+}): Command;
+export interface CommandMenuHost {
+    docId(): string | null;
+    branchId(): string | null;
+    readOnly(): boolean;
+    isLive(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    undo(): void;
+    redo(): void;
+    checkoutVersion(version: number): Promise<void>;
+    browseVersions(): void;
+    branches(): readonly BranchSummary[];
+    hasBranchProvider(): boolean;
+    createBranch(input: {
+        name?: string;
+        from_version?: number;
+    }): Promise<BranchSummary>;
+    refreshBranches(): Promise<void>;
+    setName(name: string): void;
+    onCommandsChanged(): void;
+}
+export declare class CommandMenu {
+    private readonly host;
+    private _hostedUi;
+    private readonly _builtinRunning;
+    private _builtinCommands;
+    private _onError;
+    private _downloadable;
+    private _downloadableSettled;
+    private _downloadableInFlight;
+    private _downloadableAttempts;
+    private _downloadableRetryAt;
+    constructor(host: CommandMenuHost);
+    setHostedUiProvider(provider: HostedUiProvider | null): void;
+    setErrorReporter(reporter: ((err: Error) => void) | null): void;
+    get commands(): readonly Command[];
+    private _resolveDownloadable;
+    run(commandId: string): Promise<void>;
+    forkFromVersion(fromVersion: number, name?: string): Promise<void>;
+    private _builtins;
+    private _reportError;
+    private _buildCommand;
+    private _openDuplicate;
+    private _buildBranchesCommand;
+}
+//# sourceMappingURL=document-commands.d.ts.map

package/dist/document-commands.d.ts.map

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

package/dist/document-commands.js

@@ -0,0 +1,423 @@
+// Document file-menu commands: the per-doc list of built-in actions a
+// multi-doc app reads as data and places into its own chrome (Version
+// history / Branches / Details / Share / Delete suggested for the menu,
+// Undo / Redo suggested for the toolbar), plus the branches submenu.
+//
+// The SDK owns the action set, each command's live `enabled` / `running`
+// state, and its `run()`; the app owns placement and styling. Each
+// command carries a `surface` hint ('menu' | 'toolbar') the app is free
+// to honor or ignore. The SDK does not render the menu itself: an app
+// surfaces its own actions with its own buttons and calls SDK methods
+// directly.
+// Built-in doc-scoped command labels. The session adds 'new' / 'open'
+// (which don't need an active doc) at its own level.
+const DOC_COMMAND_LABELS = {
+    history: 'Version history...',
+    branches: 'Branches...',
+    // Rename / move / delete are one surface ("the document's place in the
+    // filesystem"), so they are one menu entry, not separate Details + Delete.
+    manage: 'Manage...',
+    share: 'Share...',
+    undo: 'Undo',
+    redo: 'Redo',
+};
+// The `share` label on a document someone can take a file away from.
+// Taking a copy out is one row of the share dialog, beside the access
+// roster, the way a phone's share sheet holds "save a file" next to "send
+// to a person", so it earns a name in the entry that opens that dialog
+// rather than a menu entry of its own. A document with no file to hand
+// over keeps the plain label, so the entry never names a download the
+// dialog does not offer.
+const SHARE_WITH_DOWNLOAD_LABEL = 'Share / Download...';
+// How many times a document's downloadable read may be attempted before the
+// label stays as it is for the rest of the document's life, and how long a
+// read that could not tell holds off the next attempt. The delay is what
+// makes the retry cover the case it exists for: a session emits several
+// times in its first second, so retrying per render would spend every
+// attempt before the install that refused the read has landed.
+const DOWNLOADABLE_MAX_ATTEMPTS = 3;
+const DOWNLOADABLE_RETRY_DELAY_MS = 5000;
+// Suggested chrome per built-in: the per-doc actions live in the file
+// menu; Undo / Redo are toolbar buttons (the shape canvas / text apps
+// reach for). 'branches' is built separately but shares the 'menu' hint.
+const DOC_COMMAND_SURFACES = {
+    history: 'menu',
+    branches: 'menu',
+    manage: 'menu',
+    share: 'menu',
+    undo: 'toolbar',
+    redo: 'toolbar',
+};
+function commandToError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+// Assemble a live `Command`. The returned object exposes `label` /
+// `enabled` / `running` as getters over the injected state, so one stable
+// instance reflects state changes and reconcilers match it by reference;
+// never spread it (`{ ...cmd }` snapshots the getters into frozen values).
+export function makeLiveCommand(spec, wiring) {
+    const { running: map, onError, notify } = wiring;
+    const label = spec.label;
+    const readLabel = typeof label === 'function' ? label : () => label;
+    let localFlag = false;
+    const readRunning = map
+        ? () => map.get(spec.id) === true
+        : () => localFlag;
+    const setRunning = (value) => {
+        if (map)
+            map.set(spec.id, value);
+        else
+            localFlag = value;
+        notify?.();
+    };
+    const isEnabled = spec.isEnabled ?? (() => !readRunning());
+    return {
+        id: spec.id,
+        group: spec.group,
+        surface: spec.surface,
+        ...(spec.selected !== undefined ? { selected: spec.selected } : {}),
+        get label() {
+            return readLabel();
+        },
+        get enabled() {
+            return isEnabled();
+        },
+        get running() {
+            return readRunning();
+        },
+        async run() {
+            if (readRunning() || !isEnabled())
+                return;
+            setRunning(true);
+            try {
+                await spec.impl();
+            }
+            catch (err) {
+                onError(err);
+            }
+            finally {
+                setRunning(false);
+            }
+        },
+    };
+}
+export class CommandMenu {
+    host;
+    // Hosted-UI provider for built-in commands. `null` until the factory
+    // wires it; the built-ins' `enabled` rule reads `_hostedUi !== null`
+    // so they disable in tests / offline flows.
+    _hostedUi = null;
+    // Per-built-in `running` flag, set during a command's `run()` and
+    // cleared after. Drives the pending-affordance UI.
+    _builtinRunning = new Map();
+    // Lazily-built built-in command instances. The `Command` shape
+    // exposes getters that read live state (`enabled` / `running`), so
+    // the same object reflects state changes without recreating.
+    _builtinCommands = null;
+    // Optional error reporter for built-in command failures. Wired by
+    // the factory to `Brass.onError`'s emit path; `null` falls back
+    // to `console.error`.
+    _onError = null;
+    // Whether this document has a file someone can take away, which is what
+    // the `share` label names. `false` until the read lands, so the entry
+    // only ever promises what is confirmed.
+    _downloadable = false;
+    _downloadableSettled = false;
+    _downloadableInFlight = false;
+    _downloadableAttempts = 0;
+    _downloadableRetryAt = 0;
+    constructor(host) {
+        this.host = host;
+    }
+    setHostedUiProvider(provider) {
+        this._hostedUi = provider;
+    }
+    // Optional error sink for the doc's built-in commands. Wired by
+    // the factory to `Brass.onError`'s emit path so async failures
+    // surface through one stream. `null` falls back to `console.error`.
+    setErrorReporter(reporter) {
+        this._onError = reporter;
+    }
+    // The per-doc file menu, as data. Each Document carries its own list
+    // with its own `running` state; multi-doc apps render one menu per
+    // pane. The app filters by `surface` to place each command.
+    get commands() {
+        this._resolveDownloadable();
+        return this._builtins();
+    }
+    // Ask, on a read of the list, whether this document has a file to hand
+    // over. Reading the list is what every menu renderer does as it mounts,
+    // so the answer lands long before a reader opens the menu, while an app
+    // that renders no menu never spends the request.
+    //
+    // A read that could not tell (`null`: refused, or failed) leaves the
+    // plain `Share...` label and lets a later render try again, because the
+    // moment it is most likely to be refused is the first create in an
+    // organization, where the install lands seconds afterwards and the
+    // document becomes readable. The delay and the attempt cap are what keep
+    // that to a few spaced requests rather than one per render.
+    _resolveDownloadable() {
+        if (this._downloadableSettled || this._downloadableInFlight)
+            return;
+        if (this._downloadableAttempts >= DOWNLOADABLE_MAX_ATTEMPTS)
+            return;
+        if (Date.now() < this._downloadableRetryAt)
+            return;
+        const resolve = this._hostedUi?.documentDownloadable;
+        const docId = this.host.docId();
+        if (!resolve || docId === null)
+            return;
+        this._downloadableAttempts++;
+        this._downloadableInFlight = true;
+        void resolve(docId).then((downloadable) => {
+            this._downloadableInFlight = false;
+            if (downloadable === null) {
+                this._downloadableRetryAt = Date.now() + DOWNLOADABLE_RETRY_DELAY_MS;
+                return;
+            }
+            this._downloadableSettled = true;
+            if (downloadable === this._downloadable)
+                return;
+            this._downloadable = downloadable;
+            this.host.onCommandsChanged();
+        }, () => {
+            this._downloadableInFlight = false;
+            this._downloadableRetryAt = Date.now() + DOWNLOADABLE_RETRY_DELAY_MS;
+        });
+    }
+    // Invoke a command by id. A convenience for keyboard shortcuts
+    // (`Ctrl-Z` -> `doc.run('undo')`). No-op for an unknown id.
+    async run(commandId) {
+        const command = this.commands.find((c) => c.id === commandId);
+        if (command)
+            await command.run();
+    }
+    // Fork a new branch from a historical version and switch to it. Drives
+    // the hosted version bar's "Branch from here": create the branch at
+    // `fromVersion` (with the bar-supplied initial `name`, e.g. the version's
+    // timestamp), then open it via the same instance-swap the branches
+    // submenu's create uses. No-op without a hosted provider (offline /
+    // tests) or an open doc.
+    async forkFromVersion(fromVersion, name) {
+        const hosted = this._hostedUi;
+        const docId = this.host.docId();
+        if (!hosted || docId === null)
+            return;
+        const created = await this.host.createBranch({
+            from_version: fromVersion,
+            ...(name ? { name } : {}),
+        });
+        if (hosted.openSiblingDoc) {
+            await hosted.openSiblingDoc(docId, { branch: created.branch_id });
+        }
+    }
+    // Internal: lazy-build the doc-scoped built-in command list. The
+    // returned `Command` objects have getters that read live state, so
+    // an `enabled` / `running` change is reflected without recreating.
+    _builtins() {
+        if (this._builtinCommands !== null)
+            return this._builtinCommands;
+        const hasHostedUi = () => this._hostedUi !== null;
+        const editable = () => !this.host.readOnly() && this.host.isLive();
+        const list = [
+            this._buildCommand('history', DOC_COMMAND_LABELS.history, 'document', DOC_COMMAND_SURFACES.history, hasHostedUi, async () => {
+                const hosted = this._hostedUi;
+                const docId = this.host.docId();
+                if (!hosted || docId === null)
+                    return;
+                const branchId = this.host.branchId();
+                const result = await hosted.documentHistory(docId, branchId ? { branch: branchId } : undefined);
+                if (!result)
+                    return;
+                // Same-branch version preview folds onto this doc in place.
+                // Cross-branch / fork outcomes can't (they switch state
+                // entirely), so delegate to `openSiblingDoc`. Discriminate on
+                // `typeof === 'number'`, not `!== undefined`: the hosted embed
+                // evolves independently, and a fork serialized as `version: null`
+                // (a natural JSON shape) must not be misread as a version open,
+                // which would drop the user into a read-only checkout at a bogus
+                // version instead of their new editable branch.
+                const version = typeof result.version === 'number' ? result.version : null;
+                // Browse-in-the-app carries no version: it opens the host's
+                // version surface where the reader already is, so it is checked
+                // before the version / fork split rather than falling into the
+                // fork branch on its absent version.
+                if (version === null && result.browse === true) {
+                    this.host.browseVersions();
+                }
+                else if (version !== null && result.branch_id === branchId) {
+                    await this.host.checkoutVersion(version);
+                }
+                else if (hosted.openSiblingDoc) {
+                    await hosted.openSiblingDoc(docId, {
+                        branch: result.branch_id,
+                        ...(version !== null ? { version } : {}),
+                    });
+                }
+            }),
+            this._buildBranchesCommand(),
+            this._buildCommand('share', () => this._downloadable
+                ? SHARE_WITH_DOWNLOAD_LABEL
+                : DOC_COMMAND_LABELS.share, 'document', DOC_COMMAND_SURFACES.share, hasHostedUi, async () => {
+                const hosted = this._hostedUi;
+                const docId = this.host.docId();
+                if (!hosted || docId === null)
+                    return;
+                // The two surfaces are one dialog with a cross-link, so a
+                // duplicate started from Share reports its copy here too.
+                const outcome = await hosted.documentSettings(docId, {
+                    focus: 'share',
+                });
+                await this._openDuplicate(outcome);
+            }),
+            // Last of the document's entries, because it is the one holding a
+            // delete.
+            this._buildCommand('manage', DOC_COMMAND_LABELS.manage, 'document', DOC_COMMAND_SURFACES.manage, hasHostedUi, async () => {
+                const hosted = this._hostedUi;
+                const docId = this.host.docId();
+                if (!hosted || docId === null)
+                    return;
+                // The Manage surface is rename + move + duplicate + delete in
+                // one. A delete there ends via the server's `doc_gone` frame
+                // (routed into `close()`); a rename is reflected by the
+                // refreshName pull below.
+                const outcome = await hosted.documentSettings(docId, {
+                    focus: 'details',
+                });
+                if (await this._openDuplicate(outcome))
+                    return;
+                if (hosted.refreshName) {
+                    const newName = await hosted.refreshName(docId);
+                    if (newName !== null)
+                        this.host.setName(newName);
+                }
+            }),
+            this._buildCommand('undo', DOC_COMMAND_LABELS.undo, 'edit', DOC_COMMAND_SURFACES.undo, () => editable() && this.host.canUndo(), () => {
+                this.host.undo();
+            }),
+            this._buildCommand('redo', DOC_COMMAND_LABELS.redo, 'edit', DOC_COMMAND_SURFACES.redo, () => editable() && this.host.canRedo(), () => {
+                this.host.redo();
+            }),
+        ];
+        this._builtinCommands = list;
+        return list;
+    }
+    _reportError = (err) => {
+        if (this._onError)
+            this._onError(commandToError(err));
+        else
+            console.error('[Brass] doc command failed:', err);
+    };
+    // Build a single command over the shared per-id running map, notifying
+    // the host on each flip so the menu re-renders.
+    _buildCommand(id, label, group, surface, isEnabled, impl) {
+        return makeLiveCommand({ id, label, group, surface, isEnabled, impl }, {
+            running: this._builtinRunning,
+            onError: this._reportError,
+            notify: () => this.host.onCommandsChanged(),
+        });
+    }
+    // Open the copy a settings-surface duplicate produced. The copy is a
+    // different document, not another state of this one, so it goes through
+    // the same coordinator a branch switch does. Reports whether it opened,
+    // so a caller can skip the follow-up reads that describe the doc it just
+    // navigated away from.
+    async _openDuplicate(outcome) {
+        const hosted = this._hostedUi;
+        if (!outcome || !hosted?.openSiblingDoc)
+            return false;
+        await hosted.openSiblingDoc(outcome.newDocId, {});
+        return true;
+    }
+    // Build the branches submenu command. The parent is always present
+    // (enabled when the doc has a hostedUi provider for openSiblingDoc);
+    // its children are rebuilt dynamically from `doc.branches` on every
+    // access so the menu tracks branch creation / refresh reactively.
+    _buildBranchesCommand() {
+        const isEnabled = () => this._hostedUi !== null;
+        const readRunning = () => this._builtinRunning.get('branches') === true;
+        const buildChild = (id, label, selected, impl) => makeLiveCommand({
+            id,
+            label,
+            group: 'document',
+            surface: DOC_COMMAND_SURFACES.branches,
+            selected,
+            impl,
+        }, { onError: this._reportError });
+        const buildChildren = () => {
+            const items = [];
+            const docId = this.host.docId();
+            const branchId = this.host.branchId();
+            for (const b of this.host.branches()) {
+                const isCurrent = b.branch_id === branchId;
+                items.push(buildChild(`branch:${b.branch_id}`, b.name, isCurrent, async () => {
+                    if (isCurrent)
+                        return;
+                    const hosted = this._hostedUi;
+                    if (hosted?.openSiblingDoc && docId) {
+                        await hosted.openSiblingDoc(docId, {
+                            branch: b.branch_id,
+                        });
+                    }
+                }));
+            }
+            if (this.host.hasBranchProvider() && docId !== null) {
+                items.push(buildChild('branch:new', 'New branch...', false, async () => {
+                    await this.host.createBranch({});
+                    const branches = this.host.branches();
+                    const newest = branches[branches.length - 1];
+                    if (newest) {
+                        const hosted = this._hostedUi;
+                        if (hosted?.openSiblingDoc && docId) {
+                            await hosted.openSiblingDoc(docId, {
+                                branch: newest.branch_id,
+                            });
+                        }
+                    }
+                }));
+            }
+            return items;
+        };
+        return {
+            id: 'branches',
+            label: DOC_COMMAND_LABELS.branches,
+            group: 'document',
+            surface: DOC_COMMAND_SURFACES.branches,
+            get enabled() {
+                return isEnabled();
+            },
+            get running() {
+                return readRunning();
+            },
+            get children() {
+                return buildChildren();
+            },
+            run: async () => {
+                const hosted = this._hostedUi;
+                const docId = this.host.docId();
+                if (!hosted || !docId)
+                    return;
+                if (hosted.selectBranch) {
+                    const branchId = this.host.branchId();
+                    const result = await hosted.selectBranch(docId, branchId ? { branch: branchId } : undefined);
+                    if (result && result.branch_id !== branchId && hosted.openSiblingDoc) {
+                        // A different branch was chosen: reopening on it reloads the
+                        // branch list as part of the open.
+                        await hosted.openSiblingDoc(docId, {
+                            branch: result.branch_id,
+                        });
+                    }
+                    else {
+                        // No switch (dialog dismissed, or the active branch re-picked).
+                        // The dialog can rename / set-default in place, so re-pull the
+                        // list; a rename of the current branch otherwise leaves the
+                        // branch chip + page title stale (they read the name from the
+                        // cached list, which the dialog never touches).
+                        await this.host.refreshBranches();
+                    }
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=document-commands.js.map

package/dist/document-commands.js.map

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

package/dist/document-signals.d.ts

@@ -0,0 +1,53 @@
+export type DocumentGoneReason = 'deleted' | 'moved';
+export type DocumentGoneListener = (reason: DocumentGoneReason) => void;
+export type DocumentGoneUnsubscribe = () => void;
+export interface DocumentWorkStatus {
+    message: string;
+    progress?: number;
+    pending: boolean;
+    blocking?: boolean;
+}
+export type DocumentStatusListener = (status: DocumentWorkStatus) => void;
+export type DocumentStatusUnsubscribe = () => void;
+export type DocumentDriveTrackingState = 'unhydrated' | 'synced' | 'ahead' | 'behind' | 'diverged';
+export type DriveMirrorDirection = 'two_way' | 'import_only';
+export interface DocumentDriveStatus {
+    driveType: string;
+    driveName: string;
+    state: DocumentDriveTrackingState;
+    canPush: boolean;
+    label: string | null;
+    detail: string | null;
+    broken: boolean;
+    pushReplacesRemote: boolean;
+    mirrorDirection: DriveMirrorDirection;
+    ref: string;
+    refUpdatedAt: string;
+    itemName: string;
+    itemUrl: string;
+    publishing: boolean;
+}
+export type DocumentDriveStatusListener = (status: DocumentDriveStatus) => void;
+export type DocumentDriveStatusUnsubscribe = () => void;
+export declare class GoneSignal {
+    private readonly _emitter;
+    get reason(): DocumentGoneReason | null;
+    on(cb: DocumentGoneListener): DocumentGoneUnsubscribe;
+    mark(reason: DocumentGoneReason): void;
+    clearListeners(): void;
+}
+export declare class WorkStatusSignal {
+    private readonly _emitter;
+    get status(): DocumentWorkStatus | null;
+    on(cb: DocumentStatusListener): DocumentStatusUnsubscribe;
+    emit(status: DocumentWorkStatus): void;
+    clearListeners(): void;
+}
+export declare class DriveStatusSignal {
+    private readonly _emitter;
+    get status(): DocumentDriveStatus | null;
+    on(cb: DocumentDriveStatusListener): DocumentDriveStatusUnsubscribe;
+    emit(status: DocumentDriveStatus): void;
+    clearListeners(): void;
+}
+//# sourceMappingURL=document-signals.d.ts.map

package/dist/document-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-signals.d.ts","sourceRoot":"","sources":["../src/document-signals.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC;AAOjD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IAMjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAC1E,MAAM,MAAM,yBAAyB,GAAG,MAAM,IAAI,CAAC;AAMnD,MAAM,MAAM,0BAA0B,GAClC,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,CAAC;AAKf,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,aAAa,CAAC;AAO7D,MAAM,WAAW,mBAAmB;IAGlC,SAAS,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,0BAA0B,CAAC;IAGlC,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtB,MAAM,EAAE,OAAO,CAAC;IAIhB,kBAAkB,EAAE,OAAO,CAAC;IAI5B,eAAe,EAAE,oBAAoB,CAAC;IAEtC,GAAG,EAAE,MAAM,CAAC;IAEZ,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAMhB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,mBAAmB,KACxB,IAAI,CAAC;AACV,MAAM,MAAM,8BAA8B,GAAG,MAAM,IAAI,CAAC;AAcxD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOtB;IAEH,IAAI,MAAM,IAAI,kBAAkB,GAAG,IAAI,CAEtC;IAED,EAAE,CAAC,EAAE,EAAE,oBAAoB,GAAG,uBAAuB;IAIrD,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAMtC,cAAc,IAAI,IAAI;CAGvB;AAKD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMtB;IAEH,IAAI,MAAM,IAAI,kBAAkB,GAAG,IAAI,CAEtC;IAED,EAAE,CAAC,EAAE,EAAE,sBAAsB,GAAG,yBAAyB;IAIzD,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAItC,cAAc,IAAI,IAAI;CAGvB;AAOD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOtB;IAEH,IAAI,MAAM,IAAI,mBAAmB,GAAG,IAAI,CAEvC;IAED,EAAE,CAAC,EAAE,EAAE,2BAA2B,GAAG,8BAA8B;IAInE,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIvC,cAAc,IAAI,IAAI;CAGvB"}