eslint-plugin-typefest 1.0.1

package/dist/_internal/import-insertion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @packageDocumentation
+ * Shared utilities for safely inserting import declarations in fixer output.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+/**
+ * Create a fixer that inserts an import declaration in a safe location: after
+ * existing imports, after directive prologue, before first statement, or at
+ * file end for empty programs.
+ *
+ * @param options - Fix-planning options.
+ *
+ *   - `fixer`: Rule fixer from ESLint.
+ *   - `referenceNode`: Node used to discover the enclosing Program.
+ *   - `importDeclarationText`: Full import declaration text to insert.
+ *   - `moduleSpecifierHint`: Optional known module specifier that skips import-text
+ *       parsing when provided.
+ *
+ * @returns Rule fix when insertion is possible; otherwise `null`.
+ */
+export declare const createImportInsertionFix: (options: Readonly<{
+    fixer: TSESLint.RuleFixer;
+    importDeclarationText: string;
+    moduleSpecifierHint?: string;
+    referenceNode: Readonly<TSESTree.Node>;
+}>) => null | TSESLint.RuleFix;
+//# sourceMappingURL=import-insertion.d.ts.map

package/dist/_internal/import-insertion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-insertion.d.ts","sourceRoot":"","sources":["../../src/_internal/import-insertion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAkWnE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,GACjC,SAAS,QAAQ,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;CAC1C,CAAC,KACH,IAAI,GAAG,QAAQ,CAAC,OAiFlB,CAAC"}

package/dist/_internal/import-insertion.js

@@ -0,0 +1,295 @@
+import parser from "@typescript-eslint/parser";
+import { arrayAt, isInteger } from "ts-extras";
+import { getProgramNode } from "./ast-node.js";
+import { getBoundedCacheValue, setBoundedCacheValue } from "./bounded-cache.js";
+import { safeTypeOperation } from "./safe-type-operation.js";
+import { isKnownWhitespaceCharacter } from "./text-character.js";
+/**
+ * Program-scoped insertion-layout cache reused across repeated fixer planning.
+ */
+const programInsertionLayoutCache = new WeakMap();
+const IMPORT_KEYWORD = "import";
+/**
+ * Upper bound for import-text snippets parsed to recover module specifiers.
+ *
+ * @remarks
+ * Fix suggestions can include large synthetic text. Capping parser input keeps
+ * this helper predictable on pathological inputs.
+ */
+const MAX_IMPORT_DECLARATION_TEXT_PARSE_LENGTH = 2048;
+const skipLeadingWhitespace = ({ startIndex, text, }) => {
+    let index = startIndex;
+    while (index < text.length &&
+        isKnownWhitespaceCharacter(text[index] ?? "")) {
+        index += 1;
+    }
+    return index;
+};
+const MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES = 256;
+const parsedModuleSpecifierByImportText = new Map();
+const isTrailingImportText = (text) => {
+    const trailingText = text.trim();
+    return trailingText === "" || trailingText === ";";
+};
+const parseModuleSpecifierFromImportDeclarationText = (importDeclarationText) => {
+    const parsedResult = safeTypeOperation({
+        operation: () => parser.parseForESLint(importDeclarationText, {
+            ecmaVersion: "latest",
+            loc: false,
+            range: false,
+            sourceType: "module",
+        }),
+        reason: "import-insertion-module-specifier-parse-failed",
+    });
+    if (!parsedResult.ok) {
+        return null;
+    }
+    const [firstStatement] = parsedResult.value.ast.body;
+    if (parsedResult.value.ast.body.length !== 1 ||
+        firstStatement?.type !== "ImportDeclaration") {
+        return null;
+    }
+    const moduleSpecifier = firstStatement.source.value;
+    return typeof moduleSpecifier === "string" ? moduleSpecifier : null;
+};
+/**
+ * Extract the module specifier from an import declaration text snippet.
+ */
+const getModuleSpecifierFromImportDeclarationText = (importDeclarationText) => {
+    const trimmedImportText = importDeclarationText.trim();
+    if (trimmedImportText.length > MAX_IMPORT_DECLARATION_TEXT_PARSE_LENGTH) {
+        setBoundedCacheValue({
+            cache: parsedModuleSpecifierByImportText,
+            key: trimmedImportText,
+            maxEntries: MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES,
+            value: null,
+        });
+        return null;
+    }
+    const cachedModuleSpecifierLookup = getBoundedCacheValue(parsedModuleSpecifierByImportText, trimmedImportText);
+    if (cachedModuleSpecifierLookup.found) {
+        return cachedModuleSpecifierLookup.value ?? null;
+    }
+    if (!trimmedImportText.startsWith(IMPORT_KEYWORD)) {
+        setBoundedCacheValue({
+            cache: parsedModuleSpecifierByImportText,
+            key: trimmedImportText,
+            maxEntries: MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES,
+            value: null,
+        });
+        return null;
+    }
+    const importClauseStart = skipLeadingWhitespace({
+        startIndex: IMPORT_KEYWORD.length,
+        text: trimmedImportText,
+    });
+    if (importClauseStart >= trimmedImportText.length) {
+        setBoundedCacheValue({
+            cache: parsedModuleSpecifierByImportText,
+            key: trimmedImportText,
+            maxEntries: MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES,
+            value: null,
+        });
+        return null;
+    }
+    const moduleSpecifier = parseModuleSpecifierFromImportDeclarationText(trimmedImportText);
+    if (moduleSpecifier !== null) {
+        setBoundedCacheValue({
+            cache: parsedModuleSpecifierByImportText,
+            key: trimmedImportText,
+            maxEntries: MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES,
+            value: moduleSpecifier,
+        });
+        return moduleSpecifier;
+    }
+    const semicolonIndex = trimmedImportText.lastIndexOf(";");
+    const trailingImportText = semicolonIndex === -1
+        ? ""
+        : trimmedImportText.slice(semicolonIndex + 1);
+    if (!isTrailingImportText(trailingImportText)) {
+        setBoundedCacheValue({
+            cache: parsedModuleSpecifierByImportText,
+            key: trimmedImportText,
+            maxEntries: MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES,
+            value: null,
+        });
+        return null;
+    }
+    setBoundedCacheValue({
+        cache: parsedModuleSpecifierByImportText,
+        key: trimmedImportText,
+        maxEntries: MAX_PARSED_MODULE_SPECIFIER_CACHE_ENTRIES,
+        value: null,
+    });
+    return null;
+};
+/**
+ * Determine whether a module specifier is relative (`./` or `../`) or rooted.
+ */
+const isRelativeModuleSpecifier = (moduleSpecifier) => moduleSpecifier.startsWith(".") || moduleSpecifier.startsWith("/");
+/**
+ * Read a string-valued module specifier from an import declaration node.
+ */
+const getImportDeclarationModuleSpecifier = (importDeclaration) => {
+    const sourceValue = importDeclaration.source.value;
+    return typeof sourceValue === "string" ? sourceValue : null;
+};
+/**
+ * Check whether a Program statement is part of the directive prologue (for
+ * example, `"use strict"`).
+ */
+const isDirectiveExpressionStatement = (statement) => statement.type === "ExpressionStatement" &&
+    typeof statement.directive === "string";
+/**
+ * Read and validate a node range tuple.
+ *
+ * @param node - Node whose range should be extracted.
+ *
+ * @returns `[start, end]` tuple when available and valid; otherwise `null`.
+ */
+const getNodeRange = (node) => {
+    const nodeRange = node.range;
+    if (!Array.isArray(nodeRange)) {
+        return null;
+    }
+    const [start, end] = nodeRange;
+    if (!isInteger(start) || !isInteger(end)) {
+        return null;
+    }
+    if (start < 0 || end < start) {
+        return null;
+    }
+    return [start, end];
+};
+/**
+ * Read the numeric start offset from an ESTree node range tuple.
+ *
+ * @param node - Node whose start offset should be extracted.
+ *
+ * @returns Numeric start offset when available; otherwise `null`.
+ */
+const getNodeRangeStart = (node) => {
+    const nodeRange = getNodeRange(node);
+    if (nodeRange === null) {
+        return null;
+    }
+    return arrayAt(nodeRange, 0) ?? null;
+};
+/**
+ * Read and validate the Program end offset from its range tuple.
+ *
+ * @param programNode - Program node whose range end should be read.
+ *
+ * @returns Valid end offset when available; otherwise `null`.
+ */
+const getProgramRangeEnd = (programNode) => {
+    const programRange = getNodeRange(programNode);
+    return programRange?.[1] ?? null;
+};
+/**
+ * Build and cache insertion-layout metadata for one Program.
+ */
+const getProgramInsertionLayout = (programNode) => {
+    const existingLayout = programInsertionLayoutCache.get(programNode);
+    if (existingLayout) {
+        return existingLayout;
+    }
+    const importDeclarations = [];
+    let firstRelativeImportDeclaration = null;
+    let lastNonRelativeImportDeclaration = null;
+    let lastDirectiveStatement = null;
+    let inDirectivePrologue = true;
+    for (const statement of programNode.body) {
+        if (inDirectivePrologue && isDirectiveExpressionStatement(statement)) {
+            lastDirectiveStatement = statement;
+        }
+        else {
+            inDirectivePrologue = false;
+        }
+        if (statement.type !== "ImportDeclaration") {
+            continue;
+        }
+        importDeclarations.push(statement);
+        const existingModuleSpecifier = getImportDeclarationModuleSpecifier(statement);
+        if (typeof existingModuleSpecifier === "string" &&
+            isRelativeModuleSpecifier(existingModuleSpecifier)) {
+            firstRelativeImportDeclaration ??= statement;
+            continue;
+        }
+        lastNonRelativeImportDeclaration = statement;
+    }
+    const [firstStatement] = programNode.body;
+    const layout = Object.freeze({
+        firstRelativeImportDeclaration,
+        firstStatementStart: firstStatement === undefined
+            ? null
+            : getNodeRangeStart(firstStatement),
+        importDeclarations: Object.freeze(importDeclarations),
+        lastDirectiveStatement,
+        lastImportDeclaration: arrayAt(importDeclarations, -1) ?? null,
+        lastNonRelativeImportDeclaration,
+        programEnd: getProgramRangeEnd(programNode),
+    });
+    programInsertionLayoutCache.set(programNode, layout);
+    return layout;
+};
+/**
+ * Create a fixer that inserts an import declaration in a safe location: after
+ * existing imports, after directive prologue, before first statement, or at
+ * file end for empty programs.
+ *
+ * @param options - Fix-planning options.
+ *
+ *   - `fixer`: Rule fixer from ESLint.
+ *   - `referenceNode`: Node used to discover the enclosing Program.
+ *   - `importDeclarationText`: Full import declaration text to insert.
+ *   - `moduleSpecifierHint`: Optional known module specifier that skips import-text
+ *       parsing when provided.
+ *
+ * @returns Rule fix when insertion is possible; otherwise `null`.
+ */
+export const createImportInsertionFix = (options) => {
+    const { fixer, importDeclarationText, moduleSpecifierHint, referenceNode } = options;
+    const normalizedImportDeclarationText = importDeclarationText.trim();
+    if (normalizedImportDeclarationText.length === 0) {
+        return null;
+    }
+    const programNode = getProgramNode(referenceNode);
+    if (!programNode) {
+        return null;
+    }
+    const insertionLayout = getProgramInsertionLayout(programNode);
+    if (insertionLayout.importDeclarations.length > 0) {
+        const moduleSpecifier = moduleSpecifierHint ??
+            getModuleSpecifierFromImportDeclarationText(normalizedImportDeclarationText);
+        if (typeof moduleSpecifier === "string" &&
+            !isRelativeModuleSpecifier(moduleSpecifier)) {
+            if (insertionLayout.lastNonRelativeImportDeclaration !== null) {
+                return fixer.insertTextAfter(insertionLayout.lastNonRelativeImportDeclaration, `\n${normalizedImportDeclarationText}`);
+            }
+            if (insertionLayout.firstRelativeImportDeclaration !== null) {
+                const firstRelativeImportStart = getNodeRangeStart(insertionLayout.firstRelativeImportDeclaration);
+                if (firstRelativeImportStart !== null) {
+                    return fixer.insertTextBeforeRange([firstRelativeImportStart, firstRelativeImportStart], `${normalizedImportDeclarationText}\n`);
+                }
+            }
+        }
+    }
+    if (insertionLayout.lastImportDeclaration !== null) {
+        return fixer.insertTextAfter(insertionLayout.lastImportDeclaration, `\n${normalizedImportDeclarationText}`);
+    }
+    if (insertionLayout.lastDirectiveStatement !== null) {
+        return fixer.insertTextAfter(insertionLayout.lastDirectiveStatement, `\n${normalizedImportDeclarationText}`);
+    }
+    if (insertionLayout.firstStatementStart !== null) {
+        return fixer.insertTextBeforeRange([
+            insertionLayout.firstStatementStart,
+            insertionLayout.firstStatementStart,
+        ], `${normalizedImportDeclarationText}\n`);
+    }
+    if (insertionLayout.programEnd === null) {
+        return null;
+    }
+    return fixer.insertTextBeforeRange([insertionLayout.programEnd, insertionLayout.programEnd], `${insertionLayout.programEnd === 0 ? "" : "\n"}${normalizedImportDeclarationText}\n`);
+};
+//# sourceMappingURL=import-insertion.js.map

package/dist/_internal/import-insertion.js.map

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

package/dist/_internal/imported-type-aliases.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @packageDocumentation
+ * Internal shared utilities used by eslint-plugin-typefest rule modules and plugin wiring.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import { type ImportFixIntent } from "./import-fix-coordinator.js";
+/**
+ * Matched imported type alias that can be replaced with a canonical name.
+ */
+type ImportedTypeAliasMatch = {
+    importedName: string;
+    replacementName: string;
+    sourceValue: string;
+};
+/**
+ * Collects imported canonical type alias names that should be replaced by
+ * preferred type-fest utility names.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param replacementsByImportedName - Mapping from imported symbol names to
+ *   preferred replacement names.
+ *
+ * @returns Map keyed by canonical imported alias name with replacement
+ *   metadata.
+ */
+export declare const collectImportedTypeAliasMatches: (sourceCode: Readonly<TSESLint.SourceCode>, replacementsByImportedName: Readonly<Record<string, string>>) => ReadonlyMap<string, ImportedTypeAliasMatch>;
+/**
+ * Collect direct (non-renamed) named imports for a specific source module.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param expectedSourceValue - Module source string to match.
+ *
+ * @returns Set of imported identifier names.
+ */
+export declare const collectDirectNamedImportsFromSource: (sourceCode: Readonly<TSESLint.SourceCode>, expectedSourceValue: string) => ReadonlySet<string>;
+/**
+ * Collect local identifier names for a specific named import from a selected
+ * module source.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param expectedSourceValue - Module source string to match.
+ * @param expectedImportedName - Imported symbol name to match.
+ *
+ * @returns Set of local identifier names (including aliased locals).
+ */
+export declare const collectNamedImportLocalNamesFromSource: (sourceCode: Readonly<TSESLint.SourceCode>, expectedSourceValue: string, expectedImportedName: string) => ReadonlySet<string>;
+/**
+ * Collect local identifier names for namespace imports from a selected module
+ * source.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param expectedSourceValue - Module source string to match.
+ *
+ * @returns Set of namespace import local names.
+ */
+export declare const collectNamespaceImportLocalNamesFromSource: (sourceCode: Readonly<TSESLint.SourceCode>, expectedSourceValue: string) => ReadonlySet<string>;
+/**
+ * Determine whether a type parameter name is shadowed by any enclosing generic
+ * declaration.
+ *
+ * @param node - Node used as the starting point for ancestor traversal.
+ * @param parameterName - Type parameter name to detect.
+ *
+ * @returns `true` when an ancestor declares a matching type parameter.
+ */
+export declare function isTypeParameterNameShadowed(node: Readonly<TSESTree.Node>, parameterName: string): boolean;
+/**
+ * Build a safe type-reference replacement fixer.
+ *
+ * @param node - Type reference node to potentially fix.
+ * @param replacementName - Replacement identifier text.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export declare const createSafeTypeReferenceReplacementFix: (node: Readonly<TSESTree.TSTypeReference>, replacementName: string, availableReplacementNames: Readonly<ReadonlySet<string>>, sourceModuleName?: string, reportFixIntent?: ImportFixIntent) => null | TSESLint.ReportFixFunction;
+/**
+ * Build a safe whole-type-node replacement fixer with custom replacement text.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement symbol name used for import/scope safety
+ *   checks.
+ * @param replacementText - Final replacement text to emit.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export declare const createSafeTypeNodeTextReplacementFix: (node: Readonly<TSESTree.Node>, replacementName: string, replacementText: string, availableReplacementNames: Readonly<ReadonlySet<string>>, sourceModuleName?: string, reportFixIntent?: ImportFixIntent) => null | TSESLint.ReportFixFunction;
+/**
+ * Build a safe whole-type-node replacement fixer.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement identifier text.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export declare const createSafeTypeNodeReplacementFix: (node: Readonly<TSESTree.Node>, replacementName: string, availableReplacementNames: Readonly<ReadonlySet<string>>, sourceModuleName?: string, reportFixIntent?: ImportFixIntent) => null | TSESLint.ReportFixFunction;
+/**
+ * Build a safe whole-type-node replacement fixer that preserves explicit
+ * readonly wrappers/operators from the original node.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement symbol name used for import/scope safety
+ *   checks.
+ * @param replacementText - Final replacement text before readonly-preservation
+ *   adjustment.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export declare const createSafeTypeNodeTextReplacementFixPreservingReadonly: (node: Readonly<TSESTree.Node>, replacementName: string, replacementText: string, availableReplacementNames: Readonly<ReadonlySet<string>>, sourceModuleName?: string, reportFixIntent?: ImportFixIntent) => null | TSESLint.ReportFixFunction;
+/**
+ * Build a safe whole-type-node replacement fixer that preserves explicit
+ * readonly wrappers/operators from the original node.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement identifier text.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export declare const createSafeTypeNodeReplacementFixPreservingReadonly: (node: Readonly<TSESTree.Node>, replacementName: string, availableReplacementNames: Readonly<ReadonlySet<string>>, sourceModuleName?: string, reportFixIntent?: ImportFixIntent) => null | TSESLint.ReportFixFunction;
+export {};
+//# sourceMappingURL=imported-type-aliases.d.ts.map

package/dist/_internal/imported-type-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imported-type-aliases.d.ts","sourceRoot":"","sources":["../../src/_internal/imported-type-aliases.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAYnE,OAAO,EACH,KAAK,eAAe,EAEvB,MAAM,6BAA6B,CAAC;AA+BrC;;GAEG;AACH,KAAK,sBAAsB,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,GACxC,YAAY,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzC,4BAA4B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAC7D,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAgC5C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC,GAC5C,YAAY,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzC,qBAAqB,MAAM,KAC5B,WAAW,CAAC,MAAM,CAkBpB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,sCAAsC,GAC/C,YAAY,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzC,qBAAqB,MAAM,EAC3B,sBAAsB,MAAM,KAC7B,WAAW,CAAC,MAAM,CAMhB,CAAC;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,0CAA0C,GACnD,YAAY,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzC,qBAAqB,MAAM,KAC5B,WAAW,CAAC,MAAM,CAIhB,CAAC;AA0DN;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,aAAa,EAAE,MAAM,GACtB,OAAO,CAST;AA6DD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qCAAqC,GAC9C,MAAM,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EACxC,iBAAiB,MAAM,EACvB,2BAA2B,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACxD,mBAAkB,MAAgC,EAClD,kBAAiB,eAA2B,KAC7C,IAAI,GAAG,QAAQ,CAAC,iBAclB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oCAAoC,GAC7C,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,iBAAiB,MAAM,EACvB,iBAAiB,MAAM,EACvB,2BAA2B,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACxD,mBAAkB,MAAgC,EAClD,kBAAiB,eAA2B,KAC7C,IAAI,GAAG,QAAQ,CAAC,iBAQb,CAAC;AAEP;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,GACzC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,iBAAiB,MAAM,EACvB,2BAA2B,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACxD,mBAAkB,MAAgC,EAClD,kBAAiB,eAA2B,KAC7C,IAAI,GAAG,QAAQ,CAAC,iBAQd,CAAC;AAqCN;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sDAAsD,GAC/D,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,iBAAiB,MAAM,EACvB,iBAAiB,MAAM,EACvB,2BAA2B,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACxD,mBAAkB,MAAgC,EAClD,kBAAiB,eAA2B,KAC7C,IAAI,GAAG,QAAQ,CAAC,iBAelB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kDAAkD,GAC3D,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,iBAAiB,MAAM,EACvB,2BAA2B,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACxD,mBAAkB,MAAgC,EAClD,kBAAiB,eAA2B,KAC7C,IAAI,GAAG,QAAQ,CAAC,iBAQd,CAAC"}