/**
 * Plugin SDK 实现
 *
 * definePlugin / createCapabilityImpl / createBlobCapabilityImpl /
 * createMergeCapabilityImpl / createSplitCapabilityImpl / definePanel /
 * defaultDeriveOutputMetadata 的具体实现。
 *
 * 包级文档与 re-export 见 index.ts(barrel)。
 */
import type { Asset, AssetMetadata, AssetType, CapabilityImplementation, PluginConfig, PluginContext, PluginInstaller, PanelDefinition } from '@lokvis/schema';
/**
 * 定义一个 Lokvis Plugin
 *
 * @example
 * ```ts
 * export default definePlugin({
 *   name: 'lokvis-image-tools',
 *   version: '1.0.0',
 *   capabilities: [
 *     {
 *       name: 'image.resize',
 *       description: 'Resize image to specified dimensions',
 *       inputTypes: ['image'],
 *       outputTypes: ['image'],
 *       params: [
 *         { name: 'width', type: 'number', required: false },
 *         { name: 'height', type: 'number', required: false },
 *         { name: 'fit', type: 'enum', values: ['cover', 'contain', 'fill'] }
 *       ],
 *       performance: 'fast'
 *     }
 *   ],
 *   engine: 'squoosh'
 * });
 * ```
 */
export declare function definePlugin(config: PluginConfig, installer?: (ctx: PluginContext) => void | Promise<void>): {
    config: PluginConfig;
    install: PluginInstaller;
};
/** 便捷工具：创建能力实现注册函数 */
export declare function createCapabilityImpl(capability: string, engine: string, execute: CapabilityImplementation['execute']): CapabilityImplementation;
/** 便捷工具：创建 Panel 定义 */
export declare function definePanel(panel: PanelDefinition): PanelDefinition;
/**
 * 默认元数据派生:从 source Asset 传播 dimensions,从 outBlob 取 mimeType/size/format。
 * 适用于 image/video 等"变换不改变 dimensions 语义"的 Blob↔Blob 操作。
 */
export declare function defaultDeriveOutputMetadata(source: Asset, outBlob: Blob): AssetMetadata;
/** Blob 能力实现工厂选项 */
export interface BlobCapabilityOptions {
    /** 对应 Capability 名 */
    capability: string;
    /** 引擎名 */
    engine: string;
    /** 输出 Asset 类型 */
    outputType: AssetType;
    /** 实际执行函数(Blob → Blob),signal 可选 */
    operation: (blob: Blob, params: Record<string, unknown>, signal?: AbortSignal) => Promise<Blob>;
    /** 是否为 stub 实现(engine.version.includes('stub')) */
    isStub: boolean;
    /** 自定义元数据派生;默认用 defaultDeriveOutputMetadata */
    deriveMetadata?: (source: Asset, outBlob: Blob) => AssetMetadata;
}
/**
 * 创建单输入→单输出的 Blob 能力实现(长期方案:消除 plugin-* 重复)。
 *
 * 封装"取 blob → 调 operation → 派生 metadata → createAsset → 进度/取消"
 * 五步样板。plugin-image / plugin-video / plugin-pdf(single kind)共享此工厂,
 * 各自只提供 operation 函数与 isStub 检测,不再重复 wrapAsImplementation。
 *
 * merge(N→1) / split(1→N) 形态不同,使用 createMergeCapabilityImpl /
 * createSplitCapabilityImpl 工厂。
 */
export declare function createBlobCapabilityImpl(options: BlobCapabilityOptions, ctx: PluginContext): CapabilityImplementation;
/** Merge(N→1)能力实现工厂选项 */
export interface MergeCapabilityOptions {
    /** 对应 Capability 名 */
    capability: string;
    /** 引擎名 */
    engine: string;
    /** 输出 Asset 类型 */
    outputType: AssetType;
    /** 实际执行函数(Blob[] → Blob) */
    operation: (blobs: Blob[], params: Record<string, unknown>) => Promise<Blob>;
    /** 是否为 stub 实现(engine.version.includes('stub')) */
    isStub: boolean;
    /**
     * 自定义元数据派生;merge 无单一 source,签名是 (outBlob) => AssetMetadata。
     * 必填(无合理默认值,各 AssetType 默认 MIME 不同)。
     */
    deriveMetadata: (outBlob: Blob) => AssetMetadata;
}
/**
 * 创建多输入→单输出的 Merge 能力实现(N→1,如 pdf.merge)。
 *
 * 封装"逐个取 blob → 调 operation(blobs[]) → 派生 metadata → createAsset
 * → 进度/取消"五步样板。与 createBlobCapabilityImpl 共用语义,
 * 区别在 operation 接收 Blob[] 而非单 Blob,只产出 1 个 Asset。
 */
export declare function createMergeCapabilityImpl(options: MergeCapabilityOptions, ctx: PluginContext): CapabilityImplementation;
/** Split(1→N)能力实现工厂选项 */
export interface SplitCapabilityOptions {
    /** 对应 Capability 名 */
    capability: string;
    /** 引擎名 */
    engine: string;
    /** 输出 Asset 类型 */
    outputType: AssetType;
    /** 实际执行函数(Blob → Blob[]) */
    operation: (blob: Blob, params: Record<string, unknown>) => Promise<Blob[]>;
    /** 是否为 stub 实现(engine.version.includes('stub')) */
    isStub: boolean;
    /**
     * 自定义元数据派生;split 有多个 outBlob,签名是 (outBlob) => AssetMetadata,
     * 对每个 outBlob 调用一次。必填(无合理默认值)。
     */
    deriveMetadata: (outBlob: Blob) => AssetMetadata;
}
/**
 * 创建单输入→多输出的 Split 能力实现(1→N,如 pdf.split)。
 *
 * 封装"取 blob → 调 operation(blob) → 对每个 outBlob 派生 metadata +
 * createAsset → 进度/取消"五步样板。与 createBlobCapabilityImpl 共用语义,
 * 区别在 operation 返回 Blob[] 而非单 Blob,产生 N 个 Asset。
 */
export declare function createSplitCapabilityImpl(options: SplitCapabilityOptions, ctx: PluginContext): CapabilityImplementation;
//# sourceMappingURL=plugin-sdk.d.ts.map