@volcengine/amk-editor 0.0.1-beta.4

package/LICENSE

@@ -0,0 +1,11 @@
+Copyright 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates. All Rights Reserved.
+
+The AMK Editor SDK was developed by Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates (hereinafter “Volcano Engine”). Any rights, including but not limited to any copyrights or patent rights, are owned by and proprietary material of the Volcano Engine.
+
+The AMK Editor SDK is licensed solely for integration within AI MediaKit which shall be used under a valid commercial license. Customers can contact service@volcengine.com for such commercial license. Here is also a link to AI MediaKit: https://www.volcengine.com/docs/6448/69e744e0d6af160501b2d70b?lang=zh.
+
+Without Volcano Engine's prior written permission, any use of the AMK Editor SDK beyond its incorporation into AI MediaKit, in particular any use for commercial purposes, is strictly prohibited. This includes, without limitation, incorporation in a commercial product, use in a commercial service, or production of other artefacts for commercial purposes.
+
+Without Volcano Engine's prior written permission, you shall not reproduce, modify, decompile, disassemble, reverse-engineer, or create derivative works of the AMK Editor SDK, nor access, extract, or obtain its source code by any means, or make it available in any form to any third party in any form. Any unauthorized modifications, derivative works, or adaptations of the AMK Editor SDK, along with all associated intellectual property rights, shall automatically and exclusively vest in Volcano Engine.
+
+Except otherwise provided by Volcano Engine, the AMK Editor SDK is provided “AS IS” without any warranties. Volcano Engine disclaims all liability for damages arising from its use.

package/README.md

@@ -0,0 +1,139 @@
+# @volcengine/amk-editor
+
+AMK 场景官方接入包：发布构建会内联底层编辑器运行时 UMD 与样式。公网业务方/demo **只需安装本包**，无需安装或访问内部编辑器包。弹层挂载使用 React 18/19 的 `createRoot`（兼容 React 19，不再使用已弃用的 `ReactDOM.render`）。
+
+## License
+
+AMK Editor SDK 是火山引擎 AI MediaKit 的商业配套软件。使用本 SDK 需要获得有效的火山引擎商业授权，具体条款参见 [LICENSE](./LICENSE)。商业授权咨询请联系 `service@volcengine.com`。
+
+本 SDK 使用的第三方开源组件仍分别适用其各自的许可证，第三方许可证不因本商业许可证而被替代。
+
+```ts
+import { AmkEditor } from '@volcengine/amk-editor';
+
+const editor = new AmkEditor({
+  container,
+  projectId: 'xxx',
+  endpoint: 'https://your-proxy.example.com',
+  getLicenseUrl: 'https://license.example.com',
+  material: {
+    // 本地上传：入参 File[]，返回 MaterialItem[]；每项必须带 source_material_id，不必传 material_id
+    onUploadMaterial: async files => [],
+    // URL 上传：入参 string[]（弹窗内逗号/换行分隔），返回契约同上
+    onUploadUrlMaterial: async urls => [],
+    onRefreshPlayInfo: async materials =>
+      materials.map(item => ({
+        material_id: item.material_id, // 仅用于匹配，不要改写
+        url: '...', // 业务方按自己字段映射
+        // 以下 key 名只是推荐示例；使用自定义字段时读取自己的字段即可。
+        poster: item.poster_storage_key ? 'https://signed-poster-url' : item.poster,
+        sprite: item.sprite_storage_keys
+          ? { ...item.sprite, storeurls: ['https://signed-sprite-url'] }
+          : item.sprite,
+      })),
+    // 抽帧临时链转存成长效地址（可选）；URL 和 key 会一起写回素材
+    onPersistExtractUrls: async ({ kind, urls, material }) => {
+      const result = await persistToBusinessStorage({ kind, urls, material });
+      return {
+        urls: result.urls,
+        // SDK 会把 materialPatch 原样合并并写回素材；字段名由业务决定。
+        materialPatch:
+          kind === 'poster'
+            ? { poster_storage_key: result.storageKeys[0] }
+            : { sprite_storage_keys: result.storageKeys },
+      };
+    },
+  },
+});
+
+// 两种上传返回素材后，SDK 统一：
+// 1. addSketchItems → 素材面板
+// 2. createAmkMaterials → POST 远端仓库，并把服务端返回的 material_id 记到面板
+// 3. ensureMaterialExtractTasks → 缺/过期 poster/sprite 时抽帧；临时链上屏后可后台转存再 PUT
+
+// 转存完成后素材会保存：
+// - poster + poster_storage_key（推荐字段，可自定义）
+// - sprite.storeurls + sprite_storage_keys（推荐字段，可自定义）
+// 下一次 onRefreshPlayInfo 会收到这些 key，业务可据此重新生成有时效的访问 URL。
+// SDK 不读取上述两个 key，也不把它们当作固定 Schema。业务也可以返回：
+// materialPatch: {
+//   biz_storage: { poster_key: '...', sprite_keys: ['...'] },
+// }
+// 只需在 onRefreshPlayInfo 中按同一套自定义结构读取即可。
+
+// 导出：invokeTool('vibe-editing-common', { edit_param, callback_args? })
+// 开启画质增强时附带 callback_args（JSON 字符串），供代理后续调增强：
+// - standard/professional → { tool:"enhance-video", tool_version, resolution, fps }
+// - large-model → { tool:"enhance-video-generative", resolution, fps }
+// SDK 不负责增强任务本身。
+
+// 工程会从 {endpoint}/api/v1/editing/projects/{projectId} 加载并自动保存。
+// 通用 MediaKit 工具仍通过 POST {endpoint}/api/v1/tools/{toolName} 调用。
+await editor.invokeTool({
+  toolName: 'asr-subtitles',
+  params: {
+    input: {
+      type: 'video',
+      url: 'https://example.com/demo.mp4',
+    },
+  },
+});
+```
+
+## 构建
+
+先构建 SDK，再构建本包：
+
+```bash
+pnpm build-veveditor
+pnpm --filter @volcengine/amk-editor run build
+```
+
+产物位于 `dist/index.js`（含 veveditor 运行时）与 `dist/veveditor.css`（样式 side-effect）。
+
+- `projectId` / `endpoint` 均为必传；鉴权密钥留在业务服务端，由 `endpoint` 代理注入
+- 发布包不声明底层编辑器为运行时依赖；底层编辑器和 `video-editor` 已在构建阶段内联到 `dist/index.js`，类型声明也不依赖内部包。
+- 发布前必须使用 `npm pack --dry-run` 检查 tarball；公网用户只需要能访问 npm 公网源和业务方提供的 `endpoint`。
+
+## Editing API 对接
+
+初始化时，AMK Editor 会组合以下接口：
+
+- `GET /api/v1/editing/projects/:project_id`
+- `GET /api/v1/editing/projects/:project_id/materials`
+- `GET /api/v1/editing/projects/:project_id/editor`
+
+编辑过程中按资源分别写回：
+
+- 标题变更：`PATCH /projects/:project_id`
+- 素材变更：`PUT/DELETE /projects/:project_id/materials`
+- 剪辑参数变更：`PUT /projects/:project_id/editor`
+
+Editor 保存携带服务端 `revision`，SDK 内部串行提交保存请求，避免同一页面内的并发保存互相覆盖。素材身份字段分工：
+
+- `source_material_id`：业务必填主键。POST / PUT 请求体、DELETE 都用它；DELETE body 为 `{ source_material_ids: string[] }`
+- `material_id`：Editing API 自己生成的服务端 id。业务方不用传，传了也不会入库；SDK 只在 POST 成功后把返回值记到面板，供轨道内部关联
+- `source`：VeVEditor 轨道 `Source` / 加密 vid 等资源标识。Editing API 请求体里的 `source` 是 origin url，与面板 `source` 不是同一语义
+
+服务端响应缺少 `source` 时，加载工程仅使用 `material_id` 作为 `source` fallback。
+
+浏览器不应持有 AMK API Key。`endpoint` 应指向业务代理，由代理向 Editing API 注入：
+
+```http
+Authorization: Bearer <AMK_API_KEY>
+```
+
+`amkeditordemo` 默认使用与 Editing API 契约一致的内存 mock。联调真实服务时，在启动 demo 的服务端环境设置：
+
+```bash
+EDITING_API_UPSTREAM='https://your-editing-api.example.com' \
+AMK_API_KEY='<your-api-key>' \
+VITE_AMK_PROJECT_ID='<existing-project-id>' \
+pnpm --dir packages/amkeditordemo/fe dev
+```
+
+卸载时销毁：
+
+```ts
+editor.destroy();
+```

package/dist/amk-editor.d.ts

@@ -0,0 +1,182 @@
+import './veveditor.css';
+import type { AmkEditorOptions, AmkProjectSnapshot, MaterialItem, VeVeditorInstance } from './types';
+import { type AmkI18nInstance } from './i18n';
+import { type AmkInvokeToolParams } from './api/client';
+export declare class AmkEditor {
+    private readonly options;
+    private config;
+    private readonly i18n;
+    private editor?;
+    private layout?;
+    private exportModal?;
+    private asrProgressModal?;
+    private confirmModal?;
+    private emptyTrackConfirmInFlight?;
+    private readonly apiClient;
+    private readonly ready;
+    private projectName?;
+    private editorRevision;
+    private projectHydrated;
+    private lastKnownTrack;
+    private intentionalEmptyTrackChange;
+    private emptyTrackSaveNeedsConfirmation;
+    private emptyTrackSaveBlocked;
+    private savedMaterials;
+    private saveQueue;
+    private pendingSaveCount;
+    private readonly asrPollingControllers;
+    /** 当前前台 ASR 会话；取消、关闭或销毁后直接丢弃，不写入工程 JSON。 */
+    private activeAsrElementId?;
+    /** 提交 ASR 前的同步锁，防止连点在任务创建前重复提交 */
+    private readonly asrStartingElementIds;
+    /** sprite 抽帧任务轮询：key = material_id / source */
+    private readonly spritePollingControllers;
+    /** 同一素材的封面/雪碧图转存结果串行写回，避免自定义字段互相覆盖。 */
+    private readonly materialPatchQueues;
+    /** 同一素材的 sprite 失败只处理一次，避免多个缩略图同时 403 重复建任务。 */
+    private readonly thumbnailErrorInFlight;
+    /** 前端抽帧封面缓存（不落盘）：key = materialKey，value = dataURL */
+    private readonly posterCache;
+    /** 同一 URL 的封面抽帧只执行一次，避免初始化与上传回调重复请求。 */
+    private readonly posterCaptureInFlight;
+    /** 销毁编辑器时中断尚未完成的前端抽帧或 AMK 首帧轮询。 */
+    private readonly posterCaptureControllers;
+    /** 启动时加载的内置预设资源，供编辑器面板和 ASR 字幕复用。 */
+    private presetLibrary;
+    private readonly handleTrackChanged;
+    private readonly handleEditParamChanged;
+    constructor(options: AmkEditorOptions);
+    /** 等待工程拉取 / canvas 校正 / 挂载完成 */
+    whenReady(): Promise<this>;
+    getEditor(): VeVeditorInstance | undefined;
+    getI18n(): AmkI18nInstance;
+    /** 通用工具调用：POST /api/v1/tools/{toolName} */
+    invokeTool<T = unknown>(options: AmkInvokeToolParams): Promise<T>;
+    /**
+     * 获取工程全量参数（materials + editParam + projectName）。
+     * 从 VeVeditor 当前素材/草稿快照读取；未挂载时回落内置拉取到的快照。
+     */
+    getProject(): AmkProjectSnapshot;
+    /**
+     * 刷新素材播放信息（按需触发，如播放前 / 初始化）。
+     * - 未配置 `material.onRefreshPlayInfo`：直接从当前素材库返回匹配项，不发请求
+     * - 配置后：把完整素材列表传给业务方，业务方返回要覆盖的字段（url / sprite / poster 等）
+     * @param materialIdOrIds 单个 material_id、material_id 列表；省略则刷新当前全部有 material_id 的素材
+     */
+    refreshPlayInfo(materialIdOrIds?: string | string[]): Promise<MaterialItem | MaterialItem[] | undefined>;
+    private bootstrap;
+    /** 内置拉取工程：project + materials + editor → 归一化 → 组装 initialData。 */
+    private resolveAndApplyProject;
+    /**
+     * 初始化时批量 refresh 素材（完整素材列表交给业务方），
+     * 再把轨道元素里的 URL 回填到最新值，完成后回写 editor 文档。
+     */
+    private refreshProjectOnInit;
+    private resolveAndApplyPresetLibrary;
+    mount(): VeVeditorInstance;
+    destroy(): void;
+    private resolveConfig;
+    /** 与 VeVeditor 同一套顶层扁平资源字段：boolean 面板开关 + 内部 xgplayer 组装 */
+    private resolveVeVeditorOptions;
+    private resolveInternalConfig;
+    private enqueueSave;
+    private queueProjectNameSave;
+    /**
+     * VeVeditor 删除前置钩子：远端删除成功后返回 true，底层才清理本地素材和轨道；
+     * 请求失败返回 false，保留当前素材。
+     */
+    private deleteMaterial;
+    private queueEditorSave;
+    private confirmAbnormalEmptyTrackSave;
+    private enqueueEditorSaveWithCurrentEditParam;
+    /**
+     * AMK 内部导出入口。
+     * 适配只作用于即将提交给导出接口的 editParam 副本，不写回工程或当前预览。
+     */
+    private submitExport;
+    private attach;
+    private detach;
+    private clearAsrPollingTimers;
+    private isAsrMediaElement;
+    /** 前台 ASR 弹窗打开期间，只允许当前素材对应的一个任务运行。 */
+    private isAsrBusy;
+    private cancelActiveAsrTask;
+    private completeAsrTask;
+    private createId;
+    private getTrackSnapshot;
+    private setTrackSnapshot;
+    private findTrackElementIndexById;
+    private resolveAsrMediaUrl;
+    private extractTaskId;
+    private submitAsrTask;
+    private queryAsrTask;
+    private isTaskCompleted;
+    private isTaskFailed;
+    private extractUtterances;
+    private normalizeAsrRange;
+    private resolveAsrTimelineMapping;
+    private createAsrTextElement;
+    private finishAsrAndCreateTextTrack;
+    private startAsrPolling;
+    private startAsrTask;
+    /**
+     * 本地 / URL 上传入库后的统一收口：
+     * POST 远端素材库 → 按 sprite/poster 判断发起抽帧并 PUT 更新。
+     */
+    private ingestImportedMaterials;
+    /**
+     * 本地上传 / URL 上传完成后，将新素材 POST 到 Editing API。
+     * addSketchItems 已写入面板；此处确保远端持久化，并把 Editing API
+     * 返回的 material_id 记到面板（业务不用传这个字段；不覆盖本地 source / kid / 预览字段）。
+     */
+    private persistUploadedMaterials;
+    private isHttpUrl;
+    private resolveDisplayPoster;
+    private withDisplayPosters;
+    private blobToDataUrl;
+    /** AMK 视频抽帧：指定第 0 帧并轮询任务结果。 */
+    private captureVideoPosterFromAmk;
+    /** 前端 Range + WebCodecs 解第一张同步帧。 */
+    private captureVideoPosterFromFrontend;
+    private isThumbnailFrontendDecodeEnabled;
+    /**
+     * 封面只做运行时刷新，不写素材/工程：
+     * - enableThumbnailDecode=true：优先前端 Range + WebCodecs，失败再 AMK 第 0 帧兜底
+     * - 默认 false：只走 AMK SpecifiedFrames 第 0 帧接口
+     */
+    private captureVideoPosterFromUrl;
+    /**
+     * 抽帧临时 http 转存；失败回落临时链。
+     * 调用方应先上屏临时链，再后台调用本方法换链。
+     */
+    private persistExtractUrls;
+    /**
+     * 后台转存：临时链已上屏/落盘后，换成长效地址再 PUT + 刷新面板。
+     * 未配置回调、转存失败或结果未变时不二次写盘。
+     */
+    private schedulePersistExtractUrlsAndSwap;
+    /**
+     * 统一入口：初始化 / 本地上传 / URL 上传拿到素材后，按 sprite/poster 判断是否抽帧。
+     * - sprite / poster 缺失或 auth_key 过期：重新抽帧
+     * - http 结果：先临时链上屏/PUT；若配置 onPersistExtractUrls 则后台转存换链
+     * - 前端 dataURL 不落盘
+     * - enableThumbnailDecode=true：跳过 sprite 接口，封面优先前端解码
+     */
+    private ensureMaterialExtractTasks;
+    private createExtractFramesTask;
+    private startSpritePolling;
+    private buildSpriteFromExtractResult;
+    private extractFirstSnapshotUrl;
+    /**
+     * 时间轴 sprite 真实请求失败后的兜底：不解析 URL 的签名格式，直接以 Image.onerror 为准。
+     * 先让业务通过 onRefreshPlayInfo 更新素材；刷新后仍没有新的 sprite，再重新抽帧。
+     */
+    private handleThumbnailError;
+    private findMaterialByKey;
+    private applyMaterialToPanel;
+    private enqueueMaterialPatch;
+    private patchMaterialRemote;
+    private clearSpriteTimer;
+    private clearSpritePollingTimers;
+}
+export declare function createAmkEditor(options: AmkEditorOptions): AmkEditor;

package/dist/api/client.d.ts

@@ -0,0 +1,30 @@
+export type AmkApiClientOptions = {
+    endpoint: string;
+};
+export type AmkInvokeToolParams = {
+    toolName: string;
+    params?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+};
+export declare class AmkApiClient {
+    private readonly baseUrl;
+    constructor(options: AmkApiClientOptions);
+    getBaseUrl(): string;
+    invokeTool<T = unknown>(options: AmkInvokeToolParams): Promise<T>;
+    /**
+     * 查询异步任务：GET /api/v1/tasks/{task_id}
+     * @see https://docs.volcengine.com/docs/6448/2278532
+     */
+    getTask<T = unknown>(taskId: string, options?: {
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    requestJson<T = unknown>(path: string, options?: {
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        headers?: Record<string, string>;
+        body?: unknown;
+        signal?: AbortSignal;
+    }): Promise<T>;
+}
+export declare function createAmkApiClient(options: AmkApiClientOptions): AmkApiClient;

package/dist/api/preset-library.d.ts

@@ -0,0 +1,11 @@
+import type { AmkApiClient } from './client';
+export type PresetLibraryResourceKey = 'effects' | 'fonts' | 'word_arts' | 'filters' | 'transitions' | 'text_enter_animations' | 'text_out_animations' | 'text_loop_animations';
+export type PresetLibraryItem = {
+    id: string;
+    name: string;
+    icon_url: string;
+    package_url: string;
+    default?: boolean;
+};
+export type PresetLibrary = Partial<Record<PresetLibraryResourceKey, PresetLibraryItem[]>>;
+export declare function fetchPresetLibrary(client: Pick<AmkApiClient, 'requestJson'>, resources: PresetLibraryResourceKey[]): Promise<PresetLibrary>;

package/dist/api/project.d.ts

@@ -0,0 +1,30 @@
+import type { AmkApiClient } from './client';
+import type { AmkProjectSnapshot, MaterialItem } from '../types';
+type EditingApiClient = Pick<AmkApiClient, 'requestJson'>;
+export type LoadedAmkProject = AmkProjectSnapshot & {
+    editorRevision: number;
+};
+export type SavedAmkEditor = {
+    revision: number;
+    editParam: Record<string, unknown>;
+};
+export declare function fetchAmkProject(client: EditingApiClient, projectId: string): Promise<LoadedAmkProject>;
+export declare function updateAmkProjectName(client: EditingApiClient, projectId: string, projectName: string): Promise<void>;
+/**
+ * POST 一批新素材到 AMK 工程。
+ * POST 语义：已存在报错，不存在新增；用于上传新素材入库。
+ * 请求只带业务 source_material_id；返回值里的 material_id 由 Editing API 生成。
+ */
+export declare function createAmkMaterials(client: EditingApiClient, projectId: string, materials: MaterialItem[]): Promise<MaterialItem[]>;
+/**
+ * Upsert（PUT）一批素材到 AMK 工程。
+ * PUT 语义：已存在覆盖，不存在新增；适合本地上传/URL上传完成后写回。
+ */
+export declare function upsertAmkMaterials(client: EditingApiClient, projectId: string, materials: MaterialItem[]): Promise<void>;
+/**
+ * 删除 AMK 工程素材。Editing API DELETE body 为 source_material_ids，
+ * 值为业务 source_material_id；这里统一按 100 条分批。
+ */
+export declare function deleteAmkMaterials(client: EditingApiClient, projectId: string, materials: MaterialItem | MaterialItem[]): Promise<void>;
+export declare function saveAmkEditor(client: EditingApiClient, projectId: string, editParam: Record<string, unknown>, revision: number): Promise<SavedAmkEditor>;
+export {};

package/dist/asr-progress-modal-view.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { AmkI18nInstance } from './i18n';
+export interface AsrProgressModalViewProps {
+    visible: boolean;
+    t: AmkI18nInstance['t'];
+    onCancel: () => void;
+}
+export declare function AsrProgressModalView({ visible, t, onCancel, }: AsrProgressModalViewProps): React.ReactElement;

package/dist/asr-progress-modal.d.ts

@@ -0,0 +1,11 @@
+import type { AmkI18nInstance } from './i18n';
+export interface AsrProgressModalController {
+    open: () => void;
+    close: () => void;
+    destroy: () => void;
+}
+export declare function createAsrProgressModal(options: {
+    container: HTMLElement;
+    t: AmkI18nInstance['t'];
+    onCancel: () => void;
+}): AsrProgressModalController;

package/dist/asr-text-layout.d.ts

@@ -0,0 +1,4 @@
+/**
+ * ASR 字幕字号随画布宽度等比缩放：1080px 画布对应 80px 字号，上限 100。
+ */
+export declare function resolveAsrFontSize(canvasWidth: number): number;

package/dist/assets/import-local.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M1.5 7.93855V7.38461C1.5 7.19344 1.65498 7.03846 1.84615 7.03846C2.03733 7.03846 2.19231 7.19344 2.19231 7.38461V7.93855C2.19231 8.33194 2.19244 8.6062 2.20989 8.81971C2.227 9.02917 2.259 9.14953 2.30544 9.24068C2.405 9.43608 2.56392 9.595 2.75932 9.69456C2.85047 9.741 2.97083 9.773 3.18029 9.79011C3.39379 9.80756 3.66806 9.80769 4.06145 9.80769H7.93855C8.33194 9.80769 8.60621 9.80756 8.81971 9.79011C9.02917 9.773 9.14953 9.741 9.24068 9.69456C9.43608 9.595 9.595 9.43608 9.69456 9.24068C9.741 9.14953 9.773 9.02917 9.79011 8.81971C9.80756 8.6062 9.80769 8.33194 9.80769 7.93855V7.38461C9.80769 7.19344 9.96267 7.03846 10.1538 7.03846C10.345 7.03846 10.5 7.19344 10.5 7.38461V7.93855C10.5 8.32051 10.5004 8.62782 10.4802 8.87605C10.4596 9.12833 10.4156 9.34982 10.3111 9.55484C10.1452 9.8805 9.8805 10.1452 9.55484 10.3111C9.34982 10.4156 9.12833 10.4596 8.87605 10.4802C8.62782 10.5004 8.32051 10.5 7.93855 10.5H4.06145C3.67949 10.5 3.37218 10.5004 3.12395 10.4802C2.87167 10.4596 2.65018 10.4156 2.44516 10.3111C2.1195 10.1452 1.85479 9.8805 1.68885 9.55484C1.5844 9.34982 1.54044 9.12833 1.51983 8.87605C1.49955 8.62782 1.5 8.32051 1.5 7.93855ZM5.65385 7.38461V2.68179L3.93705 4.39859C3.80187 4.53377 3.58275 4.53377 3.44757 4.39859C3.31239 4.26341 3.31239 4.04429 3.44757 3.9091L5.75526 1.60141L5.80799 1.55814C5.86444 1.52051 5.93116 1.5 6 1.5C6.09181 1.5 6.17983 1.5365 6.24474 1.60141L8.55243 3.9091C8.68761 4.04429 8.68761 4.26341 8.55243 4.39859C8.41725 4.53377 8.19813 4.53377 8.06295 4.39859L6.34615 2.68179V7.38461C6.34615 7.57579 6.19117 7.73077 6 7.73077C5.80882 7.73077 5.65385 7.57579 5.65385 7.38461Z" fill="#595863" stroke="#595863" stroke-width="0.2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/assets/import-url.svg

@@ -0,0 +1,10 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_0_10)">
+<path d="M6.35378 9.18196L5.64667 9.88907C4.67036 10.8654 3.08745 10.8654 2.11114 9.88907C1.13483 8.91276 1.13483 7.32985 2.11114 6.35354L2.81825 5.64643M9.18221 6.35354L9.88931 5.64643C10.8656 4.67012 10.8656 3.08721 9.88931 2.1109C8.913 1.13458 7.33009 1.13458 6.35378 2.1109L5.64667 2.818M4.25023 7.74997L7.75023 4.24997" stroke="#595863" stroke-linecap="round" stroke-linejoin="round"/>
+</g>
+<defs>
+<clipPath id="clip0_0_10">
+<rect width="12" height="12" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/confirm-modal-view.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { AmkI18nInstance } from './i18n';
+export interface ConfirmModalViewProps {
+    visible: boolean;
+    title: string;
+    desc: string;
+    theme?: 'light' | 'dark';
+    t: AmkI18nInstance['t'];
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+/**
+ * 对齐 VeVeditor 节点报错弹窗（EditorErrorDialog）的居中 Modal 结构与按钮层级。
+ */
+export declare function ConfirmModalView({ visible, title, desc, theme, t, onConfirm, onCancel, }: ConfirmModalViewProps): React.ReactElement;

package/dist/confirm-modal.d.ts

@@ -0,0 +1,14 @@
+import type { AmkI18nInstance } from './i18n';
+export interface ConfirmModalAskOptions {
+    title: string;
+    desc: string;
+    theme?: 'light' | 'dark';
+}
+export interface ConfirmModalController {
+    ask: (options: ConfirmModalAskOptions) => Promise<boolean>;
+    destroy: () => void;
+}
+export declare function createConfirmModal(options: {
+    container: HTMLElement;
+    t: AmkI18nInstance['t'];
+}): ConfirmModalController;

package/dist/export-modal-view.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ExportVideoParams } from './types';
+import type { AmkI18nInstance } from './i18n';
+export interface ExportModalViewProps {
+    videoName: string;
+    visible: boolean;
+    t: AmkI18nInstance['t'];
+    onConfirm: (params: ExportVideoParams) => Promise<void> | void;
+    onClose: () => void;
+}
+export declare function ExportModalView({ videoName, visible, t, onConfirm, onClose, }: ExportModalViewProps): React.ReactElement;

package/dist/export-modal.d.ts

@@ -0,0 +1,46 @@
+import type { ExportVideoParams } from './types';
+import type { AmkI18nInstance } from './i18n';
+export interface CreateExportModalOptions {
+    container: HTMLElement;
+    videoName: string;
+    onConfirm: (params: ExportVideoParams) => Promise<void> | void;
+    t?: AmkI18nInstance['t'];
+}
+export interface ExportModalController {
+    open: () => void;
+    close: () => void;
+    destroy: () => void;
+}
+type SelectOption<T extends string> = {
+    label: string;
+    value: T;
+};
+/** @deprecated 使用 AMK_I18N_KEYS.export.qualityTooltip + t() */
+export declare const QUALITY_TOOLTIP = "AI MediaKit \u753B\u8D28\u589E\u5F3A\u96C6\u6210\u667A\u80FD\u8D85\u5206\u3001\u63D2\u5E27\u3001\u753B\u9762\u589E\u5F3A\u3001\u81EA\u9002\u5E94\u9510\u5316\u3001\u8272\u5F69\u589E\u5F3A\u7B49 30+ \u9AD8\u8D28\u91CF\u7B97\u6CD5\uFF0C\u7ED3\u5408\u81EA\u7814\u89C6\u9891\u5185\u5BB9\u7406\u89E3\u4E0E\u667A\u80FD\u8C03\u5EA6\uFF0C\u6309\u573A\u666F\u81EA\u52A8\u62E9\u4F18\u8C03\u7528\uFF0C\u5168\u9762\u63D0\u5347\u89C6\u9891\u753B\u8D28\u3002";
+export declare function getBaseResolutions(t: AmkI18nInstance['t']): SelectOption<ExportVideoParams['resolution']>[];
+/** 画质增强开启后的分辨率：不含原画；大模型版不含 4K */
+export declare function getEnhancedResolutions(t: AmkI18nInstance['t'], enhancementVersion?: ExportVideoParams['enhancementVersion']): SelectOption<ExportVideoParams['resolution']>[];
+/** 当前模式下合法分辨率；非法时回落到默认项 */
+export declare function normalizeExportResolution(params: Pick<ExportVideoParams, 'qualityEnhancement' | 'enhancementVersion' | 'resolution'>, t?: AmkI18nInstance['t']): ExportVideoParams['resolution'];
+export declare function getEnhancementVersions(t: AmkI18nInstance['t']): SelectOption<ExportVideoParams['enhancementVersion']>[];
+export declare const BASE_FORMATS: SelectOption<ExportVideoParams['format']>[];
+export declare const BASE_CODECS: SelectOption<ExportVideoParams['codec']>[];
+export declare const AUDIO_CODECS: SelectOption<ExportVideoParams['codec']>[];
+/** 按导出格式返回编码下拉选项；画质增强开启时仅保留 H264。 */
+export declare function getCodecOptions(format: ExportVideoParams['format'], enhanced: boolean): SelectOption<ExportVideoParams['codec']>[];
+/** 保证 codec 与 format 一致：MP3 固定 mp3，MP4 回落到合法视频编码。 */
+export declare function normalizeExportCodec(params: Pick<ExportVideoParams, 'format' | 'codec'>): ExportVideoParams['codec'];
+export declare function applyExportFormatChange(current: ExportVideoParams, format: ExportVideoParams['format']): ExportVideoParams;
+/** 兼容旧测试/调用方：中文默认标签 */
+export declare const BASE_RESOLUTIONS: SelectOption<"original" | "720p" | "1080p" | "2k" | "4k">[];
+export declare const ENHANCED_RESOLUTIONS: SelectOption<"original" | "720p" | "1080p" | "2k" | "4k">[];
+export declare const ENHANCEMENT_VERSIONS: SelectOption<"standard" | "professional" | "large-model">[];
+export declare function createDefaultExportVideoParams(videoName: string): ExportVideoParams;
+/** 导出帧率合法区间（含端点） */
+export declare const EXPORT_FRAME_RATE_MIN = 15;
+export declare const EXPORT_FRAME_RATE_MAX = 120;
+/** 将导出帧率钳制到 15～120；非法输入回落 30 */
+export declare function normalizeExportFrameRate(frameRate: unknown): number;
+export declare function toggleQualityEnhancement(params: ExportVideoParams, enabled: boolean): ExportVideoParams;
+export declare function createExportModal(options: CreateExportModalOptions): ExportModalController;
+export {};

package/dist/export-project-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { ExportVideoParams } from './types';
+/**
+ * 开启画质增强时，把增强任务参数交给代理层（callback_args，JSON 字符串）。
+ * - large-model → POST .../tools/enhance-video-generative
+ * - standard / professional → POST .../tools/enhance-video，带 tool_version
+ * video_url 由代理在导出完成后再填；关闭增强时返回 undefined。
+ */
+export declare function buildExportCallbackArgs(params: Pick<ExportVideoParams, 'qualityEnhancement' | 'enhancementVersion' | 'resolution' | 'frameRate'>): string | undefined;
+/**
+ * 临时导出兜底：
+ * 根据目标分辨率短边等比缩放 Canvas、Track 元素和 Extra。
+ * 只返回导出副本，不修改编辑器内部工程；服务端支持后可整文件删除。
+ */
+export declare function adaptEditParamForExport(editParam: Record<string, unknown>, params: Pick<ExportVideoParams, 'resolution' | 'format' | 'frameRate' | 'codec'>): Record<string, unknown>;

package/dist/header.d.ts

@@ -0,0 +1,29 @@
+import type { AmkI18nInstance } from './i18n';
+export interface ResolveHeaderTitleOptions {
+    /** initialData.projectName / getProject.projectName */
+    projectName?: string;
+    t?: AmkI18nInstance['t'];
+}
+export interface CreateAmkEditorLayoutOptions {
+    container: HTMLElement;
+    title: string;
+    theme?: 'light' | 'dark';
+    showHeader: boolean;
+    onExport: () => void;
+    /** 传入则展示返回按钮 */
+    onBack?: () => void;
+    /** 传入则展示关闭按钮 */
+    onClose?: () => void;
+    onTitleSubmit?: (title: string) => void;
+    t?: AmkI18nInstance['t'];
+}
+export type AmkSaveStatus = 'saving' | 'saved';
+export interface AmkEditorLayout {
+    root: HTMLDivElement;
+    workspace: HTMLDivElement;
+    setSaveStatus: (status: AmkSaveStatus) => void;
+    destroy: () => void;
+}
+export declare function resolveHeaderTitle(options: ResolveHeaderTitleOptions): string;
+export declare function validateHeaderTitle(title: string, t?: AmkI18nInstance['t']): string | undefined;
+export declare function createAmkEditorLayout(options: CreateAmkEditorLayoutOptions): AmkEditorLayout;

package/dist/i18n/index.d.ts

@@ -0,0 +1,17 @@
+export type Locale = string;
+export type Messages = Record<string, string>;
+export type LocaleMessages = Record<Locale, Messages>;
+export interface AmkI18nOptions {
+    locale?: Locale;
+    messages?: LocaleMessages;
+    messageOverrides?: Messages;
+}
+export interface AmkI18nInstance {
+    t: (key: string, params?: Record<string, any>, fallback?: string) => string;
+    getLocale: () => Locale;
+}
+export declare function createAmkI18n(options?: AmkI18nOptions): AmkI18nInstance;
+export declare function setGlobalAmkI18n(i18n: AmkI18nInstance): void;
+export declare function getGlobalAmkI18n(): AmkI18nInstance | null;
+export declare function tAmk(key: string, params?: Record<string, any>, fallback?: string): string;
+export { AMK_I18N_KEYS } from './keys';