@takazudo/zudo-doc 5.12.0 → 5.12.1

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `@takazudo/zudo-doc` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [5.12.1] - 2026-08-24
+
+### Bug Fixes
+
+- Removed the deprecated `string-similarity` runtime dependency from tag auditing while preserving its whitespace-insensitive near-duplicate scoring behavior. (`b5fa7a6c`)
+
+### Other Changes
+
+- Updated the zfb package family to 2.10.1 and raised the `@takazudo/zudo-doc-history-server` peer floor to the published 5.12.0 release. (`b5fa7a6c`)
+
 ## [5.12.0] - 2026-08-23
 
 ### Features

package/bin/tags-audit-runner.ts

@@ -21,10 +21,10 @@ import { resolve } from "node:path";
 
 import pc from "picocolors";
 import pluralize from "pluralize";
-import stringSimilarity from "string-similarity";
 
 import {
   audit,
+  compareTwoStrings,
   formatTextReport,
   hasHardIssues,
   type AuditOptions,
@@ -71,7 +71,7 @@ async function main(): Promise<void> {
     vocabularyActive: config.vocabularyActive,
     nearDupHelpers: {
       singular: pluralize.singular,
-      compareTwoStrings: stringSimilarity.compareTwoStrings,
+      compareTwoStrings,
     },
   };
 

package/dist/tags-audit.d.ts

@@ -42,8 +42,7 @@ export interface AuditOptions {
     vocabularyActive: boolean;
     /**
      * Near-duplicate detection callbacks. Optional — if omitted the relevant
-     * checks are silently skipped so callers without pluralize / string-similarity
-     * can still use the core functions.
+     * checks are silently skipped so callers can still use the core functions.
      */
     nearDupHelpers?: NearDupHelpers;
 }
@@ -65,6 +64,8 @@ export interface NearDupHelpers {
 export declare function buildIndex(vocab: readonly TagVocabularyEntry[]): VocabularyIndex;
 export declare function collectMdxFiles(dir: string): Promise<string[]>;
 export declare function normalizeTags(value: unknown): string[];
+/** Return the Sørensen–Dice similarity of two whitespace-insensitive bigram sets. */
+export declare function compareTwoStrings(first: string, second: string): number;
 export declare function findNearDuplicates(tags: string[], helpers: NearDupHelpers): NearDuplicatePair[];
 export declare function audit(opts: AuditOptions): Promise<AuditReport>;
 export declare function hasHardIssues(report: AuditReport): boolean;

package/dist/tags-audit.js

@@ -34,6 +34,26 @@ function normalizeTags(value) {
   if (!Array.isArray(value)) return [];
   return value.filter((v) => typeof v === "string");
 }
+function compareTwoStrings(first, second) {
+  const normalizedFirst = first.replace(/\s+/g, "");
+  const normalizedSecond = second.replace(/\s+/g, "");
+  if (normalizedFirst === normalizedSecond) return 1;
+  if (normalizedFirst.length < 2 || normalizedSecond.length < 2) return 0;
+  const firstBigrams = /* @__PURE__ */ new Map();
+  for (let index = 0; index < normalizedFirst.length - 1; index++) {
+    const bigram = normalizedFirst.slice(index, index + 2);
+    firstBigrams.set(bigram, (firstBigrams.get(bigram) ?? 0) + 1);
+  }
+  let intersectionSize = 0;
+  for (let index = 0; index < normalizedSecond.length - 1; index++) {
+    const bigram = normalizedSecond.slice(index, index + 2);
+    const remaining = firstBigrams.get(bigram) ?? 0;
+    if (remaining === 0) continue;
+    firstBigrams.set(bigram, remaining - 1);
+    intersectionSize++;
+  }
+  return 2 * intersectionSize / (normalizedFirst.length + normalizedSecond.length - 2);
+}
 const NEAR_DUP_THRESHOLD = 0.82;
 function findNearDuplicates(tags, helpers) {
   const pairs = [];
@@ -151,6 +171,7 @@ export {
   audit,
   buildIndex,
   collectMdxFiles,
+  compareTwoStrings,
   findNearDuplicates,
   formatTextReport,
   hasHardIssues,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.12.0",
+  "version": "5.12.1",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -634,10 +634,10 @@
   ],
   "peerDependencies": {
     "@takazudo/zdtp": "^0.4.12",
-    "@takazudo/zfb": "^2.10.0",
-    "@takazudo/zfb-md-wasm": "^2.10.0",
-    "@takazudo/zfb-runtime": "^2.10.0",
-    "@takazudo/zudo-doc-history-server": "^5.5.3",
+    "@takazudo/zfb": "^2.10.1",
+    "@takazudo/zfb-md-wasm": "^2.10.1",
+    "@takazudo/zfb-runtime": "^2.10.1",
+    "@takazudo/zudo-doc-history-server": "^5.12.0",
     "diff": "^8.0.0",
     "katex": "^0.16.0",
     "preact": "^10.29.1",
@@ -669,18 +669,16 @@
     "picocolors": "^1.1.1",
     "pluralize": "^8.0.0",
     "smol-toml": "^1.8.0",
-    "string-similarity": "^4.0.4",
     "tsx": "^4.21.0"
   },
   "devDependencies": {
-    "@takazudo/zfb": "2.10.0",
-    "@takazudo/zfb-md-wasm": "2.10.0",
-    "@takazudo/zfb-runtime": "2.10.0",
+    "@takazudo/zfb": "2.10.1",
+    "@takazudo/zfb-md-wasm": "2.10.1",
+    "@takazudo/zfb-runtime": "2.10.1",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
     "@types/pluralize": "^0.0.33",
-    "@types/string-similarity": "^4.0.2",
     "happy-dom": "^20.10.6",
     "npm-run-all2": "^7.0.2",
     "preact": "^10.29.1",
@@ -689,7 +687,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.12.0"
+    "@takazudo/zudo-doc-history-server": "5.12.1"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",