looply-cli 0.0.0-stage → 0.2.0

package/dist/settings-overlay.d.ts

@@ -0,0 +1,53 @@
+import { type LooplyConfig } from './config';
+/**
+ * Settings from the phone, laid over the config file.
+ *
+ * Every project setting was written to the server and read by nobody: the run
+ * loaded `.looply/config.yaml` and stopped there, so turning off "Check every
+ * change" on your phone changed precisely nothing about the next run. The
+ * screen was wired at both ends and terminated in a dead end.
+ *
+ * **Only settings a person actually set are applied.** The server returns every
+ * key in the registry, tagging unset ones `from: 'default'` — and those defaults
+ * are the registry's, not this project's. Applying them would mean a config
+ * saying `max_rounds: 12` silently became 400 the moment a run consulted the
+ * server, which is the opposite of respecting either source. So `default` is
+ * skipped, and the file stands wherever the phone has said nothing.
+ *
+ * Where a person HAS set one, the phone wins. That is the whole promise of a
+ * remote control: a switch you flick has to do something, and a setting that
+ * loses to a file you cannot see from the sofa is a lie told in a nice font.
+ *
+ * Every override is announced. Divergence between a committed file and a live
+ * run is only dangerous when it is silent.
+ */
+/** A setting as the server resolves it. */
+export interface ResolvedSettingLike {
+    key: string;
+    value: unknown;
+    from: string;
+}
+export interface Override {
+    key: string;
+    /** What the config file said, for the log line. */
+    was: unknown;
+    now: unknown;
+}
+export interface OverlayResult {
+    config: LooplyConfig;
+    overrides: Override[];
+    /** Set keys the run has no home for, so they are reported rather than dropped. */
+    ignored: string[];
+}
+/**
+ * Apply the settings a person set. Never mutates the config it is given.
+ *
+ * Rails are deliberately absent apart from `exemptions`: forbidden paths are
+ * the one thing a phone must not be able to widen remotely. A rail exists to
+ * stop an autonomous agent touching something, and a control that can remove it
+ * from a sofa is not a rail.
+ */
+export declare function applySettings(config: LooplyConfig, resolved: readonly ResolvedSettingLike[]): OverlayResult;
+/** The lines a run prints about what its phone changed. */
+export declare function describeOverrides(result: OverlayResult): string[];
+//# sourceMappingURL=settings-overlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-overlay.d.ts","sourceRoot":"","sources":["../src/settings-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,YAAY,EAAsB,MAAM,UAAU,CAAC;AAE/F;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,kFAAkF;IAClF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAgHD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GACvC,aAAa,CAiCf;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CASjE"}

package/dist/settings-overlay.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySettings = applySettings;
+exports.describeOverrides = describeOverrides;
+const config_1 = require("./config");
+/**
+ * Where each project setting lands in the config.
+ *
+ * A setter returns the previous value when it applied, and `undefined` when the
+ * value was the wrong shape — a bad value must not half-apply, and a caller
+ * that returns undefined is reported as ignored rather than silently dropped.
+ */
+const num = (v) => typeof v === 'number' && Number.isFinite(v) ? v : null;
+const SETTERS = {
+    'project.run.minHours': (c, v) => {
+        const n = num(v);
+        if (n === null || n <= 0)
+            return undefined;
+        const was = c.run.minHours;
+        c.run.minHours = n;
+        return was;
+    },
+    'project.run.maxRounds': (c, v) => {
+        const n = num(v);
+        if (n === null || !Number.isInteger(n) || n < 1)
+            return undefined;
+        const was = c.run.maxRounds;
+        c.run.maxRounds = n;
+        return was;
+    },
+    'project.run.cooldownS': (c, v) => {
+        const n = num(v);
+        if (n === null || n < 0)
+            return undefined;
+        const was = c.run.cooldownS;
+        c.run.cooldownS = n;
+        return was;
+    },
+    'project.proof.enabled': (c, v) => {
+        if (typeof v !== 'boolean')
+            return undefined;
+        const was = c.proof.enabled;
+        c.proof.enabled = v;
+        return was;
+    },
+    'project.proof.onPartial': (c, v) => {
+        if (v !== 'ask' && v !== 'keep' && v !== 'discard')
+            return undefined;
+        const was = c.proof.onPartial;
+        c.proof.onPartial = v;
+        return was;
+    },
+    'project.queue.topupThreshold': (c, v) => {
+        const n = num(v);
+        if (n === null || !Number.isInteger(n) || n < 0)
+            return undefined;
+        const was = c.queue.topupThreshold;
+        c.queue.topupThreshold = n;
+        return was;
+    },
+    'project.queue.topupSize': (c, v) => {
+        const n = num(v);
+        if (n === null || !Number.isInteger(n) || n < 1)
+            return undefined;
+        const was = c.queue.topupSize;
+        c.queue.topupSize = n;
+        return was;
+    },
+    'project.queue.maxSameShape': (c, v) => {
+        const n = num(v);
+        if (n === null || !Number.isInteger(n) || n < 1)
+            return undefined;
+        const was = c.queue.maxSameShape;
+        c.queue.maxSameShape = n;
+        return was;
+    },
+    'project.notify.everyMin': (c, v) => {
+        const n = num(v);
+        if (n === null || n < 0)
+            return undefined;
+        const was = c.notify.everyMin;
+        c.notify.everyMin = n;
+        return was;
+    },
+    /**
+     * WHETHER ANYTHING MAY LEAVE THIS MACHINE — the eleventh key, and the one
+     * this file's own opening paragraph was written about.
+     *
+     * `project.push.policy` has been in the settings registry, offered on the
+     * phone and marked sensitive since before anything could publish, and it was
+     * mapped to nothing. It was the last key still in the state described above:
+     * written to the server and read by nobody, a screen wired at both ends and
+     * terminating in a dead end.
+     *
+     * IT NARROWS ONLY. Every other setter here lets the phone win outright,
+     * because a person turning `max_rounds` up is a person who meant it. This one
+     * refuses to WIDEN what the file granted: a config saying `never` cannot be
+     * turned into `on-approval` from a screen, because the file is the thing a
+     * person can review in a diff and the screen is the thing a stolen session
+     * can reach. Narrowing — `on-approval` down to `never` — always applies,
+     * because refusing to publish is never the dangerous direction.
+     */
+    'project.push.policy': (c, v) => {
+        if (typeof v !== 'string' || !config_1.PUBLISH_POLICIES.includes(v))
+            return undefined;
+        const was = c.publish.policy;
+        const next = v;
+        // Widening is reported as ignored rather than applied, so it is announced
+        // rather than silently refused.
+        if (!(0, config_1.mayPublish)(was) && (0, config_1.mayPublish)(next))
+            return undefined;
+        c.publish = { policy: next };
+        return was;
+    },
+    'project.rails.exemptions': (c, v) => {
+        if (v !== 'ask' && v !== 'never')
+            return undefined;
+        const was = c.rails.exemptions;
+        c.rails.exemptions = v;
+        return was;
+    },
+};
+/**
+ * Apply the settings a person set. Never mutates the config it is given.
+ *
+ * Rails are deliberately absent apart from `exemptions`: forbidden paths are
+ * the one thing a phone must not be able to widen remotely. A rail exists to
+ * stop an autonomous agent touching something, and a control that can remove it
+ * from a sofa is not a rail.
+ */
+function applySettings(config, resolved) {
+    const next = {
+        ...config,
+        run: { ...config.run },
+        rails: { ...config.rails },
+        queue: { ...config.queue },
+        proof: { ...config.proof },
+        notify: { ...config.notify },
+        publish: { ...config.publish },
+    };
+    const overrides = [];
+    const ignored = [];
+    for (const s of resolved) {
+        // The file wins wherever nobody has chosen. See the note at the top.
+        if (s.from === 'default')
+            continue;
+        const setter = SETTERS[s.key];
+        if (!setter) {
+            ignored.push(s.key);
+            continue;
+        }
+        const was = setter(next, s.value);
+        if (was === undefined) {
+            ignored.push(s.key);
+            continue;
+        }
+        // A setting explicitly set to the value already in the file is not an
+        // override worth announcing — nothing changed.
+        if (was !== s.value)
+            overrides.push({ key: s.key, was, now: s.value });
+    }
+    return { config: next, overrides, ignored };
+}
+/** The lines a run prints about what its phone changed. */
+function describeOverrides(result) {
+    const lines = [];
+    for (const o of result.overrides) {
+        lines.push(`settings: ${o.key} = ${JSON.stringify(o.now)} (from your phone, was ${JSON.stringify(o.was)})`);
+    }
+    if (result.ignored.length) {
+        lines.push(`settings: ${result.ignored.length} setting(s) this run has no use for: ${result.ignored.join(', ')}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=settings-overlay.js.map

package/dist/settings-overlay.js.map

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

package/dist/setup-prompt.d.ts

@@ -0,0 +1,34 @@
+import { type Question, type SetupAnswers } from './setup';
+import type { RepoProfile } from './init-detect';
+/**
+ * The terminal half of setup: asking, and reading what comes back.
+ *
+ * Kept apart from `setup.ts` so the decisions are testable without a TTY. This
+ * file only knows how to print a question and hand the answer over.
+ */
+export interface Asker {
+    question(prompt: string): Promise<string>;
+    close(): void;
+}
+export declare function nodeAsker(): Asker;
+export declare function renderQuestion(q: Question, profile: RepoProfile): string;
+/** The prompt line itself, showing what enter will choose. */
+export declare function promptLine(q: Question): string;
+export interface RunSetupOptions {
+    profile: RepoProfile;
+    asker: Asker;
+    write: (s: string) => void;
+    /** Skip every question and take the defaults — for CI and for --yes. */
+    useDefaults?: boolean;
+}
+/**
+ * Ask everything, then hand back the answers.
+ *
+ * A bad answer re-asks rather than aborting: getting three questions in and
+ * being thrown back to the shell over a typo is how people decide a tool is not
+ * worth the trouble.
+ */
+export declare function runSetup(opts: RunSetupOptions): Promise<SetupAnswers>;
+/** What is printed once the file is written. */
+export declare function renderSetupDone(summary: readonly string[], configPath: string, paired: boolean): string;
+//# sourceMappingURL=setup-prompt.d.ts.map

package/dist/setup-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-prompt.d.ts","sourceRoot":"","sources":["../src/setup-prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2C,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;GAKG;AAEH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,SAAS,IAAI,KAAK,CAMjC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAuBxE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAG9C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAgC3E;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAgBvG"}

package/dist/setup-prompt.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeAsker = nodeAsker;
+exports.renderQuestion = renderQuestion;
+exports.promptLine = promptLine;
+exports.runSetup = runSetup;
+exports.renderSetupDone = renderSetupDone;
+const promises_1 = require("node:readline/promises");
+const ui_1 = require("./ui");
+const setup_1 = require("./setup");
+function nodeAsker() {
+    const rl = (0, promises_1.createInterface)({ input: process.stdin, output: process.stdout });
+    return {
+        question: (prompt) => rl.question(prompt),
+        close: () => rl.close(),
+    };
+}
+function renderQuestion(q, profile) {
+    const out = ['', `  ${(0, ui_1.bold)(q.ask)}`, `  ${(0, ui_1.grey)(q.why)}`, ''];
+    if (q.kind === 'choice' && q.choices) {
+        q.choices.forEach((c, i) => {
+            const marker = c.value === q.default ? (0, ui_1.volt)('●') : (0, ui_1.grey)('○');
+            out.push(`    ${marker} ${(0, ui_1.dim)(`${i + 1}.`)} ${c.label}${c.hint ? (0, ui_1.grey)(`  — ${c.hint}`) : ''}`);
+        });
+        out.push('');
+    }
+    if (q.kind === 'paths' && q.suggest) {
+        const suggestions = q.suggest(profile);
+        if (suggestions.length) {
+            out.push(`    ${(0, ui_1.grey)('common ones for a project like this:')}`);
+            out.push(`    ${(0, ui_1.dim)(suggestions.join('  '))}`);
+            out.push('');
+            out.push(`    ${(0, ui_1.grey)('paste the ones that apply, space separated, or press enter for none')}`);
+            out.push('');
+        }
+    }
+    return out.join('\n');
+}
+/** The prompt line itself, showing what enter will choose. */
+function promptLine(q) {
+    const shown = q.default === '' ? 'none' : q.default;
+    return `  ${(0, ui_1.volt)('›')} ${(0, ui_1.dim)(`[${shown}]`)} `;
+}
+/**
+ * Ask everything, then hand back the answers.
+ *
+ * A bad answer re-asks rather than aborting: getting three questions in and
+ * being thrown back to the shell over a typo is how people decide a tool is not
+ * worth the trouble.
+ */
+async function runSetup(opts) {
+    if (opts.useDefaults)
+        return { ...setup_1.DEFAULT_ANSWERS };
+    const answers = { ...setup_1.DEFAULT_ANSWERS };
+    opts.write((0, ui_1.box)([
+        'looply is about to look at this project.',
+        '',
+        (0, ui_1.grey)('Five questions. Press enter to take the default on any of them,'),
+        (0, ui_1.grey)('and edit .looply/config.yaml afterwards — it is meant to be read.'),
+    ], { title: 'setting up', tone: ui_1.volt }) + '\n');
+    for (const q of setup_1.QUESTIONS) {
+        opts.write(renderQuestion(q, opts.profile));
+        for (;;) {
+            const raw = await opts.asker.question(promptLine(q));
+            const parsed = (0, setup_1.parseAnswer)(q, raw);
+            if (parsed.ok) {
+                answers[q.key] = parsed.value;
+                break;
+            }
+            opts.write(`  ${(0, ui_1.warn)(parsed.error)}\n`);
+        }
+    }
+    return answers;
+}
+/** What is printed once the file is written. */
+function renderSetupDone(summary, configPath, paired) {
+    const next = paired
+        ? ['looply scan', 'looply run']
+        : ['looply scan', 'looply run', (0, ui_1.dim)('looply pair  — to watch it from your phone')];
+    return [
+        '',
+        (0, ui_1.box)(summary.map((l) => l), { title: 'set up', tone: ui_1.volt }),
+        '',
+        `  ${(0, ui_1.ok)(`written to ${configPath}`)}`,
+        `  ${(0, ui_1.grey)('open it — every value is a decision and the comments say what each costs')}`,
+        '',
+        `  ${(0, ui_1.grey)('then:')}`,
+        ...next.map((c) => `    ${(0, ui_1.step)('')}${c.startsWith('looply') ? (0, ui_1.volt)(c) : c}`),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=setup-prompt.js.map

package/dist/setup-prompt.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,103 @@
+import type { RepoProfile } from './init-detect';
+/**
+ * The guided setup behind `looply init`.
+ *
+ * Detection covers what the repository can tell you: package manager,
+ * workspaces, test runner, build commands. It cannot tell you the things that
+ * are expensive to get wrong, and those are exactly the ones a silent default
+ * would decide for you:
+ *
+ *   - which paths must never be touched
+ *   - whether a production database is reachable from this machine
+ *   - whether anything may be published
+ *
+ * So those are asked. Everything else has a defensible default and is not.
+ *
+ * The questions are data and the answers are validated here, so the whole flow
+ * is testable without a terminal — the readline wrapper is a thin shell over
+ * this.
+ */
+export type AnswerKind = 'choice' | 'paths' | 'number' | 'confirm';
+export interface Question {
+    key: string;
+    /** The question, in the words it is asked. */
+    ask: string;
+    /** Why it is being asked. Shown under the question, not in a manual somewhere. */
+    why: string;
+    kind: AnswerKind;
+    choices?: readonly {
+        value: string;
+        label: string;
+        hint?: string;
+    }[];
+    /** Used when the answer is blank. Every question has one; none are mandatory. */
+    default: string;
+    /** Suggestions offered for a paths answer, drawn from what detection found. */
+    suggest?: (profile: RepoProfile) => string[];
+}
+/**
+ * Guesses for the rails, by ecosystem.
+ *
+ * Offered rather than applied. A wrong guess that is presented as a suggestion
+ * costs a keystroke; a wrong guess applied silently costs a schema.
+ */
+export declare function suggestRails(profile: RepoProfile): string[];
+export declare const QUESTIONS: readonly Question[];
+export interface SetupAnswers {
+    rails: string[];
+    prodDb: boolean;
+    push: 'never' | 'on-approval' | 'manual';
+    scope: 'improve' | 'anything';
+    hours: number;
+}
+export declare const DEFAULT_ANSWERS: SetupAnswers;
+/**
+ * Turn one raw answer into a value, or say why it cannot be.
+ *
+ * A blank answer always means the default — a setup that punishes pressing enter
+ * is a setup people abandon halfway.
+ */
+export declare function parseAnswer(question: Question, raw: string): {
+    ok: true;
+    value: string | number | boolean | string[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The config file, written from what was detected and what was answered.
+ *
+ * Commented throughout, because this file is meant to be read and edited after
+ * setup rather than treated as generated output nobody opens.
+ */
+/**
+ * What detection could see, said in the file it wrote.
+ *
+ * 🔴 THIS MODULE'S OWN RULE, APPLIED TO THE ONE THING IT SKIPPED (the audit's
+ * B-01). The docblock at the top of this file draws the line precisely:
+ * detection covers what the repository can tell you, and *"it cannot tell you
+ * the things that are expensive to get wrong… So those are asked."* Three are
+ * asked — forbidden paths, a reachable production database, whether anything
+ * may be published.
+ *
+ * `gates` is the most expensive thing in this file to get wrong, and it is the
+ * one that is **neither asked nor defaulted**: it is DETECTED, from the
+ * lockfile, `package.json` scripts and `tsconfig` — the toolchain, and nothing
+ * else. A person handed a populated list has no way to know that contracts,
+ * data and migrations were never candidates.
+ *
+ * ⚠️ AND THE FILE ALREADY KNEW HOW TO SAY IT — IN ONE BRANCH ONLY. When nothing
+ * is detected the list reads *"none detected — add at least one, or a green
+ * round proves nothing"*, which is exactly the right sentence. It appears only
+ * when the list is EMPTY, and *"a green round proves nothing about your
+ * migrations"* is just as true when it is full.
+ *
+ * ⚠️ IT CLAIMS NOTHING ABOUT THIS REPOSITORY. Not that migrations exist, not
+ * that a contract is unchecked, not that the gates are insufficient. It says
+ * what was looked for, which is the only thing detection can honestly report.
+ */
+export declare const GATES_ARE_TOOLCHAIN: string;
+export declare function renderConfig(profile: RepoProfile, answers: SetupAnswers): string;
+/** A short account of what was decided, shown when setup finishes. */
+export declare function summarise(answers: SetupAnswers, profile: RepoProfile): string[];
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAkB3D;AAED,eAAO,MAAM,SAAS,EAAE,SAAS,QAAQ,EA8CxC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IACzC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,eAAe,EAAE,YAM7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,GACV;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAoD1F;AAgBD;;;;;GAKG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mBAAmB,QAIpB,CAAC;AAEb,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAmFhF;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAQ/E"}