@descryy/mcp 0.11.5 → 0.11.6

package/dist/browser/scenario-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-provenance.d.ts","sourceRoot":"","sources":["../../src/browser/scenario-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;yFAUyF;AAEzF,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAgC,KAAK,YAAY,EAAyB,MAAM,uBAAuB,CAAC;AAiC/G;;;;;;;+FAO+F;AAC/F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,GAAG,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,OAAO,EAAE,CAmBnH"}

package/dist/browser/scenario-provenance.js

@@ -0,0 +1,73 @@
+/** Provenance matching for `browser_save_scenario` — DEC-NEXT (Part 13 of the UAT audit). A step
+ *  the session actually performed, in order, was necessarily resolvable at the moment it ran; that
+ *  is stronger evidence than re-resolving the same step against a LATER static snapshot, which is
+ *  exactly what fails for a UI that reveals controls progressively (the earlier steps' own targets
+ *  can mutate — a "Try it out" button that renames itself to "Cancel" — or the later steps' targets
+ *  can vanish again by the time save() looks, even though every one of them was just performed live,
+ *  successfully, moments before). This module answers one question only: for each step in a
+ *  scenario, does it match something this session's own action log says actually happened, in the
+ *  same relative order? It does not decide what to do with that answer — the caller
+ *  (`browser-save-scenario.ts`) still runs today's single-snapshot check for anything this says no
+ *  to, which is the fallback that still catches a fabricated or hand-edited scenario. */
+import { isCredentialRef, isSecretRef } from "../scenarios/index.js";
+function targetsEqual(performed, declared) {
+    if (performed === null || declared === null)
+        return performed === declared;
+    return performed.role === declared.role && performed.name === declared.name && performed.selector === declared.selector;
+}
+/** The stored value against what was actually entered. Equal, or — when the stored value is a
+ *  secret reference — deliberately unequal, because replacing the literal with `${env:VAR}` is
+ *  the whole point of the reference. What provenance proves is that *this element was acted on*;
+ *  for `click` and `submit` there is no text to compare at all. Narrow on purpose: a literal is
+ *  still compared exactly, so a hand-constructed scenario claiming text that was never typed
+ *  still falls through to the fresh-snapshot check. */
+function textMatches(stored, performed) {
+    if (stored !== null && (isSecretRef(stored) || isCredentialRef(stored)))
+        return true;
+    return stored === performed;
+}
+function stepMatches(step, entry) {
+    if (step.action !== entry.action)
+        return false;
+    switch (step.action) {
+        case "navigate":
+            return step.url === entry.url;
+        case "click":
+        case "submit":
+            return targetsEqual(entry.target, step.target);
+        case "type":
+        case "fill":
+        case "select":
+            return targetsEqual(entry.target, step.target) && textMatches(step.text, entry.text);
+    }
+}
+/** For each of `steps`, in order: does it match an entry in `log`, without matching an earlier
+ *  step to a later log entry than a later step already claimed? A greedy in-order subsequence
+ *  match — each match consumes the log up to and including itself, so a match can never come
+ *  from *before* the previous step's own match, even though extra performed actions in between
+ *  (an explored dead end, a step the scenario doesn't include) are skipped over freely rather
+ *  than required to appear. `log` from a different or closed session, or a hand-constructed
+ *  scenario naming something that was never actually performed, matches nothing here — every
+ *  entry in `result` for it comes back `false`, leaving the fallback snapshot check to run. */
+export function matchByProvenance(steps, log) {
+    const result = [];
+    let cursor = 0;
+    for (const step of steps) {
+        let foundAt = -1;
+        for (let i = cursor; i < log.length; i += 1) {
+            if (stepMatches(step, log[i])) {
+                foundAt = i;
+                break;
+            }
+        }
+        if (foundAt === -1) {
+            result.push(false);
+        }
+        else {
+            result.push(true);
+            cursor = foundAt + 1;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=scenario-provenance.js.map

package/dist/browser/scenario-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-provenance.js","sourceRoot":"","sources":["../../src/browser/scenario-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;yFAUyF;AAGzF,OAAO,EAAE,eAAe,EAAE,WAAW,EAA4C,MAAM,uBAAuB,CAAC;AAE/G,SAAS,YAAY,CAAC,SAAiC,EAAE,QAAiC;IACxF,IAAI,SAAS,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,KAAK,QAAQ,CAAC;IAC3E,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,CAAC;AAC1H,CAAC;AAED;;;;;uDAKuD;AACvD,SAAS,WAAW,CAAC,MAAqB,EAAE,SAAwB;IAClE,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC;AAED,SAAS,WAAW,CAAC,IAAkB,EAAE,KAAoB;IAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/C,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC;QAChC,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED;;;;;;;+FAO+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,KAA8B,EAAE,GAA6B;IAC7F,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;gBAC/B,OAAO,GAAG,CAAC,CAAC;gBACZ,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/browser/scenario-resolve.d.ts

@@ -0,0 +1,28 @@
+/** Turning a stored target descriptor back into something clickable — DEC-383 §2/§3. Stored
+ *  steps carry role+name+selector, no `ref` (scoped to the issuing snapshot); resolution is
+ *  exact-or-refuse against a fresh snapshot, deliberately no fallback chain — substituting one
+ *  matching field for another turns a real disagreement into a quiet one, and the scenario
+ *  keeps reporting green against a changed page. Refusal messages name the exact disagreement (DEC-384). */
+import type { TargetDescriptor } from "../scenarios/index.ts";
+import type { PageSnapshot, SnapshotElement } from "./driver.ts";
+export type DescriptorField = "role" | "name" | "selector";
+/** Why a descriptor failed to resolve. `zero` — nothing matches at all. `ambiguous` —
+ *  several do, picking one would report on an unchosen run. `partial` — something still
+ *  matches part of it, the case `disagreed` exists for. */
+export interface ResolutionFailure {
+    readonly kind: "zero" | "ambiguous" | "partial";
+    /** Which of role/name/selector no longer agree. Empty for `zero` and `ambiguous`, where nothing partial matched to disagree with. */
+    readonly disagreed: readonly DescriptorField[];
+    readonly message: string;
+}
+export type TargetResolution = {
+    readonly resolved: true;
+    readonly element: SnapshotElement;
+} | {
+    readonly resolved: false;
+    readonly failure: ResolutionFailure;
+};
+/** Resolves one stored descriptor against a fresh snapshot. `where` labels what's being
+ *  resolved ("step 0") and is required — a refusal not saying which step is the failure this exists to avoid. */
+export declare function resolveTarget(where: string, target: TargetDescriptor, snapshot: PageSnapshot): TargetResolution;
+//# sourceMappingURL=scenario-resolve.d.ts.map

package/dist/browser/scenario-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-resolve.d.ts","sourceRoot":"","sources":["../../src/browser/scenario-resolve.ts"],"names":[],"mappings":"AAAA;;;;4GAI4G;AAE5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3D;;2DAE2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAChD,qIAAqI;IACrI,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAuBtE;iHACiH;AACjH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CA6E/G"}

package/dist/browser/scenario-resolve.js

@@ -0,0 +1,96 @@
+/** Turning a stored target descriptor back into something clickable — DEC-383 §2/§3. Stored
+ *  steps carry role+name+selector, no `ref` (scoped to the issuing snapshot); resolution is
+ *  exact-or-refuse against a fresh snapshot, deliberately no fallback chain — substituting one
+ *  matching field for another turns a real disagreement into a quiet one, and the scenario
+ *  keeps reporting green against a changed page. Refusal messages name the exact disagreement (DEC-384). */
+const FIELDS = ["role", "name", "selector"];
+function describe(target) {
+    return `role "${target.role}", name "${target.name}", selector "${target.selector}"`;
+}
+/** What the page holds, capped — a refusal a person has to scroll is one they stop reading. */
+function pageContents(snapshot, limit = 8) {
+    if (snapshot.elements.length === 0)
+        return "The page presents no elements at all.";
+    const shown = snapshot.elements
+        .slice(0, limit)
+        .map((e) => `role "${e.role}", name "${e.name}", selector "${e.selector}"`)
+        .join("; ");
+    const rest = snapshot.totalElements - Math.min(limit, snapshot.elements.length);
+    return `The page holds ${snapshot.totalElements} element(s): ${shown}${rest > 0 ? `; and ${rest} more` : ""}.`;
+}
+function disagreementsWith(target, element) {
+    return FIELDS.filter((field) => element[field] !== target[field]);
+}
+/** Resolves one stored descriptor against a fresh snapshot. `where` labels what's being
+ *  resolved ("step 0") and is required — a refusal not saying which step is the failure this exists to avoid. */
+export function resolveTarget(where, target, snapshot) {
+    const exact = snapshot.elements.filter((e) => e.role === target.role && e.name === target.name && e.selector === target.selector);
+    if (exact.length === 1)
+        return { resolved: true, element: exact[0] };
+    if (exact.length > 1) {
+        return {
+            resolved: false,
+            failure: {
+                kind: "ambiguous",
+                disagreed: [],
+                message: `${where}: ${exact.length} elements on ${snapshot.url} match ${describe(target)}. Resolution is ` +
+                    "exactly one match or none — the first is not picked, because a replay that guessed which element " +
+                    "it meant is reporting on a run nobody chose. Narrow the selector and re-save the step.",
+            },
+        };
+    }
+    const bySelector = snapshot.elements.filter((e) => e.selector === target.selector);
+    const byRoleName = snapshot.elements.filter((e) => e.role === target.role && e.name === target.name);
+    if (bySelector.length === 0 && byRoleName.length === 0) {
+        return {
+            resolved: false,
+            failure: {
+                kind: "zero",
+                disagreed: [],
+                message: `${where}: nothing on ${snapshot.url} matches ${describe(target)}, and nothing matches any part of ` +
+                    `it either. ${pageContents(snapshot)} Either this element was removed, or the scenario was saved ` +
+                    "against a different page than the one the replay reached.",
+            },
+        };
+    }
+    // The partial case — why the format stores all three fields. Both halves are reported
+    // when both matched, since two candidates exist and only a person knows which is theirs.
+    const parts = [];
+    const disagreed = new Set();
+    if (bySelector.length === 1) {
+        const found = bySelector[0];
+        for (const field of disagreementsWith(target, found))
+            disagreed.add(field);
+        const moved = disagreementsWith(target, found)
+            .map((field) => `${field} changed from "${target[field]}" to "${found[field]}"`)
+            .join(" and ");
+        parts.push(`selector "${target.selector}" still matches one element, but its ${moved}`);
+    }
+    else if (bySelector.length > 1) {
+        disagreed.add("selector");
+        parts.push(`selector "${target.selector}" now matches ${bySelector.length} elements, none of them with this role and name`);
+    }
+    if (byRoleName.length === 1) {
+        const found = byRoleName[0];
+        disagreed.add("selector");
+        parts.push(`an element with role "${target.role}" and name "${target.name}" is still on the page, but its ` +
+            `selector changed from "${target.selector}" to "${found.selector}"`);
+    }
+    else if (byRoleName.length > 1) {
+        disagreed.add("selector");
+        parts.push(`${byRoleName.length} elements still have role "${target.role}" and name "${target.name}", none of them at this selector`);
+    }
+    return {
+        resolved: false,
+        failure: {
+            kind: "partial",
+            // Ordered like the descriptor, so callers compare sets, not orderings.
+            disagreed: FIELDS.filter((field) => disagreed.has(field)),
+            message: `${where}: ${describe(target)} does not match exactly one element on ${snapshot.url}, but part of it ` +
+                `still does — ${parts.join("; ")}. The step is not run: substituting the half that still matches would ` +
+                "turn a real disagreement into a quiet one, and a scenario that does that keeps reporting green " +
+                "against a page that changed underneath it. Re-save the step if the change was intended.",
+        },
+    };
+}
+//# sourceMappingURL=scenario-resolve.js.map

package/dist/browser/scenario-resolve.js.map

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

package/dist/browser/scenario-runner.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Replays a stored scenario (§7 runner). DEC-384: failed assertion blocks; console
+ * error/failed request doesn't; no assertions is `unverified`; unresolvable step is
+ * neither pass nor fail. `registry.use()` and evidence draining run once per step only.
+ */
+import { type CredentialStoreLike, type Scenario, type ScenarioActionKind, type ScenarioAssertionKind, type SecretEnvironment } from "../scenarios/index.ts";
+import type { ToolContext } from "../tools/kit.ts";
+import type { BrowserEvidenceReport } from "./evidence.ts";
+import { type BrowserGraphWrite } from "./graph-write.ts";
+import type { BrowserSessionRegistry } from "./registry.ts";
+import { type ResolutionFailure } from "./scenario-resolve.ts";
+import { type DeadSession } from "./tool-support.ts";
+export interface ScenarioStepResult {
+    readonly index: number;
+    readonly action: ScenarioActionKind;
+    /** `ran` — performed. `unresolved` — the descriptor did not resolve, and the replay stopped here. `skipped` — never attempted, because an earlier step stopped the replay. */
+    readonly status: "ran" | "unresolved" | "skipped";
+    readonly url: string;
+    readonly resolution: ResolutionFailure | null;
+}
+export interface ScenarioAssertionResult {
+    readonly index: number;
+    readonly kind: ScenarioAssertionKind;
+    readonly afterStep: number | null;
+    /** `unevaluable` = hole in the artifact (e.g. missing comparison value); `notReached`
+     *  = anchored past where replay stopped. Neither is a defect claim; only
+     *  `unevaluable` joins `unresolved` (notReached is already counted there). */
+    readonly status: "passed" | "failed" | "unevaluable" | "notReached";
+    readonly detail: string;
+}
+export interface ScenarioCounts {
+    readonly passed: number;
+    readonly failed: number;
+    readonly unresolved: number;
+    readonly unverified: number;
+}
+export interface ScenarioReplay {
+    readonly scenario: string;
+    readonly sessionId: string;
+    readonly outcome: "passed" | "failed" | "unresolved" | "unverified";
+    readonly counts: ScenarioCounts;
+    /** Only failed assertions. See this file's header for why `unresolved` is not folded in. */
+    readonly blockingTotal: number;
+    /** 0 clean, 1 blocking findings, 2 could-not-run — `descry check`'s exit vocabulary,
+     *  computed here (not in the CLI) so the two never drift. Governs the CLI only;
+     *  this reply carries it as data, not a verdict. */
+    readonly exitCode: 0 | 1 | 2;
+    readonly steps: readonly ScenarioStepResult[];
+    readonly assertions: readonly ScenarioAssertionResult[];
+    /** One summary for the whole batch, aggregated from the per-step drains. */
+    readonly evidence: BrowserEvidenceReport;
+    readonly graph: BrowserGraphWrite;
+    /** Set when the session went away mid-replay — a crash, a reap, a disconnect. Null on a replay that ran to its own end. */
+    readonly sessionEnded: DeadSession | null;
+    /** True when the caller's own signal aborted mid-replay — distinct from `outcome`
+     *  because "caller cancelled" vs "a step wouldn't resolve" are different facts,
+     *  and only one says anything about the application. */
+    readonly cancelled: boolean;
+    readonly notes: readonly string[];
+}
+/** True when replaying this scenario would change the running application. A navigate-only scenario would not. */
+export declare function mutates(scenario: Scenario): boolean;
+export declare function replayScenario(ctx: ToolContext, registry: BrowserSessionRegistry, sessionId: string, scenario: Scenario, 
+/** Where a `${env:VAR}` step resolves its value. Defaulted rather than required so every
+ *  existing caller is unchanged, and injectable so a test never has to mutate the process. */
+env?: SecretEnvironment, 
+/** Where a `${credential:NAME}` step resolves its value — "sign in as this profile" without the
+ *  credential ever entering the committed file (lane A1, item 4). Undefined by default, same as
+ *  every existing caller being unchanged: a scenario naming a credential reference with no store
+ *  configured refuses by name rather than silently falling through to the environment resolver. */
+credentialStore?: CredentialStoreLike | undefined): Promise<ScenarioReplay>;
+//# sourceMappingURL=scenario-runner.d.ts.map

package/dist/browser/scenario-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-runner.d.ts","sourceRoot":"","sources":["../../src/browser/scenario-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAkD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,8KAA8K;IAC9K,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;kFAE8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,CAAC;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;IACpE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;wDAEoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACxD,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,2HAA2H;IAC3H,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1C;;4DAEwD;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAID,kHAAkH;AAClH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEnD;AA4BD,wBAAsB,cAAc,CAClC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ;AAClB;8FAC8F;AAC9F,GAAG,GAAE,iBAA+B;AACpC;;;mGAGmG;AACnG,eAAe,GAAE,mBAAmB,GAAG,SAAqB,GAC3D,OAAO,CAAC,cAAc,CAAC,CA8QzB"}