@bylqwjc/media-editor-react 1.0.12

package/node_modules/@media-editor/core/dist/browser.d.cts

@@ -0,0 +1,100 @@
+import { O as OverlayT, V as VideoEditStateT } from './state-B85vkf7_.cjs';
+import { VideoEditorEngine } from './engine.cjs';
+import 'zod';
+
+/**
+ * editor-core/overlay-render —— 标注/贴纸绘制(浏览器环境,Canvas API;零框架依赖)。
+ * 交互画布与导出 PNG 共用 drawOverlays,保证所见即所得。
+ * 坐标系 = 最终输出空间(旋转/裁剪/缩放后),导出 PNG 即按输出分辨率渲染。
+ */
+
+declare function getOverlayRotation(o: OverlayT): number;
+declare function overlayBBox(o: OverlayT): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** 单个对象绘制;sticker 的位图经 imageCache 提供(加载由调用方负责) */
+declare function drawOverlay(ctx: CanvasRenderingContext2D, o: OverlayT, imageCache?: Map<string, HTMLImageElement>): void;
+declare function drawOverlays(ctx: CanvasRenderingContext2D, overlays: OverlayT[], imageCache?: Map<string, HTMLImageElement>): void;
+/** sticker 位图预加载(dataURL → HTMLImageElement) */
+declare function loadOverlayImages(overlays: OverlayT[]): Promise<Map<string, HTMLImageElement>>;
+/** 导出:把 overlays 渲染成输出分辨率的透明 PNG Blob(无 overlay 返回 null) */
+declare function renderOverlaysToPng(overlays: OverlayT[] | undefined, width: number, height: number): Promise<Blob | null>;
+/** 命中检测(选中/拖动用):返回最上层命中的 overlay 下标,无命中 -1 */
+declare function hitTestOverlay(overlays: OverlayT[], x: number, y: number, tolerance?: number): number;
+/**
+ * 贴纸图片等比落盒:长边 = boxSide、短边按原始宽高比,下限 8px。
+ * 上传任意比例图片不再被压成正方形(drawImage 是拉伸语义,入库 w/h 必须等比)。
+ */
+declare function fitStickerBox(natW: number, natH: number, boxSide: number): {
+    w: number;
+    h: number;
+};
+/**
+ * 缩放 overlay(选中后拖右下角把手):以对象左上角为锚,按 ratio 等比。
+ * sticker/rect/ellipse 改 w/h;text 改 fontSize;pen/line/arrow 不支持(原样返回)。
+ */
+declare function scaleOverlay(o: OverlayT, ratio: number): OverlayT;
+/** 旋转 overlay:以对象 bbox 中心为视觉锚点;坐标本身不变,绘制/命中检测按 rotation 处理。 */
+declare function rotateOverlay(o: OverlayT, deg: number): OverlayT;
+/** 平移 overlay(拖动选中对象) */
+declare function translateOverlay(o: OverlayT, dx: number, dy: number): OverlayT;
+
+/**
+ * 把引擎导出计划 + 浏览器端 File 组装成服务端约定的 FormData
+ * (video_0../audio_0../overlay/editState),供 @media-editor/client.exportVideo 直接发。
+ * 触碰 DOM(overlay → canvas PNG),故归 @media-editor/core/browser,React/Vue 共用。
+ */
+
+/**
+ * @param videoFiles 以「原始 srcIdx」为下标的视频 File 数组(引擎按 videoSrcOrder 取并重排)
+ * @param audioFiles 同上(音频)
+ */
+declare function buildVideoExportFormData(engine: VideoEditorEngine, videoFiles: ReadonlyArray<File | undefined>, audioFiles?: ReadonlyArray<File | undefined>): Promise<FormData>;
+
+/**
+ * 帧合成器(框架无关 canvas)—— 把「源帧 → 输出画布 + 完整效果链 + overlays」绘到 canvas。
+ * 从 SocialEcho VideoFramePreview.drawFinalFrame 抽出,供实时预览与封面导出复用。
+ *
+ * 效果链与 ffmpeg 导出严格同构:源→画布 cover 归一 → flips → rotate → crop → scale + 调色/滤镜 css。
+ */
+
+/** drawImage 可接受的源(video / image / canvas) */
+type FrameSource = CanvasImageSource;
+/**
+ * 把一帧合成绘到 canvas(物理分辨率 = 输出尺寸 × k)。
+ * @param srcDims 活动源原始分辨率(逐片段可能不同)
+ * @param canvasDims 输出画布(= 首素材分辨率),全局效果链的「源 dims」
+ * @param k 物理像素倍率(预览用 ≤1 控带宽,封面导出用 1 全分辨率)
+ * @param imageCache 贴纸图片缓存(loadOverlayImages 产出)
+ */
+declare function drawVideoFrame(canvas: HTMLCanvasElement, source: FrameSource, srcDims: {
+    w: number;
+    h: number;
+}, canvasDims: {
+    w: number;
+    h: number;
+}, state: VideoEditStateT, k?: number, imageCache?: Map<string, HTMLImageElement>, withOverlays?: boolean): void;
+/**
+ * 抽 count 张等距缩略图(dataURL,jpeg)。供时间轴缩略图条 / 封面条。
+ * 传入**专用离屏 video 元素**(勿用主预览源,seek 会打断播放)。
+ */
+declare function generateThumbnails(videoEl: HTMLVideoElement, count: number, maxW?: number): Promise<string[]>;
+
+/**
+ * 全屏切换按钮(框架无关 DOM)。点按对 host 进/出全屏;监听 fullscreenchange 切图标和 host 状态类。
+ * 图片/视频 mount 共用:默认可作为覆盖按钮,也可放进宿主自己的返回工具栏。
+ */
+interface FullscreenToggle {
+    button: HTMLButtonElement;
+    dispose: () => void;
+}
+interface FullscreenToggleOptions {
+    mode?: 'overlay' | 'inline';
+    className?: string;
+}
+declare function createFullscreenToggle(host: HTMLElement, options?: FullscreenToggleOptions): FullscreenToggle;
+
+export { type FrameSource, type FullscreenToggle, type FullscreenToggleOptions, buildVideoExportFormData, createFullscreenToggle, drawOverlay, drawOverlays, drawVideoFrame, fitStickerBox, generateThumbnails, getOverlayRotation, hitTestOverlay, loadOverlayImages, overlayBBox, renderOverlaysToPng, rotateOverlay, scaleOverlay, translateOverlay };

package/node_modules/@media-editor/core/dist/browser.d.ts

@@ -0,0 +1,100 @@
+import { O as OverlayT, V as VideoEditStateT } from './state-B85vkf7_.js';
+import { VideoEditorEngine } from './engine.js';
+import 'zod';
+
+/**
+ * editor-core/overlay-render —— 标注/贴纸绘制(浏览器环境,Canvas API;零框架依赖)。
+ * 交互画布与导出 PNG 共用 drawOverlays,保证所见即所得。
+ * 坐标系 = 最终输出空间(旋转/裁剪/缩放后),导出 PNG 即按输出分辨率渲染。
+ */
+
+declare function getOverlayRotation(o: OverlayT): number;
+declare function overlayBBox(o: OverlayT): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** 单个对象绘制;sticker 的位图经 imageCache 提供(加载由调用方负责) */
+declare function drawOverlay(ctx: CanvasRenderingContext2D, o: OverlayT, imageCache?: Map<string, HTMLImageElement>): void;
+declare function drawOverlays(ctx: CanvasRenderingContext2D, overlays: OverlayT[], imageCache?: Map<string, HTMLImageElement>): void;
+/** sticker 位图预加载(dataURL → HTMLImageElement) */
+declare function loadOverlayImages(overlays: OverlayT[]): Promise<Map<string, HTMLImageElement>>;
+/** 导出:把 overlays 渲染成输出分辨率的透明 PNG Blob(无 overlay 返回 null) */
+declare function renderOverlaysToPng(overlays: OverlayT[] | undefined, width: number, height: number): Promise<Blob | null>;
+/** 命中检测(选中/拖动用):返回最上层命中的 overlay 下标,无命中 -1 */
+declare function hitTestOverlay(overlays: OverlayT[], x: number, y: number, tolerance?: number): number;
+/**
+ * 贴纸图片等比落盒:长边 = boxSide、短边按原始宽高比,下限 8px。
+ * 上传任意比例图片不再被压成正方形(drawImage 是拉伸语义,入库 w/h 必须等比)。
+ */
+declare function fitStickerBox(natW: number, natH: number, boxSide: number): {
+    w: number;
+    h: number;
+};
+/**
+ * 缩放 overlay(选中后拖右下角把手):以对象左上角为锚,按 ratio 等比。
+ * sticker/rect/ellipse 改 w/h;text 改 fontSize;pen/line/arrow 不支持(原样返回)。
+ */
+declare function scaleOverlay(o: OverlayT, ratio: number): OverlayT;
+/** 旋转 overlay:以对象 bbox 中心为视觉锚点;坐标本身不变,绘制/命中检测按 rotation 处理。 */
+declare function rotateOverlay(o: OverlayT, deg: number): OverlayT;
+/** 平移 overlay(拖动选中对象) */
+declare function translateOverlay(o: OverlayT, dx: number, dy: number): OverlayT;
+
+/**
+ * 把引擎导出计划 + 浏览器端 File 组装成服务端约定的 FormData
+ * (video_0../audio_0../overlay/editState),供 @media-editor/client.exportVideo 直接发。
+ * 触碰 DOM(overlay → canvas PNG),故归 @media-editor/core/browser,React/Vue 共用。
+ */
+
+/**
+ * @param videoFiles 以「原始 srcIdx」为下标的视频 File 数组(引擎按 videoSrcOrder 取并重排)
+ * @param audioFiles 同上(音频)
+ */
+declare function buildVideoExportFormData(engine: VideoEditorEngine, videoFiles: ReadonlyArray<File | undefined>, audioFiles?: ReadonlyArray<File | undefined>): Promise<FormData>;
+
+/**
+ * 帧合成器(框架无关 canvas)—— 把「源帧 → 输出画布 + 完整效果链 + overlays」绘到 canvas。
+ * 从 SocialEcho VideoFramePreview.drawFinalFrame 抽出,供实时预览与封面导出复用。
+ *
+ * 效果链与 ffmpeg 导出严格同构:源→画布 cover 归一 → flips → rotate → crop → scale + 调色/滤镜 css。
+ */
+
+/** drawImage 可接受的源(video / image / canvas) */
+type FrameSource = CanvasImageSource;
+/**
+ * 把一帧合成绘到 canvas(物理分辨率 = 输出尺寸 × k)。
+ * @param srcDims 活动源原始分辨率(逐片段可能不同)
+ * @param canvasDims 输出画布(= 首素材分辨率),全局效果链的「源 dims」
+ * @param k 物理像素倍率(预览用 ≤1 控带宽,封面导出用 1 全分辨率)
+ * @param imageCache 贴纸图片缓存(loadOverlayImages 产出)
+ */
+declare function drawVideoFrame(canvas: HTMLCanvasElement, source: FrameSource, srcDims: {
+    w: number;
+    h: number;
+}, canvasDims: {
+    w: number;
+    h: number;
+}, state: VideoEditStateT, k?: number, imageCache?: Map<string, HTMLImageElement>, withOverlays?: boolean): void;
+/**
+ * 抽 count 张等距缩略图(dataURL,jpeg)。供时间轴缩略图条 / 封面条。
+ * 传入**专用离屏 video 元素**(勿用主预览源,seek 会打断播放)。
+ */
+declare function generateThumbnails(videoEl: HTMLVideoElement, count: number, maxW?: number): Promise<string[]>;
+
+/**
+ * 全屏切换按钮(框架无关 DOM)。点按对 host 进/出全屏;监听 fullscreenchange 切图标和 host 状态类。
+ * 图片/视频 mount 共用:默认可作为覆盖按钮,也可放进宿主自己的返回工具栏。
+ */
+interface FullscreenToggle {
+    button: HTMLButtonElement;
+    dispose: () => void;
+}
+interface FullscreenToggleOptions {
+    mode?: 'overlay' | 'inline';
+    className?: string;
+}
+declare function createFullscreenToggle(host: HTMLElement, options?: FullscreenToggleOptions): FullscreenToggle;
+
+export { type FrameSource, type FullscreenToggle, type FullscreenToggleOptions, buildVideoExportFormData, createFullscreenToggle, drawOverlay, drawOverlays, drawVideoFrame, fitStickerBox, generateThumbnails, getOverlayRotation, hitTestOverlay, loadOverlayImages, overlayBBox, renderOverlaysToPng, rotateOverlay, scaleOverlay, translateOverlay };