@volcengine/amk-editor 0.0.2-beta.0 → 0.0.2-beta.1

package/dist/local-upload-modal.d.ts

@@ -6,7 +6,7 @@ export interface CreateLocalUploadModalOptions {
     onConfirm: (files: File[]) => void;
 }
 export interface LocalUploadModalController {
-    open: (files: File[]) => void;
+    open: (files?: File[]) => void;
     close: () => void;
     destroy: () => void;
 }

package/dist/types.d.ts

@@ -16,6 +16,13 @@ export type SystemMaterialItem = Omit<Partial<MaterialItem>, 'source_material_id
     type: NonNullable<MaterialItem['type']>;
     name?: string;
 };
+/** 可由外部工具栏复用的素材导入入口。 */
+export type AmkMaterialImportType = 'local' | 'url' | 'system';
+/** Optional callbacks scoped to one externally triggered material import. */
+export interface AmkMaterialImportRequestOptions {
+    /** Called with persisted materials only for this request. */
+    onMaterialsImported?: (materials: MaterialItem[]) => void | Promise<void>;
+}
 /**
  * 抽帧产物存储 key 的推荐命名，仅用于提供接入提示，不属于强制素材 Schema。
  * 业务可以直接使用这两个字段，也可以把 key 放进任意自定义字段或嵌套对象。
@@ -46,6 +53,11 @@ export interface MaterialConfig {
      * 返回 `undefined` / `null` / `[]` 视为取消或未选择，不提示失败。
      */
     onUploadFromSystem?: () => Promise<SystemMaterialItem[] | undefined | null> | SystemMaterialItem[] | undefined | null;
+    /**
+     * 素材成功入库后回调（已合并 Editing API 返回的 `material_id`）。
+     * 本地 / URL / 资产库三条导入链路都会走到这里；失败或用户取消不会触发。
+     */
+    onMaterialsImported?: (materials: MaterialItem[]) => void | Promise<void>;
     /**
      * 刷新播放信息。未配置时用素材库已有字段；
      * 配置后：入参为待刷新素材列表（按服务端 material_id 区分，支持批量），
@@ -67,10 +79,22 @@ export interface MaterialConfig {
         material: MaterialItem;
     }) => Promise<PersistExtractUrlsResult | string[]> | PersistExtractUrlsResult | string[];
 }
+export interface AmkEditorHeaderTitleUpdateSuccess {
+    readonly projectId: string;
+    /** Project title persisted successfully by the Editing API. */
+    readonly title: string;
+}
 export interface AmkEditorHeaderConfig {
     show?: boolean;
+    /**
+     * When set, the header is rendered into this element instead of inside the
+     * editor root. Use this to place a full-width header above a host split layout.
+     */
+    mount?: HTMLElement;
     onBack?: () => void;
     onClose?: () => void;
+    /** Fired only after the project title is persisted successfully. */
+    onTitleUpdateSuccess?: (change: AmkEditorHeaderTitleUpdateSuccess) => void;
 }
 export interface AmkEditorExportConfig {
     /**
@@ -181,16 +205,14 @@ type AmkResourceOptionTypes = {
 };
 type AmkInheritedVeVeditorOptions = Omit<VeVeditorOptions<MaterialConfig, VeVeditorI18nOptions, AmkResourceOptionTypes>, 'initialData' | 'recording' | 'onSketchItemsChange' | 'onNodePreviewError' | 'onPreviewNodeRefresh' | 'onBeforeUndo' | 'onBeforeRedo' | 'onBeforeTimestampMount' | 'onBeforeKeyframeMount' | 'onTrackChanged' | 'onRecordingUpload' | 'decode'>;
 export type AmkEditorDecodeOptions = VeVeditorDecodeOptions;
-/** 客户业务代理的浏览器侧鉴权配置。SDK 不约定鉴权协议，仅透传接入方返回的请求头。 */
-export interface AmkEditorAuthConfig {
-    getHeaders: () => Record<string, string> | undefined | Promise<Record<string, string> | undefined>;
-}
+/** 每次 AMK 请求前动态获取、原样透传给 endpoint 的业务请求头。 */
+export type AmkEditorGetHeaders = () => Readonly<Record<string, string>> | undefined | Promise<Readonly<Record<string, string>> | undefined>;
 export interface AmkEditorOptions extends AmkInheritedVeVeditorOptions {
     projectId: string;
     /** AMK Editing API 的业务代理地址。 */
     endpoint: string;
-    /** 可选：返回访问客户业务代理所需的自定义请求头。 */
-    auth?: AmkEditorAuthConfig;
+    /** 每次请求前调用；返回值不解析、不改写，仅透传给 endpoint。 */
+    getHeaders?: AmkEditorGetHeaders;
     header?: AmkEditorHeaderConfig;
     export?: AmkEditorExportConfig;
     getLicenseUrl?: string | (() => string | Promise<string>);