@web-ppt/edit-core 0.5.0-beta.1 → 0.5.0-beta.7

package/dist/object-source.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc, ElementId } from './types';
+import type { ChartEnv } from '@web-ppt/core';
+/** MC Choice 里的原生对象和 Fallback 可能复用 spid，必须同时匹配数据命名空间。 */
+export interface ObjectSource {
+    part: string;
+    hostPart: string;
+    xml: string;
+    context: ChartEnv;
+    references: Readonly<Record<string, string>>;
+}
+export declare function objectSource(doc: EditDoc, id: ElementId, namespace: string, attribute?: string): ObjectSource | null;

package/dist/ole/container.d.ts

@@ -0,0 +1,14 @@
+import type { XmlElement } from '@web-ppt/edit-core/xml';
+export declare const R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+export declare const attr: (node: XmlElement, key: string) => string | undefined;
+export declare const children: (node: XmlElement | undefined, name: string) => XmlElement[];
+export declare const child: (node: XmlElement | undefined, name: string) => XmlElement;
+export declare const relPart: (part: string) => string;
+export declare function resolvePart(base: string, target: string): string;
+export interface EmbeddedPackage {
+    parts: Record<string, Uint8Array>;
+    main: string;
+    kind: 'xlsx' | 'docx';
+    wrap(parts: Record<string, Uint8Array | null>): Uint8Array;
+}
+export declare function readEmbeddedPackage(source: Uint8Array): EmbeddedPackage | null;

package/dist/ole/content.d.ts

@@ -0,0 +1,94 @@
+import type { EmbeddedPackage } from './container';
+export type OleCellValue = string | number | boolean | null;
+export interface OleRunFormat {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    /** 半磅，来自 w:sz/@w:val */
+    size?: number;
+    /** 六位十六进制，来自 w:color/@w:val */
+    color?: string;
+}
+export interface OleRun {
+    index: number;
+    text: string;
+    format: OleRunFormat;
+}
+export interface OleParagraph {
+    index: number;
+    text: string;
+    editable: boolean;
+    runs: OleRun[];
+    /** 位于 w:tbl → w:tc 内时记录行列（0-based） */
+    table?: {
+        row: number;
+        col: number;
+    };
+}
+export interface OleCellStyle {
+    font?: {
+        name?: string;
+        size?: number;
+        bold?: boolean;
+        italic?: boolean;
+        color?: string;
+    };
+    fill?: {
+        color?: string;
+    };
+    border?: {
+        color?: string;
+        style?: string;
+    };
+}
+export interface OleRichRun {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    size?: number;
+    color?: string;
+}
+export interface OleCell {
+    ref: string;
+    value: OleCellValue;
+    formula?: string;
+    styleIndex?: number;
+    style?: OleCellStyle;
+    richText?: OleRichRun[];
+}
+export interface OleSheet {
+    id: string;
+    name: string;
+    cells: OleCell[];
+}
+export type OleContent = {
+    kind: 'xlsx';
+    sheets: OleSheet[];
+} | {
+    kind: 'docx';
+    paragraphs: OleParagraph[];
+};
+export interface OleEdits {
+    cells: {
+        sheet: string;
+        ref: string;
+        value?: OleCellValue;
+        /** null 表示清除样式索引 */
+        style?: OleCellStyle | null;
+        /** null 表示改回普通字符串值 */
+        richText?: OleRichRun[] | null;
+    }[];
+    paragraphs: {
+        index: number;
+        text?: string;
+        runs?: {
+            index: number;
+            text: string;
+        }[];
+    }[];
+}
+export declare function cellPosition(ref: string): [number, number];
+export declare function readOleContent(pkg: EmbeddedPackage): OleContent;
+export declare function normalizeOleEdits(value: unknown): OleEdits;
+export declare function editOleParts(pkg: EmbeddedPackage, edits: OleEdits): Record<string, Uint8Array | null>;

package/dist/ole/index.d.ts

@@ -0,0 +1,20 @@
+import type { EditDoc, Editor, ElementId } from '@web-ppt/edit-core';
+import type { OleCellStyle, OleCellValue, OleRichRun } from './content';
+export type { OleCell, OleCellValue, OleCellStyle, OleRichRun, OleRun, OleRunFormat, OleSheet, OleParagraph, OleContent, OleEdits, } from './content';
+export { cellPosition } from './content';
+export declare function queryOleContent(doc: EditDoc, id: ElementId): import("./content").OleContent;
+export declare function listEditableOle(doc: EditDoc): {
+    id: string;
+    name: string;
+    kind: "xlsx" | "docx";
+}[];
+export declare function createOleEditor(editor: Pick<Editor, 'doc' | 'exec'>): {
+    query: (id: ElementId) => import("./content").OleContent;
+    setCell(id: ElementId, sheet: string, ref: string, value: OleCellValue): void;
+    setCellStyle(id: ElementId, sheet: string, ref: string, style: OleCellStyle | null): void;
+    setCellRichText(id: ElementId, sheet: string, ref: string, richText: OleRichRun[] | null): void;
+    setParagraph(id: ElementId, index: number, text: string): void;
+    setRun(id: ElementId, paragraph: number, run: number, text: string): void;
+    exportContent(id: ElementId): Uint8Array<ArrayBufferLike>;
+    reset(id: ElementId): void;
+};

package/dist/ole/preview.d.ts

@@ -0,0 +1,3 @@
+import type { OleContent } from './content';
+/** 本地预览只展开有限窗口，完整数据仍保存在原生工作簿/文档中。 */
+export declare function olePreviewSvg(content: OleContent): string;

package/dist/ole/save.d.ts

@@ -0,0 +1,2 @@
+import type { EditDoc } from '@web-ppt/edit-core';
+export declare function saveOle(doc: EditDoc, baselines: Record<string, Uint8Array>, created: Set<string>, changes: Record<string, Uint8Array | null>, generated?: boolean): void;

package/dist/ole/state.d.ts

@@ -0,0 +1,16 @@
+import type { EditDoc } from '@web-ppt/edit-core';
+export declare const OLE = "http://schemas.openxmlformats.org/presentationml/2006/ole";
+export declare const storedOle: (doc: EditDoc, id: string) => string | undefined;
+export declare function oleSource(doc: EditDoc, id: string): {
+    source: import("../object-source").ObjectSource;
+    bytes: Uint8Array<ArrayBufferLike>;
+    pkg: import("./container").EmbeddedPackage;
+};
+export declare function oleState(doc: EditDoc, id: string): {
+    edits: import("./content").OleEdits;
+    changes: Record<string, Uint8Array<ArrayBufferLike> | null>;
+    content: import("./content").OleContent;
+    source: import("../object-source").ObjectSource;
+    bytes: Uint8Array<ArrayBufferLike>;
+    pkg: import("./container").EmbeddedPackage;
+};