@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/types/modules/pdf/types.d.ts

@@ -124,37 +124,169 @@ export interface PdfPageSetupData {
     showGridLines?: boolean;
     printArea?: string;
 }
+/** Anchor range shared by embedded images and charts. */
+export interface PdfAnchorRange {
+    tl: {
+        col: number;
+        row: number;
+        nativeCol?: number;
+        nativeRow?: number;
+        nativeColOff?: number;
+        nativeRowOff?: number;
+    };
+    br?: {
+        col: number;
+        row: number;
+        nativeCol?: number;
+        nativeRow?: number;
+        nativeColOff?: number;
+        nativeRowOff?: number;
+    };
+    /**
+     * Image variant uses pixels (px × 0.75 = pt).
+     * Chart variant uses EMU (cx / 9525 = pt).
+     * The layout engine picks the correct conversion via `extUnit`.
+     */
+    ext?: {
+        width: number;
+        height: number;
+    };
+    /** Unit of measure for `ext`. Defaults to "px" for backwards compatibility. */
+    extUnit?: "px" | "emu";
+}
 /** An image embedded in a sheet. */
 export interface PdfSheetImage {
     data: Uint8Array;
     format: "jpeg" | "png";
-    range: {
-        tl: {
-            col: number;
-            row: number;
-            nativeCol?: number;
-            nativeRow?: number;
-            nativeColOff?: number;
-            nativeRowOff?: number;
-        };
-        br?: {
-            col: number;
-            row: number;
-            nativeCol?: number;
-            nativeRow?: number;
-            nativeColOff?: number;
-            nativeRowOff?: number;
-        };
-        ext?: {
-            width: number;
-            height: number;
-        };
+    range: PdfAnchorRange;
+}
+/**
+ * Path operator set understood by {@link PdfChartDrawingSurface}.`drawPath`.
+ * Structurally compatible with `ChartPdfPathOp` from `@excel/chart` so the
+ * excel-bridge can forward between the two at the cast boundary.
+ */
+export type PdfChartPathOp = {
+    op: "move";
+    x: number;
+    y: number;
+} | {
+    op: "line";
+    x: number;
+    y: number;
+} | {
+    op: "curve";
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x3: number;
+    y3: number;
+} | {
+    op: "close";
+};
+/**
+ * Drawing surface used by vector chart renderers when embedded in a PDF page.
+ *
+ * Structurally compatible with `ChartPdfDrawingSurface` from the Excel chart
+ * renderer. Declared locally in the PDF layer so the rendering pipeline does
+ * not need to import chart types — only `excel-bridge.ts` (the documented
+ * layer-crossing file) forwards real chart models to the surface.
+ *
+ * All coordinates are in **PDF points with bottom-left origin**, matching the
+ * convention the chart renderer emits after its internal Y-flip.
+ */
+export interface PdfChartDrawingSurface {
+    drawRect(options: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        fill?: PdfColor;
+        stroke?: PdfColor;
+        lineWidth?: number;
+    }): unknown;
+    drawLine(options: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        color?: PdfColor;
+        lineWidth?: number;
+        dashPattern?: number[];
+    }): unknown;
+    drawText(text: string, options: {
+        x: number;
+        y: number;
+        fontSize?: number;
+        color?: PdfColor;
+        rotation?: number;
+        anchor?: "start" | "middle" | "end";
+        bold?: boolean;
+        italic?: boolean;
+        fontFamily?: string;
+    }): unknown;
+    drawCircle?(options: {
+        cx: number;
+        cy: number;
+        r: number;
+        fill?: PdfColor;
+        stroke?: PdfColor;
+        lineWidth?: number;
+    }): unknown;
+    drawPath?(ops: PdfChartPathOp[], options?: {
+        fill?: PdfColor;
+        stroke?: PdfColor;
+        closePath?: boolean;
+        lineWidth?: number;
+        dashPattern?: number[];
+    }): unknown;
+}
+/**
+ * A chart embedded in a sheet.
+ *
+ * Either provides a `drawVector` callback (preferred — selectable text,
+ * resolution-independent shapes) or a pre-rasterised `raster` payload that
+ * falls through to the image XObject pipeline. Exactly one of the two should
+ * be populated; if both are present the renderer prefers `drawVector`.
+ */
+export interface PdfSheetChart {
+    range: PdfAnchorRange;
+    /**
+     * Vector renderer. Bound in `excel-bridge.ts` over the concrete chart
+     * model; the PDF pipeline invokes it with a surface that adapts the
+     * current page's content stream. `rect` is in PDF page coordinates
+     * (bottom-left origin).
+     */
+    drawVector?: (surface: PdfChartDrawingSurface, rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }) => void;
+    /**
+     * Raster fallback used when the chart has no vector path (currently only
+     * ChartEx layouts not in the `VECTOR_PDF_CHART_EX_LAYOUT_IDS` whitelist).
+     */
+    raster?: {
+        data: Uint8Array;
+        format: "png" | "jpeg";
     };
 }
-/** A single sheet in the PDF input model. */
+/** A single cell-grid sheet in the PDF input model. */
 export interface PdfSheetData {
+    /**
+     * Discriminator. Optional for backwards compatibility — when absent the
+     * exporter treats the sheet as a regular cell-grid worksheet.
+     */
+    kind?: "worksheet";
     name: string;
     state?: "visible" | "hidden" | "veryHidden";
+    /**
+     * Tab order from the source workbook. Used by `excelToPdf` to interleave
+     * worksheets and chartsheets in the same order Excel would display them.
+     * Optional; when absent the sheet keeps its array position.
+     */
+    orderNo?: number;
     /** Data bounds (1-based) */
     bounds: {
         top: number;
@@ -175,7 +307,54 @@ export interface PdfSheetData {
     colBreaks?: number[];
     /** Embedded images */
     images?: PdfSheetImage[];
+    /** Embedded charts (classic + ChartEx) */
+    charts?: PdfSheetChart[];
 }
+/**
+ * A chartsheet — a single-chart "sheet" with no cell grid.
+ *
+ * Excel stores chartsheets under `xl/chartsheets/sheetN.xml`, parallel to
+ * the worksheet family. A chartsheet has no rows/columns/cells; the entire
+ * printed canvas is one chart. The PDF pipeline honours that semantic: a
+ * chartsheet produces exactly one LayoutPage with a single chart filling
+ * the content area (below the optional header, above the optional footer).
+ */
+export interface PdfChartsheetData {
+    kind: "chartsheet";
+    name: string;
+    state?: "visible" | "hidden" | "veryHidden";
+    /** Tab order — used to interleave with worksheets. See {@link PdfSheetData.orderNo}. */
+    orderNo?: number;
+    /**
+     * Page orientation override. Excel's chartsheets default to landscape
+     * (wider canvas suits most charts) and we keep that default when this
+     * field is absent.
+     */
+    orientation?: "portrait" | "landscape";
+    /** The single chart that fills the sheet canvas. */
+    chart: {
+        drawVector?: PdfSheetChart["drawVector"];
+        raster?: PdfSheetChart["raster"];
+    };
+    /**
+     * Optional page setup overrides. Only a subset of the worksheet
+     * `PdfPageSetupData` is meaningful here (chartsheets don't have
+     * gridlines, print titles, row/col breaks, etc.). The renderer reads
+     * `orientation` off `this.orientation` first, then falls back to
+     * `pageSetup?.orientation`.
+     */
+    pageSetup?: PdfPageSetupData;
+}
+/**
+ * Union of sheet shapes accepted by {@link PdfWorkbook.sheets}.
+ *
+ * Named `PdfWorkbookSheet` (not `PdfSheet`) because `PdfSheet` already
+ * denotes a different user-facing input type in `pdf.ts` — the simple
+ * "pass me a 2D array or a single sheet description" shape.
+ */
+export type PdfWorkbookSheet = PdfSheetData | PdfChartsheetData;
+/** Type guard distinguishing chartsheets from cell-grid worksheets. */
+export declare function isPdfChartsheet(sheet: PdfWorkbookSheet): sheet is PdfChartsheetData;
 /**
  * A workbook data structure for PDF generation.
  * This is a plain data object — not tied to the Excel module.
@@ -184,7 +363,7 @@ export interface PdfWorkbook {
     title?: string;
     creator?: string;
     subject?: string;
-    sheets: PdfSheetData[];
+    sheets: PdfWorkbookSheet[];
 }
 /**
  * Standard page sizes in PDF points (1 point = 1/72 inch).
@@ -750,6 +929,8 @@ export interface LayoutPage {
     rowHeights: number[];
     /** Images to render on this page */
     images: LayoutImage[];
+    /** Charts to render on this page */
+    charts: LayoutChart[];
     /** Scale factor applied to this page (for fitToPage) */
     scaleFactor: number;
 }
@@ -764,3 +945,26 @@ export interface LayoutImage {
     /** Rectangle in page coordinates (PDF points, origin bottom-left) */
     rect: PdfRect;
 }
+/**
+ * A positioned chart on a PDF page.
+ *
+ * Either `drawVector` (preferred) or `raster` must be provided; the exporter
+ * prefers `drawVector` when both are present so the PDF keeps selectable
+ * text and resolution-independent shapes.
+ */
+export interface LayoutChart {
+    /** Rectangle in page coordinates (PDF points, origin bottom-left) */
+    rect: PdfRect;
+    /** Vector rendering callback, if the chart can be drawn as PDF geometry. */
+    drawVector?: (surface: PdfChartDrawingSurface, rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }) => void;
+    /** Raster fallback for charts that have no vector path. */
+    raster?: {
+        data: Uint8Array;
+        format: "png" | "jpeg";
+    };
+}

package/dist/types/modules/pdf/word-bridge.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Word-to-PDF Bridge
+ *
+ * Converts a Word document (DocxDocument) to PDF.
+ * Like excel-bridge.ts, this is the ONLY file in the PDF module that imports
+ * from @word.
+ *
+ * @example
+ * ```typescript
+ * import { readDocx } from "excelts/word";
+ * import { docxToPdf } from "excelts/pdf";
+ *
+ * const doc = await readDocx(docxBytes);
+ * const pdfBytes = await docxToPdf(doc);
+ * ```
+ *
+ * Note: This is a simple flow-based renderer. For high-fidelity output,
+ * consider using Microsoft Word or LibreOffice.
+ */
+import type { DocxDocument } from "../word/types.js";
+/** Options for DOCX → PDF conversion. */
+export interface DocxToPdfOptions {
+    /** Page width in points (default: from document sectPr or 612 US Letter). */
+    readonly pageWidth?: number;
+    /** Page height in points (default: from document sectPr or 792 US Letter). */
+    readonly pageHeight?: number;
+    /** Top margin in points (default: from sectPr or 72). */
+    readonly marginTop?: number;
+    /** Bottom margin in points (default: from sectPr or 72). */
+    readonly marginBottom?: number;
+    /** Left margin in points (default: from sectPr or 72). */
+    readonly marginLeft?: number;
+    /** Right margin in points (default: from sectPr or 72). */
+    readonly marginRight?: number;
+    /** Default font family (default: "Times-Roman"). */
+    readonly defaultFont?: string;
+    /** Default font size in points (default: 11). */
+    readonly defaultFontSize?: number;
+}
+/**
+ * Convert a DocxDocument to PDF bytes.
+ *
+ * @param doc - The DOCX document model (from readDocx or DocumentBuilder.build()).
+ * @param options - PDF rendering options.
+ * @returns Promise of PDF bytes.
+ */
+export declare function docxToPdf(doc: DocxDocument, options?: DocxToPdfOptions): Promise<Uint8Array>;

package/dist/types/modules/word/constants.d.ts

@@ -0,0 +1,179 @@
+/**
+ * DOCX Module - Constants
+ *
+ * XML namespaces, relationship types, content types, and other constants
+ * for the OOXML WordprocessingML format.
+ */
+/** WordprocessingML main namespace (w:). */
+export declare const NS_W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+/** Relationships namespace (r:). */
+export declare const NS_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+/** DrawingML Word Processing Drawing namespace (wp:). */
+export declare const NS_WP = "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
+/** DrawingML main namespace (a:). */
+export declare const NS_A = "http://schemas.openxmlformats.org/drawingml/2006/main";
+/** DrawingML picture namespace (pic:). */
+export declare const NS_PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+/** Markup compatibility namespace (mc:). */
+export declare const NS_MC = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+/** VML namespace (v:). */
+export declare const NS_V = "urn:schemas-microsoft-com:vml";
+/** Office VML extensions (o:). */
+export declare const NS_O = "urn:schemas-microsoft-com:office:office";
+/** Math namespace (m:). */
+export declare const NS_M = "http://schemas.openxmlformats.org/officeDocument/2006/math";
+/** Word 2010 extensions (w14:). */
+export declare const NS_W14 = "http://schemas.microsoft.com/office/word/2010/wordml";
+/** Word 2013 extensions (w15:). */
+export declare const NS_W15 = "http://schemas.microsoft.com/office/word/2012/wordml";
+/** Word Processing Group (wpg:). */
+export declare const NS_WPG = "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup";
+/** Word Processing Ink (wpi:). */
+export declare const NS_WPI = "http://schemas.microsoft.com/office/word/2010/wordprocessingInk";
+/** Word Processing Shape (wps:). */
+export declare const NS_WPS = "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
+/** Word Processing Canvas (wpc:). */
+export declare const NS_WPC = "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas";
+/** Word Processing Drawing 2010 (wp14:). */
+export declare const NS_WP14 = "http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing";
+/** Office Word (w10:). */
+export declare const NS_W10 = "urn:schemas-microsoft-com:office:word";
+/** SVG extension (asvg:). */
+export declare const NS_ASVG = "http://schemas.microsoft.com/office/drawing/2016/SVG/main";
+/** SVG extension GUID for a:ext. */
+export declare const GUID_SVG = "{96DAC541-7B7A-43D3-8B79-37D633B846F1}";
+/** Dublin Core elements (dc:). */
+export declare const NS_DC = "http://purl.org/dc/elements/1.1/";
+/** Dublin Core terms (dcterms:). */
+export declare const NS_DCTERMS = "http://purl.org/dc/terms/";
+/** Dublin Core DCMI type (dcmitype:). */
+export declare const NS_DCMITYPE = "http://purl.org/dc/dcmitype/";
+/** Core properties namespace (cp:). */
+export declare const NS_CP = "http://schemas.openxmlformats.org/package/2006/metadata/core-properties";
+/** Extended properties namespace. */
+export declare const NS_EP = "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties";
+/** Doc props VTypes namespace (vt:). */
+export declare const NS_VT = "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes";
+/** Custom properties namespace. */
+export declare const NS_CUSTOM = "http://schemas.openxmlformats.org/officeDocument/2006/custom-properties";
+/** XML Schema instance namespace (xsi:). */
+export declare const NS_XSI = "http://www.w3.org/2001/XMLSchema-instance";
+/** Content Types namespace. */
+export declare const NS_CONTENT_TYPES = "http://schemas.openxmlformats.org/package/2006/content-types";
+/** Package relationships namespace. */
+export declare const NS_PKG_RELS = "http://schemas.openxmlformats.org/package/2006/relationships";
+/** DrawingML picture URI for graphicData. */
+export declare const URI_PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+/** Standard namespace attributes for w:document root element. */
+export declare const DOCUMENT_NAMESPACES: Record<string, string>;
+/** OOXML relationship type URIs. */
+export declare const RelType: {
+    readonly OfficeDocument: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
+    readonly CoreProperties: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties";
+    readonly ExtendedProperties: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties";
+    readonly CustomProperties: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties";
+    readonly Styles: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+    readonly Settings: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings";
+    readonly FontTable: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable";
+    readonly Numbering: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering";
+    readonly Footnotes: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes";
+    readonly Endnotes: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes";
+    readonly Header: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
+    readonly Footer: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
+    readonly Image: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+    readonly Hyperlink: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+    readonly Theme: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme";
+    readonly Comments: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+    readonly CommentsExtended: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/commentsExtended";
+    readonly WebSettings: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings";
+    readonly Glossary: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument";
+    readonly Font: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
+    readonly Chart: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
+    readonly Diagram: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData";
+    readonly CustomXml: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml";
+    readonly CustomXmlProps: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps";
+    readonly VbaProject: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vbaProject";
+    readonly People: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/people";
+    readonly DigitalSignature: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/digital-signature/signature";
+};
+/** OOXML content type strings. */
+export declare const ContentType: {
+    readonly Relationships: "application/vnd.openxmlformats-package.relationships+xml";
+    readonly Xml: "application/xml";
+    readonly Document: "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml";
+    readonly Styles: "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml";
+    readonly Settings: "application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml";
+    readonly FontTable: "application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml";
+    readonly Numbering: "application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml";
+    readonly Footnotes: "application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml";
+    readonly Endnotes: "application/vnd.openxmlformats-officedocument.wordprocessingml.endnotes+xml";
+    readonly Header: "application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml";
+    readonly Footer: "application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml";
+    readonly Theme: "application/vnd.openxmlformats-officedocument.theme+xml";
+    readonly CoreProperties: "application/vnd.openxmlformats-package.core-properties+xml";
+    readonly ExtendedProperties: "application/vnd.openxmlformats-officedocument.extended-properties+xml";
+    readonly CustomProperties: "application/vnd.openxmlformats-officedocument.custom-properties+xml";
+    readonly Comments: "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml";
+    readonly CommentsExtended: "application/vnd.ms-word.commentsExtended+xml";
+    readonly People: "application/vnd.ms-word.people+xml";
+    readonly WebSettings: "application/vnd.openxmlformats-officedocument.wordprocessingml.webSettings+xml";
+    readonly Png: "image/png";
+    readonly Jpeg: "image/jpeg";
+    readonly Gif: "image/gif";
+    readonly Bmp: "image/bmp";
+    readonly Tiff: "image/tiff";
+    readonly Svg: "image/svg+xml";
+    readonly Webp: "image/webp";
+    readonly Emf: "image/x-emf";
+    readonly Wmf: "image/x-wmf";
+    readonly ObfuscatedFont: "application/vnd.openxmlformats-officedocument.obfuscatedFont";
+    readonly Chart: "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
+    readonly CustomXml: "application/xml";
+    readonly VbaProject: "application/vnd.ms-office.vbaProject";
+};
+/** Map from image file extension to content type. */
+export declare const IMAGE_CONTENT_TYPES: Record<string, string>;
+/** Standard XML declaration attributes. */
+export declare const STD_DOC_ATTRIBUTES: {
+    version: string;
+    encoding: string;
+    standalone: string;
+};
+/** Default page size: US Letter (8.5" x 11") in twips. */
+export declare const DEFAULT_PAGE_WIDTH = 12240;
+export declare const DEFAULT_PAGE_HEIGHT = 15840;
+/** A4 page size in twips. */
+export declare const A4_PAGE_WIDTH = 11906;
+export declare const A4_PAGE_HEIGHT = 16838;
+/** Default margins: 1 inch all around. */
+export declare const DEFAULT_MARGIN = 1440;
+export declare const DEFAULT_HEADER_FOOTER_MARGIN = 720;
+/** Default column space. */
+export declare const DEFAULT_COLUMN_SPACE = 720;
+/** Standard DOCX part file paths within the ZIP package. */
+export declare const PartPath: {
+    readonly ContentTypes: "[Content_Types].xml";
+    readonly PackageRels: "_rels/.rels";
+    readonly Document: "word/document.xml";
+    readonly DocumentRels: "word/_rels/document.xml.rels";
+    readonly Styles: "word/styles.xml";
+    readonly Settings: "word/settings.xml";
+    readonly FontTable: "word/fontTable.xml";
+    readonly Numbering: "word/numbering.xml";
+    readonly Footnotes: "word/footnotes.xml";
+    readonly Endnotes: "word/endnotes.xml";
+    readonly Comments: "word/comments.xml";
+    readonly CommentsExtended: "word/commentsExtended.xml";
+    readonly People: "word/people.xml";
+    readonly WebSettings: "word/webSettings.xml";
+    readonly Theme: "word/theme/theme1.xml";
+    readonly CoreProps: "docProps/core.xml";
+    readonly AppProps: "docProps/app.xml";
+    readonly CustomProps: "docProps/custom.xml";
+    readonly Thumbnail: "docProps/thumbnail.jpeg";
+    readonly header: (n: number) => string;
+    readonly headerRels: (n: number) => string;
+    readonly footer: (n: number) => string;
+    readonly footerRels: (n: number) => string;
+    readonly media: (name: string) => string;
+};

package/dist/types/modules/word/content-types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * DOCX Module - Content Types Generator
+ *
+ * Generates [Content_Types].xml for the DOCX package.
+ */
+import type { XmlSink } from "../xml/types.js";
+/** Content type override entry. */
+export interface ContentTypeOverride {
+    readonly partName: string;
+    readonly contentType: string;
+}
+/**
+ * Generates the [Content_Types].xml part.
+ */
+export declare class ContentTypesManager {
+    private readonly _defaults;
+    private readonly _overrides;
+    constructor();
+    /** Add a default content type for a file extension. */
+    addDefault(extension: string, contentType: string): void;
+    /** Add an override content type for a specific part. */
+    addOverride(partName: string, contentType: string): void;
+    /** Add image extension defaults from a set of used extensions. */
+    addImageDefaults(extensions: Iterable<string>): void;
+    /** Render the [Content_Types].xml to a sink. */
+    render(xml: XmlSink): void;
+}

package/dist/types/modules/word/digital-signatures.d.ts

@@ -0,0 +1,87 @@
+/**
+ * DOCX Digital Signatures (OPC Package Digital Signature)
+ *
+ * DOCX documents may contain digital signatures stored in:
+ *   _xmlsignatures/origin.sigs
+ *   _xmlsignatures/sig1.xml, sig2.xml, ...
+ *   _xmlsignatures/_rels/origin.sigs.rels
+ *
+ * The signatures use W3C XML Digital Signature (XMLDSig) format with
+ * Office-specific OfficeObject extensions per MS-OFFCRYPTO.
+ *
+ * This module provides:
+ * - Detection and extraction of signature metadata
+ * - Preservation of signatures through round-trip (via opaqueParts)
+ *
+ * Note: Creating new signatures requires X.509 certificate handling and
+ * is outside the scope of this module. Consider using a dedicated signing
+ * tool for the actual signing step.
+ *
+ * References:
+ *   - OPC: Open Packaging Conventions (ECMA-376 Part 2)
+ *   - XMLDSig: https://www.w3.org/TR/xmldsig-core/
+ */
+/** Parsed digital signature metadata. */
+export interface DigitalSignatureInfo {
+    /** Signer's display name (from OfficeObject > SignatureInfoV1 > SignatureText). */
+    readonly signer?: string;
+    /** Sign date (ISO 8601). */
+    readonly signDate?: string;
+    /** Signature commitment type URI. */
+    readonly commitmentType?: string;
+    /** Signature comments/reason. */
+    readonly signatureComments?: string;
+    /** Signature purpose. */
+    readonly purpose?: string;
+    /** Signature provider URL. */
+    readonly providerUrl?: string;
+    /** Certificate subject CN. */
+    readonly certificateSubject?: string;
+    /** Certificate issuer CN. */
+    readonly certificateIssuer?: string;
+    /** Certificate serial number. */
+    readonly certificateSerialNumber?: string;
+    /** Hash of the signature (base64). */
+    readonly signatureValue?: string;
+    /** Whether signature is valid (requires verification). */
+    readonly valid?: boolean;
+    /** Raw XML for preservation. */
+    readonly rawXml: string;
+    /** Signature file name (e.g. "sig1.xml"). */
+    readonly fileName: string;
+}
+/**
+ * Check if a document has digital signatures.
+ *
+ * @param opaquePaths - Set of paths in the package (typically from opaqueParts).
+ * @returns True if signatures are present.
+ */
+export declare function hasDigitalSignatures(opaquePaths: readonly string[]): boolean;
+/**
+ * Extract digital signature metadata from sig XML content.
+ *
+ * @param xmlStr - The signature XML content.
+ * @param fileName - The file name (e.g. "sig1.xml").
+ * @returns Parsed signature info.
+ */
+export declare function parseSignatureXml(xmlStr: string, fileName: string): DigitalSignatureInfo;
+/**
+ * Extract all digital signatures from opaque parts of a document.
+ *
+ * @param opaqueParts - Opaque parts (from DocxDocument.opaqueParts).
+ * @returns Array of parsed signature info.
+ */
+export declare function extractSignatures(opaqueParts: readonly {
+    path: string;
+    data: Uint8Array;
+}[] | undefined): DigitalSignatureInfo[];
+/**
+ * Verify that a digital signature's structural integrity is intact.
+ *
+ * Note: This does NOT verify the cryptographic signature — that requires
+ * access to the signer's public key and a full XMLDSig implementation.
+ * Use a dedicated XMLDSig library for cryptographic verification.
+ *
+ * @returns True if the signature structure is well-formed.
+ */
+export declare function isWellFormedSignature(info: DigitalSignatureInfo): boolean;