appease 0.0.1 → 0.0.3

package/dist/core/editorconfig.js

@@ -0,0 +1,99 @@
+import picomatch from "picomatch";
+/**
+ * Parse `.editorconfig` content into ordered sections. Pure.
+ * Throws on a structurally malformed line (case 3); properties we do not manage
+ * (indent_*, max_line_length, ...) are ignored (case 1).
+ */
+export function parseEditorconfig(content) {
+    let root = false;
+    const sections = [];
+    let current; // undefined = preamble (before any section)
+    content.split(/\r\n|\r|\n/).forEach((rawLine, index) => {
+        const line = rawLine.trim();
+        if (line === "" || line.startsWith("#") || line.startsWith(";"))
+            return;
+        if (line.startsWith("[")) {
+            if (!line.endsWith("]"))
+                throw new Error(`Malformed .editorconfig line ${index + 1}: "${rawLine}"`);
+            current = { matches: makeMatcher(line.slice(1, -1)), charset: undefined, trim: undefined, finalNewline: undefined };
+            sections.push(current);
+            return;
+        }
+        const eq = line.indexOf("=");
+        if (eq === -1)
+            throw new Error(`Malformed .editorconfig line ${index + 1}: "${rawLine}"`);
+        const key = line.slice(0, eq).trim().toLowerCase();
+        const value = line.slice(eq + 1).trim().toLowerCase();
+        if (current === undefined) {
+            if (key === "root")
+                root = value === "true";
+            return; // other preamble keys are not standard — ignored
+        }
+        applyProperty(current, key, value);
+    });
+    return { root, sections };
+}
+/** Resolve the effective stance for `path` (last matching section wins per property). */
+export function resolveEditorconfig(ec, path) {
+    let charset;
+    let trim;
+    let finalNewline;
+    for (const section of ec.sections) {
+        if (!section.matches(path))
+            continue;
+        if (section.charset !== undefined)
+            charset = section.charset;
+        if (section.trim !== undefined)
+            trim = section.trim;
+        if (section.finalNewline !== undefined)
+            finalNewline = section.finalNewline;
+    }
+    const unresolved = [];
+    let outCharset = "keep";
+    if (charset === "utf-8")
+        outCharset = "utf-8";
+    else if (charset === "utf-8-bom")
+        outCharset = "utf-8-bom";
+    else if (charset === "unrecognized")
+        unresolved.push("bom");
+    let outTrailing = "keep";
+    if (trim === true)
+        outTrailing = "trim";
+    else if (trim === "unrecognized")
+        unresolved.push("trailing");
+    let outFinalNewline = "keep";
+    if (finalNewline === true)
+        outFinalNewline = "ensure";
+    else if (finalNewline === "unrecognized")
+        unresolved.push("finalNewline");
+    return { charset: outCharset, trailing: outTrailing, finalNewline: outFinalNewline, unresolved };
+}
+function applyProperty(section, key, value) {
+    if (key === "charset") {
+        section.charset =
+            value === "utf-8" ? "utf-8" : value === "utf-8-bom" ? "utf-8-bom" : value === "unset" ? "unset" : "unrecognized";
+    }
+    else if (key === "trim_trailing_whitespace") {
+        section.trim = parseBool(value);
+    }
+    else if (key === "insert_final_newline") {
+        section.finalNewline = parseBool(value);
+    }
+    // else: a property we do not manage (indent_*, max_line_length, ...) — ignored (case 1)
+}
+function parseBool(value) {
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value === "unset")
+        return "unset";
+    return "unrecognized";
+}
+/** Build an editorconfig glob matcher: a slashless glob matches the basename at any depth; any `/` (even leading) anchors it. */
+function makeMatcher(glob) {
+    const basename = !glob.includes("/");
+    const pat = glob.startsWith("/") ? glob.slice(1) : glob;
+    return picomatch(pat, { dot: true, basename });
+}
+//# sourceMappingURL=editorconfig.js.map

package/dist/core/editorconfig.js.map

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

package/dist/core/gitattributes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * EOL stance for a path as declared by `.gitattributes`.
+ * - `auto`       : text, native EOL (the `* text=auto` default).
+ * - `lf` / `crlf`: a fixed EOL via `eol=`.
+ * - `binary`     : `-text` / `binary` — not normalized.
+ * - `unresolved` : a recognized key with an unrecognized value (case 2: skip + report).
+ */
+export type GitEol = "lf" | "crlf" | "auto" | "binary" | "unresolved";
+interface GitRule {
+    matches: (path: string) => boolean;
+    /** `text` attribute state; `binary` and `-text` both map to `unset`. */
+    text: "set" | "unset" | "auto" | "unrecognized" | undefined;
+    eol: "lf" | "crlf" | "unrecognized" | undefined;
+}
+export interface Gitattributes {
+    rules: GitRule[];
+}
+/**
+ * Parse `.gitattributes` content into ordered rules. Pure.
+ * Throws on a structurally malformed line (case 3); attributes we do not manage
+ * (filter, diff, linguist-*, ...) are ignored (case 1).
+ */
+export declare function parseGitattributes(content: string): Gitattributes;
+/** Resolve the effective EOL stance for `path` (last matching rule wins per attribute). */
+export declare function resolveGitEol(ga: Gitattributes, path: string): GitEol;
+export {};

package/dist/core/gitattributes.js

@@ -0,0 +1,70 @@
+import picomatch from "picomatch";
+/**
+ * Parse `.gitattributes` content into ordered rules. Pure.
+ * Throws on a structurally malformed line (case 3); attributes we do not manage
+ * (filter, diff, linguist-*, ...) are ignored (case 1).
+ */
+export function parseGitattributes(content) {
+    const rules = [];
+    content.split(/\r\n|\r|\n/).forEach((rawLine, index) => {
+        const line = rawLine.trim();
+        if (line === "" || line.startsWith("#"))
+            return;
+        const [pattern, ...attrs] = line.split(/\s+/);
+        let text;
+        let eol;
+        for (const attr of attrs) {
+            if (attr.startsWith("="))
+                throw new Error(`Malformed .gitattributes line ${index + 1}: "${rawLine}"`);
+            if (attr === "text")
+                text = "set";
+            else if (attr === "-text" || attr === "binary")
+                text = "unset"; // binary macro = -text -diff
+            else if (attr === "!text")
+                text = undefined; // unset the attribute: no effect
+            else if (attr === "text=auto")
+                text = "auto";
+            else if (attr.startsWith("text="))
+                text = "unrecognized";
+            else if (attr === "eol=lf")
+                eol = "lf";
+            else if (attr === "eol=crlf")
+                eol = "crlf";
+            else if (attr.startsWith("eol="))
+                eol = "unrecognized";
+            // else: an attribute we do not manage — ignored (case 1)
+        }
+        rules.push({ matches: makeMatcher(pattern), text, eol });
+    });
+    return { rules };
+}
+/** Resolve the effective EOL stance for `path` (last matching rule wins per attribute). */
+export function resolveGitEol(ga, path) {
+    let text;
+    let eol;
+    for (const rule of ga.rules) {
+        if (!rule.matches(path))
+            continue;
+        if (rule.text !== undefined)
+            text = rule.text;
+        if (rule.eol !== undefined)
+            eol = rule.eol;
+    }
+    if (text === "unset")
+        return "binary";
+    if (text === "unrecognized" || eol === "unrecognized")
+        return "unresolved";
+    if (eol === "lf")
+        return "lf";
+    if (eol === "crlf")
+        return "crlf";
+    return "auto";
+}
+/** Build a gitignore-style matcher: leading `/` anchors to root; a slashless pattern matches the basename. */
+function makeMatcher(pattern) {
+    const anchored = pattern.startsWith("/");
+    const pat = anchored ? pattern.slice(1) : pattern;
+    const basename = !anchored && !pat.includes("/");
+    return picomatch(pat, { dot: true, basename });
+}
+//# sourceMappingURL=gitattributes.js.map

package/dist/core/gitattributes.js.map

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

package/dist/core/merge.d.ts

@@ -0,0 +1,39 @@
+import type { DeviationAxis, FormatReport } from "./types.js";
+/** One audited file with findings, ready to turn into config exceptions. */
+export interface AuditedFile {
+    path: string;
+    report: FormatReport;
+    deviations: DeviationAxis[];
+}
+/** A `.editorconfig` exception: a section locking some axes to "don't enforce". */
+export interface EditorconfigException {
+    pattern: string;
+    properties: string[];
+}
+/** A `.gitattributes` exception: a rule line fixing or locking the EOL. */
+export interface GitattributesException {
+    pattern: string;
+    attrs: string;
+}
+export interface ConfigExceptions {
+    editorconfig: EditorconfigException[];
+    gitattributes: GitattributesException[];
+}
+/**
+ * Turn audited deviations into the concrete config exceptions that `--adapt-configs`
+ * records, so a later `--fix-format` changes nothing. EOL is routed to `.gitattributes`
+ * using the file's actual ending; a mixed/lone-CR file goes `-text` (byte-for-byte) and
+ * is therefore protected whole, so it gets no `.editorconfig` exception.
+ */
+export declare function buildExceptions(files: AuditedFile[]): ConfigExceptions;
+/**
+ * Append `.editorconfig` exception sections to the existing content, preserving
+ * everything already there. Idempotent: a pattern that already has a section is
+ * skipped. New sections use the file's own EOL.
+ */
+export declare function mergeEditorconfig(existing: string, exceptions: EditorconfigException[]): string;
+/**
+ * Append `.gitattributes` exception lines to the existing content, preserving
+ * everything already there. Idempotent: a pattern that already has a rule is skipped.
+ */
+export declare function mergeGitattributes(existing: string, exceptions: GitattributesException[]): string;

package/dist/core/merge.js

@@ -0,0 +1,98 @@
+/** The "don't enforce" value written for each editorconfig-owned axis. */
+const EDITORCONFIG_PROPERTY = {
+    bom: "charset = unset",
+    trailing: "trim_trailing_whitespace = false",
+    finalNewline: "insert_final_newline = false",
+};
+/**
+ * Turn audited deviations into the concrete config exceptions that `--adapt-configs`
+ * records, so a later `--fix-format` changes nothing. EOL is routed to `.gitattributes`
+ * using the file's actual ending; a mixed/lone-CR file goes `-text` (byte-for-byte) and
+ * is therefore protected whole, so it gets no `.editorconfig` exception.
+ */
+export function buildExceptions(files) {
+    const editorconfig = [];
+    const gitattributes = [];
+    for (const file of files) {
+        let binary = false;
+        if (file.deviations.includes("eol")) {
+            const attrs = eolAttrs(file.report);
+            gitattributes.push({ pattern: file.path, attrs });
+            binary = attrs === "-text";
+        }
+        if (!binary) {
+            const properties = file.deviations.filter(isEditorconfigAxis).map((axis) => EDITORCONFIG_PROPERTY[axis]);
+            if (properties.length > 0)
+                editorconfig.push({ pattern: file.path, properties });
+        }
+    }
+    return { editorconfig, gitattributes };
+}
+/** The `.gitattributes` attributes that lock a file's current EOL. */
+function eolAttrs(report) {
+    if (report.hasLf && !report.hasCrlf && !report.hasCr)
+        return "text eol=lf";
+    if (report.hasCrlf && !report.hasLf && !report.hasCr)
+        return "text eol=crlf";
+    return "-text"; // mixed or lone CR: no clean eol=, lock byte-for-byte
+}
+function isEditorconfigAxis(axis) {
+    return axis !== "eol";
+}
+/**
+ * Append `.editorconfig` exception sections to the existing content, preserving
+ * everything already there. Idempotent: a pattern that already has a section is
+ * skipped. New sections use the file's own EOL.
+ */
+export function mergeEditorconfig(existing, exceptions) {
+    const present = sectionPatterns(existing);
+    const toAdd = exceptions.filter((exception) => !present.has(exception.pattern));
+    if (toAdd.length === 0)
+        return existing;
+    const eol = detectEol(existing);
+    const sections = toAdd.map((exception) => [`[${exception.pattern}]`, ...exception.properties].join(eol));
+    return append(existing, sections.join(eol + eol), eol);
+}
+/**
+ * Append `.gitattributes` exception lines to the existing content, preserving
+ * everything already there. Idempotent: a pattern that already has a rule is skipped.
+ */
+export function mergeGitattributes(existing, exceptions) {
+    const present = gitattributesPatterns(existing);
+    const toAdd = exceptions.filter((exception) => !present.has(exception.pattern));
+    if (toAdd.length === 0)
+        return existing;
+    const eol = detectEol(existing);
+    const lines = toAdd.map((exception) => `${exception.pattern} ${exception.attrs}`);
+    return append(existing, lines.join(eol), eol);
+}
+/** Patterns of existing `[glob]` sections. */
+function sectionPatterns(content) {
+    const patterns = new Set();
+    for (const raw of content.split(/\r\n|\r|\n/)) {
+        const line = raw.trim();
+        if (line.startsWith("[") && line.endsWith("]"))
+            patterns.add(line.slice(1, -1));
+    }
+    return patterns;
+}
+/** Patterns (first token) of existing `.gitattributes` rules. */
+function gitattributesPatterns(content) {
+    const patterns = new Set();
+    for (const raw of content.split(/\r\n|\r|\n/)) {
+        const line = raw.trim();
+        if (line !== "" && !line.startsWith("#"))
+            patterns.add(line.split(/\s+/)[0]);
+    }
+    return patterns;
+}
+/** The file's existing EOL (LF/CRLF), defaulting to LF. */
+function detectEol(content) {
+    return content.match(/\r\n|\n/)?.[0] ?? "\n";
+}
+/** Append `addition` after the existing content, separated by a blank line, ending with one EOL. */
+function append(existing, addition, eol) {
+    const base = existing.replace(/(?:\r\n|\r|\n)*$/, "");
+    return (base === "" ? "" : base + eol + eol) + addition + eol;
+}
+//# sourceMappingURL=merge.js.map

package/dist/core/merge.js.map

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

package/dist/core/normalize.d.ts

@@ -0,0 +1,13 @@
+import type { NormalizeOptions } from "./types.js";
+/**
+ * Normalization core: take a file's already-decoded content plus the options
+ * resolved for that file, and return the normalized content. Pure and side-effect free.
+ *
+ * Normalizes BOM, EOL (e.g. fixing a mixed file), trailing whitespace and the
+ * final newline. EOL is included so the workflow is complete: when the audit
+ * finds an EOL anomaly, the normalizer can fix it.
+ *
+ * Returns the normalized content; the caller detects whether it changed by
+ * comparing against the input. Idempotent: running twice produces the same result.
+ */
+export declare function normalizeText(content: string, options: NormalizeOptions): string;

package/dist/core/normalize.js

@@ -0,0 +1,58 @@
+/** UTF-8 BOM code point. */
+const BOM = String.fromCharCode(0xfeff);
+/**
+ * Normalization core: take a file's already-decoded content plus the options
+ * resolved for that file, and return the normalized content. Pure and side-effect free.
+ *
+ * Normalizes BOM, EOL (e.g. fixing a mixed file), trailing whitespace and the
+ * final newline. EOL is included so the workflow is complete: when the audit
+ * finds an EOL anomaly, the normalizer can fix it.
+ *
+ * Returns the normalized content; the caller detects whether it changed by
+ * comparing against the input. Idempotent: running twice produces the same result.
+ */
+export function normalizeText(content, options) {
+    let result = applyEol(content, options.eol);
+    if (options.trailing === "trim")
+        result = trimTrailing(result);
+    if (options.finalNewline === "ensure")
+        result = ensureFinalNewline(result, options.eol);
+    result = applyBom(result, options.bom);
+    return result;
+}
+/** Normalize every line ending to a single style (CRLF and lone CR both collapse to LF first). */
+function applyEol(content, eol) {
+    if (eol === "keep")
+        return content;
+    const lf = content.replace(/\r\n?/g, "\n");
+    return eol === "crlf" ? lf.replace(/\n/g, "\r\n") : lf;
+}
+/** Remove horizontal whitespace at the end of every line (and at end of file). */
+function trimTrailing(content) {
+    return content.replace(/[ \t]+(?=\r|\n|$)/g, "");
+}
+/** Collapse the trailing newlines to exactly one (leaving a truly empty file empty). */
+function ensureFinalNewline(content, eol) {
+    if (content === "")
+        return content;
+    const trailing = content.match(/(\r\n|\r|\n)+$/);
+    const body = trailing ? content.slice(0, content.length - trailing[0].length) : content;
+    const newline = eol === "crlf"
+        ? "\r\n"
+        : eol === "lf"
+            ? "\n"
+            : trailing
+                ? trailing[1] // keep: reuse the file's existing final ending
+                : (content.match(/\r\n|\r|\n/)?.[0] ?? "\n"); // keep with no trailing newline: infer
+    return body + newline;
+}
+/** Add, remove or keep the leading UTF-8 BOM. */
+function applyBom(content, bom) {
+    const hasBom = content.charCodeAt(0) === 0xfeff;
+    if (bom === "add")
+        return hasBom ? content : BOM + content;
+    if (bom === "remove")
+        return hasBom ? content.slice(1) : content;
+    return content;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/core/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/core/normalize.ts"],"names":[],"mappings":"AAEA,4BAA4B;AAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAyB;IACtE,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM;QAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,YAAY,KAAK,QAAQ;QAAE,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACxF,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kGAAkG;AAClG,SAAS,QAAQ,CAAC,OAAe,EAAE,GAA4B;IAC7D,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC;IACnC,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,kFAAkF;AAClF,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,wFAAwF;AACxF,SAAS,kBAAkB,CAAC,OAAe,EAAE,GAA4B;IACvE,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxF,MAAM,OAAO,GACX,GAAG,KAAK,MAAM;QACZ,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,GAAG,KAAK,IAAI;YACZ,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,QAAQ;gBACR,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,+CAA+C;gBAC7D,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,uCAAuC;IAC7F,OAAO,IAAI,GAAG,OAAO,CAAC;AACxB,CAAC;AAED,iDAAiD;AACjD,SAAS,QAAQ,CAAC,OAAe,EAAE,GAA4B;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IAChD,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;IAC3D,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,102 @@
+/** Final-newline state of a file. */
+export type FinalNewline = "present" | "missing" | "multiple";
+/** Result of analyzing one file's already-decoded text. Pure, side-effect free. */
+export interface FormatReport {
+    /** File has no content at all. */
+    empty: boolean;
+    /** UTF-8 BOM present at the start of the content. */
+    hasBom: boolean;
+    /** At least one CRLF line ending. */
+    hasCrlf: boolean;
+    /** At least one lone-LF line ending (LF not preceded by CR). */
+    hasLf: boolean;
+    /** At least one lone-CR line ending (CR not followed by LF; classic pre-OSX Mac). */
+    hasCr: boolean;
+    /** At least one line with trailing whitespace. */
+    hasTrailingSpaces: boolean;
+    /** Final-newline state. */
+    finalNewline: FinalNewline;
+}
+/** Resolved per-file options driving the pure normalizer. */
+export interface NormalizeOptions {
+    /** Add, remove, or leave the UTF-8 BOM. */
+    bom: "add" | "remove" | "keep";
+    /** Normalize line endings to a single style, or leave as-is. */
+    eol: "lf" | "crlf" | "keep";
+    /** Trim trailing whitespace, or leave it. */
+    trailing: "trim" | "keep";
+    /** Ensure exactly one final newline, or leave as-is. */
+    finalNewline: "ensure" | "keep";
+}
+/**
+ * Options resolved for a single file from the project config. Aligned with the
+ * normalizer's actions, so `--fix-format` can drive `normalizeText` directly.
+ */
+export interface ResolvedFileConfig {
+    /** From `.editorconfig` charset: `utf-8-bom`->add, `utf-8`->remove, unset/keep->keep. */
+    bom: "add" | "remove" | "keep";
+    /** From `.gitattributes` (or `auto` for the `text=auto` default; `binary` = not normalized). */
+    eol: "lf" | "crlf" | "auto" | "binary";
+    trailing: "trim" | "keep";
+    finalNewline: "ensure" | "keep";
+    /** Axes governed by an unrecognized config value (case 2): skip + report, never normalize. */
+    unresolved: DeviationAxis[];
+}
+/** Raw, unparsed contents of the three config sources. `null` = file absent (vs `""` = present but empty). */
+export interface RawConfigs {
+    editorconfig: string | null;
+    gitattributes: string | null;
+    vscodeSettings: string | null;
+}
+/** Parsed, not-yet-resolved project configuration. */
+export interface ProjectConfig {
+    /** Whether each config source was found on disk. */
+    present: {
+        editorconfig: boolean;
+        gitattributes: boolean;
+        vscodeSettings: boolean;
+    };
+    /** Resolve the effective options for a given repo-relative path. */
+    resolve(path: string): ResolvedFileConfig;
+}
+/** Axis along which a file deviates from its resolved config. */
+export type DeviationAxis = "bom" | "eol" | "trailing" | "finalNewline";
+/** A single file's findings against the resolved config (only files with findings are listed). */
+export interface FileAudit {
+    path: string;
+    /** Axes where the file differs from what the config asks for. */
+    deviations: DeviationAxis[];
+    /** Axes governed by an unrecognized config value (case 2): not evaluated, reported as-is. */
+    unresolved: DeviationAxis[];
+}
+/** Full audit result. `--audit` prints this as canonical JSON. */
+export interface AuditResult {
+    /** Analyzed files that deviate from their resolved config (conforming files are omitted). */
+    findings: FileAudit[];
+    /** Files not analyzed (binary / `-text` / non-UTF-8), with the reason. */
+    notAnalyzed: {
+        path: string;
+        reason: "binary-extension" | "binary-content" | "gitattributes-notext" | "non-utf8";
+    }[];
+}
+export type RunMode = "audit" | "add-config-defaults" | "adapt-configs" | "fix-format";
+/** Options for a full appease run (CLI -> public API). */
+export interface RunOptions {
+    mode: RunMode;
+    /** Repository root to operate on. */
+    cwd: string;
+    /** Simulate writes; report what would change but touch nothing. */
+    dryRun: boolean;
+}
+/** Outcome of a run: which files were created/modified, plus mode-specific payload. */
+export interface RunReport {
+    mode: RunMode;
+    /** Whether disk was actually touched (false under `--dry-run`). */
+    dryRun: boolean;
+    created: string[];
+    modified: string[];
+    /** Files considered but left untouched (e.g. a config that already existed). */
+    unchanged: string[];
+    /** Present for `--audit`. */
+    audit?: AuditResult;
+}

package/dist/core/types.js

@@ -0,0 +1,4 @@
+// Strongly-typed contracts for appease (brand: "normalificador").
+// No `any`. Every type here is shared between the pure core and the orchestration (CLI).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,yFAAyF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { RunOptions, RunReport } from "./core/types.js";
+export * from "./core/types.js";
+export { analyzeContent } from "./core/analyze.js";
+export { normalizeText } from "./core/normalize.js";
+export { interpretConfigs, defaultEditorconfig, defaultGitattributes } from "./core/configs.js";
+export { readRawConfigs, writeEditorconfig, writeGitattributes } from "./io/configs.js";
+export { audit } from "./core/audit.js";
+/**
+ * Run a full appease operation according to `options.mode`:
+ * - `audit`               : report deviations only (no writes).
+ * - `add-config-defaults` : write pure-default configs (no inspection).
+ * - `adapt-configs`       : write/adapt configs to reflect the repo's reality.
+ * - `fix-format`          : normalize files (BOM/trailing/newline; EOL via Git).
+ *
+ * Orchestrates the effects (git ls-files, file I/O) around the pure core.
+ */
+export declare function runAppease(options: RunOptions): Promise<RunReport>;