@web-ppt/edit-core 0.5.0-beta.2 → 0.5.0

package/dist/opc.js

@@ -1,4 +1,4 @@
-import { d as c, p as e } from "./patch-D7lZelRa.js";
+import { d as c, p as e } from "./patch-BwhfBbYE.js";
 export {
   c as disposeOpcPackage,
   e as patchOpcPackage

package/dist/paragraph-level.d.ts

@@ -1,5 +1,5 @@
 import type { TextBody } from '@web-ppt/core';
-import type { FlatTextParagraph, ParagraphPropertyOverrides, TextOverride } from './types';
+import type { ElementImageReplacement, FlatTextParagraph, ParagraphPropertyOverrides, TextOverride } from './types';
 import type { TextRange } from './commands/types';
 /** 改级只重基未直设字段；pPr/rPr 的来源直设与用户覆盖继续压过列表样式。 */
 export declare function rebaseParagraphLevel(body: TextBody, paragraph: FlatTextParagraph, paragraphIndex: number, level: number, template: TextBody | undefined): FlatTextParagraph;
@@ -8,4 +8,4 @@ export declare function renumberParagraphs(body: TextBody, paragraphs: readonly
 /** 段落覆盖与列表重基必须一次生成，避免派生布局和稀疏覆盖出现中间态。 */
 export declare function applyParagraphPropertyOverrides(sourceBody: TextBody, override: Extract<TextOverride, {
     kind: 'flat';
-}>, range: TextRange, changes: ParagraphPropertyOverrides, levelTemplate?: TextBody): TextOverride;
+}>, range: TextRange, changes: ParagraphPropertyOverrides, levelTemplate?: TextBody, imageOverride?: ElementImageReplacement): TextOverride;

package/dist/paragraph-property-schema.d.ts

@@ -1,4 +1,7 @@
-import type { ParagraphPropertyOverrides } from './types';
+import type { ParagraphBullet, ParagraphPropertyInput, ParagraphPropertyOverrides } from './types';
+export declare const PARAGRAPH_AUTO_NUMBER_TYPES: readonly ["alphaLcParenBoth", "alphaLcParenR", "alphaLcPeriod", "alphaUcParenBoth", "alphaUcParenR", "alphaUcPeriod", "arabic1Minus", "arabic2Minus", "arabicDbPeriod", "arabicDbPlain", "arabicParenBoth", "arabicParenR", "arabicPeriod", "arabicPlain", "circleNumDbPlain", "circleNumWdBlackPlain", "circleNumWdWhitePlain", "ea1ChsPeriod", "ea1ChsPlain", "ea1ChtPeriod", "ea1ChtPlain", "ea1JpnChsDbPeriod", "ea1JpnKorPeriod", "ea1JpnKorPlain", "hebrew2Minus", "hindiAlpha1Period", "hindiAlphaPeriod", "hindiNumParenR", "hindiNumPeriod", "romanLcParenBoth", "romanLcParenR", "romanLcPeriod", "romanUcParenBoth", "romanUcParenR", "romanUcPeriod", "thaiAlphaParenBoth", "thaiAlphaParenR", "thaiAlphaPeriod", "thaiNumParenBoth", "thaiNumParenR", "thaiNumPeriod"];
 export declare const PARAGRAPH_PROPERTY_FIELDS: readonly ["align", "lineHeight", "spaceBefore", "spaceAfter", "marginLeft", "indent", "level"];
 export declare const PARAGRAPH_ALIGNMENTS: readonly ["left", "center", "right", "justify"];
 export declare function assertParagraphPropertyOverrides(value: ParagraphPropertyOverrides, label: string): void;
+export declare function assertParagraphPropertyInput(value: ParagraphPropertyInput, label: string): void;
+export declare function assertSourceParagraphBullet(value: ParagraphBullet, label: string): void;

package/dist/{patch-D7lZelRa.js → patch-BwhfBbYE.js}

@@ -41,7 +41,7 @@ function M(t) {
   for (const e of t) n = _[(n ^ e) & 255] ^ n >>> 8;
   return (n ^ 4294967295) >>> 0;
 }
-const G = 33639248, v = 101010256, Y = 67324752, tt = 101075792, et = 117853008, x = 1, nt = new TextDecoder("utf-8", { fatal: !0 }), rt = new TextEncoder(), ot = /* @__PURE__ */ new Set([
+const G = 33639248, y = 101010256, Y = 67324752, tt = 101075792, et = 117853008, x = 1, nt = new TextDecoder("utf-8", { fatal: !0 }), rt = new TextEncoder(), ot = /* @__PURE__ */ new Set([
   "7z",
   "aac",
   "avi",
@@ -81,7 +81,7 @@ function st(t) {
   if (t.length < 22) throw new Error("ZIP 缺少 EOCD");
   const n = E(t), e = Math.max(0, t.length - 22 - 65535);
   for (let r = t.length - 22; r >= e; r--) {
-    if (n.getUint32(r, !0) !== v) continue;
+    if (n.getUint32(r, !0) !== y) continue;
     const o = n.getUint16(r + 20, !0);
     if (r + 22 + o === t.length) return r;
   }
@@ -124,10 +124,10 @@ function it(t) {
   let c = h;
   for (let u = 0; u < i; u++) {
     if (O(t, c, 46, "中央目录条目"), e.getUint32(c, !0) !== G) throw new Error("ZIP 中央目录签名错误");
-    const f = e.getUint16(c + 8, !0), w = e.getUint16(c + 10, !0), P = e.getUint32(c + 20, !0), I = e.getUint32(c + 24, !0), S = e.getUint16(c + 28, !0), k = e.getUint16(c + 30, !0), X = e.getUint16(c + 32, !0), y = e.getUint16(c + 34, !0), g = e.getUint32(c + 42, !0), z = 46 + S + k + X;
-    if (O(t, c, z, "中央目录条目"), P === 4294967295 || I === 4294967295 || g === 4294967295 || y === 65535)
+    const f = e.getUint16(c + 8, !0), w = e.getUint16(c + 10, !0), P = e.getUint32(c + 20, !0), I = e.getUint32(c + 24, !0), S = e.getUint16(c + 28, !0), v = e.getUint16(c + 30, !0), X = e.getUint16(c + 32, !0), k = e.getUint16(c + 34, !0), g = e.getUint32(c + 42, !0), z = 46 + S + v + X;
+    if (O(t, c, z, "中央目录条目"), P === 4294967295 || I === 4294967295 || g === 4294967295 || k === 65535)
       throw new p("zip64", "ZIP64 条目不支持直通");
-    if (y) throw new p("multi-disk", "跨磁盘 ZIP 条目不支持直通");
+    if (k) throw new p("multi-disk", "跨磁盘 ZIP 条目不支持直通");
     if (f & 1) throw new p("encrypted-entry", "ZIP 加密条目不支持直通");
     if (f & 8)
       throw new p("data-descriptor", "ZIP 数据描述符不支持直通");
@@ -137,7 +137,7 @@ function it(t) {
     if (L(
       t,
       c + 46 + S,
-      k,
+      v,
       x,
       `中央目录 extra ${u + 1}`
     ))
@@ -203,7 +203,7 @@ function lt(t, n) {
   return s.setUint32(14, i, !0), s.setUint32(18, e.length, !0), s.setUint32(22, n.length, !0), { bytes: o, checksum: i, compressedSize: e.length, uncompressedSize: n.length };
 }
 function at(t, n, e) {
-  const r = t.centralRaw.slice(), o = E(r);
+  const r = new Uint8Array(t.centralRaw), o = E(r);
   return n && (o.setUint32(16, n.checksum, !0), o.setUint32(20, n.compressedSize, !0), o.setUint32(24, n.uncompressedSize, !0)), o.setUint32(42, e, !0), r;
 }
 function ut(t, n) {
@@ -230,7 +230,7 @@ function ut(t, n) {
   if (U > 4294967295 || l > 4294967295)
     throw new Error("保存结果需要 ZIP64 偏移，当前不支持");
   const c = new Uint8Array(22), u = E(c);
-  return u.setUint32(0, v, !0), u.setUint16(8, d, !0), u.setUint16(10, d, !0), u.setUint32(12, l, !0), u.setUint32(16, U, !0), { bytes: F([...e, ...r, c]), preservedEntries: s, rewrittenEntries: i };
+  return u.setUint32(0, y, !0), u.setUint16(8, d, !0), u.setUint16(10, d, !0), u.setUint32(12, l, !0), u.setUint32(16, U, !0), { bytes: F([...e, ...r, c]), preservedEntries: s, rewrittenEntries: i };
 }
 function V(t, n) {
   const e = Object.keys(t), r = new Set(e), o = e.filter((l) => n.get(l) !== null);
@@ -246,7 +246,7 @@ function V(t, n) {
   const h = i.reduce((l, c) => l + c.length, 0);
   if (a > 4294967295 || h > 4294967295) throw new Error("重压结果需要 ZIP64 偏移，当前不支持");
   const d = new Uint8Array(22), U = E(d);
-  return U.setUint32(0, v, !0), U.setUint16(8, o.length, !0), U.setUint16(10, o.length, !0), U.setUint32(12, h, !0), U.setUint32(16, a, !0), {
+  return U.setUint32(0, y, !0), U.setUint16(8, o.length, !0), U.setUint16(10, o.length, !0), U.setUint32(12, h, !0), U.setUint32(16, a, !0), {
     bytes: F([...s, ...i, d]),
     preservedEntries: 0,
     rewrittenEntries: o.length
@@ -268,7 +268,7 @@ function ft(t, n) {
   for (const [r, o] of Object.entries(n)) {
     q(r);
     const s = t.parts[r];
-    o === null ? s && e.set(r, null) : (!s || !N(s, o)) && e.set(r, o.slice());
+    o === null ? s && e.set(r, null) : (!s || !N(s, o)) && e.set(r, new Uint8Array(o));
   }
   return e;
 }

package/dist/patch-events.d.ts

@@ -1,12 +1,16 @@
-import type { EditorPatchEvent, EditorPatchSubscriber, EditorPatchSubscribeOptions } from './commands/types';
+import type { EditorPatchEvent, EditorPatchSubscriber, EditorPatchSubscribeOptions, Patch } from './commands/types';
+import type { EditDoc } from './types';
 export declare function reportEditorSubscriberError(error: unknown): void;
 /** recovery 前只给协同元数据观察者；普通观察者继续在视图事件后按 FIFO 收到补丁。 */
 export declare class EditorPatchJournal {
     private readonly subscribers;
     private readonly beforeRecoverySubscribers;
     private readonly pending;
+    private readonly addresses;
     private dispatching;
+    get observed(): boolean;
     subscribe(subscriber: EditorPatchSubscriber, options?: EditorPatchSubscribeOptions): () => void;
+    transport(doc: EditDoc, patches: readonly Patch[], origin: string): readonly Patch[];
     queue(event: EditorPatchEvent): void;
     flush(): void;
 }

package/dist/ppt/appearance.d.ts

@@ -0,0 +1,11 @@
+import type { Fill, Stroke } from '@web-ppt/core';
+import { type Property } from './binary';
+export declare function fillProperties(fill: Fill | null): Property[];
+export declare function strokeProperties(stroke: Stroke | null | undefined): Property[];
+/** crop 分数 → 16.16；属性顺序 Top/Bottom/Left/Right，与 MS-ODRAW / 读取侧一致。 */
+export declare function cropProperties(crop: {
+    l: number;
+    t: number;
+    r: number;
+    b: number;
+}): Property[];

package/dist/ppt/binary.d.ts

@@ -0,0 +1,20 @@
+/** [MS-PPT]/[MS-ODRAW] 记录头是共享协议，长度始终只计算记录体。 */
+export declare const view: (bytes: Uint8Array) => DataView;
+export declare function concat(parts: readonly Uint8Array[]): Uint8Array;
+export declare function u16(value: number): Uint8Array;
+export declare function u32(value: number): Uint8Array;
+export declare function utf16(text: string, terminate?: boolean): Uint8Array;
+export declare function atom(type: number, body?: Uint8Array, version?: number, instance?: number): Uint8Array;
+export declare function container(type: number, children: readonly Uint8Array[], instance?: number): Uint8Array;
+export interface Property {
+    id: number;
+    value: number | Uint8Array;
+    blip?: boolean;
+}
+export declare function properties(input: readonly Property[]): Uint8Array;
+export declare function signed(value: number, label: string): number;
+export declare function color(value: string): number;
+export declare function rgba(value: string): {
+    rgb: number;
+    alpha: number;
+};

package/dist/ppt/drawing.d.ts

@@ -0,0 +1,18 @@
+import type { Fill, SlideElement } from '@web-ppt/core';
+import { FontTable } from './text';
+import { Pictures } from './pictures';
+export declare class Drawings {
+    readonly fonts: FontTable;
+    readonly pictures: Pictures;
+    readonly clusters: {
+        id: number;
+        used: number;
+    }[];
+    private next;
+    private count;
+    constructor(fonts: FontTable, pictures: Pictures);
+    private identity;
+    private element;
+    drawing(elements: readonly SlideElement[], background: Fill | null, drawing: number, notePlaceholder?: number): Uint8Array;
+    group(): Uint8Array;
+}

package/dist/ppt/geometry.d.ts

@@ -0,0 +1,4 @@
+import type { ShapeElement } from '@web-ppt/core';
+import { type Property } from './binary';
+/** 所有预设都已有格式无关轮廓；保持贝塞尔曲线，避免把未知预设猜成矩形。 */
+export declare function geometry(shape: ShapeElement): Property[];

package/dist/ppt/index.d.ts

@@ -0,0 +1,12 @@
+import { type EditDoc } from '@web-ppt/edit-core';
+export declare const PPT_MIME = "application/vnd.ms-powerpoint";
+export interface PptSaveIssue {
+    readonly slide: number;
+    readonly message: string;
+}
+export declare class PptSaveError extends Error {
+    readonly issues: readonly PptSaveIssue[];
+    constructor(issues: readonly PptSaveIssue[]);
+}
+/** 原生 PPT 生成保存。保持当前投影可编辑，不修改源包、历史或保存点。 */
+export declare function savePpt(doc: EditDoc): Uint8Array;

package/dist/ppt/pictures.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc } from '../types';
+/** 图片保持原 PNG/JPEG 字节；不把 SVG 或 OLE 的预览冒充原生对象。 */
+export declare class Pictures {
+    private readonly doc;
+    private readonly items;
+    private readonly indexes;
+    constructor(doc: EditDoc);
+    add(url: string): number;
+    stream(): Uint8Array;
+    store(): Uint8Array;
+}

package/dist/ppt/text.d.ts

@@ -0,0 +1,9 @@
+import type { TextBody } from '@web-ppt/core';
+export declare class FontTable {
+    readonly names: string[];
+    index(name: string): number;
+    records(): Uint8Array[];
+}
+/** 字符覆盖含段落末尾的 CR；最后一段还必须覆盖隐含的终止字符。 */
+export declare function textRecords(body: TextBody, fonts: FontTable, type?: number): Uint8Array;
+export declare function defaultTextStyle(type: number): Uint8Array;