@aura3d/cli 3.0.1 → 4.0.0

package/dist/codemods/engine-entry-imports.js

@@ -0,0 +1,159 @@
+/**
+ * `engine-entry-imports` + `devtools-imports` codemods (PRD-15 T5.9, C-39).
+ *
+ * Driven by `docs/architecture/root-export-dispositions.json` (the T5.1
+ * ledger). For every `import { … } from "@aura3d/engine"` the codemod moves
+ * names whose §6.6 destination is a subpath onto `import { … } from
+ * "@aura3d/engine/<subpath>"`, merging into an existing import from that
+ * specifier when one exists. `devtools-imports` is the same engine limited
+ * to the `./devtools` destination; `engine-entry-imports` covers every
+ * non-deleted destination.
+ *
+ * Imports of deprecated subpaths (`@aura3d/engine/rendering`, `/lean`, …)
+ * have their specifier rewritten to the recorded `target` in
+ * `aura.exports.json#deprecated`. Names destined `deleted` stay put and are
+ * reported `mapping: "none"` — they are removed at 4.0.0 and need a manual
+ * call-site change.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import ts from "typescript";
+const REPO_ROOT = join(dirname(fileURLToPath(import.meta.url)), "../../../..");
+function dispositionMap() {
+    const map = new Map();
+    const to = new Map();
+    const ledger = JSON.parse(readFileSync(join(REPO_ROOT, "docs/architecture/root-export-dispositions.json"), "utf8"));
+    for (const e of ledger.entries) {
+        to.set(e.name, e.to);
+        if (e.to !== "deleted" && e.to !== ".") {
+            map.set(e.name, `@aura3d/engine${e.to.slice(1)}`);
+        }
+    }
+    return { map, to };
+}
+function deprecatedSubpathTargets() {
+    const spec = JSON.parse(readFileSync(join(REPO_ROOT, "aura.exports.json"), "utf8"));
+    const map = new Map();
+    for (const [sub, row] of Object.entries(spec.deprecated ?? {})) {
+        if (!row.target)
+            continue;
+        const from = sub === "." ? "@aura3d/engine" : `@aura3d/engine/${sub.replace(/^\.\//, "")}`;
+        const to = row.target.startsWith("@aura3d") ? row.target
+            : row.target === "." ? "@aura3d/engine"
+                : `@aura3d/engine/${row.target.replace(/^\.\//, "")}`;
+        map.set(from, to);
+    }
+    return map;
+}
+function applyEdits(source, edits) {
+    let out = source;
+    for (const e of [...edits].sort((a, b) => b.start - a.start))
+        out = out.slice(0, e.start) + e.text + out.slice(e.end);
+    return out;
+}
+const DOT = "@aura3d/engine";
+export function createEngineEntryImportsCodemod(scope) {
+    const { map: nameMap, to: toMap } = dispositionMap();
+    const subpathMap = deprecatedSubpathTargets();
+    const name = scope === "./devtools" ? "devtools-imports" : "engine-entry-imports";
+    return {
+        name,
+        owner: "prd15",
+        description: scope === "./devtools"
+            ? "Move devtools-destined \"@aura3d/engine\" imports to \"@aura3d/engine/devtools\" (PRD-15 T5.9)."
+            : "Move dispositioned \"@aura3d/engine\" imports to their §6.6 destination subpath (PRD-15 T5.9).",
+        transform(source, file) {
+            const rows = [];
+            const sf = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true);
+            const edits = [];
+            const pendingByTarget = new Map();
+            const posOf = (n) => sf.getLineAndCharacterOfPosition(n.getStart()).line + 1;
+            // import clause -> moved names by target specifier
+            for (const decl of sf.statements) {
+                if (!ts.isImportDeclaration(decl) || !ts.isStringLiteral(decl.moduleSpecifier))
+                    continue;
+                const spec = decl.moduleSpecifier.text;
+                const named = decl.importClause?.namedBindings;
+                if (!named || !ts.isNamedImports(named)) {
+                    // Side-effect or default/namespace imports on a deprecated subpath
+                    // keep the specifier (the stub warns once) and are reported.
+                    const retarget = subpathMap.get(spec);
+                    if (retarget && retarget !== spec) {
+                        rows.push({ file, line: posOf(decl), construct: `import from "${spec}"`, mapping: "none", note: `deprecated subpath — kept on warn-stub until 4.0.0; migrate to ${retarget}` });
+                    }
+                    continue;
+                }
+                if (spec !== DOT && !subpathMap.has(spec))
+                    continue;
+                const fromDeprecated = spec !== DOT;
+                const keep = [];
+                const move = new Map();
+                for (const el of named.elements) {
+                    const imported = el.propertyName?.getText() ?? el.name.getText();
+                    const target = nameMap.get(imported);
+                    const text = el.getText();
+                    if (!target || (scope && target !== `${DOT}/devtools`)) {
+                        keep.push(text);
+                        if (toMap.get(imported) === "deleted") {
+                            rows.push({ file, line: posOf(el), construct: `import { ${imported} } from "${spec}"`, mapping: "none", note: "deleted from \".\" in 4.0.0 — migrate the call site manually" });
+                        }
+                        else if (fromDeprecated) {
+                            rows.push({ file, line: posOf(el), construct: `import { ${imported} } from "${spec}"`, mapping: "none", note: `name has no §6.6 destination — kept on deprecated "${spec}" stub until 4.0.0` });
+                        }
+                        continue;
+                    }
+                    const bucket = move.get(target) ?? [];
+                    bucket.push(text);
+                    move.set(target, bucket);
+                    rows.push({ file, line: posOf(el), construct: `import { ${imported} } from "${spec}"`, mapping: "exact", target });
+                }
+                if (move.size === 0)
+                    continue;
+                const clauseText = keep.length
+                    ? `{ ${keep.join(", ")} }`
+                    : undefined;
+                const prefix = decl.importClause?.isTypeOnly ? "import type " : "import ";
+                const rebuild = clauseText
+                    ? `${prefix}${clauseText} from "${spec}";`
+                    : "";
+                edits.push({ start: decl.getStart(), end: decl.getEnd(), text: rebuild });
+                for (const [target, texts] of move) {
+                    const key = `${decl.importClause?.isTypeOnly ? "type" : "value"}|${target}`;
+                    const prev = pendingByTarget.get(key) ?? { spec: target, names: [], typeOnly: !!decl.importClause?.isTypeOnly };
+                    prev.names.push(...texts);
+                    pendingByTarget.set(key, prev);
+                }
+            }
+            // 2. emit/merge one import per target specifier after the last import
+            if (pendingByTarget.size) {
+                const lastImport = [...sf.statements].reverse().find((s) => ts.isImportDeclaration(s));
+                const insertAt = lastImport ? lastImport.getEnd() : 0;
+                let insertion = "";
+                for (const { spec, names, typeOnly } of pendingByTarget.values()) {
+                    const existing = [...sf.statements].find((s) => ts.isImportDeclaration(s) && ts.isStringLiteral(s.moduleSpecifier) && s.moduleSpecifier.text === spec &&
+                        s.importClause?.namedBindings !== undefined && ts.isNamedImports(s.importClause.namedBindings) &&
+                        !!s.importClause?.isTypeOnly === typeOnly);
+                    if (existing) {
+                        const bindings = existing.importClause.namedBindings;
+                        const merged = [...bindings.elements.map((e) => e.getText()), ...names].filter((v, i, a) => a.indexOf(v) === i);
+                        edits.push({ start: bindings.getStart(), end: bindings.getEnd(), text: `{ ${merged.join(", ")} }` });
+                    }
+                    else {
+                        insertion += `\nimport ${typeOnly ? "type " : ""}{ ${names.join(", ")} } from "${spec}";`;
+                    }
+                }
+                if (insertion)
+                    edits.push({ start: insertAt, end: insertAt, text: insertion });
+            }
+            // `import type` clauses keep their marker on the moved import as well —
+            // covered by merging the clause's own `type` modifiers through `text`
+            // and by the pendingByTarget merge path above (same-specifier imports
+            // are merged regardless of isTypeOnly, which TS accepts for named
+            // `type` element modifiers).
+            return { code: applyEdits(source, edits), rows };
+        },
+    };
+}
+export const createDevtoolsImportsCodemod = () => createEngineEntryImportsCodemod("./devtools");
+//# sourceMappingURL=engine-entry-imports.js.map

package/dist/codemods/engine-entry-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-entry-imports.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/codemods/engine-entry-imports.ts"],"names":[],"mappings":"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"}

package/dist/codemods/lean-imports.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `lean-imports` codemod (PRD-15 T4.7, C-39).
+ *
+ * Rewrites `@aura3d/lean[/(product|game)]` imports to `@aura3d/engine` after
+ * T4.6 turned the lean package into a deprecated §7.5 re-export shim.
+ *
+ *   import { createAuraApp, scene } from "@aura3d/lean/product";
+ *     → import { createAuraApp, scene } from "@aura3d/engine";
+ *
+ * Named bindings map mechanically:
+ *  - `exact`       — the name is exported unchanged by the engine
+ *  - `approximate` — a renamed engine equivalent, applied as an alias so local
+ *                    references keep compiling (`AuraLeanNodeBuilder` →
+ *                    `AuraNodeBuilder as AuraLeanNodeBuilder`)
+ *  - `none`        — lean-only API deleted by PRD-15 (the whole `base.ts` /
+ *                    `ArcadeRuntime.ts` surface); reported, no edit applied to
+ *                    the binding
+ *
+ * `import * as lean` namespaces and default imports are reported `none` —
+ * the lean package never had them, and mechanical namespace rewriting is
+ * unsafe.
+ */
+export interface CodemodRow {
+    readonly file: string;
+    readonly line: number;
+    readonly construct: string;
+    readonly mapping: "exact" | "approximate" | "none";
+    readonly target?: string;
+    readonly note?: string;
+}
+export declare function createLeanImportsCodemod(): {
+    name: string;
+    owner: string;
+    description: string;
+    transform(source: string, fileName: string): {
+        code: string;
+        rows: CodemodRow[];
+    };
+};
+//# sourceMappingURL=lean-imports.d.ts.map

package/dist/codemods/lean-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-imports.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/codemods/lean-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAwFD,wBAAgB,wBAAwB;;;;sBAKlB,MAAM,YAAY,MAAM;;;;EA0E7C"}

package/dist/codemods/lean-imports.js

@@ -0,0 +1,175 @@
+/**
+ * `lean-imports` codemod (PRD-15 T4.7, C-39).
+ *
+ * Rewrites `@aura3d/lean[/(product|game)]` imports to `@aura3d/engine` after
+ * T4.6 turned the lean package into a deprecated §7.5 re-export shim.
+ *
+ *   import { createAuraApp, scene } from "@aura3d/lean/product";
+ *     → import { createAuraApp, scene } from "@aura3d/engine";
+ *
+ * Named bindings map mechanically:
+ *  - `exact`       — the name is exported unchanged by the engine
+ *  - `approximate` — a renamed engine equivalent, applied as an alias so local
+ *                    references keep compiling (`AuraLeanNodeBuilder` →
+ *                    `AuraNodeBuilder as AuraLeanNodeBuilder`)
+ *  - `none`        — lean-only API deleted by PRD-15 (the whole `base.ts` /
+ *                    `ArcadeRuntime.ts` surface); reported, no edit applied to
+ *                    the binding
+ *
+ * `import * as lean` namespaces and default imports are reported `none` —
+ * the lean package never had them, and mechanical namespace rewriting is
+ * unsafe.
+ */
+import ts from "typescript";
+const LEAN_MODULES = new Set(["@aura3d/lean", "@aura3d/lean/product", "@aura3d/lean/game"]);
+const ENGINE = "@aura3d/engine";
+/** Renames with an engine equivalent; applied as `<new> as <old>` so call sites stay valid. */
+const RENAMED_BINDINGS = {
+    AuraLeanNodeBuilder: "AuraNodeBuilder",
+    LeanPlatformerEvent: "GamePlatformerEvent",
+    LeanPlatformerEventType: "GamePlatformerEventType",
+    LeanPlatformerLevel: "GamePlatformerLevel",
+    LeanPlatformerSnapshot: "GamePlatformerSnapshot",
+    LeanGameInputOptions: "GameInputOptions",
+    LeanGameInputController: "GameInputController"
+};
+/** Lean-only names deleted by PRD-15 — no engine equivalent. */
+function hasNoEngineEquivalent(name) {
+    if (name in RENAMED_BINDINGS)
+        return false;
+    return (/^createLean/.test(name) ||
+        /^Lean(?!PlatformerEvent|PlatformerLevel|PlatformerSnapshot|GameInput)/.test(name) ||
+        /^AuraLean(?!NodeBuilder)/.test(name) ||
+        name === "createAuraAppWithRenderer" ||
+        name === "createAuraLeanModelMatrix" ||
+        name === "AuraLeanGameApp" ||
+        /^Sdf/.test(name) ||
+        name === "SDF_FONT_SCOPE_NOTE" ||
+        name === "SDF_SUPPORTED_GLYPHS");
+}
+function lineOf(sf, pos) {
+    return sf.getLineAndCharacterOfPosition(pos).line + 1;
+}
+function isLeanModuleSpecifier(node) {
+    return node !== undefined && ts.isStringLiteral(node) && LEAN_MODULES.has(node.text);
+}
+/** Build the replacement text for one import clause, collecting rows. */
+function rewriteClause(sf, clause, moduleText, rows, edits) {
+    const { line } = { line: lineOf(sf, clause.getStart(sf)) };
+    const named = clause.namedBindings;
+    if (named !== undefined && ts.isNamespaceImport(named)) {
+        rows.push({ file: sf.fileName, line, construct: `import * as ${named.name.text} from ${moduleText}`, mapping: "none", target: ENGINE, note: "namespace import cannot be rewritten mechanically" });
+        return;
+    }
+    if (clause.name !== undefined) {
+        rows.push({ file: sf.fileName, line, construct: `import ${clause.name.text} from ${moduleText}`, mapping: "none", target: ENGINE, note: "lean has no default export; manual migration required" });
+    }
+    if (named === undefined || !ts.isNamedImports(named)) {
+        // Bare side-effect import (`import "@aura3d/lean"`): the deprecation warn is
+        // intentional; rewriting to the engine changes semantics. Report only.
+        if (named === undefined) {
+            rows.push({ file: sf.fileName, line, construct: `import ${moduleText}`, mapping: "none", target: ENGINE, note: "side-effect import; the deprecation warn is the point" });
+        }
+        return;
+    }
+    const clauseIsTypeOnly = clause.isTypeOnly;
+    for (const spec of named.elements) {
+        const imported = spec.propertyName?.text ?? spec.name.text;
+        const typeKeyword = clauseIsTypeOnly || spec.isTypeOnly ? "type " : "";
+        if (imported in RENAMED_BINDINGS) {
+            const engineName = RENAMED_BINDINGS[imported];
+            edits.push({ start: spec.getStart(sf), end: spec.getEnd(), text: `${typeKeyword}${engineName} as ${spec.name.text}` });
+            rows.push({ file: sf.fileName, line: lineOf(sf, spec.getStart(sf)), construct: `import { ${spec.getText(sf)} } from ${moduleText}`, mapping: "approximate", target: `${ENGINE} (${engineName})`, note: "renamed binding applied as alias" });
+        }
+        else if (hasNoEngineEquivalent(imported)) {
+            rows.push({ file: sf.fileName, line: lineOf(sf, spec.getStart(sf)), construct: `import { ${spec.getText(sf)} } from ${moduleText}`, mapping: "none", target: ENGINE, note: "deleted lean-only API; manual migration required" });
+        }
+        else {
+            rows.push({ file: sf.fileName, line: lineOf(sf, spec.getStart(sf)), construct: `import { ${spec.getText(sf)} } from ${moduleText}`, mapping: "exact", target: ENGINE });
+        }
+    }
+}
+export function createLeanImportsCodemod() {
+    return {
+        name: "lean-imports",
+        owner: "prd15",
+        description: "Rewrites @aura3d/lean[/(product|game)] imports to @aura3d/engine (PRD-15 T4.7).",
+        transform(source, fileName) {
+            const sf = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+            const rows = [];
+            const edits = [];
+            for (const statement of sf.statements) {
+                if (!ts.isImportDeclaration(statement))
+                    continue;
+                if (!isLeanModuleSpecifier(statement.moduleSpecifier))
+                    continue;
+                const moduleText = statement.moduleSpecifier.text;
+                const clause = statement.importClause;
+                if (clause === undefined) {
+                    rows.push({ file: fileName, line: lineOf(sf, statement.getStart(sf)), construct: `import "${moduleText}"`, mapping: "none", target: ENGINE, note: "side-effect import" });
+                    continue;
+                }
+                rewriteClause(sf, clause, `"${moduleText}"`, rows, edits);
+                // Rewrite the module specifier itself.
+                edits.push({
+                    start: statement.moduleSpecifier.getStart(sf),
+                    end: statement.moduleSpecifier.getEnd(),
+                    text: `"${ENGINE}"`
+                });
+            }
+            // `export ... from "@aura3d/lean"` re-exports get the same treatment.
+            for (const statement of sf.statements) {
+                if (!ts.isExportDeclaration(statement))
+                    continue;
+                const specifier = statement.moduleSpecifier;
+                if (specifier === undefined || !isLeanModuleSpecifier(specifier))
+                    continue;
+                const moduleText = specifier.text;
+                const clause = statement.exportClause;
+                if (clause !== undefined && ts.isNamedExports(clause)) {
+                    const exportIsTypeOnly = statement.isTypeOnly;
+                    for (const spec of clause.elements) {
+                        const exported = spec.propertyName?.text ?? spec.name.text;
+                        const typeKeyword = exportIsTypeOnly || spec.isTypeOnly ? "type " : "";
+                        if (exported in RENAMED_BINDINGS) {
+                            const engineName = RENAMED_BINDINGS[exported];
+                            edits.push({ start: spec.getStart(sf), end: spec.getEnd(), text: `${typeKeyword}${engineName} as ${spec.name.text}` });
+                            rows.push({ file: fileName, line: lineOf(sf, spec.getStart(sf)), construct: `export { ${spec.getText(sf)} } from "${moduleText}"`, mapping: "approximate", target: `${ENGINE} (${engineName})` });
+                        }
+                        else if (hasNoEngineEquivalent(exported)) {
+                            rows.push({ file: fileName, line: lineOf(sf, spec.getStart(sf)), construct: `export { ${spec.getText(sf)} } from "${moduleText}"`, mapping: "none", target: ENGINE, note: "deleted lean-only API" });
+                        }
+                        else {
+                            rows.push({ file: fileName, line: lineOf(sf, spec.getStart(sf)), construct: `export { ${spec.getText(sf)} } from "${moduleText}"`, mapping: "exact", target: ENGINE });
+                        }
+                    }
+                }
+                else {
+                    rows.push({ file: fileName, line: lineOf(sf, statement.getStart(sf)), construct: `export * from "${moduleText}"`, mapping: "none", target: ENGINE, note: "star re-export" });
+                }
+                edits.push({
+                    start: specifier.getStart(sf),
+                    end: specifier.getEnd(),
+                    text: `"${ENGINE}"`
+                });
+            }
+            // `import("@aura3d/lean")` dynamic imports: specifier rewrite only.
+            const visit = (node) => {
+                if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+                    const [arg] = node.arguments;
+                    if (arg !== undefined && ts.isStringLiteral(arg) && LEAN_MODULES.has(arg.text)) {
+                        edits.push({ start: arg.getStart(sf), end: arg.getEnd(), text: `"${ENGINE}"` });
+                        rows.push({ file: fileName, line: lineOf(sf, arg.getStart(sf)), construct: `import("${arg.text}")`, mapping: "exact", target: ENGINE });
+                    }
+                }
+                ts.forEachChild(node, visit);
+            };
+            visit(sf);
+            const code = edits
+                .sort((a, b) => b.start - a.start)
+                .reduce((acc, edit) => acc.slice(0, edit.start) + edit.text + acc.slice(edit.end), source);
+            return { code, rows };
+        }
+    };
+}
+//# sourceMappingURL=lean-imports.js.map

package/dist/codemods/lean-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-imports.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/codemods/lean-imports.ts"],"names":[],"mappings":"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"}

package/dist/codemods/renderer-imports.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `renderer-imports` codemod (PRD-15 T2.11, C-39).
+ *
+ * Rewrites the four deprecated renderer subpaths
+ *   @aura3d/engine/advanced-runtime | @aura3d/engine/production-runtime |
+ *   @aura3d/rendering/advanced-runtime | @aura3d/rendering/production-runtime
+ * to `@aura3d/engine/renderer`, renames `A3DRenderer`/`A3DRendererOptions`
+ * identifiers to `Renderer`/`RendererOptions`, and rewrites member calls the
+ * deleted wrapper classes carried to the free functions on the new surface
+ * (`a3dRenderFrame`, `a3dRenderFrameAsync`, `rendererProofCapture`,
+ * `rendererFeatureReport`, `rendererShadowReport`).
+ *
+ * Every edit is a surgical splice on the source text — import declarations
+ * are rebuilt, everything else keeps its formatting. Constructs the codemod
+ * cannot map (names that are not exported on `./renderer`, receiver-dependent
+ * members like `.evidence()`/`.backend`, `preserveDrawingBuffer`) are kept
+ * and reported with `mapping: "none"`.
+ */
+export interface CodemodRow {
+    readonly file: string;
+    readonly line: number;
+    readonly construct: string;
+    readonly mapping: "exact" | "approximate" | "none";
+    readonly target?: string;
+    readonly note?: string;
+}
+export declare function createRendererImportsCodemod(): {
+    readonly name: "renderer-imports";
+    readonly owner: "prd15";
+    readonly description: string;
+    transform(source: string, fileName: string): {
+        readonly code: string;
+        readonly rows: readonly CodemodRow[];
+    };
+};
+//# sourceMappingURL=renderer-imports.d.ts.map

package/dist/codemods/renderer-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-imports.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/codemods/renderer-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAsFD,wBAAgB,4BAA4B,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAC;CAC9G,CAgRA"}