@12ui/design 0.2.56 → 0.2.58

package/dist/improve-kit-readme.js

@@ -1,8 +1,13 @@
 import { writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { IMPROVE_KIT_GUARDRAILS } from './improve-core/index.js';
 import { IMPROVE_ASSET_ROLE_COPY, IMPROVE_SCRIM_MAX_OPACITY_PCT, improveFrameMappingLine, readImproveKitAssets, } from './improve-kit-assets.js';
-import { IMPROVE_NO_APPROXIMATION_RULE, improveRecoveryLine, improveStageStatusLine, readImproveKitStatus, } from './improve-kit-status.js';
+import { IMPROVE_AWAITING_PICK_RULE, IMPROVE_NO_APPROXIMATION_RULE, improveAwaitingPick, improveRecoveryLine, improveStageStatusLine, readImproveKitStatus, } from './improve-kit-status.js';
+import { improveCapturedUrlLine } from './improve-capture-redirect.js';
+import { improveResponsiveOutcomeWord } from './improve-convert-resilience.js';
+import { improveKitIgnoreStatusLine } from './improve-kit-ignore.js';
 import { improveAbandonedLines } from './improve-reset.js';
+import { readImproveSpendLedger, renderImproveSpendLedgerSection, } from './improve-spend-ledger.js';
 import { improvePaths } from './improve-workspace.js';
 /**
  * The kit's front door.
@@ -20,10 +25,33 @@ const ROLE_GLOSSARY = [
     { role: 'upscaled-region', pattern: 'upscaled-region-N' },
     { role: 'source-crop', pattern: 'crop-N' },
 ];
+/**
+ * One sentence, wherever a resolved `plan/STALL.md` sits under this README.
+ *
+ * Freshdesk shipped a settled plan whose README said "settled" and whose
+ * STALL.md said "INCOMPLETE — no plan"; nothing in the kit said which was
+ * current (F21). The file is replaced when the stage settles, and the README
+ * says what it now is instead of pointing at it as a live stall.
+ */
+const improveResolvedStallLines = (status) => (status.present.stallResolved
+    ? ['', '`plan/STALL.md` records an earlier stall in this kit that has since resolved.'
+            + ' The plan and target here are current.']
+    : []);
 const statusSection = (args) => {
     const lines = ['## Status', ''];
     lines.push(...args.status.stages.map((stage) => `- ${improveStageStatusLine(stage)}`));
     lines.push(`- Target: ${args.status.targetMode}`);
+    // The page this kit is actually about, whenever it is not the page that was
+    // asked for (F27). It goes in the status block, above everything a reader
+    // would otherwise act on, because every artifact below describes it.
+    const captured = improveCapturedUrlLine(args.record);
+    if (captured)
+        lines.push(`- ${captured}`);
+    // Where the kit sits relative to the repository being improved, because a
+    // committed kit is 100 MB of paid artifacts in someone's history (F17).
+    const ignore = improveKitIgnoreStatusLine(args.record.kitIgnore);
+    if (ignore)
+        lines.push(`- ${ignore}`);
     lines.push(...improveAbandonedLines(args.record));
     if (args.status.complete) {
         lines.push('', ...(args.status.gateBlocked
@@ -31,12 +59,36 @@ const statusSection = (args) => {
                     + ' and `token-patch.css`. Read `plan/GATE.md` before touching code; the target, its assets'
                     + ' and the raster layers it names are all still here.']
             : args.record.convert?.layout === 'fixed'
-                ? ['Convert fell back: the target HTML is fixed-layout, not responsive.'
-                        + ' The LayerDoc and its assets are the full-quality source of truth.']
-                : ['Every requested stage settled. The kit is complete.']), '');
+                // The event, not just the outcome (F8): a lane that watched a silent
+                // wait needs the kit to confirm the responsive export stalled, and
+                // `plan/STALL.md` is where the timings and the collect-it-later
+                // command live.
+                ? [`Responsive export ${improveResponsiveOutcomeWord(args.record.convert.responsiveOutcome)};`
+                        + ' the plan was built from the fixed-layout fallback.'
+                        + ' The target HTML is fixed-layout, not responsive, and the LayerDoc and its assets'
+                        + ' are the full-quality source of truth.',
+                    ...(args.status.present.stall
+                        ? args.record.convert.responsiveOutcome === 'server-failed'
+                            ? ['', 'See `plan/STALL.md` for the service reason. There is nothing to collect and'
+                                    + ' nothing running.']
+                            : ['', 'See `plan/STALL.md` for what stalled, how long it waited, and how to collect'
+                                    + ' the responsive export later if it completes.']
+                        : [])]
+                // A complete kit that still has a STALL.md stalled once and then
+                // settled. Saying only "the kit is complete" left the reader to
+                // adjudicate this README against a file that said INCOMPLETE (F21).
+                : ['Every requested stage settled. The kit is complete.',
+                    ...improveResolvedStallLines(args.status)]), '');
         return lines;
     }
-    lines.push('', `This kit is INCOMPLETE: ${args.status.missing.join(', ')}.`, ...(args.status.present.stall ? ['', 'See `plan/STALL.md` for what the run was waiting on.'] : []), '', 'Recovery, in order — the first resumes and replays every settled stage:', '', ...args.status.recovery.map(improveRecoveryLine), '', IMPROVE_NO_APPROXIMATION_RULE, '');
+    lines.push('', `This kit is INCOMPLETE: ${args.status.missing.join(', ')}.`, ...(args.status.present.stall && !args.status.present.stallResolved
+        ? ['', 'See `plan/STALL.md` for what the run was waiting on.']
+        : improveResolvedStallLines(args.status)), '', 
+    // A never-picked kit has one recovery, and it is not a resume: heading it
+    // "the first resumes" over a single `--from pick` line reads as a stall.
+    ...(improveAwaitingPick(args.record)
+        ? [IMPROVE_AWAITING_PICK_RULE, '', 'Recovery — pick a candidate; convert and plan run from there:']
+        : ['Recovery, in order — the first resumes and replays every settled stage:']), '', ...args.status.recovery.map(improveRecoveryLine), '', IMPROVE_NO_APPROXIMATION_RULE, '');
     return lines;
 };
 const startHere = (args) => {
@@ -62,9 +114,11 @@ const startHere = (args) => {
             ? []
             : [args.status.gateBlocked
                     ? 'Run the recovery above first: the steps below assume a target this kit has not finished.'
-                    : hasAssets
-                        ? 'Run the recovery above first: steps 3 and 4 need a plan this kit does not have yet.'
-                        : 'Run the recovery above first: steps 2 to 4 need a target this kit does not have yet.', '']),
+                    : improveAwaitingPick(args.record)
+                        ? 'Pick a candidate first (command above); steps 2 to 4 need the target that the pick produces.'
+                        : hasAssets
+                            ? 'Run the recovery above first: steps 3 and 4 need a plan this kit does not have yet.'
+                            : 'Run the recovery above first: steps 2 to 4 need a target this kit does not have yet.', '']),
         // The frame a bound belongs to, before the first step that places anything:
         // a lane read these percentages as `winner.png` pixels and placed short.
         improveFrameMappingLine({
@@ -72,9 +126,14 @@ const startHere = (args) => {
             ...(args.index.canvas ? { design: args.index.canvas } : {}),
         }),
         '',
-        args.status.designKind === 'layerdoc'
-            ? `1. Open \`${design}\`. The supplied target document is the design.`
-            : `1. Open \`${design}\`. It is the design.`,
+        // A never-picked kit has no winner, so `design` is the capture. Calling
+        // that "the design" is the same wrong turn the recovery block used to make.
+        improveAwaitingPick(args.record)
+            ? '1. Open the candidate PNGs in `candidates/` and pick one (command above).'
+                + ' `capture/source.png` is the page as it is today, not the design.'
+            : args.status.designKind === 'layerdoc'
+                ? `1. Open \`${design}\`. The supplied target document is the design.`
+                : `1. Open \`${design}\`. It is the design.`,
         '2. Copy the files the assets table below marks ship into the repository;'
             + ' the rest are references and alternates.',
         ...planSteps,
@@ -103,6 +162,12 @@ const assetsSection = (args) => {
         ...ROLE_GLOSSARY.map(({ role, pattern }) => `- ${IMPROVE_ASSET_ROLE_COPY[role].label}`
             + ` (\`${pattern}\`): ${IMPROVE_ASSET_ROLE_COPY[role].instruction}`),
         `- \`${design}\`: ${IMPROVE_ASSET_ROLE_COPY.design.instruction}`,
+        // F30: the single `currentColor` file the plan used to write rendered black
+        // in every external form this README recommends.
+        '- Icons (`plan/assets/added-*.svg`): reference `<name>.svg` — it carries the design\'s'
+            + ' declared colour and is safe as an `<img>`, `background-image`, or `url()`; its'
+            + ' `<name>-inline.svg` sibling paints with `currentColor` and is for inlining in the markup'
+            + ' or masking with a token colour.',
         '',
     ];
     if (args.index.assets.length === 0) {
@@ -133,12 +198,7 @@ const assetsSection = (args) => {
 const guardrails = () => [
     '## Guardrails',
     '',
-    '- Preserve all real content, data, and controls; invent nothing.',
-    '- Do not describe emptiness or thin content as a defect: that phrasing can invite fabricated UI.',
-    '- Verify Tailwind v4 arbitrary custom-property syntax, quote CSS `url(...)` values, and update CSP before introducing data URIs.',
-    '- Never use the raw candidate PNG as a shipped asset; ship the extracted cutouts and plates.',
-    '- Never scrim imagery away. A heavy overlay is a fidelity defect, not a readability fix.',
-    '- Do not add decoration the design does not contain.',
+    ...IMPROVE_KIT_GUARDRAILS.map((rule) => `- ${rule}`),
     '',
 ];
 const anatomy = (record) => [
@@ -151,19 +211,86 @@ const anatomy = (record) => [
     '- `candidates/` keeps every generated option and its draft record; `winner.png` is the explicit image target.',
     '- `target/` holds the target LayerDoc, responsive HTML when generated, and extracted assets.',
     '- `plan/` holds the diff, implementation plan, token patch, added-element assets, `GATE.md` when anchoring was unsafe, or `STALL.md` when a stage did not settle.',
+    ...(record.scope === 'site' ? [
+        '- The root stays in `capture/`, `winner.png`, `target/`, and `plan/`; `pages/<id>/` holds only non-root routes\' capture, polished image, converted target, and gated implementation plan.',
+        '- `site-plan/` deduplicates tokens and shared shell work, inventories every page, and provides the ordered `APPLY.md` coding-model brief.',
+    ] : []),
     '',
     '## Replay',
     '',
     '- Apply the plan in the owning repository, then verify behavior and screenshots there. This kit never applies code.',
     '- Re-run from `pick` with another `--pick` slot to reuse capture and candidates; settled paid stages replay.',
+    // A magic-link triple is a live credential and this file sits in the working
+    // tree (F31), so the kit says what it holds and what a re-capture needs.
+    ...(record.bootstrap.length > 0
+        ? ['- This kit captured with `--bootstrap`. `improve.json` keeps only the redacted triple'
+                + ` (${record.bootstrap.map((value) => `\`${value}\``).join(', ')}) and its sha256 — the live`
+                + ' value, session token included, is stored nowhere. A re-capture needs `--bootstrap` passed'
+                + ' again.']
+        : []),
     '',
 ];
-const fixedLayoutSection = (record) => (record.convert?.layout === 'fixed'
+/**
+ * Every page whose responsive export did not land, not only the root.
+ *
+ * A site run converts the root and each page independently, so one page can
+ * fall back to fixed layout while the others are responsive. Reporting only
+ * the root left a reader believing the rest were fine.
+ */
+const responsiveGapsSection = (record) => {
+    const gaps = [
+        ...(record.convert?.responsiveWarning || record.convert?.layout === 'fixed'
+            ? [{ id: 'root', convert: record.convert }]
+            : []),
+        // `?? []`: a record written before `--scope site` existed has no `pages`
+        // key at all, and this renderer runs for EVERY kit. Throwing here would
+        // deny a README to a kit that has already been paid for.
+        ...(record.pages ?? []).flatMap((page) => (page.convert?.responsiveWarning || page.convert?.layout === 'fixed'
+            ? [{ id: page.id, convert: page.convert }]
+            : [])),
+    ];
+    if (gaps.length === 0)
+        return [];
+    return [
+        '## Responsive HTML gaps',
+        '',
+        ...gaps.map(({ id, convert }) => (`- ${id}: ${convert.responsiveWarning ?? 'Responsive HTML was unavailable.'} ${convert.layout === 'fixed'
+            ? 'A fixed-layout HTML fallback derived free from the successful LayerDoc conversion is present; it is not a responsive deliverable.'
+            : 'No HTML fallback is present.'}`)),
+        '- Every affected LayerDoc remains valid and is the artifact used for planning.',
+        '',
+    ];
+};
+/**
+ * The design's font, and whose job it is to load it (F23).
+ *
+ * `plan/token-patch.css` used to open with a hosted Google Fonts `@import`,
+ * and this README makes applying that patch step 3 of "Start here" — so the
+ * one step a lane is told to apply wholesale was also the step that added a
+ * third-party network dependency to a repository that declared none. The patch
+ * names the family; loading it is the repository's own decision.
+ */
+const fontsSection = (record) => {
+    const fonts = record.plan?.fonts ?? [];
+    if (fonts.length === 0)
+        return [];
+    return [
+        '## Fonts',
+        '',
+        ...fonts.map(({ family, weights }) => (`- ${family} (weights ${weights.join(', ')}). \`plan/token-patch.css\` declares it as a`
+            + ' token and imports nothing. Load the family the way this repository already loads fonts'
+            + ' — self-host it, or add it to the existing loader — or keep the current family and skip'
+            + ' the token.')),
+        '',
+    ];
+};
+/** The order a coding model applies a whole-site kit in, and how to re-measure it. */
+const siteApplicationOrder = (record) => (record.scope === 'site'
     ? [
-        '## Fixed-layout target',
+        '## Whole-site application order',
         '',
-        `- Warning: ${record.convert.responsiveWarning ?? 'Responsive HTML was unavailable.'}`,
-        '- The target HTML is a fixed-layout fallback derived free from the successful LayerDoc conversion. It is not a responsive deliverable; the LayerDoc remains valid for planning.',
+        '- Follow `site-plan/APPLY.md`: tokens through the theme entry point, shared shell once, then page residue in page order.',
+        '- Apply `site-plan/APPLY.md`, then run `12ui improve <url> --scope site --out-dir <kit> --recheck` to re-shoot every page against its retained targets without replaying settled stages. Each numbered `recheck/` directory keeps its capture, plan, and report.',
         '',
     ]
     : []);
@@ -183,16 +310,20 @@ export const renderImproveReadme = (args) => [
     ...startHere(args),
     ...assetsSection(args),
     ...guardrails(),
-    ...fixedLayoutSection(args.record),
+    ...fontsSection(args.record),
+    ...responsiveGapsSection(args.record),
+    ...siteApplicationOrder(args.record),
+    ...(args.ledger ? renderImproveSpendLedgerSection(args.ledger) : []),
     ...anatomy(args.record),
 ].join('\n');
 export const writeImproveReadme = async (record, context = {}) => {
     const paths = improvePaths(record.runDir);
-    const [status, index] = await Promise.all([
+    const [status, index, ledger] = await Promise.all([
         readImproveKitStatus({ record, ...(context.requestedTo ? { requestedTo: context.requestedTo } : {}) }),
         readImproveKitAssets({ runDir: record.runDir, layerDocPath: paths.targetLayerDoc }),
+        readImproveSpendLedger(record),
     ]);
-    await writeFile(paths.readme, renderImproveReadme({ record, status, index }), 'utf8');
+    await writeFile(paths.readme, renderImproveReadme({ record, status, index, ledger }), 'utf8');
     return paths.readme;
 };
 //# sourceMappingURL=improve-kit-readme.js.map

package/dist/improve-kit-readme.js.map

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

package/dist/improve-kit-stall.d.ts

@@ -2,16 +2,30 @@ import { type ImproveKitAssetIndex } from './improve-kit-assets.js';
 import { type ImproveKitStatus } from './improve-kit-status.js';
 import { type ImproveResumeConversion } from './improve-convert-resilience.js';
 import { type RunJournalEntry } from './run-journal.js';
-import { type ImproveRecord, type ImproveStage } from './improve-workspace.js';
-/** A run that ran out of patience and a run somebody killed read differently. */
-export type ImproveStallKind = 'stalled' | 'stopped';
+import { type ImproveRecord, type ImproveResponsiveFallbackOutcome, type ImproveStage } from './improve-workspace.js';
+/**
+ * A run that ran out of patience, a run somebody killed, and a run that
+ * recovered read differently.
+ *
+ * `fallback` is the third: the responsive export stalled and improve derived
+ * fixed-layout HTML free from the settled LayerDoc, so the kit is complete and
+ * the plan was built — but something DID stall, and F8 (wave-2, 2026-09-03)
+ * found that nothing said so anywhere a lane looks. No STALL.md exists in any
+ * of the six wave-2 kits, including the two that fell back. A recovered run is
+ * not a clean run, and this file is where the difference gets written down.
+ */
+export type ImproveStallKind = 'stalled' | 'stopped' | 'fallback';
 export type ImproveStallFacts = {
     stage: ImproveStage;
     kind: ImproveStallKind;
     hostedRunId?: string;
     waitedSeconds?: number;
     typicalSeconds?: number;
+    /** The published bound the wait ran against, when the caller knows it. */
+    boundSeconds?: number;
     serviceStage?: string;
+    /** For a `fallback`: what actually ended the responsive export (F34). */
+    responsiveOutcome?: ImproveResponsiveFallbackOutcome;
     /** The conversion the first recovery command will attach to, if the kit knows one. */
     resume?: ImproveResumeConversion;
     reason: string;
@@ -51,6 +65,40 @@ export declare const renderImproveStall: (args: {
     status: ImproveKitStatus;
     index: ImproveKitAssetIndex;
 }) => string;
+/**
+ * The same file, for the run that recovered.
+ *
+ * The facts come off the durable record rather than out of an error, because
+ * there is no error: the responsive export stalled, the free derivation took
+ * over, and the run went on to build a plan. A kit written before
+ * `responsiveStall` existed records the fallback but not its timings, so this
+ * writes what it has and never invents a number.
+ */
+export declare const writeImproveFallbackStall: (args: {
+    record: ImproveRecord;
+    requestedTo?: ImproveStage;
+}) => Promise<string | undefined>;
+/**
+ * The stall this kit recorded is over, so the file that recorded it stops
+ * saying the kit is INCOMPLETE (F21).
+ *
+ * Freshdesk's `--from convert` resume settled at 18:56:41Z and wrote a whole
+ * plan; the `plan/STALL.md` from 18:48:17Z survived beside it, still saying
+ * "this run was stopped", "no plan", and "resume or convert first" — directly
+ * contradicting the README above it, which said the plan was settled. A reader
+ * opening that kit cold got two mutually exclusive statuses and no way to tell
+ * which was current.
+ *
+ * The file is REPLACED rather than deleted: it is the durable record that this
+ * kit stalled once, which is worth keeping, and a README that links to it must
+ * not link to nothing. Its mtime is when the stall was written, which is the
+ * one timestamp neither the record nor the journal keeps.
+ */
+export declare const resolveImproveStall: (args: {
+    record: ImproveRecord;
+    status: ImproveKitStatus;
+    now?: Date;
+}) => Promise<string | undefined>;
 /**
  * Write `plan/STALL.md`, creating `plan/` when the plan stage never ran.
  * Returns the file so the caller can journal it as an artifact.

package/dist/improve-kit-stall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"improve-kit-stall.d.ts","sourceRoot":"","sources":["../src/improve-kit-stall.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAe7F,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,iBAAiB,CAgC5B,CAAC;AAgDF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAoCH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,MAAM;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAoBjB,CAAC"}
+{"version":3,"file":"improve-kit-stall.d.ts","sourceRoot":"","sources":["../src/improve-kit-stall.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gCAAgC,EACrC,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAehC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IACrD,sFAAsF;IACtF,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,iBAAiB,CAuC5B,CAAC;AAqGF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAqEH,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CA0B7B,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAgC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,MAAM;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAoBjB,CAAC"}