@json-to-office/core-docx 0.37.0 → 0.38.0

package/dist/utils/bookmarkRegistry.d.ts

@@ -2,6 +2,7 @@
  * Bookmark Registry
  * Utilities for managing document bookmarks for internal hyperlinks
  */
+import type { ParagraphChild } from 'docx';
 export interface BookmarkInfo {
     id: string;
     title: string;
@@ -35,6 +36,17 @@ export declare class BookmarkRegistry {
      * Register a bookmark
      */
     register(id: string, title: string, type: string): void;
+    /**
+     * A `w:id` no other bookmark in this document will use.
+     *
+     * docx's own `Bookmark` cannot supply one: its constructor builds a fresh
+     * id generator per instance (`bookmarkUniqueNumericIdGen()`), so every
+     * bookmark it emits carries `w:id="1"`. Reported upstream as dolanmiu/docx
+     * #3478, still unreleased as of 9.7.1. Duplicated ids leave the start/end
+     * pairing ambiguous, which is why a `REF` field could not read a target's
+     * text even though navigating to it by name worked.
+     */
+    allocateLinkId(): number;
     /**
      * Generate a unique bookmark ID from text
      * Converts text to a URL-friendly format
@@ -63,4 +75,12 @@ export declare class BookmarkRegistry {
     validateReferences(referencedIds: string[]): string[];
 }
 export declare const globalBookmarkRegistry: BookmarkRegistry;
+/**
+ * A bookmark around `children`, as the three elements OOXML actually wants:
+ * `w:bookmarkStart`, the content, `w:bookmarkEnd`.
+ *
+ * Replaces docx's `Bookmark`, which pairs every start/end with `w:id="1"`
+ * (see `allocateLinkId`). Spread the result into a paragraph's children.
+ */
+export declare function createBookmarkedContent(name: string, children: readonly ParagraphChild[]): ParagraphChild[];
 //# sourceMappingURL=bookmarkRegistry.d.ts.map

package/dist/utils/bookmarkRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bookmarkRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/bookmarkRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAC7B,MAAM,CAOR;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE,OAAO,KAAK,KAAK,GAEhB;IAED,4EAA4E;IAC5E,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASvD;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAM5D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAStD;AAGD,eAAO,MAAM,sBAAsB,kBAAyB,CAAC"}
+{"version":3,"file":"bookmarkRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/bookmarkRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAC7B,MAAM,CAOR;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE,OAAO,KAAK,KAAK,GAEhB;IAED,4EAA4E;IAC5E,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASvD;;;;;;;;;OASG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAM5D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAStD;AAGD,eAAO,MAAM,sBAAsB,kBAAyB,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,EAAE,CAOlB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-to-office/core-docx",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Core DOCX document generation engine",
   "type": "module",
   "main": "dist/index.js",
@@ -23,8 +23,8 @@
     "adm-zip": "0.5.16",
     "date-fns": "3.6.0",
     "probe-image-size": "7.2.3",
-    "@json-to-office/shared-docx": "^0.37.0",
-    "@json-to-office/shared": "^0.35.0"
+    "@json-to-office/shared": "^0.35.0",
+    "@json-to-office/shared-docx": "^0.38.0"
   },
   "peerDependencies": {
     "docx": "9.7.1"