@json-to-office/core-pptx 4.4.1 → 5.4.0

package/dist/index.js

@@ -3937,6 +3937,12 @@ import {
   REMOTE_EXPORT_WARNING,
   chartFamilyResolver,
   chartPointsPerPixel,
+  chartRequestKey,
+  dedupeChartRequest,
+  limitChartRequest,
+  postJsonToService,
+  recordChartRetry,
+  resolveServiceUrl,
   withChartFontFaceCss,
   withChartTypography
 } from "@json-to-office/shared";
@@ -3956,7 +3962,10 @@ async function expandHighchartsComponents(presentation, services, warnings, char
     slideWidth: presentation.slideWidth,
     services,
     warnings,
-    chartFonts
+    chartFonts,
+    // Per deck: a chart repeated on an agenda slide and again in its section
+    // is one render.
+    chartCache: /* @__PURE__ */ new Map()
   };
   const slides = await Promise.all(
     presentation.slides.map(async (slide, index) => ({
@@ -3992,19 +4001,24 @@ async function expandList(components, path4, scope) {
 }
 async function expandOne(component, path4, scope) {
   const props = component.props;
-  const chart = await renderChart(
-    withChartFontFaces(
-      withThemeTypography(
-        withThemeColors(props, scope.theme, scope.warnings),
+  const chart = await limitChartRequest(
+    exportServerUrl(props.serverUrl, scope.services?.serverUrl),
+    scope.services?.concurrency,
+    () => renderChart(
+      withChartFontFaces(
+        withThemeTypography(
+          withThemeColors(props, scope.theme, scope.warnings),
+          scope.theme,
+          scope.slideWidth,
+          scope.warnings
+        ),
         scope.theme,
-        scope.slideWidth,
-        scope.warnings
+        scope.chartFonts
       ),
-      scope.theme,
-      scope.chartFonts
-    ),
-    scope.services,
-    scope.warnings
+      scope.services,
+      scope.warnings,
+      scope.chartCache
+    )
   );
   void path4;
   return {
@@ -4021,14 +4035,18 @@ async function expandOne(component, path4, scope) {
 }
 function assertExportServerAllowed(serverUrl, services, warnings) {
   const notice = remoteExportNotice(serverUrl, services?.allowRemote);
-  if (notice)
-    warnings.push({
-      code: REMOTE_EXPORT_WARNING,
-      component: "highcharts",
-      message: notice
-    });
+  if (!notice) return;
+  const alreadySaid = warnings.some(
+    (warning) => warning.code === REMOTE_EXPORT_WARNING && warning.message === notice
+  );
+  if (alreadySaid) return;
+  warnings.push({
+    code: REMOTE_EXPORT_WARNING,
+    component: "highcharts",
+    message: notice
+  });
 }
-async function renderChart(config, services, warnings) {
+async function renderChart(config, services, warnings, cache) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Highcharts export server requires a Node.js environment. Chart generation is not available in browser environments."
@@ -4045,25 +4063,27 @@ async function renderChart(config, services, warnings) {
     // for callers that omit it.
     ...config.resources ? { resources: config.resources } : {}
   };
-  const resolvedHeaders = typeof services?.headers === "function" ? await services.headers(requestBody) : services?.headers;
-  const response = await fetch(`${serverUrl}/export`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json", ...resolvedHeaders },
-    body: JSON.stringify(requestBody)
-  }).catch((error) => {
-    throw Object.assign(
-      new Error(
-        `Highcharts Export Server is not running at ${serverUrl}. Start it with: npx highcharts-export-server --enableServer true
-Cause: ${error instanceof Error ? error.message : String(error)}`
-      ),
-      { code: "SERVICE_UNAVAILABLE" }
-    );
+  return dedupeChartRequest(
+    cache,
+    chartRequestKey(serverUrl, requestBody),
+    () => postChart(serverUrl, requestBody, config, services)
+  );
+}
+async function postChart(serverUrl, requestBody, config, services) {
+  const response = await postJsonToService({
+    url: serverUrl,
+    path: "/export",
+    body: requestBody,
+    headers: services?.headers,
+    timeoutMs: services?.timeoutMs,
+    retries: services?.retries,
+    onRetry: recordChartRetry,
+    serviceLabel: "Highcharts export server",
+    // The code lets a server route report a missing export server as a
+    // dependency outage with this message, not as an internal error.
+    onUnreachable: (url, cause) => `Highcharts Export Server is not running at ${url}. Start it with: npx highcharts-export-server --enableServer true
+Cause: ${cause}`
   });
-  if (!response.ok) {
-    throw new Error(
-      `Highcharts export server returned ${response.status}: ${response.statusText}`
-    );
-  }
   return {
     dataUri: `data:image/png;base64,${await response.text()}`,
     widthPx: config.options.chart?.width ?? DEFAULT_CHART_WIDTH_PX,
@@ -4071,8 +4091,7 @@ Cause: ${error instanceof Error ? error.message : String(error)}`
   };
 }
 function exportServerUrl(propsUrl, servicesUrl) {
-  const raw = propsUrl || servicesUrl || DEFAULT_EXPORT_SERVER_URL;
-  return raw.startsWith("http") ? raw : `http://${raw}`;
+  return resolveServiceUrl(propsUrl, servicesUrl, DEFAULT_EXPORT_SERVER_URL);
 }
 function withThemeColors(props, theme, warnings) {
   if (!props.options || props.options.colors || !theme?.colors) return props;
@@ -4264,100 +4283,637 @@ function isPrivateUrl(urlString) {
       const second = Number.parseInt(hostname.split(".")[1], 10);
       if (second >= 16 && second <= 31) return true;
     }
-    return false;
-  } catch {
-    return true;
-  }
-}
-async function probeIntrinsicSize(source, warnings) {
-  try {
-    if (/^data:image\//.test(source)) {
-      const base64Data = source.split(",")[1];
-      if (!base64Data) return void 0;
-      const result2 = probe.sync(Buffer.from(base64Data, "base64"));
-      return result2 ? { width: result2.width, height: result2.height } : void 0;
+    return false;
+  } catch {
+    return true;
+  }
+}
+async function probeIntrinsicSize(source, warnings) {
+  try {
+    if (/^data:image\//.test(source)) {
+      const base64Data = source.split(",")[1];
+      if (!base64Data) return void 0;
+      const result2 = probe.sync(Buffer.from(base64Data, "base64"));
+      return result2 ? { width: result2.width, height: result2.height } : void 0;
+    }
+    if (/^https?:\/\//.test(source)) {
+      if (isPrivateUrl(source)) return void 0;
+      const result2 = await probe(source, { timeout: 5e3 });
+      return { width: result2.width, height: result2.height };
+    }
+    const resolved = path3.resolve(resolveFromBaseDir(source));
+    if (!isAllowedLocalPath(resolved)) return void 0;
+    const { createReadStream } = await import("fs");
+    const result = await probe(createReadStream(resolved));
+    return result ? { width: result.width, height: result.height } : void 0;
+  } catch (error) {
+    warn(
+      warnings,
+      W.IMAGE_PROBE_FAILED,
+      `Image probe failed: ${error instanceof Error ? error.message : String(error)}`,
+      { component: "image" }
+    );
+    return void 0;
+  }
+}
+
+// src/quality/facts.ts
+import {
+  chartEncodingFor,
+  collectColorLiterals,
+  collectFontFamilies,
+  collectPlaceholders,
+  hasUnitMarker,
+  normalizeHex,
+  normalizeHighchartsChart,
+  parseNumericCell
+} from "@json-to-office/quality";
+import {
+  DEFAULT_PPTX_RENDERER_ID as DEFAULT_PPTX_RENDERER_ID2,
+  SEMANTIC_COLOR_NAMES as SEMANTIC_COLOR_NAMES2
+} from "@json-to-office/shared-pptx";
+import { designColors as designColors2 } from "@json-to-office/shared";
+
+// src/core/generationContext.ts
+import { applyExportMode } from "@json-to-office/shared";
+
+// src/themes/consulting.pptx.theme.json
+var consulting_pptx_theme_default = {
+  name: "consulting",
+  displayName: "Consulting House",
+  description: "The house style for decision decks \u2014 near-black ink, three greys and one deep-blue accent, Calibri body under Arial headings, hairline rules, no fills behind text, safe fonts only",
+  whenToUse: "Decision decks and client readouts: one message per slide, a chart that carries it, a source under it; the twin of the DOCX house theme, so a deck and its report match.",
+  version: "1.0.0",
+  colors: {
+    primary: "#1A1F26",
+    secondary: "#4B5563",
+    accent: "#1B4F8A",
+    background: "#FFFFFF",
+    text: "#1A1F26",
+    text2: "#4B5563",
+    background2: "#F2F4F7",
+    accent4: "#5B8DC9",
+    accent5: "#A9C4E4",
+    accent6: "#7B8794"
+  },
+  palette: {
+    rule: "#C9CED6",
+    textMuted: "#7B8794",
+    onPrimary: "#FFFFFF",
+    surfaceInverse: "#1A1F26",
+    positive: "#1E7F4F",
+    negative: "#B42318",
+    chart: ["accent", "secondary", "accent4", "textMuted", "accent5", "rule"]
+  },
+  fonts: {
+    heading: "Arial",
+    body: "Calibri",
+    mono: "Consolas"
+  },
+  defaults: {
+    fontSize: 14,
+    fontColor: "#1A1F26"
+  },
+  styles: {
+    title: {
+      fontSize: 32,
+      bold: true,
+      fontColor: "text",
+      align: "left"
+    },
+    subtitle: {
+      fontSize: 16,
+      fontColor: "text2",
+      align: "left"
+    },
+    heading1: {
+      fontSize: 24,
+      bold: true,
+      fontColor: "text"
+    },
+    heading2: {
+      fontSize: 18,
+      bold: true,
+      fontColor: "text"
+    },
+    heading3: {
+      fontSize: 14,
+      bold: true,
+      fontColor: "text2"
+    },
+    body: {
+      fontSize: 14,
+      fontColor: "text"
+    },
+    caption: {
+      fontSize: 10,
+      fontColor: "text2"
+    }
+  },
+  typography: {
+    roles: {
+      eyebrow: {
+        face: "heading",
+        size: 10,
+        weight: 700,
+        case: "upper",
+        tracking: 8,
+        color: "accent"
+      },
+      display: {
+        face: "heading",
+        size: 28,
+        weight: 700,
+        color: "primary",
+        lineHeight: 1.1
+      },
+      stat: {
+        face: "heading",
+        size: 40,
+        weight: 700,
+        color: "accent",
+        lineHeight: 1
+      },
+      quote: {
+        face: "body",
+        size: 18,
+        color: "text2",
+        lineHeight: 1.3
+      },
+      label: {
+        face: "body",
+        size: 12,
+        weight: 700,
+        color: "text2"
+      },
+      footer: {
+        face: "body",
+        size: 9,
+        color: "text2"
+      },
+      tableHeader: {
+        face: "body",
+        size: 12,
+        weight: 700,
+        color: "primary"
+      },
+      tableCell: {
+        face: "body",
+        size: 12,
+        color: "text"
+      },
+      chartLabel: {
+        face: "body",
+        size: 11,
+        weight: 400,
+        color: "text2"
+      },
+      tracker: {
+        face: "body",
+        size: 10,
+        case: "upper",
+        tracking: 6,
+        color: "text2"
+      },
+      source: {
+        face: "body",
+        size: 9,
+        color: "text2"
+      }
+    },
+    scale: {
+      wide169: {
+        base: 14,
+        ratio: 1.2,
+        baselinePt: 2
+      },
+      standard43: {
+        base: 14,
+        ratio: 1.2,
+        baselinePt: 2
+      }
+    }
+  },
+  spacing: {
+    basePt: 8,
+    blockGap: {
+      tight: 4,
+      normal: 8,
+      loose: 16
+    },
+    canvas: {
+      wide169: {
+        safeAreaIn: 0.5,
+        gutterIn: 0.2,
+        columns: 12,
+        rows: 8
+      },
+      standard43: {
+        safeAreaIn: 0.5,
+        gutterIn: 0.2,
+        columns: 12,
+        rows: 8
+      }
+    }
+  },
+  chrome: {
+    runningHead: {
+      type: "tracker",
+      color: "text2",
+      rule: {
+        weightPt: 0.5,
+        color: "rule"
+      },
+      alignment: "right"
+    },
+    tracker: {
+      type: "tracker",
+      color: "text2",
+      alignment: "right"
+    },
+    actionTitle: {
+      type: "display",
+      color: "primary"
+    },
+    keyTakeaways: {
+      type: "label",
+      color: "primary",
+      rule: {
+        weightPt: 2,
+        color: "accent"
+      },
+      padPt: 8
+    },
+    sourceLine: {
+      type: "source",
+      color: "text2"
+    },
+    confidentialFooter: {
+      type: "footer",
+      color: "text2",
+      rule: {
+        weightPt: 0.5,
+        color: "rule"
+      },
+      alignment: "left"
+    },
+    logoSlot: {
+      alignment: "right"
+    },
+    cover: {
+      type: "display",
+      color: "primary",
+      rule: {
+        weightPt: 3,
+        color: "accent"
+      }
+    }
+  },
+  motif: {
+    kind: "rule",
+    color: "accent",
+    weightPt: 3,
+    placement: "top"
+  },
+  componentDefaults: {
+    table: {
+      border: {
+        type: "solid",
+        pt: 0.5,
+        color: "#C9CED6"
+      },
+      headerRow: true,
+      fontSize: 12
+    },
+    chart: {
+      showLegend: true,
+      legendPos: "b",
+      legendFontSize: 11,
+      catAxisLabelFontSize: 11,
+      valAxisLabelFontSize: 11,
+      catGridLine: {
+        style: "none"
+      },
+      valGridLine: {
+        style: "solid",
+        size: 0.5,
+        color: "#E4E7EB"
+      },
+      valAxisLineShow: false
+    }
+  }
+};
+
+// src/themes/consulting.ts
+var CONSULTING_PPTX_THEME = consulting_pptx_theme_default;
+
+// src/themes/vermilion.pptx.theme.json
+var vermilion_pptx_theme_default = {
+  name: "vermilion",
+  displayName: "Vermilion Editorial",
+  description: "Poster-red editorial deck \u2014 vermilion display titles, ink text, warm creams and hairline rules; the twin of the DOCX vermilion theme",
+  whenToUse: "Talks and readouts that want a strong red display voice beside a vermilion report: a few large titles, one figure per slide. Not for a dense data deck.",
+  version: "1.0.0",
+  colors: {
+    primary: "#282829",
+    secondary: "#58595B",
+    accent: "#EF4130",
+    background: "#FFFFFF",
+    text: "#282829",
+    text2: "#58595B",
+    background2: "#FAF7F5",
+    accent4: "#F4857A",
+    accent5: "#F9C4BE",
+    accent6: "#939598"
+  },
+  palette: {
+    rule: "#C7C8CA",
+    textMuted: "#939598",
+    onPrimary: "#FFFFFF",
+    surfaceInverse: "#282829",
+    positive: "#2E7D4F",
+    negative: "#B42318",
+    chart: ["accent", "primary", "textMuted", "accent4", "rule", "accent5"]
+  },
+  fonts: {
+    heading: "Arial",
+    body: "Calibri",
+    mono: "Courier New"
+  },
+  defaults: {
+    fontSize: 14,
+    fontColor: "#282829"
+  },
+  styles: {
+    title: {
+      fontSize: 32,
+      bold: true,
+      fontColor: "accent",
+      align: "left"
+    },
+    subtitle: {
+      fontSize: 16,
+      fontColor: "text2",
+      align: "left"
+    },
+    heading1: {
+      fontSize: 24,
+      bold: true,
+      fontColor: "accent"
+    },
+    heading2: {
+      fontSize: 18,
+      bold: true,
+      fontColor: "text"
+    },
+    heading3: {
+      fontSize: 14,
+      bold: true,
+      fontColor: "text2"
+    },
+    body: {
+      fontSize: 14,
+      fontColor: "text"
+    },
+    caption: {
+      fontSize: 10,
+      fontColor: "text2"
+    }
+  },
+  typography: {
+    roles: {
+      eyebrow: {
+        face: "heading",
+        size: 10,
+        weight: 700,
+        case: "upper",
+        tracking: 8,
+        color: "accent"
+      },
+      display: {
+        face: "heading",
+        size: 28,
+        weight: 700,
+        color: "accent",
+        lineHeight: 1.1
+      },
+      stat: {
+        face: "heading",
+        size: 40,
+        weight: 700,
+        color: "accent",
+        lineHeight: 1
+      },
+      quote: {
+        face: "body",
+        size: 18,
+        color: "text2",
+        lineHeight: 1.3
+      },
+      label: {
+        face: "body",
+        size: 12,
+        weight: 700,
+        color: "text2"
+      },
+      footer: {
+        face: "body",
+        size: 9,
+        color: "text2"
+      },
+      tableHeader: {
+        face: "body",
+        size: 12,
+        weight: 700,
+        color: "accent"
+      },
+      tableCell: {
+        face: "body",
+        size: 12,
+        color: "text"
+      },
+      chartLabel: {
+        face: "body",
+        size: 11,
+        weight: 400,
+        color: "text2"
+      },
+      tracker: {
+        face: "body",
+        size: 10,
+        case: "upper",
+        tracking: 6,
+        color: "text2"
+      },
+      source: {
+        face: "body",
+        size: 9,
+        color: "text2"
+      }
+    },
+    scale: {
+      wide169: {
+        base: 14,
+        ratio: 1.2,
+        baselinePt: 2
+      },
+      standard43: {
+        base: 14,
+        ratio: 1.2,
+        baselinePt: 2
+      }
+    }
+  },
+  spacing: {
+    basePt: 8,
+    blockGap: {
+      tight: 4,
+      normal: 8,
+      loose: 16
+    },
+    canvas: {
+      wide169: {
+        safeAreaIn: 0.5,
+        gutterIn: 0.2,
+        columns: 12,
+        rows: 8
+      },
+      standard43: {
+        safeAreaIn: 0.5,
+        gutterIn: 0.2,
+        columns: 12,
+        rows: 8
+      }
+    }
+  },
+  chrome: {
+    runningHead: {
+      type: "tracker",
+      color: "text2",
+      rule: {
+        weightPt: 0.5,
+        color: "rule"
+      },
+      alignment: "right"
+    },
+    tracker: {
+      type: "tracker",
+      color: "text2",
+      alignment: "right"
+    },
+    actionTitle: {
+      type: "display",
+      color: "primary"
+    },
+    keyTakeaways: {
+      type: "label",
+      color: "primary",
+      rule: {
+        weightPt: 1.5,
+        color: "accent"
+      },
+      padPt: 8
+    },
+    sourceLine: {
+      type: "source",
+      color: "text2"
+    },
+    confidentialFooter: {
+      type: "footer",
+      color: "text2",
+      rule: {
+        weightPt: 0.5,
+        color: "rule"
+      },
+      alignment: "left"
+    },
+    logoSlot: {
+      alignment: "right"
+    },
+    cover: {
+      type: "display",
+      color: "primary",
+      rule: {
+        weightPt: 4,
+        color: "accent"
+      }
     }
-    if (/^https?:\/\//.test(source)) {
-      if (isPrivateUrl(source)) return void 0;
-      const result2 = await probe(source, { timeout: 5e3 });
-      return { width: result2.width, height: result2.height };
+  },
+  motif: {
+    kind: "rule",
+    color: "accent",
+    weightPt: 4,
+    placement: "top"
+  },
+  componentDefaults: {
+    table: {
+      border: {
+        type: "solid",
+        pt: 0.5,
+        color: "#C7C8CA"
+      },
+      headerRow: true,
+      fontSize: 12
+    },
+    chart: {
+      showLegend: true,
+      legendPos: "b",
+      legendFontSize: 11,
+      catAxisLabelFontSize: 11,
+      valAxisLabelFontSize: 11,
+      catGridLine: {
+        style: "none"
+      },
+      valGridLine: {
+        style: "solid",
+        size: 0.5,
+        color: "#EFEAE4"
+      },
+      valAxisLineShow: false
     }
-    const resolved = path3.resolve(resolveFromBaseDir(source));
-    if (!isAllowedLocalPath(resolved)) return void 0;
-    const { createReadStream } = await import("fs");
-    const result = await probe(createReadStream(resolved));
-    return result ? { width: result.width, height: result.height } : void 0;
-  } catch (error) {
-    warn(
-      warnings,
-      W.IMAGE_PROBE_FAILED,
-      `Image probe failed: ${error instanceof Error ? error.message : String(error)}`,
-      { component: "image" }
-    );
-    return void 0;
   }
-}
-
-// src/quality/facts.ts
-import {
-  chartEncodingFor,
-  collectColorLiterals,
-  collectFontFamilies,
-  collectPlaceholders,
-  hasUnitMarker,
-  normalizeHex,
-  normalizeHighchartsChart,
-  parseNumericCell
-} from "@json-to-office/quality";
-import {
-  DEFAULT_PPTX_RENDERER_ID as DEFAULT_PPTX_RENDERER_ID2,
-  SEMANTIC_COLOR_NAMES as SEMANTIC_COLOR_NAMES2
-} from "@json-to-office/shared-pptx";
-import { designColors as designColors2 } from "@json-to-office/shared";
-
-// src/core/generationContext.ts
-import { applyExportMode } from "@json-to-office/shared";
+};
 
-// src/themes/consulting.pptx.theme.json
-var consulting_pptx_theme_default = {
-  name: "consulting",
-  displayName: "Consulting House",
-  description: "The house style for decision decks \u2014 near-black ink, three greys and one deep-blue accent, Calibri body under Arial headings, hairline rules, no fills behind text, safe fonts only",
-  whenToUse: "Decision decks and client readouts: one message per slide, a chart that carries it, a source under it; the twin of the DOCX house theme, so a deck and its report match.",
+// src/themes/devportal.pptx.theme.json
+var devportal_pptx_theme_default = {
+  name: "devportal",
+  displayName: "Field Editorial",
+  description: "Compact editorial deck \u2014 Helvetica in near-black ink with a burnt-orange accent, tight titles, letterspaced labels, warm tinted fills and hairline rules; the twin of the DOCX devportal theme",
+  whenToUse: "Product and engineering readouts, API and platform reviews: dense text, code and tables beside a devportal report. Not for a client's decision deck.",
   version: "1.0.0",
   colors: {
-    primary: "#1A1F26",
-    secondary: "#4B5563",
-    accent: "#1B4F8A",
+    primary: "#12191F",
+    secondary: "#172028",
+    accent: "#E35B3F",
     background: "#FFFFFF",
-    text: "#1A1F26",
-    text2: "#4B5563",
-    background2: "#F2F4F7",
-    accent4: "#5B8DC9",
-    accent5: "#A9C4E4",
-    accent6: "#7B8794"
+    text: "#232323",
+    text2: "#46494C",
+    background2: "#F7ECE7",
+    accent4: "#46494C",
+    accent5: "#8A9299",
+    accent6: "#E8A18D"
   },
   palette: {
-    rule: "#C9CED6",
-    textMuted: "#7B8794",
+    rule: "#D8D5D1",
+    textMuted: "#737373",
     onPrimary: "#FFFFFF",
-    surfaceInverse: "#1A1F26",
-    positive: "#1E7F4F",
+    surfaceInverse: "#12191F",
+    positive: "#2E7D4F",
     negative: "#B42318",
-    chart: ["accent", "secondary", "accent4", "textMuted", "accent5", "rule"]
+    chart: ["accent", "primary", "accent4", "accent5", "accent6", "rule"]
   },
   fonts: {
-    heading: "Arial",
-    body: "Calibri",
-    mono: "Consolas"
+    heading: "Helvetica",
+    body: "Helvetica",
+    mono: "Courier New"
   },
   defaults: {
     fontSize: 14,
-    fontColor: "#1A1F26"
+    fontColor: "#232323"
   },
   styles: {
     title: {
-      fontSize: 32,
+      fontSize: 30,
       bold: true,
       fontColor: "text",
       align: "left"
@@ -4370,12 +4926,12 @@ var consulting_pptx_theme_default = {
     heading1: {
       fontSize: 24,
       bold: true,
-      fontColor: "text"
+      fontColor: "primary"
     },
     heading2: {
       fontSize: 18,
       bold: true,
-      fontColor: "text"
+      fontColor: "secondary"
     },
     heading3: {
       fontSize: 14,
@@ -4398,7 +4954,7 @@ var consulting_pptx_theme_default = {
         size: 10,
         weight: 700,
         case: "upper",
-        tracking: 8,
+        tracking: 10,
         color: "accent"
       },
       display: {
@@ -4406,7 +4962,8 @@ var consulting_pptx_theme_default = {
         size: 28,
         weight: 700,
         color: "primary",
-        lineHeight: 1.1
+        lineHeight: 1.1,
+        tracking: -2
       },
       stat: {
         face: "heading",
@@ -4425,7 +4982,9 @@ var consulting_pptx_theme_default = {
         face: "body",
         size: 12,
         weight: 700,
-        color: "text2"
+        color: "text2",
+        case: "upper",
+        tracking: 6
       },
       footer: {
         face: "body",
@@ -4436,7 +4995,7 @@ var consulting_pptx_theme_default = {
         face: "body",
         size: 12,
         weight: 700,
-        color: "primary"
+        color: "secondary"
       },
       tableCell: {
         face: "body",
@@ -4520,7 +5079,7 @@ var consulting_pptx_theme_default = {
       type: "label",
       color: "primary",
       rule: {
-        weightPt: 2,
+        weightPt: 1,
         color: "accent"
       },
       padPt: 8
@@ -4553,7 +5112,7 @@ var consulting_pptx_theme_default = {
   motif: {
     kind: "rule",
     color: "accent",
-    weightPt: 3,
+    weightPt: 2,
     placement: "top"
   },
   componentDefaults: {
@@ -4561,7 +5120,7 @@ var consulting_pptx_theme_default = {
       border: {
         type: "solid",
         pt: 0.5,
-        color: "#C9CED6"
+        color: "#D8D5D1"
       },
       headerRow: true,
       fontSize: 12
@@ -4578,15 +5137,16 @@ var consulting_pptx_theme_default = {
       valGridLine: {
         style: "solid",
         size: 0.5,
-        color: "#E4E7EB"
+        color: "#F2F3F3"
       },
       valAxisLineShow: false
     }
   }
 };
 
-// src/themes/consulting.ts
-var CONSULTING_PPTX_THEME = consulting_pptx_theme_default;
+// src/themes/alternates.ts
+var VERMILION_PPTX_THEME = vermilion_pptx_theme_default;
+var DEVPORTAL_PPTX_THEME = devportal_pptx_theme_default;
 
 // src/themes/defaults.ts
 var DEFAULT_TABLE = {
@@ -4633,6 +5193,8 @@ var DEFAULT_PPTX_THEME = {
 var PPTX_THEMES = {
   default: DEFAULT_PPTX_THEME,
   consulting: CONSULTING_PPTX_THEME,
+  vermilion: VERMILION_PPTX_THEME,
+  devportal: DEVPORTAL_PPTX_THEME,
   dark: {
     name: "dark",
     displayName: "Dark",
@@ -6258,8 +6820,8 @@ async function generateAndSaveFromJson(jsonConfig, outputPath, options) {
   writeFileSync(outputPath, buffer);
 }
 async function generateFromFile(filePath, outputPath, options) {
-  const { readFileSync } = await import("fs");
-  const json = readFileSync(filePath, "utf-8");
+  const { readFileSync: readFileSync2 } = await import("fs");
+  const json = readFileSync2(filePath, "utf-8");
   await generateAndSaveFromJson(json, outputPath, options);
 }
 var PresentationGenerator = {
@@ -6273,6 +6835,620 @@ var PresentationGenerator = {
 // src/index.ts
 init_finalizePackage();
 init_warn();
+import {
+  getChartRequestStats,
+  resetChartRequestStats
+} from "@json-to-office/shared";
+
+// src/blueprints/index.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import {
+  instantiateBlueprint,
+  registerBlueprints
+} from "@json-to-office/shared";
+import { collectPlaceholders as collectPlaceholders2 } from "@json-to-office/quality";
+
+// src/templates/blueprints/consulting-deck.pptx.blueprint.json
+var consulting_deck_pptx_blueprint_default = {
+  id: "consulting-deck",
+  format: "pptx",
+  title: "Consulting deck",
+  description: "A decision deck for a client readout: a cover, the quarter in numbers, one action-chart per finding with its takeaway and source, a two-column slide for the evidence that is a table or a list, a closing statement; every slide invokes one of the five consulting blocks on the house theme.",
+  whenToUse: "A client readout, a board update or a steering-committee deck: one message per slide, a chart or table that carries it, a source under it. Not for a talk track or a training deck.",
+  theme: "consulting",
+  profile: "consulting-deck",
+  definitions: "consulting-deck-blocks.pptx.json",
+  numbering: "none",
+  toc: false,
+  variants: {
+    "data-heavy": {
+      description: "Evidence-led: cover, a KPI row, three action-charts, a two-column table slide, a closing statement.",
+      whenToUse: "The brief comes with numbers the audience will check: performance, finance, operations.",
+      pages: {
+        min: 6,
+        max: 9
+      },
+      metadata: {
+        title: "{{Title: as on the cover}}",
+        author: "{{Author or team}}",
+        company: "{{Client name}}"
+      },
+      children: [
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "cover",
+                slots: {
+                  title: "{{Title: the deck's conclusion in one sentence}}",
+                  subtitle: "{{Subtitle: what the deck answers, for whom}}",
+                  client: "{{Client name}}",
+                  date: "{{Month YYYY}}",
+                  confidentiality: "{{Confidentiality: Confidential, or For internal use}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "kpi-row",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  items: [
+                    {
+                      value: "{{0.0}}",
+                      unit: "{{unit}}",
+                      label: "{{What it measures}}",
+                      delta: "{{+0.0}}"
+                    },
+                    {
+                      value: "{{0.0}}",
+                      unit: "{{unit}}",
+                      label: "{{What it measures}}",
+                      delta: "{{+0.0}}"
+                    },
+                    {
+                      value: "{{0.0}}",
+                      unit: "{{unit}}",
+                      label: "{{What it measures}}",
+                      delta: "{{+0.0}}"
+                    }
+                  ],
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "action-chart",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  chart: {
+                    name: "chart",
+                    props: {
+                      type: "bar",
+                      valAxisTitle: "{{Measure (unit)}}",
+                      data: [
+                        {
+                          name: "{{Series name}}",
+                          labels: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ],
+                          values: [0, 0, 0]
+                        }
+                      ],
+                      chartColors: [
+                        "accent",
+                        "secondary",
+                        "accent4",
+                        "accent6",
+                        "accent5"
+                      ]
+                    }
+                  },
+                  takeaway: "{{Takeaway: what the reader should conclude, one or two sentences}}",
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "action-chart",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  chart: {
+                    name: "chart",
+                    props: {
+                      type: "bar",
+                      valAxisTitle: "{{Measure (unit)}}",
+                      data: [
+                        {
+                          name: "{{Series name}}",
+                          labels: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ],
+                          values: [0, 0, 0]
+                        }
+                      ],
+                      chartColors: [
+                        "accent",
+                        "secondary",
+                        "accent4",
+                        "accent6",
+                        "accent5"
+                      ]
+                    }
+                  },
+                  takeaway: "{{Takeaway: what the reader should conclude, one or two sentences}}",
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "action-chart",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  chart: {
+                    name: "chart",
+                    props: {
+                      type: "bar",
+                      valAxisTitle: "{{Measure (unit)}}",
+                      data: [
+                        {
+                          name: "{{Series name}}",
+                          labels: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ],
+                          values: [0, 0, 0]
+                        }
+                      ],
+                      chartColors: [
+                        "accent",
+                        "secondary",
+                        "accent4",
+                        "accent6",
+                        "accent5"
+                      ]
+                    }
+                  },
+                  takeaway: "{{Takeaway: what the reader should conclude, one or two sentences}}",
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "two-column",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  bullets: [
+                    "{{Bullet 1: one claim, ten words}}",
+                    "{{Bullet 2: one claim, ten words}}",
+                    "{{Bullet 3: one claim, ten words}}"
+                  ],
+                  content: {
+                    name: "table",
+                    props: {
+                      rows: [
+                        [
+                          "{{Row label}}",
+                          {
+                            text: "{{Column (unit)}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{Column (unit)}}",
+                            align: "right"
+                          }
+                        ],
+                        [
+                          "{{Row 1}}",
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          }
+                        ],
+                        [
+                          "{{Row 2}}",
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          }
+                        ],
+                        [
+                          "{{Row 3}}",
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          }
+                        ]
+                      ]
+                    }
+                  },
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "statement",
+                slots: {
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  assertion: "{{Assertion: what to do next, in one sentence}}",
+                  support: "{{Support: what backs the assertion, under thirty words}}"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    narrative: {
+      description: "Argument-led: cover, the position as a statement, two two-column slides that argue it beside a chart, one action-chart, a two-column table, a closing statement.",
+      whenToUse: "The brief is a position or a recommendation with few numbers; the audience follows an argument.",
+      pages: {
+        min: 6,
+        max: 8
+      },
+      metadata: {
+        title: "{{Title: as on the cover}}",
+        author: "{{Author or team}}",
+        company: "{{Client name}}"
+      },
+      children: [
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "cover",
+                slots: {
+                  title: "{{Title: the deck's conclusion in one sentence}}",
+                  subtitle: "{{Subtitle: what the deck answers, for whom}}",
+                  client: "{{Client name}}",
+                  date: "{{Month YYYY}}",
+                  confidentiality: "{{Confidentiality: Confidential, or For internal use}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "statement",
+                slots: {
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  assertion: "{{Assertion: the position, in one sentence}}",
+                  support: "{{Support: what backs the assertion, under thirty words}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "two-column",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  text: "{{Body: the argument this slide makes, under fifty words}}",
+                  content: {
+                    name: "chart",
+                    props: {
+                      type: "bar",
+                      valAxisTitle: "{{Measure (unit)}}",
+                      data: [
+                        {
+                          name: "{{Series name}}",
+                          labels: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ],
+                          values: [0, 0, 0]
+                        }
+                      ],
+                      chartColors: [
+                        "accent",
+                        "secondary",
+                        "accent4",
+                        "accent6",
+                        "accent5"
+                      ]
+                    }
+                  },
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "two-column",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  text: "{{Body: the argument this slide makes, under fifty words}}",
+                  content: {
+                    name: "chart",
+                    props: {
+                      type: "bar",
+                      valAxisTitle: "{{Measure (unit)}}",
+                      data: [
+                        {
+                          name: "{{Series name}}",
+                          labels: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ],
+                          values: [0, 0, 0]
+                        }
+                      ],
+                      chartColors: [
+                        "accent",
+                        "secondary",
+                        "accent4",
+                        "accent6",
+                        "accent5"
+                      ]
+                    }
+                  },
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "action-chart",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  chart: {
+                    name: "chart",
+                    props: {
+                      type: "bar",
+                      valAxisTitle: "{{Measure (unit)}}",
+                      data: [
+                        {
+                          name: "{{Series name}}",
+                          labels: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ],
+                          values: [0, 0, 0]
+                        }
+                      ],
+                      chartColors: [
+                        "accent",
+                        "secondary",
+                        "accent4",
+                        "accent6",
+                        "accent5"
+                      ]
+                    }
+                  },
+                  takeaway: "{{Takeaway: what the reader should conclude, one or two sentences}}",
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "two-column",
+                slots: {
+                  title: "{{Action title: the claim this slide proves, with its number, two lines at most}}",
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  bullets: [
+                    "{{Bullet 1: one claim, ten words}}",
+                    "{{Bullet 2: one claim, ten words}}",
+                    "{{Bullet 3: one claim, ten words}}"
+                  ],
+                  content: {
+                    name: "table",
+                    props: {
+                      rows: [
+                        [
+                          "{{Row label}}",
+                          {
+                            text: "{{Column (unit)}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{Column (unit)}}",
+                            align: "right"
+                          }
+                        ],
+                        [
+                          "{{Row 1}}",
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          }
+                        ],
+                        [
+                          "{{Row 2}}",
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          }
+                        ],
+                        [
+                          "{{Row 3}}",
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          },
+                          {
+                            text: "{{0.0}}",
+                            align: "right"
+                          }
+                        ]
+                      ]
+                    }
+                  },
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "slide",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "statement",
+                slots: {
+                  tracker: "{{Tracker: the section, one or two words}}",
+                  assertion: "{{Assertion: what to do next, in one sentence}}",
+                  support: "{{Support: what backs the assertion, under thirty words}}"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  }
+};
+
+// src/blueprints/index.ts
+function scanned(known) {
+  let here;
+  try {
+    here = dirname(fileURLToPath(import.meta.url));
+  } catch {
+    return [];
+  }
+  const directory = [
+    join(here, "../templates/blueprints"),
+    join(here, "templates/blueprints")
+  ].find((path4) => existsSync(path4));
+  if (!directory) return [];
+  return readdirSync(directory).filter((file) => file.endsWith(".pptx.blueprint.json")).map((file) => JSON.parse(readFileSync(join(directory, file), "utf8"))).filter((candidate) => {
+    const id = candidate?.id;
+    return !(typeof id === "string" && id in known);
+  });
+}
+var bundled = registerBlueprints("pptx", [consulting_deck_pptx_blueprint_default]);
+var PPTX_BLUEPRINTS = {
+  ...bundled,
+  ...registerBlueprints("pptx", scanned(bundled))
+};
+function pptxBlueprint(id) {
+  return PPTX_BLUEPRINTS[id];
+}
+var CANVAS = { slideWidth: 13.333, slideHeight: 7.5 };
+function instantiatePptxBlueprint(blueprint, options) {
+  return instantiateBlueprint(blueprint, options, {
+    format: "pptx",
+    props: CANVAS,
+    metadataPointer: "/props",
+    markers: (document) => collectPlaceholders2(document).filter(
+      (occurrence) => occurrence.match.kind === "scaffold-marker"
+    )
+  });
+}
 
 // src/quality/preflight.ts
 import {
@@ -7613,13 +8789,16 @@ export {
   DEFAULT_GENERATED_AT,
   DEFAULT_PPTX_RENDERER_ID,
   DEFAULT_PPTX_THEME,
+  DEVPORTAL_PPTX_THEME,
   DuplicateComponentError,
+  PPTX_BLUEPRINTS,
   PPTX_DEFAULT_QUALITY_PROFILE,
   PPTX_QUALITY_PROFILES,
   PPTX_QUALITY_RULES,
   PresentationGenerator,
   PresentationValidationError,
   UncompiledComponentError,
+  VERMILION_PPTX_THEME,
   W as WarningCodes,
   analyzePptxQuality,
   blockSlotBudgets,
@@ -7636,18 +8815,22 @@ export {
   generateBufferWithWarnings,
   generateFromFile,
   generatePluginPresentationSchema,
+  getChartRequestStats,
   getPptxCoreVersion,
   getPptxTheme,
   hasPptxTheme,
+  instantiatePptxBlueprint,
   isPptxRendererId,
   isPresentationComponent,
   isPresentationComponentDefinition,
   isSlideComponent,
+  pptxBlueprint,
   pptxQualityEngine,
   pptxRendererIds,
   pptxRendererStatuses,
   pptxThemes,
   preparePptxQualityDocument,
+  resetChartRequestStats,
   resolveComponentVersion3 as resolveComponentVersion,
   resolvePptxQualityProfile,
   toAuthoredPointer,