oasis-editor 0.0.142 → 0.0.144

package/dist/core/model/index.d.ts

@@ -15,6 +15,7 @@ export type { EditorFootnote } from './types/documentFootnotes.js';
 export type { EditorEndnote } from './types/documentEndnotes.js';
 export type { EditorBookmark, EditorBookmarkAnchor, EditorBookmarks, } from './types/documentBookmarks.js';
 export type { EditorComment, EditorCommentAnchor, EditorComments, } from './types/documentComments.js';
+export type { EditorOpcPartKind, EditorOpcPartEncoding, EditorOpcRelationship, EditorOpcContentTypes, EditorOpcPart, EditorDocxDiagnostic, EditorDocxSourcePackage, } from './types/docxSourcePackage.js';
 export type { EditorPageMargins, EditorPageSettings, EditorColumnsSettings, EditorSection, EditorPageNumbering, EditorSectionVerticalAlign, EditorFontInfo, EditorFootnoteSettings, EditorFootnotes, EditorEndnoteSettings, EditorEndnotes, EditorDocument, } from './types/document.js';
 export type { EditorPosition, EditorSelection, EditorEditingZone, } from './types/selection.js';
 export type { EditorCaretSlot, EditorLayoutFragmentChar, EditorLayoutFragment, EditorLayoutLine, EditorLayoutParagraph, EditorLayoutBlock, TableCellBlockPosition, EditorLayoutPage, EditorLayoutDocument, } from './types/layout.js';

package/dist/core/model/types/document.d.ts

@@ -5,6 +5,7 @@ import { EditorEndnote } from './documentEndnotes.js';
 import { EditorBookmarks } from './documentBookmarks.js';
 import { EditorComments } from './documentComments.js';
 import { EditorNamedStyle } from './styles.js';
+import { EditorDocxSourcePackage } from './docxSourcePackage.js';
 
 export interface EditorPageMargins {
     top: number;
@@ -157,6 +158,12 @@ export interface EditorDocument {
         /** `w:doNotHyphenateCaps`: do not hyphenate all-caps words. */
         doNotHyphenateCaps?: boolean;
     };
+    /**
+     * Original OPC package snapshot for an imported DOCX. The object is shared
+     * across editor-state clones and is not traversed by layout or hot mutation
+     * paths. It is the preservation source for unsupported package parts.
+     */
+    sourcePackage?: EditorDocxSourcePackage;
     /**
      * Out-of-band asset registry. Image runs reference entries here using
      * `src = "asset:<id>"`. The map itself is treated as append-only and is

package/dist/core/model/types/docxSourcePackage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Serializable snapshot of the OPC package that backed an imported DOCX.
+ *
+ * The editor model is the typed, editable projection. This package snapshot is
+ * the preservation layer for parts and relationships that Oasis does not yet
+ * understand semantically. It deliberately contains only structured-clone-safe
+ * data so imports can continue to run inside a Web Worker.
+ */
+export type EditorOpcPartKind = "xml" | "binary";
+export type EditorOpcPartEncoding = "utf8" | "base64";
+export interface EditorOpcRelationship {
+    id: string;
+    type: string;
+    target: string;
+    targetMode?: "Internal" | "External";
+    /** Normalized package path for an internal target. */
+    resolvedTarget?: string;
+}
+export interface EditorOpcContentTypes {
+    defaults: Record<string, string>;
+    overrides: Record<string, string>;
+}
+export interface EditorOpcPart {
+    path: string;
+    contentType?: string;
+    kind: EditorOpcPartKind;
+    data: string;
+    encoding: EditorOpcPartEncoding;
+    originalHash: string;
+    relationships?: EditorOpcRelationship[];
+}
+export interface EditorDocxDiagnostic {
+    level: "warning" | "error";
+    code: string;
+    message: string;
+    partPath?: string;
+    relationshipId?: string;
+}
+export interface EditorDocxSourcePackage {
+    format: "docx";
+    mainDocumentPart: string;
+    contentTypes: EditorOpcContentTypes;
+    rootRelationships: EditorOpcRelationship[];
+    parts: Record<string, EditorOpcPart>;
+    diagnostics?: EditorDocxDiagnostic[];
+}

package/dist/export/docx/docxTypes.d.ts

@@ -1,4 +1,5 @@
 import { EditorBlockNode, EditorImageBorder, EditorImageCrop, EditorImageFillMode, EditorImageFloatingLayout, EditorParagraphListStyle, EditorWrapPolygonPoint } from '../../core/model.js';
+import { EditorListOoxmlNumberingMetadata } from '../../ooxml/word/numberingMetadata.js';
 import { BookmarkEventsByParagraph } from './bookmarksXml.js';
 import { CommentEventsByParagraph } from './commentsXml.js';
 
@@ -13,6 +14,7 @@ export interface NumberingLevelDefinition {
     legal?: boolean;
     bulletGlyph?: string;
     bulletFont?: string;
+    ooxml?: EditorListOoxmlNumberingMetadata;
 }
 export interface NumberingDefinition {
     abstractNumId: number;

package/dist/export/docx/exportEditorDocumentToDocxPreservingSource.d.ts

@@ -0,0 +1,4 @@
+import { EditorDocument } from '../../core/model.js';
+
+export declare function exportEditorDocumentToDocxPreservingSource(document: EditorDocument): Promise<ArrayBuffer>;
+export declare function exportEditorDocumentToDocxBlobPreservingSource(document: EditorDocument): Promise<Blob>;

package/dist/export/docx/opc/sourcePackagePatcher.d.ts

@@ -0,0 +1,8 @@
+import { EditorDocument } from '../../../core/model.js';
+
+/**
+ * Clones the imported package and overlays the freshly rebuilt Oasis parts.
+ * Unknown source parts remain untouched. Content types and relationship parts
+ * are merged instead of blindly replaced so unrelated package features survive.
+ */
+export declare function patchRebuiltDocxWithSourcePackage(document: EditorDocument, rebuiltBuffer: ArrayBuffer): Promise<ArrayBuffer>;

package/dist/export/docx/text/sourceParagraphPropertiesXml.d.ts

@@ -0,0 +1,8 @@
+import { EditorParagraphNode } from '../../../core/model.js';
+
+/**
+ * Preserves source-only `w:pPr` children while keeping the freshly generated
+ * paragraph properties authoritative. Unknown children are inserted before the
+ * next generated source sibling when possible, preserving source order.
+ */
+export declare function mergeParagraphPropertiesOoxmlSource(paragraph: EditorParagraphNode, generatedXml: string, hasOverrides: boolean): string;

package/dist/export/docx/text/sourceParagraphXml.d.ts

@@ -0,0 +1,12 @@
+import { EditorParagraphNode } from '../../../core/model.js';
+
+/**
+ * Overlays edited paragraph properties and one-to-one generated runs onto the
+ * original source paragraph only when the paragraph envelope contains source-
+ * only attributes, children or wrappers. Ordinary paragraphs use the canonical
+ * serializer directly, avoiding unnecessary DOM normalization.
+ */
+export declare function overlayEditorParagraphOnOoxmlSource(paragraph: EditorParagraphNode, generatedParagraphPropertiesXml: string, generatedRunXml: string[], options: {
+    hasOverrides: boolean;
+    hasBoundaryTokens: boolean;
+}): string | undefined;

package/dist/export/docx/text/sourceRunXml.d.ts

@@ -0,0 +1,14 @@
+import { EditorTextRun } from '../../../core/model.js';
+
+/**
+ * Returns the original run subtree when its editor semantics are unchanged.
+ * For a text-only edit with otherwise identical structure, patches the original
+ * subtree's text nodes so unknown attributes/properties/children remain ordered.
+ */
+export declare function serializeRunFromOoxmlSource(run: EditorTextRun): string | undefined;
+/**
+ * Merges source-only run attributes, run properties and direct extension
+ * children into a freshly generated single `w:r`. Generated/modelled content is
+ * authoritative; unknown source content remains anchored by source order.
+ */
+export declare function mergeRunOoxmlSourceIntoGeneratedXml(run: EditorTextRun, generatedXml: string): string;

package/dist/import/docx/markupCompatibility.d.ts

@@ -0,0 +1,20 @@
+import { Element as XmlElement } from '@xmldom/xmldom';
+
+export declare const MARKUP_COMPATIBILITY_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+export interface MarkupCompatibilityCapabilities {
+    supportedNamespaces: ReadonlySet<string>;
+}
+export declare const DEFAULT_MARKUP_COMPATIBILITY_CAPABILITIES: MarkupCompatibilityCapabilities;
+export declare function extendMarkupCompatibilityCapabilities(base: MarkupCompatibilityCapabilities, ...namespaces: string[]): MarkupCompatibilityCapabilities;
+/**
+ * Returns the effective direct children after applying the parts of ECMA-376
+ * Markup Compatibility needed by semantic import:
+ *
+ * - first satisfiable mc:Choice, otherwise mc:Fallback;
+ * - mc:Ignorable filtering for unsupported extension namespaces;
+ * - mc:ProcessContent unwrapping for ignorable wrapper elements.
+ *
+ * PreserveElements/PreserveAttributes remain the responsibility of the source
+ * fragment layer, which retains the original XML for round-trip export.
+ */
+export declare function getMarkupCompatibleChildren(element: XmlElement, capabilities?: MarkupCompatibilityCapabilities): XmlElement[];

package/dist/import/docx/numbering.d.ts

@@ -5,6 +5,7 @@ type ListFormat = NonNullable<EditorParagraphListStyle["format"]>;
 interface NumberingLevel {
     kind?: EditorParagraphListStyle["kind"];
     format?: ListFormat;
+    rawFormat?: string;
     suffix?: EditorParagraphListStyle["suffix"];
     startAt?: number;
     levelText?: string;
@@ -12,6 +13,8 @@ interface NumberingLevel {
     legal?: boolean;
     bulletGlyph?: string;
     bulletFont?: string;
+    restartAfterLevel?: number;
+    paragraphStyleId?: string;
     indent?: {
         left?: number;
         hanging?: number;

package/dist/import/docx/opc/legacyCompatibilityPackage.d.ts

@@ -0,0 +1,10 @@
+import { EditorDocxSourcePackage } from '../../../core/model.js';
+
+export declare function requiresDocxImporterCompatibilityPackage(sourcePackage: EditorDocxSourcePackage): boolean;
+/**
+ * Builds a temporary compatibility package for the current semantic importer.
+ * The original source snapshot remains authoritative and is attached to the
+ * resulting editor document; these aliases exist only so legacy path-based
+ * parsers can consume relationship-discovered packages.
+ */
+export declare function prepareDocxForCurrentImporter(originalBuffer: ArrayBuffer, sourcePackage: EditorDocxSourcePackage): Promise<ArrayBuffer>;

package/dist/import/docx/opc/sourcePackage.d.ts

@@ -0,0 +1,4 @@
+import { EditorDocument, EditorDocxSourcePackage } from '../../../core/model.js';
+
+export declare function captureDocxSourcePackage(buffer: ArrayBuffer): Promise<EditorDocxSourcePackage>;
+export declare function attachDocxSourcePackage(document: EditorDocument, buffer: ArrayBuffer): Promise<EditorDocument>;

package/dist/import/docx/xmlHelpers.d.ts

@@ -10,11 +10,9 @@ export type DocxTextDirection = "lrTb" | "tbRl" | "btLr" | "lrTbV" | "tbRlV";
 export declare function parseTextDirection(value: string | null | undefined): DocxTextDirection | undefined;
 export declare function getFirstChildByTagNameNS(element: XmlElement | null | undefined, namespace: string, localName: string): XmlElement | null;
 /**
- * Finds a direct `w14:localName` child of `element`, also searching inside
- * `mc:AlternateContent/mc:Choice` branches (which carry w14 markup in files
- * produced by modern Word). The `mc:Fallback` branch used by
- * `getChildrenByTagNameNS` would not contain w14 elements, so a separate
- * helper is needed for these extension elements.
+ * Finds a direct `w14:localName` child using a Markup Compatibility capability
+ * profile that explicitly understands the w14 namespace. The generic child
+ * helpers remain conservative and continue to consume mc:Fallback instead.
  */
 export declare function getFirstW14Child(element: XmlElement | null | undefined, localName: string): XmlElement | null;
 export declare function getAttributeValue(element: XmlElement | null, localName: string): string | null;