ts-semver-checks-core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ardenden
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# ts-semver-checks-core
+
+The pure library behind [`ts-semver-checks`](https://www.npmjs.com/package/ts-semver-checks):
+extract, diff, and classify the exported type surface of a TypeScript package.
+
+```ts
+import { extractSurface, checkSurfaces } from "ts-semver-checks-core";
+
+const before = extractSurface({ entryPoint: "baseline/index.d.ts" });
+const after = extractSurface({ entryPoint: "src/index.ts" });
+const { level, findings } = checkSurfaces(before, after);
+// level: "major" | "minor" | "patch"
+```
+
+See the [monorepo README](https://github.com/ardenden/ts-semver-checks#readme) for the
+surface model, rule set, and known limitations.
+
+MIT © ardenden

package/dist/check.d.ts

@@ -0,0 +1,13 @@
+import type { ApiSurface, SemverLevel } from "./model.js";
+import { type Finding } from "./findings.js";
+export interface CheckResult {
+    /** The highest-impact semver level across all findings. */
+    level: SemverLevel;
+    /** All findings, sorted most-severe first. */
+    findings: Finding[];
+}
+/**
+ * Convenience: diff two surfaces and classify the result in one step.
+ */
+export declare function checkSurfaces(before: ApiSurface, after: ApiSurface): CheckResult;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,KAAK,EAAE,WAAW,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,CAGhF"}

package/dist/check.js

@@ -0,0 +1,10 @@
+import { diffSurfaces } from "./diff.js";
+import { classify, sortFindings } from "./findings.js";
+/**
+ * Convenience: diff two surfaces and classify the result in one step.
+ */
+export function checkSurfaces(before, after) {
+    const findings = sortFindings(diffSurfaces(before, after));
+    return { level: classify(findings), findings };
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AASrE;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,KAAiB;IACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;AACjD,CAAC"}

package/dist/diff.d.ts

@@ -0,0 +1,14 @@
+import type { ApiSurface } from "./model.js";
+import type { Finding } from "./findings.js";
+/**
+ * Compare two extracted surfaces and produce a list of findings.
+ *
+ * LIMITATION: types are compared as normalized strings, not via the compiler's
+ * assignability relation. So "did this type widen or narrow?" cannot be answered
+ * precisely across two independent builds. Where a change *could* be breaking, we
+ * classify it as `major` — a checker meant to fail CI should err toward safety.
+ * Cases where structure alone proves the direction (adding an optional param,
+ * relaxing `required` to `optional`) are classified precisely.
+ */
+export declare function diffSurfaces(before: ApiSurface, after: ApiSurface): Finding[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAYX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,EAAE,CA4C7E"}

package/dist/diff.js

@@ -0,0 +1,474 @@
+/**
+ * Compare two extracted surfaces and produce a list of findings.
+ *
+ * LIMITATION: types are compared as normalized strings, not via the compiler's
+ * assignability relation. So "did this type widen or narrow?" cannot be answered
+ * precisely across two independent builds. Where a change *could* be breaking, we
+ * classify it as `major` — a checker meant to fail CI should err toward safety.
+ * Cases where structure alone proves the direction (adding an optional param,
+ * relaxing `required` to `optional`) are classified precisely.
+ */
+export function diffSurfaces(before, after) {
+    const findings = [];
+    const beforeNames = new Set(Object.keys(before.exports));
+    const afterNames = new Set(Object.keys(after.exports));
+    for (const name of beforeNames) {
+        if (!afterNames.has(name)) {
+            findings.push({
+                level: "major",
+                code: "export.removed",
+                path: name,
+                message: `Exported symbol '${name}' was removed.`,
+            });
+        }
+    }
+    for (const name of afterNames) {
+        if (!beforeNames.has(name)) {
+            findings.push({
+                level: "minor",
+                code: "export.added",
+                path: name,
+                message: `New exported symbol '${name}' was added.`,
+            });
+        }
+    }
+    for (const name of beforeNames) {
+        if (!afterNames.has(name))
+            continue;
+        const oldSym = before.exports[name];
+        const newSym = after.exports[name];
+        if (oldSym.kind !== newSym.kind) {
+            findings.push({
+                level: "major",
+                code: "export.kindChanged",
+                path: name,
+                message: `'${name}' changed from ${oldSym.kind} to ${newSym.kind}.`,
+            });
+            continue;
+        }
+        diffSymbol(name, oldSym, newSym, findings);
+    }
+    return findings;
+}
+function diffSymbol(name, before, after, findings) {
+    switch (before.kind) {
+        case "function":
+            diffFunction(name, before, after, findings);
+            break;
+        case "interface":
+            diffInterface(name, before, after, findings);
+            break;
+        case "class":
+            diffClass(name, before, after, findings);
+            break;
+        case "enum":
+            diffEnum(name, before, after, findings);
+            break;
+        case "typeAlias":
+            diffTypeAlias(name, before, after, findings);
+            break;
+        case "variable":
+            diffVariable(name, before, after, findings);
+            break;
+    }
+}
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+function renderSignature(sig) {
+    const tp = sig.typeParameters.length > 0
+        ? `<${sig.typeParameters.map(renderTypeParam).join(", ")}>`
+        : "";
+    const params = sig.parameters
+        .map((p) => `${p.rest ? "..." : ""}${p.name}${p.optional ? "?" : ""}: ${p.type}`)
+        .join(", ");
+    return `${tp}(${params}) => ${sig.returnType}`;
+}
+function renderTypeParam(tp) {
+    let s = tp.name;
+    if (tp.constraint)
+        s += ` extends ${tp.constraint}`;
+    if (tp.default)
+        s += ` = ${tp.default}`;
+    return s;
+}
+function diffTypeParameters(path, before, after, findings) {
+    const beforeStr = before.map(renderTypeParam).join(", ");
+    const afterStr = after.map(renderTypeParam).join(", ");
+    if (beforeStr === afterStr)
+        return;
+    if (after.length > before.length && after.slice(before.length).every((tp) => tp.default)) {
+        // Added type parameters all have defaults -> existing usages still compile.
+        findings.push({
+            level: "minor",
+            code: "generics.typeParamAdded",
+            path,
+            message: `Type parameters added with defaults: <${afterStr}>.`,
+        });
+        return;
+    }
+    findings.push({
+        level: "major",
+        code: "generics.changed",
+        path,
+        message: `Type parameters changed from <${beforeStr}> to <${afterStr}>.`,
+    });
+}
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+function diffFunction(name, before, after, findings) {
+    // Single signature on each side is the common case; diff it at parameter level
+    // so we can distinguish "added optional param" (minor) from "added required".
+    if (before.signatures.length === 1 && after.signatures.length === 1) {
+        diffSignature(name, before.signatures[0], after.signatures[0], findings, "param");
+        return;
+    }
+    // Overloaded: compare the set of rendered signatures.
+    const beforeSigs = new Map(before.signatures.map((s) => [renderSignature(s), s]));
+    const afterSigs = new Set(after.signatures.map(renderSignature));
+    for (const [rendered] of beforeSigs) {
+        if (!afterSigs.has(rendered)) {
+            findings.push({
+                level: "major",
+                code: "overload.removedOrChanged",
+                path: name,
+                message: `Call signature no longer present: ${rendered}`,
+            });
+        }
+    }
+    for (const rendered of afterSigs) {
+        if (!beforeSigs.has(rendered)) {
+            findings.push({
+                level: "minor",
+                code: "overload.added",
+                path: name,
+                message: `New call signature added: ${rendered}`,
+            });
+        }
+    }
+}
+/**
+ * Diff two call signatures at the parameter level.
+ * `role` distinguishes plain parameters from constructor parameters for messaging.
+ */
+function diffSignature(path, before, after, findings, role) {
+    diffTypeParameters(path, before.typeParameters, after.typeParameters, findings);
+    const max = Math.max(before.parameters.length, after.parameters.length);
+    for (let i = 0; i < max; i++) {
+        const b = before.parameters[i];
+        const a = after.parameters[i];
+        const paramPath = `${path}.${role === "ctor" ? "ctor." : ""}params[${i}]`;
+        if (b && !a) {
+            findings.push({
+                level: "major",
+                code: "param.removed",
+                path: paramPath,
+                message: `Parameter '${b.name}' was removed.`,
+            });
+            continue;
+        }
+        if (!b && a) {
+            if (a.optional || a.rest) {
+                findings.push({
+                    level: "minor",
+                    code: "param.addedOptional",
+                    path: paramPath,
+                    message: `New optional parameter '${a.name}: ${a.type}' was added.`,
+                });
+            }
+            else {
+                findings.push({
+                    level: "major",
+                    code: "param.addedRequired",
+                    path: paramPath,
+                    message: `New required parameter '${a.name}: ${a.type}' was added.`,
+                });
+            }
+            continue;
+        }
+        if (b && a)
+            diffParameter(paramPath, b, a, findings);
+    }
+    if (before.returnType !== after.returnType) {
+        findings.push({
+            level: "major",
+            code: "returnType.changed",
+            path: `${path}.returnType`,
+            message: `Return type changed from '${before.returnType}' to '${after.returnType}'.`,
+        });
+    }
+}
+function diffParameter(path, before, after, findings) {
+    if (before.type !== after.type) {
+        findings.push({
+            level: "major",
+            code: "param.typeChanged",
+            path,
+            message: `Parameter '${before.name}' type changed from '${before.type}' to '${after.type}'.`,
+        });
+    }
+    if (before.optional && !after.optional) {
+        findings.push({
+            level: "major",
+            code: "param.madeRequired",
+            path,
+            message: `Parameter '${before.name}' changed from optional to required.`,
+        });
+    }
+    else if (!before.optional && after.optional) {
+        findings.push({
+            level: "minor",
+            code: "param.madeOptional",
+            path,
+            message: `Parameter '${before.name}' changed from required to optional.`,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Interfaces & classes (structural members)
+// ---------------------------------------------------------------------------
+function diffInterface(name, before, after, findings) {
+    diffTypeParameters(name, before.typeParameters, after.typeParameters, findings);
+    // For interfaces, adding a required member is breaking (implementers/object
+    // literals must now provide it).
+    diffProperties(name, before.properties, after.properties, findings, "interface");
+    diffMethods(name, before.methods, after.methods, findings, "interface");
+}
+function diffClass(name, before, after, findings) {
+    diffTypeParameters(name, before.typeParameters, after.typeParameters, findings);
+    if (!before.abstract && after.abstract) {
+        findings.push({
+            level: "major",
+            code: "class.madeAbstract",
+            path: name,
+            message: `Class '${name}' was made abstract and can no longer be instantiated directly.`,
+        });
+    }
+    else if (before.abstract && !after.abstract) {
+        findings.push({
+            level: "minor",
+            code: "class.madeConcrete",
+            path: name,
+            message: `Class '${name}' is no longer abstract.`,
+        });
+    }
+    // For classes, adding a public member is non-breaking (consumers don't implement
+    // classes structurally in practice); removing/changing is breaking.
+    diffProperties(name, before.properties, after.properties, findings, "class");
+    diffMethods(name, before.methods, after.methods, findings, "class");
+    diffConstructors(name, before.constructors, after.constructors, findings);
+}
+function diffConstructors(name, before, after, findings) {
+    if (before.length === 0 && after.length === 0)
+        return;
+    // Compare the primary construct signature at parameter level.
+    const b = before[0];
+    const a = after[0];
+    if (b && a) {
+        diffSignature(name, b, a, findings, "ctor");
+    }
+    else if (b && !a) {
+        findings.push({
+            level: "major",
+            code: "constructor.removed",
+            path: `${name}.ctor`,
+            message: `Constructor of '${name}' was removed.`,
+        });
+    }
+}
+function diffProperties(owner, before, after, findings, kind) {
+    for (const [propName, b] of Object.entries(before)) {
+        const a = after[propName];
+        const path = `${owner}.${propName}`;
+        if (!a) {
+            findings.push({
+                level: "major",
+                code: "property.removed",
+                path,
+                message: `Property '${propName}' was removed from '${owner}'.`,
+            });
+            continue;
+        }
+        if (b.type !== a.type) {
+            findings.push({
+                level: "major",
+                code: "property.typeChanged",
+                path,
+                message: `Property '${propName}' type changed from '${b.type}' to '${a.type}'.`,
+            });
+        }
+        if (b.optional && !a.optional) {
+            findings.push({
+                level: "major",
+                code: "property.madeRequired",
+                path,
+                message: `Property '${propName}' changed from optional to required.`,
+            });
+        }
+        else if (!b.optional && a.optional) {
+            findings.push({
+                level: "minor",
+                code: "property.madeOptional",
+                path,
+                message: `Property '${propName}' changed from required to optional.`,
+            });
+        }
+        if (!b.readonly && a.readonly) {
+            findings.push({
+                level: "major",
+                code: "property.madeReadonly",
+                path,
+                message: `Property '${propName}' was made readonly.`,
+            });
+        }
+        else if (b.readonly && !a.readonly) {
+            findings.push({
+                level: "minor",
+                code: "property.readonlyRemoved",
+                path,
+                message: `Property '${propName}' is no longer readonly.`,
+            });
+        }
+    }
+    for (const [propName, a] of Object.entries(after)) {
+        if (before[propName])
+            continue;
+        const path = `${owner}.${propName}`;
+        if (kind === "class") {
+            findings.push({
+                level: "minor",
+                code: "property.added",
+                path,
+                message: `New property '${propName}: ${a.type}' was added to class '${owner}'.`,
+            });
+        }
+        else if (a.optional) {
+            findings.push({
+                level: "minor",
+                code: "property.addedOptional",
+                path,
+                message: `New optional property '${propName}?: ${a.type}' was added.`,
+            });
+        }
+        else {
+            findings.push({
+                level: "major",
+                code: "property.addedRequired",
+                path,
+                message: `New required property '${propName}: ${a.type}' was added to interface '${owner}'.`,
+            });
+        }
+    }
+}
+function diffMethods(owner, before, after, findings, kind) {
+    for (const [methodName, b] of Object.entries(before)) {
+        const a = after[methodName];
+        const path = `${owner}.${methodName}()`;
+        if (!a) {
+            findings.push({
+                level: "major",
+                code: "method.removed",
+                path,
+                message: `Method '${methodName}' was removed from '${owner}'.`,
+            });
+            continue;
+        }
+        const beforeStr = b.map(renderSignature).join(" | ");
+        const afterStr = a.map(renderSignature).join(" | ");
+        if (beforeStr !== afterStr) {
+            findings.push({
+                level: "major",
+                code: "method.signatureChanged",
+                path,
+                message: `Method '${methodName}' signature changed from '${beforeStr}' to '${afterStr}'.`,
+            });
+        }
+    }
+    for (const methodName of Object.keys(after)) {
+        if (before[methodName])
+            continue;
+        const path = `${owner}.${methodName}()`;
+        if (kind === "class") {
+            findings.push({
+                level: "minor",
+                code: "method.added",
+                path,
+                message: `New method '${methodName}' was added to class '${owner}'.`,
+            });
+        }
+        else {
+            findings.push({
+                level: "major",
+                code: "method.addedRequired",
+                path,
+                message: `New method '${methodName}' was added to interface '${owner}' (implementers must provide it).`,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Enums, type aliases, variables
+// ---------------------------------------------------------------------------
+function diffEnum(name, before, after, findings) {
+    if (before.const !== after.const) {
+        findings.push({
+            level: "major",
+            code: "enum.constnessChanged",
+            path: name,
+            message: `Enum '${name}' ${after.const ? "became" : "is no longer"} a const enum.`,
+        });
+    }
+    for (const [member, value] of Object.entries(before.members)) {
+        const newValue = after.members[member];
+        const path = `${name}.${member}`;
+        if (newValue === undefined) {
+            findings.push({
+                level: "major",
+                code: "enum.memberRemoved",
+                path,
+                message: `Enum member '${member}' was removed.`,
+            });
+        }
+        else if (newValue !== value) {
+            findings.push({
+                level: "major",
+                code: "enum.valueChanged",
+                path,
+                message: `Enum member '${member}' value changed from '${value}' to '${newValue}'.`,
+            });
+        }
+    }
+    for (const member of Object.keys(after.members)) {
+        if (before.members[member] !== undefined)
+            continue;
+        findings.push({
+            level: "minor",
+            code: "enum.memberAdded",
+            path: `${name}.${member}`,
+            message: `New enum member '${member}' was added.`,
+        });
+    }
+}
+function diffTypeAlias(name, before, after, findings) {
+    diffTypeParameters(name, before.typeParameters, after.typeParameters, findings);
+    if (before.type !== after.type) {
+        findings.push({
+            level: "major",
+            code: "typeAlias.changed",
+            path: name,
+            message: `Type alias '${name}' changed from '${before.type}' to '${after.type}'.`,
+        });
+    }
+}
+function diffVariable(name, before, after, findings) {
+    if (before.type !== after.type) {
+        findings.push({
+            level: "major",
+            code: "variable.typeChanged",
+            path: name,
+            message: `Exported value '${name}' type changed from '${before.type}' to '${after.type}'.`,
+        });
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/extract.d.ts

@@ -0,0 +1,22 @@
+import ts from "typescript";
+import type { ApiSurface } from "./model.js";
+export interface ExtractOptions {
+    /** Path to the entry file (`.ts` or `.d.ts`) whose exports form the surface. */
+    entryPoint: string;
+    /** Compiler options to use. Sensible strict defaults are applied when omitted. */
+    compilerOptions?: ts.CompilerOptions;
+    /**
+     * Pre-built program to reuse (e.g. one created over a whole package). When
+     * provided, `compilerOptions` is ignored.
+     */
+    program?: ts.Program;
+}
+/**
+ * Extract the exported type surface reachable from a single entry point.
+ *
+ * NOTE: Types are captured as normalized strings produced by the compiler's
+ * printer. Diffing therefore compares structure, not assignability — see
+ * `diff.ts` for how that shapes classification and its known limitations.
+ */
+export declare function extractSurface(options: ExtractOptions): ApiSurface;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EACV,UAAU,EAYX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC;CACtB;AAiBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CA2ClE"}

package/dist/extract.js

@@ -0,0 +1,256 @@
+import * as path from "node:path";
+import ts from "typescript";
+// NOTE: deliberately NOT using UseFullyQualifiedType — it renders local types
+// as their absolute import path (which differs between two builds/checkouts of
+// the same package), producing false "type changed" findings.
+const TYPE_FORMAT_FLAGS = ts.TypeFormatFlags.NoTruncation | ts.TypeFormatFlags.WriteArrayAsGenericType;
+const DEFAULT_COMPILER_OPTIONS = {
+    target: ts.ScriptTarget.ES2022,
+    module: ts.ModuleKind.NodeNext,
+    moduleResolution: ts.ModuleResolutionKind.NodeNext,
+    strict: true,
+    skipLibCheck: true,
+    noEmit: true,
+};
+/**
+ * Extract the exported type surface reachable from a single entry point.
+ *
+ * NOTE: Types are captured as normalized strings produced by the compiler's
+ * printer. Diffing therefore compares structure, not assignability — see
+ * `diff.ts` for how that shapes classification and its known limitations.
+ */
+export function extractSurface(options) {
+    const entryPoint = path.resolve(options.entryPoint);
+    const program = options.program ??
+        ts.createProgram({
+            rootNames: [entryPoint],
+            options: { ...DEFAULT_COMPILER_OPTIONS, ...options.compilerOptions },
+        });
+    const checker = program.getTypeChecker();
+    const sourceFile = program.getSourceFile(entryPoint);
+    if (!sourceFile) {
+        throw new Error(`Could not load entry point as a source file: ${entryPoint}`);
+    }
+    const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+    if (!moduleSymbol) {
+        // A source file with no exports still yields an empty, valid surface.
+        return { entryPoint: options.entryPoint, exports: {} };
+    }
+    const exports = {};
+    for (const exportSymbol of checker.getExportsOfModule(moduleSymbol)) {
+        const resolved = resolveAlias(exportSymbol, checker);
+        const serialized = serializeSymbol(exportSymbol.getName(), resolved, checker);
+        if (serialized) {
+            exports[exportSymbol.getName()] = serialized;
+        }
+    }
+    // CommonJS `export = X` (TypeScript export-assignment) is not returned by
+    // getExportsOfModule; it lives on the module symbol under "export=". This is
+    // how packages like `mri` expose their main function.
+    const exportEquals = moduleSymbol.exports?.get("export=");
+    if (exportEquals) {
+        const resolved = resolveAlias(exportEquals, checker);
+        const serialized = serializeSymbol("export=", resolved, checker);
+        if (serialized) {
+            exports["export="] = serialized;
+        }
+    }
+    return { entryPoint: options.entryPoint, exports };
+}
+function resolveAlias(symbol, checker) {
+    return symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
+}
+function serializeSymbol(name, symbol, checker) {
+    const flags = symbol.getFlags();
+    if (flags & ts.SymbolFlags.TypeAlias)
+        return serializeTypeAlias(name, symbol, checker);
+    if (flags & ts.SymbolFlags.Interface)
+        return serializeInterface(name, symbol, checker);
+    if (flags & ts.SymbolFlags.Class)
+        return serializeClass(name, symbol, checker);
+    if (flags & ts.SymbolFlags.Enum || flags & ts.SymbolFlags.ConstEnum)
+        return serializeEnum(name, symbol, checker);
+    if (flags & ts.SymbolFlags.Function)
+        return serializeFunction(name, symbol, checker);
+    if (flags & (ts.SymbolFlags.Variable | ts.SymbolFlags.BlockScopedVariable))
+        return serializeVariable(name, symbol, checker);
+    return undefined;
+}
+function firstDeclaration(symbol) {
+    return symbol.getDeclarations()?.[0] ?? symbol.valueDeclaration;
+}
+function typeToString(type, checker, enclosing) {
+    return checker.typeToString(type, enclosing, TYPE_FORMAT_FLAGS);
+}
+/**
+ * Render the type of a declared member. Prefers the author's written type
+ * annotation when present, because the compiler's resolved type for optional
+ * parameters/properties includes a synthetic `| undefined` that would otherwise
+ * make `foo?: string` and `foo: string` look like unrelated types.
+ */
+function annotatedTypeString(decl, fallback, checker) {
+    if (decl &&
+        (ts.isParameter(decl) || ts.isPropertySignature(decl) || ts.isPropertyDeclaration(decl)) &&
+        decl.type) {
+        return decl.type.getText();
+    }
+    return typeToString(fallback, checker, decl);
+}
+function serializeTypeParameters(params, checker) {
+    if (!params)
+        return [];
+    return params.map((tp) => {
+        const result = { name: tp.name.text };
+        if (tp.constraint)
+            result.constraint = tp.constraint.getText();
+        if (tp.default)
+            result.default = tp.default.getText();
+        return result;
+    });
+}
+function serializeSignature(sig, checker) {
+    const parameters = sig.getParameters().map((paramSymbol) => {
+        const decl = paramSymbol.valueDeclaration;
+        const paramType = checker.getTypeOfSymbolAtLocation(paramSymbol, decl ?? paramSymbol.declarations[0]);
+        return {
+            name: paramSymbol.getName(),
+            type: annotatedTypeString(decl, paramType, checker),
+            optional: decl ? checker.isOptionalParameter(decl) : false,
+            rest: decl?.dotDotDotToken !== undefined,
+        };
+    });
+    const typeParameters = (sig.getTypeParameters() ?? []).map((tp) => {
+        const result = { name: tp.symbol.getName() };
+        const constraint = tp.getConstraint();
+        if (constraint)
+            result.constraint = typeToString(constraint, checker);
+        const dflt = tp.getDefault();
+        if (dflt)
+            result.default = typeToString(dflt, checker);
+        return result;
+    });
+    return {
+        typeParameters,
+        parameters,
+        returnType: typeToString(sig.getReturnType(), checker),
+    };
+}
+function serializeFunction(name, symbol, checker) {
+    const decl = firstDeclaration(symbol);
+    const type = checker.getTypeOfSymbolAtLocation(symbol, decl ?? symbol.valueDeclaration);
+    const signatures = type.getCallSignatures().map((sig) => serializeSignature(sig, checker));
+    return { kind: "function", name, signatures };
+}
+function isMethodSymbol(member) {
+    return (member.getFlags() & ts.SymbolFlags.Method) !== 0;
+}
+function isReadonlyMember(member) {
+    const decl = member.getDeclarations()?.[0];
+    if (!decl || !ts.canHaveModifiers(decl))
+        return false;
+    return (ts
+        .getModifiers(decl)
+        ?.some((m) => m.kind === ts.SyntaxKind.ReadonlyKeyword) ?? false);
+}
+function serializeProperty(member, checker) {
+    const decl = member.getDeclarations()?.[0];
+    const type = decl
+        ? checker.getTypeOfSymbolAtLocation(member, decl)
+        : checker.getTypeOfSymbol(member);
+    return {
+        name: member.getName(),
+        type: annotatedTypeString(decl, type, checker),
+        optional: (member.getFlags() & ts.SymbolFlags.Optional) !== 0,
+        readonly: isReadonlyMember(member),
+    };
+}
+function serializeMembers(type, checker) {
+    const properties = {};
+    const methods = {};
+    for (const member of type.getProperties()) {
+        const memberName = member.getName();
+        // Skip private / internal members (leading underscore is a common convention,
+        // and truly private class members are excluded from the apparent type already).
+        if (isMethodSymbol(member)) {
+            const decl = member.getDeclarations()?.[0];
+            const memberType = decl
+                ? checker.getTypeOfSymbolAtLocation(member, decl)
+                : checker.getTypeOfSymbol(member);
+            const sigs = memberType.getCallSignatures().map((s) => serializeSignature(s, checker));
+            methods[memberName] = sigs;
+        }
+        else {
+            properties[memberName] = serializeProperty(member, checker);
+        }
+    }
+    return { properties, methods };
+}
+function serializeTypeAlias(name, symbol, checker) {
+    const decl = symbol.getDeclarations()?.find(ts.isTypeAliasDeclaration);
+    const type = checker.getDeclaredTypeOfSymbol(symbol);
+    // Prefer the written type text when available; fall back to the resolved type.
+    const rendered = decl?.type ? decl.type.getText() : typeToString(type, checker, decl);
+    return {
+        kind: "typeAlias",
+        name,
+        typeParameters: serializeTypeParameters(decl?.typeParameters, checker),
+        type: rendered,
+    };
+}
+function serializeInterface(name, symbol, checker) {
+    const type = checker.getDeclaredTypeOfSymbol(symbol);
+    const decl = symbol.getDeclarations()?.find(ts.isInterfaceDeclaration);
+    const { properties, methods } = serializeMembers(type, checker);
+    return {
+        kind: "interface",
+        name,
+        typeParameters: serializeTypeParameters(decl?.typeParameters, checker),
+        properties,
+        methods,
+    };
+}
+function serializeClass(name, symbol, checker) {
+    const instanceType = checker.getDeclaredTypeOfSymbol(symbol);
+    const decl = symbol.getDeclarations()?.find(ts.isClassDeclaration);
+    const { properties, methods } = serializeMembers(instanceType, checker);
+    // Construct signatures live on the static (constructor) side of the class.
+    const staticType = checker.getTypeOfSymbolAtLocation(symbol, decl ?? symbol.valueDeclaration);
+    const constructors = staticType
+        .getConstructSignatures()
+        .map((sig) => serializeSignature(sig, checker));
+    const abstract = decl?.modifiers?.some((m) => m.kind === ts.SyntaxKind.AbstractKeyword) ?? false;
+    return {
+        kind: "class",
+        name,
+        abstract,
+        typeParameters: serializeTypeParameters(decl?.typeParameters, checker),
+        constructors,
+        properties,
+        methods,
+    };
+}
+function serializeEnum(name, symbol, checker) {
+    const members = {};
+    const isConst = (symbol.getFlags() & ts.SymbolFlags.ConstEnum) !== 0;
+    for (const decl of symbol.getDeclarations() ?? []) {
+        if (!ts.isEnumDeclaration(decl))
+            continue;
+        for (const member of decl.members) {
+            const memberName = member.name.getText();
+            const value = checker.getConstantValue(member);
+            members[memberName] = value === undefined ? "<computed>" : String(value);
+        }
+    }
+    return { kind: "enum", name, const: isConst, members };
+}
+function serializeVariable(name, symbol, checker) {
+    const decl = firstDeclaration(symbol);
+    const type = checker.getTypeOfSymbolAtLocation(symbol, decl ?? symbol.valueDeclaration);
+    const isConst = decl !== undefined &&
+        ts.isVariableDeclaration(decl) &&
+        decl.parent !== undefined &&
+        ts.isVariableDeclarationList(decl.parent) &&
+        (decl.parent.flags & ts.NodeFlags.Const) !== 0;
+    return { kind: "variable", name, const: isConst, type: typeToString(type, checker, decl) };
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

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

package/dist/findings.d.ts

@@ -0,0 +1,16 @@
+import type { SemverLevel } from "./model.js";
+export interface Finding {
+    /** The semver impact of this single change. */
+    level: SemverLevel;
+    /** Stable machine-readable code, e.g. `export.removed`, `param.typeChanged`. */
+    code: string;
+    /** Dotted path to the affected surface location, e.g. `parseConfig.params[0]`. */
+    path: string;
+    /** Human-readable one-line explanation. */
+    message: string;
+}
+/** Reduce a set of findings to the single highest-impact semver level. */
+export declare function classify(findings: readonly Finding[]): SemverLevel;
+/** Sort findings most-severe first, then by path for stable output. */
+export declare function sortFindings(findings: Finding[]): Finding[];
+//# sourceMappingURL=findings.d.ts.map

package/dist/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,OAAO;IACtB,+CAA+C;IAC/C,KAAK,EAAE,WAAW,CAAC;IACnB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAMlE;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAM3D"}

package/dist/findings.js

@@ -0,0 +1,20 @@
+const ORDER = { patch: 0, minor: 1, major: 2 };
+/** Reduce a set of findings to the single highest-impact semver level. */
+export function classify(findings) {
+    let level = "patch";
+    for (const f of findings) {
+        if (ORDER[f.level] > ORDER[level])
+            level = f.level;
+    }
+    return level;
+}
+/** Sort findings most-severe first, then by path for stable output. */
+export function sortFindings(findings) {
+    return [...findings].sort((a, b) => {
+        const byLevel = ORDER[b.level] - ORDER[a.level];
+        if (byLevel !== 0)
+            return byLevel;
+        return a.path.localeCompare(b.path);
+    });
+}
+//# sourceMappingURL=findings.js.map

package/dist/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAaA,MAAM,KAAK,GAAgC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAE5E,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,QAA4B;IACnD,IAAI,KAAK,GAAgB,OAAO,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;YAAE,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,QAAmB;IAC9C,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAClC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { ApiSurface, CallSignature, ClassSymbol, EnumSymbol, ExportedSymbol, FunctionSymbol, InterfaceSymbol, Parameter, PropertyMember, SemverLevel, SymbolKind, TypeAliasSymbol, TypeParameter, VariableSymbol, } from "./model.js";
+export { extractSurface } from "./extract.js";
+export type { ExtractOptions } from "./extract.js";
+export { diffSurfaces } from "./diff.js";
+export { classify, sortFindings } from "./findings.js";
+export type { Finding } from "./findings.js";
+export { checkSurfaces } from "./check.js";
+export type { CheckResult } from "./check.js";
+export { renderReport } from "./report.js";
+export type { RenderOptions } from "./report.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,YAAY,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,SAAS,EACT,cAAc,EACd,WAAW,EACX,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { extractSurface } from "./extract.js";
+export { diffSurfaces } from "./diff.js";
+export { classify, sortFindings } from "./findings.js";
+export { checkSurfaces } from "./check.js";
+export { renderReport } from "./report.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":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Serializable model of a package's exported type surface.
+ *
+ * The whole point of this model is that it is plain JSON: a surface can be
+ * written to disk (an "API lockfile"), committed, and diffed later against a
+ * freshly extracted surface without needing the original TypeScript program.
+ */
+export type SemverLevel = "major" | "minor" | "patch";
+export interface ApiSurface {
+    /** Logical identifier of the entry point that produced this surface. */
+    entryPoint: string;
+    /** Exported symbols keyed by their exported name. */
+    exports: Record<string, ExportedSymbol>;
+}
+export type ExportedSymbol = FunctionSymbol | InterfaceSymbol | TypeAliasSymbol | ClassSymbol | EnumSymbol | VariableSymbol;
+export type SymbolKind = ExportedSymbol["kind"];
+export interface TypeParameter {
+    name: string;
+    constraint?: string;
+    default?: string;
+}
+export interface Parameter {
+    name: string;
+    /** Rendered type string (normalized via the compiler's printer). */
+    type: string;
+    optional: boolean;
+    rest: boolean;
+}
+export interface CallSignature {
+    typeParameters: TypeParameter[];
+    parameters: Parameter[];
+    returnType: string;
+}
+export interface PropertyMember {
+    name: string;
+    type: string;
+    optional: boolean;
+    readonly: boolean;
+}
+export interface FunctionSymbol {
+    kind: "function";
+    name: string;
+    signatures: CallSignature[];
+}
+export interface InterfaceSymbol {
+    kind: "interface";
+    name: string;
+    typeParameters: TypeParameter[];
+    properties: Record<string, PropertyMember>;
+    methods: Record<string, CallSignature[]>;
+}
+export interface TypeAliasSymbol {
+    kind: "typeAlias";
+    name: string;
+    typeParameters: TypeParameter[];
+    type: string;
+}
+export interface ClassSymbol {
+    kind: "class";
+    name: string;
+    abstract: boolean;
+    typeParameters: TypeParameter[];
+    constructors: CallSignature[];
+    properties: Record<string, PropertyMember>;
+    methods: Record<string, CallSignature[]>;
+}
+export interface EnumSymbol {
+    kind: "enum";
+    name: string;
+    const: boolean;
+    /** Member name -> constant value rendered as a string (or `undefined` if computed). */
+    members: Record<string, string>;
+}
+export interface VariableSymbol {
+    kind: "variable";
+    name: string;
+    const: boolean;
+    type: string;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,eAAe,GACf,eAAe,GACf,WAAW,GACX,UAAU,GACV,cAAc,CAAC;AAEnB,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/model.js

@@ -0,0 +1,9 @@
+/**
+ * Serializable model of a package's exported type surface.
+ *
+ * The whole point of this model is that it is plain JSON: a surface can be
+ * written to disk (an "API lockfile"), committed, and diffed later against a
+ * freshly extracted surface without needing the original TypeScript program.
+ */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/report.d.ts

@@ -0,0 +1,8 @@
+import type { CheckResult } from "./check.js";
+export interface RenderOptions {
+    /** Emit ANSI colors. Default: false (caller decides based on TTY). */
+    color?: boolean;
+}
+/** Render a check result as a human-readable, optionally colored report. */
+export declare function renderReport(result: CheckResult, options?: RenderOptions): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA6BrF"}

package/dist/report.js

@@ -0,0 +1,38 @@
+const LEVEL_LABEL = {
+    major: "MAJOR",
+    minor: "MINOR",
+    patch: "PATCH",
+};
+const ANSI = {
+    major: "\x1b[31m", // red
+    minor: "\x1b[33m", // yellow
+    patch: "\x1b[32m", // green
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    reset: "\x1b[0m",
+};
+/** Render a check result as a human-readable, optionally colored report. */
+export function renderReport(result, options = {}) {
+    const paint = (code, text) => options.color ? `${ANSI[code]}${text}${ANSI.reset}` : text;
+    const lines = [];
+    const counts = { major: 0, minor: 0, patch: 0 };
+    for (const f of result.findings)
+        counts[f.level]++;
+    if (result.findings.length === 0) {
+        lines.push(paint("patch", "No public API changes detected."));
+        lines.push("");
+        lines.push(`Required version bump: ${paint("patch", LEVEL_LABEL.patch)}`);
+        return lines.join("\n");
+    }
+    for (const f of result.findings) {
+        const badge = paint(f.level, LEVEL_LABEL[f.level].padEnd(5));
+        lines.push(`${badge}  ${f.message}`);
+        lines.push(`       ${paint("dim", `${f.code} @ ${f.path}`)}`);
+    }
+    lines.push("");
+    const summary = `${counts.major} major, ${counts.minor} minor`;
+    lines.push(paint("dim", summary));
+    lines.push(`Required version bump: ${paint("bold", "")}${paint(result.level, LEVEL_LABEL[result.level])}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAgC;IAC/C,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,IAAI,GAA2D;IACnE,KAAK,EAAE,UAAU,EAAE,MAAM;IACzB,KAAK,EAAE,UAAU,EAAE,SAAS;IAC5B,KAAK,EAAE,UAAU,EAAE,QAAQ;IAC3B,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,UAAyB,EAAE;IAC3E,MAAM,KAAK,GAAG,CAAC,IAAuB,EAAE,IAAY,EAAE,EAAE,CACtD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAgC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC7E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;QAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAEnD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,KAAK,QAAQ,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CACR,0BAA0B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAC/F,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "ts-semver-checks-core",
+  "version": "0.2.0",
+  "description": "Core library: extract, diff and classify the exported type surface of a TypeScript package.",
+  "keywords": [
+    "semver",
+    "typescript",
+    "api",
+    "breaking-change",
+    "types",
+    "diff"
+  ],
+  "homepage": "https://github.com/ardenden/ts-semver-checks#readme",
+  "bugs": "https://github.com/ardenden/ts-semver-checks/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ardenden/ts-semver-checks.git",
+    "directory": "packages/core"
+  },
+  "author": "ardenden",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}