@design.estate/wcctools 6.0.0 → 6.1.0

package/dist_ts/standards/classes.standardfixer.js

@@ -0,0 +1,210 @@
+import * as plugins from '../plugins.js';
+import { rekeyStandardConfig } from './baselines.js';
+import { checkStandard, detectFindings, rulesOfProfile } from './checker.js';
+import { GitRepo } from './classes.gitrepo.js';
+import { loadStandardProject, standardSideFiles } from './classes.standardproject.js';
+import { FixBatch, StandardTree } from './classes.standardtree.js';
+import { StandardUsageError } from './errors.js';
+import { dirOf, isRepoPath, isTypeScriptSource } from './helpers.paths.js';
+import { fixOrder, standardRules } from './rules/index.js';
+/** How often one rule is re-run on the edited tree to apply edits that overlapped in an earlier run. */
+const maxRunsPerRule = 5;
+/**
+ * `wcctools fix`: applies the fixes of the selected rules to an in-memory copy of the repository,
+ * one rule after another on the re-parsed result, validates that every path of the resulting plan
+ * stays inside the repository root, then writes the configuration, moves files with `git mv`, writes
+ * the edited files and checks again. Refuses to run on a dirty work tree and never commits, so a
+ * failure part-way through the writes is undone with `git reset --hard` and `git clean -fd`.
+ */
+export class StandardFixer {
+    options;
+    constructor(optionsArg) {
+        this.options = optionsArg;
+    }
+    selectRules() {
+        const { profile } = this.options.loaded;
+        const inProfile = new Set(rulesOfProfile(profile).map((ruleArg) => ruleArg.id));
+        if (!this.options.rules || this.options.rules.length === 0) {
+            return fixOrder.filter((idArg) => inProfile.has(idArg) && standardRules.find((ruleArg) => ruleArg.id === idArg).fixMode === 'auto');
+        }
+        for (const id of this.options.rules) {
+            const rule = standardRules.find((ruleArg) => ruleArg.id === id);
+            if (!rule) {
+                throw new StandardUsageError(`Unknown rule '${id}'`);
+            }
+            if (!inProfile.has(id)) {
+                throw new StandardUsageError(`Rule '${id}' is not part of the '${profile}' profile`);
+            }
+            if (rule.fixMode === 'none') {
+                throw new StandardUsageError(`Rule '${id}' has no fix`);
+            }
+        }
+        return fixOrder.filter((idArg) => this.options.rules.includes(idArg));
+    }
+    async run() {
+        const { rootDir, loaded } = this.options;
+        const selected = this.selectRules();
+        const git = new GitRepo(rootDir);
+        const topLevel = await git.topLevel();
+        if (!topLevel || plugins.fsSync.realpathSync(topLevel) !== plugins.fsSync.realpathSync(rootDir)) {
+            throw new StandardUsageError(`wcctools fix runs at the root of a git repository; ${rootDir} is not one`);
+        }
+        const status = await git.statusLines();
+        if (status.length > 0) {
+            throw new StandardUsageError(`wcctools fix needs a clean work tree; git status reports ${status.length} change(s). Commit or stash them first.`);
+        }
+        const trackedFiles = await git.trackedFiles();
+        const files = new Map();
+        for (const file of trackedFiles) {
+            if (isTypeScriptSource(file) || standardSideFiles.includes(file)) {
+                files.set(file, await plugins.fs.readFile(plugins.path.join(rootDir, file), 'utf8'));
+            }
+        }
+        const tree = new StandardTree(files, trackedFiles, (fileArg) => plugins.fsSync.existsSync(plugins.path.join(rootDir, fileArg)));
+        for (const ruleId of selected) {
+            const rule = standardRules.find((ruleArg) => ruleArg.id === ruleId);
+            for (let run = 0; run < maxRunsPerRule; run++) {
+                const fixable = detectFindings(tree.project(), loaded, [rule]).filter((detectedArg) => !detectedArg.allowlisted && detectedArg.finding.fix);
+                if (fixable.length === 0) {
+                    break;
+                }
+                const batch = new FixBatch();
+                fixable.forEach((detectedArg) => detectedArg.finding.fix(batch));
+                if (tree.apply(rule.id, batch) === 0) {
+                    break;
+                }
+            }
+        }
+        const plan = tree.plan();
+        await this.assertInsideRoot(plan);
+        const rekeyed = rekeyStandardConfig(loaded.config, plan.moves);
+        if (rekeyed.changed.length > 0 && !this.options.configWriter) {
+            throw new StandardUsageError(`wcctools fix would move files that the standard configuration names (${rekeyed.changed.join(', ')}) but has no configuration writer`);
+        }
+        const loadedAfter = { ...loaded, config: rekeyed.config };
+        if (this.options.dryRun) {
+            return { dryRun: true, plan, remaining: checkStandard(tree.project(), loadedAfter) };
+        }
+        // Every path is validated above. The configuration goes first: a refused write (the file changed
+        // since it was read) leaves the tree untouched. A failure after it leaves a partial result that the
+        // clean work tree fix started from restores (`git reset --hard`, `git clean -fd`).
+        if (rekeyed.changed.length > 0) {
+            await this.options.configWriter.writeStandardConfig(rekeyed.config);
+        }
+        await this.commitMoves(git, plan.moves);
+        for (const file of [...plan.created, ...plan.edited.map((editedArg) => editedArg.file)]) {
+            await this.ensureDir(dirOf(file));
+            await plugins.fs.writeFile(plugins.path.join(rootDir, file), tree.files.get(file), 'utf8');
+        }
+        await this.removeEmptyDirs(plan.moves.map((moveArg) => dirOf(moveArg.from)));
+        return { dryRun: false, plan, remaining: checkStandard(await loadStandardProject(rootDir), loadedAfter) };
+    }
+    /**
+     * Refuses a plan with a path that leaves the repository root, lexically (an absolute path or a `..`
+     * segment) or physically (through a symbolic link that resolves outside the root or dangles).
+     * Runs before anything is written, so a refused plan leaves the repository and its surroundings as
+     * they were.
+     */
+    async assertInsideRoot(planArg) {
+        const realRoot = await plugins.fs.realpath(this.options.rootDir);
+        const paths = [
+            ...planArg.moves.flatMap((moveArg) => [moveArg.from, moveArg.to]),
+            ...planArg.created,
+            ...planArg.edited.map((editedArg) => editedArg.file),
+        ];
+        const outside = [];
+        for (const file of new Set(paths)) {
+            if (!isRepoPath(file) || !(await this.resolvesInside(realRoot, file))) {
+                outside.push(file);
+            }
+        }
+        if (outside.length > 0) {
+            throw new StandardUsageError(`wcctools fix refuses to write outside the repository root: ${outside.join(', ')}`);
+        }
+    }
+    /** True when the file, or its nearest existing ancestor, resolves to a path inside the real root. */
+    async resolvesInside(realRootArg, fileArg) {
+        let current = plugins.path.join(realRootArg, fileArg);
+        while (true) {
+            try {
+                const real = await plugins.fs.realpath(current);
+                return real === realRootArg || real.startsWith(`${realRootArg}${plugins.path.sep}`);
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== 'ENOENT' && code !== 'ENOTDIR') {
+                    throw error;
+                }
+            }
+            if (await this.isSymbolicLink(current)) {
+                // A dangling link: writing through it would create its target, wherever that is.
+                return false;
+            }
+            const parent = plugins.path.dirname(current);
+            if (parent === current) {
+                return false;
+            }
+            current = parent;
+        }
+    }
+    async isSymbolicLink(pathArg) {
+        try {
+            return (await plugins.fs.lstat(pathArg)).isSymbolicLink();
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === 'ENOENT' || code === 'ENOTDIR') {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /** `git mv` in an order where no move overwrites a file that has not moved away yet. */
+    async commitMoves(gitArg, movesArg) {
+        const pending = [...movesArg];
+        while (pending.length > 0) {
+            const index = pending.findIndex((moveArg) => !plugins.fsSync.existsSync(plugins.path.join(this.options.rootDir, moveArg.to)));
+            if (index === -1) {
+                throw new Error(`Cannot order the moves ${pending.map((moveArg) => `${moveArg.from} → ${moveArg.to}`).join(', ')}`);
+            }
+            const [move] = pending.splice(index, 1);
+            await this.ensureDir(dirOf(move.to));
+            await gitArg.move(move.from, move.to);
+        }
+    }
+    /** Creates a directory one path component at a time. */
+    async ensureDir(dirArg) {
+        let current = this.options.rootDir;
+        for (const segment of dirArg.split('/').filter((segmentArg) => segmentArg && segmentArg !== '.')) {
+            current = plugins.path.join(current, segment);
+            try {
+                await plugins.fs.mkdir(current);
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST') {
+                    throw error;
+                }
+            }
+        }
+    }
+    /** Removes directories that moves left empty, walking up towards the repository root. */
+    async removeEmptyDirs(dirsArg) {
+        for (const start of [...new Set(dirsArg)].sort((a, b) => b.length - a.length)) {
+            let dir = start;
+            while (dir && dir !== '.') {
+                try {
+                    await plugins.fs.rmdir(plugins.path.join(this.options.rootDir, dir));
+                }
+                catch (error) {
+                    const code = error.code;
+                    if (code === 'ENOTEMPTY' || code === 'EEXIST' || code === 'ENOENT') {
+                        break;
+                    }
+                    throw error;
+                }
+                dir = dirOf(dir);
+            }
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zdGFuZGFyZGZpeGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvc3RhbmRhcmRzL2NsYXNzZXMuc3RhbmRhcmRmaXhlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNyRCxPQUFPLEVBQUUsYUFBYSxFQUFFLGNBQWMsRUFBRSxjQUFjLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDN0UsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQy9DLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ3RGLE9BQU8sRUFBRSxRQUFRLEVBQUUsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFFbkUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ2pELE9BQU8sRUFBRSxLQUFLLEVBQUUsVUFBVSxFQUFFLGtCQUFrQixFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDM0UsT0FBTyxFQUFFLFFBQVEsRUFBRSxhQUFhLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQVkzRCx3R0FBd0c7QUFDeEcsTUFBTSxjQUFjLEdBQUcsQ0FBQyxDQUFDO0FBRXpCOzs7Ozs7R0FNRztBQUNILE1BQU0sT0FBTyxhQUFhO0lBQ1AsT0FBTyxDQUFzQjtJQUU5QyxZQUFZLFVBQStCO1FBQ3pDLElBQUksQ0FBQyxPQUFPLEdBQUcsVUFBVSxDQUFDO0lBQzVCLENBQUM7SUFFTyxXQUFXO1FBQ2pCLE1BQU0sRUFBRSxPQUFPLEVBQUUsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQztRQUN4QyxNQUFNLFNBQVMsR0FBRyxJQUFJLEdBQUcsQ0FBQyxjQUFjLENBQUMsT0FBTyxDQUFDLENBQUMsR0FBRyxD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

package/dist_ts/standards/classes.standardproject.d.ts

@@ -0,0 +1,80 @@
+import * as plugins from '../plugins.js';
+import * as ast from './helpers.ast.js';
+/** A class decorated with `@customElement(…)`. */
+export interface IStandardElement {
+    file: string;
+    sourceFile: ast.TSourceFile;
+    classNode: ast.TClassDeclaration;
+    className: string | null;
+    decoratorCall: ast.TCallExpression;
+    /** The literal tag, or null when the decorator argument is not a string literal. */
+    tag: string | null;
+    exported: boolean;
+    inDemoFile: boolean;
+}
+/** A class member decorated with `@property(…)` or `@state(…)`. */
+export interface IStandardProperty {
+    file: string;
+    sourceFile: ast.TSourceFile;
+    classNode: ast.TClassDeclaration;
+    member: ast.TClassElement;
+    name: string;
+    decorator: 'property' | 'state';
+    call: ast.TCallExpression;
+    /** The options object literal; null when the decorator has no argument or a non-literal one. */
+    options: ast.TObjectLiteralExpression | null;
+    /** True when the decorator has an argument that is not an object literal. */
+    dynamicOptions: boolean;
+    isPublic: boolean;
+    inDemoFile: boolean;
+}
+/** An `export … from '<relative>'` declaration. */
+export interface IStandardReexport {
+    file: string;
+    statement: plugins.typescript.ExportDeclaration;
+    specifier: string;
+    /** The resolved repository path, or null when it does not resolve to a known file. */
+    target: string | null;
+}
+export type TParseCache = Map<string, {
+    text: string;
+    sourceFile: ast.TSourceFile;
+}>;
+/** The root barrel every reachability check starts from. */
+export declare const rootBarrel = "ts_web/index.ts";
+export declare const elementsBarrel = "ts_web/elements/index.ts";
+/**
+ * The syntax-only model of a catalog the rules read: its files, elements, reactive properties and
+ * barrel graph. Built from a map of repository paths to file texts, so the same model serves a
+ * repository on disk and the fixer's in-memory tree.
+ */
+export declare class StandardProject {
+    readonly files: ReadonlyMap<string, string>;
+    private readonly existsOnDisk;
+    private readonly parseCache;
+    private elementsCache;
+    private propertiesCache;
+    private reexportsCache;
+    constructor(filesArg: ReadonlyMap<string, string>, existsOnDiskArg: (fileArg: string) => boolean, parseCacheArg?: TParseCache);
+    /** True when the file is part of the model or exists in the repository. */
+    exists(fileArg: string): boolean;
+    /** The `ts_web/**\/*.ts` sources, sorted. */
+    get webFiles(): string[];
+    sourceFile(fileArg: string): ast.TSourceFile;
+    /** `compilerOptions.experimentalDecorators` of tsconfig.json (its `extends` chain is not followed). */
+    get experimentalDecorators(): boolean;
+    get elements(): IStandardElement[];
+    get properties(): IStandardProperty[];
+    /** The `export … from` declarations of a file with relative specifiers. */
+    reexports(fileArg: string): IStandardReexport[];
+    /** Every file reached from a barrel by following `export … from` declarations. */
+    reachableFrom(fileArg: string): Set<string>;
+    lineAndColumn(fileArg: string, positionArg: number): {
+        line: number;
+        column: number;
+    };
+}
+/** The files besides `ts_web/**` a check reads. */
+export declare const standardSideFiles: string[];
+/** Reads the files the standard covers from a repository on disk. */
+export declare const loadStandardProject: (rootDirArg: string) => Promise<StandardProject>;

package/dist_ts/standards/classes.standardproject.js

@@ -0,0 +1,195 @@
+import * as plugins from '../plugins.js';
+import * as ast from './helpers.ast.js';
+import { isDemoFile, isTypeScriptSource, resolveSpecifier, toPosix } from './helpers.paths.js';
+const ts = plugins.typescript;
+/** The root barrel every reachability check starts from. */
+export const rootBarrel = 'ts_web/index.ts';
+export const elementsBarrel = 'ts_web/elements/index.ts';
+/**
+ * The syntax-only model of a catalog the rules read: its files, elements, reactive properties and
+ * barrel graph. Built from a map of repository paths to file texts, so the same model serves a
+ * repository on disk and the fixer's in-memory tree.
+ */
+export class StandardProject {
+    files;
+    existsOnDisk;
+    parseCache;
+    elementsCache = null;
+    propertiesCache = null;
+    reexportsCache = new Map();
+    constructor(filesArg, existsOnDiskArg, parseCacheArg = new Map()) {
+        this.files = filesArg;
+        this.existsOnDisk = existsOnDiskArg;
+        this.parseCache = parseCacheArg;
+    }
+    /** True when the file is part of the model or exists in the repository. */
+    exists(fileArg) {
+        return this.files.has(fileArg) || this.existsOnDisk(fileArg);
+    }
+    /** The `ts_web/**\/*.ts` sources, sorted. */
+    get webFiles() {
+        return [...this.files.keys()].filter((fileArg) => fileArg.startsWith('ts_web/') && fileArg.endsWith('.ts') && isTypeScriptSource(fileArg)).sort();
+    }
+    sourceFile(fileArg) {
+        const text = this.files.get(fileArg);
+        if (text === undefined) {
+            throw new Error(`Not a known file: ${fileArg}`);
+        }
+        const cached = this.parseCache.get(fileArg);
+        if (cached && cached.text === text) {
+            return cached.sourceFile;
+        }
+        const sourceFile = ast.parseSource(fileArg, text);
+        this.parseCache.set(fileArg, { text, sourceFile });
+        return sourceFile;
+    }
+    /** `compilerOptions.experimentalDecorators` of tsconfig.json (its `extends` chain is not followed). */
+    get experimentalDecorators() {
+        const text = this.files.get('tsconfig.json');
+        if (!text) {
+            return false;
+        }
+        const parsed = ts.parseConfigFileTextToJson('tsconfig.json', text);
+        return parsed.config?.compilerOptions?.experimentalDecorators === true;
+    }
+    get elements() {
+        if (!this.elementsCache) {
+            this.elementsCache = [];
+            for (const file of this.webFiles) {
+                const sourceFile = this.sourceFile(file);
+                const visit = (nodeArg) => {
+                    if (ts.isClassDeclaration(nodeArg)) {
+                        const decorator = ast.findDecoratorCall(nodeArg, ['customElement']);
+                        if (decorator) {
+                            const tagArgument = decorator.call.arguments[0];
+                            this.elementsCache.push({
+                                file,
+                                sourceFile,
+                                classNode: nodeArg,
+                                className: nodeArg.name?.text ?? null,
+                                decoratorCall: decorator.call,
+                                tag: decorator.call.arguments.length === 1 && ast.isStringLiteralLike(tagArgument) ? tagArgument.text : null,
+                                exported: ast.hasModifier(nodeArg, ts.SyntaxKind.ExportKeyword),
+                                inDemoFile: isDemoFile(file),
+                            });
+                        }
+                    }
+                    ts.forEachChild(nodeArg, visit);
+                };
+                visit(sourceFile);
+            }
+        }
+        return this.elementsCache;
+    }
+    get properties() {
+        if (!this.propertiesCache) {
+            this.propertiesCache = [];
+            for (const file of this.webFiles) {
+                const sourceFile = this.sourceFile(file);
+                const visit = (nodeArg) => {
+                    if (ts.isClassDeclaration(nodeArg) || ts.isClassExpression(nodeArg)) {
+                        for (const member of nodeArg.members) {
+                            const decorator = ast.findDecoratorCall(member, ['property', 'state']);
+                            const name = ast.memberNameText(member);
+                            if (!decorator || name === null) {
+                                continue;
+                            }
+                            const firstArgument = decorator.call.arguments[0];
+                            const isPrivateName = !!member.name && ts.isPrivateIdentifier(member.name);
+                            this.propertiesCache.push({
+                                file,
+                                sourceFile,
+                                classNode: nodeArg,
+                                member,
+                                name: isPrivateName && !name.startsWith('#') ? `#${name}` : name,
+                                decorator: decorator.name,
+                                call: decorator.call,
+                                options: firstArgument && ts.isObjectLiteralExpression(firstArgument) ? firstArgument : null,
+                                dynamicOptions: !!firstArgument && !ts.isObjectLiteralExpression(firstArgument),
+                                isPublic: !isPrivateName
+                                    && !ast.hasModifier(member, ts.SyntaxKind.PrivateKeyword)
+                                    && !ast.hasModifier(member, ts.SyntaxKind.ProtectedKeyword),
+                                inDemoFile: isDemoFile(file),
+                            });
+                        }
+                    }
+                    ts.forEachChild(nodeArg, visit);
+                };
+                visit(sourceFile);
+            }
+        }
+        return this.propertiesCache;
+    }
+    /** The `export … from` declarations of a file with relative specifiers. */
+    reexports(fileArg) {
+        let reexports = this.reexportsCache.get(fileArg);
+        if (!reexports) {
+            reexports = [];
+            if (this.files.has(fileArg)) {
+                for (const statement of this.sourceFile(fileArg).statements) {
+                    if (ts.isExportDeclaration(statement) && statement.moduleSpecifier && ast.isStringLiteralLike(statement.moduleSpecifier)) {
+                        const specifier = statement.moduleSpecifier.text;
+                        if (!specifier.startsWith('.')) {
+                            continue;
+                        }
+                        const resolved = resolveSpecifier(fileArg, specifier, (candidateArg) => this.files.has(candidateArg));
+                        reexports.push({ file: fileArg, statement, specifier, target: resolved?.target ?? null });
+                    }
+                }
+            }
+            this.reexportsCache.set(fileArg, reexports);
+        }
+        return reexports;
+    }
+    /** Every file reached from a barrel by following `export … from` declarations. */
+    reachableFrom(fileArg) {
+        const reached = new Set();
+        const queue = this.files.has(fileArg) ? [fileArg] : [];
+        while (queue.length > 0) {
+            const file = queue.shift();
+            if (reached.has(file)) {
+                continue;
+            }
+            reached.add(file);
+            for (const reexport of this.reexports(file)) {
+                if (reexport.target && !reached.has(reexport.target)) {
+                    queue.push(reexport.target);
+                }
+            }
+        }
+        return reached;
+    }
+    lineAndColumn(fileArg, positionArg) {
+        return ast.lineAndColumn(this.sourceFile(fileArg), positionArg);
+    }
+}
+/** The files besides `ts_web/**` a check reads. */
+export const standardSideFiles = ['html/index.ts', 'html/index.html', 'tsconfig.json', 'readme.md'];
+/** Reads the files the standard covers from a repository on disk. */
+export const loadStandardProject = async (rootDirArg) => {
+    const files = new Map();
+    const webDir = plugins.path.join(rootDirArg, 'ts_web');
+    if (plugins.fsSync.existsSync(webDir)) {
+        const entries = await plugins.fs.readdir(webDir, { recursive: true, withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const relative = toPosix(plugins.path.relative(rootDirArg, plugins.path.join(entry.parentPath, entry.name)));
+            if (relative.split('/').some((segmentArg) => segmentArg === 'node_modules')) {
+                continue;
+            }
+            if (relative.endsWith('.ts') && isTypeScriptSource(relative)) {
+                files.set(relative, await plugins.fs.readFile(plugins.path.join(rootDirArg, relative), 'utf8'));
+            }
+        }
+    }
+    for (const sideFile of standardSideFiles) {
+        const absolute = plugins.path.join(rootDirArg, sideFile);
+        if (plugins.fsSync.existsSync(absolute)) {
+            files.set(sideFile, await plugins.fs.readFile(absolute, 'utf8'));
+        }
+    }
+    return new StandardProject(files, (fileArg) => plugins.fsSync.existsSync(plugins.path.join(rootDirArg, fileArg)));
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zdGFuZGFyZHByb2plY3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9zdGFuZGFyZHMvY2xhc3Nlcy5zdGFuZGFyZHByb2plY3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLEdBQUcsTUFBTSxrQkFBa0IsQ0FBQztBQUN4QyxPQUFPLEVBQUUsVUFBVSxFQUFFLGtCQUFrQixFQUFFLGdCQUFnQixFQUFFLE9BQU8sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRS9GLE1BQU0sRUFBRSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUM7QUEyQzlCLDREQUE0RDtBQUM1RCxNQUFNLENBQUMsTUFBTSxVQUFVLEdBQUcsaUJBQWlCLENBQUM7QUFDNUMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLDBCQUEwQixDQUFDO0FBRXpEOzs7O0dBSUc7QUFDSCxNQUFNLE9BQU8sZUFBZTtJQUNWLEtBQUssQ0FBOEI7SUFDbEMsWUFBWSxDQUErQjtJQUMzQyxVQUFVLENBQWM7SUFDakMsYUFBYSxHQUE4QixJQUFJLENBQUM7SUFDaEQsZUFBZSxHQUErQixJQUFJLENBQUM7SUFDbkQsY0FBYyxHQUFHLElBQUksR0FBRyxFQUErQixDQUFDO0lBRWhFLFlBQVksUUFBcUMsRUFBRSxlQUE2QyxFQUFFLGdCQUE2QixJQUFJLEdBQUcsRUFBRTtRQUN0SSxJQUFJLENBQUMsS0FBSyxHQUFHLFFBQVEsQ0FBQztRQUN0QixJQUFJLENBQUMsWUFBWSxHQUFHLGVBQWUsQ0FBQztRQUNwQyxJQUFJLENBQUMsVUFBVSxHQUFHLGFBQWEsQ0FBQztJQUNsQyxDQUFDO0lBRUQsMkVBQTJFO0lBQ3BFLE1BQU0sQ0FBQyxPQUFlO1FBQzNCLE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksSUFBSSxDQUFDLFlBQVksQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUMvRCxDQUFDO0lBRUQsNkNBQTZDO0lBQzdDLElBQVcsUUFBUTtRQUNqQixPQUFPLENBQUMsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLFNBQVMsQ0FBQyxJQUFJLE9BQU8sQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLElBQUksa0JBQWtCLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNwSixDQUFDO0lBRU0sVUFBVSxDQUFDLE9BQWU7UUFDL0IsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDckMsSUFBSSxJQUFJLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDdkIsTUFBTSxJQUFJLEtBQUssQ0FBQyxxQkFBcUIsT0FBTyxFQUFFLENBQUMsQ0FBQztRQUNsRCxDQUFDO1FBQ0QsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDNUMsSUFBSSxNQUFNLElBQUksTUFBTSxDQUFDLElBQUksS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUNuQyxPQUFPLE1BQU0sQ0FBQyxVQUFVLENBQUM7UUFDM0IsQ0FBQztRQUNELE1BQU0sVUFBVSxHQUFHLEdBQUcsQ0FBQyxXQUFXLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ2xELElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsQ0FBQyxDQUFDO1FBQ25ELE9BQU8sVUFBVSxDQUFDO0lBQ3BCLENBQUM7SUFFRCx1R0FBdUc7SUFDdkcsSUFBVyxzQkFBc0I7UUFDL0IsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsZUFBZSxDQUFDLENBQUM7UUFDN0MsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ1YsT0FBTyxLQUFLLENBQUM7UUFDZixDQUFDO1FBQ0QsTUFBTSxNQUFNLEdBQUcsRUFBRSxDQUFDLHlCQUF5QixDQUFDLGVBQWUsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUNuRSxPQUFPLE1BQU0sQ0FBQyxNQUFNLEVBQUUsZUFBZSxFQUFFLHNCQUFzQixLQUFLLElBQUksQ0FBQztJQUN6RSxDQUFDO0lBRUQsSUFBVyxRQUFRO1FBQ2pCLElBQUksQ0FBQyxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7WUFDeEIsSUFBSSxDQUFDLGFBQWEsR0FBRyxFQUFFLENBQUM7WUFDeEIsS0FBSyxNQUFNLElBQUksSUFBSSxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7Z0JBQ2pDLE1BQU0sVUFBVSxHQUFHLElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLENBQUM7Z0JBQ3pDLE1BQU0sS0FBSyxHQUFHLENBQUMsT0FBa0IsRUFBUSxFQUFFO29CQUN6QyxJQUFJLEVBQUUsQ0FBQyxrQkFBa0IsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO3dCQUNuQyxNQUFNLFNBQVMsR0FBRyxHQUFHLENBQUMsaUJBQWlCLENBQUMsT0FBTyxFQUFFLENBQUMsZUFBZSxDQUFDLENBQUMsQ0FBQzt3QkFDcEUsSUFBSSxTQUFTLEVBQUUsQ0FBQzs0QkFDZCxNQUFNLFdBQVcsR0FBRyxTQUFTLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQzs0QkFDaEQsSUFBSSxDQUFDLGFBQWMsQ0FBQyxJQUFJLENBQUM7Z0NBQ3ZCLElBQUk7Z0NBQ0osVUFBVTtnQ0FDVixTQUFTLEVBQUUsT0FBTztnQ0FDbEIsU0FBUyxFQUFFLE9BQU8sQ0FBQyxJQUFJLEVBQUUsSUFBSSxJQUFJLElBQUk7Z0NBQ3JDLGFBQWEsRUFBRSxTQUFTLENBQUMsSUFBSTtnQ0FDN0IsR0FBRyxFQUFFLFNBQVMsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksR0FBRyxDQUFDLG1CQUFtQixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJO2dDQUM1RyxRQUFRLEVBQUUsR0FBRyxDQUFDLFdBQVcsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxhQUFhLENBQUM7Z0NBQy9ELFVBQVUsRUFBRSxVQUFVLENBQUMsSUFBSSxDQUFDOzZCQUM3QixDQUFDLENBQUM7d0JBQ0wsQ0FBQztvQkFDSCxDQUFDO29CQUNELEVBQUUsQ0FBQyxZQUFZLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO2dCQUNsQyxDQUFDLENBQUM7Z0JBQ0YsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1lBQ3BCLENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsYUFBYSxDQUFDO0lBQzVCLENBQUM7SUFFRCxJQUFXLFVBQVU7UUFDbkIsSUFBSSxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsQ0FBQztZQUMxQixJQUFJLENBQUMsZUFBZSxHQUFHLEVBQUUsQ0FBQztZQUMxQixLQUFLLE1BQU0sSUFBSSxJQUFJLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztnQkFDakMsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztnQkFDekMsTUFBTSxLQUFLLEdBQUcsQ0FBQyxPQUFrQixFQUFRLEVBQUU7b0JBQ3pDLElBQUksRUFBRSxDQUFDLGtCQUFrQixDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQyxpQkFBaUIsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO3dCQUNwRSxLQUFLLE1BQU0sTUFBTSxJQUFJLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQzs0QkFDckMsTUFBTSxTQUFTLEdBQUcsR0FBRyxDQUFDLGlCQUFpQixDQUFDLE1BQU0sRUFBRSxDQUFDLFVBQVUsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDOzRCQUN2RSxNQUFNLElBQUksR0FBRyxHQUFHLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDOzRCQUN4QyxJQUFJLENBQUMsU0FBUyxJQUFJLElBQUksS0FBSyxJQUFJLEVBQUUsQ0FBQztnQ0FDaEMsU0FBUzs0QkFDWCxDQUFDOzRCQUNELE1BQU0sYUFBYSxHQUFHLFNBQVMsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxDQUFDOzRCQUNsRCxNQUFNLGFBQWEsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFDLElBQUksSUFBSSxFQUFFLENBQUMsbUJBQW1CLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDOzRCQUMzRSxJQUFJLENBQUMsZUFBZ0IsQ0FBQyxJQUFJLENBQUM7Z0NBQ3pCLElBQUk7Z0NBQ0osVUFBVTtnQ0FDVixTQUFTLEVBQUUsT0FBZ0M7Z0NBQzNDLE1BQU07Z0NBQ04sSUFBSSxFQUFFLGFBQWEsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUk7Z0NBQ2hFLFNBQVMsRUFBRSxTQUFTLENBQUMsSUFBNEI7Z0NBQ2pELElBQUksRUFBRSxTQUFTLENBQUMsSUFBSTtnQ0FDcEIsT0FBTyxFQUFFLGFBQWEsSUFBSSxFQUFFLENBQUMseUJBQXlCLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsSUFBSTtnQ0FDNUYsY0FBYyxFQUFFLENBQUMsQ0FBQyxhQUFhLElBQUksQ0FBQyxFQUFFLENBQUMseUJBQXlCLENBQUMsYUFBYSxDQUFDO2dDQUMvRSxRQUFRLEVBQUUsQ0FBQyxhQUFhO3VDQUNuQixDQUFDLEdBQUcsQ0FBQyxXQUFXLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsY0FBYyxDQUFDO3VDQUN0RCxDQUFDLEdBQUcsQ0FBQyxXQUFXLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsZ0JBQWdCLENBQUM7Z0NBQzdELFVBQVUsRUFBRSxVQUFVLENBQUMsSUFBSSxDQUFDOzZCQUM3QixDQUFDLENBQUM7d0JBQ0wsQ0FBQztvQkFDSCxDQUFDO29CQUNELEVBQUUsQ0FBQyxZQUFZLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO2dCQUNsQyxDQUFDLENBQUM7Z0JBQ0YsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1lBQ3BCLENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsZUFBZSxDQUFDO0lBQzlCLENBQUM7SUFFRCwyRUFBMkU7SUFDcEUsU0FBUyxDQUFDLE9BQWU7UUFDOUIsSUFBSSxTQUFTLEdBQUcsSUFBSSxDQUFDLGNBQWMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDakQsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ2YsU0FBUyxHQUFHLEVBQUUsQ0FBQztZQUNmLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztnQkFDNUIsS0FBSyxNQUFNLFNBQVMsSUFBSSxJQUFJLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDO29CQUM1RCxJQUFJLEVBQUUsQ0FBQyxtQkFBbUIsQ0FBQyxTQUFTLENBQUMsSUFBSSxTQUFTLENBQUMsZUFBZSxJQUFJLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBQyxTQUFTLENBQUMsZUFBZSxDQUFDLEVBQUUsQ0FBQzt3QkFDekgsTUFBTSxTQUFTLEdBQUcsU0FBUyxDQUFDLGVBQWUsQ0FBQyxJQUFJLENBQUM7d0JBQ2pELElBQUksQ0FBQyxTQUFTLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7NEJBQy9CLFNBQVM7d0JBQ1gsQ0FBQzt3QkFDRCxNQUFNLFFBQVEsR0FBRyxnQkFBZ0IsQ0FBQyxPQUFPLEVBQUUsU0FBUyxFQUFFLENBQUMsWUFBWSxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQyxDQUFDO3dCQUN0RyxTQUFTLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxTQUFTLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsTUFBTSxJQUFJLElBQUksRUFBRSxDQUFDLENBQUM7b0JBQzVGLENBQUM7Z0JBQ0gsQ0FBQztZQUNILENBQUM7WUFDRCxJQUFJLENBQUMsY0FBYyxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsU0FBUyxDQUFDLENBQUM7UUFDOUMsQ0FBQztRQUNELE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFFRCxrRkFBa0Y7SUFDM0UsYUFBYSxDQUFDLE9BQWU7UUFDbEMsTUFBTSxPQUFPLEdBQUcsSUFBSSxHQUFHLEVBQVUsQ0FBQztRQUNsQyxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3ZELE9BQU8sS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUN4QixNQUFNLElBQUksR0FBRyxLQUFLLENBQUMsS0FBSyxFQUFHLENBQUM7WUFDNUIsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7Z0JBQ3RCLFNBQVM7WUFDWCxDQUFDO1lBQ0QsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUNsQixLQUFLLE1BQU0sUUFBUSxJQUFJLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDNUMsSUFBSSxRQUFRLENBQUMsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztvQkFDckQsS0FBSyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUM7Z0JBQzlCLENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sT0FBTyxDQUFDO0lBQ2pCLENBQUM7SUFFTSxhQUFhLENBQUMsT0FBZSxFQUFFLFdBQW1CO1FBQ3ZELE9BQU8sR0FBRyxDQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxFQUFFLFdBQVcsQ0FBQyxDQUFDO0lBQ2xFLENBQUM7Q0FDRjtBQUVELG1EQUFtRDtBQUNuRCxNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxDQUFDLGVBQWUsRUFBRSxpQkFBaUIsRUFBRSxlQUFlLEVBQUUsV0FBVyxDQUFDLENBQUM7QUFFcEcscUVBQXFFO0FBQ3JFLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLEtBQUssRUFBRSxVQUFrQixFQUE0QixFQUFFO0lBQ3hGLE1BQU0sS0FBSyxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBQ3hDLE1BQU0sTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRSxRQUFRLENBQUMsQ0FBQztJQUN2RCxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDdEMsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsRUFBRSxTQUFTLEVBQUUsSUFBSSxFQUFFLGFBQWEsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQzNGLEtBQUssTUFBTSxLQUFLLElBQUksT0FBTyxFQUFFLENBQUM7WUFDNUIsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDO2dCQUNwQixTQUFTO1lBQ1gsQ0FBQztZQUNELE1BQU0sUUFBUSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxVQUFVLEVBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFVBQVUsRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQzdHLElBQUksUUFBUSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsS0FBSyxjQUFjLENBQUMsRUFBRSxDQUFDO2dCQUM1RSxTQUFTO1lBQ1gsQ0FBQztZQUNELElBQUksUUFBUSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsSUFBSSxrQkFBa0IsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO2dCQUM3RCxLQUFLLENBQUMsR0FBRyxDQUFDLFFBQVEsRUFBRSxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRSxRQUFRLENBQUMsRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDO1lBQ2xHLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUNELEtBQUssTUFBTSxRQUFRLElBQUksaUJBQWlCLEVBQUUsQ0FBQztRQUN6QyxNQUFNLFFBQVEsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsUUFBUSxDQUFDLENBQUM7UUFDekQsSUFBSSxPQUFPLENBQUMsTUFBTSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1lBQ3hDLEtBQUssQ0FBQyxHQUFHLENBQUMsUUFBUSxFQUFFLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUM7UUFDbkUsQ0FBQztJQUNILENBQUM7SUFDRCxPQUFPLElBQUksZUFBZSxDQUFDLEtBQUssRUFBRSxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNwSCxDQUFDLENBQUMifQ==

package/dist_ts/standards/classes.standardtree.d.ts

@@ -0,0 +1,56 @@
+import * as plugins from '../plugins.js';
+import * as ast from './helpers.ast.js';
+import { StandardProject } from './classes.standardproject.js';
+import type { IFixBuilder } from './rule.js';
+/** The changes one rule run collected. */
+export declare class FixBatch implements IFixBuilder {
+    readonly edits: Map<string, ast.ITextEdit[]>;
+    readonly creates: Map<string, string>;
+    readonly moves: Map<string, string>;
+    readonly redirects: Map<string, string>;
+    edit(fileArg: string, startArg: number, endArg: number, textArg: string): void;
+    create(fileArg: string, textArg: string): void;
+    move(fromArg: string, toArg: string): void;
+    redirectBarrelExports(targetArg: string, barrelTargetArg: string): void;
+}
+/**
+ * The fixer's in-memory copy of a repository: the tracked TypeScript sources and the side files the
+ * standard reads, with the moves and edits applied so far. Nothing touches the disk until the
+ * fixer commits the tree. Every path a batch names must be a repository path (see isRepoPath);
+ * a batch with any other path is rejected before it changes the tree.
+ */
+export declare class StandardTree {
+    readonly files: Map<string, string>;
+    private readonly originalTexts;
+    /** Current path → original path, for moved files. */
+    private readonly originOf;
+    /** Original paths that were moved away. */
+    private readonly vacated;
+    readonly created: Set<string>;
+    /** Current path → ids of the rules that changed the file. */
+    private readonly changedBy;
+    private readonly parseCache;
+    /** Every tracked file of the repository, including those the tree holds no text for (`.json`, `.css`, `.d.ts`, …). */
+    private readonly trackedFiles;
+    private readonly existsOnDisk;
+    constructor(filesArg: Map<string, string>, trackedFilesArg: Iterable<string>, existsOnDiskArg: (fileArg: string) => boolean);
+    exists(fileArg: string): boolean;
+    /** The model of the tree's current state. */
+    project(): StandardProject;
+    private markChanged;
+    /**
+     * Applies a batch: edits, then new files, then moves with import rewriting. Returns the number of
+     * applied changes. Throws without changing the tree when the batch names a path that is not a
+     * repository path.
+     */
+    apply(ruleIdArg: string, batchArg: FixBatch): number;
+    /**
+     * Rewrites every relative module specifier whose importing file or target moves, keeping its
+     * extension style. A specifier resolves to any tracked file (sources, `.d.ts`, `.json`, `.css`, …),
+     * so a moved file's imports of files that stay keep pointing at them. Barrel re-exports of a
+     * redirected target point at the redirect instead.
+     */
+    private rewriteSpecifiers;
+    /** The tree's changes against the repository it was read from. */
+    plan(): plugins.interfaces.IStandardFixPlan;
+}