@json-to-office/core-docx 1.3.0 → 1.4.0

package/dist/renderers/docxjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderers/docxjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,QAAQ,EAUT,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAqB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,QAAQ,CAAC;AAGhB,eAAO,MAAM,kBAAkB,EAAE,cAAyB,CAAC;AA6B3D,wBAAgB,oBAAoB,IAAI,YAAY,CA0BnD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,aAAyB,GACnC,QAAQ,CA2CV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderers/docxjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,QAAQ,EAUT,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAqB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,QAAQ,CAAC;AAGhB,eAAO,MAAM,kBAAkB,EAAE,cAAyB,CAAC;AAwC3D,wBAAgB,oBAAoB,IAAI,YAAY,CA0BnD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,aAAyB,GACnC,QAAQ,CA2CV"}

package/dist/renderers/office-open/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderers/office-open/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,MAAM,EAEN,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAqB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAWhF,eAAO,MAAM,4BAA4B,EAAE,cAA8B,CAAC;AAwC1E,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,YAAY,CAAC,CAqD1E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,cAAc,EAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4ClC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderers/office-open/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,MAAM,EAEN,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAqB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAWhF,eAAO,MAAM,4BAA4B,EAAE,cAA8B,CAAC;AA8D1E,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,YAAY,CAAC,CAqD1E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,cAAc,EAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4ClC"}

package/dist/renderers/registry.d.ts

@@ -1,15 +1,29 @@
 /**
  * DOCX renderer registry.
  *
- * Adapters are registered as async factories so an optional backend is only
- * imported when it is actually selected — choosing `docxjs` never loads
- * `@office-open/docx`, and a missing optional dependency surfaces as an
- * actionable install hint rather than a bare module-resolution failure.
+ * Adapters are registered as async factories so a backend is only imported
+ * when it is actually selected — choosing `docxjs` never loads
+ * `@office-open/docx`, and a backend that cannot be loaded at all (an
+ * `--omit=optional` install, a broken tree) surfaces as an actionable install
+ * hint rather than a bare module-resolution failure. `statuses()` asks the
+ * same question up front, so a discovery surface never advertises a renderer
+ * that would fail on the first render.
  */
+import { type RendererStatus } from '@json-to-office/shared/rendering';
 import { type DocxRenderer, type DocxRendererId } from './types';
 /** Resolve a renderer by id, defaulting to `docxjs`. */
 export declare function resolveDocxRenderer(id?: DocxRendererId): Promise<DocxRenderer>;
 /** Renderer ids registered for DOCX. */
 export declare function docxRendererIds(): readonly DocxRendererId[];
+/**
+ * Every registered renderer with whether its backend can be loaded here.
+ *
+ * Registration is not availability: the factory only runs on selection, so an
+ * id alone says nothing about whether the render behind it will work. Callers
+ * that advertise renderers — `jto_info`, `jto_discover` — report this instead
+ * of docxRendererIds() so a renderer that cannot run is never offered as one
+ * that can.
+ */
+export declare function docxRendererStatuses(): Promise<RendererStatus<DocxRendererId>[]>;
 export declare function isDocxRendererId(value: string): value is DocxRendererId;
 //# sourceMappingURL=registry.d.ts.map

package/dist/renderers/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/renderers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAiBjB,wDAAwD;AACxD,wBAAgB,mBAAmB,CACjC,EAAE,CAAC,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wCAAwC;AACxC,wBAAgB,eAAe,IAAI,SAAS,cAAc,EAAE,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/renderers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAiBjB,wDAAwD;AACxD,wBAAgB,mBAAmB,CACjC,EAAE,CAAC,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wCAAwC;AACxC,wBAAgB,eAAe,IAAI,SAAS,cAAc,EAAE,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAC7C,cAAc,CAAC,cAAc,CAAC,EAAE,CACjC,CAEA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}

package/dist/styles/themeToStyles.d.ts

@@ -6,7 +6,41 @@
  * shape, so which styles a document defines — and what each one says — is
  * decided once, here, rather than once per renderer.
  */
-import type { DocxIrStyles } from '../ir/types';
+/**
+ * Style ids a `statistic` lowers to.
+ *
+ * Exported because the compiler names them on every statistic paragraph it
+ * emits and the two must not drift: a `w:pStyle` pointing at a style the
+ * document does not define is not an error anywhere in OOXML, it just resolves
+ * to Normal — which is how the component came to render as two ordinary body
+ * paragraphs with nothing to tell the number from its caption.
+ */
+export declare const STATISTIC_NUMBER_STYLE_ID = "StatisticNumber";
+export declare const STATISTIC_DESCRIPTION_STYLE_ID = "StatisticDescription";
+/**
+ * The number's size, in points, per the component's `size` prop.
+ *
+ * `medium` is what the style itself carries; the compiler overrides the run
+ * for the other two, so a document that never states `size` needs no run
+ * properties at all and restyling every statistic stays a one-style edit.
+ */
+export declare const STATISTIC_SIZE_POINTS: Readonly<Record<string, number>>;
+import type { DocxIrParagraphStyle, DocxIrStyles } from '../ir/types';
 import type { ThemeConfig } from './index';
 export declare function createDocumentStyles(themeNameOrObject?: string | ThemeConfig, language?: string): DocxIrStyles;
+/**
+ * The two paragraph styles a `statistic` lowers to.
+ *
+ * Separate from `createDocumentStyles`, and appended by the compiler only when
+ * the document actually contains a statistic. Defining them unconditionally
+ * would rewrite `word/styles.xml` in every document ever produced — including
+ * the ones with no statistic in them — to fix a component most documents never
+ * use, and every recorded golden with it.
+ *
+ * A theme that names either id under `styles` has already had it emitted as a
+ * custom style, so that one is skipped rather than defined twice: two entries
+ * with the same id leave the later one winning, and the later one here is the
+ * default, not the theme's.
+ */
+export declare function createStatisticStyles(theme: ThemeConfig): DocxIrParagraphStyle[];
 //# sourceMappingURL=themeToStyles.d.ts.map

package/dist/styles/themeToStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themeToStyles.d.ts","sourceRoot":"","sources":["../../src/styles/themeToStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAQV,YAAY,EAEb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAoX3C,wBAAgB,oBAAoB,CAClC,iBAAiB,GAAE,MAAM,GAAG,WAAuB,EACnD,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,CAgjBd"}
+{"version":3,"file":"themeToStyles.d.ts","sourceRoot":"","sources":["../../src/styles/themeToStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAC3D,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlE,CAAC;AAEF,OAAO,KAAK,EAMV,oBAAoB,EAEpB,YAAY,EAEb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAoX3C,wBAAgB,oBAAoB,CAClC,iBAAiB,GAAE,MAAM,GAAG,WAAuB,EACnD,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,CAgjBd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,GACjB,oBAAoB,EAAE,CAmExB"}

package/dist/templates/themes/apex.docx.theme.json

@@ -102,8 +102,7 @@
     },
     "list": {
       "format": "bullet",
-      "bullet": "\u2022",
-      "indent": 3
+      "bullet": "\u2022"
     },
     "image": {
       "alignment": "center"

package/dist/templates/themes/corporate.docx.theme.json

@@ -102,8 +102,7 @@
     },
     "list": {
       "format": "bullet",
-      "bullet": "\u2022",
-      "indent": 3
+      "bullet": "\u2022"
     },
     "statistic": {
       "alignment": "center"

package/dist/templates/themes/devportal.docx.theme.json

@@ -110,8 +110,7 @@
     },
     "list": {
       "format": "bullet",
-      "bullet": "\u2013",
-      "indent": 3
+      "bullet": "\u2013"
     },
     "image": {
       "alignment": "center"

package/dist/templates/themes/minimal.docx.theme.json

@@ -170,8 +170,7 @@
     },
     "list": {
       "format": "bullet",
-      "bullet": "•",
-      "indent": 3
+      "bullet": "•"
     },
     "image": {
       "alignment": "left"

package/dist/templates/themes/modern.docx.theme.json

@@ -94,8 +94,7 @@
     },
     "list": {
       "format": "bullet",
-      "bullet": "\u2013",
-      "indent": 3
+      "bullet": "\u2013"
     },
     "image": {
       "alignment": "center"