@takazudo/zfb-slugify 0.0.0-stage → 4.3.1

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 4.2.1
+
+Initial standalone package release, extracted from the existing zfb heading-anchor
+slug utilities. Its output is covered by the shared Rust parity fixture.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Takeshi Takatsudo
+
+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

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @takazudo/zfb-slugify
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Standalone, zero-dependency heading-anchor slug utilities used by zfb. The
+package exports only `slugify` and `SlugAllocator`.
+
+```sh
+npm install @takazudo/zfb-slugify
+```
+
+```ts
+import { SlugAllocator, slugify } from "@takazudo/zfb-slugify";
+
+const allocator = new SlugAllocator("hierarchical");
+const slug = allocator.allocate(2, slugify("Hello World")); // "hello-world"
+```
+
+The output matches zfb's Rust implementation through the shared fixture at
+`crates/zfb-content/tests/fixtures/slugify-parity.json`. The existing
+`@takazudo/zfb/slugify` export remains available for compatibility.
+
+`SlugAllocator` accepts `"flat"` (the default) or `"hierarchical"`; call
+`reset()` between documents to clear deduplication and ancestor state.

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Heading-anchor slug utilities — a pure-TypeScript port of the Rust
+ * `slugify` / `next_slug` / `SlugAllocator` in
+ * `crates/zfb-content/src/plugins/heading_links.rs`.
+ *
+ * These functions produce the `id` attribute values that appear on
+ * `<h2>`–`<h6>` elements in the rendered HTML.  They are intentionally
+ * **not** compatible with npm `github-slugger`: stripped punctuation
+ * collapses to a `-` separator (`"a,b"` → `"a-b"`), and leading/trailing
+ * whitespace / stripped chars emit nothing rather than a stray dash.
+ *
+ * ⚠️  These functions produce heading-anchor slugs (e.g. `"hello-world"`
+ * for `<h2 id="hello-world">`).  They are **different** from
+ * `_relPathToSlug` in `content.ts`, which converts a file-system relative
+ * path into a URL slug for `CollectionEntry.slug`.
+ *
+ * Parity is enforced by the shared fixture at
+ * `crates/zfb-content/tests/fixtures/slugify-parity.json`, consumed by
+ * both the Rust integration test and this package's `slugify.test.ts` suite.
+ */
+/**
+ * Produce a heading-anchor slug from `input`, matching the Rust
+ * `slugify()` in `crates/zfb-content/src/plugins/heading_links.rs`.
+ *
+ * Algorithm (per Unicode code point):
+ * - whitespace or stripped punctuation → emit ONE `-` unless the last
+ *   emitted character was already a `-` (leading separators are skipped
+ *   because `lastDash` starts `true`).
+ * - anything else → push `ch.toLowerCase()` (per-code-point, not
+ *   whole-string, to avoid Greek final-sigma context collapsing).
+ * - finally pop ONE trailing `-` if present.
+ *
+ * Divergence from npm github-slugger (intentional — parity target is
+ * the Rust function, not npm):
+ * - `"a,b"` → `"a-b"` (stripped punctuation emits a dash, not nothing)
+ * - `"  --weird-- "` → `"--weird--"` (existing dashes/underscores pass
+ *   through unchanged)
+ */
+export declare function slugify(input: string): string;
+/**
+ * Strategy-aware slug allocator for a single document.
+ *
+ * Mirrors Rust `SlugAllocator` in heading_links.rs:70-118.
+ *
+ * @param strategy `"flat"` (default) — per-document dedup counter, mirrors
+ *   github-slugger numbering.  `"hierarchical"` — each slug is prefixed with
+ *   its ancestor chain and deduped on the full candidate path.
+ *
+ * Depth contract: callers pass `depth` values 2–6 (h2–h6).  h1 is never
+ * allocated — it is handled by the page layout, not the markdown body.
+ */
+export declare class SlugAllocator {
+    private readonly strategy;
+    private seen;
+    /** Hierarchical ancestor stack of `[depth, finalId]` pairs. Unused in flat mode. */
+    private stack;
+    constructor(strategy?: "flat" | "hierarchical");
+    /**
+     * Allocate the slug for a heading of `depth` (2–6) whose slugified text
+     * is `base`.  Returns `""` for an empty `base` without mutating state.
+     */
+    allocate(depth: number, base: string): string;
+    /**
+     * Clear all per-document state (dedup counters AND the hierarchical
+     * ancestor stack).  Call between documents to avoid slug counter leakage.
+     */
+    reset(): void;
+}

package/dist/index.js

@@ -0,0 +1,197 @@
+/**
+ * Heading-anchor slug utilities — a pure-TypeScript port of the Rust
+ * `slugify` / `next_slug` / `SlugAllocator` in
+ * `crates/zfb-content/src/plugins/heading_links.rs`.
+ *
+ * These functions produce the `id` attribute values that appear on
+ * `<h2>`–`<h6>` elements in the rendered HTML.  They are intentionally
+ * **not** compatible with npm `github-slugger`: stripped punctuation
+ * collapses to a `-` separator (`"a,b"` → `"a-b"`), and leading/trailing
+ * whitespace / stripped chars emit nothing rather than a stray dash.
+ *
+ * ⚠️  These functions produce heading-anchor slugs (e.g. `"hello-world"`
+ * for `<h2 id="hello-world">`).  They are **different** from
+ * `_relPathToSlug` in `content.ts`, which converts a file-system relative
+ * path into a URL slug for `CollectionEntry.slug`.
+ *
+ * Parity is enforced by the shared fixture at
+ * `crates/zfb-content/tests/fixtures/slugify-parity.json`, consumed by
+ * both the Rust integration test and this package's `slugify.test.ts` suite.
+ */
+// ---------------------------------------------------------------------------
+// Helpers — mirrors the Rust `is_stripped` predicate
+// ---------------------------------------------------------------------------
+/** Unicode General Category Cc (control characters). */
+function isCc(ch) {
+    // \p{Cc} = general category "Control" (C0 + C1 blocks: U+0000–U+001F, U+007F–U+009F)
+    return /^\p{Cc}$/u.test(ch);
+}
+/**
+ * Returns true when the character should be stripped (maps to a dash
+ * separator in the output).  Mirrors Rust's `is_stripped`:
+ *   - Unicode Cc control characters
+ *   - Explicit ASCII punctuation set: `! " # $ % & ' ( ) * + , . / : ; < = > ? @ [ \ ] ^ ` { | } ~`
+ */
+function isStripped(ch) {
+    if (isCc(ch))
+        return true;
+    return (ch === "!" ||
+        ch === '"' ||
+        ch === "#" ||
+        ch === "$" ||
+        ch === "%" ||
+        ch === "&" ||
+        ch === "'" ||
+        ch === "(" ||
+        ch === ")" ||
+        ch === "*" ||
+        ch === "+" ||
+        ch === "," ||
+        ch === "." ||
+        ch === "/" ||
+        ch === ":" ||
+        ch === ";" ||
+        ch === "<" ||
+        ch === "=" ||
+        ch === ">" ||
+        ch === "?" ||
+        ch === "@" ||
+        ch === "[" ||
+        ch === "\\" ||
+        ch === "]" ||
+        ch === "^" ||
+        ch === "`" ||
+        ch === "{" ||
+        ch === "|" ||
+        ch === "}" ||
+        ch === "~");
+}
+/**
+ * Returns true when `ch` is a Unicode whitespace character.
+ *
+ * Mirrors Rust `char::is_whitespace` which is `\p{White_Space}/u` — NOT
+ * the JS `\s` class (`\s` wrongly matches U+FEFF BYTE ORDER MARK and
+ * misses U+0085 NEXT LINE).
+ */
+function isWhitespace(ch) {
+    return /^\p{White_Space}$/u.test(ch);
+}
+// ---------------------------------------------------------------------------
+// slugify
+// ---------------------------------------------------------------------------
+/**
+ * Produce a heading-anchor slug from `input`, matching the Rust
+ * `slugify()` in `crates/zfb-content/src/plugins/heading_links.rs`.
+ *
+ * Algorithm (per Unicode code point):
+ * - whitespace or stripped punctuation → emit ONE `-` unless the last
+ *   emitted character was already a `-` (leading separators are skipped
+ *   because `lastDash` starts `true`).
+ * - anything else → push `ch.toLowerCase()` (per-code-point, not
+ *   whole-string, to avoid Greek final-sigma context collapsing).
+ * - finally pop ONE trailing `-` if present.
+ *
+ * Divergence from npm github-slugger (intentional — parity target is
+ * the Rust function, not npm):
+ * - `"a,b"` → `"a-b"` (stripped punctuation emits a dash, not nothing)
+ * - `"  --weird-- "` → `"--weird--"` (existing dashes/underscores pass
+ *   through unchanged)
+ */
+export function slugify(input) {
+    let out = "";
+    let lastDash = true;
+    for (const ch of input) {
+        if (isWhitespace(ch) || isStripped(ch)) {
+            if (!lastDash) {
+                out += "-";
+                lastDash = true;
+            }
+        }
+        else {
+            // Per-code-point lowercase — avoids Greek final-sigma context:
+            // "ΦΟΣ" → "φοσ" not "φος".
+            out += ch.toLowerCase();
+            lastDash = false;
+        }
+    }
+    if (out.endsWith("-")) {
+        out = out.slice(0, -1);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// next_slug
+// ---------------------------------------------------------------------------
+/**
+ * Allocate the next deduplicated slug for `base` against a per-document
+ * counter map.
+ *
+ * Mirrors Rust `next_slug`: first occurrence returns `base`, second
+ * returns `base-1`, third `base-2`, …  Empty `base` short-circuits to
+ * `""` without mutating the map.
+ */
+function nextSlug(seen, base) {
+    if (base === "")
+        return "";
+    const count = seen.get(base) ?? 0;
+    const slug = count === 0 ? base : `${base}-${count}`;
+    seen.set(base, count + 1);
+    return slug;
+}
+// ---------------------------------------------------------------------------
+// SlugAllocator
+// ---------------------------------------------------------------------------
+/**
+ * Strategy-aware slug allocator for a single document.
+ *
+ * Mirrors Rust `SlugAllocator` in heading_links.rs:70-118.
+ *
+ * @param strategy `"flat"` (default) — per-document dedup counter, mirrors
+ *   github-slugger numbering.  `"hierarchical"` — each slug is prefixed with
+ *   its ancestor chain and deduped on the full candidate path.
+ *
+ * Depth contract: callers pass `depth` values 2–6 (h2–h6).  h1 is never
+ * allocated — it is handled by the page layout, not the markdown body.
+ */
+export class SlugAllocator {
+    strategy;
+    seen;
+    /** Hierarchical ancestor stack of `[depth, finalId]` pairs. Unused in flat mode. */
+    stack;
+    constructor(strategy = "flat") {
+        this.strategy = strategy;
+        this.seen = new Map();
+        this.stack = [];
+    }
+    /**
+     * Allocate the slug for a heading of `depth` (2–6) whose slugified text
+     * is `base`.  Returns `""` for an empty `base` without mutating state.
+     */
+    allocate(depth, base) {
+        if (this.strategy === "flat") {
+            return nextSlug(this.seen, base);
+        }
+        // Hierarchical mode
+        if (base === "")
+            return "";
+        // Pop ancestors whose depth >= this heading's depth
+        let top = this.stack.at(-1);
+        while (top !== undefined && top[0] >= depth) {
+            this.stack.pop();
+            top = this.stack.at(-1);
+        }
+        const candidate = top !== undefined ? `${top[1]}-${base}` : base;
+        const slug = nextSlug(this.seen, candidate);
+        this.stack.push([depth, slug]);
+        return slug;
+    }
+    /**
+     * Clear all per-document state (dedup counters AND the hierarchical
+     * ancestor stack).  Call between documents to avoid slug counter leakage.
+     */
+    reset() {
+        this.seen.clear();
+        this.stack = [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E,wDAAwD;AACxD,SAAS,IAAI,CAAC,EAAU;IACtB,qFAAqF;IACrF,OAAO,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,EAAU;IAC5B,IAAI,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CACL,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,IAAI;QACX,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG;QACV,EAAE,KAAK,GAAG,CACX,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,EAAU;IAC9B,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,QAAQ,GAAG,IAAI,CAAC;IAEpB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,GAAG,IAAI,GAAG,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,2BAA2B;YAC3B,GAAG,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACxB,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,IAAyB,EAAE,IAAY;IACvD,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IACrD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IACP,QAAQ,CAA0B;IAC3C,IAAI,CAAsB;IAClC,oFAAoF;IAC5E,KAAK,CAA0B;IAEvC,YAAY,QAAQ,GAA4B,MAAM;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAa,EAAE,IAAY;QAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,oBAAoB;QACpB,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAE3B,oDAAoD;QACpD,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACjB,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF","sourcesContent":["/**\n * Heading-anchor slug utilities — a pure-TypeScript port of the Rust\n * `slugify` / `next_slug` / `SlugAllocator` in\n * `crates/zfb-content/src/plugins/heading_links.rs`.\n *\n * These functions produce the `id` attribute values that appear on\n * `<h2>`–`<h6>` elements in the rendered HTML.  They are intentionally\n * **not** compatible with npm `github-slugger`: stripped punctuation\n * collapses to a `-` separator (`\"a,b\"` → `\"a-b\"`), and leading/trailing\n * whitespace / stripped chars emit nothing rather than a stray dash.\n *\n * ⚠️  These functions produce heading-anchor slugs (e.g. `\"hello-world\"`\n * for `<h2 id=\"hello-world\">`).  They are **different** from\n * `_relPathToSlug` in `content.ts`, which converts a file-system relative\n * path into a URL slug for `CollectionEntry.slug`.\n *\n * Parity is enforced by the shared fixture at\n * `crates/zfb-content/tests/fixtures/slugify-parity.json`, consumed by\n * both the Rust integration test and this package's `slugify.test.ts` suite.\n */\n\n// ---------------------------------------------------------------------------\n// Helpers — mirrors the Rust `is_stripped` predicate\n// ---------------------------------------------------------------------------\n\n/** Unicode General Category Cc (control characters). */\nfunction isCc(ch: string): boolean {\n  // \\p{Cc} = general category \"Control\" (C0 + C1 blocks: U+0000–U+001F, U+007F–U+009F)\n  return /^\\p{Cc}$/u.test(ch);\n}\n\n/**\n * Returns true when the character should be stripped (maps to a dash\n * separator in the output).  Mirrors Rust's `is_stripped`:\n *   - Unicode Cc control characters\n *   - Explicit ASCII punctuation set: `! \" # $ % & ' ( ) * + , . / : ; < = > ? @ [ \\ ] ^ ` { | } ~`\n */\nfunction isStripped(ch: string): boolean {\n  if (isCc(ch)) return true;\n  return (\n    ch === \"!\" ||\n    ch === '\"' ||\n    ch === \"#\" ||\n    ch === \"$\" ||\n    ch === \"%\" ||\n    ch === \"&\" ||\n    ch === \"'\" ||\n    ch === \"(\" ||\n    ch === \")\" ||\n    ch === \"*\" ||\n    ch === \"+\" ||\n    ch === \",\" ||\n    ch === \".\" ||\n    ch === \"/\" ||\n    ch === \":\" ||\n    ch === \";\" ||\n    ch === \"<\" ||\n    ch === \"=\" ||\n    ch === \">\" ||\n    ch === \"?\" ||\n    ch === \"@\" ||\n    ch === \"[\" ||\n    ch === \"\\\\\" ||\n    ch === \"]\" ||\n    ch === \"^\" ||\n    ch === \"`\" ||\n    ch === \"{\" ||\n    ch === \"|\" ||\n    ch === \"}\" ||\n    ch === \"~\"\n  );\n}\n\n/**\n * Returns true when `ch` is a Unicode whitespace character.\n *\n * Mirrors Rust `char::is_whitespace` which is `\\p{White_Space}/u` — NOT\n * the JS `\\s` class (`\\s` wrongly matches U+FEFF BYTE ORDER MARK and\n * misses U+0085 NEXT LINE).\n */\nfunction isWhitespace(ch: string): boolean {\n  return /^\\p{White_Space}$/u.test(ch);\n}\n\n// ---------------------------------------------------------------------------\n// slugify\n// ---------------------------------------------------------------------------\n\n/**\n * Produce a heading-anchor slug from `input`, matching the Rust\n * `slugify()` in `crates/zfb-content/src/plugins/heading_links.rs`.\n *\n * Algorithm (per Unicode code point):\n * - whitespace or stripped punctuation → emit ONE `-` unless the last\n *   emitted character was already a `-` (leading separators are skipped\n *   because `lastDash` starts `true`).\n * - anything else → push `ch.toLowerCase()` (per-code-point, not\n *   whole-string, to avoid Greek final-sigma context collapsing).\n * - finally pop ONE trailing `-` if present.\n *\n * Divergence from npm github-slugger (intentional — parity target is\n * the Rust function, not npm):\n * - `\"a,b\"` → `\"a-b\"` (stripped punctuation emits a dash, not nothing)\n * - `\"  --weird-- \"` → `\"--weird--\"` (existing dashes/underscores pass\n *   through unchanged)\n */\nexport function slugify(input: string): string {\n  let out = \"\";\n  let lastDash = true;\n\n  for (const ch of input) {\n    if (isWhitespace(ch) || isStripped(ch)) {\n      if (!lastDash) {\n        out += \"-\";\n        lastDash = true;\n      }\n    } else {\n      // Per-code-point lowercase — avoids Greek final-sigma context:\n      // \"ΦΟΣ\" → \"φοσ\" not \"φος\".\n      out += ch.toLowerCase();\n      lastDash = false;\n    }\n  }\n\n  if (out.endsWith(\"-\")) {\n    out = out.slice(0, -1);\n  }\n\n  return out;\n}\n\n// ---------------------------------------------------------------------------\n// next_slug\n// ---------------------------------------------------------------------------\n\n/**\n * Allocate the next deduplicated slug for `base` against a per-document\n * counter map.\n *\n * Mirrors Rust `next_slug`: first occurrence returns `base`, second\n * returns `base-1`, third `base-2`, …  Empty `base` short-circuits to\n * `\"\"` without mutating the map.\n */\nfunction nextSlug(seen: Map<string, number>, base: string): string {\n  if (base === \"\") return \"\";\n  const count = seen.get(base) ?? 0;\n  const slug = count === 0 ? base : `${base}-${count}`;\n  seen.set(base, count + 1);\n  return slug;\n}\n\n// ---------------------------------------------------------------------------\n// SlugAllocator\n// ---------------------------------------------------------------------------\n\n/**\n * Strategy-aware slug allocator for a single document.\n *\n * Mirrors Rust `SlugAllocator` in heading_links.rs:70-118.\n *\n * @param strategy `\"flat\"` (default) — per-document dedup counter, mirrors\n *   github-slugger numbering.  `\"hierarchical\"` — each slug is prefixed with\n *   its ancestor chain and deduped on the full candidate path.\n *\n * Depth contract: callers pass `depth` values 2–6 (h2–h6).  h1 is never\n * allocated — it is handled by the page layout, not the markdown body.\n */\nexport class SlugAllocator {\n  private readonly strategy: \"flat\" | \"hierarchical\";\n  private seen: Map<string, number>;\n  /** Hierarchical ancestor stack of `[depth, finalId]` pairs. Unused in flat mode. */\n  private stack: Array<[number, string]>;\n\n  constructor(strategy: \"flat\" | \"hierarchical\" = \"flat\") {\n    this.strategy = strategy;\n    this.seen = new Map();\n    this.stack = [];\n  }\n\n  /**\n   * Allocate the slug for a heading of `depth` (2–6) whose slugified text\n   * is `base`.  Returns `\"\"` for an empty `base` without mutating state.\n   */\n  allocate(depth: number, base: string): string {\n    if (this.strategy === \"flat\") {\n      return nextSlug(this.seen, base);\n    }\n\n    // Hierarchical mode\n    if (base === \"\") return \"\";\n\n    // Pop ancestors whose depth >= this heading's depth\n    let top = this.stack.at(-1);\n    while (top !== undefined && top[0] >= depth) {\n      this.stack.pop();\n      top = this.stack.at(-1);\n    }\n\n    const candidate = top !== undefined ? `${top[1]}-${base}` : base;\n    const slug = nextSlug(this.seen, candidate);\n    this.stack.push([depth, slug]);\n    return slug;\n  }\n\n  /**\n   * Clear all per-document state (dedup counters AND the hierarchical\n   * ancestor stack).  Call between documents to avoid slug counter leakage.\n   */\n  reset(): void {\n    this.seen.clear();\n    this.stack = [];\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@takazudo/zfb-slugify",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "4.3.1",
+  "private": false,
+  "type": "module",
+  "description": "Zero-dependency heading-anchor slug utilities for zfb.",
+  "keywords": [
+    "zfb",
+    "slugify",
+    "heading",
+    "anchor"
+  ],
+  "license": "MIT",
+  "author": "Takeshi Takatsudo <takazudo@gmail.com> (https://github.com/takazudo)",
+  "homepage": "https://takazudomodular.com/pj/zudo-front-builder/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Takazudo/zudo-front-builder.git",
+    "directory": "packages/zfb-slugify"
+  },
+  "bugs": {
+    "url": "https://github.com/Takazudo/zudo-front-builder/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "7.0.2",
+    "typescript-5.9": "npm:typescript@5.9.3",
+    "typescript-6.0": "npm:typescript@6.0.3",
+    "vite-plus": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vp test run",
+    "test:watch": "vp test",
+    "typecheck": "tsc --noEmit"
+  }
 }