@thethracian/oxlint-config 0.2.1 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.1 - 2026-05-25
+
+### Changes
+
+- chore(ts): consume published oxlint config (#8) (5a1b72a)
+
+## 0.3.0 - 2026-05-25
+
+### Features
+
+- feat(ci): keep performance gate local (#7) (635fdfe)
+- feat(ts): rewrite codemod fixers with jscodeshift (#6) (989d924)
+
 ## 0.2.1 - 2026-05-24
 
 ### Changes

package/README.md

@@ -1,25 +1,96 @@
 # @thethracian/oxlint-config
 
-Importable Oxlint config for TypeScript projects.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@thethracian/oxlint-config"><img alt="npm version" src="https://img.shields.io/npm/v/@thethracian/oxlint-config?style=flat-square"></a>
+  <a href="https://www.npmjs.com/package/@thethracian/oxlint-config"><img alt="npm downloads" src="https://img.shields.io/npm/dw/@thethracian/oxlint-config?style=flat-square"></a>
+  <a href="https://socket.dev/npm/package/%40thethracian/oxlint-config"><img alt="Socket package analysis" src="https://socket.dev/api/badge/npm/package/@thethracian/oxlint-config"></a>
+  <a href="https://github.com/stefan-vatov/code-quality/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/stefan-vatov/code-quality/ci.yml?branch=main&style=flat-square"></a>
+  <a href="https://github.com/stefan-vatov/code-quality/blob/main/LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-blue?style=flat-square"></a>
+</p>
 
-The config errors on lines over 150 characters, files over 500 lines, functions over 75 lines, nesting deeper than 3 levels, callback nesting deeper than 4 levels (max-nested-callbacks), more than 5 parameters, cyclomatic complexity over 10, requires strict equality (eqeqeq), denies eval and dynamic code execution (no-eval, no-implied-eval when type-aware), denies debug artifacts (no-console, no-debugger), bans silent catch blocks (no-empty), bans commented-out code (custom thethracian/no-commented-out-code rule), bans inline comments and warning comments (no-inline-comments, no-warning-comments), bans `any` and untyped escape hatches (no-explicit-any, no-unsafe-call, no-unsafe-member-access, plus no-unsafe-assignment/return/argument when type-aware), denies unhandled promises (no-floating-promises, no-misused-promises when type-aware), and enforces immutability with prefer-const and no-param-reassign (including property mutations).
+The Thracian Oxlint config is an experimental, painfully strict, very opinionated TypeScript lint profile for teams that want AI-generated code reviewed like production code.
 
-The package uses Oxlint's native complexity rule and ships the Oxlint type-aware runner needed by
-the `typeAware` profile.
+```text
+oxlint.config.mjs
+  import theThracian from '@thethracian/oxlint-config';
+
+  export default theThracian({ typeAware: true });
+
+Result: native Oxlint rules + The Thracian custom rules + optional Effect policy checks.
+```
+
+## Why Use It
+
+- Strict by default: every rule is an error, not a suggestion.
+- Agent-ready TypeScript: catches debug artifacts, unsafe escape hatches, silent catches, mutation, deep nesting, and oversized code.
+- Effect-aware out of the box: 81 always-on Effect rules target lazy values, generator style, Promise boundaries, typed errors, Schema boundaries, resources, tests, and common hallucinated APIs.
+- Strict Effect mode when you want it: opt in to 60 additional project-boundary rules for entrypoints, adapters, config layers, domain modules, service wiring, external calls, and test ownership.
+- Importable config: consumers import one package instead of copying linter files around a codebase.
+
+## Install
 
 ```sh
 pnpm add -D @thethracian/oxlint-config oxlint@^1.63.0
 ```
 
-```ts
+Create `oxlint.config.mjs`:
+
+```js
 import theThracian from '@thethracian/oxlint-config';
 
 export default theThracian();
 ```
 
-Enable type-aware Oxlint execution and the matching type-aware rules from the shared config:
+Run Oxlint:
+
+```sh
+pnpm oxlint .
+```
+
+Add package scripts for normal linting, type-aware linting, and the combined fixer:
+
+```json
+{
+  "scripts": {
+    "lint": "oxlint src",
+    "lint:fix": "thx-codemod-fix src && oxlint src --fix && thx-codemod-fix src",
+    "lint:type-aware": "oxlint src --type-aware --type-check",
+    "lint:fix:type-aware": "thx-codemod-fix src && oxlint src --type-aware --type-check --fix && thx-codemod-fix src"
+  }
+}
+```
+
+`thx-codemod-fix` is intentionally separate from `oxlint --fix` because Oxlint owns native rule fixes and the package CLI owns larger AST codemods. Running it before and after Oxlint is safe because the codemods are idempotent. The CLI defaults to `src`, but you can pass any files or directories your project wants fixed.
+
+For staged files, wire the same package tools through `lint-staged`:
+
+```json
+{
+  "lint-staged": {
+    "*.{ts,tsx,mts,cts}": [
+      "thx-codemod-fix",
+      "oxlint --type-aware --type-check --fix --no-error-on-unmatched-pattern",
+      "thx-codemod-fix"
+    ]
+  }
+}
+```
+
+Programmatic consumers can use the same codemod runner:
 
 ```ts
+import { codemodFix } from '@thethracian/oxlint-config/codemod-fix';
+
+codemodFix({
+  paths: ['src', 'scripts'],
+});
+```
+
+## Type-Aware Mode
+
+Type-aware mode enables Oxlint's semantic TypeScript checks and the matching strict rules from this config.
+
+```js
 import theThracian from '@thethracian/oxlint-config';
 
 export default theThracian({
@@ -27,14 +98,26 @@ export default theThracian({
 });
 ```
 
-The 81-rule always-on default Effect bucket is enabled by default for this config. These rules
-target lazy Effect values, generator style, Promise boundaries, typed errors, resource safety,
-Schema boundaries, test determinism, stale APIs, platform escape hatches, unsafe Effect type
-assertions, service self-type drift, and common AI-generated Effect hallucinations.
+Use this when you want checks such as unsafe calls, unsafe member access, floating promises, misused promises, and exhaustive switch handling. It is slower than syntax-only linting because Oxlint has to load TypeScript project information.
 
-Non-Effect projects can disable that bucket explicitly:
+## Effect Defaults
 
-```ts
+Effect rules are enabled by default. They are designed for codebases where agents may produce plausible-looking but semantically weak Effect code.
+
+The default bucket checks for patterns such as:
+
+- floating `Effect` values that are never run, yielded, returned, or composed
+- missing `yield*` inside `Effect.gen`
+- nested `flatMap` code that should be `Effect.gen`
+- string errors and untagged error channels
+- unsafe Promise, throw, runtime, and sync boundaries
+- Schema decode misuse at external data boundaries
+- resource, fiber, stream, concurrency, and test determinism mistakes
+- deprecated or invented Effect APIs
+
+Disable the Effect bucket for non-Effect projects:
+
+```js
 import theThracian from '@thethracian/oxlint-config';
 
 export default theThracian({
@@ -42,10 +125,11 @@ export default theThracian({
 });
 ```
 
-Effect projects that want strict project-boundary enforcement can opt in to the 60-rule strict
-bucket:
+## Strict Effect Mode
 
-```ts
+Strict mode adds project-boundary checks. It is intentionally opinionated and is best for Effect services with clear layers.
+
+```js
 import theThracian from '@thethracian/oxlint-config';
 
 export default theThracian({
@@ -55,10 +139,9 @@ export default theThracian({
 });
 ```
 
-Strict mode uses conventional project globs for entrypoints, composition roots, config layers,
-domain modules, adapters, and test types. Override them when a project uses a different layout:
+Override the default project layout when your repository uses different paths:
 
-```ts
+```js
 import theThracian from '@thethracian/oxlint-config';
 
 export default theThracian({
@@ -75,3 +158,26 @@ export default theThracian({
   },
 });
 ```
+
+## What It Enforces
+
+| Area                   | Policy                                                                                                                           |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| Size and shape         | 150-character lines, 500-line files, 75-line functions, max nesting depth 3, max 5 parameters, cyclomatic complexity 10          |
+| TypeScript safety      | no `any` escape hatches, no unsafe calls/member access, explicit function return types, strict equality                          |
+| Async safety           | no floating promises in type-aware mode, no misused promises, no unhandled Effect values                                         |
+| Debug and dynamic code | no `console`, `debugger`, `eval`, `new Function`, script URLs, warning comments, or commented-out code                           |
+| Immutability           | `prefer-const` and no parameter reassignment, including property mutation                                                        |
+| Naming                 | PascalCase types, camelCase identifiers, boolean prefixes, private underscores, and consistent acronym casing                    |
+| Effect                 | generator style, typed errors, Schema validation, resource safety, bounded concurrency, test determinism, and project boundaries |
+
+## Registry Links
+
+- npm: <https://www.npmjs.com/package/@thethracian/oxlint-config>
+- Socket package analysis: <https://socket.dev/npm/package/%40thethracian/oxlint-config>
+- Source: <https://github.com/stefan-vatov/code-quality/tree/main/ts>
+- Issues: <https://github.com/stefan-vatov/code-quality/issues>
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/codemod-fix/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/codemod-fix/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/codemod-fix/cli.ts"],"names":[],"mappings":""}

package/dist/codemod-fix/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/* -------------------------------------------------------------------------- */
+/*          CLI entry point for running The Thracian codemod fixes.           */
+/* -------------------------------------------------------------------------- */
+import { codemodFix } from './index.js';
+const dryRunFlag = '--dry-run';
+const rawArgs = process.argv.slice(2);
+const dryRun = rawArgs.includes(dryRunFlag);
+const paths = rawArgs.filter((arg) => arg !== dryRunFlag);
+const result = codemodFix({ dryRun, paths });
+const mode = (() => {
+    if (dryRun) {
+        return 'Would apply';
+    }
+    return 'Applied';
+})();
+process.stdout.write(`${mode} The Thracian codemod fixes to ${result.changedFiles.length} file(s); ` +
+    `scanned ${result.scannedFiles} file(s).\n`);
+if (dryRun && result.changedFiles.length > 0) {
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/codemod-fix/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/codemod-fix/cli.ts"],"names":[],"mappings":";AACA,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAW,EAAE,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;AACnE,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7C,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE;IACzB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC,EAAE,CAAC;AAEL,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,kCAAkC,MAAM,CAAC,YAAY,CAAC,MAAM,YAAY;IAC7E,WAAW,MAAM,CAAC,YAAY,aAAa,CAC9C,CAAC;AAEF,IAAI,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/codemod-fix/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Options for running The Thracian codemod fixer.
+ *
+ * @public
+ */
+export interface CodemodFixOptions {
+    cwd?: string;
+    dryRun?: boolean;
+    paths?: readonly string[];
+}
+/**
+ * Summary returned after scanning and optionally rewriting source files.
+ *
+ * @public
+ */
+export interface CodemodFixResult {
+    changedFiles: string[];
+    scannedFiles: number;
+}
+/**
+ * Lists TypeScript source files under a root directory.
+ *
+ * @public
+ */
+export declare const sourceFilesUnder: (root: string) => string[];
+/**
+ * Applies all safe codemod fixes to a single source string.
+ *
+ * @public
+ */
+export declare const applyCodemodFixToSource: (source: string) => string;
+/**
+ * Applies all safe codemod fixes to one file.
+ *
+ * @public
+ */
+export declare const applyCodemodFixToFile: (path: string, dryRun: boolean) => boolean;
+/**
+ * Runs The Thracian codemod fixer across configured paths.
+ *
+ * @public
+ */
+export declare const codemodFix: (options?: CodemodFixOptions) => CodemodFixResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/codemod-fix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codemod-fix/index.ts"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAAM,EAoBrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,KAAG,MAatD,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,QAAQ,OAAO,KAAG,OAYrE,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,UAAS,iBAAsB,KAAG,gBAiB5D,CAAC"}

package/dist/codemod-fix/index.js

@@ -0,0 +1,110 @@
+/* -------------------------------------------------------------------------- */
+/* Public API for running The Thracian codemod fixes from package scripts or  */
+/*                                   Tools.                                   */
+/* -------------------------------------------------------------------------- */
+import { readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { addInternalExportDocs } from '../codemods/internal-export-docs.js';
+import { addVoidReturnTypes } from '../codemods/explicit-return-types.js';
+import { formatFileHeaderComment } from '../codemods/format-file-header.js';
+import { formatJSDocComments } from '../codemods/format-jsdoc-comments.js';
+import { inlineLocalExportLists } from '../codemods/inline-export-lists.js';
+import { preferConciseArrowBodies } from '../codemods/arrow-body-style.js';
+import { preferExplicitBranches } from '../codemods/no-ternary.js';
+import { preferFunctionExpressions } from '../codemods/function-declarations.js';
+import { renameMisCasedAcronyms } from '../codemods/rename-acronyms.js';
+import { resolve } from 'node:path';
+import { sortImportDeclarations } from '../codemods/sort-imports.js';
+const defaultPaths = ['src'];
+const sourceExtensions = new Set(['.ts', '.tsx', '.mts', '.cts']);
+const ignoredDirectories = new Set(['bench', 'dist', 'fixtures', 'node_modules', 'test']);
+const hasSourceExtension = (path) => [...sourceExtensions].some((extension) => path.endsWith(extension));
+/**
+ * Lists TypeScript source files under a root directory.
+ *
+ * @public
+ */
+export const sourceFilesUnder = (root) => {
+    const files = [];
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory)) {
+            const path = resolve(directory, entry);
+            const stats = statSync(path);
+            if (stats.isDirectory()) {
+                if (!ignoredDirectories.has(entry)) {
+                    visit(path);
+                }
+            }
+            else if (stats.isFile() && hasSourceExtension(path)) {
+                files.push(path);
+            }
+        }
+    };
+    visit(root);
+    return files;
+};
+/**
+ * Applies all safe codemod fixes to a single source string.
+ *
+ * @public
+ */
+export const applyCodemodFixToSource = (source) => formatJSDocComments(addInternalExportDocs(inlineLocalExportLists(addVoidReturnTypes(preferConciseArrowBodies(preferExplicitBranches(preferFunctionExpressions(sortImportDeclarations(renameMisCasedAcronyms(source)))))))));
+/**
+ * Applies all safe codemod fixes to one file.
+ *
+ * @public
+ */
+export const applyCodemodFixToFile = (path, dryRun) => {
+    const before = readFileSync(path, 'utf8');
+    const after = formatFileHeaderComment(applyCodemodFixToSource(before));
+    if (after === before) {
+        return false;
+    }
+    if (!dryRun) {
+        writeFileSync(path, after);
+    }
+    return true;
+};
+const candidateFiles = (path) => {
+    const stats = statSync(path);
+    if (stats.isDirectory()) {
+        return sourceFilesUnder(path);
+    }
+    return [path];
+};
+/**
+ * Runs The Thracian codemod fixer across configured paths.
+ *
+ * @public
+ */
+export const codemodFix = (options = {}) => {
+    const cwd = options.cwd ?? process.cwd();
+    const paths = (() => {
+        if (options.paths && options.paths.length > 0) {
+            return options.paths;
+        }
+        return defaultPaths;
+    })();
+    const dryRun = options.dryRun ?? false;
+    const changedFiles = [];
+    let scannedFiles = 0;
+    for (const path of paths) {
+        scannedFiles += scanPath(cwd, path, dryRun, changedFiles);
+    }
+    return { changedFiles, scannedFiles };
+};
+const collectChangedFile = (changedFiles, file, dryRun) => {
+    if (applyCodemodFixToFile(file, dryRun)) {
+        changedFiles.push(file);
+    }
+};
+const scanPath = (cwd, path, dryRun, changedFiles) => {
+    let scannedFiles = 0;
+    for (const file of candidateFiles(resolve(cwd, path))) {
+        if (hasSourceExtension(file)) {
+            scannedFiles += 1;
+            collectChangedFile(changedFiles, file, dryRun);
+        }
+    }
+    return scannedFiles;
+};
+//# sourceMappingURL=index.js.map

package/dist/codemod-fix/index.js.map

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

package/dist/codemods/arrow-body-style.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Internal helper exported for package-local composition.
+ *
+ * @internal
+ */
+export declare const preferConciseArrowBodies: (source: string) => string;
+//# sourceMappingURL=arrow-body-style.d.ts.map

package/dist/codemods/arrow-body-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-body-style.d.ts","sourceRoot":"","sources":["../../src/codemods/arrow-body-style.ts"],"names":[],"mappings":"AAmJA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,KAAG,MAazD,CAAC"}

package/dist/codemods/arrow-body-style.js

@@ -0,0 +1,106 @@
+import jscodeshift from 'jscodeshift';
+const MAX_LINE_LENGTH = 150;
+const NOT_FOUND_INDEX = -1;
+const codemodAPI = jscodeshift.withParser('ts');
+const isObjectRecord = (value) => typeof value === 'object' && value !== null;
+const applyReplacements = (source, replacements) => [...replacements]
+    .sort((left, right) => right.start - left.start)
+    .reduce((current, replacement) => current.slice(0, replacement.start) + replacement.text + current.slice(replacement.end), source);
+const nodeStart = (node) => {
+    if (isObjectRecord(node)) {
+        const { start } = node;
+        if (typeof start === 'number') {
+            return start;
+        }
+    }
+    throw new Error('jscodeshift node is missing a start offset');
+};
+const nodeEnd = (node) => {
+    if (isObjectRecord(node)) {
+        const { end } = node;
+        if (typeof end === 'number') {
+            return end;
+        }
+    }
+    throw new Error('jscodeshift node is missing an end offset');
+};
+const sourceForNode = (source, node) => source.slice(nodeStart(node), nodeEnd(node));
+const hasAttachedComments = (node) => Boolean(node.comments?.length ||
+    (isObjectRecord(node) &&
+        Array.isArray(node.leadingComments) &&
+        node.leadingComments.length > 0) ||
+    (isObjectRecord(node) &&
+        Array.isArray(node.trailingComments) &&
+        node.trailingComments.length > 0));
+const expressionNeedsParentheses = (expression) => expression.type === 'ObjectExpression';
+const lineEndAfter = (source, end) => {
+    const nextLineBreak = source.indexOf('\n', end);
+    if (nextLineBreak === NOT_FOUND_INDEX) {
+        return source.length;
+    }
+    return nextLineBreak;
+};
+const wouldExceedLineLimit = (source, start, end, replacementText) => {
+    if (replacementText.includes('\n')) {
+        return false;
+    }
+    const lineStart = source.lastIndexOf('\n', start) + 1;
+    const lineEnd = lineEndAfter(source, end);
+    const line = source.slice(lineStart, start) + replacementText + source.slice(end, lineEnd);
+    return line.length > MAX_LINE_LENGTH;
+};
+const replacementTextForExpression = (source, expression) => {
+    const expressionText = sourceForNode(source, expression);
+    if (expressionNeedsParentheses(expression)) {
+        return `(${expressionText})`;
+    }
+    return expressionText;
+};
+const onlyReturnStatement = (body) => {
+    if (body.body.length !== 1) {
+        return undefined;
+    }
+    const [statement] = body.body;
+    if (statement?.type === 'ReturnStatement' && statement.argument) {
+        return { expression: statement.argument, statement };
+    }
+    return undefined;
+};
+const replacementForReturnExpression = (source, node, expression) => {
+    const text = replacementTextForExpression(source, expression);
+    if (wouldExceedLineLimit(source, nodeStart(node.body), nodeEnd(node.body), text)) {
+        return undefined;
+    }
+    return { end: nodeEnd(node.body), start: nodeStart(node.body), text };
+};
+const replacementForArrow = (source, node) => {
+    if (node.body.type !== 'BlockStatement') {
+        return undefined;
+    }
+    const result = onlyReturnStatement(node.body);
+    if (!result) {
+        return undefined;
+    }
+    if (hasAttachedComments(result.statement)) {
+        return undefined;
+    }
+    return replacementForReturnExpression(source, node, result.expression);
+};
+/**
+ * Internal helper exported for package-local composition.
+ *
+ * @internal
+ */
+export const preferConciseArrowBodies = (source) => {
+    const replacements = [];
+    codemodAPI(source)
+        .find(codemodAPI.ArrowFunctionExpression)
+        .forEach((path) => {
+        const replacement = replacementForArrow(source, path.value);
+        if (replacement) {
+            replacements.push(replacement);
+        }
+    });
+    return applyReplacements(source, replacements);
+};
+//# sourceMappingURL=arrow-body-style.js.map

package/dist/codemods/arrow-body-style.js.map

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

package/dist/codemods/comment-format.d.ts

@@ -0,0 +1,24 @@
+interface JSDocInput {
+    summary: string;
+    tags?: readonly string[];
+}
+/**
+ * Formats a classic multi-line JSDoc block.
+ *
+ * @internal
+ */
+export declare const formatJSDoc: (input: JSDocInput) => string;
+/**
+ * Formats a three-line fixed-width section header.
+ *
+ * @internal
+ */
+export declare const formatMainHeader: (text: string) => string;
+/**
+ * Formats a one-line fixed-width section header.
+ *
+ * @internal
+ */
+export declare const formatSubheader: (text: string) => string;
+export {};
+//# sourceMappingURL=comment-format.d.ts.map

package/dist/codemods/comment-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-format.d.ts","sourceRoot":"","sources":["../../src/codemods/comment-format.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAgFD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,MAW/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAOlC,CAAC;AAEf;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAM9C,CAAC"}