@json-to-office/core-pptx 0.20.0 → 0.22.0

package/dist/utils/color.d.ts

@@ -4,12 +4,24 @@
  * convention uses '#'-prefixed values (e.g. '#FF0000').
  */
 import type { PptxThemeConfig, PipelineWarning } from '../types';
+import { DEFAULT_CHART_THEME_COLORS } from '@json-to-office/shared';
 /**
- * Default series-color tokens for charts. Shared by the native `chart`
- * component and the `highcharts` component so both palettes stay in sync
- * with the active theme when the author sets no explicit colors.
+ * Default series-color tokens for charts, used by the native `chart` component
+ * and the `highcharts` component. Defined in @json-to-office/shared so the DOCX
+ * `highcharts` component resolves the same tokens; re-exported here because
+ * every PPTX call site already imports colors from this module.
  */
-export declare const DEFAULT_CHART_THEME_COLORS: string[];
+export { DEFAULT_CHART_THEME_COLORS };
+/**
+ * The default chart palette narrowed to the tokens this theme actually defines
+ * *and* can resolve to a color. Both PPTX chart paths build their implicit
+ * palette from this, so an unset accent4-6 is skipped — matching DOCX — instead
+ * of resolving to `primary` six times over, and a slot holding an unresolvable
+ * value is dropped rather than posted as `#primary`. Author-supplied colors must
+ * NOT go through here: naming an undefined token stays a loud `resolveColor`
+ * fallback + warning.
+ */
+export declare function definedChartColorTokens(theme: PptxThemeConfig): string[];
 /**
  * Resolve a color value to bare hex (no '#' prefix).
  * Accepts hex colors (with or without '#') or semantic theme color names.

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

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAiBjE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAOtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,eAAe,EACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,MAAM,CA8BR"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAgBpE;;;;;GAKG;AACH,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAoCtC;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAWxE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,eAAe,EACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,MAAM,CAsCR"}

package/dist/utils/hyperlink.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Slide-targeted hyperlinks
+ *
+ * `hyperlink.slide` is 1-based over the slides *as authored* in the JSON —
+ * slides carrying `enabled: false` still count. Structure processing remaps
+ * every ref to the position its target ends up at in the generated deck, so
+ * toggling one slide off never silently retargets the links after it.
+ *
+ * A ref that cannot be resolved — target dropped, or index outside the
+ * authored range — is marked unresolved here and dropped by the writer with a
+ * warning. It must never reach pptxgenjs: it would emit a relationship to a
+ * `slideN.xml` part that is not in the archive, which PowerPoint reports as a
+ * damaged file.
+ */
+import type { PipelineWarning, PptxComponentInput } from '../types';
+export declare const HYPERLINK_SLIDE_UNRESOLVED = "HYPERLINK_SLIDE_UNRESOLVED";
+export interface HyperlinkProps {
+    url?: string;
+    slide?: number;
+    tooltip?: string;
+    /** Internal: authored `slide` ref that resolves to no rendered slide. */
+    unresolvedSlideRef?: number;
+}
+/** Authored 1-based slide number -> rendered 1-based slide number. */
+export type SlideIndexMap = ReadonlyMap<number, number>;
+/**
+ * Rewrite `hyperlink.slide` in a bare props bag. Template placeholder
+ * `defaults` are merged into a component at render time without ever being a
+ * component themselves, so they need rebasing on their own — otherwise a
+ * `defaults.props.hyperlink.slide` reaches the writer as a raw authored index.
+ */
+export declare function remapHyperlinkProps<T extends Record<string, unknown>>(props: T, map: SlideIndexMap): T;
+/** Rewrite every `hyperlink.slide` in a component subtree. Returns a new tree. */
+export declare function remapHyperlinkSlideRefs(component: PptxComponentInput, map: SlideIndexMap): PptxComponentInput;
+/**
+ * Write the pptxgenjs `hyperlink` option, dropping unresolvable slide refs.
+ * Shared by every component that accepts a hyperlink.
+ */
+export declare function applyHyperlink(opts: Record<string, unknown>, hyperlink: HyperlinkProps | undefined, componentName: string, warnings?: PipelineWarning[]): void;
+//# sourceMappingURL=hyperlink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlink.d.ts","sourceRoot":"","sources":["../../src/utils/hyperlink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEpE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAmBxD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,aAAa,GACjB,CAAC,CAMH;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,GAAG,EAAE,aAAa,GACjB,kBAAkB,CAqBpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,IAAI,CA2BN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-to-office/core-pptx",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Core PPTX presentation generation engine",
   "type": "module",
   "main": "dist/index.js",
@@ -22,8 +22,8 @@
     "jszip": "3.10.1",
     "pptxgenjs": "^3.12.0",
     "probe-image-size": "7.2.3",
-    "@json-to-office/shared": "^0.16.0",
-    "@json-to-office/shared-pptx": "^0.20.0"
+    "@json-to-office/shared": "^0.22.0",
+    "@json-to-office/shared-pptx": "^0.22.0"
   },
   "devDependencies": {
     "@types/node": "20.11.0",