@bendyline/squisq-formats 1.4.1 → 2.0.0

package/dist/ooxml/index.d.ts

@@ -1,138 +1,32 @@
-import JSZip from 'jszip';
+import { R as Relationship, C as CoreProperties } from '../reader-Gof6OrJX.js';
+export { b as ContentTypeMap, O as OoxmlOpenOptions, a as OoxmlPackage, P as PackagePart, c as PendingRelationship, g as getCoreProperties, d as getPartBinary, e as getPartRelationships, f as getPartXml, o as openPackage } from '../reader-Gof6OrJX.js';
+export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from '../zipLimits-bGYMS9cI.js';
+export { O as OoxmlColorScheme, a as OoxmlFontScheme, b as OoxmlTheme, p as parseThemeXml, r as readThemePart } from '../themeReader-DPw4J5Ss.js';
 
 /**
- * OOXML Types
+ * Shared DOM-read helpers for OOXML importers.
  *
- * Shared type definitions for all Office Open XML formats (DOCX, PPTX, XLSX).
- * These model the common structural elements of the OOXML package format:
- * ZIP archive, relationships, content types, and core properties.
+ * Every importer walks parts with `getElementsByTagNameNS` and resolves
+ * relationship targets relative to the referencing part; these helpers hold
+ * the common pieces so new readers (theme, slide layouts) don't re-implement
+ * them per format.
  */
 
 /**
- * An opened OOXML package — wraps the JSZip archive plus parsed
- * structural metadata (content types, root relationships).
+ * Read a namespaced attribute with a qualified-name fallback for documents
+ * whose producer omitted the namespace declaration (e.g. `r:id`).
  */
-interface OoxmlPackage {
-    /** The underlying JSZip archive */
-    zip: JSZip;
-    /** Parsed [Content_Types].xml entries */
-    contentTypes: ContentTypeMap;
-    /** Root-level relationships (_rels/.rels) */
-    rootRelationships: Relationship[];
-}
-/**
- * Content type map built from [Content_Types].xml.
- * Maps part paths → content type strings plus extension defaults.
- */
-interface ContentTypeMap {
-    /** Explicit overrides: partName → contentType */
-    overrides: Map<string, string>;
-    /** Default extensions: extension → contentType */
-    defaults: Map<string, string>;
-}
-/**
- * An OOXML relationship entry (from any _rels/*.rels file).
- */
-interface Relationship {
-    /** Relationship ID (e.g., "rId1") */
-    id: string;
-    /** Relationship type URI (e.g., "http://...officedocument/...") */
-    type: string;
-    /** Target path or URL */
-    target: string;
-    /** "Internal" (default) or "External" for hyperlinks */
-    targetMode?: 'Internal' | 'External';
-}
-/**
- * Document core properties from docProps/core.xml (Dublin Core metadata).
- */
-interface CoreProperties {
-    title?: string;
-    subject?: string;
-    creator?: string;
-    keywords?: string;
-    description?: string;
-    lastModifiedBy?: string;
-    revision?: string;
-    created?: string;
-    modified?: string;
-}
-/**
- * A part (file) that will be written into an OOXML package.
- */
-interface PackagePart {
-    /** Path within the ZIP (e.g., "word/document.xml") */
-    path: string;
-    /** XML or text content (mutually exclusive with binaryContent) */
-    content?: string;
-    /** Binary content (mutually exclusive with content) */
-    binaryContent?: ArrayBuffer | Uint8Array;
-    /** MIME content type for [Content_Types].xml */
-    contentType: string;
-}
-/**
- * A relationship to be written into a _rels/*.rels file.
- * `sourcePart` identifies which part the relationship belongs to.
- * Use "" (empty string) for root-level relationships (_rels/.rels).
- */
-interface PendingRelationship {
-    /** The part this relationship belongs to ("" for root) */
-    sourcePart: string;
-    /** The relationship entry */
-    relationship: Relationship;
-}
-
-/**
- * OOXML Package Reader
- *
- * Opens OOXML archives (.docx, .pptx, .xlsx) and parses their
- * structural metadata: [Content_Types].xml, relationships, and
- * core properties.
- *
- * Uses JSZip to unzip and the browser's DOMParser to parse XML.
- */
-
-/**
- * Open an OOXML package from raw data.
- *
- * Parses the ZIP archive, [Content_Types].xml, and root relationships.
- *
- * @param data - The raw .docx/.pptx/.xlsx file as ArrayBuffer or Blob
- * @returns A parsed OoxmlPackage
- */
-declare function openPackage(data: ArrayBuffer | Blob): Promise<OoxmlPackage>;
-/**
- * Parse relationships for a specific part.
- *
- * @param pkg - The OOXML package (or the zip directly)
- * @param partPath - The part path (e.g., "word/document.xml").
- *   Use "" for root-level relationships (_rels/.rels).
- * @returns Array of relationship entries
- */
-declare function getPartRelationships(pkg: OoxmlPackage, partPath: string): Promise<Relationship[]>;
-/**
- * Extract an XML part from the package and parse it as a DOM Document.
- *
- * @param pkg - The OOXML package
- * @param partPath - Path within the archive (e.g., "word/document.xml")
- * @returns Parsed XML Document, or null if the part doesn't exist
- */
-declare function getPartXml(pkg: OoxmlPackage, partPath: string): Promise<Document | null>;
+declare function attrNS(el: Element, ns: string, local: string, qualified: string): string | null;
+/** Directory portion of a part path, e.g. `ppt/slides/slide1.xml` → `ppt/slides`. */
+declare function baseDirOf(path: string): string;
 /**
- * Extract a binary part from the package (e.g., an image from word/media/).
- *
- * @param pkg - The OOXML package
- * @param partPath - Path within the archive
- * @returns The binary content, or null if the part doesn't exist
- */
-declare function getPartBinary(pkg: OoxmlPackage, partPath: string): Promise<ArrayBuffer | null>;
-/**
- * Parse core document properties from docProps/core.xml.
- *
- * @param pkg - The OOXML package
- * @returns Parsed core properties (all fields optional)
+ * Resolve a relationship target against the referencing part's directory.
+ * Absolute targets (leading `/`) are package-rooted; relative targets may
+ * climb with `..` segments (e.g. `../slideLayouts/slideLayout1.xml`).
  */
-declare function getCoreProperties(pkg: OoxmlPackage): Promise<CoreProperties>;
+declare function resolveTarget(baseDir: string, target: string): string;
+/** First relationship of the given type, if any. */
+declare function findRelByType(rels: Relationship[], type: string): Relationship | undefined;
 
 /**
  * OOXML Package Writer
@@ -362,4 +256,4 @@ declare const CONTENT_TYPE_XLSX_STYLES = "application/vnd.openxmlformats-officed
 /** Relationship type: Worksheet */
 declare const REL_WORKSHEET = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet";
 
-export { CONTENT_TYPE_CORE_PROPERTIES, CONTENT_TYPE_DOCX_DOCUMENT, CONTENT_TYPE_DOCX_FONT_TABLE, CONTENT_TYPE_DOCX_FOOTNOTES, CONTENT_TYPE_DOCX_NUMBERING, CONTENT_TYPE_DOCX_SETTINGS, CONTENT_TYPE_DOCX_STYLES, CONTENT_TYPE_PPTX_PRESENTATION, CONTENT_TYPE_PPTX_SLIDE, CONTENT_TYPE_PPTX_SLIDE_LAYOUT, CONTENT_TYPE_PPTX_SLIDE_MASTER, CONTENT_TYPE_PPTX_THEME, CONTENT_TYPE_RELATIONSHIPS, CONTENT_TYPE_XLSX_STYLES, CONTENT_TYPE_XLSX_WORKBOOK, CONTENT_TYPE_XLSX_WORKSHEET, type ContentTypeMap, type CoreProperties, NS_CONTENT_TYPES, NS_CORE_PROPERTIES, NS_DC, NS_DCTERMS, NS_DRAWINGML, NS_MC, NS_PICTURE, NS_PML, NS_R, NS_RELATIONSHIPS, NS_SML, NS_WML, NS_WP_DRAWING, NS_XSI, type OoxmlPackage, type OoxmlPackageBuilder, type PackagePart, type PendingRelationship, REL_CORE_PROPERTIES, REL_EXTENDED_PROPERTIES, REL_FONT_TABLE, REL_FOOTNOTES, REL_HYPERLINK, REL_IMAGE, REL_NUMBERING, REL_OFFICE_DOCUMENT, REL_SETTINGS, REL_SLIDE, REL_SLIDE_LAYOUT, REL_SLIDE_MASTER, REL_STYLES, REL_THEME, REL_WORKSHEET, type Relationship, attrString, createPackage, escapeXml, getCoreProperties, getPartBinary, getPartRelationships, getPartXml, openPackage, selfClosingElement, textElement, xmlDeclaration, xmlElement };
+export { CONTENT_TYPE_CORE_PROPERTIES, CONTENT_TYPE_DOCX_DOCUMENT, CONTENT_TYPE_DOCX_FONT_TABLE, CONTENT_TYPE_DOCX_FOOTNOTES, CONTENT_TYPE_DOCX_NUMBERING, CONTENT_TYPE_DOCX_SETTINGS, CONTENT_TYPE_DOCX_STYLES, CONTENT_TYPE_PPTX_PRESENTATION, CONTENT_TYPE_PPTX_SLIDE, CONTENT_TYPE_PPTX_SLIDE_LAYOUT, CONTENT_TYPE_PPTX_SLIDE_MASTER, CONTENT_TYPE_PPTX_THEME, CONTENT_TYPE_RELATIONSHIPS, CONTENT_TYPE_XLSX_STYLES, CONTENT_TYPE_XLSX_WORKBOOK, CONTENT_TYPE_XLSX_WORKSHEET, CoreProperties, NS_CONTENT_TYPES, NS_CORE_PROPERTIES, NS_DC, NS_DCTERMS, NS_DRAWINGML, NS_MC, NS_PICTURE, NS_PML, NS_R, NS_RELATIONSHIPS, NS_SML, NS_WML, NS_WP_DRAWING, NS_XSI, type OoxmlPackageBuilder, REL_CORE_PROPERTIES, REL_EXTENDED_PROPERTIES, REL_FONT_TABLE, REL_FOOTNOTES, REL_HYPERLINK, REL_IMAGE, REL_NUMBERING, REL_OFFICE_DOCUMENT, REL_SETTINGS, REL_SLIDE, REL_SLIDE_LAYOUT, REL_SLIDE_MASTER, REL_STYLES, REL_THEME, REL_WORKSHEET, Relationship, attrNS, attrString, baseDirOf, createPackage, escapeXml, findRelByType, resolveTarget, selfClosingElement, textElement, xmlDeclaration, xmlElement };

package/dist/ooxml/index.js

@@ -1,3 +1,24 @@
+import {
+  parseThemeXml,
+  readThemePart
+} from "../chunk-X4USWOQ2.js";
+import {
+  attrNS,
+  baseDirOf,
+  findRelByType,
+  resolveTarget
+} from "../chunk-YRT7GQ5Y.js";
+import {
+  createPackage
+} from "../chunk-XTLQXR4U.js";
+import {
+  attrString,
+  escapeXml,
+  selfClosingElement,
+  textElement,
+  xmlDeclaration,
+  xmlElement
+} from "../chunk-U4MRIFKL.js";
 import {
   CONTENT_TYPE_CORE_PROPERTIES,
   CONTENT_TYPE_DOCX_DOCUMENT,
@@ -44,21 +65,15 @@ import {
   REL_STYLES,
   REL_THEME,
   REL_WORKSHEET,
-  createPackage,
   getCoreProperties,
   getPartBinary,
   getPartRelationships,
   getPartXml,
   openPackage
-} from "../chunk-SHLPSADL.js";
+} from "../chunk-4HJ6AK2Q.js";
 import {
-  attrString,
-  escapeXml,
-  selfClosingElement,
-  textElement,
-  xmlDeclaration,
-  xmlElement
-} from "../chunk-U4MRIFKL.js";
+  ZipSafetyError
+} from "../chunk-H7T5DXUU.js";
 export {
   CONTENT_TYPE_CORE_PROPERTIES,
   CONTENT_TYPE_DOCX_DOCUMENT,
@@ -105,14 +120,21 @@ export {
   REL_STYLES,
   REL_THEME,
   REL_WORKSHEET,
+  ZipSafetyError,
+  attrNS,
   attrString,
+  baseDirOf,
   createPackage,
   escapeXml,
+  findRelByType,
   getCoreProperties,
   getPartBinary,
   getPartRelationships,
   getPartXml,
   openPackage,
+  parseThemeXml,
+  readThemePart,
+  resolveTarget,
   selfClosingElement,
   textElement,
   xmlDeclaration,

package/dist/pdf/index.d.ts

@@ -1,4 +1,4 @@
-import { Doc } from '@bendyline/squisq/schemas';
+import { ThemeRegistry, Doc } from '@bendyline/squisq/schemas';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
 import { ContentContainer } from '@bendyline/squisq/storage';
 
@@ -45,6 +45,8 @@ interface PdfExportOptions {
      * Font changes are not supported (pdf-lib uses standard 14 PDF fonts only).
      */
     themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
 }
 /**
  * Convert a MarkdownDocument to a PDF ArrayBuffer.

package/dist/pdf/index.js

@@ -5,7 +5,7 @@ import {
   pdfToContainer,
   pdfToDoc,
   pdfToMarkdownDoc
-} from "../chunk-D7IFPWNZ.js";
+} from "../chunk-GVS2XXV6.js";
 import "../chunk-SSUPBUF5.js";
 export {
   configurePdfWorker,

package/dist/pptx/index.d.ts

@@ -1,111 +1,11 @@
+import { a as PptxImportOptions } from '../import-Yivc3kZM.js';
+export { P as PptxExportOptions, d as docToPptx, m as markdownDocToPptx, b as pptxToContainer, p as pptxToMarkdownDoc } from '../import-Yivc3kZM.js';
 import { Doc } from '@bendyline/squisq/schemas';
-import { MarkdownDocument } from '@bendyline/squisq/markdown';
-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;
-    /**
-     * 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`).
- */
-
-interface PptxImportOptions {
-    /**
-     * 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;
-}
-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 { A as AnalyzePptxLayoutsOptions, a as AnalyzedLayout, E as ExtractedPlaceholder, b as ExtractedSlideLayout, I as InspectPptxLayoutsOptions, L as LayoutVerdict, P as PptxColorHints, c as PptxLayoutInference, d as PptxLayoutSummary, e as analyzePptxLayouts, i as inspectPptxLayouts } from '../layouts-CZ0bdsNL.js';
+import '@bendyline/squisq/markdown';
+import '../reader-Gof6OrJX.js';
+import '../zipLimits-bGYMS9cI.js';
+import '@bendyline/squisq/storage';
 
 /**
  * @bendyline/squisq-formats PPTX Module
@@ -129,4 +29,4 @@ declare function pptxToContainer(data: ArrayBuffer | Blob, options?: PptxImportO
  */
 declare function pptxToDoc(data: ArrayBuffer | Blob, options?: PptxImportOptions): Promise<Doc>;
 
-export { type PptxExportOptions, type PptxImportOptions, docToPptx, markdownDocToPptx, pptxToContainer, pptxToDoc, pptxToMarkdownDoc };
+export { PptxImportOptions, pptxToDoc };

package/dist/pptx/index.js

@@ -4,16 +4,25 @@ import {
   pptxToContainer,
   pptxToDoc,
   pptxToMarkdownDoc
-} from "../chunk-YESS7VY3.js";
+} from "../chunk-CVNVD7VH.js";
+import {
+  analyzePptxLayouts,
+  inspectPptxLayouts
+} from "../chunk-2PRVLAU3.js";
 import "../chunk-6M7Z25LA.js";
 import "../chunk-PN52A5AA.js";
-import "../chunk-SHLPSADL.js";
+import "../chunk-YRT7GQ5Y.js";
+import "../chunk-XTLQXR4U.js";
 import "../chunk-U4MRIFKL.js";
+import "../chunk-4HJ6AK2Q.js";
+import "../chunk-H7T5DXUU.js";
 import "../chunk-SSUPBUF5.js";
-import "../chunk-MJGRI6XR.js";
-import "../chunk-DQAZR57U.js";
+import "../chunk-MLX2BOJC.js";
+import "../chunk-O3GVVND4.js";
 export {
+  analyzePptxLayouts,
   docToPptx,
+  inspectPptxLayouts,
   markdownDocToPptx,
   pptxToContainer,
   pptxToDoc,

package/dist/reader-Gof6OrJX.d.ts

@@ -0,0 +1,140 @@
+import { c as ZipSafetyLimits } from './zipLimits-bGYMS9cI.js';
+
+/**
+ * OOXML Types
+ *
+ * Shared type definitions for all Office Open XML formats (DOCX, PPTX, XLSX).
+ * These model the common structural elements of the OOXML package format:
+ * relationships, content types, and core properties.
+ */
+/**
+ * An opened OOXML package. Instances are created only by `openPackage`; the
+ * archive remains private so every part read goes through the bounded reader.
+ */
+declare const ooxmlPackageBrand: unique symbol;
+interface OoxmlPackage {
+    /** Nominal brand: callers cannot manually construct a safety-bypassing package. */
+    readonly [ooxmlPackageBrand]: never;
+    /** Parsed [Content_Types].xml entries */
+    readonly contentTypes: ContentTypeMap;
+    /** Root-level relationships (_rels/.rels) */
+    readonly rootRelationships: readonly Relationship[];
+}
+/**
+ * Content type map built from [Content_Types].xml.
+ * Maps part paths → content type strings plus extension defaults.
+ */
+interface ContentTypeMap {
+    /** Explicit overrides: partName → contentType */
+    overrides: Map<string, string>;
+    /** Default extensions: extension → contentType */
+    defaults: Map<string, string>;
+}
+/**
+ * An OOXML relationship entry (from any _rels/*.rels file).
+ */
+interface Relationship {
+    /** Relationship ID (e.g., "rId1") */
+    id: string;
+    /** Relationship type URI (e.g., "http://...officedocument/...") */
+    type: string;
+    /** Target path or URL */
+    target: string;
+    /** "Internal" (default) or "External" for hyperlinks */
+    targetMode?: 'Internal' | 'External';
+}
+/**
+ * Document core properties from docProps/core.xml (Dublin Core metadata).
+ */
+interface CoreProperties {
+    title?: string;
+    subject?: string;
+    creator?: string;
+    keywords?: string;
+    description?: string;
+    lastModifiedBy?: string;
+    revision?: string;
+    created?: string;
+    modified?: string;
+}
+/**
+ * A part (file) that will be written into an OOXML package.
+ */
+interface PackagePart {
+    /** Path within the ZIP (e.g., "word/document.xml") */
+    path: string;
+    /** XML or text content (mutually exclusive with binaryContent) */
+    content?: string;
+    /** Binary content (mutually exclusive with content) */
+    binaryContent?: ArrayBuffer | Uint8Array;
+    /** MIME content type for [Content_Types].xml */
+    contentType: string;
+}
+/**
+ * A relationship to be written into a _rels/*.rels file.
+ * `sourcePart` identifies which part the relationship belongs to.
+ * Use "" (empty string) for root-level relationships (_rels/.rels).
+ */
+interface PendingRelationship {
+    /** The part this relationship belongs to ("" for root) */
+    sourcePart: string;
+    /** The relationship entry */
+    relationship: Relationship;
+}
+
+/**
+ * OOXML Package Reader
+ *
+ * Opens OOXML archives (.docx, .pptx, .xlsx) and parses their
+ * structural metadata: [Content_Types].xml, relationships, and
+ * core properties.
+ *
+ * Uses bounded JSZip member streams and a platform DOMParser (with an xmldom
+ * fallback in bare Node/SSR) to parse XML.
+ */
+
+type OoxmlOpenOptions = ZipSafetyLimits;
+/**
+ * Open an OOXML package from raw data.
+ *
+ * Parses the ZIP archive, [Content_Types].xml, and root relationships.
+ *
+ * @param data - The raw .docx/.pptx/.xlsx file as ArrayBuffer or Blob
+ * @param limits - Optional archive count, size, and compression-ratio limits
+ * @returns A parsed OoxmlPackage
+ */
+declare function openPackage(data: ArrayBuffer | Blob, limits?: OoxmlOpenOptions): Promise<OoxmlPackage>;
+/**
+ * Parse relationships for a specific part.
+ *
+ * @param pkg - The OOXML package (or the zip directly)
+ * @param partPath - The part path (e.g., "word/document.xml").
+ *   Use "" for root-level relationships (_rels/.rels).
+ * @returns Array of relationship entries
+ */
+declare function getPartRelationships(pkg: OoxmlPackage, partPath: string): Promise<Relationship[]>;
+/**
+ * Extract an XML part from the package and parse it as a DOM Document.
+ *
+ * @param pkg - The OOXML package
+ * @param partPath - Path within the archive (e.g., "word/document.xml")
+ * @returns Parsed XML Document, or null if the part doesn't exist
+ */
+declare function getPartXml(pkg: OoxmlPackage, partPath: string): Promise<Document | null>;
+/**
+ * Extract a binary part from the package (e.g., an image from word/media/).
+ *
+ * @param pkg - The OOXML package
+ * @param partPath - Path within the archive
+ * @returns The binary content, or null if the part doesn't exist
+ */
+declare function getPartBinary(pkg: OoxmlPackage, partPath: string): Promise<ArrayBuffer | null>;
+/**
+ * Parse core document properties from docProps/core.xml.
+ *
+ * @param pkg - The OOXML package
+ * @returns Parsed core properties (all fields optional)
+ */
+declare function getCoreProperties(pkg: OoxmlPackage): Promise<CoreProperties>;
+
+export { type CoreProperties as C, type OoxmlOpenOptions as O, type PackagePart as P, type Relationship as R, type OoxmlPackage as a, type ContentTypeMap as b, type PendingRelationship as c, getPartBinary as d, getPartRelationships as e, getPartXml as f, getCoreProperties as g, openPackage as o };

package/dist/registry/index.d.ts

@@ -1,6 +1,16 @@
-import { Doc } from '@bendyline/squisq/schemas';
-import { MarkdownDocument } from '@bendyline/squisq/markdown';
+import { Doc, ThemeRegistry } from '@bendyline/squisq/schemas';
+import { TransformStyleInput, TransformStyleRegistry } from '@bendyline/squisq/transform';
+import { ParseOptions, StringifyOptions, MarkdownDocument } from '@bendyline/squisq/markdown';
 import { ContentContainer } from '@bendyline/squisq/storage';
+import { DocxImportOptions, DocxExportOptions } from '../docx/index.js';
+import { a as PptxImportOptions, P as PptxExportOptions } from '../import-Yivc3kZM.js';
+import { a as XlsxImportOptions, X as XlsxExportOptions } from '../export-Djev9BLU.js';
+import { CsvImportOptions, CsvExportOptions } from '../csv/index.js';
+import { PdfImportOptions, PdfExportOptions } from '../pdf/index.js';
+import { a as HtmlImportOptions, H as HtmlExportOptions } from '../import-DTkDxHmZ.js';
+import { EpubExportOptions } from '../epub/index.js';
+import { c as ZipSafetyLimits } from '../zipLimits-bGYMS9cI.js';
+import '../reader-Gof6OrJX.js';
 
 /**
  * Format registry — shared types.
@@ -27,6 +37,30 @@ interface ConversionResult {
     /** Non-fatal notes accumulated during conversion (may be empty). */
     warnings: string[];
 }
+interface MarkdownFormatOptions {
+    parse?: ParseOptions;
+    stringify?: StringifyOptions;
+}
+/** Resource limits applied when importing a DBK/ZIP container. */
+type DbkFormatOptions = ZipSafetyLimits;
+/**
+ * Strongly typed option bags for built-in formats. Import and export options
+ * share a bag because a single conversion may use the format on either side.
+ * Custom registries may add arbitrary keys through the intersection used by
+ * {@link ConvertOptions.formatOptions}.
+ */
+interface BuiltinFormatOptions {
+    md: MarkdownFormatOptions;
+    docx: DocxImportOptions & DocxExportOptions;
+    pptx: PptxImportOptions & PptxExportOptions;
+    xlsx: XlsxImportOptions & XlsxExportOptions;
+    csv: CsvImportOptions & CsvExportOptions;
+    pdf: PdfImportOptions & PdfExportOptions;
+    html: HtmlImportOptions & Partial<Omit<HtmlExportOptions, 'playerScript'>>;
+    htmlzip: Partial<Omit<HtmlExportOptions, 'playerScript'>>;
+    epub: EpubExportOptions;
+    dbk: DbkFormatOptions;
+}
 /**
  * A source normalized into every shape an exporter might need. `doc` is always
  * present; `markdownDoc` is present when the source was markdown-shaped (an
@@ -46,16 +80,20 @@ interface ConvertOptions {
     from?: FormatId;
     /** Theme id to apply to the exported document. */
     themeId?: string;
-    /** Transform style id to apply before export. */
-    transformStyle?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
+    /** Built-in/registry id or call-scoped style to apply before export. */
+    transformStyle?: TransformStyleInput;
+    /** Explicit caller-owned registry used to resolve transform style ids. */
+    transformRegistry?: TransformStyleRegistry;
     /** Content-aware auto-templating when deriving a Doc from markdown. */
     autoTemplates?: boolean;
-    /** Title hint for exporters that support one (epub, html). */
+    /** Title hint for exporters that expose document metadata. */
     title?: string;
     /** Lazily resolve the standalone player IIFE bundle (required for HTML export). */
     resolvePlayerScript?: () => Promise<string>;
-    /** Per-format escape hatch for extra options. */
-    formatOptions?: Record<FormatId, Record<string, unknown>>;
+    /** Typed per-format options for built-ins; custom format ids remain extensible. */
+    formatOptions?: Partial<BuiltinFormatOptions> & Record<FormatId, unknown>;
 }
 /** Describes how a single format imports to / exports from the squisq model. */
 interface FormatDefinition {
@@ -164,4 +202,4 @@ declare function defaultFormats(): FormatDefinition[];
  */
 declare function convert(source: ConvertSource, to: FormatId, options?: ConvertOptions): Promise<ConversionResult>;
 
-export { BUILTIN_FORMAT_IDS, ConversionError, type ConversionErrorCode, type ConversionErrorOptions, type ConversionResult, type ConvertOptions, type ConvertSource, type FormatDefinition, type FormatId, type FormatRegistry, type NormalizedInput, convert, createRegistry, defaultFormats, defaultRegistry };
+export { BUILTIN_FORMAT_IDS, type BuiltinFormatOptions, ConversionError, type ConversionErrorCode, type ConversionErrorOptions, type ConversionResult, type ConvertOptions, type ConvertSource, type DbkFormatOptions, type FormatDefinition, type FormatId, type FormatRegistry, type MarkdownFormatOptions, type NormalizedInput, convert, createRegistry, defaultFormats, defaultRegistry };

package/dist/registry/index.js

@@ -1,11 +1,14 @@
 import {
   BUILTIN_FORMAT_IDS,
-  ConversionError,
   convert,
   createRegistry,
   defaultFormats,
   defaultRegistry
-} from "../chunk-RTS5XBZ7.js";
+} from "../chunk-2EFDWKC6.js";
+import {
+  ConversionError
+} from "../chunk-ODL3SSPT.js";
+import "../chunk-H7T5DXUU.js";
 export {
   BUILTIN_FORMAT_IDS,
   ConversionError,