superdoc 2.6.1-next.3 → 2.7.0-next.2

package/dist/document-api/src/types/sd-contract.d.ts

@@ -1,6 +1,6 @@
 import { BlockNodeAddress } from './base.js';
 import { SelectionTarget, TextAddress } from './address.js';
-import { ReceiptEffects, TextMutationRange } from './receipt.js';
+import { ReceiptEffects, ReceiptSuccess, TextMutationRange } from './receipt.js';
 export type SDErrorCode = 'INVALID_PAYLOAD' | 'INVALID_TARGET' | 'TARGET_NOT_FOUND' | 'ADDRESS_STALE' | 'PRECONDITION_FAILED' | 'REVISION_MISMATCH' | 'INVALID_CONTEXT' | 'INVALID_NESTING' | 'INVALID_PLACEMENT' | 'DUPLICATE_ID' | 'CAPABILITY_UNSUPPORTED' | 'RAW_MODE_REQUIRED' | 'PRESERVE_ONLY_VIOLATION' | 'NO_OP' | 'UNSUPPORTED_ENVIRONMENT' | 'INTERNAL_ERROR';
 export interface SDError {
     code: SDErrorCode;
@@ -24,6 +24,16 @@ export interface SDMutationReceipt {
         before: string;
         after: string;
     };
+    id?: ReceiptSuccess['id'];
+    inserted?: ReceiptSuccess['inserted'];
+    updated?: ReceiptSuccess['updated'];
+    removed?: ReceiptSuccess['removed'];
+    invalidatedRefs?: ReceiptSuccess['invalidatedRefs'];
+    remappedRefs?: ReceiptSuccess['remappedRefs'];
+    affectedStories?: ReceiptSuccess['affectedStories'];
+    textRangeShifts?: ReceiptSuccess['textRangeShifts'];
+    txId?: ReceiptSuccess['txId'];
+    warnings?: ReceiptSuccess['warnings'];
     resolution?: {
         target: MutationResolutionTarget;
         /** Engine-resolved absolute document range for the effective target. */
@@ -40,15 +50,59 @@ export interface SDMutationReceipt {
      * read it here instead. See {@link ReceiptEffects}.
      */
     effects?: ReceiptEffects;
+    conversion?: SDMutationConversionReport;
+}
+export declare const SD_CONVERSION_FORMATS: readonly ["html", "markdown"];
+export type SDConversionFormat = (typeof SD_CONVERSION_FORMATS)[number];
+export declare const SD_CONVERSION_DIAGNOSTIC_CODES: readonly ["conversion-normalized-construct", "conversion-unsupported-construct", "conversion-dropped-style", "conversion-unsafe-content", "conversion-unsafe-url", "conversion-source-limit-exceeded", "conversion-depth-limit-exceeded", "conversion-malformed-input", "conversion-empty-result"];
+export type SDConversionDiagnosticCode = (typeof SD_CONVERSION_DIAGNOSTIC_CODES)[number];
+/** Stable feature identifiers used to classify conversion diagnostics. */
+export declare const SD_CONVERSION_CONSTRUCTS: readonly ["document", "source", "text", "paragraph", "emptyParagraph", "softBreak", "lineBreak", "heading", "bold", "italic", "underline", "strike", "hyperlink", "list", "table", "tableHeader", "colSpan", "rowSpan", "horizontalRule", "inlineCode", "codeBlock", "blockquote", "taskList", "image", "footnote", "rawHtml", "unknownWrapper", "script", "style", "eventHandler"];
+export type SDConversionConstruct = (typeof SD_CONVERSION_CONSTRUCTS)[number];
+export declare const SD_CONVERSION_DISPOSITIONS: readonly ["preserved", "normalized", "downgraded", "dropped", "rejected"];
+export type SDConversionDisposition = (typeof SD_CONVERSION_DISPOSITIONS)[number];
+/** UTF-16 offsets are start-inclusive and end-exclusive. */
+export interface SDConversionSourceRange {
+    startOffset: number;
+    endOffset: number;
+    startLine?: number;
+    startColumn?: number;
+    endLine?: number;
+    endColumn?: number;
+}
+export interface SDConversionSource {
+    format: SDConversionFormat;
+    range?: SDConversionSourceRange;
 }
 export interface SDDiagnostic {
     code: string;
     severity: 'error' | 'warning' | 'info';
     message: string;
     path?: Array<string | number>;
+    construct?: SDConversionConstruct;
+    disposition?: SDConversionDisposition;
+    lossy?: boolean;
+    source?: SDConversionSource;
+}
+/** Diagnostic shape guaranteed by the canonical HTML/Markdown converters. */
+export interface SDConversionDiagnostic extends SDDiagnostic {
+    code: SDConversionDiagnosticCode;
+    construct: SDConversionConstruct;
+    disposition: SDConversionDisposition;
+    lossy: boolean;
+    source: SDConversionSource;
 }
-export interface SDMarkdownToFragmentResult {
+export interface SDMutationConversionReport {
+    format: SDConversionFormat;
+    lossy: boolean;
+    diagnostics: SDConversionDiagnostic[];
+}
+export interface SDContentToFragmentResult<TDiagnostic extends SDDiagnostic = SDDiagnostic> {
     fragment: import('./fragment.js').SDFragment;
     lossy: boolean;
-    diagnostics: SDDiagnostic[];
+    diagnostics: TDiagnostic[];
+}
+export type SDHtmlToFragmentResult = SDContentToFragmentResult<SDConversionDiagnostic>;
+/** Existing Markdown adapters may continue returning base diagnostics. */
+export interface SDMarkdownToFragmentResult extends SDContentToFragmentResult<SDDiagnostic> {
 }

package/dist/document-api/src/types/sd-nodes.d.ts

@@ -74,6 +74,8 @@ export interface SDTableCell {
     props?: SDCellProps;
     colSpan?: number;
     rowSpan?: number;
+    /** Marks a semantic table header cell. */
+    header?: boolean;
     content: SDContentNode[];
 }
 export interface SDTable extends SDNodeBase {
@@ -164,6 +166,12 @@ export interface SDBreak extends SDNodeBase {
         type: 'page' | 'column';
     };
 }
+/** A semantic horizontal rule; the destination chooses its durable representation. */
+export interface SDHorizontalRule {
+    id?: string;
+    kind: 'horizontalRule';
+    horizontalRule: Record<string, never>;
+}
 export interface SDSectionBreak extends SDNodeBase {
     kind: 'sectionBreak';
     sectionBreak: {
@@ -371,5 +379,5 @@ export interface SDExtInlineNode extends SDNodeBase {
     kind: `ext.${string}`;
     [key: string]: unknown;
 }
-export type SDContentNode = SDParagraph | SDHeading | SDList | SDTable | SDToc | SDDocumentIndex | SDBibliography | SDTableOfAuthorities | SDBreak | SDSectionBreak | SDSectPr | SDImage | SDDrawing | SDSdt | SDCustomXml | SDAltChunk | SDMath | SDField | SDExtContentNode;
+export type SDContentNode = SDParagraph | SDHeading | SDList | SDTable | SDToc | SDDocumentIndex | SDBibliography | SDTableOfAuthorities | SDBreak | SDHorizontalRule | SDSectionBreak | SDSectPr | SDImage | SDDrawing | SDSdt | SDCustomXml | SDAltChunk | SDMath | SDField | SDExtContentNode;
 export type SDInlineNode = SDRun | SDHyperlink | SDCrossRef | SDIndexEntry | SDSequenceField | SDCitation | SDAuthorityEntry | SDTocEntry | SDImage | SDDrawing | SDSdt | SDCustomXml | SDMath | SDField | SDTab | SDLineBreak | SDFootnoteRef | SDEndnoteRef | SDExtInlineNode;

package/dist/document-api/src/write/write.d.ts

@@ -66,7 +66,7 @@ export interface WriteAdapter {
     write(request: InsertWriteRequest, options?: MutationOptions): TextMutationReceipt;
     /** Structured insert for SDFragment or markdown/html content. Returns SDMutationReceipt. */
     insertStructured(input: InsertInput, options?: MutationOptions): SDMutationReceipt;
-    /** Structured replace for SDFragment content. Returns SDMutationReceipt. */
+    /** Structured replace for SDFragment or markdown/html content. Returns SDMutationReceipt. */
     replaceStructured(input: ReplaceInput, options?: MutationOptions): SDMutationReceipt;
 }
 export declare function normalizeMutationOptions(options?: MutationOptions): MutationOptions;

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CwCvqMOa.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C44xPZxz.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCjm-_Xo.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BTNVc3UD.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CwCvqMOa.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C44xPZxz.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCjm-_Xo.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BTNVc3UD.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/helpers/v2-review-mutation-impact.d.ts

@@ -2,9 +2,8 @@
  * Classify the tracked-change identities carried by a v2 mutation event.
  *
  * Receipt entities are the durable invalidation contract between the document
- * kernel and derived review UI. Consumers apply removals/remaps locally; the
- * next committed window supplies surviving or restored rows. History follows
- * the same bounded path and never enumerates invisible review identities.
+ * kernel and derived review UI. Direct receipts carry entity refs; mutation
+ * plans carry the same identities through `trackedChanges` and per-step ids.
  */
 export function getV2TrackedChangeMutationImpact(event: any): {
     allResolved?: any;

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-D38u8ta_.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-RC64TPzL.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-CwCvqMOa.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-C44xPZxz.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-SDR04tiH.cjs");
 const require_constants = require("./chunks/constants-DpXuDx_g.cjs");
 let vue = require("vue");
@@ -43606,7 +43606,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.6.1-next.3";
+		this.version = "2.7.0-next.2";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -3,7 +3,7 @@ import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-CMOjDs74.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-VxCFV9YS.es.js";
-import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-DCjm-_Xo.es.js";
+import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-BTNVc3UD.es.js";
 import { t as _plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-BOaGB7Aw.es.js";
 import { t as PDF_TO_CSS_UNITS } from "./chunks/constants-B6VBlmKp.es.js";
 import * as Vue from "vue";
@@ -43539,7 +43539,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.6.1-next.3";
+		this.version = "2.7.0-next.2";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];