@rotorsoft/act-tck 1.39.2 → 1.40.0

package/dist/@types/stability-tck.d.ts

@@ -4,7 +4,8 @@
  * @property name - Display name for the snapshot suite (e.g., the package
  *   name). Used as the `describe` block label so failing snapshots are
  *   attributable at a glance.
- * @property entryPoints - Map of subpath → entry source file. The TCK
+ * @property entryPoints - Map of subpath → entry file, either source
+ *   (`.ts`) or a published declaration (`.d.ts`). The TCK
  *   reads each entry, follows its relative re-exports recursively, and
  *   snapshots the resulting surface text. Empty-string subpaths label
  *   the root entry; everything else is rendered with its key (e.g.
@@ -15,8 +16,8 @@ export type StabilityTckOptions = {
     readonly entryPoints: Readonly<Record<string, string>>;
 };
 /**
- * Snapshot-based public-API stability check. Walks each entry's source
- * file plus everything it re-exports through relative imports, and
+ * Snapshot-based public-API stability check. Walks each entry file plus
+ * everything it re-exports through relative imports, and
  * compares the concatenated text against a committed Vitest snapshot.
  *
  * Catches accidental rename / removal / signature drift on the public
@@ -24,9 +25,13 @@ export type StabilityTckOptions = {
  * shows up as a snapshot diff in the PR; reviewers either accept the
  * change (update the snapshot deliberately) or push back.
  *
- * The TCK reads source (`.ts`) rather than built declarations so it
- * doesn't need a prior `pnpm build`. It follows `from "./relative.js"`
- * re-exports transitively; non-relative paths (other packages, `node:`)
+ * Point it at the built declarations (`.d.ts`) to record the surface
+ * alone: a change to implementation then leaves the snapshot alone, and
+ * doc comments still show. That needs a build first. Point it at source
+ * (`.ts`) to skip the build, at the cost of a snapshot that also moves
+ * with every implementation change. It follows `from "./relative.js"`
+ * re-exports transitively, to `.d.ts` from a declaration and to `.ts`
+ * from source; non-relative paths (other packages, `node:`)
  * stop the walk — drift in another package's surface is that package's
  * stability TCK to catch.
  *

package/dist/@types/stability-tck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stability-tck.d.ts","sourceRoot":"","sources":["../../src/stability-tck.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAUlE"}
+{"version":3,"file":"stability-tck.d.ts","sourceRoot":"","sources":["../../src/stability-tck.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAUlE"}

package/dist/index.cjs

@@ -418,8 +418,9 @@ async function load_surface(entry2) {
     const content = await import_node_fs.promises.readFile(abs, "utf8");
     visited.set(abs, content);
     const re_export = /^\s*export\b[^"';]*\bfrom\s+["'](\.[^"']+)["']/gm;
+    const ext = abs.endsWith(".d.ts") ? ".d.ts" : ".ts";
     for (const m of content.matchAll(re_export)) {
-      const rel = m[1].replace(/\.js$/, ".ts");
+      const rel = m[1].replace(/\.js$/, ext);
       const target = import_node_path.default.resolve(import_node_path.default.dirname(abs), rel);
       await walk(target);
     }