@codegraft/core 0.1.0-beta.1 → 0.1.0-beta.10

package/dist/containers.js

@@ -0,0 +1,39 @@
+import { COMMENT_TYPES } from './comment-attachment.js';
+import { assert } from './assert.js';
+// Structural queries over container nodes (arrays / objects / blocks / interface bodies …), shared by
+// the Collection (routing, `remove({ separator })`) and the Formatter (layout). Kept here so neither
+// has to import the other.
+/** The opening delimiter token (`[` / `{` / `(`) of a container node. */
+export function openDelimiter(node) {
+    const open = node.allChildren[0];
+    assert(open, `container '${node.type}' has no opening delimiter`);
+    return open;
+}
+/** The separator token (a `,` by default, or `;` for a `;`-list) immediately after `node` among its
+ *  parent's children (comments skipped), or `null` — the trailing separator `remove({ separator })`
+ *  drops alongside a list element, and `append` extends to keep the container's style. */
+export function trailingSeparator(node, sep = ',') {
+    const siblings = node.parent?.allChildren;
+    if (!siblings)
+        return null;
+    const i = siblings.indexOf(node);
+    if (i === -1)
+        return null;
+    for (let j = i + 1; j < siblings.length; j++) {
+        const sib = siblings[j];
+        if (COMMENT_TYPES[sib.language].has(sib.type))
+            continue;
+        return sib.type === sep ? sib : null;
+    }
+    return null;
+}
+/** Whether `node` spans more than one line (its open and close sit on different rows) — the cue for
+ *  `append`/`prepend` to lay an element on its own line rather than inline. */
+export function isMultiline(node) {
+    return node.startPosition.row !== node.endPosition.row;
+}
+/** Containers whose elements are separated by newlines (a block / class body), not commas. */
+export const NEWLINE_CONTAINERS = new Set(['statement_block', 'class_body', 'program']);
+/** Containers whose members are separated/terminated by `;` (a TS interface / object type). */
+export const SEMI_CONTAINERS = new Set(['interface_body', 'object_type']);
+//# sourceMappingURL=containers.js.map

package/dist/containers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.js","sourceRoot":"","sources":["../src/containers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,sGAAsG;AACtG,qGAAqG;AACrG,2BAA2B;AAE3B,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;IAChC,MAAM,CAAC,IAAI,EAAE,cAAc,IAAI,CAAC,IAAI,4BAA4B,CAAC,CAAA;IACjE,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;0FAE0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,GAAG,GAAG,GAAG;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAA;IACzC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAQ;QACvD,OAAO,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IACtC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;+EAC+E;AAC/E,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,KAAK,IAAI,CAAC,WAAW,CAAC,GAAG,CAAA;AACxD,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAA;AAEvF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAA"}

package/dist/edit-collector.d.ts

@@ -1,12 +1,12 @@
 import type { SourceMap } from './types.js';
 /**
- * Collects edits against a source string and produces the transformed code (and, on
- * demand, a source map) via magic-string.
+ * A pure edit buffer: collects text edits against a source string and produces the transformed code
+ * (and, on demand, a source map) via magic-string. It knows nothing about lines, indentation, or
+ * formatting — that policy lives in the {@link Formatter}, which drives this buffer.
  *
- * Overlap is resolved **first-wins**: an edit overlapping one already accepted is
- * dropped silently — the text-layer side of outer-wins. Because edits are applied
- * through magic-string at their original offsets, the kept text keeps its original
- * position, so the generated map is precise.
+ * Overlap is resolved **first-wins**: an edit overlapping one already accepted is dropped silently —
+ * the text-layer side of outer-wins. Because edits are applied through magic-string at their original
+ * offsets, the kept text keeps its original position, so the generated map is precise.
  */
 export declare class EditCollector {
     #private;
@@ -15,19 +15,11 @@ export declare class EditCollector {
     overwrite(start: number, end: number, replacement: string): void;
     /** Delete `[start, end)`. */
     remove(start: number, end: number): void;
-    /** Delete the whole lines `[start, end)` touches — from the start of `start`'s line (leading
-     *  indentation included) through the newline after `end`'s line, so nothing blank is left behind.
-     *  With `collapseBlankBefore`, also absorb whole blank lines immediately above (a separator before
-     *  a dropped block). */
-    removeLines(start: number, end: number, collapseBlankBefore?: boolean): void;
     /** Insert `text` at `index`, attached to the left chunk. A point insertion: it claims no
      *  range, so it composes with edits on either side (and survives removal of the right side). */
     insertLeft(index: number, text: string): void;
     /** Insert `text` at `index`, attached to the right chunk. */
     insertRight(index: number, text: string): void;
-    /** The leading whitespace of the line containing `index` — the base indent an inserted block
-     *  should match. Empty when the line starts with a non-whitespace character. */
-    indentAt(index: number): string;
     toString(): string;
     generateMap(source: string): SourceMap;
 }

package/dist/edit-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit-collector.d.ts","sourceRoot":"","sources":["../src/edit-collector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;;;GAQG;AACH,qBAAa,aAAa;;gBAKZ,MAAM,EAAE,MAAM;IAK1B,yFAAyF;IACzF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMhE,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxC;;;4BAGwB;IACxB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,mBAAmB,UAAQ,GAAG,IAAI;IAa1E;oGACgG;IAChG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7C,6DAA6D;IAC7D,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9C;oFACgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B,QAAQ,IAAI,MAAM;IAIlB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAgBvC"}
+{"version":3,"file":"edit-collector.d.ts","sourceRoot":"","sources":["../src/edit-collector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;;;GAQG;AACH,qBAAa,aAAa;;gBAIZ,MAAM,EAAE,MAAM;IAI1B,yFAAyF;IACzF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMhE,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxC;oGACgG;IAChG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7C,6DAA6D;IAC7D,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9C,QAAQ,IAAI,MAAM;IAIlB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAWvC"}

package/dist/edit-collector.js

@@ -1,20 +1,18 @@
 import MagicString from 'magic-string';
 /**
- * Collects edits against a source string and produces the transformed code (and, on
- * demand, a source map) via magic-string.
+ * A pure edit buffer: collects text edits against a source string and produces the transformed code
+ * (and, on demand, a source map) via magic-string. It knows nothing about lines, indentation, or
+ * formatting — that policy lives in the {@link Formatter}, which drives this buffer.
  *
- * Overlap is resolved **first-wins**: an edit overlapping one already accepted is
- * dropped silently — the text-layer side of outer-wins. Because edits are applied
- * through magic-string at their original offsets, the kept text keeps its original
- * position, so the generated map is precise.
+ * Overlap is resolved **first-wins**: an edit overlapping one already accepted is dropped silently —
+ * the text-layer side of outer-wins. Because edits are applied through magic-string at their original
+ * offsets, the kept text keeps its original position, so the generated map is precise.
  */
 export class EditCollector {
     #magic;
-    #source;
     #claimed = [];
     constructor(source) {
         this.#magic = new MagicString(source);
-        this.#source = source;
     }
     /** Replace `[start, end)` with `replacement` (an empty range inserts before `start`). */
     overwrite(start, end, replacement) {
@@ -31,23 +29,6 @@ export class EditCollector {
             return;
         this.#magic.remove(start, end);
     }
-    /** Delete the whole lines `[start, end)` touches — from the start of `start`'s line (leading
-     *  indentation included) through the newline after `end`'s line, so nothing blank is left behind.
-     *  With `collapseBlankBefore`, also absorb whole blank lines immediately above (a separator before
-     *  a dropped block). */
-    removeLines(start, end, collapseBlankBefore = false) {
-        let lineStart = this.#lineStart(start);
-        if (collapseBlankBefore) {
-            while (lineStart > 0) {
-                const prevStart = this.#lineStart(lineStart - 1);
-                if (this.#source.slice(prevStart, lineStart - 1).trim() !== '')
-                    break; // a non-blank line stops it
-                lineStart = prevStart;
-            }
-        }
-        const newline = this.#source.indexOf('\n', end);
-        this.remove(lineStart, newline === -1 ? this.#source.length : newline + 1);
-    }
     /** Insert `text` at `index`, attached to the left chunk. A point insertion: it claims no
      *  range, so it composes with edits on either side (and survives removal of the right side). */
     insertLeft(index, text) {
@@ -57,21 +38,12 @@ export class EditCollector {
     insertRight(index, text) {
         this.#magic.appendRight(index, text);
     }
-    /** The leading whitespace of the line containing `index` — the base indent an inserted block
-     *  should match. Empty when the line starts with a non-whitespace character. */
-    indentAt(index) {
-        return /^[ \t]*/.exec(this.#source.slice(this.#lineStart(index), index))[0];
-    }
     toString() {
         return this.#magic.toString();
     }
     generateMap(source) {
         return this.#magic.generateMap({ source, includeContent: true, hires: true });
     }
-    // Offset of the first character of the line containing `index`.
-    #lineStart(index) {
-        return this.#source.lastIndexOf('\n', index - 1) + 1;
-    }
     // Half-open intervals [start, end): reject one overlapping an accepted edit (touching
     // boundaries don't overlap), so magic-string never sees a conflicting operation.
     #claim(start, end) {

package/dist/edit-collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"edit-collector.js","sourceRoot":"","sources":["../src/edit-collector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"edit-collector.js","sourceRoot":"","sources":["../src/edit-collector.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAA;AAGtC;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IACf,MAAM,CAAa;IACnB,QAAQ,GAA4B,EAAE,CAAA;IAE/C,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,yFAAyF;IACzF,SAAS,CAAC,KAAa,EAAE,GAAW,EAAE,WAAmB;QACvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,OAAM;QACpC,IAAI,KAAK,KAAK,GAAG;YAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;;YACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAA;IAClD,CAAC;IAED,6BAA6B;IAC7B,MAAM,CAAC,KAAa,EAAE,GAAW;QAC/B,IAAI,KAAK,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,OAAM;QACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAChC,CAAC;IAED;oGACgG;IAChG,UAAU,CAAC,KAAa,EAAE,IAAY;QACpC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,6DAA6D;IAC7D,WAAW,CAAC,KAAa,EAAE,IAAY;QACrC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC/B,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/E,CAAC;IAED,sFAAsF;IACtF,iFAAiF;IACjF,MAAM,CAAC,KAAa,EAAE,GAAW;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;QACtE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/format.d.ts

@@ -1,13 +1,51 @@
-/** A source file's guessed formatting: the indent unit (`'\t'` or N spaces) and line ending. */
+/** A source file's resolved formatting: the indent unit (`'\t'` or N spaces) and line ending. */
 export interface FormatStyle {
     indentUnit: string;
     eol: string;
 }
+/** Per-apply formatting configuration (`transform(src, ctx, options)`) — each field overrides what
+ *  would otherwise be detected from the source. The extension point prettier-like options (trailing
+ *  comma, semicolons, quotes, print width) would grow on. */
+export interface FormatOptions {
+    /** Force the indent unit (`'\t'` or N spaces) instead of guessing it. */
+    indentUnit?: string;
+    /** Force the line ending (`'\n'` / `'\r\n'`) instead of guessing it. */
+    eol?: string;
+}
 /** Guess the indent unit (most common indentation step, detect-indent style; tabs when they
  *  dominate) and EOL (first line break) of `source`, defaulting to two spaces and `'\n'`. */
 export declare function detectStyle(source: string): FormatStyle;
+/** The {@link FormatStyle} for an apply: detected from `source`, with any explicit `options` winning. */
+export declare function resolveStyle(source: string, options?: FormatOptions): FormatStyle;
 /** Re-indent a snippet for a line indented by `baseIndent`: the first line is left for the caller
- *  to position, each following non-blank line is prefixed with `baseIndent` (its own internal
- *  indentation preserved), and line breaks become `eol`. */
+ *  to position, every following non-blank line is re-anchored to `baseIndent` (its indentation
+ *  relative to the block's own base preserved), and line breaks become `eol`.
+ *
+ *  The block's base is the least-indented continuation line — *not* the first line, which a node's
+ *  `.text` leaves at column 0 even when the node sits deep in the source. Stripping that base before
+ *  applying `baseIndent` re-anchors a "hanging" block (continuation lines still at their source
+ *  indent) to the target, instead of stacking `baseIndent` on top of the indent already there. */
 export declare function reindent(text: string, baseIndent: string, eol: string): string;
+/** Offset of the first character of the line containing `index`. */
+export declare function lineStartOf(source: string, index: number): number;
+/** The leading whitespace of the line containing `index` — the base indent an inserted block should
+ *  match. Empty when the line starts with a non-whitespace character. */
+export declare function indentOf(source: string, index: number): string;
+/** A space or tab — the horizontal whitespace separating inline list elements (`undefined` past
+ *  either end of the source is not whitespace). */
+export declare function isHSpace(char: string | undefined): boolean;
+/** The start of the run of whole blank lines immediately above the line beginning at `lineStart`
+ *  — `lineStart` itself when the preceding line is non-blank. The "absorb blank lines above" step
+ *  shared by whole-line removal and the line-collapse of a removed last element. */
+export declare function blankRunStart(source: string, lineStart: number): number;
+/** The end of the run of whole blank lines beginning at line start `from` — the start of the first
+ *  non-blank line at or after it (`from` itself when that line is non-blank, the source length when
+ *  only blank lines remain). The forward mirror of {@link blankRunStart}: collapsing the blank lines
+ *  that followed a removed first element, which would dangle after the container's opening delimiter. */
+export declare function blankRunEnd(source: string, from: number): number;
+/** The whole-line span `[from, to)` covering the lines `[start, end)` touches — from the start of
+ *  `start`'s line (leading indentation included) through the newline after `end`'s line, so nothing
+ *  blank is left behind. With `collapseBlankBefore`, also absorb whole blank lines immediately above
+ *  (a separator before a dropped block). */
+export declare function wholeLineRange(source: string, start: number, end: number, collapseBlankBefore?: boolean): [number, number];
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAIA,gGAAgG;AAChG,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;6FAC6F;AAC7F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEvD;AA0CD;;4DAE4D;AAC5D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9E"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAIA,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;6DAE6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;6FAC6F;AAC7F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEvD;AAED,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAMjF;AA0CD;;;;;;;kGAOkG;AAClG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9E;AAKD,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;mDACmD;AACnD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE1D;AAED;;oFAEoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED;;;yGAGyG;AACzG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAShE;AAED;;;4CAG4C;AAC5C,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,mBAAmB,UAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxH"}

package/dist/format.js

@@ -6,6 +6,14 @@
 export function detectStyle(source) {
     return { indentUnit: detectIndentUnit(source), eol: detectEol(source) };
 }
+/** The {@link FormatStyle} for an apply: detected from `source`, with any explicit `options` winning. */
+export function resolveStyle(source, options) {
+    const detected = detectStyle(source);
+    return {
+        indentUnit: options?.indentUnit ?? detected.indentUnit,
+        eol: options?.eol ?? detected.eol,
+    };
+}
 function detectEol(source) {
     return /\r\n|\n/.exec(source)?.[0] ?? '\n';
 }
@@ -47,14 +55,79 @@ function detectIndentUnit(source) {
     return ' '.repeat(unit || 2);
 }
 /** Re-indent a snippet for a line indented by `baseIndent`: the first line is left for the caller
- *  to position, each following non-blank line is prefixed with `baseIndent` (its own internal
- *  indentation preserved), and line breaks become `eol`. */
+ *  to position, every following non-blank line is re-anchored to `baseIndent` (its indentation
+ *  relative to the block's own base preserved), and line breaks become `eol`.
+ *
+ *  The block's base is the least-indented continuation line — *not* the first line, which a node's
+ *  `.text` leaves at column 0 even when the node sits deep in the source. Stripping that base before
+ *  applying `baseIndent` re-anchors a "hanging" block (continuation lines still at their source
+ *  indent) to the target, instead of stacking `baseIndent` on top of the indent already there. */
 export function reindent(text, baseIndent, eol) {
     if (!text.includes('\n'))
         return text;
-    return text
-        .split(/\r\n|\n/)
-        .map((line, i) => (i === 0 || line.trim() === '' ? line : baseIndent + line))
-        .join(eol);
+    const lines = text.split(/\r\n|\n/);
+    let base = Infinity;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '')
+            continue;
+        base = Math.min(base, /^[ \t]*/.exec(lines[i])[0].length);
+    }
+    if (base === Infinity)
+        base = 0; // a single-or-blank-continuation snippet: nothing to strip
+    return lines.map((line, i) => (i === 0 || line.trim() === '' ? line : baseIndent + line.slice(base))).join(eol);
+}
+// —— Pure line/whitespace queries over a source string (shared by the formatter and whole-line
+// removal). They take the source explicitly so they stay independent of the edit buffer. ——
+/** Offset of the first character of the line containing `index`. */
+export function lineStartOf(source, index) {
+    return source.lastIndexOf('\n', index - 1) + 1;
+}
+/** The leading whitespace of the line containing `index` — the base indent an inserted block should
+ *  match. Empty when the line starts with a non-whitespace character. */
+export function indentOf(source, index) {
+    return /^[ \t]*/.exec(source.slice(lineStartOf(source, index), index))[0];
+}
+/** A space or tab — the horizontal whitespace separating inline list elements (`undefined` past
+ *  either end of the source is not whitespace). */
+export function isHSpace(char) {
+    return char === ' ' || char === '\t';
+}
+/** The start of the run of whole blank lines immediately above the line beginning at `lineStart`
+ *  — `lineStart` itself when the preceding line is non-blank. The "absorb blank lines above" step
+ *  shared by whole-line removal and the line-collapse of a removed last element. */
+export function blankRunStart(source, lineStart) {
+    let from = lineStart;
+    while (from > 0) {
+        const prevStart = lineStartOf(source, from - 1);
+        if (source.slice(prevStart, from - 1).trim() !== '')
+            break; // a non-blank line stops it
+        from = prevStart;
+    }
+    return from;
+}
+/** The end of the run of whole blank lines beginning at line start `from` — the start of the first
+ *  non-blank line at or after it (`from` itself when that line is non-blank, the source length when
+ *  only blank lines remain). The forward mirror of {@link blankRunStart}: collapsing the blank lines
+ *  that followed a removed first element, which would dangle after the container's opening delimiter. */
+export function blankRunEnd(source, from) {
+    let to = from;
+    while (to < source.length) {
+        const newline = source.indexOf('\n', to);
+        const lineEnd = newline === -1 ? source.length : newline;
+        if (source.slice(to, lineEnd).trim() !== '')
+            break; // a non-blank line stops it
+        to = newline === -1 ? source.length : newline + 1;
+    }
+    return to;
+}
+/** The whole-line span `[from, to)` covering the lines `[start, end)` touches — from the start of
+ *  `start`'s line (leading indentation included) through the newline after `end`'s line, so nothing
+ *  blank is left behind. With `collapseBlankBefore`, also absorb whole blank lines immediately above
+ *  (a separator before a dropped block). */
+export function wholeLineRange(source, start, end, collapseBlankBefore = false) {
+    const lineStart = lineStartOf(source, start);
+    const from = collapseBlankBefore ? blankRunStart(source, lineStart) : lineStart;
+    const newline = source.indexOf('\n', end);
+    return [from, newline === -1 ? source.length : newline + 1];
 }
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,iGAAiG;AACjG,mGAAmG;AAQnG;6FAC6F;AAC7F,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA,CAAC,gCAAgC;IACxE,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QACxD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,YAAY,GAAG,KAAK,CAAA;YACpB,SAAQ;QACV,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;QACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,QAAQ,EAAE,CAAA;YACV,YAAY,GAAG,KAAK,CAAA;YACpB,SAAQ;QACV,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAA;YACjD,IAAI,IAAI,GAAG,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAC3D,CAAC;QACD,UAAU,GAAG,MAAM,CAAC,MAAM,CAAA;QAC1B,YAAY,GAAG,IAAI,CAAA;IACrB,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAClC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YACjB,IAAI,GAAG,KAAK,CAAA;YACZ,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI;QAAE,OAAO,IAAI,CAAA;IAChC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;AAC9B,CAAC;AAED;;4DAE4D;AAC5D,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,UAAkB,EAAE,GAAW;IACpE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,IAAI;SACR,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;SAC5E,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/formatter.d.ts

@@ -0,0 +1,73 @@
+import type { RichNode } from './types.js';
+import type { EditCollector } from './edit-collector.js';
+import { type FormatStyle } from './format.js';
+/**
+ * The layout-formatting policy: how an edit is *rendered* once the codemod has decided *what* to
+ * edit. Built per-apply from the source plus a resolved {@link FormatStyle}. The {@link Collection}
+ * delegates the rendering of each edit to it; the {@link EditCollector} it drives stays a pure edit
+ * buffer.
+ *
+ * This is the single home for indentation/EOL re-rendering, container layout (separators, trailing
+ * commas, brace padding), and line-collapse on removal — and the place prettier-like options
+ * (trailing-comma/semicolon/quote/print-width) would grow.
+ */
+export declare class Formatter {
+    #private;
+    constructor(collector: EditCollector, source: string, style: FormatStyle);
+    /** The line ending — for inserting whole statements (`ensureImport`). */
+    get eol(): string;
+    /** The leading whitespace of the line containing `index` — for restoring a displaced node's indent. */
+    indentAt(index: number): string;
+    /** `text` re-indented to the line at `index` (single-line text is unchanged) — for a replaced or
+     *  inserted snippet. */
+    reindent(text: string, index: number): string;
+    /** Append `text` as the last element of `node`: a fresh indented line in a block/class body, after
+     *  the last element of a comma- or `;`-separated list, or as the sole element of an empty one. */
+    append(node: RichNode, text: string): void;
+    /** Prepend `text` as the first element of `node` — the mirror of {@link append}. */
+    prepend(node: RichNode, text: string): void;
+    /** Delete `[start, end)`, collapsing whitespace the way Prettier would: when the span owns its
+     *  line(s) — only indentation before `start`, only whitespace after `end` up to the line break —
+     *  drop the whole lines so no blank line is left; otherwise an in-line delete that also clears one
+     *  residual separating space, so a removed mid-list element (`[1, two(), 3]`) leaves `[1, 3]`, not
+     *  `[1,  3]`.
+     *
+     *  In the own-line case the content, the leading indent, and the trailing line break are removed
+     *  separately so the deletion composes after an abutting edit: a prior `unwrap`/`dropDirective` that
+     *  already consumed the run up to `start` leaves the content abutting it (no overlap, so it lands),
+     *  while the leading-indent removal it overlaps is dropped on its own (first-wins) instead of taking
+     *  the whole line removal down with it.
+     *
+     *  `collapse.before`/`collapse.after` (the node was the last / first surviving element of its
+     *  container) additionally drop the run of blank lines directly above / below: a blank separator
+     *  left against the container's closing / opening delimiter, which Prettier strips. Each is its own
+     *  edit, abutting (not overlapping) the line removal, so a prior edit on the line is unaffected. */
+    removeNode(start: number, end: number, collapse?: {
+        before?: boolean;
+        after?: boolean;
+    }): void;
+    /** Delete `[start, end)` where `end` begins a following node, collapsing the lines before it: when
+     *  `start` opens its own line and `end` sits on a later line, drop `[start's line, end's line)` so
+     *  the leading run (a directive comment and any comments stacked under it) vanishes whole-line while
+     *  `end`'s own line — its indentation included — is left for a later edit to collapse independently.
+     *  Otherwise (an inline `start`, or `end` on the same line) a plain `[start, end)` delete. Used by
+     *  `dropDirective` so it composes with a following `remove`. */
+    removeLeadingTo(start: number, end: number): void;
+    /** Delete the whole lines `[start, end)` touches — leading indentation through the trailing newline,
+     *  so nothing blank is left. With `collapseBlankBefore`, also absorb whole blank lines immediately
+     *  above (a separator before a dropped block). The explicit whole-line removal `remove({ wholeLines })`
+     *  asks for, where collapsing per node isn't enough. */
+    removeWholeLines(start: number, end: number, collapseBlankBefore?: boolean): void;
+    /** Register a dedent of the lifted range `[from, to)` by `dedent` columns: every continuation line
+     *  (the lines after the first) loses up to `dedent` leading-whitespace columns. Used by `unwrap`,
+     *  whose kept statements drop a level — their first line inherits the wrapper's indent for free,
+     *  but the rest keep their deeper source indent.
+     *
+     *  Deferred to {@link flush} rather than applied now so it yields (first-wins) to the codemod's own
+     *  edits on the kept nodes: a kept statement removed or replaced in the same pass wins the overlap,
+     *  so only lines that actually survive get dedented. A no-op unless `dedent` is positive. */
+    deferReindent(from: number, to: number, dedent: number): void;
+    /** Apply every {@link deferReindent}, once, after the codemod has recorded its explicit edits. */
+    flush(): void;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,KAAK,WAAW,EAAyF,MAAM,aAAa,CAAA;AAGrI;;;;;;;;;GASG;AACH,qBAAa,SAAS;;gBAQR,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAMxE,yEAAyE;IACzE,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B;4BACwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAM7C;sGACkG;IAClG,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAY1C,oFAAoF;IACpF,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3C;;;;;;;;;;;;;;;wGAeoG;IACpG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAuBlG;;;;;oEAKgE;IAChE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAOjD;;;4DAGwD;IACxD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,mBAAmB,UAAQ,GAAG,IAAI;IAO/E;;;;;;;iGAO6F;IAC7F,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7D,kGAAkG;IAClG,KAAK,IAAI,IAAI;CA+Ed"}