@absolutejs/changelog 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -6,6 +6,19 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.7.1 — 2026-10-07
+
+### Fixed
+
+- **Quote style, comments and line wrapping no longer read as API changes** (`diffSurface`)
+  Two builds of the same API can print a declaration differently: a formatter swaps 'single' for "double" quotes, wraps a parameter list and adds a trailing comma, or a doc comment is reworded. The release gate and the upgrade advisor reported each of those as a changed export. Declarations are now compared token by token, with string literals in one form and comments, trailing commas and spacing ignored; a different string, type or parameter is still a change. The declarations shown in a report keep their own text.
+
+## 0.7.0 — 2026-09-10
+
+### Added
+
+- **Say when the build is older than the source it was built from, because the gate compares what is on disk** (`buildIsStale`)
+
 ## 0.6.0 — 2026-09-10
 
 ### Added

package/changelog.json

@@ -2,6 +2,33 @@
 	"contract": 1,
 	"name": "@absolutejs/changelog",
 	"releases": [
+		{
+			"changes": [
+				{
+					"detail": "Two builds of the same API can print a declaration differently: a formatter swaps 'single' for \"double\" quotes, wraps a parameter list and adds a trailing comma, or a doc comment is reworded. The release gate and the upgrade advisor reported each of those as a changed export. Declarations are now compared token by token, with string literals in one form and comments, trailing commas and spacing ignored; a different string, type or parameter is still a change. The declarations shown in a report keep their own text.",
+					"kind": "fixed",
+					"summary": "Quote style, comments and line wrapping no longer read as API changes",
+					"symbols": [
+						"diffSurface"
+					]
+				}
+			],
+			"date": "2026-10-07",
+			"version": "0.7.1"
+		},
+		{
+			"changes": [
+				{
+					"kind": "added",
+					"summary": "Say when the build is older than the source it was built from, because the gate compares what is on disk",
+					"symbols": [
+						"buildIsStale"
+					]
+				}
+			],
+			"date": "2026-09-10",
+			"version": "0.7.0"
+		},
 		{
 			"changes": [
 				{

package/dist/cli.js

@@ -8,7 +8,7 @@ import { mkdir, readFile as readFile3, rm, writeFile as writeFile2 } from "fs/pr
 import { join as join2 } from "path";
 
 // src/entries.ts
-import { readdir, readFile } from "fs/promises";
+import { readdir, readFile, stat } from "fs/promises";
 import { join } from "path";
 import { pathToFileURL } from "url";
 
@@ -337,6 +337,38 @@ var readTar = (archive, keep, limits = {}) => {
 var DECLARATION = /\.d\.[cm]?ts$/u;
 var parse = (source, name) => ts.createSourceFile(name, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
 var normalize = (text) => text.replace(/\s+/gu, " ").trim();
+var CLOSERS = new Set(["}", ")", "]", ">"]);
+var wordy = (token) => /^[\w$#@]/u.test(token) || /[\w$]$/u.test(token);
+var LAST2 = -1;
+var tokenText = (scanner, scanned, state) => {
+  const closesTemplate = scanned === ts.SyntaxKind.CloseBraceToken && state.templates.at(LAST2) === state.depth;
+  const token = closesTemplate ? scanner.reScanTemplateToken(false) : scanned;
+  if (closesTemplate && token === ts.SyntaxKind.TemplateTail)
+    state.templates.pop();
+  if (closesTemplate)
+    return scanner.getTokenText();
+  if (token === ts.SyntaxKind.StringLiteral)
+    return JSON.stringify(scanner.getTokenValue());
+  if (token === ts.SyntaxKind.TemplateHead)
+    state.templates.push(state.depth);
+  if (token === ts.SyntaxKind.OpenBraceToken)
+    state.depth += 1;
+  if (token === ts.SyntaxKind.CloseBraceToken)
+    state.depth -= 1;
+  return scanner.getTokenText();
+};
+var canonical = (text) => {
+  const scanner = ts.createScanner(ts.ScriptTarget.Latest, true, ts.LanguageVariant.Standard, text);
+  const state = { depth: 0, templates: [] };
+  const tokens = [];
+  for (let token = scanner.scan();token !== ts.SyntaxKind.EndOfFileToken; token = scanner.scan()) {
+    const value = tokenText(scanner, token, state);
+    if (CLOSERS.has(value) && tokens.at(LAST2) === ",")
+      tokens.pop();
+    tokens.push(value);
+  }
+  return tokens.reduce((joined, token, index) => index > 0 && wordy(tokens[index - 1] ?? "") && wordy(token) ? `${joined} ${token}` : `${joined}${token}`, "");
+};
 var resolveFrom = (files, from, specifier) => {
   if (!specifier.startsWith("."))
     return;
@@ -502,7 +534,7 @@ var SHAPE = {
   types: "types",
   unknown: "unknown"
 };
-var isStub = (declaration) => declaration.startsWith("export {");
+var isStub = (declaration) => /^export\s*\{/u.test(declaration);
 var signatureOf = (declaration) => {
   const file = parse(`${declaration}
 `, "declaration.d.ts");
@@ -518,7 +550,7 @@ var parametersOf = (declaration) => {
   const found = [];
   const visit = (node) => {
     if (ts.isFunctionTypeNode(node) || ts.isFunctionDeclaration(node) || ts.isMethodSignature(node) || ts.isMethodDeclaration(node) || ts.isConstructSignatureDeclaration(node) || ts.isConstructorDeclaration(node))
-      found.push(node.parameters.map((parameter) => normalize(parameter.getText())).join(", "));
+      found.push(node.parameters.map((parameter) => canonical(parameter.getText())).join(", "));
     ts.forEachChild(node, visit);
   };
   visit(statement);
@@ -560,7 +592,7 @@ var diffSurface = (before, after) => {
     const lost = was.entries.filter((entry) => !now.entries.includes(entry));
     if (lost.length > 0)
       withdrawn.push({ from: lost, name });
-    if (now.declaration !== was.declaration)
+    if (canonical(now.declaration) !== canonical(was.declaration))
       changed.push({
         after: now.declaration,
         before: was.declaration,
@@ -581,9 +613,9 @@ var diffSurface = (before, after) => {
 var notable = (diff) => diff.changed.filter((change) => change.shape === "parameters" || change.shape === "members");
 
 // src/entries.ts
-var loadEntry = async (path2) => {
+var loadEntry = async (path) => {
   try {
-    const module = await import(pathToFileURL(path2).href);
+    const module = await import(pathToFileURL(path).href);
     const named = typeof module === "object" && module !== null && "change" in module ? module.change : undefined;
     const exported = named ?? (typeof module === "object" && module !== null && "default" in module ? module.default : undefined);
     const read = { exported };
@@ -598,6 +630,23 @@ var loadEntry = async (path2) => {
 var ENTRY = /\.[cm]?ts$/u;
 var DECLARATION2 = /\.d\.[cm]?ts$/u;
 var OUTPUT_DIRECTORIES = ["dist", "build", "lib", "types", "out"];
+var newestUnder = async (root) => {
+  const found = await readdir(root, { withFileTypes: true }).catch(() => []);
+  const times = await Promise.all(found.map(async (entry) => {
+    const path = join(root, entry.name);
+    if (entry.isDirectory())
+      return newestUnder(path);
+    return stat(path).then((stats) => stats.mtimeMs, () => 0);
+  }));
+  return Math.max(0, ...times);
+};
+var buildIsStale = async (packageRoot) => {
+  const [source, built] = await Promise.all([
+    newestUnder(join(packageRoot, "src")),
+    Promise.all(OUTPUT_DIRECTORIES.map((directory) => newestUnder(join(packageRoot, directory)))).then((times) => Math.max(0, ...times))
+  ]);
+  return source > 0 && built > 0 && source > built;
+};
 var builtSurface = async (packageRoot) => {
   const manifest = await readJsonFile(join(packageRoot, "package.json"));
   const files = new Map;
@@ -643,8 +692,8 @@ var loadUnreleased = async (packageRoot) => {
   }
   return { entries, problems };
 };
-var readJsonFile = async (path2) => {
-  const source = await readFile(path2, "utf8").catch(() => {
+var readJsonFile = async (path) => {
+  const source = await readFile(path, "utf8").catch(() => {
     return;
   });
   if (source === undefined)
@@ -667,9 +716,9 @@ var indentOf = (source) => {
   const found = /\n([\t ]+)\S/u.exec(source)?.[1];
   return found === undefined || found === "" ? "\t" : found;
 };
-var writeJsonLike = async (path2, document) => {
-  const source = await readFile2(path2, "utf8").catch(() => "");
-  await writeFile(path2, `${JSON.stringify(document, null, indentOf(source))}
+var writeJsonLike = async (path, document) => {
+  const source = await readFile2(path, "utf8").catch(() => "");
+  await writeFile(path, `${JSON.stringify(document, null, indentOf(source))}
 `);
 };
 
@@ -835,7 +884,7 @@ var publishedChangelog = async (name, version, options = {}) => {
   const archive = await packageArchive(name, version, options);
   if (!archive)
     return;
-  const file = readTar(archive, (path2) => path2 === CHANGELOG_FILE).get(CHANGELOG_FILE);
+  const file = readTar(archive, (path) => path === CHANGELOG_FILE).get(CHANGELOG_FILE);
   if (!file)
     return;
   try {
@@ -1164,6 +1213,8 @@ var check = async (root, flags) => {
   const offline = flags.offline === true;
   const built = await builtSurface(root);
   const shipsTypes = declaresTypes(await readJsonFile(join2(root, "package.json")));
+  if (await buildIsStale(root))
+    console.warn("  (the build is older than the source it was built from, so this compared yesterday's package \u2014 run the build first)");
   if (built === undefined && shipsTypes)
     failures.push("there are no declaration files where package.json says its types are \u2014 build before the gate, or nothing compares them");
   if (!shipsTypes)
@@ -1173,7 +1224,7 @@ var check = async (root, flags) => {
     failures.push(`the registry did not answer for ${manifest.name}, so nothing was compared \u2014 pass --offline to skip the comparison deliberately`);
   if (versions !== undefined && versions.published.length === 0)
     console.warn(`  (${manifest.name} has never been published, so there was nothing to compare)`);
-  const baseline = (versions?.published ?? []).filter((version) => compareVersions(version, manifest.version) <= 0).sort(compareVersions).at(LAST2);
+  const baseline = (versions?.published ?? []).filter((version) => compareVersions(version, manifest.version) <= 0).sort(compareVersions).at(LAST3);
   if (versions !== undefined && versions.published.length > 0 && baseline === undefined && !offline)
     console.warn(`  (nothing published at or below ${manifest.version}, so there was nothing to compare)`);
   if (built !== undefined && baseline !== undefined) {
@@ -1197,7 +1248,7 @@ var check = async (root, flags) => {
   `));
   console.log(`${manifest.name}@${manifest.version}: changelog holds (${entries.length} pending, ${current.releases.length} released)`);
 };
-var LAST2 = -1;
+var LAST3 = -1;
 var subpathsOf = (manifest) => {
   const { exports } = manifest;
   if (typeof exports !== "object" || exports === null)
@@ -1205,13 +1256,13 @@ var subpathsOf = (manifest) => {
   return new Set(Object.keys(exports).map((key) => key === "." ? manifest.name ?? "" : `${manifest.name}${key.slice(1)}`));
 };
 var CHECKING_CONFIGS = ["tsconfig.json", "tsconfig.eslint.json"];
-var readTsconfig = async (path2) => {
-  const source = await readFile3(path2, "utf8").catch(() => {
+var readTsconfig = async (path) => {
+  const source = await readFile3(path, "utf8").catch(() => {
     return;
   });
   if (source === undefined)
     return;
-  const read = ts2.parseConfigFileTextToJson(path2, source);
+  const read = ts2.parseConfigFileTextToJson(path, source);
   if (read.error !== undefined)
     return;
   const { config } = read;
@@ -1221,8 +1272,8 @@ var readTsconfig = async (path2) => {
 var coversEntries = (include) => Array.isArray(include) && include.some((entry) => typeof entry === "string" && entry.startsWith("changelog"));
 var includeOf = (config) => typeof config === "object" && config !== null ? new Map(Object.entries(config)).get("include") : undefined;
 var includeEntriesIn = async (root, file) => {
-  const path2 = join2(root, file);
-  const read = await readTsconfig(path2);
+  const path = join2(root, file);
+  const read = await readTsconfig(path);
   if (read === undefined)
     return false;
   const include = includeOf(read.config);
@@ -1232,7 +1283,7 @@ var includeEntriesIn = async (root, file) => {
   if (opened === null)
     return false;
   const opens = opened.index + opened[0].length;
-  await writeFile2(path2, `${read.source.slice(0, opens)}
+  await writeFile2(path, `${read.source.slice(0, opens)}
 		"changelog/**/*",${read.source.slice(opens)}`);
   return true;
 };
@@ -1241,8 +1292,8 @@ var includeEntries = async (root) => {
   return wired.some(Boolean) ? undefined : "no tsconfig include list to wire \u2014 make sure changelog/ is compiled by something";
 };
 var ignoreGenerated = async (root) => {
-  const path2 = join2(root, ".prettierignore");
-  const existing = await readFile3(path2, "utf8").catch(() => "");
+  const path = join2(root, ".prettierignore");
+  const existing = await readFile3(path, "utf8").catch(() => "");
   const wanted = [CHANGELOG_FILE, CHANGELOG_MARKDOWN].filter((name) => !existing.split(`
 `).includes(name));
   if (wanted.length === 0)
@@ -1250,7 +1301,7 @@ var ignoreGenerated = async (root) => {
   const head = existing.trim() === "" ? `# Generated by absolute-changelog. Edit the entries, not these.
 ` : `${existing.trimEnd()}
 `;
-  await writeFile2(path2, `${head}${wanted.join(`
+  await writeFile2(path, `${head}${wanted.join(`
 `)}
 `);
 };
@@ -1314,5 +1365,5 @@ await main().catch((error) => {
   process.exit(1);
 });
 
-//# debugId=A14460FB75D13A7E64756E2164756E21
+//# debugId=D76B4516336E7D1B64756E2164756E21
 //# sourceMappingURL=cli.js.map