@bendyline/squisq-formats 1.4.2 → 2.0.0

package/dist/import-Yivc3kZM.d.ts

@@ -0,0 +1,136 @@
+import { ThemeRegistry, Doc } from '@bendyline/squisq/schemas';
+import { MarkdownDocument } from '@bendyline/squisq/markdown';
+import { O as OoxmlOpenOptions } from './reader-Gof6OrJX.js';
+import { ContentContainer } from '@bendyline/squisq/storage';
+
+/**
+ * PPTX Export
+ *
+ * Converts a squisq MarkdownDocument (or Doc) into a .pptx file
+ * by generating PresentationML + DrawingML XML and assembling the
+ * OOXML package.
+ *
+ * Slide segmentation: each H1 or H2 heading starts a new slide.
+ * The heading becomes the slide title; content below becomes the body.
+ *
+ * Supports:
+ * - Theme-based styling (background, text colors, fonts from squisq themes)
+ * - Image embedding (pass images as ArrayBuffers via options)
+ * - Inline formatting (bold, italic, strikethrough, code, links)
+ * - Lists, code blocks, blockquotes, tables, math
+ *
+ * No third-party pptx library — all XML is generated directly using
+ * the shared ooxml/ infrastructure.
+ *
+ * @example
+ * ```ts
+ * import { parseMarkdown } from '@bendyline/squisq/markdown';
+ * import { markdownDocToPptx } from '@bendyline/squisq-formats/pptx';
+ *
+ * const md = parseMarkdown('# Slide 1\n\nHello world\n\n## Slide 2\n\nMore content');
+ * const blob = await markdownDocToPptx(md, { themeId: 'documentary' });
+ * ```
+ */
+
+/**
+ * Options for PPTX export.
+ */
+interface PptxExportOptions {
+    /** Presentation title (appears in core properties) */
+    title?: string;
+    /** Presentation author */
+    author?: string;
+    /** Presentation description */
+    description?: string;
+    /**
+     * Which heading depth triggers a new slide.
+     * - `'h1'` — only H1 headings start slides
+     * - `'h2'` — H1 and H2 headings start slides (default)
+     * - `'heading'` — any heading (H1–H6) starts a slide
+     */
+    slideBreak?: 'h1' | 'h2' | 'heading';
+    /** Default body font family. Default: "Calibri" */
+    defaultFont?: string;
+    /** Default body font size in points. Default: 18 */
+    defaultFontSize?: number;
+    /**
+     * Squisq theme ID to apply (e.g., 'documentary', 'cinematic', 'bold').
+     * Controls slide background, text colors, and fonts.
+     * Falls back to the document's frontmatter `themeId` if not set here.
+     */
+    themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
+    /**
+     * Image data keyed by the path/URL used in markdown.
+     * When provided, images are embedded as picture shapes instead of
+     * showing `[Image: alt]` placeholders.
+     */
+    images?: Map<string, ArrayBuffer>;
+}
+/**
+ * Convert a MarkdownDocument to a .pptx ArrayBuffer.
+ */
+declare function markdownDocToPptx(doc: MarkdownDocument, options?: PptxExportOptions): Promise<ArrayBuffer>;
+/**
+ * Convert a squisq Doc to a .pptx ArrayBuffer.
+ *
+ * Convenience wrapper: Doc -> MarkdownDocument -> PPTX.
+ */
+declare function docToPptx(doc: Doc, options?: PptxExportOptions): Promise<ArrayBuffer>;
+
+/**
+ * PPTX import — PresentationML (.pptx) → MarkdownDocument.
+ *
+ * Reuses the shared ooxml/ reader. Reads slide order from
+ * `ppt/presentation.xml` (`<p:sldIdLst>`), resolves each slide part via
+ * relationships, and converts each slide to: an H2 of the title placeholder
+ * (or "Slide N"), the remaining text as a bullet list, and any slide tables
+ * (`<a:tbl>`) as markdown tables. Text lives in the DrawingML namespace
+ * (`a:p` / `a:r` / `a:t`) inside PresentationML shapes (`p:sp`).
+ *
+ * Theme + layout inference (default ON): the deck's theme part is compiled
+ * into a Squisq custom theme and carried in the returned document's
+ * frontmatter (`squisq-custom-themes` + `squisq-theme`); slide layouts are
+ * classified against the built-in template set, distinctive ones become
+ * `squisq-custom-templates` definitions, and each slide's heading is
+ * annotated (`{[templateName …]}`) per its layout's verdict. Pass
+ * `inferTheme: false` / `inferLayouts: false` for legacy plain imports.
+ * Inference never fails an import — extraction errors degrade to plain
+ * output with a console warning.
+ */
+
+interface PptxImportOptions extends OoxmlOpenOptions {
+    /**
+     * Whether to extract embedded slide images into the document as image nodes
+     * (referencing `images/imageN.ext`). When false, pictures are ignored so the
+     * markdown never carries dangling image references with no backing container.
+     * `pptxToContainer` forces this on. Default: false.
+     */
+    extractImages?: boolean;
+    /**
+     * Infer a Squisq theme from the deck's theme part (colors + fonts) and
+     * carry it in the returned document's frontmatter (`squisq-custom-themes`
+     * + `squisq-theme`). Default: true — pass false for a legacy import with
+     * no frontmatter.
+     */
+    inferTheme?: boolean;
+    /**
+     * Derive custom layout templates from the deck's slide layouts/masters
+     * (`squisq-custom-templates` frontmatter) and annotate slide headings
+     * with matching built-in or generated templates. Default: true.
+     */
+    inferLayouts?: boolean;
+}
+declare function pptxToMarkdownDoc(data: ArrayBuffer | Blob, options?: PptxImportOptions): Promise<MarkdownDocument>;
+/**
+ * Convert a .pptx file to a ContentContainer with markdown + extracted images.
+ *
+ * The container holds the primary markdown document plus every embedded slide
+ * image under `images/` (e.g. `images/image1.png`). Image extraction is always
+ * forced on here so the markdown's image references resolve inside the
+ * container. Mirrors `docxToContainer`.
+ */
+declare function pptxToContainer(data: ArrayBuffer | Blob, options?: PptxImportOptions): Promise<ContentContainer>;
+
+export { type PptxExportOptions as P, type PptxImportOptions as a, pptxToContainer as b, docToPptx as d, markdownDocToPptx as m, pptxToMarkdownDoc as p };

package/dist/index.d.ts

@@ -1,11 +1,20 @@
 export { DocxExportOptions, DocxImportOptions, docToDocx, docxToDoc, docxToMarkdownDoc, markdownDocToDocx } from './docx/index.js';
-export { PptxExportOptions, PptxImportOptions, docToPptx, markdownDocToPptx, pptxToDoc, pptxToMarkdownDoc } from './pptx/index.js';
-export { XlsxExportOptions, XlsxImportOptions, docToXlsx, markdownDocToXlsx, xlsxToDoc, xlsxToMarkdownDoc } from './xlsx/index.js';
+export { pptxToDoc } from './pptx/index.js';
+export { xlsxToDoc } from './xlsx/index.js';
 export { CsvExportOptions, CsvImportOptions, csvToDoc, csvToMarkdownDoc, markdownDocToCsv, parseCsv } from './csv/index.js';
 export { PdfExportOptions, PdfImportOptions, configurePdfWorker, docToPdf, markdownDocToPdf, pdfToDoc, pdfToMarkdownDoc } from './pdf/index.js';
-export { HtmlExportOptions, HtmlImportOptions, HtmlZipExportOptions, collectImagePaths, docToHtml, docToHtmlZip, htmlToMarkdown, htmlToMarkdownDoc, htmlToMarkdownDocSync } from './html/index.js';
+export { HtmlZipExportOptions, docToHtml, docToHtmlZip } from './html/index.js';
 export { EpubExportOptions, docToEpub, markdownDocToEpub } from './epub/index.js';
-export { BUILTIN_FORMAT_IDS, ConversionError, ConversionErrorCode, ConversionErrorOptions, ConversionResult, ConvertOptions, ConvertSource, FormatDefinition, FormatId, FormatRegistry, NormalizedInput, convert, createRegistry, defaultFormats, defaultRegistry } from './registry/index.js';
+export { ExtractedFileTheme, InferSourceFormat, InferThemeOptions, InferredFileTheme, compileExtractedTheme, inferThemeFromFile } from './infer/index.js';
+export { BUILTIN_FORMAT_IDS, BuiltinFormatOptions, ConversionError, ConversionErrorCode, ConversionErrorOptions, ConversionResult, ConvertOptions, ConvertSource, DbkFormatOptions, FormatDefinition, FormatId, FormatRegistry, MarkdownFormatOptions, NormalizedInput, convert, createRegistry, defaultFormats, defaultRegistry } from './registry/index.js';
+export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from './zipLimits-bGYMS9cI.js';
+export { H as HtmlExportOptions, a as HtmlImportOptions, c as collectImagePaths, h as htmlToMarkdown, b as htmlToMarkdownDoc, d as htmlToMarkdownDocSync } from './import-DTkDxHmZ.js';
+export { P as PptxExportOptions, a as PptxImportOptions, d as docToPptx, m as markdownDocToPptx, p as pptxToMarkdownDoc } from './import-Yivc3kZM.js';
+export { X as XlsxExportOptions, a as XlsxImportOptions, d as docToXlsx, m as markdownDocToXlsx, x as xlsxToMarkdownDoc } from './export-Djev9BLU.js';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/markdown';
+import './reader-Gof6OrJX.js';
 import '@bendyline/squisq/storage';
+import './layouts-CZ0bdsNL.js';
+import './themeReader-DPw4J5Ss.js';
+import '@bendyline/squisq/transform';

package/dist/index.js

@@ -1,34 +1,44 @@
 import {
   docToEpub,
   markdownDocToEpub
-} from "./chunk-5LSSWZPU.js";
+} from "./chunk-4VUWTSGM.js";
 import {
   BUILTIN_FORMAT_IDS,
-  ConversionError,
   convert,
   createRegistry,
   defaultFormats,
   defaultRegistry
-} from "./chunk-RTS5XBZ7.js";
+} from "./chunk-2EFDWKC6.js";
+import {
+  inferThemeFromFile
+} from "./chunk-ZZ7D4DN6.js";
+import {
+  ConversionError
+} from "./chunk-ODL3SSPT.js";
+import "./chunk-CX3LH47J.js";
+import {
+  compileExtractedTheme
+} from "./chunk-NKAJPJ4G.js";
 import {
   docToDocx,
   docxToDoc,
   docxToMarkdownDoc,
   markdownDocToDocx
-} from "./chunk-WWBIKRNP.js";
+} from "./chunk-2CSZJEAL.js";
 import {
   docToPptx,
   markdownDocToPptx,
   pptxToDoc,
   pptxToMarkdownDoc
-} from "./chunk-YESS7VY3.js";
+} from "./chunk-CVNVD7VH.js";
+import "./chunk-2PRVLAU3.js";
 import "./chunk-6M7Z25LA.js";
 import {
   docToXlsx,
   markdownDocToXlsx,
   xlsxToDoc,
   xlsxToMarkdownDoc
-} from "./chunk-EHLGMSTE.js";
+} from "./chunk-HBSCRS5P.js";
 import "./chunk-PN52A5AA.js";
 import {
   csvToDoc,
@@ -36,15 +46,21 @@ import {
   markdownDocToCsv,
   parseCsv
 } from "./chunk-RFAPOKHJ.js";
-import "./chunk-SHLPSADL.js";
+import "./chunk-X4USWOQ2.js";
+import "./chunk-YRT7GQ5Y.js";
+import "./chunk-XTLQXR4U.js";
 import "./chunk-U4MRIFKL.js";
+import "./chunk-4HJ6AK2Q.js";
+import {
+  ZipSafetyError
+} from "./chunk-H7T5DXUU.js";
 import {
   configurePdfWorker,
   docToPdf,
   markdownDocToPdf,
   pdfToDoc,
   pdfToMarkdownDoc
-} from "./chunk-D7IFPWNZ.js";
+} from "./chunk-GVS2XXV6.js";
 import "./chunk-SSUPBUF5.js";
 import {
   collectImagePaths,
@@ -53,13 +69,15 @@ import {
   htmlToMarkdown,
   htmlToMarkdownDoc,
   htmlToMarkdownDocSync
-} from "./chunk-46FMDOWZ.js";
-import "./chunk-MJGRI6XR.js";
-import "./chunk-DQAZR57U.js";
+} from "./chunk-LXYLOOST.js";
+import "./chunk-MLX2BOJC.js";
+import "./chunk-O3GVVND4.js";
 export {
   BUILTIN_FORMAT_IDS,
   ConversionError,
+  ZipSafetyError,
   collectImagePaths,
+  compileExtractedTheme,
   configurePdfWorker,
   convert,
   createRegistry,
@@ -79,6 +97,7 @@ export {
   htmlToMarkdown,
   htmlToMarkdownDoc,
   htmlToMarkdownDocSync,
+  inferThemeFromFile,
   markdownDocToCsv,
   markdownDocToDocx,
   markdownDocToEpub,

package/dist/infer/index.d.ts

@@ -0,0 +1,138 @@
+import { Theme, DeepPartial, CustomTemplateDefinition } from '@bendyline/squisq/schemas';
+import { a as OoxmlPackage, O as OoxmlOpenOptions } from '../reader-Gof6OrJX.js';
+import { O as OoxmlColorScheme, a as OoxmlFontScheme } from '../themeReader-DPw4J5Ss.js';
+import { P as PptxColorHints } from '../layouts-CZ0bdsNL.js';
+import '../zipLimits-bGYMS9cI.js';
+
+/**
+ * Shared types for file-import theme inference.
+ */
+
+/** Source formats theme inference supports. PDF carries no theme tables. */
+type InferSourceFormat = 'docx' | 'pptx' | 'xlsx';
+/** The four surface/text scheme slots a color map can point at. */
+type SchemeSlot = 'dk1' | 'lt1' | 'dk2' | 'lt2';
+/**
+ * Raw theme extraction from one office file, before mapping onto a Squisq
+ * `Theme`. `colorMap` records which scheme slots back the document's
+ * background/text — PPTX masters carry `<p:clrMap bg1=… tx1=…>` and DOCX may
+ * carry `w:clrSchemeMapping`; dark decks map `bg1="dk1"` and invert here.
+ */
+interface ExtractedFileTheme {
+    sourceFormat: InferSourceFormat;
+    /** `a:theme@name` when present (e.g. "Office Theme", "Ion"). */
+    themeName?: string;
+    colors?: OoxmlColorScheme;
+    colorMap: {
+        bg1: SchemeSlot;
+        tx1: SchemeSlot;
+    };
+    fonts?: OoxmlFontScheme;
+    warnings: string[];
+}
+
+/**
+ * Per-format theme extraction: locate the theme part of an already-opened
+ * OOXML package, parse it, and resolve the document's background/text color
+ * mapping. Returns null when the file has no theme part at all.
+ */
+
+/**
+ * DOCX: theme hangs off `word/document.xml`; an optional
+ * `w:clrSchemeMapping` in `word/settings.xml` remaps bg1/t1 slots
+ * (values `light1`/`dark1`/`light2`/`dark2`).
+ */
+declare function extractDocxTheme(pkg: OoxmlPackage): Promise<ExtractedFileTheme | null>;
+/**
+ * PPTX: theme hangs off the first slide master, whose `<p:clrMap>` records
+ * which scheme slots back the deck's background/text (dark decks set
+ * `bg1="dk1" tx1="lt1"`).
+ */
+declare function extractPptxTheme(pkg: OoxmlPackage): Promise<ExtractedFileTheme | null>;
+/** XLSX: theme hangs off `xl/workbook.xml`; no color remapping exists. */
+declare function extractXlsxTheme(pkg: OoxmlPackage): Promise<ExtractedFileTheme | null>;
+
+/**
+ * Map a raw OOXML theme extraction onto a compiled Squisq `Theme`.
+ *
+ * Only a handful of seeds are taken from the file (lead accents, background,
+ * text, major/minor fonts); `compileTheme` derives the rest of the palette
+ * via OKLCh so the result is always a complete, validated theme that stays
+ * re-editable in the customizer (seeds are recorded on `Theme.seedColors`).
+ */
+
+interface CompileExtractedOptions {
+    /** Preferred display name for the compiled theme (e.g. the file's basename). */
+    nameHint?: string;
+}
+interface MappedThemePartial {
+    partial: DeepPartial<Theme>;
+    warnings: string[];
+}
+/**
+ * Build the `DeepPartial<Theme>` for an extraction. Exported for tests; most
+ * callers want {@link compileExtractedTheme}.
+ */
+declare function extractedThemeToPartial(extraction: ExtractedFileTheme, opts?: CompileExtractedOptions): MappedThemePartial;
+/**
+ * Compile an extraction into a full validated Squisq theme. Mapping warnings
+ * (dropped accents, low-contrast surfaces) are returned alongside; extraction
+ * warnings stay on `extraction.warnings`.
+ */
+declare function compileExtractedTheme(extraction: ExtractedFileTheme, opts?: CompileExtractedOptions): {
+    theme: Theme;
+    warnings: string[];
+};
+/**
+ * Build the color hints the PPTX layout generator uses to resolve scheme
+ * color references (`a:schemeClr val="accent1"`, `bg1`, `tx1`, …) on
+ * decorative shapes.
+ */
+declare function colorHintsFromExtraction(extraction: ExtractedFileTheme): PptxColorHints;
+
+/**
+ * @bendyline/squisq-formats Infer Module
+ *
+ * "Infer theme and layouts from a file import": read the OOXML theme
+ * (colors + fonts) out of a DOCX/PPTX/XLSX file and compile it into a
+ * Squisq `Theme`; for PPTX, optionally derive custom layout templates
+ * from the deck's slide layouts/masters.
+ *
+ * Consumers:
+ *   - the editor's theme customizer surfaces (upload / drag-drop a file)
+ *   - the PPTX importer (theme + layouts ride along as frontmatter)
+ *
+ * PDF is deliberately unsupported: PDF files carry no theme tables, so
+ * inference would produce a mostly-default theme. `inferThemeFromFile`
+ * rejects PDF bytes with a clear `ConversionError`.
+ */
+
+interface InferThemeOptions extends OoxmlOpenOptions {
+    /** Skip sniffing when the caller already knows the format (e.g. from the extension). */
+    format?: InferSourceFormat;
+    /** PPTX only: also derive custom layout templates from slide layouts/masters. */
+    inferLayouts?: boolean;
+    /** Preferred display name for the compiled theme (e.g. the file's basename). */
+    nameHint?: string;
+}
+interface InferredFileTheme {
+    /** Compiled, validated Squisq theme (`custom-<slug>` id, seeds recorded). */
+    theme: Theme;
+    /** Raw extraction, for callers mapping into their own editing model. */
+    extraction: ExtractedFileTheme;
+    /** Present only for PPTX with `inferLayouts` and ≥1 non-redundant layout. */
+    layouts?: CustomTemplateDefinition[];
+    /** Non-fatal notes: sysClr fallbacks, dropped accents, skipped layouts, … */
+    warnings: string[];
+}
+/**
+ * Infer a Squisq theme (and, for PPTX, optionally custom layout templates)
+ * from an office file's bytes.
+ *
+ * Throws `ConversionError`:
+ *   - `unsupported-input` for PDF bytes (no theme tables to read)
+ *   - `invalid-input` for non-OOXML data or files with no theme part
+ */
+declare function inferThemeFromFile(data: ArrayBuffer | Blob, options?: InferThemeOptions): Promise<InferredFileTheme>;
+
+export { type CompileExtractedOptions, type ExtractedFileTheme, type InferSourceFormat, type InferThemeOptions, type InferredFileTheme, type MappedThemePartial, type SchemeSlot, colorHintsFromExtraction, compileExtractedTheme, extractDocxTheme, extractPptxTheme, extractXlsxTheme, extractedThemeToPartial, inferThemeFromFile };

package/dist/infer/index.js

@@ -0,0 +1,28 @@
+import {
+  inferThemeFromFile
+} from "../chunk-ZZ7D4DN6.js";
+import "../chunk-ODL3SSPT.js";
+import {
+  extractDocxTheme,
+  extractPptxTheme,
+  extractXlsxTheme
+} from "../chunk-CX3LH47J.js";
+import {
+  colorHintsFromExtraction,
+  compileExtractedTheme,
+  extractedThemeToPartial
+} from "../chunk-NKAJPJ4G.js";
+import "../chunk-X4USWOQ2.js";
+import "../chunk-YRT7GQ5Y.js";
+import "../chunk-4HJ6AK2Q.js";
+import "../chunk-H7T5DXUU.js";
+export {
+  colorHintsFromExtraction,
+  compileExtractedTheme,
+  extractDocxTheme,
+  extractPptxTheme,
+  extractXlsxTheme,
+  extractedThemeToPartial,
+  inferThemeFromFile
+};
+//# sourceMappingURL=index.js.map

package/dist/infer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/layouts-7OUUVAGU.js

@@ -0,0 +1,12 @@
+import {
+  analyzePptxLayouts,
+  inspectPptxLayouts
+} from "./chunk-2PRVLAU3.js";
+import "./chunk-YRT7GQ5Y.js";
+import "./chunk-4HJ6AK2Q.js";
+import "./chunk-H7T5DXUU.js";
+export {
+  analyzePptxLayouts,
+  inspectPptxLayouts
+};
+//# sourceMappingURL=layouts-7OUUVAGU.js.map

package/dist/layouts-7OUUVAGU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/layouts-CZ0bdsNL.d.ts

@@ -0,0 +1,150 @@
+import { CustomTemplateDefinition } from '@bendyline/squisq/schemas';
+import { O as OoxmlOpenOptions, a as OoxmlPackage } from './reader-Gof6OrJX.js';
+
+/**
+ * PPTX slide-layout inference — reads the layouts/masters a deck actually
+ * uses and, per layout, either matches it to a close built-in Squisq
+ * template (title, sectionHeader, twoColumn, leftFeature, …) or generates a
+ * reusable `CustomTemplateDefinition` from its placeholder geometry.
+ *
+ * The classifier is a deterministic three-stage waterfall — the layout's
+ * `type` attribute, then well-known layout names, then placeholder-set
+ * geometry — biased toward *not* templating: a title over a single body
+ * flows better as plain markdown, and only genuinely distinctive geometry
+ * (side-by-side content, positioned picture placeholders) becomes a custom
+ * template.
+ *
+ * Shared by the PPTX importer (`inferLayouts`) and the theme dialog's
+ * `inspectPptxLayouts` — one implementation, two consumers.
+ */
+
+/** Percent-of-slide rect, 0–100 per axis (2-decimal precision). */
+interface PctRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+type PlaceholderKind = 'title' | 'subtitle' | 'text' | 'picture' | 'table' | 'chart' | 'other';
+interface PlaceholderTextStyle {
+    fontSizePt?: number;
+    bold?: boolean;
+    align?: 'left' | 'center' | 'right';
+    anchor?: 'top' | 'middle' | 'bottom';
+}
+interface ExtractedPlaceholder {
+    kind: PlaceholderKind;
+    /** `p:ph@type` verbatim ('' when absent — spec default is body). */
+    rawType: string;
+    /** `p:ph@idx`, default 0. */
+    idx: number;
+    /** Geometry resolved through the layout→master inheritance chain. */
+    rect: PctRect;
+    inheritedFromMaster: boolean;
+    vertical: boolean;
+    textStyle?: PlaceholderTextStyle;
+}
+interface ExtractedDecoration {
+    shape: 'rect' | 'line';
+    rect: PctRect;
+    fill?: string;
+    stroke?: string;
+    strokeWidthPx?: number;
+    borderRadius?: number;
+}
+interface ExtractedSlideLayout {
+    partPath: string;
+    /** `p:cSld@name` ('' when absent). */
+    name: string;
+    /** `p:sldLayout@type` (ST_SlideLayoutType) when present. */
+    typeAttr?: string;
+    masterPath?: string;
+    masterName?: string;
+    /** Content placeholders — dt/ftr/sldNum/hdr chrome already excluded. */
+    placeholders: ExtractedPlaceholder[];
+    decorations: ExtractedDecoration[];
+    /** Number of slides in this deck using this layout (0 = defined but unused). */
+    slideCount: number;
+}
+/** Scheme-color hints for decoration fills, supplied by theme extraction. */
+interface PptxColorHints {
+    text?: string;
+    background?: string;
+    /** `a:schemeClr@val` (accent1…, bg1, tx1, dk1, …) → resolved hex. */
+    schemeColors?: Record<string, string>;
+}
+type BuiltinParamSpec = 'titleSubtitle' | 'comparisonPairs' | 'featureImage' | 'photoGridGate';
+type LayoutVerdict = {
+    kind: 'plain';
+} | {
+    kind: 'skip';
+} | {
+    kind: 'builtin';
+    template: string;
+    paramSpec?: BuiltinParamSpec;
+    /** For `comparisonPairs`: placeholder idx lists per column, top-to-bottom. */
+    columns?: {
+        left: number[];
+        right: number[];
+    };
+} | {
+    kind: 'custom';
+    def: CustomTemplateDefinition;
+};
+interface AnalyzedLayout {
+    extracted: ExtractedSlideLayout;
+    verdict: LayoutVerdict;
+    /** Human-readable caveats: dropped regions, unsupported placeholders, … */
+    notes: string[];
+}
+interface PptxLayoutInference {
+    slideSize: {
+        cx: number;
+        cy: number;
+    };
+    layouts: AnalyzedLayout[];
+    byLayoutPath: Map<string, AnalyzedLayout>;
+    layoutPathBySlide: Map<string, string>;
+    warnings: string[];
+}
+interface AnalyzePptxLayoutsOptions extends OoxmlOpenOptions {
+    /** Also analyze layouts no slide references (default false). */
+    includeUnused?: boolean;
+    colors?: PptxColorHints;
+    /** Cap on generated custom templates (default 12); excess downgrades to plain. */
+    maxTemplates?: number;
+}
+/**
+ * Analyze the deck's slide layouts: extract placeholder geometry (with
+ * master inheritance), classify each layout against the built-in template
+ * set, and generate custom template definitions for the distinctive ones.
+ */
+declare function analyzePptxLayouts(pkg: OoxmlPackage, options?: AnalyzePptxLayoutsOptions): Promise<PptxLayoutInference>;
+interface PptxLayoutSummary {
+    layoutPath: string;
+    name: string;
+    masterName?: string;
+    typeAttr?: string;
+    slideCount: number;
+    verdict: 'builtin' | 'custom' | 'plain' | 'skip';
+    /** Set when verdict is 'builtin' — the close built-in alternative. */
+    builtinTemplate?: string;
+    /** Set when verdict is 'custom' — ready to save as a doc/library template. */
+    customTemplate?: CustomTemplateDefinition;
+    notes?: string[];
+}
+type InspectPptxLayoutsOptions = AnalyzePptxLayoutsOptions;
+/**
+ * Inspect a deck's layouts without importing it — used by the theme dialog
+ * to list what a PPTX would contribute (built-in matches shown as
+ * informational rows; custom templates offered for confirmation).
+ */
+declare function inspectPptxLayouts(data: ArrayBuffer | Blob, options?: InspectPptxLayoutsOptions): Promise<{
+    layouts: PptxLayoutSummary[];
+    slideSize: {
+        cx: number;
+        cy: number;
+    };
+}>;
+
+export { type AnalyzePptxLayoutsOptions as A, type ExtractedPlaceholder as E, type InspectPptxLayoutsOptions as I, type LayoutVerdict as L, type PptxColorHints as P, type AnalyzedLayout as a, type ExtractedSlideLayout as b, type PptxLayoutInference as c, type PptxLayoutSummary as d, analyzePptxLayouts as e, inspectPptxLayouts as i };

package/dist/mapTheme-IR27S6IV.js

@@ -0,0 +1,11 @@
+import {
+  colorHintsFromExtraction,
+  compileExtractedTheme,
+  extractedThemeToPartial
+} from "./chunk-NKAJPJ4G.js";
+export {
+  colorHintsFromExtraction,
+  compileExtractedTheme,
+  extractedThemeToPartial
+};
+//# sourceMappingURL=mapTheme-IR27S6IV.js.map

package/dist/mapTheme-IR27S6IV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}