@json-to-office/core-docx 0.13.0 → 0.14.0

package/dist/utils/revisionUtils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Revision (tracked-change) rendering utilities
+ *
+ * Turns `revision.segments` from the JSON definition into native Word
+ * revision runs (w:ins / w:del) via docx.js InsertedTextRun / DeletedTextRun.
+ */
+import { TextRun, InsertedTextRun, DeletedTextRun } from 'docx';
+import type { IRunOptions, ParagraphChild } from 'docx';
+import type { Revision } from '@json-to-office/shared-docx';
+export declare const DEFAULT_REVISION_AUTHOR = "json-to-office";
+export declare const DEFAULT_REVISION_DATE = "1970-01-01T00:00:00Z";
+/**
+ * OOXML requires a numeric id on every w:ins / w:del element, unique within
+ * one document. The counter is process-wide and never reset between renders:
+ * concurrent renderDocument calls then draw from disjoint id sets, so
+ * intra-document uniqueness holds even when renders interleave (a per-render
+ * reset would let one render clear the counter mid-flight for another).
+ */
+declare class RevisionIdRegistry {
+    private counter;
+    next(): number;
+    /** Test-only: deterministic ids for snapshot assertions. */
+    clear(): void;
+}
+export declare const globalRevisionIdRegistry: RevisionIdRegistry;
+export type RevisionRun = TextRun | InsertedTextRun | DeletedTextRun;
+type RevisionBaseStyle = Omit<IRunOptions, 'text' | 'children'>;
+/**
+ * Build paragraph children from revision segments.
+ *
+ * Segment text is rendered literally (no markdown parsing): a `**` opened in
+ * one segment could close in another, so decorator parsing cannot work
+ * per-segment. The diff engine strips markdown before diffing for this
+ * reason. Placeholders ({DATE}, {PAGE}, ...) are resolved for unchanged
+ * segments; inside inserted/deleted text they render literally (the diff
+ * summary reports those).
+ */
+export declare function createRevisionRuns(revision: Revision, baseStyle: RevisionBaseStyle): ParagraphChild[];
+/**
+ * True when a component carries revision data anywhere in its subtree
+ * (own props, list items, or any descendant), meaning its render output
+ * embeds document-scoped revision ids and must not be served from the
+ * cross-document component cache.
+ */
+export declare function componentHasRevision(component: {
+    props?: unknown;
+    children?: unknown[];
+}): boolean;
+export {};
+//# sourceMappingURL=revisionUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"revisionUtils.d.ts","sourceRoot":"","sources":["../../src/utils/revisionUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAK5D,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAE5D;;;;;;GAMG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,IAAI,MAAM;IAKd,4DAA4D;IAC5D,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,wBAAwB,oBAA2B,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,eAAe,GAAG,cAAc,CAAC;AAIrE,KAAK,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAgBhE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,iBAAiB,GAC3B,cAAc,EAAE,CAoDlB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,GAAG,OAAO,CA6BV"}

package/package.json

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