@a3s-lab/office 0.2.2 → 0.4.0

package/dist/internal/features/work/work-docx-note-comment-identity.d.ts

@@ -0,0 +1,15 @@
+import { type WorkDocumentNote, type WorkDocumentNoteKind } from './work-document-notes';
+import type { WorkDocumentComment, WorkDocumentCommentReply } from './work-types';
+export interface AssignedDocxCommentReply {
+    id: number;
+    reply: WorkDocumentCommentReply;
+}
+export interface AssignedDocxCommentThread {
+    comment: WorkDocumentComment;
+    id: number;
+    replies: AssignedDocxCommentReply[];
+}
+export declare function importedDocumentNoteId(kind: WorkDocumentNoteKind, target: string): string | null;
+export declare function assignDocxNoteIds(notes: readonly WorkDocumentNote[]): Map<string, number>;
+export declare function assignDocxCommentThreads(comments: readonly WorkDocumentComment[]): AssignedDocxCommentThread[];
+export declare function normalizeDocxCommentId(value: string | null | undefined): number | null;

package/dist/internal/features/work/work-docx-note-comment-run-preservation.d.ts

@@ -0,0 +1,4 @@
+import { type DocxIgnorableExtensionPair } from './work-docx-ignorable-extension-preservation';
+type NoteCommentContentKind = 'comment' | 'note';
+export declare function preserveDocxNoteCommentRunContent(generatedDocument: Document, sourceDocument: Document, scopes: readonly DocxIgnorableExtensionPair[], kind: NoteCommentContentKind): void;
+export {};

package/dist/internal/features/work/work-docx-note-comment-run-properties.d.ts

@@ -0,0 +1,2 @@
+export declare function preserveDocxNoteCommentRunProperties(generatedDocument: Document, generatedRun: Element, sourceRun: Element, kind: 'comment' | 'note'): void;
+export declare function cloneDocxNoteCommentRunProperties(document: Document, sourceProperties: Element, targetContext: Element, kind: 'comment' | 'note'): Element | null;

package/dist/internal/features/work/work-docx-note-image-import.d.ts

@@ -0,0 +1,12 @@
+import { type ImportedDocxImageLayoutMarkerState, type ImportedDocxImageLayoutMarkers } from './work-docx-image-layout-import';
+import type { OoxmlPackage } from './work-ooxml-package';
+interface MarkedNoteImagePart {
+    document: Document;
+    path: string;
+}
+export interface ImportedDocxNoteImageMarkers {
+    markers: ImportedDocxImageLayoutMarkers;
+    parts: MarkedNoteImagePart[];
+}
+export declare function markDocxNoteImageLayouts(archive: OoxmlPackage, state: ImportedDocxImageLayoutMarkerState): Promise<ImportedDocxNoteImageMarkers>;
+export {};

package/dist/internal/features/work/work-docx-note-image-relationships.d.ts

@@ -0,0 +1 @@
+export declare function patchDocxNoteImageRelationships(buffer: ArrayBuffer): Promise<ArrayBuffer>;

package/dist/internal/features/work/work-docx-numbering-extension-preservation.d.ts

@@ -0,0 +1,6 @@
+import type JSZip from 'jszip';
+export interface DocxSourceNumberingIdentity {
+    numId: number;
+    abstractNumId?: number;
+}
+export declare function preserveDocxNumberingExtensions(generated: JSZip, source: JSZip, sourceIdentities: readonly (DocxSourceNumberingIdentity | null)[], generatedPath?: string, sourcePath?: string): Promise<void>;

package/dist/internal/features/work/work-docx-numbering.d.ts

@@ -0,0 +1 @@
+export declare function patchDocxNumberingRestartRules(buffer: ArrayBuffer, rules: ReadonlyArray<ReadonlyMap<number, number>>): Promise<ArrayBuffer>;

package/dist/internal/features/work/work-docx-page-borders-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { OoxmlPackage } from './work-ooxml-package';
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxPageBorders(archive: OoxmlPackage, document: Document): Promise<WorkCompatibilityIssue[]>;

package/dist/internal/features/work/work-docx-page-borders-import.d.ts

@@ -0,0 +1,10 @@
+import { type WorkDocumentPageBorders } from './work-document-page-borders';
+import { type DocxThemeSource } from './work-docx-theme';
+export interface InspectedDocxPageBorders {
+    status: 'absent' | 'valid' | 'invalid';
+    pageBorders?: WorkDocumentPageBorders;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function inspectDocxPageBorders(sectionProperties: Element, themeSource?: DocxThemeSource): InspectedDocxPageBorders;
+export declare function parseDocxPageBorders(sectionProperties: Element, themeSource?: DocxThemeSource): WorkDocumentPageBorders | null | undefined;

package/dist/internal/features/work/work-docx-page-margins-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { OoxmlPackage } from './work-ooxml-package';
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxPageMargins(archive: OoxmlPackage, document: Document): Promise<WorkCompatibilityIssue[]>;

package/dist/internal/features/work/work-docx-page-margins-import.d.ts

@@ -0,0 +1,18 @@
+import { type WorkDocumentPageMargins } from './work-document-page-margins';
+export interface InspectedDocxPageMarginSettings {
+    mirrorMargins?: boolean;
+    gutterAtTop?: boolean;
+    invalidCount: number;
+    spoofedCount: number;
+    incompatible: string[];
+}
+export interface InspectedDocxPageMargins {
+    status: 'absent' | 'valid' | 'invalid';
+    pageMargins?: WorkDocumentPageMargins;
+    gutterOnRight?: boolean;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function inspectDocxPageMarginSettings(settings: Document | null | undefined): InspectedDocxPageMarginSettings;
+export declare function inspectDocxPageMargins(sectionProperties: Element, settings?: InspectedDocxPageMarginSettings): InspectedDocxPageMargins;
+export declare function parseDocxPageMargins(sectionProperties: Element, settings: InspectedDocxPageMarginSettings, fallback?: WorkDocumentPageMargins): WorkDocumentPageMargins | null | undefined;

package/dist/internal/features/work/work-docx-page-size-diagnostics.d.ts

@@ -0,0 +1,2 @@
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxPageSize(document: Document): WorkCompatibilityIssue[];

package/dist/internal/features/work/work-docx-page-size-import.d.ts

@@ -0,0 +1,17 @@
+import { type WorkDocumentPageGeometry, type WorkDocumentPaperSource } from './work-document-page-size';
+export interface InspectedDocxPageSize {
+    status: 'absent' | 'valid' | 'invalid';
+    pageGeometry?: WorkDocumentPageGeometry;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export interface InspectedDocxPaperSource {
+    status: 'absent' | 'valid' | 'invalid';
+    paperSource?: WorkDocumentPaperSource;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function inspectDocxPageSize(sectionProperties: Element): InspectedDocxPageSize;
+export declare function inspectDocxPaperSource(sectionProperties: Element): InspectedDocxPaperSource;
+export declare function parseDocxPageGeometry(sectionProperties: Element, fallback?: WorkDocumentPageGeometry): WorkDocumentPageGeometry | null | undefined;
+export declare function parseDocxPaperSource(sectionProperties: Element, fallback?: WorkDocumentPaperSource): WorkDocumentPaperSource | null | undefined;

package/dist/internal/features/work/work-docx-paragraph-borders-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { OoxmlPackage } from './work-ooxml-package';
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxParagraphBorders(archive: OoxmlPackage, document: Document): Promise<WorkCompatibilityIssue[]>;

package/dist/internal/features/work/work-docx-paragraph-borders-export.d.ts

@@ -0,0 +1,18 @@
+import type { IParagraphPropertiesOptions } from 'docx';
+import { type DocumentParagraphBorder, type DocumentParagraphBorders } from './work-document-paragraph-borders';
+type ParagraphBorderOptions = Partial<Pick<IParagraphPropertiesOptions, 'border'>>;
+interface DocxParagraphBorderPatch {
+    marker: string;
+    borders: DocumentParagraphBorders;
+}
+export declare class DocxParagraphBorderPatchCollector {
+    readonly patches: DocxParagraphBorderPatch[];
+    private nextMarker;
+    private readonly usedColors;
+    constructor(sourceHtml: string);
+    marker(source: unknown): string | null;
+}
+export declare function documentParagraphBordersDocxOptions(element: HTMLElement, collector?: DocxParagraphBorderPatchCollector): ParagraphBorderOptions;
+export declare function patchDocxParagraphBorders(buffer: ArrayBuffer, patches: readonly DocxParagraphBorderPatch[]): Promise<ArrayBuffer>;
+export declare function setDocxBorderAttributes(document: Document, element: Element, border: DocumentParagraphBorder): void;
+export {};

package/dist/internal/features/work/work-docx-paragraph-borders-import.d.ts

@@ -0,0 +1,24 @@
+import { type DocumentParagraphBorder, type DocumentParagraphBorders } from './work-document-paragraph-borders';
+import { type DocxParagraphStyleSource } from './work-docx-paragraph-styles';
+import { type DocxTableStyleSource } from './work-docx-table-styles';
+import { type DocxThemeResolver, type DocxThemeSource } from './work-docx-theme';
+export interface ImportedDocxParagraphBorderMarker {
+    marker: string;
+    borders: DocumentParagraphBorders;
+}
+export interface ImportedDocxParagraphBorderMarkers {
+    paragraphs: ImportedDocxParagraphBorderMarker[];
+    invalidCount: number;
+    spoofedCount: number;
+}
+export interface ResolvedDocxParagraphBorders {
+    borders: DocumentParagraphBorders | null;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function markDocxParagraphBorders(document: Document, styleSource?: DocxParagraphStyleSource, themeSource?: DocxThemeSource, tableStyleSource?: DocxTableStyleSource): ImportedDocxParagraphBorderMarkers;
+export declare function resolveDocxParagraphBordersForParagraph(paragraph: Element, styleSource?: DocxParagraphStyleSource, themeSource?: DocxThemeSource, tableStyleSource?: DocxTableStyleSource): ResolvedDocxParagraphBorders;
+export declare function applyImportedDocxParagraphBorderMarkers(document: Document, markers: ImportedDocxParagraphBorderMarkers): void;
+export declare function hasImportedDocxParagraphBorderMarkers(markers: ImportedDocxParagraphBorderMarkers): boolean;
+export declare function parseDirectDocxParagraphBorders(properties: Element, themeSource?: DocxThemeSource): DocumentParagraphBorders | null | undefined;
+export declare function parseDocxBorderElement(element: Element, theme: DocxThemeResolver): DocumentParagraphBorder | null;

package/dist/internal/features/work/work-docx-paragraph-default-collapsed.d.ts

@@ -0,0 +1,19 @@
+export type ParsedDocxParagraphDefaultCollapsed = {
+    status: 'absent';
+} | {
+    status: 'invalid';
+} | {
+    status: 'valid';
+    value: boolean;
+};
+interface DocxParagraphDefaultCollapsedPatch {
+    marker: string;
+    value: boolean;
+}
+export declare class DocxParagraphDefaultCollapsedPatchCollector {
+    readonly patches: DocxParagraphDefaultCollapsedPatch[];
+    register(marker: string, element: HTMLElement): void;
+}
+export declare function parseDocxParagraphDefaultCollapsed(properties: Element): ParsedDocxParagraphDefaultCollapsed;
+export declare function patchDocxParagraphDefaultCollapsed(buffer: ArrayBuffer, patches: readonly DocxParagraphDefaultCollapsedPatch[]): Promise<ArrayBuffer>;
+export {};

package/dist/internal/features/work/work-docx-paragraph-extension-preservation.d.ts

@@ -0,0 +1,2 @@
+import type JSZip from 'jszip';
+export declare function preserveDocxParagraphExtensions(generated: JSZip, source: JSZip, generatedPaths: readonly string[], sourcePaths: readonly string[]): Promise<void>;

package/dist/internal/features/work/work-docx-paragraph-identity-import.d.ts

@@ -0,0 +1,10 @@
+import { type WorkDocumentParagraphIdentity } from './work-document-paragraph-identity';
+export interface ImportedDocxParagraphIdentityMarker extends WorkDocumentParagraphIdentity {
+    marker: string;
+}
+export interface ImportedDocxParagraphIdentityMarkers {
+    paragraphs: ImportedDocxParagraphIdentityMarker[];
+}
+export declare function markDocxParagraphIdentities(document: Document): ImportedDocxParagraphIdentityMarkers;
+export declare function applyImportedDocxParagraphIdentityMarkers(document: Document, markers: ImportedDocxParagraphIdentityMarkers): void;
+export declare function hasImportedDocxParagraphIdentityMarkers(markers: ImportedDocxParagraphIdentityMarkers): boolean;

package/dist/internal/features/work/work-docx-paragraph-identity.d.ts

@@ -0,0 +1,18 @@
+import { type WorkDocumentParagraphIdentity } from './work-document-paragraph-identity';
+interface DocxParagraphIdentityPatch {
+    marker: string;
+    identity: WorkDocumentParagraphIdentity;
+    target: 'paragraph' | 'tableRow';
+}
+export declare class DocxParagraphIdentityPatchCollector {
+    private readonly source;
+    readonly patches: DocxParagraphIdentityPatch[];
+    private readonly registry;
+    private nextMarker;
+    constructor(source: string);
+    marker(element: HTMLElement): string;
+    rowMarker(element: HTMLTableRowElement): string;
+    private registerPatch;
+}
+export declare function patchDocxParagraphIdentities(buffer: ArrayBuffer, patches: readonly DocxParagraphIdentityPatch[]): Promise<ArrayBuffer>;
+export {};

package/dist/internal/features/work/work-docx-paragraph-pagination-import.d.ts

@@ -3,8 +3,13 @@ import { type DocxParagraphStyleSource } from './work-docx-paragraph-styles';
 import { type DocxTableStyleSource } from './work-docx-table-styles';
 export interface ImportedDocxParagraphPaginationMarker {
     marker: string;
-    pagination: Partial<DocumentParagraphPagination>;
+    pagination: ImportedDocxParagraphPagination;
 }
+export type ImportedDocxParagraphPagination = Partial<DocumentParagraphPagination> & {
+    contextualSpacing?: boolean;
+    defaultCollapsed?: boolean;
+    outlineLevel?: number;
+};
 export interface ImportedDocxParagraphPaginationMarkers {
     paragraphs: ImportedDocxParagraphPaginationMarker[];
 }

package/dist/internal/features/work/work-docx-paragraph-shading-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { OoxmlPackage } from './work-ooxml-package';
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxParagraphShading(archive: OoxmlPackage, document: Document): Promise<WorkCompatibilityIssue[]>;

package/dist/internal/features/work/work-docx-paragraph-shading-export.d.ts

@@ -0,0 +1,5 @@
+import type { IParagraphPropertiesOptions } from 'docx';
+import type { DocxThemePatchCollector } from './work-docx-theme-reference';
+type ParagraphShadingOptions = Partial<Pick<IParagraphPropertiesOptions, 'shading'>>;
+export declare function documentParagraphShadingDocxOptions(element: HTMLElement, themePatches?: DocxThemePatchCollector): ParagraphShadingOptions;
+export {};

package/dist/internal/features/work/work-docx-paragraph-shading-import.d.ts

@@ -0,0 +1,18 @@
+import { type DocumentParagraphShading } from './work-document-paragraph-shading';
+import { type DocxParagraphStyleSource } from './work-docx-paragraph-styles';
+import { type DocxTableStyleSource } from './work-docx-table-styles';
+import { type DocxThemeSource } from './work-docx-theme';
+export interface ImportedDocxParagraphShadingMarker {
+    marker: string;
+    shading: DocumentParagraphShading;
+}
+export interface ImportedDocxParagraphShadingMarkers {
+    paragraphs: ImportedDocxParagraphShadingMarker[];
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function markDocxParagraphShading(document: Document, styleSource?: DocxParagraphStyleSource, themeSource?: DocxThemeSource, tableStyleSource?: DocxTableStyleSource): ImportedDocxParagraphShadingMarkers;
+export declare function applyImportedDocxParagraphShadingMarkers(document: Document, markers: ImportedDocxParagraphShadingMarkers): void;
+export declare function hasImportedDocxParagraphShadingMarkers(markers: ImportedDocxParagraphShadingMarkers): boolean;
+export declare function parseDocxParagraphShadingElement(element: Element, themeSource?: DocxThemeSource): DocumentParagraphShading | null;
+export declare function parseDirectDocxParagraphShading(properties: Element, themeSource?: DocxThemeSource): DocumentParagraphShading | null | undefined;

package/dist/internal/features/work/work-docx-run-formatting-import.d.ts

@@ -1,6 +1,7 @@
 import { type DocxParagraphStyleSource } from './work-docx-paragraph-styles';
 import { type DocxThemeSource } from './work-docx-theme';
 import { type DocxTableStyleSource } from './work-docx-table-styles';
+import { type DocxThemeColorReference } from './work-docx-theme-reference';
 export interface ImportedDocxRunFormatting {
     bold?: boolean;
     italic?: boolean;
@@ -12,6 +13,8 @@ export interface ImportedDocxRunFormatting {
     fontSize?: number;
     color?: string;
     backgroundColor?: string;
+    themeColor?: DocxThemeColorReference;
+    themeFill?: DocxThemeColorReference;
 }
 export interface ImportedDocxRunFormattingMarker {
     startMarker: string;

package/dist/internal/features/work/work-docx-settings-preservation.d.ts

@@ -0,0 +1,10 @@
+import type JSZip from 'jszip';
+/**
+ * Merges passive extension markup from source settings into generated settings.
+ *
+ * WordprocessingML settings and relationship-bound markup remain generated-only.
+ * The source contribution is limited to ignorable extension attributes/elements
+ * and structurally valid, non-conflicting mc:AlternateContent blocks, plus a
+ * strictly validated color-scheme mapping required by preserved theme colors.
+ */
+export declare function preserveDocxSettingsExtensions(generated: JSZip, source: JSZip, generatedPath?: string, sourcePath?: string): Promise<void>;

package/dist/internal/features/work/work-docx-settings-xml.d.ts

@@ -0,0 +1,16 @@
+export declare const XMLNS_NAMESPACE = "http://www.w3.org/2000/xmlns/";
+export declare const XML_NAMESPACE = "http://www.w3.org/XML/1998/namespace";
+export declare function declareInheritedNamespaces(importedRoot: Element, sourceRoot: Element): void;
+export declare function collectRetainedNamespaces(root: Element, retained: Set<string>): void;
+/** Clones XML without relying on DOM importNode prefix preservation. */
+export declare function cloneXmlElement(document: Document, source: Element): Element;
+export declare function xmlNamespaceUri(element: Element, prefix: string): string | null;
+export declare function xmlDeclaredPrefix(root: Element, namespace: string): string | null;
+export declare function xmlAttributeNamespace(element: Element, item: Attr): string | null;
+export declare function xmlAttributePrefix(item: Attr): string | null;
+export declare function xmlAttributeLocalName(item: Attr): string;
+export declare function hasXmlAttribute(element: Element, namespace: string, localName: string): boolean;
+export declare function hasUnexpectedXmlAttributes(element: Element, allowedUnqualified: ReadonlySet<string>): boolean;
+export declare function hasNonWhitespaceXmlText(element: Element): boolean;
+export declare function isStructurallyValidAlternateContent(element: Element): boolean;
+export declare function assertXmlRoot(root: Element, localName: string, namespaces: ReadonlySet<string>, message: string): void;

package/dist/internal/features/work/work-docx-style-extension-preservation.d.ts

@@ -0,0 +1,2 @@
+import type JSZip from 'jszip';
+export declare function preserveDocxStyleExtensions(generated: JSZip, source: JSZip, generatedPath?: string, sourcePath?: string): Promise<void>;

package/dist/internal/features/work/work-docx-table-cell-export.d.ts

@@ -1,4 +1,5 @@
 import type { ITableCellOptions } from 'docx';
+import { type DocxThemePatchCollector } from './work-docx-theme-reference';
 type TableCellPresentationOptions = Partial<Pick<ITableCellOptions, 'borders' | 'margins' | 'shading' | 'verticalAlign'>>;
-export declare function documentTableCellDocxOptions(cell: HTMLTableCellElement, docx: typeof import('docx')): TableCellPresentationOptions;
+export declare function documentTableCellDocxOptions(cell: HTMLTableCellElement, docx: typeof import('docx'), themePatches?: DocxThemePatchCollector): TableCellPresentationOptions;
 export {};

package/dist/internal/features/work/work-docx-table-cell-import.d.ts

@@ -2,11 +2,13 @@ import { type DocumentTableBorderEdge } from './work-document-table-borders';
 import { type DocxThemeSource } from './work-docx-theme';
 import { type DocxTableStyleSource } from './work-docx-table-styles';
 import { type DocumentTableCellMarginOverrides } from './work-document-table-geometry';
+import { type DocxThemeColorReference } from './work-docx-theme-reference';
 export type ImportedDocxTableCellVerticalAlign = 'top' | 'middle' | 'bottom';
 export type ImportedDocxTableCellBorderStyle = 'solid' | 'dashed' | 'dotted' | 'double' | 'none';
 export interface ImportedDocxTableCellMarker {
     marker: string;
     backgroundColor?: string;
+    themeFill?: DocxThemeColorReference;
     verticalAlign?: ImportedDocxTableCellVerticalAlign;
     borders?: ImportedDocxTableCellBorders;
     margins?: DocumentTableCellMarginOverrides;
@@ -18,6 +20,7 @@ interface ImportedDocxCellBorder {
     color: string;
     style: ImportedDocxTableCellBorderStyle;
     width: number;
+    theme?: DocxThemeColorReference;
 }
 type ImportedDocxTableCellBorders = Partial<Record<DocumentTableBorderEdge, ImportedDocxCellBorder>>;
 export declare function markDocxTableCells(document: Document, themeSource?: DocxThemeSource, tableStyleSource?: DocxTableStyleSource): ImportedDocxTableCellMarkers;

package/dist/internal/features/work/work-docx-table-extension-preservation.d.ts

@@ -0,0 +1,2 @@
+import type JSZip from 'jszip';
+export declare function preserveDocxTableExtensions(generated: JSZip, source: JSZip, generatedPaths: readonly string[], sourcePaths: readonly string[]): Promise<void>;

package/dist/internal/features/work/work-docx-table-row-import.d.ts

@@ -2,8 +2,10 @@ export interface ImportedDocxTableRowMarker {
     marker: string;
     cantSplit?: boolean;
     repeatHeader?: boolean;
+    rowId?: string;
     rowHeight?: number;
     rowHeightRule?: 'atLeast' | 'exact';
+    rowTextId?: string;
 }
 export interface ImportedDocxTableRowMarkers {
     rows: ImportedDocxTableRowMarker[];

package/dist/internal/features/work/work-docx-table-sizing-import.d.ts

@@ -4,6 +4,7 @@ export interface ImportedDocxTableSizingMarker {
     marker: string;
     geometry: DocumentTableGeometry;
     columnWidths: number[];
+    columnPercentages: number[];
 }
 export interface ImportedDocxTableSizingMarkers {
     tables: ImportedDocxTableSizingMarker[];

package/dist/internal/features/work/work-docx-theme-reference.d.ts

@@ -0,0 +1,23 @@
+export interface DocxThemeColorReference {
+    theme: string;
+    resolved: string;
+    tint?: string;
+    shade?: string;
+}
+type DocxThemePatchKind = 'color' | 'fill' | 'border' | 'shadingColor';
+interface DocxThemePatch {
+    kind: DocxThemePatchKind;
+    marker: string;
+    reference: DocxThemeColorReference;
+}
+export declare class DocxThemePatchCollector {
+    readonly patches: DocxThemePatch[];
+    private nextMarker;
+    private readonly usedColors;
+    constructor(sourceHtml: string);
+    marker(kind: DocxThemePatchKind, reference: DocxThemeColorReference | null, currentColor: string | null): string | null;
+}
+export declare function serializeDocxThemeReference(reference: DocxThemeColorReference | null): string | undefined;
+export declare function parseDocxThemeReference(value: string | null | undefined): DocxThemeColorReference | null;
+export declare function patchDocxThemeReferences(buffer: ArrayBuffer, patches: readonly DocxThemePatch[]): Promise<ArrayBuffer>;
+export {};

package/dist/internal/features/work/work-docx-theme.d.ts

@@ -1,9 +1,12 @@
 export interface DocxThemeResolver {
     colors: ReadonlyMap<string, string>;
+    colorMapping?: ReadonlyMap<string, string>;
     fonts: ReadonlyMap<string, string>;
 }
 export type DocxThemeSource = Document | DocxThemeResolver | null | undefined;
-export declare function createDocxThemeResolver(themeDocument?: Document | null): DocxThemeResolver;
+export declare const DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES: Map<string, string>;
+export declare function createDocxThemeResolver(themeDocument?: Document | null, settingsDocument?: Document | null): DocxThemeResolver;
 export declare function resolveDocxThemeResolver(source: DocxThemeSource): DocxThemeResolver;
 export declare function docxThemeFont(resolver: DocxThemeResolver, key: string | null): string | undefined;
 export declare function docxThemeColor(resolver: DocxThemeResolver, key: string | null, tint?: string | null, shade?: string | null): string | undefined;
+export declare function parseDocxColorSchemeMappingElement(element: Element | undefined): ReadonlyMap<string, string> | null;

package/dist/internal/features/work/work-docx-twips.d.ts

@@ -0,0 +1,12 @@
+export declare const STRICT_WORDPROCESSING_NAMESPACE = "http://purl.oclc.org/ooxml/wordprocessingml/main";
+export declare function parseDocxTwipsMeasure(source: string, options: {
+    minimum: number;
+    maximum: number;
+    signed: boolean;
+    strict: boolean;
+}): number | null;
+export declare function parseBoundedDocxInteger(source: string, options: {
+    minimum: number;
+    maximum: number;
+    signed?: boolean;
+}): number | null;

package/dist/internal/features/work/work-file-contract.d.ts

@@ -0,0 +1 @@
+export declare const WORK_IMPORT_ACCEPT: string;

package/dist/internal/features/work/work-file-io.d.ts

@@ -1,6 +1,6 @@
+export { WORK_IMPORT_ACCEPT } from './work-file-contract';
 import { type WorkPresentationExportOptions } from './work-presentation-file-io';
 import { type WorkArtifact, type WorkArtifactKind } from './work-types';
-export declare const WORK_IMPORT_ACCEPT: string;
 export type WorkArtifactExportOptions = WorkPresentationExportOptions;
 export declare function importWorkFile(file: File): Promise<WorkArtifact>;
 export declare function exportWorkArtifact(artifact: WorkArtifact, options?: WorkArtifactExportOptions): Promise<void>;

package/dist/internal/features/work/work-markdown-extensions.d.ts

@@ -10,7 +10,10 @@ declare module '@tiptap/core' {
     }
 }
 export declare const WorkMarkdown: Extension<any, any>;
-export declare function createWorkMarkdownExtensions(): Extensions;
+export interface WorkMarkdownExtensionOptions {
+    collaborative?: boolean;
+}
+export declare function createWorkMarkdownExtensions(options?: WorkMarkdownExtensionOptions): Extensions;
 export declare function markdownTaskCheckboxLabel(node: {
     attrs: {
         checked?: boolean;

package/dist/internal/features/work/work-ooxml-package-preservation.d.ts

@@ -0,0 +1,12 @@
+import { type DocxSourceNumberingIdentity } from './work-docx-numbering-extension-preservation';
+export interface DocxSourcePackagePreservationOptions {
+    numberingIdentities?: readonly (DocxSourceNumberingIdentity | null)[];
+}
+/**
+ * Copies safe source-only DOCX parts into a newly generated package.
+ *
+ * Generated parts remain authoritative. Digital signatures are invalid after
+ * an edit, and macro, ActiveX, and custom-ribbon parts are intentionally not
+ * propagated into a macro-free DOCX export.
+ */
+export declare function preserveDocxSourcePackage(generatedBuffer: ArrayBuffer, sourceBuffer: ArrayBuffer, options?: DocxSourcePackagePreservationOptions): Promise<ArrayBuffer>;

package/dist/internal/features/work/work-ooxml-package-security.d.ts

@@ -0,0 +1,6 @@
+export declare function isSafeOpcPartPath(path: string): boolean;
+export declare function isExcludedDocxPart(path: string): boolean;
+export declare function isRegeneratedDocxNoteCommentPart(path: string): boolean;
+export declare function isRegeneratedDocxNoteCommentContentType(type: string | undefined): boolean;
+export declare function isExcludedRelationshipType(type: string): boolean;
+export declare function isExcludedDocxContentType(type: string | undefined): boolean;

package/dist/internal/features/work/work-ooxml-relationship-preservation.d.ts

@@ -0,0 +1,10 @@
+import type JSZip from 'jszip';
+export interface PreservedRelationshipReference {
+    id: string;
+    target: string;
+    targetMode?: string;
+    type: string;
+}
+export type PreservedRelationshipReferences = Map<string, Map<string, PreservedRelationshipReference>>;
+export declare function preserveDocxRelationships(generated: JSZip, source: JSZip, sourcePaths: readonly string[], finalPartPaths: ReadonlySet<string>, generatedPartPaths: ReadonlySet<string>, generatedByLower: Map<string, string>): Promise<PreservedRelationshipReferences>;
+export declare function isRelationshipsPart(path: string): boolean;

package/dist/internal/features/work/work-ooxml-xml.d.ts

@@ -0,0 +1,2 @@
+export declare function decodeXmlBytes(bytes: Uint8Array, label: string): string;
+export declare function serializeUtf8Xml(document: Document): string;

package/dist/internal/features/work/work-pdf-export.d.ts

@@ -1,16 +1,26 @@
 import type { WorkArtifact, WorkSpreadsheetPaperSize } from './work-types';
+import { type WorkLiveDocumentCapturePage } from './work-document-page-capture';
 type PdfPageSize = WorkSpreadsheetPaperSize;
 export interface WorkPdfExportOptions {
     pageIndexes?: number[];
 }
+export interface WorkLiveDocumentPdfPage extends WorkLiveDocumentCapturePage {
+    orientation: 'portrait' | 'landscape';
+    pageHeightPoints: number;
+    pageSize: PdfPageSize;
+    pageWidthPoints: number;
+}
 export interface WorkLiveDocumentPdfSurface {
     element: HTMLElement;
     orientation: 'portrait' | 'landscape';
     pageCount: number;
     pageGap: number;
     pageHeight: number;
+    pageHeightPoints: number;
     pageSize: PdfPageSize;
     pageWidth: number;
+    pageWidthPoints: number;
+    pages: WorkLiveDocumentPdfPage[];
 }
 export declare function exportWorkArtifactPdf(artifact: WorkArtifact, options?: WorkPdfExportOptions): Promise<void>;
 export declare function workLiveDocumentPdfSurfaceForExport(artifactId: string): WorkLiveDocumentPdfSurface | null;

package/dist/internal/features/work/work-repository.d.ts

@@ -2,3 +2,5 @@ import type { WorkArtifact } from './work-types';
 export declare function rememberWorkSourceBlob(artifactId: string, source: Blob): void;
 export declare function forgetWorkSourceBlob(artifactId: string): void;
 export declare function readWorkSourceBlob(artifact: WorkArtifact): Promise<Blob>;
+export declare function readVerifiedWorkSourceBytes(artifact: WorkArtifact): Promise<ArrayBuffer>;
+export declare function workSourceFingerprint(bytes: ArrayBuffer): Promise<string>;

package/dist/internal/features/work/work-types.d.ts

@@ -1,4 +1,7 @@
 import type { Sheet } from '@fortune-sheet/core';
+import type { WorkDocumentPageBorders } from './work-document-page-borders';
+import type { WorkDocumentPageMargins } from './work-document-page-margins';
+import type { WorkDocumentPageGeometry, WorkDocumentPaperSource } from './work-document-page-size';
 import type { WorkSpreadsheetChartLayout } from './work-spreadsheet-chart-layout';
 import type { WorkSpreadsheetChart, WorkSpreadsheetChartAxes, WorkSpreadsheetChartAxis, WorkSpreadsheetChartSeriesStyle, WorkSpreadsheetErrorBars, WorkSpreadsheetImage, WorkSpreadsheetTrendline } from './work-spreadsheet-chart-types';
 export * from './work-spreadsheet-chart-types';
@@ -41,8 +44,9 @@ export interface WorkDocumentGrid {
     type: WorkDocumentGridType;
     linePitch: number;
 }
+export type WorkDocumentPaperSize = 'a3' | 'a4' | 'a5' | 'letter' | 'legal' | 'tabloid' | 'custom';
 export interface WorkDocumentSectionLayout {
-    pageSize: 'a4' | 'letter';
+    pageSize: WorkDocumentPaperSize;
     orientation: 'portrait' | 'landscape';
     margins: WorkDocumentMargins;
     columns: WorkDocumentColumns;
@@ -53,6 +57,10 @@ export interface WorkDocumentSectionLayout {
     pageNumberStart?: number;
     pageChrome?: WorkDocumentPageChrome;
     documentGrid?: WorkDocumentGrid;
+    pageBorders?: WorkDocumentPageBorders;
+    pageMargins?: WorkDocumentPageMargins;
+    pageGeometry?: WorkDocumentPageGeometry;
+    paperSource?: WorkDocumentPaperSource;
 }
 export type WorkDocumentAttributeValue = string | number | boolean | null | WorkDocumentAttributeValue[] | {
     [key: string]: WorkDocumentAttributeValue;
@@ -79,7 +87,7 @@ export interface WorkDocumentContent {
     type: 'document';
     html: string;
     model?: WorkDocumentModel;
-    pageSize: 'a4' | 'letter';
+    pageSize: WorkDocumentPaperSize;
     pageColor?: string;
     orientation?: 'portrait' | 'landscape';
     margins?: WorkDocumentMargins;
@@ -89,6 +97,10 @@ export interface WorkDocumentContent {
     showPageNumbers?: boolean;
     pageNumberStart?: number;
     pageChrome?: WorkDocumentPageChrome;
+    pageBorders?: WorkDocumentPageBorders;
+    pageMargins?: WorkDocumentPageMargins;
+    pageGeometry?: WorkDocumentPageGeometry;
+    paperSource?: WorkDocumentPaperSource;
     trackChanges?: boolean;
     comments?: WorkDocumentComment[];
     bibliography?: WorkDocumentBibliography;
@@ -481,6 +493,7 @@ export interface WorkSourceFile {
     contentType: string;
     size: number;
     updatedAt: number;
+    fingerprint?: string;
 }
 export interface WorkFolder {
     id: string;

package/dist/internal/kernel/office-kernel-client-types.d.ts

@@ -4,6 +4,7 @@ export interface OfficeKernelLayoutInput {
     documentRevision: number;
     startPageIndex?: number;
     page: OfficeKernelLayoutRequest['page'];
+    pageStyles?: OfficeKernelLayoutRequest['pageStyles'];
     blocks: OfficeKernelLayoutRequest['blocks'];
 }
 export interface OfficeKernelPresentationGeometryInput {