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

package/dist/space.d.ts

@@ -1,3 +1,4 @@
+import type { SlideElement } from '@web-ppt/core';
 import type { EditDoc, ElementId } from './types';
 export interface SpacePoint {
     x: number;
@@ -33,12 +34,48 @@ export declare function inverseTransformSpaceVector(matrix: AffineMatrix, vector
 /** 反射会让父空间里的正角方向与幻灯片空间相反；旋转连续性必须沿同一手性展开。 */
 export declare function spaceOrientationParity(matrix: AffineMatrix): 1 | -1;
 export declare function invertSpaceMatrix(matrix: AffineMatrix): AffineMatrix;
+/** 模型局部坐标（0..w, 0..h）→ 幻灯片：渲染外框再乘上各轴组缩放，保持刚体。 */
 export declare function elementFrameToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
 /** 元素内容坐标还要经过自身翻转；frame 几何本身不含这一步。 */
 export declare function elementContentToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
+/**
+ * 模型父空间（父组子坐标）→ 幻灯片。子元素中心按直接父组渲染后的缩放映射，
+ * 所以平移类命令在这里换算的位移与画面一致；外框尺寸与旋转改用编辑父空间计算。
+ */
 export declare function elementParentToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
 /** 组的子坐标系包含自身 frame、翻转及 chOff/chExt 缩放，不能等同于组所在父坐标系。 */
 export declare function elementChildrenToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
+/** 元素在其父容器渲染坐标中的投影：组内子元素已折算组缩放。 */
+export declare function renderedElement(doc: EditDoc, id: ElementId): SlideElement;
+/** 渲染外框到幻灯片坐标：沿祖先组只叠加外框平移、旋转与翻转，缩放已进入外框尺寸。 */
+export declare function renderedFrameToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
+export declare function renderedContentToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
+/**
+ * 父组子坐标 → 父组渲染坐标；顶层元素的两套坐标相同。
+ * 平移预览在模型父空间求得，挂到组内 DOM 前用它换算位移。
+ */
+export declare function elementParentToRenderedParentMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
+/**
+ * 编辑外框：元素在父组渲染坐标里的刚体外框。缩放与旋转手势在这里计算，
+ * 提交前经 editFrameToModelFrame 写回模型，画面与提交结果因此一致。
+ */
+export interface ElementEditFrame extends ElementFrameTransform {
+    flipH: boolean;
+    flipV: boolean;
+}
+export declare function elementEditFrame(doc: EditDoc, id: ElementId): ElementEditFrame;
+/** 父组渲染坐标（编辑父空间）→ 幻灯片。 */
+export declare function elementEditParentToSlideMatrix(doc: EditDoc, id: ElementId): AffineMatrix;
+export declare function slideToElementEditParentPoint(doc: EditDoc, id: ElementId, point: SpacePoint): SpacePoint;
+/**
+ * 编辑外框 → 模型外框（父组子坐标）。旋转只改角度，宽高按目标角度所在象限承接的组缩放除回去：
+ * 跨过 45° 等边界时画面尺寸保持不变，由模型宽高吸收轴向互换。
+ */
+export declare function editFrameToModelFrame(doc: EditDoc, id: ElementId, frame: ElementFrameTransform): ElementFrameTransform;
+/** 组合子元素的编辑父空间 → 幻灯片；粘贴进组合时用它把幻灯片外框换算成刚体的组内外框。 */
+export declare function groupEditChildrenToSlideMatrix(doc: EditDoc, groupId: ElementId): AffineMatrix;
+/** 组合内的编辑外框 → 该组合子坐标里的模型外框。 */
+export declare function groupEditFrameToModelFrame(doc: EditDoc, groupId: ElementId, frame: ElementFrameTransform): ElementFrameTransform;
 export declare function elementFrameToSlidePoint(doc: EditDoc, id: ElementId, point: SpacePoint): SpacePoint;
 export declare function slideToElementFramePoint(doc: EditDoc, id: ElementId, point: SpacePoint): SpacePoint;
 export declare function elementParentToSlidePoint(doc: EditDoc, id: ElementId, point: SpacePoint): SpacePoint;

package/dist/table-cell.d.ts

@@ -1,10 +1,16 @@
-import type { ElementRecord, TableCellAddress, TableCellKey, TableCellRowRef, TableRowId } from './types';
+import type { ElementRecord, TableCellAddress, TableCellColumnRef, TableCellKey, TableCellRef, TableCellRowRef, TableRowId } from './types';
 export declare function tableCellKey(cell: TableCellAddress): TableCellKey;
 export declare function parseTableCellKey(value: string): TableCellAddress | null;
 export declare function tableCellKeyBelongsToRow(key: string, rowId: TableRowId): boolean;
 export declare function tableCellRowRef(record: ElementRecord, cell: TableCellAddress): TableCellRowRef | null;
+export declare function tableCellColumnRef(record: ElementRecord, cell: TableCellAddress): TableCellColumnRef | null;
 export declare function tableCellAddressFromRowRef(record: ElementRecord, row: unknown, column: unknown): TableCellAddress | null;
+export declare function tableCellAddressFromRefs(record: ElementRecord, row: unknown, column: unknown): TableCellAddress | null;
+export declare function tableCellAddressFromStableRef(record: ElementRecord, cell: TableCellRef): TableCellAddress | null;
 export declare function tableCellOverrideKeyFromRowRef(row: TableCellRowRef, column: number): TableCellKey;
+export declare function tableCellOverrideKeyFromRefs(row: TableCellRowRef, column: TableCellColumnRef): TableCellKey;
 export declare function tableCellOverrideKey(record: ElementRecord, cell: TableCellAddress): TableCellKey;
 export declare function tableCellKeyResolver(record: ElementRecord): (key: string) => TableCellAddress | null;
+/** 协同冲突判断必须能解析已被 tombstone 隐藏的格，但不能让普通编辑重新寻址它。 */
+export declare function tableCellStableRefFromKey(record: ElementRecord, key: string): TableCellRef | null;
 export declare function assertTableCellAddress(value: unknown, label: string): asserts value is TableCellAddress;

package/dist/table-grid-projection.d.ts

@@ -0,0 +1,6 @@
+import type { TableElement } from '@web-ppt/core';
+import type { ElementRecord } from './types';
+export declare function hasTableStructureOverrides(record: ElementRecord): boolean;
+export declare function hasComplexTableStructureOverrides(record: ElementRecord): boolean;
+/** 稀疏结构覆盖在这里一次性收敛为 core 的矩形二维 Schema。 */
+export declare function projectTableStructure(record: ElementRecord, base: TableElement): TableElement;

package/dist/table-grid.d.ts

@@ -0,0 +1,45 @@
+import type { TableRow } from '@web-ppt/core';
+import type { EditDoc, ElementId, ElementRecord, TableCellColumnRef, TableCellRowRef, TableColumnId, TableCellRef, TableColumnInsertion, TableMergeRegion, TableRowId, TableRowInsertion } from './types';
+export interface TableGridRow {
+    readonly id: TableRowId;
+    readonly source: number | null;
+    readonly height: number;
+}
+export interface TableGridColumn {
+    readonly id: string;
+    readonly source: number | null;
+    readonly width: number;
+}
+export interface TableGridState {
+    readonly rows: readonly TableGridRow[];
+    readonly columns: readonly TableGridColumn[];
+    readonly merges: readonly TableMergeRegion[];
+}
+export interface TableGridIdentities {
+    readonly rows: readonly TableRowId[];
+    readonly columns: readonly TableColumnId[];
+}
+export interface OrderedTableColumn extends TableColumnInsertion {
+    readonly id: TableColumnId;
+    readonly columnRef: TableCellColumnRef;
+    readonly source: number | null;
+}
+export interface OrderedTableRow extends TableRowInsertion {
+    readonly id: TableRowId;
+    readonly rowRef: TableCellRowRef;
+    readonly source: number | null;
+}
+export declare function sourceTableRowId(index: number): TableRowId;
+export declare function sourceTableColumnId(index: number): string;
+export declare function isReservedTableRowId(id: string): boolean;
+export declare function isReservedTableColumnId(id: string): boolean;
+export declare function tableGridIdentities(doc: EditDoc, id: ElementId): TableGridIdentities;
+export declare function orderedTableRows(record: ElementRecord): OrderedTableRow[];
+export declare function orderedTableColumns(record: ElementRecord): OrderedTableColumn[];
+export declare function tableRowById(record: ElementRecord, id: TableRowId): OrderedTableRow | null;
+export declare function tableColumnById(record: ElementRecord, id: TableColumnId): OrderedTableColumn | null;
+export declare function sourceTableMerges(record: ElementRecord): TableMergeRegion[];
+export declare function effectiveTableMerges(record: ElementRecord): readonly TableMergeRegion[];
+export declare function tableCellMergeRole(record: ElementRecord, cell: TableCellRef): 'anchor' | 'placeholder' | null;
+export declare function queryTableGrid(doc: EditDoc, id: ElementId): TableGridState;
+export declare function tableRowTemplate(record: ElementRecord, insertion: TableRowInsertion): TableRow;

package/dist/table-invariants.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementRecord } from './types';
+export declare function assertTableRows(record: ElementRecord): void;
+export declare function assertTableGridOverrides(record: ElementRecord): void;
+export declare function assertTableCellOverrides(doc: EditDoc, record: ElementRecord, assertTextOverride: (value: unknown, label: string) => void): void;

package/dist/table-rows.d.ts

@@ -1,10 +1,11 @@
-import type { TableRow } from '@web-ppt/core';
+import type { TableCell, TableRow } from '@web-ppt/core';
 import type { ElementRecord, TableRowId, TableRowInsertion } from './types';
 export interface OrderedTableRowInsertion extends TableRowInsertion {
     readonly id: TableRowId;
 }
 export declare function orderedTableRowInsertions(record: ElementRecord): OrderedTableRowInsertion[];
 export declare function lastTableRowOrder(record: ElementRecord): string;
+export declare function emptyTableCell(source: TableCell): TableCell;
 export declare function tableRowsWithoutTextOverrides(record: ElementRecord): TableRow[];
 export declare function tableRowHeightDelta(record: ElementRecord): number;
 export declare function effectiveTableFrameHeight(record: ElementRecord): number;

package/dist/table-scale.d.ts

@@ -0,0 +1,4 @@
+import type { TableElement } from '@web-ppt/core';
+/** 最后一格吃掉浮点余量，保证即时网格与选择 frame 在 JS 数值上也严格闭合。 */
+export declare function scaledDimensions(values: readonly number[], total: number): number[];
+export declare function scaledTableEditInfo(editInfo: TableElement['editInfo'], scale: number): TableElement['editInfo'];

package/dist/table-style.d.ts

@@ -1,5 +1,6 @@
 import type { TableElement, TableStyleDefinition, TableStyleSettings } from '@web-ppt/core';
-import type { EditDoc, ElementId, SlideId } from './types';
+import type { CanvasTarget } from './design-target';
+import type { DesignTarget, EditDoc, ElementId, SlideId } from './types';
 export interface TableStyleCatalogItem {
     readonly styleId: string;
     readonly name: string;
@@ -12,9 +13,9 @@ export interface TableStyleState {
     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[];
+/** 目录以页面或版式主题为上下文；返回值不泄露 OOXML，也不要求 UI 复刻样式优先级。 */
+export declare function listTableStyles(doc: EditDoc, target: SlideId | DesignTarget): 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;
+export declare function projectTableStyle(doc: EditDoc, target: CanvasTarget, table: TableElement, settings: TableStyleSettings): TableElement;

package/dist/templates/index.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinTemplateCatalogItem, BuiltinTemplateId, CreatePptxFromTemplateOptions } from './types';
+export type { BuiltinTemplateCatalogItem, BuiltinTemplateId, BuiltinTemplatePreviewToken, CreatePptxFromTemplateOptions, } from './types';
+export declare function listBuiltinTemplates(): readonly BuiltinTemplateCatalogItem[];
+export declare function createPptxFromTemplate(id: BuiltinTemplateId, options?: CreatePptxFromTemplateOptions): Uint8Array;

package/dist/templates/recipes.d.ts

@@ -0,0 +1,5 @@
+import type { GeneratedTemplateDesign } from '../generate/template';
+import type { BuiltinTemplateCatalogItem, BuiltinTemplateId } from './types';
+export interface BuiltinTemplateRecipe extends BuiltinTemplateCatalogItem, GeneratedTemplateDesign {
+}
+export declare const BUILTIN_TEMPLATE_RECIPES: Readonly<Record<BuiltinTemplateId, BuiltinTemplateRecipe>>;

package/dist/templates/types.d.ts

@@ -0,0 +1,17 @@
+import type { CreateBlankPptxOptions } from '../generate';
+export type BuiltinTemplateId = 'aurora' | 'editorial' | 'midnight';
+export interface BuiltinTemplatePreviewToken {
+    readonly surface: string;
+    readonly foreground: string;
+    readonly accent: string;
+    readonly secondary: string;
+    readonly motif: 'orb' | 'rule' | 'beam';
+}
+export interface BuiltinTemplateCatalogItem {
+    readonly id: BuiltinTemplateId;
+    readonly name: string;
+    readonly description: string;
+    readonly preview: BuiltinTemplatePreviewToken;
+}
+export interface CreatePptxFromTemplateOptions extends CreateBlankPptxOptions {
+}