@sagmans/dsh-tui 0.6.0 → 0.8.0

package/lib/compat/section.d.ts

@@ -0,0 +1,29 @@
+/** Keep released section ownership and Config-backed profile edits behind one checked seam. */
+import type { Context } from '@deepseek-ai/cordis';
+/** Appearance must not report success until its durable owner accepts the patch. */
+export interface SectionScope {
+    readonly kind: 'installSection' | 'register' | 'config' | 'unsupported';
+    get(): unknown;
+    update(patch: object): Promise<void>;
+    /** Raw opt-outs can precede a valid commit and therefore never reach get() or notifications. */
+    readUser(): {
+        readonly value: unknown;
+        readonly revision: number;
+    } | undefined;
+}
+/** The row reader is needed before the Loader marks the calling fiber active. */
+export interface SectionRequest<T> {
+    readonly owner: Context;
+    readonly ns: string;
+    readonly schema: unknown;
+    readonly entry: T;
+    readonly onChange: () => void;
+    readonly config?: {
+        readonly ns: string | undefined;
+        readonly get: () => unknown;
+        readonly live: boolean;
+    };
+}
+/** Never manufacture a successful write when no supported owner can persist it. */
+export declare function openSection<T>(service: unknown, request: SectionRequest<T>): SectionScope;
+//# sourceMappingURL=section.d.ts.map

package/lib/compat/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../src/compat/section.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAA;IACvE,GAAG,IAAI,OAAO,CAAA;IACd,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,gGAAgG;IAChG,QAAQ,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC/E;AAyBD,iFAAiF;AACjF,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;CAC3G;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,CAsEzF"}

package/lib/compat/section.js

@@ -0,0 +1,82 @@
+const READ_UNSUPPORTED = 'the settings service cannot read the section; prompt history stays off';
+const WRITE_UNSUPPORTED = 'the settings service cannot write the section; the patch was not applied';
+const CONFIG_NOT_LIVE = 'the settings service cannot write live Config with this schema runtime; the patch was not applied';
+/** Never manufacture a successful write when no supported owner can persist it. */
+export function openSection(service, request) {
+    const settings = (service ?? {});
+    const refuseWrite = () => Promise.reject(new Error(WRITE_UNSUPPORTED));
+    const readUser = (ns) => {
+        if (typeof settings.describe !== 'function')
+            return undefined;
+        const descriptor = settings.describe().find(row => row.ns === ns);
+        if (descriptor === undefined || !Number.isSafeInteger(descriptor.revision) || descriptor.revision < 0) {
+            throw new Error(READ_UNSUPPORTED);
+        }
+        return { value: descriptor.user, revision: descriptor.revision };
+    };
+    if (typeof settings.installSection === 'function') {
+        let source = () => request.entry;
+        // An attach notification precedes the caller receiving its scope.
+        let attached = false;
+        settings.installSection(request.owner, request.ns, request.schema, request.entry, {
+            setSource: current => { source = current; },
+            onChange: () => { if (attached)
+                request.onChange(); },
+        });
+        attached = true;
+        return {
+            kind: 'installSection',
+            readUser: () => readUser(request.ns),
+            get: () => source(),
+            update: async (patch) => {
+                if (settings.writable === false || typeof settings.update !== 'function')
+                    return refuseWrite();
+                await settings.update(request.ns, patch);
+            },
+        };
+    }
+    if (typeof settings.register === 'function') {
+        const scope = settings.register(request.ns, request.schema, { base: request.entry });
+        return {
+            kind: 'register',
+            readUser: () => readUser(request.ns),
+            get: () => scope.get(),
+            update: async (patch) => {
+                if (settings.writable === false || typeof scope.update !== 'function')
+                    return refuseWrite();
+                await scope.update(patch);
+            },
+        };
+    }
+    if (typeof settings.describe === 'function' && request.config !== undefined) {
+        const config = request.config;
+        const descriptor = () => config.ns === undefined
+            ? undefined
+            : settings.describe().find(row => row.ns === config.ns);
+        return {
+            kind: 'config',
+            readUser: () => readUser(config.ns),
+            // Config is readable during startup even before describe() includes this fiber.
+            get: () => {
+                const current = descriptor();
+                return current === undefined ? config.get() : current.value;
+            },
+            update: async (patch) => {
+                if (!config.live)
+                    throw new Error(CONFIG_NOT_LIVE);
+                const current = descriptor();
+                if (current === undefined || settings.writable === false || typeof settings.update !== 'function'
+                    || !Number.isSafeInteger(current.revision) || current.revision < 0)
+                    return refuseWrite();
+                await settings.update(current.ns, patch, current.revision);
+            },
+        };
+    }
+    return {
+        kind: 'unsupported',
+        readUser: () => { throw new Error(READ_UNSUPPORTED); },
+        get: () => { throw new Error(READ_UNSUPPORTED); },
+        update: refuseWrite,
+    };
+}
+//# sourceMappingURL=section.js.map

package/lib/compat/section.js.map

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

package/lib/config.d.ts

@@ -1,4 +1,29 @@
-import type { TuiStartup } from './contracts.ts';
+import z from '@deepseek-ai/schemastery';
+import type { TuiRowConfig } from './contracts.ts';
+/** Keep launch identity fixed while source hosts expose preferences as live Config fields. */
+export declare const Config: z<Schemastery.ObjectS<{
+    sessionId: z<string, string>;
+    resume: z<boolean, boolean>;
+    resumePicker: z<boolean, boolean>;
+    model: z<string, string>;
+    provider: z<string, string>;
+    preset: z<string, string>;
+    color: z<boolean, boolean>;
+    bell: z<boolean, boolean>;
+}>, Schemastery.ObjectT<{
+    sessionId: z<string, string>;
+    resume: z<boolean, boolean>;
+    resumePicker: z<boolean, boolean>;
+    model: z<string, string>;
+    provider: z<string, string>;
+    preset: z<string, string>;
+    color: z<boolean, boolean>;
+    bell: z<boolean, boolean>;
+}>>;
+/** Metadata alone makes source Loader skip remounts; writes require actual native references too. */
+export declare function hasLiveRowSettings(raw: unknown): boolean;
+/** Preserve raw malformed fields for the appearance owner to diagnose without losing opt-outs. */
+export declare function readRowSettings(raw: unknown): unknown;
 /** A composed row whose configuration cannot describe a runnable terminal surface. */
 export declare class TuiConfigError extends Error {
 }
@@ -9,5 +34,5 @@ export declare class TuiConfigError extends Error {
  * may hand-configure this row in a profile patch, so the row validates its own
  * input instead of trusting the layer above it.
  */
-export declare function resolveConfig(raw: unknown): TuiStartup;
+export declare function resolveConfig(raw: unknown): TuiRowConfig;
 //# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,sFAAsF;AACtF,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAsB5C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAetD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAalD,8FAA8F;AAC9F,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;GAejB,CAAA;AAUF,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQxD;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOrD;AAED,sFAAsF;AACtF,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAsB5C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAgBxD"}

package/lib/config.js

@@ -1,4 +1,63 @@
 import { SessionId } from '@deepseek-ai/dsh-session';
+import z from '@deepseek-ai/schemastery';
+import { TuiSettingsSchema } from "./theme-settings.js";
+/** Native references distinguish live Config from ordinary released schema output. */
+const VOLATILE_REFERENCE = Symbol.for('cosmokit.volatile.write');
+const PREFERENCE_SCHEMA = TuiSettingsSchema.dict;
+const PREFERENCE_FIELDS = Object.keys(PREFERENCE_SCHEMA);
+const CONFIG_HISTORY = z.object({
+    // A source host imports legacy settings after activation; absence is not consent.
+    enabled: z.boolean(),
+    ghost: z.boolean(),
+    maxEntries: PREFERENCE_SCHEMA.history.dict.maxEntries,
+});
+/** Keep launch identity fixed while source hosts expose preferences as live Config fields. */
+export const Config = z.object({
+    sessionId: z.string().required(),
+    resume: z.boolean().default(false),
+    resumePicker: z.boolean().default(false),
+    model: z.string(),
+    provider: z.string(),
+    preset: z.string(),
+    color: z.boolean().default(true),
+    bell: z.boolean().default(true),
+    ...Object.fromEntries(Object.entries(PREFERENCE_SCHEMA).map(([key, schema]) => {
+        const field = new z((key === 'history' ? CONFIG_HISTORY : schema).toJSON());
+        // False metadata makes source Loader silently skip ordinary config updates.
+        const native = field;
+        return [key, typeof native.volatile === 'function' ? native.volatile() : field];
+    })),
+});
+/** Only native Config references may execute a getter; ordinary input remains data. */
+function preferenceValue(value) {
+    if (typeof value !== 'object' || value === null || !(VOLATILE_REFERENCE in value))
+        return value;
+    const reference = value;
+    if (typeof reference.get !== 'function')
+        throw new TuiConfigError('invalid volatile preference reference');
+    return reference.get();
+}
+/** Metadata alone makes source Loader skip remounts; writes require actual native references too. */
+export function hasLiveRowSettings(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return false;
+    const record = raw;
+    return PREFERENCE_FIELDS.every(key => {
+        const value = record[key];
+        return typeof value === 'object' && value !== null && VOLATILE_REFERENCE in value
+            && typeof Reflect.get(value, 'get') === 'function';
+    });
+}
+/** Preserve raw malformed fields for the appearance owner to diagnose without losing opt-outs. */
+export function readRowSettings(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return raw;
+    const record = raw;
+    return Object.fromEntries(PREFERENCE_FIELDS.flatMap(key => {
+        const value = preferenceValue(record[key]);
+        return value === undefined ? [] : [[key, value]];
+    }));
+}
 /** A composed row whose configuration cannot describe a runnable terminal surface. */
 export class TuiConfigError extends Error {
 }
@@ -31,7 +90,7 @@ function optionalBoolean(value, field, fallback) {
  * input instead of trusting the layer above it.
  */
 export function resolveConfig(raw) {
-    if (typeof raw !== 'object' || raw === null) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
         throw new TuiConfigError('tui row configuration must be a mapping');
     }
     const record = raw;
@@ -42,6 +101,7 @@ export function resolveConfig(raw) {
         model: optionalString(record.model, 'model'),
         provider: optionalString(record.provider, 'provider'),
         preset: optionalString(record.preset, 'preset'),
+        theme: optionalString(preferenceValue(record.theme), 'theme'),
         color: optionalBoolean(record.color, 'color', true),
         bell: optionalBoolean(record.bell, 'bell', true),
     };

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGpD,sFAAsF;AACtF,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C,SAAS,aAAa,CAAC,KAAc,EAAE,KAAa;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,cAAc,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,cAAc,CAAC,GAAG,KAAK,gCAAgC,CAAC,CAAA;IACjG,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAA;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa,EAAE,QAAiB;IACvE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAA;IAC1D,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,cAAc,CAAC,GAAG,KAAK,iCAAiC,CAAC,CAAA;IACnG,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,cAAc,CAAC,yCAAyC,CAAC,CAAA;IACrE,CAAC;IACD,MAAM,MAAM,GAAG,GAA8B,CAAA;IAC7C,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;QACvD,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,CAAC;QACzE,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;QAC5C,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC;QACrD,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC/C,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;QACnD,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;KACjD,CAAA;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/lib/contracts.d.ts

@@ -22,9 +22,37 @@ export interface TuiStartup {
     /** Whether a long turn may ring the terminal bell when it finishes. */
     readonly bell: boolean;
 }
+/**
+ * The row's own configuration: every launch option, plus what only the profile
+ * can name.
+ *
+ * Split from the startup service because no command-line flag can carry these
+ * values. A harness that keeps settings per row has no `dsh-tui:` document
+ * section left to write a theme into, so the row's own config is the one place a
+ * profile patch pins it — and that makes the row the config surface for it, not
+ * the launcher.
+ */
+export interface TuiRowConfig extends TuiStartup {
+    /**
+     * Theme the row pins, below the settings section and above the package default.
+     *
+     * The section is the reader's own document and still outranks this; the
+     * package's default answers when neither names a theme.
+     */
+    readonly theme: string | undefined;
+}
 declare module '@deepseek-ai/cordis' {
     interface Context {
         tuiStartup?: TuiStartup;
+        /**
+         * Set when this invocation must print the model directory and exit instead
+         * of mounting the surface.
+         *
+         * The flag is a boolean because the directory is read after the llm row
+         * mounts, which is after the command line has already parsed: the action
+         * only orders the listing, it never prints.
+         */
+        tuiListModels?: boolean;
         /** Printed after the terminal is handed back, so the session stays recoverable. */
         tuiGoodbyeMessage?: string;
     }

package/lib/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEzD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,UAAU,CAAC,EAAE,UAAU,CAAA;QACvB,mFAAmF;QACnF,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC3B;CACF"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEzD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,UAAU,CAAC,EAAE,UAAU,CAAA;QACvB;;;;;;;WAOG;QACH,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,mFAAmF;QACnF,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC3B;CACF"}

package/lib/fold-cursor.d.ts

@@ -13,6 +13,14 @@ import type { ForkEvent } from './agent/fork.ts';
  * than the one just read — what `/new` does — would otherwise measure the new
  * conversation against the old one's numbering and drop all of it.
  */
+/** A late stored log must not repaint a transcript the reader already left. */
+export declare function replayIfCurrent<Event>(read: () => Promise<readonly Event[]>, current: () => boolean, apply: (event: Event) => void): Promise<number>;
+/** An older asynchronous fold must lose ownership when the view resets. */
+export declare class ViewGeneration {
+    private generation;
+    /** An old view cannot regain ownership if its read finishes out of order. */
+    begin(): () => boolean;
+}
 /** Consumes durable events in sequence order, each exactly once per session. */
 export declare class FoldCursor {
     private session;

package/lib/fold-cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fold-cursor.d.ts","sourceRoot":"","sources":["../src/fold-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAoB;IAEnC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAKb,2EAA2E;IAC3E,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO;CAWtD"}
+{"version":3,"file":"fold-cursor.d.ts","sourceRoot":"","sources":["../src/fold-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,wBAAsB,eAAe,CAAC,KAAK,EACzC,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,EACrC,OAAO,EAAE,MAAM,OAAO,EACtB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC5B,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,2EAA2E;AAC3E,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAI;IAEtB,6EAA6E;IAC7E,KAAK,IAAI,MAAM,OAAO;CAIvB;AAED,gFAAgF;AAChF,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAoB;IAEnC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAKb,2EAA2E;IAC3E,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO;CAWtD"}

package/lib/fold-cursor.js

@@ -11,6 +11,24 @@
  * than the one just read — what `/new` does — would otherwise measure the new
  * conversation against the old one's numbering and drop all of it.
  */
+/** A late stored log must not repaint a transcript the reader already left. */
+export async function replayIfCurrent(read, current, apply) {
+    const events = await read();
+    if (!current())
+        return 0;
+    for (const event of events)
+        apply(event);
+    return events.length;
+}
+/** An older asynchronous fold must lose ownership when the view resets. */
+export class ViewGeneration {
+    generation = 0;
+    /** An old view cannot regain ownership if its read finishes out of order. */
+    begin() {
+        const generation = ++this.generation;
+        return () => generation === this.generation;
+    }
+}
 /** Consumes durable events in sequence order, each exactly once per session. */
 export class FoldCursor {
     session;

package/lib/fold-cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"fold-cursor.js","sourceRoot":"","sources":["../src/fold-cursor.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,MAAM,OAAO,UAAU;IACb,OAAO,CAAuB;IAC9B,OAAO,CAAoB;IAEnC;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,OAAkB,EAAE,KAAgB;QACzC,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QAC1B,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAA;YACzE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAA;QAC1B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
+{"version":3,"file":"fold-cursor.js","sourceRoot":"","sources":["../src/fold-cursor.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAqC,EACrC,OAAsB,EACtB,KAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,CAAA;IACxB,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACxC,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAED,2EAA2E;AAC3E,MAAM,OAAO,cAAc;IACjB,UAAU,GAAG,CAAC,CAAA;IAEtB,6EAA6E;IAC7E,KAAK;QACH,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,UAAU,CAAA;QACpC,OAAO,GAAG,EAAE,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,CAAA;IAC7C,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,UAAU;IACb,OAAO,CAAuB;IAC9B,OAAO,CAAoB;IAEnC;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,OAAkB,EAAE,KAAgB;QACzC,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QAC1B,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAA;YACzE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAA;QAC1B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/lib/gates/question-card.d.ts

@@ -0,0 +1,77 @@
+import { type GateCard, type GateInput, type GateQuestion } from '../gates.ts';
+import { type Keymap } from '../input/actions.ts';
+import type { PositionedOption } from './questions.ts';
+/** The label a question earns for an answer the model did not list. */
+export declare const CUSTOM_ROW_LABEL = "other";
+/** What the free-text row does, said where the reader decides. */
+export declare const CUSTOM_ROW_DESCRIPTION = "type your own answer";
+/** How the list hint names that row, which the row itself already labels. */
+export declare const CUSTOM_ROW_SHORTHAND = "0 answer freely";
+/**
+ * How a hint names the keys of one action.
+ *
+ * A hint is prose about what a key does here, so the word comes from the card
+ * rather than from the catalog row, which has to read well out of context too.
+ */
+export declare function namedKeys(map: Keymap, id: string, verb: string): string;
+/**
+ * How the free-text row spells the keys that leave it.
+ *
+ * A text field keeps its own exits: the arrows and escape are the field's, not
+ * the question's, so a reader who moved question.up or question.skip somewhere
+ * else still leaves with these. The question's own movement keys leave it as
+ * well, which is how the navigation aliases reach a reader who is typing rather
+ * than filtering. The arrows stay one token because they are pinned together
+ * rather than listed one direction at a time.
+ */
+export declare function customRowExits(map: Keymap): string;
+/** The keys that answer the free-text row, where typing is the answer rather than a filter. */
+export declare function customHint(map: Keymap): string;
+/**
+ * The question-id suffix that declares a typed answer a credential. The seam
+ * has no field for it, so a caller marks its own id and the gate reads that
+ * declaration rather than the wording: ids are caller-owned, and a question
+ * that merely mentions a key must still show the answer its author meant read.
+ */
+export declare const SECRET_ID_SUFFIX = ":secret";
+/** The free-text row's label when the answer is a credential, so the reader sees what they hand over. */
+export declare const SECRET_ROW_LABEL = "API KEY";
+/** Whether a question declares its typed answer a credential through its id. */
+export declare function declaresSecret(id: string): boolean;
+/**
+ * Everything the question card draws, read off the gate at the moment of the
+ * call.
+ *
+ * The projection takes this snapshot rather than the gate itself, so a card
+ * cannot reach back into state that moved on while it was being assembled, and
+ * a test can describe a screen without building a gate to hold it.
+ */
+export interface QuestionCardView {
+    /** The question on screen, or undefined once every one has been decided. */
+    readonly question: GateQuestion | undefined;
+    /** One-based position of that question among the gate's own. */
+    readonly position: number;
+    /** How many questions the gate asks; the title admits to it only when it is more than one. */
+    readonly total: number;
+    /** Labels already chosen on this question. */
+    readonly chosen: readonly string[];
+    /** The filter the reader typed, empty when none. */
+    readonly typed: string;
+    /** Whether the cursor is on the free-text row. */
+    readonly atCustom: boolean;
+    /** Whether the editor already holds an answer; the card decides where to draw it. */
+    readonly written: boolean;
+    /** Every option matching the filter, in row order. */
+    readonly matched: readonly PositionedOption[];
+    /** The slice of those rows the window shows. */
+    readonly rows: readonly PositionedOption[];
+    /** One-based row number the window starts at, and where the cursor stands in it. */
+    readonly start: number;
+    readonly cursor: number;
+    /** The keys and the editor in force, read per draw so a settings edit lands on the next frame. */
+    readonly keys: Keymap;
+    readonly input: GateInput;
+}
+/** The card for one question: its heading, its windowed options, the free-text row, and the answer in view. */
+export declare function questionCard(view: QuestionCardView): GateCard;
+//# sourceMappingURL=question-card.d.ts.map

package/lib/gates/question-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-card.d.ts","sourceRoot":"","sources":["../../src/gates/question-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AACxG,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAE5D,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,oBAAuC,CAAA;AAExE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAA;AAEzC,yGAAyG;AACzG,eAAO,MAAM,gBAAgB,YAAY,CAAA;AAEzC,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAA;IAC3C,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC7C,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC1C,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAC1B;AAED,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,QAAQ,CAmD7D"}

package/lib/gates/question-card.js

@@ -0,0 +1,113 @@
+import { CUSTOM_ROW_NUMBER, lines } from "../gates.js";
+import { keyName, keysFor } from "../input/actions.js";
+/** The label a question earns for an answer the model did not list. */
+export const CUSTOM_ROW_LABEL = 'other';
+/** What the free-text row does, said where the reader decides. */
+export const CUSTOM_ROW_DESCRIPTION = 'type your own answer';
+/** How the list hint names that row, which the row itself already labels. */
+export const CUSTOM_ROW_SHORTHAND = `${CUSTOM_ROW_NUMBER} answer freely`;
+/**
+ * How a hint names the keys of one action.
+ *
+ * A hint is prose about what a key does here, so the word comes from the card
+ * rather than from the catalog row, which has to read well out of context too.
+ */
+export function namedKeys(map, id, verb) {
+    // One verb for the action, however many keys reach it: a hint that repeated
+    // the word would read as two actions rather than two ways to do one.
+    return `${keysFor(map, id).map(keyName).join('/')} ${verb}`;
+}
+/**
+ * How the free-text row spells the keys that leave it.
+ *
+ * A text field keeps its own exits: the arrows and escape are the field's, not
+ * the question's, so a reader who moved question.up or question.skip somewhere
+ * else still leaves with these. The question's own movement keys leave it as
+ * well, which is how the navigation aliases reach a reader who is typing rather
+ * than filtering. The arrows stay one token because they are pinned together
+ * rather than listed one direction at a time.
+ */
+export function customRowExits(map) {
+    const names = ['↑↓'];
+    for (const id of ['question.up', 'question.down']) {
+        for (const key of keysFor(map, id)) {
+            const name = keyName(key);
+            if (name !== 'up' && name !== 'down' && !names.includes(name))
+                names.push(name);
+        }
+    }
+    return names.join('/');
+}
+/** The keys that answer the free-text row, where typing is the answer rather than a filter. */
+export function customHint(map) {
+    return `type or paste an answer · ${namedKeys(map, 'question.confirm', 'confirm')} · ${namedKeys(map, 'question.cancel', 'abandon')} · ${customRowExits(map)} or esc to options`;
+}
+/**
+ * The question-id suffix that declares a typed answer a credential. The seam
+ * has no field for it, so a caller marks its own id and the gate reads that
+ * declaration rather than the wording: ids are caller-owned, and a question
+ * that merely mentions a key must still show the answer its author meant read.
+ */
+export const SECRET_ID_SUFFIX = ':secret';
+/** The free-text row's label when the answer is a credential, so the reader sees what they hand over. */
+export const SECRET_ROW_LABEL = 'API KEY';
+/** Whether a question declares its typed answer a credential through its id. */
+export function declaresSecret(id) {
+    return id.endsWith(SECRET_ID_SUFFIX);
+}
+/** The card for one question: its heading, its windowed options, the free-text row, and the answer in view. */
+export function questionCard(view) {
+    const question = view.question;
+    if (question === undefined) {
+        return { kind: 'question', title: 'question', detail: [], optionOffset: 0, options: [], custom: undefined, answerInput: undefined, hint: 'finishing' };
+    }
+    const detail = question.detail === undefined ? [] : lines(question.detail);
+    const heading = question.header === undefined ? '' : question.header + ' · ';
+    const title = `${heading}${question.question}${view.total > 1 ? `  (${view.position}/${view.total})` : ''}`;
+    if (question.options.length === 0) {
+        return {
+            kind: 'question',
+            title,
+            detail,
+            optionOffset: 0,
+            options: [],
+            custom: undefined,
+            // The editor is the only place the text lands, so it is drawn even while
+            // empty: a question answered by typing needs somewhere to paste a key.
+            answerInput: view.input,
+            hint: `type or paste an answer · ${namedKeys(view.keys, 'question.confirm', 'confirm')} · ${namedKeys(view.keys, 'question.skip', 'skip')} · ${namedKeys(view.keys, 'question.cancel', 'abandon')}`,
+        };
+    }
+    if (view.typed !== '')
+        detail.push(`filter: ${view.typed}`);
+    const secret = declaresSecret(question.id);
+    if (view.rows.length < view.matched.length)
+        detail.push(`showing ${view.start + 1}–${view.start + view.rows.length} of ${view.matched.length}`);
+    return {
+        kind: 'question',
+        title,
+        detail,
+        optionOffset: view.start,
+        options: view.rows.map(({ option }, position) => ({
+            label: option.label,
+            description: option.description,
+            // The free-text row wears the cursor when it holds it: a mark on a row
+            // the reader is not pointing at is a mark that lies.
+            current: !view.atCustom && view.start + position === view.cursor,
+            selected: view.chosen.includes(option.label),
+        })),
+        custom: {
+            label: secret ? SECRET_ROW_LABEL : CUSTOM_ROW_LABEL,
+            description: CUSTOM_ROW_DESCRIPTION,
+            current: view.atCustom,
+            selected: view.atCustom || view.written,
+        },
+        // A written answer stays in view whether or not the cursor is on the row,
+        // because it is what an enter is about to send.
+        answerInput: view.atCustom || view.written ? view.input : undefined,
+        hint: view.atCustom
+            ? customHint(view.keys)
+            : `${namedKeys(view.keys, 'question.toggle', question.multiSelect ? 'toggle' : 'select')} · digits pick · ${CUSTOM_ROW_SHORTHAND} · type to filter · ${namedKeys(view.keys, 'question.confirm', 'confirm')} · ${namedKeys(view.keys, 'question.skip', 'skip')} · ${namedKeys(view.keys, 'question.cancel', 'abandon')}`,
+    };
+}
+//# sourceMappingURL=question-card.js.map

package/lib/gates/question-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-card.js","sourceRoot":"","sources":["../../src/gates/question-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAoD,MAAM,aAAa,CAAA;AACxG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAe,MAAM,qBAAqB,CAAA;AAGnE,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAEvC,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAA;AAE5D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,iBAAiB,gBAAgB,CAAA;AAExE;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,EAAU,EAAE,IAAY;IAC7D,4EAA4E;IAC5E,qEAAqE;IACrE,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;AAC7D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAA;IACpB,KAAK,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YACzB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,6BAA6B,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,SAAS,CAAC,MAAM,SAAS,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,oBAAoB,CAAA;AAClL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAA;AAEzC,yGAAyG;AACzG,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAA;AAEzC,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;AACtC,CAAC;AAqCD,+GAA+G;AAC/G,MAAM,UAAU,YAAY,CAAC,IAAsB;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;IAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IACxJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAA;IAC5E,MAAM,KAAK,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAC3G,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,KAAK;YACL,MAAM;YACN,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,SAAS;YACjB,yEAAyE;YACzE,uEAAuE;YACvE,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,IAAI,EAAE,6BAA6B,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,SAAS,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE;SACpM,CAAA;IACH,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/I,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,MAAM;QACN,YAAY,EAAE,IAAI,CAAC,KAAK;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,uEAAuE;YACvE,qDAAqD;YACrD,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,QAAQ,KAAK,IAAI,CAAC,MAAM;YAChE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;SAC7C,CAAC,CAAC;QACH,MAAM,EAAE;YACN,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB;YACnD,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO;SACxC;QACD,0EAA0E;QAC1E,gDAAgD;QAChD,WAAW,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACnE,IAAI,EAAE,IAAI,CAAC,QAAQ;YACjB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,oBAAoB,uBAAuB,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,SAAS,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE;KAC1T,CAAA;AACH,CAAC"}