@web-ppt/edit-core 0.6.0-beta.1 → 0.8.0-beta.1

package/dist/agent/generated-validator.d.ts

@@ -0,0 +1,6 @@
+export declare const validate: typeof validate10;
+export default validate10;
+declare function validate10(data: any, { instancePath, parentData, parentDataProperty, rootData }?: {
+    instancePath?: string | undefined;
+    rootData?: any;
+}): boolean;

package/dist/agent/index.d.ts

@@ -0,0 +1,6 @@
+export { agentToolSchema } from './generated-schema';
+export { listAgentTools } from './tools';
+export { AgentSession, createAgentSession, openAgentSession } from './session';
+export type { AgentSessionOptions } from './session';
+export { AgentToolError } from './errors';
+export type { AgentCommand, AgentDescribeInput, AgentEditInput, AgentElementInput, AgentElementQuery, AgentElementResult, AgentEmptyInput, AgentHistoryState, AgentLintInput, AgentMutationResult, AgentRenderInput, AgentRenderResult, AgentSaveResult, AgentToolDescriptor, AgentToolFailure, AgentToolInput, AgentToolInputMap, AgentToolName, AgentToolOutputMap, AgentToolResult, } from './types';

package/dist/agent/query.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '@web-ppt/edit-core';
+import type { AgentElementInput, AgentElementResult } from './types';
+export declare function queryElement(doc: EditDoc, input: AgentElementInput): AgentElementResult;

package/dist/agent/session.d.ts

@@ -0,0 +1,33 @@
+import type { Presentation, TextMeasure } from '@web-ppt/core';
+import type { NodeRasterizer } from '@web-ppt/core/node';
+import { Editor } from '@web-ppt/edit-core';
+import type { EditDoc } from '@web-ppt/edit-core';
+import type { LayoutLintOptions } from '../lint/types';
+import type { AgentToolInput, AgentToolName, AgentToolResult } from './types';
+export interface AgentSessionOptions {
+    readonly idPrefix?: string;
+    readonly lint?: LayoutLintOptions;
+    readonly measureText?: TextMeasure;
+    readonly rasterize?: NodeRasterizer;
+    readonly presentation?: Presentation;
+}
+export declare class AgentSession {
+    readonly editor: Editor;
+    private readonly options;
+    private readonly ownsDoc;
+    private active;
+    constructor(editor: Editor, options?: AgentSessionOptions, ownsDoc?: boolean);
+    get doc(): EditDoc;
+    call<T extends AgentToolName>(name: T, input: AgentToolInput<T>): Promise<AgentToolResult<T>>;
+    dispose(): void;
+    private dispatch;
+    private edit;
+    private replay;
+    private mutation;
+    private observe;
+    private lintOptions;
+    private render;
+    private save;
+}
+export declare function createAgentSession(doc: EditDoc, options?: AgentSessionOptions): AgentSession;
+export declare function openAgentSession(bytes: Uint8Array, options?: AgentSessionOptions): Promise<AgentSession>;

package/dist/agent/targets.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from '../commands/types';
+import type { DesignTarget, EditDoc } from '../types';
+export declare function assertCommandTargets(doc: EditDoc, command: Command, index: number): void;
+export declare function assertBatchTargets(doc: EditDoc, commands: readonly Command[]): void;
+export declare function commonDesignTarget(doc: EditDoc, commands: readonly Command[]): DesignTarget | null;

package/dist/agent/tools.d.ts

@@ -0,0 +1,2 @@
+import type { AgentToolDescriptor } from './types';
+export declare function listAgentTools(): readonly AgentToolDescriptor[];

package/dist/agent/types.d.ts

@@ -0,0 +1,126 @@
+import type { LayoutCheck, LayoutLintReport } from '../lint/types';
+import type { PresentationDescription } from '../describe/types';
+import type { AddImageCommand as EditAddImageCommand, Command, ReplaceImageCommand as EditReplaceImageCommand, SetBackgroundImageCommand as EditSetBackgroundImageCommand, TextRange } from '../commands/types';
+import type { TableCellAddress } from '../types';
+type JsonBytes<T> = T extends {
+    readonly bytes: Uint8Array;
+} ? {
+    readonly [K in keyof T]: K extends 'bytes' ? string : T[K];
+} : T;
+type BinaryCommand = EditAddImageCommand | EditReplaceImageCommand | EditSetBackgroundImageCommand;
+export type AddImageCommand = JsonBytes<EditAddImageCommand>;
+export type ReplaceImageCommand = JsonBytes<EditReplaceImageCommand>;
+export type SetBackgroundImageCommand = JsonBytes<EditSetBackgroundImageCommand>;
+/** 与 Editor 命令一一对应；图片字节在 JSON 传输中使用 Base64。 */
+export type AgentCommand = Exclude<Command, BinaryCommand> | AddImageCommand | ReplaceImageCommand | SetBackgroundImageCommand;
+export interface AgentDescribeInput {
+    readonly maxChars?: number;
+}
+export type AgentElementQuery = 'describe' | 'fill' | 'stroke' | 'effects' | 'crop' | 'link' | 'run' | 'paragraph' | 'body';
+export interface AgentElementInput {
+    readonly id: string;
+    readonly query: AgentElementQuery;
+    readonly range?: TextRange;
+    readonly cell?: TableCellAddress;
+}
+export interface AgentLintInput {
+    readonly checks?: readonly LayoutCheck[];
+    readonly canvasColor?: string;
+    readonly overlapRatio?: number;
+    readonly imageDeviation?: number;
+    readonly tolerancePx?: number;
+    readonly maxIssues?: number;
+}
+export interface AgentRenderInput {
+    readonly slideNumber: number;
+    readonly format: 'svg' | 'png';
+    readonly scale?: number;
+}
+export interface AgentEditInput {
+    /** @minItems 1 */
+    readonly commands: readonly AgentCommand[];
+    readonly lint?: AgentLintInput;
+}
+export interface AgentEmptyInput {
+    readonly [key: string]: never;
+}
+/** 每个属性是一种工具；校验时只提交当前工具对应的单属性对象。 */
+export interface AgentToolInputMap {
+    readonly describe?: AgentDescribeInput;
+    readonly element?: AgentElementInput;
+    readonly lint?: AgentLintInput;
+    readonly render?: AgentRenderInput;
+    readonly edit?: AgentEditInput;
+    readonly undo?: AgentEmptyInput;
+    readonly redo?: AgentEmptyInput;
+    readonly save?: AgentEmptyInput;
+}
+export type AgentToolName = keyof AgentToolInputMap;
+export type AgentToolInput<T extends AgentToolName> = NonNullable<AgentToolInputMap[T]>;
+export interface AgentToolDescriptor {
+    readonly name: AgentToolName;
+    readonly description: string;
+    readonly inputSchema: Readonly<Record<string, unknown>>;
+}
+export interface AgentElementResult {
+    readonly id: string;
+    readonly query: AgentElementQuery;
+    readonly value: unknown;
+}
+export interface AgentRenderResult {
+    readonly slideNumber: number;
+    readonly format: 'svg' | 'png';
+    readonly data: string;
+}
+export interface AgentHistoryState {
+    readonly undoCount: number;
+    readonly redoCount: number;
+}
+export interface AgentMutationResult {
+    readonly affectedElements: readonly string[];
+    readonly affectedSlides: readonly string[];
+    readonly lint: {
+        readonly status: 'ok';
+        readonly slideNumbers: readonly number[];
+        readonly report: LayoutLintReport | null;
+    } | {
+        readonly status: 'failed';
+        readonly slideNumbers: readonly number[];
+        readonly reason: string;
+        readonly message: string;
+    };
+    readonly history: AgentHistoryState;
+}
+export interface AgentSaveResult {
+    readonly bytes: string;
+    readonly saveMode: 'patch' | 'generated';
+    readonly packageMode: 'identity' | 'passthrough' | 'repacked';
+    readonly fallbackReason: string | null;
+    readonly preservedEntries: number;
+    readonly rewrittenEntries: number;
+}
+export interface AgentToolOutputMap {
+    readonly describe: PresentationDescription;
+    readonly element: AgentElementResult;
+    readonly lint: LayoutLintReport;
+    readonly render: AgentRenderResult;
+    readonly edit: AgentMutationResult;
+    readonly undo: AgentMutationResult;
+    readonly redo: AgentMutationResult;
+    readonly save: AgentSaveResult;
+}
+export interface AgentToolFailure {
+    readonly ok: false;
+    readonly error: {
+        readonly reason: string;
+        readonly message: string;
+        readonly commandIndex: number | null;
+        readonly elementId: string | null;
+        readonly slideNumber: number | null;
+    };
+}
+export type AgentToolResult<T extends AgentToolName> = {
+    readonly ok: true;
+    readonly value: AgentToolOutputMap[T];
+} | AgentToolFailure;
+export {};

package/dist/agent/validation.d.ts

@@ -0,0 +1,2 @@
+import type { AgentToolInput, AgentToolName } from './types';
+export declare function assertToolInput<T extends AgentToolName>(name: T, input: unknown): AgentToolInput<T>;