@tacuchi/agent-workflow-cli 20.26.0 → 21.1.0

package/dist/domain/design/maturity.js

@@ -0,0 +1,305 @@
+import { ESSENTIAL_HEADINGS, HEADINGS, conditionalKeys, headingKey, parseBody, } from "./artifact-body.js";
+import { splitDesignDocument, validateDesignArtifact, } from "./artifact.js";
+import { parseArtifactId, parseArtifactRef } from "./identity.js";
+/**
+ * A reference that is only a picture. A rendition shows what a screen LOOKED
+ * like when someone rendered it; it is not the semantics and it is not a WCAG
+ * verdict. A section whose entire content is a rendition reference has answered
+ * with an image (AC-SEM-07).
+ */
+const RENDITION_ONLY = /^(?:\s*(?:DES-[0-9]+\/)?VIS-[0-9]+@r[0-9]+\s*[,·.;]?\s*)+$/;
+/** Sections whose closure a `handoff` must be able to demonstrate later. */
+const OBLIGATION_KEYS = new Set([
+    "accessibility",
+    "data_permissions_and_validation",
+    "states_and_transitions",
+    "responsive_and_adaptation",
+    "localization",
+    "permissions_and_privacy",
+    "alternatives_and_recovery",
+]);
+export function checkMaturity(artifact, sections, kind, file) {
+    const obligations = readObligations(sections, artifact.not_applicable);
+    const failures = [
+        ...checkOutlineFloor(artifact, sections, kind, file),
+        ...(artifact.maturity === "handoff" ? checkHandoff(artifact, sections, kind, file) : []),
+    ];
+    return {
+        attainable: failures.length === 0 ? artifact.maturity : "outline",
+        failures,
+        obligations,
+    };
+}
+/**
+ * The floor BOTH profiles stand on (AC-SEM-01).
+ *
+ * `outline` is not "anything goes": it is the minimum inventory from which the
+ * next revision can be planned — who, what for, on what, what screens or steps
+ * exist, and what it traces to. What `outline` does NOT demand is completing the
+ * handoff early, which is why every check here is about presence, not depth.
+ */
+function checkOutlineFloor(artifact, sections, kind, file) {
+    const failures = [];
+    if (artifact.trace.length === 0) {
+        failures.push({
+            code: "DESIGN_MATURITY_INCOMPLETE",
+            artifact: file,
+            message: "sin trazabilidad no hay inventario: 'trace' está vacío",
+            action: "declará al menos el Requirement y el acceptance criterion que origina esto",
+        });
+    }
+    if (artifact.kind === "flow" && artifact.actors.length === 0) {
+        failures.push({
+            code: "DESIGN_MATURITY_INCOMPLETE",
+            artifact: file,
+            message: "no declara actores: el inventario mínimo incluye quién lo recorre",
+            action: "declará al menos un actor en 'actors'",
+        });
+    }
+    const inventory = artifact.kind === "flow"
+        ? { what: "nodos", empty: artifact.nodes.length === 0 }
+        : { what: "estados", empty: artifact.states.length === 0 };
+    if (inventory.empty) {
+        failures.push({
+            code: "DESIGN_MATURITY_INCOMPLETE",
+            artifact: file,
+            message: `el inventario mínimo está vacío: no declara ${inventory.what}`,
+            action: `un ${kind} en 'outline' ya enumera sus ${inventory.what}, aunque no los detalle`,
+        });
+    }
+    // Acá vivía un cruce `unknown` ↔ `not_applicable` por coincidencia de texto.
+    // Era inseguro en las dos direcciones —no veía la contradicción real escrita
+    // como pregunta, y bloqueaba documentos legítimos que nombraban la sección de
+    // paso— así que se fue: adivinar sobre prosa libre no es una guarda. Lo que
+    // AC-SEM-04 exige de verdad lo hace `checkBlockingUnknowns`, sobre un booleano
+    // que el autor declara.
+    failures.push(...checkPlaceholders(sections, kind, file));
+    return failures;
+}
+/** Whatever a section says, it cannot be only a picture — in either profile. */
+function checkPlaceholders(sections, kind, file) {
+    const essential = new Set(ESSENTIAL_HEADINGS[kind]);
+    return sections
+        .filter((s) => essential.has(s.heading) && RENDITION_ONLY.test(s.prose.trim()))
+        .map((s) => ({
+        code: "DESIGN_EVIDENCE_INSUFFICIENT",
+        artifact: file,
+        message: `'${s.heading}' responde con una rendition y nada más`,
+        action: "una imagen aprobada no es la semántica vigente ni una conformidad WCAG: escribí lo que exige",
+    }));
+}
+/**
+ * `handoff` (AC-SEM-02, AC-SEM-03, AC-SEM-04, AC-PKG-09).
+ *
+ * The claim is: everything applicable is closed, and nothing open can still move
+ * behavior or acceptance. Every check below is a way that claim can be false.
+ */
+function checkHandoff(artifact, sections, kind, file) {
+    return [
+        ...checkBlockingUnknowns(artifact, file),
+        ...checkGraph(artifact, file),
+        ...checkApplicableCompleteness(artifact, sections, kind, file),
+        ...checkExternalCustody(artifact, file),
+        ...checkVisualEvidence(artifact, file),
+    ];
+}
+/**
+ * The elevation of AC-REN-01 and AC-REN-02: a `handoff` screen is LOOKABLE.
+ *
+ * Until this existed, `handoff` meant the prose was complete. That let a screen
+ * be declared implementable while nobody could see it — and the visual evidence,
+ * when it existed at all, was somebody's habit rather than a requirement. So a
+ * `handoff` screen now owes two things:
+ *
+ * 1. a classification for every criterion it traces, and
+ * 2. a local preview of its `default_state` — the criterion that shows the base
+ *    state has to enumerate it AND enumerate a rendition of it.
+ *
+ * Both are checked HERE, against the document alone, and only the document's own
+ * claims. Whether the enumerated rendition exists, was cut from this revision and
+ * really covers that state is the package-level cross in `visual-evidence.ts`:
+ * this gate cannot open another file, and a gate that pretended to would be
+ * reporting on evidence it never read.
+ *
+ * `outline` is untouched on purpose. A screen still being shaped legitimately has
+ * no picture yet, and demanding one would push the author to render a placeholder
+ * so the document matches a template.
+ */
+function checkVisualEvidence(artifact, file) {
+    if (artifact.kind !== "screen")
+        return [];
+    const screen = artifact;
+    const failures = [];
+    for (const entry of screen.trace) {
+        failures.push(...checkClassified(entry, file));
+    }
+    const base = screen.trace.filter((e) => e.classification !== "not_visual" && e.states.includes(screen.default_state));
+    if (!base.some((e) => e.renditions.length > 0)) {
+        failures.push({
+            code: "DESIGN_EVIDENCE_INSUFFICIENT",
+            artifact: file,
+            message: `ningún criterio trazado muestra el estado base '${screen.default_state}' con una rendition`,
+            action: "un 'handoff' conserva una preview estática local de su default_state: creá la rendition y enumerala en el criterio que lo demuestra",
+        });
+    }
+    return failures;
+}
+/** One entry of the matrix: classified, and enumerating what its class demands. */
+function checkClassified(entry, file) {
+    const incomplete = (message, action) => ({
+        code: "DESIGN_MATURITY_INCOMPLETE",
+        artifact: file,
+        message: `trace['${entry.criterion}'] ${message}`,
+        action,
+    });
+    if (entry.classification === null) {
+        return [
+            incomplete("no está clasificado", "clasificalo 'visual', 'interaction' o 'not_visual': un 'handoff' dice cómo se demuestra cada criterio"),
+        ];
+    }
+    if (entry.classification === "not_visual") {
+        return entry.reason === null
+            ? [
+                incomplete("está clasificado 'not_visual' y no dice por qué", "escribí en 'reason' qué hace que ese criterio no tenga nada que mirar"),
+            ]
+            : [];
+    }
+    const failures = [];
+    if (entry.states.length === 0) {
+        failures.push(incomplete(`es '${entry.classification}' y no enumera estados`, "nombrá en 'states' los anchors donde se ve"));
+    }
+    if (entry.renditions.length === 0) {
+        failures.push(incomplete(`es '${entry.classification}' y no enumera renditions`, "referenciá en 'renditions' la evidencia visual que lo muestra"));
+    }
+    return failures;
+}
+/**
+ * AC-SEM-02: a `handoff` flow states its TRANSITIONS, not just its steps.
+ *
+ * A flow with two or more nodes and no edges has its graph only in the prose of
+ * `## Main journey` — which is exactly what the machine-readable frontmatter
+ * exists to avoid. One node and no edges is a legitimate degenerate case.
+ */
+function checkGraph(artifact, file) {
+    if (artifact.kind !== "flow" || artifact.nodes.length < 2 || artifact.edges.length > 0) {
+        return [];
+    }
+    return [
+        {
+            code: "DESIGN_MATURITY_INCOMPLETE",
+            artifact: file,
+            message: `declara ${artifact.nodes.length} nodos y ninguna transición entre ellos`,
+            action: "un 'handoff' resuelve su grafo sin interpretar prosa: declará las aristas en 'edges'",
+        },
+    ];
+}
+/** AC-SEM-04: an open question that can move behavior forbids the claim. */
+function checkBlockingUnknowns(artifact, file) {
+    return artifact.unknowns
+        .filter((u) => u.blocking)
+        .map((u) => ({
+        code: "DESIGN_MATURITY_BLOCKED",
+        artifact: file,
+        message: `queda una incógnita bloqueante: "${u.question}"`,
+        action: "resolvela y volvé a declarar 'handoff', o bajá a 'outline': una incógnita no es un 'no aplica'",
+    }));
+}
+/**
+ * Every section either SAYS something or is justified as inapplicable.
+ *
+ * The essential sections admit neither escape — F2 already rejects a
+ * `not_applicable` on them — so what is left to check here is the conditional
+ * ones: silence is not closure.
+ */
+function checkApplicableCompleteness(artifact, sections, kind, file) {
+    const byKey = new Map(sections.map((s) => [s.key, s]));
+    const failures = [];
+    for (const key of conditionalKeys(kind)) {
+        const waived = artifact.not_applicable[key];
+        if (waived !== undefined)
+            continue;
+        const section = byKey.get(key);
+        if (section === undefined || section.text.trim().length > 0)
+            continue;
+        failures.push({
+            code: "DESIGN_MATURITY_INCOMPLETE",
+            artifact: file,
+            message: `'${headingOf(kind, key)}' está vacía y no se declaró no aplicable`,
+            action: `completala, o declará not_applicable.${key} con su razón`,
+        });
+    }
+    return failures;
+}
+/**
+ * AC-PKG-09: depending on someone else's design system.
+ *
+ * A `handoff` that points at another package's rules or tokens is implementable
+ * only if that material is HERE — pinned by provider, revision and digest, and
+ * kept locally. Otherwise the artifact describes something that can change
+ * underneath it, which is exactly what `outline` is for.
+ */
+function checkExternalCustody(artifact, file) {
+    const own = parseArtifactId(artifact.id)?.package;
+    // Todas las referencias, no solo `dependencies`: un flow cuyos NODOS viven en
+    // otro package es tan poco implementable como uno cuyas rules viven afuera, y
+    // la clausura ya lo declara irresoluble. Las dos mitades tienen que coincidir.
+    const refs = artifact.kind === "flow"
+        ? [artifact.entry, ...artifact.nodes, ...artifact.dependencies]
+        : [...artifact.flow_refs, ...artifact.dependencies.rules, ...artifact.dependencies.tokens];
+    const pinned = new Set(artifact.external.map((e) => e.provider));
+    const loose = new Map();
+    for (const ref of refs) {
+        const parsed = parseArtifactRef(ref);
+        if (parsed === null || parsed.package === own || pinned.has(parsed.package))
+            continue;
+        loose.set(parsed.package, [...(loose.get(parsed.package) ?? []), ref]);
+    }
+    if (loose.size === 0)
+        return [];
+    return [...loose].map(([provider, refs]) => ({
+        code: "DESIGN_EVIDENCE_INSUFFICIENT",
+        artifact: file,
+        message: `depende de ${provider} sin fijarlo: ${refs.join(", ")}`,
+        action: `agregá a 'external' el proveedor ${provider} con su revisión y su digest, y conservá localmente ese subconjunto; sin esa evidencia queda en 'outline'`,
+    }));
+}
+/**
+ * What the implementation will have to prove.
+ *
+ * Derived, never authored: the obligations ARE the sections that state demands
+ * an implementation can fail — accessibility, permissions, states, adaptation.
+ * The gate records them so a later phase can ask for evidence instead of taking
+ * a rendered picture as proof.
+ *
+ * A section the document WAIVED is not an obligation. F2 makes the heading exist
+ * with real prose even when it is waived — the machine-readable reason and the
+ * human explanation are two audiences — so filtering by prose alone would demand
+ * evidence for exactly what the design justified as inapplicable. And the whole
+ * section is the statement: cutting at the first period dropped the second half
+ * of every rule, which is where the testable part usually lives.
+ */
+function readObligations(sections, waived) {
+    return sections
+        .filter((s) => OBLIGATION_KEYS.has(s.key) && s.prose.trim().length > 0 && waived[s.key] === undefined)
+        .map((s) => ({ key: s.key, statement: s.prose.replace(/\s+/g, " ").trim() }));
+}
+function headingOf(kind, key) {
+    return HEADINGS[kind].find((h) => headingKey(h) === key) ?? key;
+}
+/**
+ * The gate over raw document text: validate, then judge.
+ *
+ * One entry point so no caller can do half of it. A document that does not
+ * validate has no maturity to judge — `attainable` is `outline` because that is
+ * the only honest thing to say about text that is not yet a document.
+ */
+export function gateDesignDocument(text, kind, file) {
+    const document = validateDesignArtifact(text, kind, file);
+    if (!document.ok || document.value === null) {
+        return { attainable: "outline", failures: document.failures, obligations: [] };
+    }
+    const split = splitDesignDocument(text);
+    const sections = split === null ? [] : parseBody(split.body, split.bodyLine).sections;
+    return checkMaturity(document.value, sections, kind, file);
+}
+//# sourceMappingURL=maturity.js.map

package/dist/domain/design/maturity.js.map

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

package/dist/domain/design/naming.js

@@ -0,0 +1,117 @@
+/**
+ * Where each normative artifact lives, and what its file is called.
+ *
+ * This is what makes immutability CHECKABLE rather than promised: the revision
+ * is part of the file name, so publishing `@r2` writes a new file and cannot
+ * overwrite `@r1` — not by policy, but because they are different paths. An
+ * asset goes further and carries its own digest, so different bytes can never
+ * occupy the same name.
+ *
+ * The directory layout is contract too (spec § *Package unit and durable
+ * location*): `flows/`, `screens/`, `baselines/` and `governance/` always
+ * exist; `design-system/`, `renditions/`, `tokens/` and `assets/` appear when
+ * the content requires them.
+ */
+/** `2` → `r002`. Three digits so a directory listing sorts the way a human reads it. */
+export function revisionSegment(revision) {
+    return `r${String(revision).padStart(3, "0")}`;
+}
+export const NAMING = {
+    flow: {
+        dir: "flows",
+        prefix: (id, revision) => `${id}-${revisionSegment(revision)}-`,
+        suffix: ".md",
+    },
+    screen: {
+        dir: "screens",
+        prefix: (id, revision) => `${id}-${revisionSegment(revision)}-`,
+        suffix: ".md",
+    },
+    rule: {
+        dir: "design-system/rules",
+        prefix: (id, revision) => `${id}-${revisionSegment(revision)}-`,
+        suffix: ".md",
+    },
+    token: {
+        dir: "tokens",
+        prefix: (id, revision) => `${id}-${revisionSegment(revision)}-`,
+        suffix: ".tokens.json",
+    },
+    rendition: {
+        dir: "renditions",
+        prefix: (id, revision) => `${id}-${revisionSegment(revision)}-`,
+        suffix: "/rendition.json",
+    },
+};
+/** `baselines/DES-001-r004.json` — no slug: a baseline seals a revision, not a name. */
+export function baselinePath(packageId, revision) {
+    return `baselines/${packageId}-${revisionSegment(revision)}.json`;
+}
+/**
+ * Regenerable projections. They are NOT normative and never appear in the
+ * catalog: a baseline that selected them would make its digest depend on
+ * something derived, and re-rendering the landing page would rewrite history.
+ */
+export const PROJECTIONS = ["PACKAGE.md", "design-system/DESIGN.md"];
+/**
+ * Where each governance record lives (T7.1).
+ *
+ * Separate from `NAMING` on purpose: a record is not a normative artifact, is
+ * never selected by a baseline, and has no revision of its own — it decides ON
+ * one. Folding it into the same table would hand it a revision segment it must
+ * not have.
+ */
+export const GOVERNANCE_NAMING = {
+    review: { dir: "governance/reviews", prefix: "REV-" },
+    revocation: { dir: "governance/revocations", prefix: "RVK-" },
+};
+/** `governance/reviews/REV-001.json`, or why the path does not honor the rule. */
+export function checkGovernanceNaming(kind, path, id) {
+    const rule = GOVERNANCE_NAMING[kind];
+    const expected = `${rule.dir}/${id}.json`;
+    if (path === expected)
+        return { ok: true };
+    return {
+        ok: false,
+        why: `'${path}' no es la ubicación de ${id}`,
+        expected,
+    };
+}
+/** Does `path` name revision `revision` of artifact `id`, in the right place? */
+export function checkNaming(kind, path, id, revision) {
+    const rule = NAMING[kind];
+    const expected = `${rule.dir}/${rule.prefix(id, revision)}<slug>${rule.suffix}`;
+    if (PROJECTIONS.includes(path)) {
+        return {
+            ok: false,
+            why: `'${path}' es una proyección regenerable y no puede catalogarse como artefacto normativo`,
+            expected,
+        };
+    }
+    if (!path.startsWith(`${rule.dir}/`)) {
+        return { ok: false, why: `'${path}' no vive en '${rule.dir}/'`, expected };
+    }
+    const rest = path.slice(rule.dir.length + 1);
+    if (!rest.startsWith(rule.prefix(id, revision))) {
+        // The revision in the name is the whole point: without it, publishing the
+        // next revision would write over the one already referenced.
+        return {
+            ok: false,
+            why: `'${path}' no lleva '${rule.prefix(id, revision)}' en el nombre, así que su revisión no está en el path`,
+            expected,
+        };
+    }
+    if (!rest.endsWith(rule.suffix)) {
+        return { ok: false, why: `'${path}' no termina en '${rule.suffix}'`, expected };
+    }
+    const slug = rest.slice(rule.prefix(id, revision).length, rest.length - (rule.suffix?.length ?? 0));
+    if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(slug)) {
+        return {
+            ok: false,
+            why: `'${slug}' no es un slug: solo minúsculas, números y guiones`,
+            expected,
+        };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=naming.js.map

package/dist/domain/design/naming.js.map

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

package/dist/domain/design/offline.js

@@ -0,0 +1,92 @@
+/**
+ * The offline guarantee of a portable export, checked as a REJECTION.
+ *
+ * AC-REN-07 is not "prefer local assets": an offline preview that loads a font,
+ * a script, an image or a datum from a URL shows something different the day the
+ * network, the CDN or the account is gone — and it fails silently, looking like a
+ * rendering quirk. So a remote resource here is a validation error, never a
+ * warning: the whole value of a local snapshot is that what you see is what the
+ * package contains.
+ *
+ * Two deliberate calls.
+ *
+ * **It scans text instead of parsing.** A parser would tell a reference apart
+ * from prose, at the cost of a dependency, and would still have to decide what a
+ * URL inside a `style` attribute is. Scanning over-detects at worst, and in this
+ * direction over-detection is the safe failure: the author moves the URL out of
+ * the export and the export stays self-sufficient.
+ *
+ * **A hyperlink counts too.** `<a href="https://figma.com/…">` loads nothing
+ * until somebody clicks it, so a stricter reading would let it through. It is
+ * still reported, because the package already has the right place for that
+ * pointer — `provider.locator` in `rendition.json`, where a locator is recorded
+ * as a locator and cannot be mistaken for the evidence. Keeping the export free
+ * of every absolute URL is also what makes this check a scan rather than a parse.
+ *
+ * What is allowed is what travels inside the file or beside it: `data:` URIs,
+ * fragments, and paths relative to the rendition's own directory.
+ */
+/** A remote reference: any scheme-qualified or protocol-relative URL. */
+const REMOTE_URL = /(?:\b[a-z][a-z0-9+.-]*:\/\/|(?<![a-z0-9+.:/])\/\/)[^\s"'`)<>]+/gi;
+/** Schemes that carry their content inline, so they are not remote at all. */
+const INLINE_SCHEMES = /^(?:data|blob|about|cid):/i;
+/**
+ * `xmlns`/`xmlns:prefix` attributes, blanked before scanning.
+ *
+ * A namespace URI is an IDENTIFIER, not a fetch: nothing resolves
+ * `http://www.w3.org/2000/svg` over the network. And every inline SVG carries
+ * one, so treating it as a remote resource would reject exactly the format the
+ * static-preview requirement recommends.
+ */
+const NAMESPACE_ATTRIBUTE = /\bxmlns(?::[A-Za-z][\w.-]*)?\s*=\s*(?:"[^"]*"|'[^']*')/gi;
+/** Runtime calls that fetch at display time, whatever the URL looks like. */
+const NETWORK_CALLS = [
+    [/\bfetch\s*\(/i, "fetch()"],
+    [/\bXMLHttpRequest\b/, "XMLHttpRequest"],
+    [/\bnew\s+WebSocket\b/, "WebSocket"],
+    [/\bnew\s+EventSource\b/, "EventSource"],
+    [/\bimportScripts\s*\(/i, "importScripts()"],
+    [/\bnavigator\s*\.\s*sendBeacon\b/, "navigator.sendBeacon()"],
+];
+/**
+ * Judge an HTML export's self-sufficiency.
+ *
+ * Every finding quotes the offending text so the author can search for it: in a
+ * 400-line export, "there is a remote resource somewhere" is a dead end, and
+ * this is the one check whose fix always starts by finding that string.
+ */
+export function checkOfflineHtml(html, artifact) {
+    const scannable = html.replace(NAMESPACE_ATTRIBUTE, "");
+    const failures = [];
+    for (const url of remoteUrls(scannable)) {
+        failures.push({
+            code: "DESIGN_REMOTE_RESOURCE",
+            artifact,
+            message: `el export referencia '${url}', que vive fuera del package`,
+            action: "un export portable es autosuficiente: incrustá el recurso (inline o como data: URI), usá una ruta relativa a la carpeta de la rendition, o registrá el locator del proveedor en 'provider.locator'",
+        });
+    }
+    for (const [pattern, what] of NETWORK_CALLS) {
+        if (!pattern.test(scannable))
+            continue;
+        failures.push({
+            code: "DESIGN_REMOTE_RESOURCE",
+            artifact,
+            message: `el export usa ${what}: pide datos en tiempo de visualización`,
+            action: "incrustá en el propio HTML los datos que la preview necesita: sin red tiene que verse igual",
+        });
+    }
+    return failures;
+}
+/** Every distinct remote URL in the text, in order of appearance. */
+function remoteUrls(html) {
+    const out = [];
+    for (const match of html.matchAll(REMOTE_URL)) {
+        const url = match[0].replace(/[.,;:!?]+$/, "");
+        if (INLINE_SCHEMES.test(url) || out.includes(url))
+            continue;
+        out.push(url);
+    }
+    return out;
+}
+//# sourceMappingURL=offline.js.map

package/dist/domain/design/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.js","sourceRoot":"","sources":["../../../src/domain/design/offline.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,yEAAyE;AACzE,MAAM,UAAU,GAAG,kEAAkE,CAAC;AAEtF,8EAA8E;AAC9E,MAAM,cAAc,GAAG,4BAA4B,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,0DAA0D,CAAC;AAEvF,6EAA6E;AAC7E,MAAM,aAAa,GAAoC;IACrD,CAAC,eAAe,EAAE,SAAS,CAAC;IAC5B,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;IACxC,CAAC,qBAAqB,EAAE,WAAW,CAAC;IACpC,CAAC,uBAAuB,EAAE,aAAa,CAAC;IACxC,CAAC,uBAAuB,EAAE,iBAAiB,CAAC;IAC5C,CAAC,iCAAiC,EAAE,wBAAwB,CAAC;CAC9D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,wBAAwB;YAC9B,QAAQ;YACR,OAAO,EAAE,yBAAyB,GAAG,+BAA+B;YACpE,MAAM,EACJ,oMAAoM;SACvM,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,SAAS;QACvC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,wBAAwB;YAC9B,QAAQ;YACR,OAAO,EAAE,iBAAiB,IAAI,yCAAyC;YACvE,MAAM,EACJ,6FAA6F;SAChG,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}