codesift-mcp 0.7.0 → 0.8.2

package/dist/tools/php8-migration-candidates-tools.js

@@ -0,0 +1,476 @@
+/**
+ * PHP 8 modernization candidate finder (M1).
+ *
+ * Companion to M3 (php8_compat_check). Where M3 is the gating tool — "will
+ * this PHP 8 merge break anything" — M1 is the post-merge modernization
+ * tool. After PHP 8 lands, run M1 to surface places where the legacy
+ * 7.2-style idiom can be tightened up using new language features.
+ *
+ * Sub-checks (each is a regex pattern over file content):
+ *
+ *   promotable-ctor           ctor with N parameters whose body only does
+ *                             $this->x = $x assignments — collapse to
+ *                             promoted constructor (PHP 8.0+).
+ *   docblock-to-typed-property /** @var T *\/ above an untyped public/private
+ *                             property — convert to inline `public T $x`
+ *                             (PHP 7.4+).
+ *   nullable-flag-to-syntax   /** @var T|null *\/ — same conversion but
+ *                             produces `public ?T $x`.
+ *   readonly-candidate        property only assigned in __construct — add
+ *                             `readonly` modifier (PHP 8.1+).
+ *   enum-from-class-consts    class with N const NAME = 'value' entries +
+ *                             a getValues()/getOptions() method — convert
+ *                             to a backed enum (PHP 8.1+).
+ *   match-from-switch         switch ($x) { case A: return ...; ...}
+ *                             without fall-through — convert to match.
+ *
+ * Each finding includes:
+ *   - file, line, snippet
+ *   - rule_id, severity (always "modernize" — informational, never blocking)
+ *   - suggested_replacement: rough sketch of the new form (string, NOT
+ *     auto-applied)
+ *   - confidence: "high" | "medium" | "low"
+ *
+ * The tool is intentionally lossy: many candidates will be rejected after
+ * human review (e.g., a property "only assigned in ctor" might still be
+ * mutated via reflection for testing). The point is to triage thousands
+ * of files into a small reviewable list, not to auto-fix.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+const VENDOR_RE = /(^|\/)(?:vendor|node_modules|runtime|tests\/_data)(\/|$)/;
+const SAMPLE_LIMIT_PER_RULE = 5;
+export async function findPhp8MigrationCandidates(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const sampleLimit = options?.max_samples_per_rule ?? SAMPLE_LIMIT_PER_RULE;
+    const includeVendor = options?.include_vendor ?? false;
+    const filePattern = options?.file_pattern;
+    const ruleFilter = options?.rules ? new Set(options.rules) : null;
+    const phpFiles = index.files.filter((f) => {
+        if (!f.path.endsWith(".php"))
+            return false;
+        if (!includeVendor && VENDOR_RE.test(f.path))
+            return false;
+        if (filePattern && !f.path.includes(filePattern))
+            return false;
+        return true;
+    });
+    const candidates = [];
+    // Symbol-level rules use the index directly (faster, no second file read).
+    if (!ruleFilter || ruleFilter.has("docblock-to-typed-property")) {
+        findDocblockToTypedProperty(index, candidates);
+    }
+    if (!ruleFilter || ruleFilter.has("nullable-flag-to-syntax")) {
+        findNullableFlagToSyntax(index, candidates);
+    }
+    if (!ruleFilter || ruleFilter.has("readonly-candidate")) {
+        findReadonlyCandidates(index, candidates);
+    }
+    if (!ruleFilter || ruleFilter.has("enum-from-class-consts")) {
+        findEnumFromClassConsts(index, candidates);
+    }
+    if (!ruleFilter || ruleFilter.has("promotable-ctor")) {
+        findPromotableCtor(index, candidates);
+    }
+    // File-level rule (match-from-switch) needs the raw source — switch/match
+    // can span across functions, so a per-symbol scan would miss cross-method
+    // patterns. Scoped to the file set we already filtered.
+    if (!ruleFilter || ruleFilter.has("match-from-switch")) {
+        await Promise.all(phpFiles.map(async (f) => {
+            let content;
+            try {
+                content = await readFile(join(index.root, f.path), "utf-8");
+            }
+            catch {
+                return;
+            }
+            findMatchFromSwitch(content, f.path, candidates);
+        }));
+    }
+    // Group by rule with sample cap.
+    const byRuleMap = new Map();
+    for (const c of candidates) {
+        if (!byRuleMap.has(c.rule_id))
+            byRuleMap.set(c.rule_id, []);
+        byRuleMap.get(c.rule_id).push(c);
+    }
+    const byRule = [...byRuleMap.entries()].map(([rule_id, list]) => ({
+        rule_id,
+        count: list.length,
+        description: RULE_DESCRIPTIONS[rule_id],
+        samples: list.slice(0, sampleLimit),
+    }));
+    byRule.sort((a, b) => b.count - a.count);
+    return {
+        repo,
+        scanned_files: phpFiles.length,
+        total_candidates: candidates.length,
+        by_rule: byRule,
+        candidates,
+    };
+}
+// ---------------------------------------------------------------------------
+// Rule descriptions (used in output for clarity)
+// ---------------------------------------------------------------------------
+const RULE_DESCRIPTIONS = {
+    "promotable-ctor": "__construct that only assigns parameters to same-named properties — collapse to PHP 8.0 promoted constructor.",
+    "docblock-to-typed-property": "/** @var T */ above an untyped property — convert to PHP 7.4 inline typed property `public T $x;`.",
+    "nullable-flag-to-syntax": "/** @var T|null */ above a property — convert to PHP 7.4 nullable typed property `public ?T $x;`.",
+    "readonly-candidate": "Property only assigned in __construct, no setter, no unset — add `readonly` modifier (PHP 8.1+).",
+    "enum-from-class-consts": "Pre-enum idiom: class of `const FOO = 'foo'` literals + getValues()/getOptions() — convert to PHP 8.1 backed enum.",
+    "match-from-switch": "switch with no fall-through where every case returns a value — convert to PHP 8.0 match expression.",
+};
+// ---------------------------------------------------------------------------
+// Rule implementations
+// ---------------------------------------------------------------------------
+/**
+ * docblock-to-typed-property: inline type would replace @var. Uses the v2.0.0
+ * extractor's `meta.type_source: "phpdoc"` flag — that's exactly the cohort
+ * we want (property has type info in the docblock but not inline).
+ */
+function findDocblockToTypedProperty(index, out) {
+    for (const sym of index.symbols) {
+        if (sym.kind !== "field")
+            continue;
+        if (!sym.file.endsWith(".php"))
+            continue;
+        if (sym.meta?.from_constructor)
+            continue; // skip promoted-ctor synth fields
+        const ts = sym.meta?.type_source;
+        if (ts !== "phpdoc")
+            continue;
+        const t = sym.meta?.type;
+        if (!t)
+            continue;
+        // Skip rule 2 patterns (nullable union) — they belong to nullable-flag-to-syntax
+        if (/\|null\b|\bnull\|/.test(t))
+            continue;
+        const visibility = sym.meta?.visibility ?? "public";
+        const propName = sym.name.replace(/^\$/, "");
+        out.push({
+            rule_id: "docblock-to-typed-property",
+            file: sym.file,
+            line: sym.start_line,
+            snippet: `/** @var ${t} */ ${visibility} ${sym.name}`,
+            description: RULE_DESCRIPTIONS["docblock-to-typed-property"],
+            suggested_replacement: `${visibility} ${normalizeDocblockType(t)} \$${propName};`,
+            confidence: rateTypeConfidence(t),
+        });
+    }
+}
+/**
+ * nullable-flag-to-syntax: `@var T|null` → `?T`. Carved out from
+ * docblock-to-typed-property so callers can decide they want only the
+ * nullable conversion (which is the safer of the two — it never loses
+ * information).
+ */
+function findNullableFlagToSyntax(index, out) {
+    for (const sym of index.symbols) {
+        if (sym.kind !== "field")
+            continue;
+        if (!sym.file.endsWith(".php"))
+            continue;
+        if (sym.meta?.from_constructor)
+            continue;
+        if (sym.meta?.type_source !== "phpdoc")
+            continue;
+        const t = sym.meta?.type;
+        if (!t)
+            continue;
+        if (!/\|null\b|\bnull\|/.test(t))
+            continue;
+        const baseType = t.replace(/\|null$|^null\|/, "");
+        if (!baseType || baseType.includes("|"))
+            continue; // Multi-type union — not a simple ?T
+        const visibility = sym.meta?.visibility ?? "public";
+        const propName = sym.name.replace(/^\$/, "");
+        out.push({
+            rule_id: "nullable-flag-to-syntax",
+            file: sym.file,
+            line: sym.start_line,
+            snippet: `/** @var ${t} */ ${visibility} ${sym.name}`,
+            description: RULE_DESCRIPTIONS["nullable-flag-to-syntax"],
+            suggested_replacement: `${visibility} ?${normalizeDocblockType(baseType)} \$${propName};`,
+            confidence: rateTypeConfidence(baseType),
+        });
+    }
+}
+/**
+ * readonly-candidate: property assigned only in __construct. We approximate
+ * by walking the parent class's source for `$this->propName = ` patterns
+ * and checking that all of them appear inside the __construct body (or
+ * inside a method we know is the ctor). Conservative — false positives
+ * acceptable for a discovery tool.
+ */
+function findReadonlyCandidates(index, out) {
+    // Group fields by parent class id so we can scan each class once.
+    const fieldsByClass = new Map();
+    for (const sym of index.symbols) {
+        if (sym.kind !== "field")
+            continue;
+        if (!sym.parent)
+            continue;
+        if (sym.meta?.is_readonly)
+            continue; // already readonly
+        if (sym.meta?.is_static)
+            continue;
+        if (!fieldsByClass.has(sym.parent))
+            fieldsByClass.set(sym.parent, []);
+        fieldsByClass.get(sym.parent).push(sym);
+    }
+    for (const [classId, fields] of fieldsByClass.entries()) {
+        const cls = index.symbols.find((s) => s.id === classId);
+        if (!cls || !cls.source)
+            continue;
+        // Find the constructor method by name (could be __construct).
+        const ctor = index.symbols.find((s) => s.parent === classId && s.kind === "method" && s.name === "__construct");
+        const ctorSource = ctor?.source ?? "";
+        for (const f of fields) {
+            const propName = f.name.replace(/^\$/, "");
+            // All assignment sites for $this->propName in the class body.
+            const assignRe = new RegExp(`\\$this->${escapeRegex(propName)}\\s*=`, "g");
+            const allAssigns = (cls.source.match(assignRe) ?? []).length;
+            if (allAssigns === 0)
+                continue;
+            // How many of those assignments are inside the ctor body?
+            const ctorAssigns = (ctorSource.match(assignRe) ?? []).length;
+            if (ctorAssigns !== allAssigns)
+                continue;
+            // Skip if there is an explicit setter that mutates this property.
+            const setterRe = new RegExp(`function\\s+set${propName.charAt(0).toUpperCase()}${propName.slice(1)}\\s*\\(`, "i");
+            if (setterRe.test(cls.source))
+                continue;
+            const visibility = f.meta?.visibility ?? "public";
+            const inlineType = f.meta?.type ?? "mixed";
+            out.push({
+                rule_id: "readonly-candidate",
+                file: f.file,
+                line: f.start_line,
+                snippet: `${visibility} ${inlineType} \$${propName}`,
+                description: RULE_DESCRIPTIONS["readonly-candidate"],
+                suggested_replacement: `${visibility} readonly ${inlineType} \$${propName};`,
+                confidence: f.meta?.type_source === "inline" ? "high" : "medium",
+            });
+        }
+    }
+}
+/**
+ * enum-from-class-consts: classes that look like a pre-enum bag-of-constants.
+ * Heuristic: a class with >=3 `constant` symbols whose values are all
+ * string literals AND a static method named getValues / getOptions /
+ * getList / cases (which devs commonly add to enumerate the constants).
+ */
+function findEnumFromClassConsts(index, out) {
+    const constsByClass = new Map();
+    for (const sym of index.symbols) {
+        if (sym.kind !== "constant")
+            continue;
+        if (!sym.parent)
+            continue;
+        if (!sym.file.endsWith(".php"))
+            continue;
+        if (!constsByClass.has(sym.parent))
+            constsByClass.set(sym.parent, []);
+        constsByClass.get(sym.parent).push(sym);
+    }
+    const ENUM_HELPER_NAMES = new Set([
+        "getValues",
+        "getOptions",
+        "getList",
+        "all",
+        "labels",
+        "names",
+        "values",
+    ]);
+    for (const [classId, consts] of constsByClass.entries()) {
+        if (consts.length < 3)
+            continue;
+        const cls = index.symbols.find((s) => s.id === classId);
+        if (!cls || cls.kind !== "class")
+            continue;
+        // All constants must have string-literal values for this to be a true
+        // pre-enum. Mixed types or method calls are a sign of a config class.
+        let allStrings = true;
+        for (const c of consts) {
+            if (!c.source) {
+                allStrings = false;
+                break;
+            }
+            // const_element source is just `NAME = 'value'` (no `const` keyword,
+            // no trailing `;` — those belong to the enclosing const_declaration).
+            // Match a string literal anywhere after the `=`.
+            if (!/=\s*['"][^'"]*['"]/.test(c.source)) {
+                allStrings = false;
+                break;
+            }
+        }
+        if (!allStrings)
+            continue;
+        // At least one helper method name must be present (or class name ends
+        // in "Enum" / "Status" / "Type" — common pre-enum suffixes).
+        const helperPresent = index.symbols.some((s) => s.parent === classId &&
+            s.kind === "method" &&
+            ENUM_HELPER_NAMES.has(s.name));
+        const naming = /(?:Enum|Status|Type|Kind|Code)$/.test(cls.name);
+        if (!helperPresent && !naming)
+            continue;
+        out.push({
+            rule_id: "enum-from-class-consts",
+            file: cls.file,
+            line: cls.start_line,
+            snippet: `class ${cls.name} { ${consts.length} consts }`,
+            description: RULE_DESCRIPTIONS["enum-from-class-consts"],
+            suggested_replacement: `enum ${cls.name}: string { case Foo = 'foo'; /* … convert each const */ }`,
+            confidence: helperPresent ? "high" : "medium",
+        });
+    }
+}
+/**
+ * promotable-ctor: __construct(T $x, U $y) { $this->x = $x; $this->y = $y; }
+ * is mechanically promotable to __construct(public T $x, public U $y) {}.
+ *
+ * Heuristic: extract the constructor body, count assignment statements,
+ * count formal parameters. If every parameter $X has exactly one matching
+ * `$this->X = $X;` in the body and there are no other statements (modulo
+ * whitespace), the constructor is promotable.
+ */
+function findPromotableCtor(index, out) {
+    for (const sym of index.symbols) {
+        if (sym.kind !== "method" || sym.name !== "__construct")
+            continue;
+        if (!sym.source)
+            continue;
+        // Skip if already using promoted ctor (visibility on parameters).
+        if (/\b(?:public|private|protected)\s+(?:readonly\s+)?[\w\\?|&]+\s+\$\w+/.test(sym.source)) {
+            // This is a heuristic — promoted params have visibility BEFORE the
+            // type. Already-promoted ctors have nothing to modernize.
+            continue;
+        }
+        // Pull formal parameter names from the signature
+        const sigMatch = /__construct\s*\(([^)]*)\)/.exec(sym.source);
+        if (!sigMatch)
+            continue;
+        const sig = sigMatch[1];
+        if (!sig.trim())
+            continue;
+        const paramNames = [];
+        for (const part of sig.split(",")) {
+            const pm = /\$(\w+)/.exec(part);
+            if (pm)
+                paramNames.push(pm[1]);
+        }
+        if (paramNames.length === 0)
+            continue;
+        // Pull body { … }
+        const bodyStart = sym.source.indexOf("{");
+        const bodyEnd = sym.source.lastIndexOf("}");
+        if (bodyStart === -1 || bodyEnd <= bodyStart)
+            continue;
+        const body = sym.source.slice(bodyStart + 1, bodyEnd).trim();
+        // Count $this->NAME = $NAME; statements with names matching params.
+        let matched = 0;
+        let extras = 0;
+        const statements = body
+            .split(/;\s*(?:\n|$)/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        for (const stmt of statements) {
+            const am = /^\$this->(\w+)\s*=\s*\$(\w+)$/.exec(stmt);
+            if (am && am[1] === am[2] && paramNames.includes(am[1])) {
+                matched++;
+            }
+            else if (stmt && !/^\/\/|^#/.test(stmt)) {
+                extras++;
+            }
+        }
+        if (matched !== paramNames.length || extras > 0)
+            continue;
+        out.push({
+            rule_id: "promotable-ctor",
+            file: sym.file,
+            line: sym.start_line,
+            snippet: sym.source.slice(0, Math.min(160, sym.source.length)).replace(/\s+/g, " "),
+            description: RULE_DESCRIPTIONS["promotable-ctor"],
+            suggested_replacement: `public function __construct(${paramNames
+                .map((n) => `public \$${n}`)
+                .join(", ")}) {}`,
+            confidence: "high",
+        });
+    }
+}
+/**
+ * match-from-switch: every case returns a value, no fall-through. Pattern
+ * is regex-based — over-approximates by including switches that already
+ * have break statements. The auditor reviews each finding.
+ */
+function findMatchFromSwitch(content, file, out) {
+    // Bounded regex: switch with at least 2 case-return blocks and no
+    // visible break / fall-through within a 2000-char window after the
+    // switch keyword.
+    const switchRe = /switch\s*\(\s*(\$\w+(?:->\w+)?|\w+\s*\([^)]*\))\s*\)\s*\{/g;
+    let m;
+    while ((m = switchRe.exec(content)) !== null) {
+        const body = content.slice(m.index, m.index + 2000);
+        // Each case must contain a return; no `break` between cases means
+        // every branch terminates the switch.
+        const caseReturns = (body.match(/case\s+[^:]+:\s*[^\n]*return/g) ?? []).length;
+        const breaks = (body.match(/\bbreak\s*;/g) ?? []).length;
+        if (caseReturns >= 2 && breaks === 0) {
+            out.push({
+                rule_id: "match-from-switch",
+                file,
+                line: countLines(content, m.index),
+                snippet: extractLine(content, m.index),
+                description: RULE_DESCRIPTIONS["match-from-switch"],
+                suggested_replacement: "return match($expr) { … };",
+                confidence: caseReturns >= 4 ? "high" : "medium",
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function rateTypeConfidence(type) {
+    // Plain primitives = high confidence; class types = medium (might need
+    // alias resolution); union/intersection = low.
+    if (/^(?:string|int|integer|float|bool|boolean|array|mixed|void|object|iterable|callable)$/i.test(type)) {
+        return "high";
+    }
+    if (/[|&]/.test(type))
+        return "low";
+    return "medium";
+}
+function normalizeDocblockType(type) {
+    // Map common docblock spellings to PHP keyword forms.
+    const map = {
+        integer: "int",
+        boolean: "bool",
+        double: "float",
+    };
+    return map[type.toLowerCase()] ?? type;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function countLines(source, idx) {
+    let line = 1;
+    for (let i = 0; i < idx; i++) {
+        if (source.charCodeAt(i) === 10)
+            line++;
+    }
+    return line;
+}
+function extractLine(source, idx) {
+    const start = source.lastIndexOf("\n", idx) + 1;
+    const end = source.indexOf("\n", idx);
+    const line = source.slice(start, end === -1 ? source.length : end);
+    return line.trim().slice(0, 200);
+}
+//# sourceMappingURL=php8-migration-candidates-tools.js.map

package/dist/tools/php8-migration-candidates-tools.js.map

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

package/dist/tools/phpstan-baseline-tools.d.ts

@@ -0,0 +1,62 @@
+/**
+ * PHPStan baseline analyzer (N6).
+ *
+ * Mature PHP codebases adopt PHPStan incrementally — they raise the level
+ * to e.g. 6, generate a baseline file containing every existing error,
+ * and treat the baseline as a debt ledger. The Yii2 panel in this gap
+ * analysis (tgm-panel) ships an 18 011-line phpstan-baseline.neon — that's
+ * roughly 1 800 ignored errors. The team knows the debt is there but has
+ * no per-path triage data.
+ *
+ * This tool parses phpstan-baseline.neon and surfaces:
+ *   - by_path:    files ranked by error count
+ *   - by_category: error types (no-return-type, undefined-property,
+ *                  iterable-no-value-type, ...) ranked by frequency
+ *   - quick_wins: files with 1-3 errors — easy refactor targets
+ *   - aggregate counts (total_ignored, by-severity if hints present)
+ *
+ * The tool is universal — works on any PHP repo with PHPStan, not only
+ * Yii2. Auto-loads on composer.json detection.
+ *
+ * NEON parsing: NEON is a YAML superset with PHP-specific bracket forms.
+ * Rather than pull in a NEON parser dependency we hand-roll a minimal
+ * reader — the baseline format is mechanical (parameters: → ignoreErrors:
+ * → array of {message, count, path}). Edge cases like nested includes are
+ * out of scope; the tool would surface a file_unparseable note rather
+ * than crash.
+ */
+export interface PhpStanBaselineEntry {
+    message: string;
+    count: number;
+    path: string;
+    /** Best-effort category derived from the message text. */
+    category: string;
+}
+export interface PhpStanBaselineAudit {
+    repo: string;
+    baseline_file: string | null;
+    /** Total ignored errors (sum of count fields). */
+    total_ignored: number;
+    /** Files containing at least one ignored error. */
+    total_files: number;
+    by_path: Array<{
+        path: string;
+        count: number;
+    }>;
+    by_category: Record<string, number>;
+    /** Files with 1-3 ignored errors — quickest to clear. */
+    quick_wins: Array<{
+        path: string;
+        count: number;
+        categories: string[];
+    }>;
+    /** Raw entries (full list, sorted by count descending). */
+    entries: PhpStanBaselineEntry[];
+    /** Diagnostic when the baseline couldn't be parsed cleanly. */
+    parse_warnings: string[];
+}
+export declare function analyzePhpStanBaseline(repo: string, options?: {
+    baseline_path?: string;
+    max_paths?: number;
+}): Promise<PhpStanBaselineAudit>;
+//# sourceMappingURL=phpstan-baseline-tools.d.ts.map

package/dist/tools/phpstan-baseline-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phpstan-baseline-tools.d.ts","sourceRoot":"","sources":["../../src/tools/phpstan-baseline-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAUH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,yDAAyD;IACzD,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACzE,2DAA2D;IAC3D,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAQD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,oBAAoB,CAAC,CAuF/B"}