@12ui/design 0.2.55 → 0.2.57

package/dist/improve-bootstrap-secret.js

@@ -0,0 +1,61 @@
+import { createHash } from 'node:crypto';
+/**
+ * The bootstrap triple is a credential, and the kit is written inside a
+ * repository (F31).
+ *
+ * `--bootstrap 'http://host/auth/callback?token=…||**\/app'` is how a lane
+ * seats an authenticated session before capture, and it worked — zendesk's app
+ * route is the wave's first successful authenticated capture. But the value
+ * was persisted verbatim into `improve.json`, and `improve.json` sits at
+ * `.improve/<surface>/` inside the working tree. Mode 0600 does not survive a
+ * commit, and F17 is the standing proof that kits get swept in by `git add -A`
+ * (typeform, 100.8 MiB); a committed kit would put a live session token in
+ * history permanently.
+ *
+ * So the durable record keeps the shape and not the secret: origin and path as
+ * written, every query value and any fragment replaced, plus a sha256 of the
+ * original so a later run can tell whether it was handed the same value. The
+ * live triple exists only in the parsed options for the length of the capture.
+ * Redaction is idempotent, so re-writing an older record scrubs it.
+ */
+export const IMPROVE_REDACTED = '<redacted>';
+const redactUserInfo = (field) => field.replace(/^(https?:\/\/)[^/@]+@/iu, `$1${IMPROVE_REDACTED}@`);
+/**
+ * String surgery rather than URL parsing: a wait glob (`**\/app?token=…`) is
+ * not a URL, and re-serializing one would percent-encode the placeholder.
+ */
+const redactField = (field) => {
+    const hash = field.indexOf('#');
+    const base = redactUserInfo(hash < 0 ? field : field.slice(0, hash));
+    const fragment = hash < 0 ? '' : `#${IMPROVE_REDACTED}`;
+    const query = base.indexOf('?');
+    if (query < 0)
+        return `${base}${fragment}`;
+    const redacted = base.slice(query + 1).split('&').map((pair) => {
+        if (!pair)
+            return pair;
+        const equals = pair.indexOf('=');
+        return equals < 0 ? IMPROVE_REDACTED : `${pair.slice(0, equals)}=${IMPROVE_REDACTED}`;
+    }).join('&');
+    return `${base.slice(0, query)}?${redacted}${fragment}`;
+};
+/** The durable form of one `--bootstrap` triple: shape kept, secrets removed. */
+export const redactImproveBootstrap = (value) => value
+    .split('|').map(redactField).join('|');
+/** Identity of the original value, so a replay can tell it was handed the same one. */
+export const improveBootstrapDigest = (value) => createHash('sha256')
+    .update(value, 'utf8').digest('hex');
+/** The two record fields, built together so neither can be written without the other. */
+export const improveBootstrapRecordFields = (values) => ({
+    bootstrap: values.map(redactImproveBootstrap),
+    bootstrapSha256: values.map(improveBootstrapDigest),
+});
+/**
+ * What a resume is told when the kit captured with `--bootstrap` and this run
+ * passed none. The record cannot replay it: the live value was never stored.
+ */
+export const IMPROVE_BOOTSTRAP_NOT_STORED = 'This kit captured with --bootstrap, and the live'
+    + ' bootstrap value is never stored: improve.json keeps only a redacted form and a sha256, so a'
+    + ' session token cannot leak through the kit. Nothing was captured or bought.'
+    + ' Pass --bootstrap again with the same triple to re-capture this page.';
+//# sourceMappingURL=improve-bootstrap-secret.js.map

package/dist/improve-bootstrap-secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-bootstrap-secret.js","sourceRoot":"","sources":["../src/improve-bootstrap-secret.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAC7D,yBAAyB,EACzB,KAAK,gBAAgB,GAAG,CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7D,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;IACxF,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,QAAQ,GAAG,QAAQ,EAAE,CAAC;AAC1D,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK;KACnE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEzC,uFAAuF;AACvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;KAClF,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEvC,yFAAyF;AACzF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,MAAyB,EAGpE,EAAE,CAAC,CAAC;IACJ,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;CACpD,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,kDAAkD;MAC1F,8FAA8F;MAC9F,6EAA6E;MAC7E,uEAAuE,CAAC"}

package/dist/improve-capture-redirect.d.ts

@@ -0,0 +1,46 @@
+import type { ImproveRecord } from './improve-workspace.js';
+/**
+ * Did this run photograph the page it was asked for?
+ *
+ * Notion's app kit is the whole argument for this module. The lane seated a
+ * real session, ran `12ui improve http://127.0.0.1:4300/app`, and capture
+ * followed the app's auth redirect to `/signin?next=%2Fapp`. Both URLs were
+ * recorded — the requested one in `improve.json`, the captured one in
+ * `current.domdoc.json` — and nothing compared them, so the run drafted four
+ * redesigns of a sign-in dialog, converted one, anchored a plan to it, passed
+ * the coverage gate at 100.0% DOM, and printed "Kit ready". $0.792 against a
+ * page nobody asked for, with every signal green.
+ *
+ * The gate cannot catch this: coverage scores target-vs-capture agreement, and
+ * both halves were the sign-in page. Only the two URLs disagree, and the check
+ * that reads them is free and deterministic — so it runs before any paid
+ * stage, not after.
+ */
+export type ImproveCaptureRedirect = {
+    requested: string;
+    captured: string;
+};
+/** The two URLs when they name different pages, and nothing when they agree. */
+export declare const improveCaptureRedirect: (record: ImproveRecord) => ImproveCaptureRedirect | undefined;
+export declare const IMPROVE_REDIRECT_CAUSE: string;
+/**
+ * The `Captured:` line, in one place, so the kit README and the end-of-run
+ * summary cannot describe the same redirect in two different ways. Absent when
+ * the captured page is the requested one — which is every healthy run, and the
+ * reason this line is not printed unconditionally.
+ */
+export declare const improveCapturedUrlLine: (record: ImproveRecord) => string | undefined;
+/**
+ * Refuse to spend against a page nobody asked for.
+ *
+ * The capture is already written when this throws, so nothing is lost and the
+ * next run replays it; what does not happen is the draft purchase and every
+ * paid stage after it. `--allow-redirect` is the opt-in for a redirect that
+ * was the point — a bootstrap that deliberately ends somewhere else.
+ */
+export declare const assertImproveCaptureNotRedirected: (args: {
+    record: ImproveRecord;
+    allowRedirect: boolean;
+    runDir: string;
+}) => void;
+//# sourceMappingURL=improve-capture-redirect.d.ts.map

package/dist/improve-capture-redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-capture-redirect.d.ts","sourceRoot":"","sources":["../src/improve-capture-redirect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAkB7E,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,aAAa,KACpB,sBAAsB,GAAG,SAS3B,CAAC;AAEF,eAAO,MAAM,sBAAsB,QACiD,CAAC;AAErF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,aAAa,KAAG,MAAM,GAAG,SAMvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,GAAI,MAAM;IACtD,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,IAaH,CAAC"}

package/dist/improve-capture-redirect.js

@@ -0,0 +1,68 @@
+import { CliRefusal } from './cli-refusal.js';
+/**
+ * Origin plus path, with the hash and a trailing slash dropped.
+ *
+ * A redirect that only adds a query (`?next=…`, a tracking parameter, a
+ * session id) is still the requested page; a redirect that lands on a
+ * different path is a different page. `/app` and `/app/` are the same page.
+ */
+const urlIdentity = (value) => {
+    try {
+        const url = new URL(value);
+        return `${url.origin}${url.pathname.replace(/\/+$/u, '') || '/'}`;
+    }
+    catch {
+        return undefined;
+    }
+};
+/** The two URLs when they name different pages, and nothing when they agree. */
+export const improveCaptureRedirect = (record) => {
+    if (record.input.kind !== 'url')
+        return undefined;
+    const captured = record.capture?.capturedUrl;
+    if (!captured)
+        return undefined;
+    const requestedIdentity = urlIdentity(record.input.value);
+    const capturedIdentity = urlIdentity(captured);
+    if (!requestedIdentity || !capturedIdentity)
+        return undefined;
+    if (requestedIdentity === capturedIdentity)
+        return undefined;
+    return { requested: record.input.value, captured };
+};
+export const IMPROVE_REDIRECT_CAUSE = 'The page redirected, usually an auth gate:'
+    + ' seat the session first (--bootstrap), or pass the page that actually renders.';
+/**
+ * The `Captured:` line, in one place, so the kit README and the end-of-run
+ * summary cannot describe the same redirect in two different ways. Absent when
+ * the captured page is the requested one — which is every healthy run, and the
+ * reason this line is not printed unconditionally.
+ */
+export const improveCapturedUrlLine = (record) => {
+    const redirect = improveCaptureRedirect(record);
+    return redirect
+        ? `Captured: ${redirect.captured} — NOT the requested ${redirect.requested}.`
+            + ` ${IMPROVE_REDIRECT_CAUSE}`
+        : undefined;
+};
+/**
+ * Refuse to spend against a page nobody asked for.
+ *
+ * The capture is already written when this throws, so nothing is lost and the
+ * next run replays it; what does not happen is the draft purchase and every
+ * paid stage after it. `--allow-redirect` is the opt-in for a redirect that
+ * was the point — a bootstrap that deliberately ends somewhere else.
+ */
+export const assertImproveCaptureNotRedirected = (args) => {
+    const redirect = improveCaptureRedirect(args.record);
+    if (!redirect || args.allowRedirect)
+        return;
+    throw new CliRefusal(`Capture landed on ${redirect.captured}, not the requested ${redirect.requested}.`
+        + ` ${IMPROVE_REDIRECT_CAUSE}`
+        + ' Nothing was bought: improve stops here rather than draft, convert and plan'
+        + ' a page you did not ask for — a coverage gate cannot catch it, because it'
+        + ' scores the target against the capture and both would be the wrong page.'
+        + ` The capture is kept in ${args.runDir} and replays on the next run.`
+        + ' Pass --allow-redirect to improve the page the redirect landed on.', 'improve_capture_redirected');
+};
+//# sourceMappingURL=improve-capture-redirect.js.map

package/dist/improve-capture-redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-capture-redirect.js","sourceRoot":"","sources":["../src/improve-capture-redirect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuB9C;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,KAAa,EAAsB,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAqB,EACe,EAAE;IACtC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,iBAAiB,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,iBAAiB,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,4CAA4C;MAC9E,gFAAgF,CAAC;AAErF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAqB,EAAsB,EAAE;IAClF,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,QAAQ;QACb,CAAC,CAAC,aAAa,QAAQ,CAAC,QAAQ,wBAAwB,QAAQ,CAAC,SAAS,GAAG;cACzE,IAAI,sBAAsB,EAAE;QAChC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,IAIjD,EAAQ,EAAE;IACT,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO;IAC5C,MAAM,IAAI,UAAU,CAClB,qBAAqB,QAAQ,CAAC,QAAQ,uBAAuB,QAAQ,CAAC,SAAS,GAAG;UAChF,IAAI,sBAAsB,EAAE;UAC5B,6EAA6E;UAC7E,2EAA2E;UAC3E,0EAA0E;UAC1E,2BAA2B,IAAI,CAAC,MAAM,+BAA+B;UACrE,oEAAoE,EACtE,4BAA4B,CAC7B,CAAC;AACJ,CAAC,CAAC"}

package/dist/improve-concept.d.ts

@@ -4,7 +4,20 @@
  * did the opposite: the image model filled it with invented product content.
  */
 export declare const IMPROVE_NO_INVENTION_CLAUSE = "Keep all real content, data, and controls; invent nothing.";
-/** The real steering limit after reserving room for the mandatory harness. */
+/**
+ * The real steering limit after reserving room for the mandatory harness.
+ *
+ * The SERVICE bound is `MAX_CREATE_CONCEPT_CHARACTERS` — 1200, on the whole
+ * concept — and improve does not get to spend all of it: the style preamble,
+ * the `Direction: ` prefix and the no-invention clause are part of the concept
+ * it sends, so what is left is the flag's budget. Nothing here can be raised to
+ * 1200 without dropping the guardrails that keep the draw from inventing UI.
+ * The number is therefore stated wherever a caller writes a direction — the
+ * usage line, `improve.md`, and the refusal below, which also names the length
+ * of what was written (F7).
+ */
 export declare const IMPROVE_DIRECTION_MAX_CHARACTERS: number;
+/** Where cut detail belongs, stated once for the refusal and the skill. */
+export declare const IMPROVE_DIRECTION_TRIM_HINT: string;
 export declare const buildImproveConcept: (direction?: string) => string;
 //# sourceMappingURL=improve-concept.d.ts.map

package/dist/improve-concept.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"improve-concept.d.ts","sourceRoot":"","sources":["../src/improve-concept.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,+DAA+D,CAAC;AAexG,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,QAAuD,CAAC;AAIrG,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,MA2BxD,CAAC"}
+{"version":3,"file":"improve-concept.d.ts","sourceRoot":"","sources":["../src/improve-concept.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,+DAA+D,CAAC;AAexG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,QAAuD,CAAC;AAErG,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,QACG,CAAC;AAI5C,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,MAkCxD,CAAC"}

package/dist/improve-concept.js

@@ -1,5 +1,5 @@
 import { CliRefusal } from './cli-refusal.js';
-import { MAX_CONCEPT_CHARACTERS, readConceptValue } from './concept-input.js';
+import { conceptCharacterCount, conceptOverLimitMessage, MAX_CONCEPT_CHARACTERS, normalizeConceptText, readConceptValue, } from './concept-input.js';
 /**
  * F9 found that detailed, style-anchored direction reliably beats a vague
  * "make it better" instruction. Naming an empty or thin region as the defect
@@ -17,15 +17,36 @@ const RESERVED_CONCEPT_CHARACTERS = [
     DIRECTION_PREFIX,
     IMPROVE_NO_INVENTION_CLAUSE,
 ].join('\n\n').length;
-/** The real steering limit after reserving room for the mandatory harness. */
+/**
+ * The real steering limit after reserving room for the mandatory harness.
+ *
+ * The SERVICE bound is `MAX_CREATE_CONCEPT_CHARACTERS` — 1200, on the whole
+ * concept — and improve does not get to spend all of it: the style preamble,
+ * the `Direction: ` prefix and the no-invention clause are part of the concept
+ * it sends, so what is left is the flag's budget. Nothing here can be raised to
+ * 1200 without dropping the guardrails that keep the draw from inventing UI.
+ * The number is therefore stated wherever a caller writes a direction — the
+ * usage line, `improve.md`, and the refusal below, which also names the length
+ * of what was written (F7).
+ */
 export const IMPROVE_DIRECTION_MAX_CHARACTERS = MAX_CONCEPT_CHARACTERS - RESERVED_CONCEPT_CHARACTERS;
+/** Where cut detail belongs, stated once for the refusal and the skill. */
+export const IMPROVE_DIRECTION_TRIM_HINT = 'Keep the intended hierarchy, rhythm, typography,'
+    + ' surfaces, color, controls, and mood.';
 const FABRICATION_TRIGGER = /\b(?:empty|emptiness|underfilled|under-filled|thin[ -]content|lack of content|missing content|dead space|blank (?:area|region|half|section))\b/iu;
 export const buildImproveConcept = (direction) => {
-    const steering = direction?.replace(/\s+/gu, ' ').trim() ?? '';
-    if ([...steering].length > IMPROVE_DIRECTION_MAX_CHARACTERS) {
-        throw new CliRefusal(`--direction accepts at most ${IMPROVE_DIRECTION_MAX_CHARACTERS} characters because improve`
-            + ` reserves the rest of the ${MAX_CONCEPT_CHARACTERS}-character concept for its style and`
-            + ' no-invention guardrails.', 'improve_direction_too_long');
+    const steering = normalizeConceptText(direction ?? '');
+    if (conceptCharacterCount(steering) > IMPROVE_DIRECTION_MAX_CHARACTERS) {
+        throw new CliRefusal(conceptOverLimitMessage({
+            flag: '--direction',
+            raw: direction ?? '',
+            normalized: steering,
+            limit: IMPROVE_DIRECTION_MAX_CHARACTERS,
+            because: `improve reserves the other ${RESERVED_CONCEPT_CHARACTERS} of the`
+                + ` ${MAX_CONCEPT_CHARACTERS}-character concept for its style and no-invention`
+                + ' guardrails, so --direction is what is left.',
+            trimHint: IMPROVE_DIRECTION_TRIM_HINT,
+        }), 'improve_direction_too_long');
     }
     if (FABRICATION_TRIGGER.test(steering)) {
         throw new CliRefusal('--direction must describe the intended style and hierarchy, not emptiness or thin content;'
@@ -39,7 +60,7 @@ export const buildImproveConcept = (direction) => {
     return readConceptValue({
         value: concept,
         flag: '--direction',
-        trimHint: 'Keep the intended hierarchy, rhythm, typography, surfaces, color, controls, and mood.',
+        trimHint: IMPROVE_DIRECTION_TRIM_HINT,
     });
 };
 //# sourceMappingURL=improve-concept.js.map

package/dist/improve-concept.js.map

@@ -1 +1 @@
-{"version":3,"file":"improve-concept.js","sourceRoot":"","sources":["../src/improve-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,4DAA4D,CAAC;AAExG,MAAM,sBAAsB,GAAG;IAC7B,gJAAgJ;IAChJ,4IAA4I;IAC5I,0JAA0J;CAC3J,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,2BAA2B,GAAG;IAClC,sBAAsB;IACtB,gBAAgB;IAChB,2BAA2B;CAC5B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AAEtB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,GAAG,2BAA2B,CAAC;AAErG,MAAM,mBAAmB,GAAG,kJAAkJ,CAAC;AAE/K,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAkB,EAAU,EAAE;IAChE,MAAM,QAAQ,GAAG,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,gCAAgC,EAAE,CAAC;QAC5D,MAAM,IAAI,UAAU,CAClB,+BAA+B,gCAAgC,6BAA6B;cAC1F,6BAA6B,sBAAsB,sCAAsC;cACzF,2BAA2B,EAC7B,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,4FAA4F;cAC1F,+CAA+C,EACjD,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG;QACd,sBAAsB;QACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,2BAA2B;KAC5B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,uFAAuF;KAClG,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"improve-concept.js","sourceRoot":"","sources":["../src/improve-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,4DAA4D,CAAC;AAExG,MAAM,sBAAsB,GAAG;IAC7B,gJAAgJ;IAChJ,4IAA4I;IAC5I,0JAA0J;CAC3J,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,2BAA2B,GAAG;IAClC,sBAAsB;IACtB,gBAAgB;IAChB,2BAA2B;CAC5B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,GAAG,2BAA2B,CAAC;AAErG,2EAA2E;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,kDAAkD;MACzF,uCAAuC,CAAC;AAE5C,MAAM,mBAAmB,GAAG,kJAAkJ,CAAC;AAE/K,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAkB,EAAU,EAAE;IAChE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACvD,IAAI,qBAAqB,CAAC,QAAQ,CAAC,GAAG,gCAAgC,EAAE,CAAC;QACvE,MAAM,IAAI,UAAU,CAClB,uBAAuB,CAAC;YACtB,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,SAAS,IAAI,EAAE;YACpB,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,gCAAgC;YACvC,OAAO,EAAE,8BAA8B,2BAA2B,SAAS;kBACvE,IAAI,sBAAsB,mDAAmD;kBAC7E,8CAA8C;YAClD,QAAQ,EAAE,2BAA2B;SACtC,CAAC,EACF,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,4FAA4F;cAC1F,+CAA+C,EACjD,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG;QACd,sBAAsB;QACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,2BAA2B;KAC5B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,2BAA2B;KACtC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/improve-conversion-attempts.d.ts

@@ -0,0 +1,96 @@
+import type { ImproveRecord } from './improve-workspace.js';
+/**
+ * The kit's ledger of conversions dispatched under a key that is not the base
+ * key — written BEFORE the dispatch, so a later invocation can rebuild it.
+ *
+ * THE MONEY LEAK THIS CLOSES. `--fresh` dispatched under
+ * `${baseKey}:fresh:${randomUUID()}` and nothing durable recorded that nonce.
+ * A fresh conversion that was stopped or that stalled could therefore never be
+ * reached again: `--from convert` rebuilt the BASE key, the server's dedupe
+ * attached it to the older recorded conversion, and the fresh one kept running
+ * and kept billing with nothing able to collect it. The stall retry had the
+ * same shape and was patched by DERIVING its key from the count of stall
+ * abandonments (`improveConvertStallCount`), which only becomes true once the
+ * stalled conversion has been abandoned — a retry stopped mid-flight was still
+ * unreachable, because the conversion it was waiting on had not been abandoned
+ * by anything.
+ *
+ * So both now use ONE mechanism. The exact key goes on the record before the
+ * conversion is dispatched, the hosted id joins it as soon as the run reports
+ * one, and a resume prefers the newest attempt nothing has abandoned. The
+ * derived stall key stays as the fallback for kits written before this ledger.
+ *
+ * WHY THE BASE-KEY ATTEMPT IS IN HERE TOO (F19). It was left out because it is
+ * the deterministic identity every invocation recomputes from the winner, so
+ * it needs no record to be rebuilt. But a kit whose ordinary conversion stalled
+ * then held no durable trace of it at all: pipedrive's `improve.json` priced
+ * nothing for two parent conversions, and the lane could not state its own
+ * spend. Every dispatch is recorded, with the price it may cost, before it
+ * happens. One extra durable write buys a receipt.
+ *
+ * WHAT THE STOP PATH OWES. Nothing. Because the key is recorded before the
+ * dispatch, a run killed mid-attempt is already resumable from what is on
+ * disk, and `improve-stop-handler.ts` still writes no `improve.json` of its
+ * own — it reads the durable record after its journal end line and reports it.
+ */
+export type ImproveConversionAttempt = NonNullable<ImproveRecord['conversionAttempts']>[number];
+export type ImproveConversionAttemptReason = ImproveConversionAttempt['reason'];
+/** `--fresh`: one conversion of the same winner under a key nothing replays. */
+export declare const improveFreshConversionKey: (baseKey: string, nonce: string) => string;
+/**
+ * The attempt a resume rebuilds its key from: the newest one still open.
+ *
+ * Newest rather than oldest, for the reason the stall retry already states —
+ * the newest conversion is the one that is running and billing now, and
+ * re-attaching to it is the only way to get anything back for it.
+ */
+export declare const openImproveConversionAttempt: (record: ImproveRecord) => ImproveConversionAttempt | undefined;
+/** How many conversions of this winner the ledger says one reason has bought. */
+export declare const improveConversionAttemptCount: (record: ImproveRecord, reason: ImproveConversionAttemptReason) => number;
+/**
+ * Walk away from every attempt still open. The ids are returned rather than
+ * written to `abandonedConversions` here, because that ledger is owned by
+ * `improve-reset.ts` and says its own sentence about billing.
+ */
+export declare const abandonImproveConversionAttempts: (record: ImproveRecord, args: {
+    reason: string;
+    at?: string;
+    /** The attempt this invocation is about to dispatch, which is not abandoned. */
+    except?: string;
+}) => {
+    record: ImproveRecord;
+    abandoned: ImproveConversionAttempt[];
+};
+/**
+ * Record a dispatch, deduped by key so replaying the same attempt — the
+ * temporarily-unavailable retry re-enters the whole stage — is one entry and
+ * not two. `supersedes` is the reason written against every OTHER open
+ * attempt: `--fresh` replaces whatever this kit was waiting on, and leaving
+ * that one open would send the next resume back to it.
+ */
+export declare const startImproveConversionAttempt: (record: ImproveRecord, args: {
+    key: string;
+    reason: ImproveConversionAttemptReason;
+    at?: string;
+    supersedes?: string;
+    /** What this conversion may cost, recorded before it is dispatched (F19). */
+    priceCeilingUsd?: number;
+}) => {
+    record: ImproveRecord;
+    superseded: ImproveConversionAttempt[];
+};
+/**
+ * The hosted id, the first time the conversion reports one. First wins: the
+ * dispatch names the conversion this key bought, and a fused run's later ids
+ * belong to its export half.
+ */
+export declare const noteImproveConversionAttemptId: (record: ImproveRecord, args: {
+    key: string;
+    conversionId: string;
+}) => ImproveRecord;
+/** The attempt delivered. It is no longer what a resume should re-attach to. */
+export declare const settleImproveConversionAttempt: (record: ImproveRecord, args: {
+    key?: string;
+    at?: string;
+}) => ImproveRecord;
+//# sourceMappingURL=improve-conversion-attempts.d.ts.map

package/dist/improve-conversion-attempts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-conversion-attempts.d.ts","sourceRoot":"","sources":["../src/improve-conversion-attempts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChG,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AAEhF,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,KAAG,MAE1E,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,aAAa,KACpB,wBAAwB,GAAG,SAE7B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,GACxC,QAAQ,aAAa,EACrB,QAAQ,8BAA8B,KACrC,MAAiG,CAAC;AAErG;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAAI,QAAQ,aAAa,EAAE,MAAM;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,wBAAwB,EAAE,CAAA;CAWjE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,aAAa,EAAE,MAAM;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,8BAA8B,CAAC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,KAAG;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,wBAAwB,EAAE,CAAA;CAqBlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GAAI,QAAQ,aAAa,EAAE,MAAM;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB,KAAG,aAaH,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,8BAA8B,GAAI,QAAQ,aAAa,EAAE,MAAM;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,KAAG,aAaH,CAAC"}

package/dist/improve-conversion-attempts.js

@@ -0,0 +1,93 @@
+/** `--fresh`: one conversion of the same winner under a key nothing replays. */
+export const improveFreshConversionKey = (baseKey, nonce) => (`${baseKey}:fresh:${nonce}`);
+/** Still owed a result: dispatched, and neither settled nor walked away from. */
+const isOpen = (attempt) => (attempt.abandonedAt === undefined && attempt.settledAt === undefined);
+/**
+ * The attempt a resume rebuilds its key from: the newest one still open.
+ *
+ * Newest rather than oldest, for the reason the stall retry already states —
+ * the newest conversion is the one that is running and billing now, and
+ * re-attaching to it is the only way to get anything back for it.
+ */
+export const openImproveConversionAttempt = (record) => ([...(record.conversionAttempts ?? [])].reverse().find(isOpen));
+/** How many conversions of this winner the ledger says one reason has bought. */
+export const improveConversionAttemptCount = (record, reason) => (record.conversionAttempts ?? []).filter((attempt) => attempt.reason === reason).length;
+/**
+ * Walk away from every attempt still open. The ids are returned rather than
+ * written to `abandonedConversions` here, because that ledger is owned by
+ * `improve-reset.ts` and says its own sentence about billing.
+ */
+export const abandonImproveConversionAttempts = (record, args) => {
+    const at = args.at ?? new Date().toISOString();
+    const abandoned = [];
+    const attempts = (record.conversionAttempts ?? []).map((attempt) => {
+        if (!isOpen(attempt) || attempt.key === args.except)
+            return attempt;
+        const closed = { ...attempt, abandonedAt: at, abandonedReason: args.reason };
+        abandoned.push(closed);
+        return closed;
+    });
+    if (abandoned.length === 0)
+        return { record, abandoned };
+    return { record: { ...record, conversionAttempts: attempts }, abandoned };
+};
+/**
+ * Record a dispatch, deduped by key so replaying the same attempt — the
+ * temporarily-unavailable retry re-enters the whole stage — is one entry and
+ * not two. `supersedes` is the reason written against every OTHER open
+ * attempt: `--fresh` replaces whatever this kit was waiting on, and leaving
+ * that one open would send the next resume back to it.
+ */
+export const startImproveConversionAttempt = (record, args) => {
+    const at = args.at ?? new Date().toISOString();
+    const rotated = args.supersedes === undefined
+        ? { record, abandoned: [] }
+        : abandonImproveConversionAttempts(record, { reason: args.supersedes, at, except: args.key });
+    const attempts = rotated.record.conversionAttempts ?? [];
+    if (attempts.some((attempt) => attempt.key === args.key)) {
+        return { record: rotated.record, superseded: rotated.abandoned };
+    }
+    return {
+        record: {
+            ...rotated.record,
+            conversionAttempts: [...attempts, {
+                    key: args.key,
+                    reason: args.reason,
+                    dispatchedAt: at,
+                    ...(args.priceCeilingUsd === undefined ? {} : { priceCeilingUsd: args.priceCeilingUsd }),
+                }],
+        },
+        superseded: rotated.abandoned,
+    };
+};
+/**
+ * The hosted id, the first time the conversion reports one. First wins: the
+ * dispatch names the conversion this key bought, and a fused run's later ids
+ * belong to its export half.
+ */
+export const noteImproveConversionAttemptId = (record, args) => {
+    const attempts = record.conversionAttempts ?? [];
+    if (!attempts.some((attempt) => attempt.key === args.key && attempt.conversionId === undefined)) {
+        return record;
+    }
+    return {
+        ...record,
+        conversionAttempts: attempts.map((attempt) => (attempt.key === args.key && attempt.conversionId === undefined
+            ? { ...attempt, conversionId: args.conversionId }
+            : attempt)),
+    };
+};
+/** The attempt delivered. It is no longer what a resume should re-attach to. */
+export const settleImproveConversionAttempt = (record, args) => {
+    const key = args.key;
+    const attempts = record.conversionAttempts ?? [];
+    if (key === undefined || !attempts.some((attempt) => attempt.key === key && isOpen(attempt))) {
+        return record;
+    }
+    const at = args.at ?? new Date().toISOString();
+    return {
+        ...record,
+        conversionAttempts: attempts.map((attempt) => (attempt.key === key && isOpen(attempt) ? { ...attempt, settledAt: at } : attempt)),
+    };
+};
+//# sourceMappingURL=improve-conversion-attempts.js.map

package/dist/improve-conversion-attempts.js.map

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

package/dist/improve-conversion-stage.d.ts

@@ -1,4 +1,5 @@
 import { runConversionCommand } from './cli-convert-command.js';
+import { type ImproveConvertProgress } from './improve-convert-progress.js';
 import type { ImproveOptions } from './improve-options.js';
 import { type ImproveCommandDependencies } from './improve-stage-shared.js';
 import type { RunJournalNotes } from './run-journal.js';
@@ -13,6 +14,19 @@ export declare const runImproveConversion: (args: {
     key: string;
     runner: typeof runConversionCommand;
     journal?: RunJournalNotes;
+    /**
+     * The hosted id, the first time this conversion reports one. It fires from
+     * the dispatch note `cli-convert-command.ts` makes immediately after
+     * `createConversion`, which is what lets the attempt ledger join a key to the
+     * conversion it bought while that conversion is still running.
+     */
+    onConversionId?: (id: string) => void;
+    /**
+     * The visible tick over an otherwise silent wait (F8). The nested convert
+     * runs quiet, so without this the terminal shows nothing between dispatch
+     * and the terminal line, however long the hosted work takes.
+     */
+    progress?: ImproveConvertProgress;
 }) => Promise<{
     artifacts: string[];
     purchaseIds: string[];

package/dist/improve-conversion-stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"improve-conversion-stage.d.ts","sourceRoot":"","sources":["../src/improve-conversion-stage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAahE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnG,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,oBAAoB,CAAC;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,KAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoC3E,CAAC;AA6CF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,KAAG,OAAO,CAAC,aAAa,CAqIxB,CAAC"}
+{"version":3,"file":"improve-conversion-stage.d.ts","sourceRoot":"","sources":["../src/improve-conversion-stage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AA6BvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnG,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,oBAAoB,CAAC;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC,KAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA6C3E,CAAC;AAmCF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,KAAG,OAAO,CAAC,aAAa,CA8TxB,CAAC"}