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

package/dist/master-types.d.ts

@@ -0,0 +1,55 @@
+import type { Fill, MasterTextCategory, SlideMasterTemplate } from '@web-ppt/core';
+import type { ElementId } from './identities';
+import type { MasterDesignTarget } from './layout-types';
+import type { LayoutPropertyState } from './layout-types';
+import type { ParagraphBullet, ParagraphProperties, ParagraphPropertyInput, ParagraphPropertyOverrides, RunProperties, RunPropertyOverrides } from './types';
+export type MasterRunPropertyOverrides = Omit<RunPropertyOverrides, 'link'>;
+export type MasterParagraphPropertyOverrides = Omit<ParagraphPropertyOverrides, 'level'>;
+export type MasterParagraphPropertyInput = Omit<ParagraphPropertyInput, 'level'>;
+export interface MasterTextLevelOverrides {
+    paragraph?: MasterParagraphPropertyOverrides;
+    run?: MasterRunPropertyOverrides;
+}
+export type MasterTextStyleOverrides = Partial<Record<MasterTextCategory, Record<number, MasterTextLevelOverrides>>>;
+export interface MasterOverrides {
+    /** 缺少字段表示来源；显式无背景使用 Fill.none。 */
+    background?: Exclude<Fill, {
+        type: 'image';
+    }>;
+    /** txStyles 三类九级分别稀疏覆盖；字段粒度是协同合并边界。 */
+    textStyles?: MasterTextStyleOverrides;
+}
+/** src 字段继承自解析目录；编辑状态只进入 children / ovr。 */
+export interface MasterRecord extends SlideMasterTemplate {
+    children: ElementId[];
+    ovr: MasterOverrides;
+}
+export interface MasterCatalogItem {
+    readonly id: string;
+    readonly name: string;
+    readonly themeId?: string;
+    readonly layoutIds: readonly string[];
+    readonly target: MasterDesignTarget;
+}
+export interface MasterDesignState extends MasterCatalogItem {
+    readonly background: LayoutPropertyState<Fill | null>;
+    readonly textStyles: Readonly<Record<MasterTextCategory, readonly MasterTextLevelState[]>>;
+}
+export interface MasterParagraphStyle extends ParagraphProperties {
+    readonly bullet: ParagraphBullet;
+}
+export interface MasterTextLevelState {
+    readonly level: number;
+    readonly value: {
+        readonly paragraph: MasterParagraphStyle;
+        readonly run: RunProperties;
+    };
+    readonly source: {
+        readonly paragraph: MasterParagraphStyle;
+        readonly run: RunProperties;
+    };
+    readonly direct: {
+        readonly paragraph: readonly (keyof MasterParagraphPropertyOverrides)[];
+        readonly run: readonly (keyof MasterRunPropertyOverrides)[];
+    };
+}

package/dist/master.d.ts

@@ -0,0 +1,5 @@
+import type { Slide } from '@web-ppt/core';
+import type { EditDoc, MasterCatalogItem, MasterDesignState, MasterDesignTarget } from './types';
+export declare function listMasters(doc: EditDoc): MasterCatalogItem[];
+export declare function queryMaster(doc: EditDoc, target: MasterDesignTarget): MasterDesignState;
+export declare function toMasterCanvas(doc: EditDoc, target: MasterDesignTarget): Slide;

package/dist/media/audio-icon.d.ts

@@ -0,0 +1,2 @@
+/** 固定 PNG 来自 tooling/lib/media-audio-icon-fixture.mjs，生成器校验字节一致；运行时不带栅格器。 */
+export declare const AUDIO_ICON_PNG = "iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAIAAABMXPacAAAC/0lEQVR42u3du24TQRQGYF6GJ+AFeAKegI6KgjotBRUlokZ0VBTUqSloKBE1oiMCIgjiIi5HGFmHSXzZmVl7nf2iv3FhW5lvZ+bMXsZXrt56J3sMAAAABAAAAQBAAAAQAAAEAAABAEAAABAAAAQAAAEAQAAAEAAABMDouXbnBMDecvTo0+nZrxt3PwDYT+v//vu3GwMA/+X60ftF6y8Nxh6LAJS59+RzNnj15seoBgAuyNPnX7NBvASwuWjp20zHL79lg5gYAKxMTJVvT35GM/UVjcEnTwYxPQDYMGR3d412X374i9ffAZQHaTRKHijGnpDjJYB/uXn/Yz48RwKIZOMxqtKDBHh8/KVo+vEAYujP0vHVswaI5shz4w4AIg+eneVv6TsbHxLA4hTNqtbfEuD2w9OKr15UWWMsCw4DYFHmr2n6LQEW53kqWnB5gqh7JzgAgGWZ3wiQG7HCYKROMHWAohBsASgmj6GL26IT9CqHpgtwvsxvBIgPzEdxxeI2v73XmmCiABeW+e1zQOPiNnfHwLi0AKvK/HaA8yPJoAM5+lB+b5fLNdMCWF/mdwEoznQOXdzm93ZZlE0IYGOZ3wsgWjx/Uayz6qbiLqNQN4CWhuv1V7e4HdQJilGofUEwU4CiEwyaCXJt1l4LzRSg6ASDBpNcC8WUAKASoLqkiRK54zQwX4Di4vugkqbjknjWAHFmtO5YztNAdAgAlQDVJU3uOoOqWADrjuXtLxXkCRxAE0BdU+axq/FuibkD5JXt9k2ZCyEATQB1TZnv4W2sROcOkOfhWBvX/b8Amhqi7hMAAAAAAIBJGIAy1EIMgFMRTsYBcDraBRkALkm6KA/AbSluzAIwx1sT3Zzr9nS3p3tAwyNKHlHykJ7HVD2m6kFtWxXYqsBmHbarsV2NDZtsWdYcW5bZtM+2lbattHGrrYttXbzD2Lzb9vVzjR9w8BMm4kd8/IyV7C4AAAAQAAAEAAABAEAAABAAAAQAAAEAQAAAEAAABAAAAQBAAACQjvkDJvM8rvLczI4AAAAASUVORK5CYII=";

package/dist/media/commands.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, ExtensionCommand } from '../commands/types';
+export declare function addMediaPatches(doc: EditDoc, extension: ExtensionCommand, origin: string): CommandPatches;

package/dist/media/index.d.ts

@@ -0,0 +1,10 @@
+import type { Editor } from '../editor';
+import type { MediaCommand } from './types';
+export type { AddMediaCommand, ReplaceMediaPosterCommand, MediaCommand, MediaPoster } from './types';
+export { MAX_MEDIA_BYTES } from './resource';
+/** 接收恢复/协同数据前显式调用，避免仅副作用导入被打包器移除。 */
+export declare function registerMediaEditing(): void;
+/** 按需命令只产生现有 Patch，历史、恢复与协同仍共用主编辑器。 */
+export declare function createMediaEditor(editor: Pick<Editor, 'doc' | 'exec'>): {
+    exec(command: MediaCommand): string;
+};

package/dist/media/markup.d.ts

@@ -0,0 +1,10 @@
+import type { InsertionRect } from '../commands/insertion-rect';
+export declare const OFFICE_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+export declare const MEDIA_REL = "http://schemas.microsoft.com/office/2007/relationships/media";
+export declare const MEDIA_NAMESPACES: {
+    'xmlns:a': string;
+    'xmlns:p': string;
+    'xmlns:r': string;
+    'xmlns:p14': string;
+};
+export declare function mediaMarkup(spid: number, rect: InsertionRect, kind: 'audio' | 'video', external?: boolean): string;

package/dist/media/mp4-boxes.d.ts

@@ -0,0 +1,12 @@
+export interface Mp4Box {
+    type: string;
+    start: number;
+    data: number;
+    end: number;
+}
+export declare const invalidMp4: () => never;
+export declare const mp4Tag: (bytes: Uint8Array, at: number) => string;
+export declare function mp4Uint(bytes: Uint8Array, box: Mp4Box, offset: number, size?: 1 | 2 | 4 | 8): number;
+/** 未知 box 按声明长度跳过；不扫描载荷中的伪标签，也不把 64 位长度截断到 32 位。 */
+export declare function mp4Boxes(bytes: Uint8Array, start?: number, end?: number): Mp4Box[];
+export declare function mp4Box(boxes: readonly Mp4Box[], type: string): Mp4Box;

package/dist/media/mp4-fragments.d.ts

@@ -0,0 +1,8 @@
+import { type Mp4Box } from './mp4-boxes';
+export interface Mp4Track {
+    descriptions: number;
+    samples: number;
+    video: boolean;
+}
+/** 分片地址以 tfhd 为基准，trun 再叠加有符号偏移；不能把它当成 stco 绝对地址。 */
+export declare function assertMp4Fragments(bytes: Uint8Array, boxes: readonly Mp4Box[], movie: readonly Mp4Box[], tracks: Map<number, Mp4Track>): void;

package/dist/media/mp4-samples.d.ts

@@ -0,0 +1,4 @@
+import { type Mp4Box } from './mp4-boxes';
+export declare function assertMp4Range(start: number, size: number, mdats: readonly Mp4Box[]): void;
+/** 样本地址必须由 stsc/stsz/stco 联合求出；只验证首个 chunk 会漏掉尾部截断和外部引用。 */
+export declare function assertMp4Samples(bytes: Uint8Array, tables: readonly Mp4Box[], mdats: readonly Mp4Box[], descriptions: number): number;

package/dist/media/mp4.d.ts

@@ -0,0 +1,2 @@
+/** 上传仅验证容器闭包，不引入解码器；实际编解码能力仍由播放器决定。 */
+export declare function assertMp4(bytes: Uint8Array): void;

package/dist/media/poster.d.ts

@@ -0,0 +1,2 @@
+import type { MediaPoster } from './types';
+export declare function prepareMediaPoster(poster: MediaPoster | undefined, kind: 'audio' | 'video'): import("..").ClipboardResource;

package/dist/media/replace-poster.d.ts

@@ -0,0 +1,3 @@
+import type { CommandPatches, ExtensionCommand } from '../commands/types';
+import type { EditDoc } from '../types';
+export declare function mediaCommandPatches(doc: EditDoc, extension: ExtensionCommand, origin: string): CommandPatches;

package/dist/media/resource.d.ts

@@ -0,0 +1,4 @@
+import type { ClipboardResource } from '../commands/types';
+export declare const MAX_MEDIA_BYTES: number;
+export declare function validateMediaResource(resource: Pick<ClipboardResource, 'mime' | 'extension'>, bytes: Uint8Array): boolean;
+export declare function createMediaResource(value: unknown, mime: unknown): ClipboardResource;

package/dist/media/source.d.ts

@@ -0,0 +1,14 @@
+import type { ClipboardResource } from '../commands/types';
+import type { AddMediaCommand } from './types';
+type PreparedMedia = {
+    readonly kind: 'audio' | 'video';
+} & ({
+    readonly resource: ClipboardResource;
+    readonly url?: never;
+} | {
+    readonly resource: null;
+    readonly url: string;
+});
+/** 外链没有可验证字节；只保留显式来源，不能按 URL 后缀假装验证过 MIME。 */
+export declare function prepareMediaSource(source: AddMediaCommand['source']): PreparedMedia;
+export {};

package/dist/media/types.d.ts

@@ -0,0 +1,33 @@
+import type { ElementId, SlideId } from '../types';
+import type { InsertionRect } from '../commands/insertion-rect';
+export interface MediaPoster {
+    readonly bytes: Uint8Array;
+    readonly mime: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+}
+type MediaSource<K extends 'audio' | 'video'> = {
+    readonly kind: 'embedded';
+    readonly bytes: Uint8Array;
+    readonly mime: K extends 'audio' ? 'audio/wav' : 'video/mp4';
+} | {
+    readonly kind: 'external';
+    readonly mediaKind: K;
+    readonly url: string;
+};
+export type AddMediaCommand = {
+    readonly type: 'AddMedia';
+    readonly slideId: SlideId;
+    readonly rect: InsertionRect;
+} & ({
+    readonly source: MediaSource<'audio'>;
+    readonly poster?: MediaPoster;
+} | {
+    readonly source: MediaSource<'video'>;
+    readonly poster: MediaPoster;
+});
+export interface ReplaceMediaPosterCommand {
+    readonly type: 'ReplaceMediaPoster';
+    readonly id: ElementId;
+    readonly poster: MediaPoster;
+}
+export type MediaCommand = AddMediaCommand | ReplaceMediaPosterCommand;
+export {};

package/dist/media-properties.d.ts

@@ -0,0 +1,4 @@
+export declare const OFFICE_MEDIA_REL = "http://schemas.microsoft.com/office/2007/relationships/media";
+export declare const POWERPOINT_2010_NS = "http://schemas.microsoft.com/office/powerpoint/2010/main";
+/** 经典关系服务旧版 Office，p14 关系服务新版媒体；二者必须指向同一来源。 */
+export declare function mediaPropertiesMarkup(kind: 'audio' | 'video', classicId?: string, compatibleId?: string, external?: boolean): string;