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

package/dist/table-style.d.ts

@@ -0,0 +1,20 @@
+import type { TableElement, TableStyleDefinition, TableStyleSettings } from '@web-ppt/core';
+import type { EditDoc, ElementId, SlideId } from './types';
+export interface TableStyleCatalogItem {
+    readonly styleId: string;
+    readonly name: string;
+    readonly source: 'document' | 'builtin';
+    readonly preview: TableElement;
+}
+export interface TableStyleState {
+    readonly value: TableStyleSettings | null;
+    readonly source: TableStyleSettings | null;
+    readonly direct: boolean;
+}
+export declare function tableStyleDefinitionForElement(doc: EditDoc, id: ElementId, styleId: string): TableStyleDefinition | undefined;
+/** 目录以页面主题为上下文；返回值不泄露 OOXML，也不要求 UI 复刻样式优先级。 */
+export declare function listTableStyles(doc: EditDoc, slideId: SlideId): readonly TableStyleCatalogItem[];
+export declare function assertTableStyleSettings(doc: EditDoc, id: ElementId, input: unknown, label: string): TableStyleSettings;
+export declare function queryTableStyle(doc: EditDoc, id: ElementId): TableStyleState;
+/** 来源直设基线最后叠加，因此样式切换不会清洗单元格直接格式。 */
+export declare function projectTableStyle(doc: EditDoc, slideId: SlideId, table: TableElement, settings: TableStyleSettings): TableElement;

package/dist/text-model.d.ts

@@ -15,7 +15,7 @@ export declare function applyRunProps(body: TextBody, range: TextRange, props: R
 }>): TextOverride;
 export declare function applyParagraphProps(body: TextBody, range: TextRange, props: ParagraphPropertyOverrides, initial?: Extract<TextOverride, {
     kind: 'flat';
-}>): TextOverride;
+}>, levelTemplate?: TextBody, sourceBody?: TextBody): TextOverride;
 export declare function queryTextParagraphProps(body: TextBody, range: TextRange, initial?: Extract<TextOverride, {
     kind: 'flat';
 }>): ParagraphPropertiesState;

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { Effects, ElementBase, Fill, GeomSpec, ImageElement, OpcPackage, Paragraph, PlaceholderDirectFlags, Presentation, ShapeCreationDefaults, ShapeElement, Slide, Stroke, Transition, TableCreationDefaults, SlideElement, SlideLayoutTemplate, TextBody, TextRun } from '@web-ppt/core';
+import type { CustomGeometry, Effects, ElementBase, Fill, GeomSpec, ImageElement, OpcPackage, Paragraph, PlaceholderDirectFlags, Presentation, ShapeCreationDefaults, ShapeElement, Slide, Stroke, Transition, TableCreationDefaults, SlideElement, SlideLayoutTemplate, TableStyleDefinition, TableStyleSettings, TextBody, TextRun } from '@web-ppt/core';
 import type { EmphasisAnimationEffect, EntranceExitAnimationEffect } from './animation-catalog';
 export type ElementId = string;
 export type SlideId = string;
@@ -18,6 +18,8 @@ export interface ElementInsertionSource {
     readonly spids: Readonly<Record<string, number>>;
     readonly relationships?: readonly ElementInsertionRelationship[];
     readonly resources?: readonly ElementInsertionResource[];
+    /** false 表示宿主只是空容器，后代要按当前模型层级分别插入或从来源树移动。 */
+    readonly containsDescendants?: false;
 }
 export interface ElementInsertionRelationship {
     readonly sourceId: string;
@@ -91,6 +93,8 @@ export interface ElementLinkState {
  * `id` / `editInfo` 则属于源文件身份，二者都不能进入覆盖层。
  */
 export type ElementOverrides = Partial<Pick<ElementBase, BaseOverrideKey>> & {
+    /** 自定义几何是 path 的语义来源；path 本身仍保持派生字段，不能写入覆盖层。 */
+    geometry?: CustomGeometry;
     /** 缺少字段表示来源；none 表示明确移除，不能用 undefined 混淆二者。 */
     link?: LinkOverride;
     /** 显式无填充用 Fill.none；缺少该字段才表示恢复来源/主题。 */
@@ -108,6 +112,8 @@ export type ElementOverrides = Partial<Pick<ElementBase, BaseOverrideKey>> & {
     tableCells?: Record<TableCellKey, TableCellOverrides>;
     /** 表格行使用稳定身份稀疏追加；不复制整张 rows，未来可沿同一身份扩展中间插入。 */
     tableRows?: Record<TableRowId, TableRowInsertion>;
+    /** 缺少字段表示来源；SetTableStyle(null) 删除整份覆盖。 */
+    tableStyle?: TableStyleSettings;
 };
 export interface ElementFillState {
     readonly value: Fill | null;
@@ -234,14 +240,19 @@ export interface TextMark {
     readonly runOverrides?: RunPropertyOverrides;
     /** 删除直接格式后用于恢复继承所得的有效值；只含字符格式 P0 字段。 */
     readonly inheritedProps?: RunProperties;
+    /** 完整继承字符元数据；改级后不能继续沿用旧层级的非面板字段。 */
+    readonly inheritedRunProps?: import('@web-ppt/core').TextRunEditInfo['inheritedRunProps'];
     /** 继承字体可能分别含 latin/ea/cs，不能为面板的单字体值而丢掉回退栈。 */
     readonly inheritedFonts?: readonly string[];
+    /** 去重字体栈不足以还原脚本槽；清除 font 直设与换级重基必须保留槽位身份。 */
+    readonly inheritedFontSlots?: import('@web-ppt/core').TextFontSlots;
     /** 只说明来源链接不可安全编辑，不携带原始 action 或危险 URL。 */
     readonly sourceLinkReadonly?: true;
 }
 export interface RunProperties {
     readonly font: string | null;
     readonly size: number;
+    readonly color: string;
     readonly b: boolean;
     readonly i: boolean;
     readonly u: boolean;
@@ -250,6 +261,7 @@ export interface RunProperties {
 export interface RunPropertyOverrides {
     readonly font?: string | null;
     readonly size?: number | null;
+    readonly color?: string | null;
     readonly b?: boolean | null;
     readonly i?: boolean | null;
     readonly u?: boolean | null;
@@ -277,6 +289,7 @@ export interface RunPropertyState<T> {
 export interface RunPropertiesState {
     readonly font: RunPropertyState<string>;
     readonly size: RunPropertyState<number>;
+    readonly color: RunPropertyState<string>;
     readonly b: RunPropertyState<boolean>;
     readonly i: RunPropertyState<boolean>;
     readonly u: RunPropertyState<boolean>;
@@ -284,6 +297,7 @@ export interface RunPropertiesState {
 }
 export type RunLinkState = ElementLinkState;
 export interface ParagraphPropertyOverrides {
+    readonly level?: number | null;
     readonly align?: Paragraph['align'] | null;
     readonly lineHeight?: number | null;
     readonly spaceBefore?: number | null;
@@ -292,6 +306,7 @@ export interface ParagraphPropertyOverrides {
     readonly indent?: number | null;
 }
 export interface ParagraphProperties {
+    readonly level: number;
     readonly align: Paragraph['align'];
     readonly lineHeight: number | null;
     readonly spaceBefore: number;
@@ -300,6 +315,7 @@ export interface ParagraphProperties {
     readonly indent: number;
 }
 export interface ParagraphPropertiesState {
+    readonly level: RunPropertyState<number>;
     readonly align: RunPropertyState<Paragraph['align']>;
     readonly lineHeight: RunPropertyState<number>;
     readonly spaceBefore: RunPropertyState<number>;
@@ -355,6 +371,7 @@ export type TextOverride = {
 };
 export interface ElementMeta {
     geom?: GeomSpec;
+    customGeometry?: CustomGeometry;
     ph?: {
         type: string;
         idx?: string;
@@ -387,6 +404,8 @@ export interface ElementMeta {
     inherited?: true;
     /** 来源存在无法安全映射的链接；覆盖层缺失时查询为只读来源。 */
     sourceLinkReadonly?: true;
+    /** 来源 XML 中的直属父级；结构编辑后保存层据此移动原宿主而不是克隆内容。 */
+    sourceParent?: SlideId | ElementId;
 }
 export interface ElementRecord {
     id: ElementId;
@@ -444,6 +463,8 @@ export interface SlideRecord {
     defaultShape?: ShapeCreationDefaults;
     /** 解析期已在当前页主题/默认表样式上求值，新增表格无需理解 OOXML 样式层。 */
     defaultTable?: TableCreationDefaults;
+    /** 当前页主题求值后的公开表样式目录。 */
+    tableStyles?: TableStyleDefinition[];
 }
 export interface SlideNotesBinding {
     readonly sourcePart?: string;
@@ -473,6 +494,27 @@ export interface EditDocMeta {
     source: Presentation['source'];
     /** true 表示缺少可靠写回上下文，只能安全查看 */
     readonly: boolean;
+    /** 来源演示文稿的表样式 part；省略表示保存时按需创建标准 part。 */
+    tableStylesPart?: string;
+}
+export interface EditIdentityRange {
+    /** 划分区间前的全局首值；恢复时据此重算当前 slot 的精确边界。 */
+    base: number;
+    maximum: number;
+    next: number;
+    end: number;
+    step: number;
+}
+/** 协同分配状态随恢复日志持久化；ranges 是各类 OOXML 数值身份的互斥游标。 */
+export interface EditIdentityAllocation {
+    replicaId: string;
+    prefix: string;
+    slot: number;
+    count: number;
+    /** 与补丁事务一起进入恢复帧，进程重开后不能复用旧消息序号或 Lamport 时间。 */
+    clock: number;
+    sequence: number;
+    ranges: Record<string, EditIdentityRange>;
 }
 /** 会话内身份分配状态必须随文档持久化，否则恢复后会复用旧 id。 */
 export interface EditIdentity {
@@ -486,6 +528,7 @@ export interface EditIdentity {
     nextNotesPart?: number;
     nextPresentationSlideId?: number;
     nextPresentationRelationship?: number;
+    allocation?: EditIdentityAllocation;
 }
 /** 只保存首次触碰的 XML part；必须随文档 structuredClone 才能在 Worker 中正确撤销后保存。 */
 export interface EditSaveState {

package/dist/xml.js

@@ -1,4 +1,4 @@
-import { w as s, c as l, g as a, f as m, d as t, h as i, u as X, k as d, p as n, r as h, b as C, e as f, y as o, s as b, a as c, x as u } from "./index-D4ZTaYOa.js";
+import { w as s, c as l, g as a, f as m, d as t, h as i, u as X, k as d, p as n, r as h, b as C, e as f, y as o, a as b, s as c, x as u } from "./index-D2JizcOQ.js";
 export {
   s as OOXML_CHILD_ORDER,
   l as createXmlElement,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web-ppt/edit-core",
-  "version": "0.5.0-beta.1",
+  "version": "0.5.0-beta.2",
   "description": "Headless, framework-agnostic editing document model and render projection for Web-PPT.",
   "keywords": [
     "pptx",
@@ -42,6 +42,10 @@
       "types": "./dist/save/index.d.ts",
       "import": "./dist/save.js"
     },
+    "./generate": {
+      "types": "./dist/generate/index.d.ts",
+      "import": "./dist/generate.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -56,7 +60,7 @@
     "prepack": "node ../../tooling/sync-package-docs.mjs"
   },
   "peerDependencies": {
-    "@web-ppt/core": "^0.5.0-beta.1"
+    "@web-ppt/core": "^0.5.0-beta.2"
   },
   "dependencies": {
     "fflate": "^0.8.2"