@terra-symposium/standards-quality 0.0.0-stage → 0.5.0

package/dist/history-report.js

@@ -0,0 +1,317 @@
+import { execFileSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/*//////////////////////////////////////////////////
+REGEX
+//////////////////////////////////////////////////*/
+const S_REGEX = /\s+/;
+const GIT_I_REGEX = /\.git$/i;
+const A_F_D_40_I_REGEX = /^[a-f\d]{40}$/i;
+const SRC_EXT = /\.(?:astro|c|cc|cpp|cs|css|go|html|java|js|jsx|jsonl|kt|less|m|mdx|php|py|rb|rs|scss|sh|sql|svelte|swift|ts|tsx|vue)$/i;
+const EXCLUDED_DIR = /^(?:\.git|\.github|\.next|\.nuxt|\.output|\.turbo|\.vercel|\.netlify|\.astro|\.cache|build|coverage|dist|docs?|documentation|generated|vendor|node_modules|bower_components|target|out|public|static|storybook-static|test-results)$/i;
+const EXCLUDED_FILE = /^(?:package(?:-lock)?\.json|pnpm-lock\.yaml|yarn\.lock|tsconfig(?:\.[^.]+)?\.json|(?:astro|eslint|prettier|vite|vitest|webpack|rollup|tailwind|postcss|jest|playwright|babel|next|netlify)\.config\.[^.]+|Dockerfile|Makefile)$/i;
+const HISTORY_BATCH_SIZE = 50;
+const BLOB_BATCH_SIZE = 250;
+const GIT_OUTPUT_LIMIT = 128 * 1024 * 1024;
+/**
+ * Return whether a tracked path belongs to the dashboard's source and test scope.
+ *
+ * @param path Repository-relative tracked file path.
+ * @return Whether the path contributes to history metrics.
+ */
+export function isHistorySourcePath(path) {
+    const parts = path.split('/');
+    if (!parts.length || parts.some((part) => part === '..' || part === ''))
+        return false;
+    if (parts.slice(0, -1).some((part) => EXCLUDED_DIR.test(part)))
+        return false;
+    const file = parts.at(-1) ?? '';
+    return SRC_EXT.test(file) && !EXCLUDED_FILE.test(file) && !/\.(?:config|generated|gen|min|map|snap|lock)\.[^.]+$/i.test(file) && !/^\./.test(file);
+}
+/**
+ * Run Git in the selected checkout and return UTF-8 output.
+ *
+ * @param root Git checkout path.
+ * @param args Git command arguments.
+ * @param input Optional standard input for the command.
+ * @return The command's UTF-8 output.
+ */
+function git(root, args, input) {
+    return execFileSync('git', args, { cwd: root, encoding: 'utf8', input, maxBuffer: GIT_OUTPUT_LIMIT, stdio: ['pipe', 'pipe', 'pipe'] });
+}
+/**
+ * Run Git in the selected checkout and preserve binary object output.
+ *
+ * @param root Git checkout path.
+ * @param args Git command arguments.
+ * @param input Standard input for the command.
+ * @return The command's binary output.
+ */
+function gitBuffer(root, args, input) {
+    return execFileSync('git', args, { cwd: root, input, maxBuffer: GIT_OUTPUT_LIMIT, stdio: ['pipe', 'pipe', 'pipe'] });
+}
+/**
+ * Resolve the GitHub repository name from Actions metadata or the origin remote.
+ *
+ * @param root Git checkout path.
+ * @return The owner/repository name.
+ */
+function repoName(root) {
+    const fromEnvironment = process.env.GITHUB_REPOSITORY;
+    if (fromEnvironment && /^[^/]+\/[^/]+$/.test(fromEnvironment))
+        return fromEnvironment.replace(GIT_I_REGEX, '');
+    const remote = git(root, ['config', '--get', 'remote.origin.url']).trim();
+    const match = remote.match(/(?:github\.com[:/])([^/]+\/[^/]+?)(?:\.git)?$/i);
+    if (!match)
+        throw new Error('Set GITHUB_REPOSITORY or use a GitHub origin remote to generate a history report.');
+    return match[1].replace(GIT_I_REGEX, '');
+}
+/**
+ * Read the before SHA from a GitHub push event when it is available.
+ *
+ * @return The push base SHA, or null when no usable base is present.
+ */
+function pushBase() {
+    const ePath = process.env.GITHUB_EVENT_PATH;
+    if (!ePath)
+        return null;
+    try {
+        const e = JSON.parse(readFileSync(ePath, 'utf8'));
+        return typeof e.before === 'string' && A_F_D_40_I_REGEX.test(e.before) && !/^0{40}$/.test(e.before) ? e.before : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Calculate source-line additions and deletions against a commit's first parent.
+ *
+ * @param root Git checkout path.
+ * @param head Commit whose source changes are measured.
+ * @param parents Commit parent SHAs.
+ * @param stats Per-commit source line totals to update.
+ */
+function srcChanges(root, head, parents, stats) {
+    if (!parents.length)
+        return;
+    const output = git(root, ['diff', '--numstat', '--no-renames', '--no-ext-diff', parents[0], head, '--']);
+    for (const line of output.split('\n')) {
+        if (!line)
+            continue;
+        const firstTab = line.indexOf('\t');
+        const secondTab = line.indexOf('\t', firstTab + 1);
+        if (firstTab < 0 || secondTab < 0)
+            continue;
+        const path = line.slice(secondTab + 1);
+        if (!isHistorySourcePath(path))
+            continue;
+        const additions = line.slice(0, firstTab) === '-' ? 0 : Number(line.slice(0, firstTab));
+        const deletions = line.slice(firstTab + 1, secondTab) === '-' ? 0 : Number(line.slice(firstTab + 1, secondTab));
+        const curr = stats.get(head) ?? { additions: 0, deletions: 0 };
+        curr.additions += additions;
+        curr.deletions += deletions;
+        stats.set(head, curr);
+    }
+}
+/**
+ * Read source-line stats for each commit and return merge commits for first-parent handling.
+ *
+ * @param root Git checkout path.
+ * @param range Git revision range to inspect.
+ * @param stats Per-commit source line totals to update.
+ * @return Merge commit SHAs requiring first-parent stats.
+ */
+function readNumstatLog(root, range, stats) {
+    const output = git(root, ['log', '-z', '--format=%x1e%H%x00%P%x00', '--numstat', '--no-renames', '--root', '--reverse', '--topo-order', range]);
+    const merges = new Set();
+    for (const block of output.split('\x1e')) {
+        if (!block)
+            continue;
+        const headerEnd = block.indexOf('\n');
+        const header = headerEnd < 0 ? block : block.slice(0, headerEnd);
+        const [sha, parents = ''] = header.replace(/^\n/, '').split('\x00');
+        if (!A_F_D_40_I_REGEX.test(sha))
+            continue;
+        const parentList = parents.trim().split(S_REGEX).filter(Boolean);
+        if (parentList.length > 1) {
+            merges.add(sha);
+            continue;
+        }
+        const curr = { additions: 0, deletions: 0 };
+        const body = headerEnd < 0 ? '' : block.slice(headerEnd + 1);
+        for (const entry of body.split('\x00')) {
+            const firstTab = entry.indexOf('\t');
+            const secondTab = entry.indexOf('\t', firstTab + 1);
+            if (firstTab < 0 || secondTab < 0 || !isHistorySourcePath(entry.slice(secondTab + 1)))
+                continue;
+            const added = entry.slice(0, firstTab);
+            const removed = entry.slice(firstTab + 1, secondTab);
+            curr.additions += added === '-' ? 0 : Number(added);
+            curr.deletions += removed === '-' ? 0 : Number(removed);
+        }
+        stats.set(sha, curr);
+    }
+    return merges;
+}
+/**
+ * Return eligible source blob IDs from a commit's tree.
+ *
+ * @param root Git checkout path.
+ * @param sha Commit SHA to inspect.
+ * @return Eligible blob IDs in the commit tree.
+ */
+function parseTree(root, sha) {
+    const tree = git(root, ['ls-tree', '-r', '-z', '--full-tree', sha]);
+    const blobs = [];
+    for (const entry of tree.split('\0')) {
+        const tab = entry.indexOf('\t');
+        if (tab < 0)
+            continue;
+        const [mode, type, blob] = entry.slice(0, tab).split(' ');
+        const path = entry.slice(tab + 1);
+        if (type === 'blob' && mode !== '120000' && isHistorySourcePath(path))
+            blobs.push(blob);
+    }
+    return blobs;
+}
+/**
+ * Count newline-terminated and final unterminated source lines.
+ *
+ * @param content Source blob bytes.
+ * @return The number of source lines.
+ */
+function lineCount(content) {
+    if (!content.length)
+        return 0;
+    let lines = 0;
+    for (const byte of content)
+        if (byte === 10)
+            lines++;
+    return content.at(-1) === 10 ? lines : lines + 1;
+}
+/**
+ * Read blob contents in bounded batches and cache their line counts by object ID.
+ *
+ * @param root Git checkout path.
+ * @param blobs Blob object IDs to count.
+ * @param cache Blob line counts already computed.
+ */
+function blobLineCounts(root, blobs, cache) {
+    const unknown = [...new Set(blobs)].filter((sha) => !cache.has(sha));
+    for (let start = 0; start < unknown.length; start += BLOB_BATCH_SIZE) {
+        const batch = unknown.slice(start, start + BLOB_BATCH_SIZE);
+        const output = gitBuffer(root, ['cat-file', '--batch'], `${batch.join('\n')}\n`);
+        let offset = 0;
+        for (const sha of batch) {
+            const headerEnd = output.indexOf(10, offset);
+            if (headerEnd < 0)
+                throw new Error(`Git did not return blob ${sha}.`);
+            const header = output.toString('utf8', offset, headerEnd).split(' ');
+            if (header[0] !== sha || header[1] !== 'blob')
+                throw new Error(`Git returned an invalid object for ${sha}.`);
+            const size = Number(header[2]);
+            const contentStart = headerEnd + 1;
+            const contentEnd = contentStart + size;
+            cache.set(sha, lineCount(output.subarray(contentStart, contentEnd)));
+            offset = contentEnd + 1;
+        }
+    }
+}
+/**
+ * Read author dates and parent IDs for commits in chronological topological order.
+ *
+ * @param root Git checkout path.
+ * @param range Git revision range to inspect.
+ * @return Commit SHAs, author dates, and parent SHAs.
+ */
+function commitMetadata(root, range) {
+    return git(root, ['log', '--format=%H%x00%aI%x00%P', '--reverse', '--topo-order', range])
+        .trim()
+        .split('\n')
+        .filter(Boolean)
+        .map((line) => {
+        const [sha, authorDate, parents = ''] = line.split('\x00');
+        if (!A_F_D_40_I_REGEX.test(sha) || !Number.isFinite(Date.parse(authorDate)))
+            throw new Error('Git returned invalid commit metadata.');
+        return { sha, authorDate, parents: parents.trim().split(S_REGEX).filter(Boolean) };
+    });
+}
+/**
+ * Check whether a push base is reachable from the checked-out head.
+ *
+ * @param root Git checkout path.
+ * @param base Push base SHA.
+ * @param head Checked-out head SHA.
+ * @return Whether base is an ancestor of head.
+ */
+function isAncestor(root, base, head) {
+    try {
+        execFileSync('git', ['merge-base', '--is-ancestor', base, head], { cwd: root, stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build a complete snapshot or push delta from the local Git object database.
+ *
+ * @param root Path to the full Git checkout.
+ * @param opts Optional repository, branch, or push-base overrides.
+ * @return A versioned history report with normalized commit counts.
+ */
+export function createHistoryReport(root, opts = {}) {
+    const headSha = git(root, ['rev-parse', 'HEAD']).trim();
+    const branch = opts.branch ?? process.env.GITHUB_REF_NAME ?? git(root, ['branch', '--show-current']).trim();
+    if (!branch)
+        throw new Error('Set GITHUB_REF_NAME or pass a checked-out branch to generate a history report.');
+    const base = opts.baseSha === undefined ? pushBase() : opts.baseSha;
+    const delta = !!base && isAncestor(root, base, headSha);
+    const range = delta ? `${base}..${headSha}` : headSha;
+    const commits = commitMetadata(root, range);
+    const changes = new Map();
+    const merges = readNumstatLog(root, range, changes);
+    for (const commit of commits)
+        if (merges.has(commit.sha))
+            srcChanges(root, commit.sha, commit.parents, changes);
+    const lineCounts = new Map();
+    const reportCommits = [];
+    for (let start = 0; start < commits.length; start += HISTORY_BATCH_SIZE) {
+        const batch = commits.slice(start, start + HISTORY_BATCH_SIZE).map((commit) => ({ commit, blobs: parseTree(root, commit.sha) }));
+        blobLineCounts(root, batch.flatMap((i) => i.blobs), lineCounts);
+        for (const { commit, blobs } of batch) {
+            const changed = changes.get(commit.sha) ?? { additions: 0, deletions: 0 };
+            reportCommits.push({
+                sha: commit.sha,
+                authorDate: commit.authorDate,
+                additions: changed.additions,
+                deletions: changed.deletions,
+                sourceLines: blobs.reduce((total, blob) => total + (lineCounts.get(blob) ?? 0), 0),
+            });
+        }
+    }
+    return {
+        schemaVersion: 1,
+        mode: delta ? 'delta' : 'snapshot',
+        repository: opts.repository ?? repoName(root),
+        branch,
+        headSha,
+        baseSha: delta ? base : null,
+        generatedAt: new Date().toISOString(),
+        commits: reportCommits,
+    };
+}
+/**
+ * Write a generated report to a JSON file in the checkout.
+ *
+ * @param root Path to the full Git checkout.
+ * @param path Output path relative to the checkout.
+ * @param opts Optional repository, branch, or push-base overrides.
+ * @return The generated history report.
+ */
+export function writeHistoryReport(root, path, opts) {
+    const report = createHistoryReport(root, opts);
+    writeFileSync(resolve(root, path), `${JSON.stringify(report, null, 2)}\n`);
+    return report;
+}
+//# sourceMappingURL=history-report.js.map

package/dist/history-report.js.map

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

package/dist/imports.d.ts

@@ -0,0 +1,19 @@
+/**
+ * packages/quality/src/imports.ts
+ * Resolves import specifiers to their corresponding files.
+ */
+import type { QualityCfg } from './runner.js';
+/** An unresolved local import specifier and the file that contains it. */
+export type ImportFailure = {
+    importer: string;
+    specifier: string;
+};
+/**
+ * Checks all configured internal imports, including assets and extensionless modules.
+ *
+ * @param cfg Quality configuration defining the source scope and alias rules.
+ *
+ * @return Internal import failures whose specifiers could not be resolved.
+ */
+export declare function checkImports(cfg: QualityCfg): ImportFailure[];
+//# sourceMappingURL=imports.d.ts.map

package/dist/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../src/imports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9C,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAkDpE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,EAAE,CAW7D"}

package/dist/imports.js

@@ -0,0 +1,90 @@
+/**
+ * packages/quality/src/imports.ts
+ * Resolves import specifiers to their corresponding files.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import ts from 'typescript';
+import { dirname, extname, join, resolve } from 'node:path';
+import { displayPath, isFile, srcFiles } from './files.js';
+import { readFileSync } from 'node:fs';
+/*//////////////////////////////////////////////////
+CONFIG
+//////////////////////////////////////////////////*/
+const MODULE_EXTS = ['', '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts', '.astro', '.mdx', '.json', '.css', '.scss', '.svg', '.png', '.jpg', '.jpeg', '.webp'];
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Resolves a relative or configured alias import against the repository filesystem.
+ *
+ * @param specifier Module specifier written by the importing source file.
+ * @param importer Absolute path of the file containing the import.
+ * @param cfg Quality configuration containing aliases and the repository root.
+ *
+ * @return The resolved file path, or `null` when no supported target exists.
+ */
+function resolveImport(specifier, importer, cfg) {
+    const alias = Object.entries(cfg.aliases ?? {}).find(([p]) => specifier.startsWith(p));
+    const raw = alias ? resolve(cfg.root, alias[1], specifier.slice(alias[0].length)) : specifier.startsWith('.') ? resolve(dirname(importer), specifier) : null;
+    if (!raw)
+        return null;
+    const stripped = /\.(?:c|m)?(?:j|t)sx?$/.test(raw) ? raw.slice(0, raw.lastIndexOf('.')) : raw;
+    for (const b of [...new Set([raw, stripped])])
+        for (const ext of MODULE_EXTS) {
+            const candidate = b + ext;
+            if (isFile(candidate))
+                return candidate;
+            const idx = join(b, `index${ext}`);
+            if (isFile(idx))
+                return idx;
+        }
+    return null;
+}
+/**
+ * Extracts static import, export, dynamic-import, and CommonJS require specifiers from a source file.
+ *
+ * @param fileName Absolute path to the source file to parse.
+ *
+ * @return Module specifiers found in the file.
+ */
+function specifiers(fileName) {
+    const src = readFileSync(fileName, 'utf8');
+    const file = ts.createSourceFile(fileName, src, ts.ScriptTarget.Latest, true);
+    const vals = [];
+    ts.forEachChild(file, (n) => {
+        if (ts.isImportDeclaration(n) && ts.isStringLiteral(n.moduleSpecifier))
+            vals.push(n.moduleSpecifier.text);
+        if (ts.isExportDeclaration(n) && n.moduleSpecifier && ts.isStringLiteral(n.moduleSpecifier))
+            vals.push(n.moduleSpecifier.text);
+        if (ts.isCallExpression(n) && n.arguments.length === 1 && ts.isStringLiteral(n.arguments[0]) && (n.expression.kind === ts.SyntaxKind.ImportKeyword || n.expression.getText(file) === 'require'))
+            vals.push(n.arguments[0].text);
+    });
+    return vals;
+}
+/**
+ * Checks all configured internal imports, including assets and extensionless modules.
+ *
+ * @param cfg Quality configuration defining the source scope and alias rules.
+ *
+ * @return Internal import failures whose specifiers could not be resolved.
+ */
+export function checkImports(cfg) {
+    const failures = [];
+    for (const i of srcFiles(cfg)) {
+        for (const s of specifiers(i)) {
+            if (cfg.externalPrefixes?.some((p) => s.startsWith(p)))
+                continue;
+            if (!s.startsWith('.') && !Object.keys(cfg.aliases ?? {}).some((p) => s.startsWith(p)))
+                continue;
+            if (s.startsWith('.') && extname(s) && !MODULE_EXTS.includes(extname(s)))
+                continue;
+            if (!resolveImport(s, i, cfg))
+                failures.push({ importer: displayPath(cfg, i), specifier: s });
+        }
+    }
+    return failures;
+}
+//# sourceMappingURL=imports.js.map

package/dist/imports.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * packages/quality/src/index.ts
+ * Public API for the consolidated Terra quality package.
+ */
+export * from './collapse.js';
+export * from './files.js';
+export * from './history-report.js';
+export * from './github-report.js';
+export * from './imports.js';
+export * from './inline-if.js';
+export * from './documentation.js';
+export * from './naming.js';
+export * from './object-forwarding.js';
+export * from './port.js';
+export * from './runner.js';
+export * from './single-use.js';
+export * from './security.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * packages/quality/src/index.ts
+ * Public API for the consolidated Terra quality package.
+ */
+export * from './collapse.js';
+export * from './files.js';
+export * from './history-report.js';
+export * from './github-report.js';
+export * from './imports.js';
+export * from './inline-if.js';
+export * from './documentation.js';
+export * from './naming.js';
+export * from './object-forwarding.js';
+export * from './port.js';
+export * from './runner.js';
+export * from './single-use.js';
+export * from './security.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/inline-if.d.ts

@@ -0,0 +1,13 @@
+/**
+ * packages/quality/src/inline-if.ts
+ * Inlines single-statement conditional blocks without changing nested blocks.
+ */
+/**
+ * Collapses single-statement conditional blocks without changing nested blocks.
+ *
+ * @param fileName Absolute path to the source file to rewrite.
+ *
+ * @return `true` when at least one eligible conditional was collapsed.
+ */
+export declare function collapseInlineIfs(fileName: string): boolean;
+//# sourceMappingURL=inline-if.d.ts.map

package/dist/inline-if.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-if.d.ts","sourceRoot":"","sources":["../src/inline-if.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyB3D"}

package/dist/inline-if.js

@@ -0,0 +1,48 @@
+/**
+ * packages/quality/src/inline-if.ts
+ * Inlines single-statement conditional blocks without changing nested blocks.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import ts from 'typescript';
+import { readFileSync, writeFileSync } from 'node:fs';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Collapses single-statement conditional blocks without changing nested blocks.
+ *
+ * @param fileName Absolute path to the source file to rewrite.
+ *
+ * @return `true` when at least one eligible conditional was collapsed.
+ */
+export function collapseInlineIfs(fileName) {
+    const src = readFileSync(fileName, 'utf8');
+    const parsed = ts.createSourceFile(fileName, src, ts.ScriptTarget.Latest, true, fileName.endsWith('x') ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+    const edits = [];
+    const visit = (node) => {
+        if (ts.isIfStatement(node) && ts.isBlock(node.thenStatement) && node.thenStatement.statements.length === 1) {
+            const statement = node.thenStatement.statements[0];
+            const sStatement = ts.isExpressionStatement(statement) || ts.isReturnStatement(statement) || ts.isThrowStatement(statement) || ts.isBreakStatement(statement) || ts.isContinueStatement(statement);
+            const danglingElse = Boolean(node.elseStatement && ts.isIfStatement(statement) && !statement.elseStatement);
+            const body = src.slice(node.thenStatement.getStart(parsed) + 1, node.thenStatement.end - 1);
+            if (sStatement && !danglingElse && !body.includes('//') && !body.includes('/*')) {
+                edits.push({ start: node.thenStatement.getStart(parsed), end: statement.getStart(parsed), text: '' });
+                edits.push({ start: statement.end, end: node.thenStatement.end, text: '' });
+            }
+        }
+        // Nested conditionals are deliberately retained. Removing their braces can
+        // change which conditional owns a following else even when the result parses.
+        if (!ts.isIfStatement(node))
+            ts.forEachChild(node, visit);
+    };
+    visit(parsed);
+    const n = edits.sort((a, b) => b.start - a.start).reduce((text, edit) => `${text.slice(0, edit.start)}${edit.text}${text.slice(edit.end)}`, src);
+    if (n === src)
+        return false;
+    writeFileSync(fileName, n);
+    return true;
+}
+//# sourceMappingURL=inline-if.js.map

package/dist/inline-if.js.map

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