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

package/dist/selection-pane.d.ts

@@ -0,0 +1,18 @@
+import type { EditDoc, EditableKind, ElementId, SlideId } from './types';
+export interface SelectionPaneItem {
+    readonly id: ElementId;
+    readonly parentId: ElementId | null;
+    readonly depth: number;
+    readonly kind: EditDoc['elements'][string]['src']['kind'];
+    readonly name: string;
+    readonly sourceName: string | null;
+    readonly direct: boolean;
+    readonly editable: EditableKind;
+    readonly locked: boolean;
+    readonly ownLocked: boolean;
+    readonly hidden: boolean;
+    readonly ownHidden: boolean;
+    readonly hasChildren: boolean;
+}
+/** 选择窗格与画布共用模型绘制序；逆序只负责把最上层对象放在列表顶部。 */
+export declare function querySelectionPane(doc: EditDoc, slideId: SlideId): SelectionPaneItem[];

package/dist/selection.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc, ElementId } from './types';
+import type { Selection } from './commands/types';
+export declare function cloneSelection(selection: Selection): Selection;
+export declare function isElementDescendantOf(doc: EditDoc, id: ElementId, ancestor: ElementId): boolean;
+/** 选区根只沿每个元素的父链查找，避免大选区用两两后代判断退化为平方复杂度。 */
+export declare function outermostSelectedElementIds(doc: EditDoc, ids: readonly ElementId[]): ElementId[];
+export declare function normalizeSelection(doc: EditDoc, selection: Selection): Selection;
+/** 结构编辑后过滤已删除身份；普通属性事务仍走严格 normalizeSelection。 */
+export declare function selectionAfterStructure(doc: EditDoc, selection: Selection): Selection;
+/** 会话锁定/隐藏不删除模型，只过滤因此失效的活动选区。 */
+export declare function selectionAfterInteractionState(doc: EditDoc, selection: Selection): Selection;

package/dist/session-assets.d.ts

@@ -0,0 +1,20 @@
+import type { PresentationEditAsset, SlideElement } from '@web-ppt/core';
+import type { ClipboardResource } from './commands/types';
+import type { EditDoc, ElementInsertionResource } from './types';
+interface DocAsset {
+    readonly mime: string;
+    readonly bytes: Uint8Array;
+    readonly sourcePart?: string;
+    hash?: string;
+}
+export declare const insertionResourceToken: (hash: string) => string;
+/** 保存会替换 doc.package；解析期 URL 与字节的对应关系必须在建模时保留下来。 */
+export declare function registerSessionAssets(doc: EditDoc, editAssets?: readonly PresentationEditAsset[]): void;
+export declare function sessionAsset(doc: EditDoc, url: string): DocAsset | undefined;
+export declare function releaseSessionAssets(doc: EditDoc): void;
+export declare function tokenizeElementAssets(doc: EditDoc, source: SlideElement, used: Set<string>, insertionResources?: readonly ClipboardResource[]): SlideElement;
+export declare function createElementAssetHydrator(resources: readonly ClipboardResource[]): (source: SlideElement) => SlideElement;
+/** EditDoc 保留小型资源 token；只有有效投影需要付出 data URI 的字符串成本。 */
+export declare function hydrateElementInsertionAssets(source: SlideElement, resources: readonly ClipboardResource[]): SlideElement;
+export declare function hydrateInsertionResourceSource(source: string, resource: ElementInsertionResource): string;
+export {};

package/dist/shape-effects.d.ts

@@ -0,0 +1,6 @@
+import type { Effects } from '@web-ppt/core';
+import type { EditDoc, ElementEffectsState, ElementId } from './types';
+export declare function assertEffects(value: unknown, label: string): asserts value is Effects;
+/** 与 core 解析器及 OOXML 整数单位共用一份规范值，避免保存重开后制造脏状态。 */
+export declare function normalizeEffects(effects: Effects): Effects;
+export declare function queryElementEffects(doc: EditDoc, ids: readonly ElementId[]): ElementEffectsState;

package/dist/shape-fill.d.ts

@@ -0,0 +1,12 @@
+import type { Fill } from '@web-ppt/core';
+import type { EditDoc, ElementFillState, ElementId } from './types';
+export type VectorFill = Exclude<Fill, {
+    type: 'image';
+}>;
+export declare const SHAPE_PATTERN_PRESETS: readonly ["pct5", "pct10", "pct20", "pct25", "pct30", "pct40", "pct50", "pct60", "pct70", "pct75", "pct80", "pct90", "ltHorz", "horz", "dkHorz", "ltVert", "vert", "dkVert", "ltUpDiag", "upDiag", "ltDnDiag", "dnDiag", "smGrid", "lgGrid", "cross", "diagCross", "trellis", "wave"];
+export declare function assertDrawingColor(value: unknown, label: string): asserts value is string;
+/** 命令提交时就收敛到 core 解析器的颜色表示，保存/重开不应改变统一 Schema。 */
+export declare function normalizeDrawingColor(value: string): string;
+export declare function normalizeVectorFill(fill: VectorFill): VectorFill;
+export declare function assertVectorFill(value: unknown, label: string): asserts value is VectorFill;
+export declare function queryElementFill(doc: EditDoc, ids: readonly ElementId[]): ElementFillState;

package/dist/shape-stroke.d.ts

@@ -0,0 +1,9 @@
+import type { Stroke } from '@web-ppt/core';
+import type { EditDoc, ElementId, ElementStrokeState } from './types';
+export type StrokeCommandValue = Stroke | {
+    readonly type: 'none';
+} | null;
+export declare function assertStroke(value: unknown, label: string): asserts value is Stroke;
+export declare function strokeDashName(stroke: Stroke): string | null;
+export declare function normalizeStroke(stroke: Stroke): Stroke;
+export declare function queryElementStroke(doc: EditDoc, ids: readonly ElementId[]): ElementStrokeState;

package/dist/slide-animation.d.ts

@@ -0,0 +1,15 @@
+import type { AnimStep } from '@web-ppt/core';
+import type { EditAnimationStep, EditDoc, SlideAnimationState, SlideId } from './types';
+import { ANIMATION_EFFECTS, animationDirections, animationEffectsForKind } from './animation-catalog';
+export { ANIMATION_EFFECTS, animationDirections, animationEffectsForKind };
+/** 128 个最重的规范效果仍能在 core 的 4096 DOM 节点预算内完整回读。 */
+export declare const MAX_ANIMATION_STEPS = 128;
+export declare function normalizeSlideAnimations(doc: EditDoc, slideId: SlideId, value: unknown, label?: string): readonly EditAnimationStep[];
+/** 来源解析结果映射失败时仍原样投影；查询用 sourceReadonly 告知产品不要冒充完整可编辑。 */
+export declare function sourceAnimationSteps(doc: EditDoc, slideId: SlideId, steps: readonly AnimStep[] | undefined): {
+    steps: readonly EditAnimationStep[];
+    readonly: boolean;
+};
+export declare function projectAnimationSteps(doc: EditDoc, steps: readonly EditAnimationStep[]): AnimStep[] | undefined;
+export declare function querySlideAnimations(doc: EditDoc, ids: readonly SlideId[]): SlideAnimationState;
+export declare function assertStoredSlideAnimations(doc: EditDoc, slideId: SlideId, value: unknown, label: string): asserts value is readonly EditAnimationStep[];

package/dist/slide-background-source.d.ts

@@ -0,0 +1,13 @@
+import type { ClipboardClosure } from './clipboard-source';
+import type { OpcPackage } from '@web-ppt/core';
+import type { EditDoc, SlideRecord } from './types';
+import type { XmlElement } from './xml/types';
+export interface SourceImageBackground {
+    readonly package: OpcPackage;
+    readonly part: string;
+    readonly background: XmlElement;
+    readonly imageRelationshipId: string;
+    readonly closure: ClipboardClosure;
+}
+/** 按 slide → layout → master 的继承停止规则定位真正提供当前图片背景的 OPC 宿主。 */
+export declare function sourceImageBackground(doc: EditDoc, record: SlideRecord): SourceImageBackground | null;

package/dist/slide-notes.d.ts

@@ -0,0 +1,2 @@
+import type { EditDoc, SlideId, SlideNotesState } from './types';
+export declare function querySlideNotes(doc: EditDoc, ids: readonly SlideId[]): SlideNotesState;

package/dist/slide-properties.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, SlideBackgroundState, SlideHiddenState, SlideId, SlideLayoutState } from './types';
+export declare function querySlideBackground(doc: EditDoc, ids: readonly SlideId[]): SlideBackgroundState;
+export declare function querySlideHidden(doc: EditDoc, ids: readonly SlideId[]): SlideHiddenState;
+export declare function querySlideLayout(doc: EditDoc, ids: readonly SlideId[]): SlideLayoutState;

package/dist/slide-transition.d.ts

@@ -0,0 +1,19 @@
+import { type Transition, type TransitionType } from '@web-ppt/core';
+import type { EditDoc, SlideId, SlideTransitionState } from './types';
+/** 顺序是公开契约；宿主可以稳定地分组或持久化最近使用项。 */
+export declare const SLIDE_TRANSITION_TYPES: readonly ["none", "fade", "cut", "push", "pull", "cover", "wipe", "split", "zoom", "dissolve", "checker", "blinds", "comb", "wheel", "circle", "diamond", "plus", "wedge", "newsflash", "randomBar", "strips", "vortex", "switch", "flip", "ripple", "honeycomb", "glitter", "warp", "flythrough", "flash", "shred", "reveal", "wheelReverse", "ferris", "gallery", "conveyor", "pan", "doors", "window", "prism", "morph"];
+export declare function transitionDirections(type: TransitionType): readonly string[];
+export type SlideTransitionInput = {
+    readonly type: TransitionType;
+    /** none 省略；其余省略时采用 750ms。 */
+    readonly durationMs?: number;
+    readonly dir?: string;
+    /** SetTransition 省略时保留当前页面计时；显式传值才更新。 */
+    readonly advanceAfterMs?: number;
+    readonly morphBy?: Transition['morphBy'];
+};
+/** 命令与恢复 Patch 共用一处严格归一化，避免合法性在不同入口漂移。 */
+export declare function normalizeSlideTransition(value: unknown, label?: string): Transition;
+/** 模型/Patch 必须已经归一化，不能在回放时悄悄补默认值。 */
+export declare function assertStoredSlideTransition(value: unknown, label: string): asserts value is Transition;
+export declare function querySlideTransition(doc: EditDoc, ids: readonly SlideId[]): SlideTransitionState;

package/dist/space.d.ts

@@ -0,0 +1,47 @@
+import type { EditDoc, ElementId } from './types';
+export interface SpacePoint {
+    x: number;
+    y: number;
+}
+/** SVG 同口径仿射矩阵：x' = ax + cy + e，y' = bx + dy + f。 */
+export interface AffineMatrix {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    e: number;
+    f: number;
+}
+export interface SlideViewport {
+    left: number;
+    top: number;
+    zoom: number;
+}
+export interface ElementFrameTransform {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    rot: number;
+}
+export declare function composeSpaceMatrices(left: AffineMatrix, right: AffineMatrix): AffineMatrix;
+export declare function elementFrameToParentMatrix(element: ElementFrameTransform): AffineMatrix;
+export declare function transformSpacePoint(matrix: AffineMatrix, point: SpacePoint): SpacePoint;
+export declare function transformSpaceVector(matrix: AffineMatrix, vector: SpacePoint): SpacePoint;
+/** 方向没有平移分量，单独求逆可避免误把父空间原点带进角度计算。 */
+export declare function inverseTransformSpaceVector(matrix: AffineMatrix, vector: SpacePoint): SpacePoint;
+/** 反射会让父空间里的正角方向与幻灯片空间相反；旋转连续性必须沿同一手性展开。 */
+export declare function spaceOrientationParity(matrix: AffineMatrix): 1 | -1;
+export declare function invertSpaceMatrix(matrix: AffineMatrix): AffineMatrix;
+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 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;
+export declare function slideToElementParentPoint(doc: EditDoc, id: ElementId, point: SpacePoint): SpacePoint;
+export declare function slideToScreenPoint(point: SpacePoint, viewport: SlideViewport): SpacePoint;
+export declare function screenToSlidePoint(point: SpacePoint, viewport: SlideViewport): SpacePoint;

package/dist/table-cell.d.ts

@@ -0,0 +1,10 @@
+import type { ElementRecord, TableCellAddress, TableCellKey, 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 tableCellAddressFromRowRef(record: ElementRecord, row: unknown, column: unknown): TableCellAddress | null;
+export declare function tableCellOverrideKeyFromRowRef(row: TableCellRowRef, column: number): TableCellKey;
+export declare function tableCellOverrideKey(record: ElementRecord, cell: TableCellAddress): TableCellKey;
+export declare function tableCellKeyResolver(record: ElementRecord): (key: string) => TableCellAddress | null;
+export declare function assertTableCellAddress(value: unknown, label: string): asserts value is TableCellAddress;

package/dist/table-direct-markup.d.ts

@@ -0,0 +1,3 @@
+import type { TableCell } from '@web-ppt/core';
+/** 新表格把已求值视觉写成直接格式，跨文档粘贴不再依赖来源 tableStyles/theme。 */
+export declare function directTableCellMarkup(cell: TableCell): string;

package/dist/table-insertion-policy.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc, ElementId, SlideId } from './types';
+export declare const MAX_TABLE_DIMENSION = 75;
+export declare function assertTableDimension(value: number, label: string): void;
+/** 命令层与公开交互层必须共享同一占位符资格规则，避免 UI 接受而模型拒绝。 */
+export declare function isEmptyContentPlaceholder(doc: EditDoc, slideId: SlideId, id: unknown): id is ElementId;

package/dist/table-row-append-validation.d.ts

@@ -0,0 +1,3 @@
+import type { TableElement } from '@web-ppt/core';
+/** tableRowAppend 是公开剪贴板与 EditDoc 的结构入口，不能等到投影时才发现坏模板。 */
+export declare function assertTableRowAppendEditInfo(table: TableElement, label: string): void;

package/dist/table-rows.d.ts

@@ -0,0 +1,12 @@
+import type { 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 tableRowsWithoutTextOverrides(record: ElementRecord): TableRow[];
+export declare function tableRowHeightDelta(record: ElementRecord): number;
+export declare function effectiveTableFrameHeight(record: ElementRecord): number;
+/** SetXfrm 面向当前可见整表；稀疏覆盖保存的是追加前 frame，故需反解同一缩放比例。 */
+export declare function tableBaseFrameHeight(record: ElementRecord, effectiveHeight: number): number;

package/dist/text-model.d.ts

@@ -0,0 +1,28 @@
+import type { TextBody } from '@web-ppt/core';
+import type { TextEditOp, TextRange } from './commands/types';
+import type { ParagraphPropertiesState, ParagraphPropertyOverrides, RunPropertiesState, RunPropertyOverrides, TextFragment, TextMark, TextOverride } from './types';
+export { textBodyFromOverride } from './text-override-projection';
+export declare function flattenTextBody(body: TextBody): Extract<TextOverride, {
+    kind: 'flat';
+}>;
+export declare function applyTextEditOps(body: TextBody, ops: readonly TextEditOp[], initial?: Extract<TextOverride, {
+    kind: 'flat';
+}>): TextOverride;
+/** 把有效文字选区降成可跨实例传输的格式白名单，不泄漏 OOXML 来源身份。 */
+export declare function textFragmentFromRange(body: TextBody, range: TextRange): TextFragment;
+export declare function applyRunProps(body: TextBody, range: TextRange, props: RunPropertyOverrides, initial?: Extract<TextOverride, {
+    kind: 'flat';
+}>): TextOverride;
+export declare function applyParagraphProps(body: TextBody, range: TextRange, props: ParagraphPropertyOverrides, initial?: Extract<TextOverride, {
+    kind: 'flat';
+}>): TextOverride;
+export declare function queryTextParagraphProps(body: TextBody, range: TextRange, initial?: Extract<TextOverride, {
+    kind: 'flat';
+}>): ParagraphPropertiesState;
+export declare function queryTextRunProps(body: TextBody, range: TextRange, initial?: Extract<TextOverride, {
+    kind: 'flat';
+}>): RunPropertiesState;
+/** 链接查询与字符面板复用完全相同的区间/公式边界语义。 */
+export declare function textMarksInRange(body: TextBody, range: TextRange, initial?: Extract<TextOverride, {
+    kind: 'flat';
+}>): TextMark[];

package/dist/text-override-projection.d.ts

@@ -0,0 +1,8 @@
+import type { TextBody } from '@web-ppt/core';
+import type { LinkOverride, TextOverride } from './types';
+/** 用户未触碰的格式每次从当前投影源重基；覆盖层不会冻结旧版式的有效值。 */
+export declare function textBodyFromOverride(override: Extract<TextOverride, {
+    kind: 'flat';
+}>, source?: TextBody | null, resolveLink?: (link: Exclude<LinkOverride, {
+    kind: 'none';
+}>) => string | undefined): TextBody;

package/dist/text-override-validation.d.ts

@@ -0,0 +1,7 @@
+import type { TextOverride } from './types';
+export declare function validateFlatTextOverride(override: Extract<TextOverride, {
+    kind: 'flat';
+}>): void;
+export declare function validateEmptyTextOverride(override: Extract<TextOverride, {
+    kind: 'empty';
+}>): void;

package/dist/text-position.d.ts

@@ -0,0 +1,8 @@
+import type { TextBody, TextRun } from '@web-ppt/core';
+import type { TextPosition } from './commands/types';
+/** 公式在编辑字符串里只占一个 UTF-16 位置，不能把光标落进公式树内部。 */
+export declare const TEXT_ATOM = "\uFFFC";
+export declare function textRunEditLength(run: Pick<TextRun, 'text' | 'math'>): number;
+export declare function textBodyEditText(body: TextBody): string;
+export declare function textPositionAtIndex(body: TextBody, index: number): TextPosition;
+export declare function textPositionToIndex(body: TextBody, position: TextPosition): number;

package/dist/text-search-types.d.ts

@@ -0,0 +1,46 @@
+import type { ElementId, SlideId, TableCellAddress } from './types';
+import type { TextRange } from './commands/types';
+export type TextSearchScope = {
+    readonly kind: 'document';
+} | {
+    readonly kind: 'slide';
+    readonly slideId: SlideId;
+} | {
+    readonly kind: 'slides';
+    readonly slideIds: readonly SlideId[];
+};
+export interface FindTextRequest {
+    readonly query: string;
+    readonly scope: TextSearchScope;
+    readonly matchCase?: boolean;
+    readonly wholeWord?: boolean;
+}
+export interface TextSearchMatch {
+    /** 同一文档状态下可直接用作列表 key；模型变化后必须重新查询。 */
+    readonly key: string;
+    readonly slideId: SlideId;
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly range: TextRange;
+    readonly text: string;
+    readonly before: string;
+    readonly after: string;
+}
+export interface TextSearchTarget {
+    readonly slideId: SlideId;
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly range: TextRange;
+}
+export type ReplaceTextScope = TextSearchScope | {
+    readonly kind: 'match';
+    readonly match: TextSearchTarget;
+};
+export interface ReplaceTextCommand {
+    readonly type: 'ReplaceText';
+    readonly scope: ReplaceTextScope;
+    readonly from: string;
+    readonly to: string;
+    readonly matchCase?: boolean;
+    readonly wholeWord?: boolean;
+}

package/dist/text-search.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from './types';
+import type { FindTextRequest, TextSearchMatch } from './text-search-types';
+export declare function assertFindTextRequest(doc: EditDoc, value: unknown): asserts value is FindTextRequest;
+/** 无 DOM、无索引副作用；需要增量缓存的宿主可在此公开结果之上按脏页维护。 */
+export declare function findText(doc: EditDoc, request: FindTextRequest): readonly TextSearchMatch[];

package/dist/transaction-validation.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from './commands/types';
+import type { EditDoc, ElementId } from './types';
+export declare function shapeTextCommandTarget(command: Command): ElementId | null;
+/** 删除子树与同树属性编辑无法形成无需依赖顺序的双向 patch，必须在任何模型修改前拒绝。 */
+export declare function validateCommandRelations(doc: EditDoc, commands: readonly Command[]): void;