docxmlater 10.0.1 → 10.0.3

package/src/zip/errors.ts

@@ -0,0 +1,69 @@
+/**
+ * Custom error classes for ZIP and DOCX operations
+ */
+
+/**
+ * Base error class for all DOCX-related errors
+ */
+export class DocxError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'DocxError';
+    Object.setPrototypeOf(this, DocxError.prototype);
+  }
+}
+
+/**
+ * Error thrown when a DOCX file is not found
+ */
+export class DocxNotFoundError extends DocxError {
+  constructor(filePath: string) {
+    super(`DOCX file not found: ${filePath}`);
+    this.name = 'DocxNotFoundError';
+    Object.setPrototypeOf(this, DocxNotFoundError.prototype);
+  }
+}
+
+/**
+ * Error thrown when a file is not a valid DOCX/ZIP archive
+ */
+export class InvalidDocxError extends DocxError {
+  constructor(message: string) {
+    super(`Invalid DOCX file: ${message}`);
+    this.name = 'InvalidDocxError';
+    Object.setPrototypeOf(this, InvalidDocxError.prototype);
+  }
+}
+
+/**
+ * Error thrown when a ZIP archive is corrupted
+ */
+export class CorruptedArchiveError extends DocxError {
+  constructor(message: string) {
+    super(`Corrupted archive: ${message}`);
+    this.name = 'CorruptedArchiveError';
+    Object.setPrototypeOf(this, CorruptedArchiveError.prototype);
+  }
+}
+
+/**
+ * Error thrown when a required DOCX file is missing
+ */
+export class MissingRequiredFileError extends DocxError {
+  constructor(fileName: string) {
+    super(`Missing required file: ${fileName}`);
+    this.name = 'MissingRequiredFileError';
+    Object.setPrototypeOf(this, MissingRequiredFileError.prototype);
+  }
+}
+
+/**
+ * Error thrown when a file operation fails
+ */
+export class FileOperationError extends DocxError {
+  constructor(operation: string, message: string) {
+    super(`File operation '${operation}' failed: ${message}`);
+    this.name = 'FileOperationError';
+    Object.setPrototypeOf(this, FileOperationError.prototype);
+  }
+}

package/src/zip/types.ts

@@ -0,0 +1,116 @@
+/**
+ * Types and interfaces for ZIP archive handling
+ */
+
+/**
+ * Represents a file within a ZIP archive
+ */
+export interface ZipFile {
+  /** The path of the file within the archive */
+  path: string;
+  /** The content of the file (string for text, Buffer for binary) */
+  content: string | Buffer;
+  /** Whether the content is binary */
+  isBinary: boolean;
+  /** File size in bytes */
+  size: number;
+  /** Last modified date */
+  date?: Date;
+}
+
+/**
+ * Size limit configuration for document loading
+ */
+export interface SizeLimitOptions {
+  /**
+   * Size in MB at which to show a warning (default: 50 MB)
+   * Set to 0 to disable warnings
+   */
+  warningSizeMB?: number;
+  /**
+   * Maximum size in MB to load (default: 150 MB)
+   * Set to 0 to disable the limit (not recommended)
+   */
+  maxSizeMB?: number;
+}
+
+/**
+ * Default size limits for document loading
+ */
+export const DEFAULT_SIZE_LIMITS: Required<SizeLimitOptions> = {
+  warningSizeMB: 50,
+  maxSizeMB: 150,
+};
+
+/**
+ * Options for loading a DOCX file
+ */
+export interface LoadOptions {
+  /** Whether to validate the DOCX structure on load */
+  validate?: boolean;
+  /** Whether to load files lazily */
+  lazy?: boolean;
+  /** Size limit configuration (warning and max size thresholds) */
+  sizeLimits?: SizeLimitOptions;
+}
+
+/**
+ * Options for saving a DOCX file
+ */
+export interface SaveOptions {
+  /** Compression level (0-9, where 0 is no compression and 9 is maximum) */
+  compression?: number;
+  /** Whether to validate the DOCX structure before save */
+  validate?: boolean;
+}
+
+/**
+ * Options for adding files to the archive
+ */
+export interface AddFileOptions {
+  /** Whether the content is binary */
+  binary?: boolean;
+  /** Compression level for this specific file */
+  compression?: number;
+  /** Last modified date */
+  date?: Date;
+}
+
+/**
+ * Map of file paths to their contents
+ */
+export type FileMap = Map<string, ZipFile>;
+
+/**
+ * Required files for a valid DOCX structure
+ */
+export const REQUIRED_DOCX_FILES = [
+  '[Content_Types].xml',
+  '_rels/.rels',
+  'word/document.xml'
+] as const;
+
+/**
+ * Common DOCX file paths
+ */
+export const DOCX_PATHS = {
+  CONTENT_TYPES: '[Content_Types].xml',
+  RELS: '_rels/.rels',
+  DOCUMENT: 'word/document.xml',
+  DOCUMENT_RELS: 'word/_rels/document.xml.rels',
+  STYLES: 'word/styles.xml',
+  NUMBERING: 'word/numbering.xml',
+  NUMBERING_RELS: 'word/_rels/numbering.xml.rels',
+  SETTINGS: 'word/settings.xml',
+  FONT_TABLE: 'word/fontTable.xml',
+  THEME: 'word/theme/theme1.xml',
+  CORE_PROPS: 'docProps/core.xml',
+  APP_PROPS: 'docProps/app.xml',
+  MEDIA_DIR: 'word/media/',
+  FOOTNOTES: 'word/footnotes.xml',
+  ENDNOTES: 'word/endnotes.xml',
+  COMMENTS_EXTENDED: 'word/commentsExtended.xml',
+  COMMENTS_IDS: 'word/commentsIds.xml',
+  COMMENTS_EXTENSIBLE: 'word/commentsExtensible.xml',
+  WEB_SETTINGS: 'word/webSettings.xml',
+} as const;

package/dist/core/ListNormalizer.d.ts

@@ -1,23 +0,0 @@
-import type { Paragraph } from "../elements/Paragraph";
-import type { Table } from "../elements/Table";
-import type { TableCell } from "../elements/TableCell";
-import type { NumberingManager } from "../formatting/NumberingManager";
-import type { ListAnalysis, ListNormalizationOptions, ListNormalizationReport } from "../types/list-types";
-export declare function analyzeCellLists(cell: TableCell, numberingManager?: NumberingManager): ListAnalysis;
-export declare function analyzeTableLists(table: Table): Map<TableCell, ListAnalysis>;
-export declare function stripTypedPrefix(paragraph: Paragraph, prefix: string): void;
-export declare function normalizeListsInCell(cell: TableCell, options: ListNormalizationOptions, numberingManager: NumberingManager): ListNormalizationReport;
-export declare function normalizeListsInTable(table: Table, options: ListNormalizationOptions, numberingManager: NumberingManager): ListNormalizationReport;
-export declare function normalizeOrphanListLevelsInCell(cell: TableCell): number;
-export declare function normalizeOrphanListLevelsInTable(table: Table): number;
-export declare class ListNormalizer {
-    private numberingManager;
-    constructor(numberingManager: NumberingManager);
-    analyzeCell(cell: TableCell): ListAnalysis;
-    analyzeTable(table: Table): Map<TableCell, ListAnalysis>;
-    normalizeCell(cell: TableCell, options?: Partial<ListNormalizationOptions>): ListNormalizationReport;
-    normalizeTable(table: Table, options?: Partial<ListNormalizationOptions>): ListNormalizationReport;
-    normalizeAllTables(tables: Table[], options?: Partial<ListNormalizationOptions>): ListNormalizationReport;
-    private resolveOptions;
-}
-//# sourceMappingURL=ListNormalizer.d.ts.map

package/dist/core/ListNormalizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ListNormalizer.d.ts","sourceRoot":"","sources":["../../src/core/ListNormalizer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAEV,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EAGxB,MAAM,qBAAqB,CAAC;AAqF7B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,YAAY,CAwEd;AAMD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GACX,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAU9B;AAWD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA0C3E;AAWD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,EAAE,gBAAgB,GACjC,uBAAuB,CAkZzB;AAKD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,EAAE,gBAAgB,GACjC,uBAAuB,CAyBzB;AAmBD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAgCvE;AAQD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAUrE;AAqFD,qBAAa,cAAc;IACzB,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,gBAAgB,EAAE,gBAAgB;IAO9C,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY;IAO1C,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC;IAOxD,aAAa,CACX,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAC9C,uBAAuB;IAQ1B,cAAc,CACZ,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAC9C,uBAAuB;IAQ1B,kBAAkB,CAChB,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAC9C,uBAAuB;IAiC1B,OAAO,CAAC,cAAc;CAgBvB"}