lofter-lottie-opt 1.0.1

package/dist/esm/plugins/compress-images/algorithm.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 核心算法 - compress-images 插件（简化版）
+ *
+ * 极简参数：只关心是否启用 WebP/AVIF、是否内嵌、最长边限制和质量档位。
+ * 默认启用 WebP，关闭 AVIF。内置 mozjpeg / pngquant（palette）最佳实践。
+ * 自动多组候选 + SSIM 质量控制，智能选择最优压缩方案。
+ */
+import { LottieData } from '../../types';
+import { CompressImagesOptions, CompressImagesResult } from './types';
+export declare function compressImages(input: LottieData, opt?: CompressImagesOptions): Promise<CompressImagesResult>;
+//# sourceMappingURL=algorithm.d.ts.map

package/dist/esm/plugins/compress-images/algorithm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.d.ts","sourceRoot":"","sources":["../../../../src/plugins/compress-images/algorithm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAe,qBAAqB,EAAE,oBAAoB,EAAyC,MAAM,SAAS,CAAC;AAqF1H,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAE,qBAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+QtH"}

package/dist/esm/plugins/compress-images/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * compress-images 插件入口（简化版）
+ *
+ * 极简参数：只关心是否启用 WebP/AVIF、是否内嵌、最长边限制和质量档位。
+ * 默认启用 WebP，关闭 AVIF。内置 mozjpeg / pngquant（palette）最佳实践。
+ * 自动多组候选 + SSIM 质量控制，智能选择最优压缩方案。
+ *
+ * Author: lottie-opt
+ */
+import { OptimizePlugin } from '../../types';
+export { compressImages } from './algorithm';
+export * from './types';
+export declare const compressImagesPlugin: OptimizePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/plugins/compress-images/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/compress-images/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAA2C,MAAM,aAAa,CAAC;AAMtF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,cAAc,SAAS,CAAC;AAGxB,eAAO,MAAM,oBAAoB,EAAE,cAmDlC,CAAC"}

package/dist/esm/plugins/compress-images/tinypng.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TinyPNG 压缩功能
+ */
+/**
+ * 生成随机IP地址，用于绕过某些服务的IP限制
+ */
+export declare function getRandomIP(): string;
+/**
+ * 下载图片并返回Buffer
+ */
+export declare function downloadImg(url: string): Promise<Buffer>;
+/**
+ * 使用 TinyPNG 压缩图片
+ * @param file 图片Buffer
+ * @returns [压缩后的Buffer, 文件扩展名]
+ */
+export declare function compress(file: Buffer): Promise<[Buffer, string]>;
+/**
+ * 重置 TinyPNG 服务状态，允许重新尝试使用服务
+ */
+export declare function resetServiceStatus(): void;
+//# sourceMappingURL=tinypng.d.ts.map

package/dist/esm/plugins/compress-images/tinypng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinypng.d.ts","sourceRoot":"","sources":["../../../../src/plugins/compress-images/tinypng.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9D;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyEtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/esm/plugins/compress-images/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 类型定义 - compress-images 插件（简化版）
+ */
+import { LottieData, BasePluginOptions, QualityLevel } from '../../types';
+import { CDNUploadConfig } from '../../utils/nos-client';
+type AnyObj = Record<string, any>;
+export type CompressionLevel = "mild" | "standard" | "aggressive";
+export interface SSIMCompressOptions {
+    /**
+     * 压缩等级：mild (0.995) | standard (0.99) | aggressive (0.975)
+     */
+    level?: CompressionLevel;
+    /**
+     * 自定义 SSIM 阈值，覆盖默认档位阈值
+     */
+    ssimThreshold?: number;
+    /**
+     * 允许的格式候选，默认全部尝试
+     */
+    allowFormats?: Array<"png" | "webp-lossy" | "webp-near" | "jpeg">;
+    /**
+     * 无达标项时是否回退到 SSIM 最大者，默认 true
+     */
+    fallbackToBestSSIM?: boolean;
+    /**
+     * 覆盖编码 effort，默认 6（webp）/ 10（png）
+     */
+    forceEffort?: number;
+}
+export interface LottieAsset extends AnyObj {
+    id?: string;
+    u?: string;
+    p?: string;
+    e?: 0 | 1;
+    w?: number;
+    h?: number;
+}
+export interface CompressImagesOptions extends BasePluginOptions {
+    /**
+     * 是否启用 WebP 格式，默认 true
+     */
+    enableWebp?: boolean;
+    /**
+     * 是否启用 AVIF 格式，默认 false
+     */
+    enableAvif?: boolean;
+    /**
+     * 压缩质量等级，默认 'balanced'
+     * @deprecated 建议使用 ssimOptions.level 替代
+     */
+    quality?: QualityLevel;
+    /**
+     * 最长边限制，0=不限制，默认 0
+     */
+    longEdge?: number;
+    /**
+     * 结果是否内嵌 DataURL，默认 true
+     */
+    embed?: boolean;
+    /**
+     * 读取相对路径的根目录，默认 cwd
+     */
+    baseDir?: string;
+    /**
+     * embed=false 时输出目录，默认 ./lottie-assets
+     */
+    outDir?: string;
+    /**
+     * 是否使用 TinyPNG 压缩，默认 false
+     * 开启后将优先使用 TinyPNG 进行图片压缩
+     */
+    useTinyPNG?: boolean;
+    /**
+     * CDN 上传配置，启用后将图片上传到 CDN 并替换为 CDN URL
+     * 注意：只有在 embed=false 时才生效
+     */
+    cdn?: CDNUploadConfig;
+    /**
+     * 基于 SSIM 的压缩选项，更智能的质量控制
+     */
+    ssimOptions?: SSIMCompressOptions;
+}
+export interface CompressImagesStats {
+    total: number;
+    optimized: number;
+    before: number;
+    after: number;
+    saved: number;
+    savedPct: number;
+    perAsset: Array<{
+        id?: string;
+        from?: string;
+        to?: string;
+        orig: number;
+        out: number;
+        ssim?: number;
+        resized?: boolean;
+    }>;
+    warnings: string[];
+}
+export interface CompressImagesResult {
+    data: LottieData;
+    stats: CompressImagesStats;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/plugins/compress-images/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/compress-images/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGlC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAGlE,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,CAAC;IAElE;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,GAAG,CAAC,EAAE,eAAe,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;CAInC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,mBAAmB,CAAC;CAC5B"}

package/dist/esm/plugins/compress-images/utils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * image-compressor-utils.ts
+ *
+ * 图片压缩工具：
+ * - 三档压缩："mild" | "standard" | "aggressive"
+ * - 用 SSIM.js 做质量守门（默认阈值：0.995 / 0.99 / 0.975，可自定义）
+ * - 对同一原图尝试多种编码候选（PNG-8 / WebP 有损 / WebP 近无损 / JPEG（无透明时）），
+ *   在达标的候选中选体积最小者；若无达标项，可选择回退到 SSIM 最大者，或返回原图。
+ * - 仅关注“图片压缩”，不包含 Lottie 处理逻辑。
+ *
+ * SSIM.js 参考：ssim(img1, img2, options) // 接收两张图的 Buffer（或路径）并返回 { mssim }
+ */
+export type CompressionLevel = "mild" | "standard" | "aggressive";
+export interface CompressOptions {
+    level?: CompressionLevel;
+    ssimThreshold?: number;
+    allowFormats?: Array<"png" | "webp-lossy" | "webp-near" | "jpeg">;
+    fallbackToBestSSIM?: boolean;
+    forceEffort?: number;
+}
+export interface EncodeChoice {
+    format: "png" | "webp" | "jpeg";
+    variant: "png8" | "webp-lossy" | "webp-near" | "jpeg";
+    label: string;
+    bytes: number;
+    ssim: number;
+    buffer: Buffer;
+}
+export interface CompressResult extends EncodeChoice {
+    level: CompressionLevel;
+    threshold: number;
+    hasAlpha: boolean;
+    tried: EncodeChoice[];
+}
+/**
+ * 主函数：压缩一张图片 Buffer，返回在 SSIM 达标前提下体积最小的候选。
+ */
+export declare function compressImage(input: Buffer, options?: CompressOptions): Promise<CompressResult>;
+export declare function compressMany(inputs: Buffer[], opts?: CompressOptions): Promise<CompressResult[]>;
+/**
+import fs from "node:fs/promises";
+
+(async () => {
+  const input = await fs.readFile("./input.png");
+
+  // 1) 标准档（默认）
+  let r = await compressImage(input, { level: "standard" });
+  console.log("standard:", r.label, r.bytes, r.ssim.toFixed(5));
+  await fs.writeFile(`./out-standard.${r.format}`, r.buffer);
+
+  // 2) mild 档，阈值更苛刻（可覆盖阈值）、仅尝试 WebP 系列
+  r = await compressImage(input, {
+    level: "mild",
+    ssimThreshold: 0.997,
+    allowFormats: ["webp-lossy", "webp-near"],
+  });
+  console.log("mild:", r.label, r.bytes, r.ssim.toFixed(5));
+  await fs.writeFile(`./out-mild.${r.format}`, r.buffer);
+
+  // 3) aggressive 档，若全不达标则回退到 SSIM 最大者
+  r = await compressImage(input, { level: "aggressive", fallbackToBestSSIM: true });
+  console.log("aggressive:", r.label, r.bytes, r.ssim.toFixed(5));
+  await fs.writeFile(`./out-aggr.${r.format}`, r.buffer);
+})();
+*/
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/plugins/compress-images/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/plugins/compress-images/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,CAAC;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAqBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAqCzB;AAiJD,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;EAyBE"}

package/dist/esm/plugins/index.d.ts

@@ -0,0 +1,8 @@
+import { OptimizePlugin } from '../types';
+export declare function getAvailablePlugins(): OptimizePlugin[];
+export declare function getPluginByName(name: string): OptimizePlugin | undefined;
+/**
+ * @deprecated Use plugin groups from presets/plugin-groups.ts instead
+ */
+export declare function getPluginsByCategory(_category: 'safe' | 'lossy' | 'advanced'): OptimizePlugin[];
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAgB1C,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAEtD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,EAAE,CAG/F"}

package/dist/esm/plugins/minify-json/algorithm.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lottie JSON 精简算法
+ * 删除冗余数据，降低精度，压缩体积
+ */
+import { LottieData } from '../../types';
+import { MinifyJsonOptions, MinifyJsonResult } from './types';
+/**
+ * 精简 Lottie JSON
+ * @param input  原始 Lottie 对象
+ * @param options  配置选项
+ * @returns      精简结果
+ */
+export declare function minifyLottieJson(input: LottieData, options?: MinifyJsonOptions): MinifyJsonResult;
+export default minifyLottieJson;
+//# sourceMappingURL=algorithm.d.ts.map

package/dist/esm/plugins/minify-json/algorithm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.d.ts","sourceRoot":"","sources":["../../../../src/plugins/minify-json/algorithm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAA6C,MAAM,SAAS,CAAC;AA4azG;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA6FrG;AAED,eAAe,gBAAgB,CAAC"}

package/dist/esm/plugins/minify-json/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lottie JSON 精简插件
+ * 删除元数据、降低精度、压缩体积
+ */
+import { OptimizePlugin } from '../../types';
+export { minifyLottieJson } from './algorithm';
+export * from './types';
+export declare const minifyJsonPlugin: OptimizePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/plugins/minify-json/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/minify-json/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAA2C,MAAM,aAAa,CAAC;AAMtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,cAAc,SAAS,CAAC;AAGxB,eAAO,MAAM,gBAAgB,EAAE,cAoE9B,CAAC"}

package/dist/esm/plugins/minify-json/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Lottie JSON 精简插件类型定义
+ */
+import { LottieData, BasePluginOptions, BasePluginStats, BasePluginResult } from '../../types';
+export interface LottieLayer {
+    ind?: number;
+    [k: string]: any;
+}
+export interface LottieAsset {
+    id?: string;
+    layers?: LottieLayer[];
+    [k: string]: any;
+}
+export interface MinifyJsonOptions extends BasePluginOptions {
+    keepMatchName?: boolean;
+    keepIds?: boolean;
+    mergeNearbyNumbers?: boolean;
+    markTiny?: boolean | number;
+    precisionTargetKeys?: string[];
+    frameKeyDigits?: number;
+    normalKeyDigits?: number;
+    mergeStep?: number;
+    colorQuantizePrecision?: number;
+    roundThreshold?: number;
+    removeMetadataKeys?: boolean;
+    enableGlobalPrecision?: boolean;
+    globalMaxDecimals?: number;
+    compressNames?: boolean;
+    removeDefaultValues?: boolean;
+    customMetadataKeys?: string[];
+    customDefaultValues?: Record<string, any>;
+}
+export interface MinifyJsonStats extends BasePluginStats {
+    originalSize: number;
+    minifiedSize: number;
+    compressionRatio: number;
+    savedBytes: number;
+    layersProcessed: number;
+    assetsProcessed: number;
+    idsShortened: number;
+    numbersPrecisionReduced: number;
+    attributesRemoved: number;
+    nearbyNumbersMerged: number;
+    missingIndicesFixed: number;
+    metadataKeysRemoved: number;
+    globalPrecisionProcessed: number;
+    namesCompressed: number;
+    defaultValuesRemoved: number;
+    hiddenFalseRemoved: number;
+}
+export interface MinifyJsonResult extends BasePluginResult<LottieData, MinifyJsonStats> {
+    data: LottieData;
+    stats: MinifyJsonStats;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/plugins/minify-json/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/minify-json/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/F,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB,CAAC,UAAU,EAAE,eAAe,CAAC;IACrF,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;CACxB"}

package/dist/esm/plugins/remove-unused-assets/algorithm.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 核心算法 - remove-unused-assets 插件
+ *
+ * 使用 BFS 广度优先搜索进行闭包式遍历，安全地找出所有被引用的资产。
+ */
+import { LottieData } from '../../types';
+import { RemoveUnusedAssetsOptions, RemoveUnusedAssetsResult } from './types';
+/**
+ * Compute a stable list of all layers reachable from top-level layers by
+ * following precomp assets' `layers` fields.
+ */
+export declare function computeReferencedAssetIds(json: LottieData, opts: RemoveUnusedAssetsOptions): {
+    used: Set<string>;
+    unknownRefs: Set<string>;
+};
+/**
+ * Remove unreferenced assets by computing the transitive closure of references.
+ */
+export declare function removeUnusedAssets(input: LottieData, options?: RemoveUnusedAssetsOptions): RemoveUnusedAssetsResult;
+//# sourceMappingURL=algorithm.d.ts.map

package/dist/esm/plugins/remove-unused-assets/algorithm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.d.ts","sourceRoot":"","sources":["../../../../src/plugins/remove-unused-assets/algorithm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAGL,yBAAyB,EACzB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,yBAAyB,GAC9B;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAsDjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CAsG1B"}

package/dist/esm/plugins/remove-unused-assets/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * remove-unused-assets 插件入口
+ *
+ * Remove assets in a Lottie JSON that are not (transitively) referenced
+ * by any layer (including nested precomps). Uses a closure/BFS traversal.
+ *
+ * Safe-by-default:
+ * - Does not mutate the input object.
+ * - Skips deletion for assets without `id` (kept to be conservative).
+ * - Detects cycles in precomps to avoid infinite loops (rare but guarded).
+ *
+ * Author: lottie-opt
+ */
+import { OptimizePlugin } from '../../types';
+export { removeUnusedAssets } from './algorithm';
+export * from './types';
+export declare const removeUnusedAssetsPlugin: OptimizePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/plugins/remove-unused-assets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/remove-unused-assets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAA2C,MAAM,aAAa,CAAC;AAMtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,cAAc,SAAS,CAAC;AAGxB,eAAO,MAAM,wBAAwB,EAAE,cAkCtC,CAAC"}

package/dist/esm/plugins/remove-unused-assets/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 类型定义 - remove-unused-assets 插件
+ */
+import { LottieData } from '../../types';
+type AnyObj = Record<string, any>;
+export interface LottieLayer extends AnyObj {
+    ty?: number;
+    refId?: string;
+}
+export interface LottieAsset extends AnyObj {
+    id?: string;
+    layers?: LottieLayer[];
+    u?: string;
+    p?: string;
+    e?: boolean | number;
+}
+export interface RemoveUnusedAssetsOptions {
+    /**
+     * IDs that must be preserved even if unreferenced.
+     * Useful when your runtime code loads certain precomps/images by ID/name.
+     */
+    preserveAssetIds?: string[];
+    /**
+     * If true, keep all assets that don't have an `id` field (safer).
+     * Default: true
+     */
+    keepAssetsWithoutId?: boolean;
+    /**
+     * If true, keep all precomp assets even if currently unreferenced.
+     * (Sometimes teams like to ship reusable precomps for later composition.)
+     * Default: false
+     */
+    keepUnreferencedPrecomps?: boolean;
+    /**
+     * Optional logger for diagnostics.
+     */
+    onLog?: (msg: string) => void;
+}
+export interface RemoveUnusedAssetsStats {
+    originalAssetCount: number;
+    keptAssetCount: number;
+    removedAssetCount: number;
+    unknownRefIds: string[];
+    referencedAssetIds: string[];
+    removedAssetIds: string[];
+}
+export interface RemoveUnusedAssetsResult {
+    data: LottieData;
+    stats: RemoveUnusedAssetsStats;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/plugins/remove-unused-assets/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/remove-unused-assets/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAElC,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAEhB;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAEtB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,uBAAuB,CAAC;CAChC"}

package/dist/esm/plugins/simplify-paths/algorithm.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 核心算法 - simplify-paths 插件
+ *
+ * Lottie shape path simplifier with:
+ *  - Safe default: only simplify STATIC paths (a === 0)
+ *  - Optional "animated-consistent" mode: remove common vertices across ALL frames,
+ *    recompute cubic handles consistently per frame (Catmull-Rom → Bezier),
+ *    guaranteeing identical vertex count/order across frames.
+ *
+ * Algorithms:
+ *  - Ramer–Douglas–Peucker (RDP) on vertex polyline (v[]), with corner preservation
+ *  - Catmull-Rom based handle regeneration to keep smoothness after vertex removal
+ *  - Error check by curve sampling; fallback to original path if error > tolerance
+ */
+import { LottieJSON, SimplifyPathsOptions, SimplifyPathsResult } from './types';
+export declare function simplifyPaths(input: LottieJSON, options?: SimplifyPathsOptions): SimplifyPathsResult;
+//# sourceMappingURL=algorithm.d.ts.map

package/dist/esm/plugins/simplify-paths/algorithm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.d.ts","sourceRoot":"","sources":["../../../../src/plugins/simplify-paths/algorithm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAEL,UAAU,EAIV,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AA0ajB,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CA0ErB"}

package/dist/esm/plugins/simplify-paths/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * simplify-paths 插件入口
+ *
+ * Lottie shape path simplifier with:
+ *  - Safe default: only simplify STATIC paths (a === 0)
+ *  - Optional "animated-consistent" mode: remove common vertices across ALL frames,
+ *    recompute cubic handles consistently per frame (Catmull-Rom → Bezier),
+ *    guaranteeing identical vertex count/order across frames.
+ *
+ * Author: lottie-opt
+ */
+import { OptimizePlugin } from '../../types';
+export { simplifyPaths } from './algorithm';
+export * from './types';
+export declare const simplifyPathsPlugin: OptimizePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/plugins/simplify-paths/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/simplify-paths/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAA2C,MAAM,aAAa,CAAC;AAMtF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,cAAc,SAAS,CAAC;AAExB,eAAO,MAAM,mBAAmB,EAAE,cAkDjC,CAAC"}

package/dist/esm/plugins/simplify-paths/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 类型定义 - simplify-paths 插件
+ */
+type AnyObj = Record<string, any>;
+export type Vec2 = [number, number];
+export interface LottieJSON extends AnyObj {
+    layers?: LottieLayer[];
+}
+export interface LottieLayer extends AnyObj {
+    ty?: number;
+    shapes?: LottieShapeItem[];
+}
+export type LottieShapeItem = ({
+    ty: "gr";
+    it?: LottieShapeItem[];
+} & AnyObj) | ({
+    ty: "sh";
+    ks: PathKeyframeProp;
+} & AnyObj) | AnyObj;
+export interface PathKeyframeProp {
+    a: 0 | 1;
+    k: LottieShapePath | PathKeyframe[];
+}
+export interface PathKeyframe extends AnyObj {
+    t?: number;
+    s?: [LottieShapePath];
+    e?: [LottieShapePath];
+    h?: number;
+}
+export interface LottieShapePath {
+    v: Vec2[];
+    i: Vec2[];
+    o: Vec2[];
+    c: boolean;
+}
+export interface SimplifyPathsOptions {
+    /**
+     * "static-only" (default): only simplify a===0 paths (safest).
+     * "animated-consistent": simplify a===1 by removing the SAME indices across all frames.
+     * "all": do both.
+     */
+    mode?: "static-only" | "animated-consistent" | "all";
+    /**
+     * Tolerance for geometric error (pixels).
+     * If relativeTolerance=true, this is a fraction of the path bbox diagonal (e.g. 0.01 = 1%).
+     * Default: 1.0 px.
+     */
+    tolerance?: number;
+    /**
+     * Interpret tolerance as relative to bbox diagonal.
+     * Default: false (absolute pixels).
+     */
+    relativeTolerance?: boolean;
+    /**
+     * Minimal number of vertices to keep (per path).
+     * Default: 6 (reasonable for smooth closed shapes).
+     */
+    minPoints?: number;
+    /**
+     * Preserve "corner" vertices (sharp angle) from removal.
+     * Default: true.
+     */
+    preserveCorners?: boolean;
+    /**
+     * Corner angle threshold in degrees (smaller = sharper corner).
+     * Default: 150 deg (keep angles sharper than this).
+     */
+    cornerAngleDeg?: number;
+    /**
+     * RDP simplification only (we implement RDP; "visvalingam" ignored).
+     */
+    algorithm?: "rdp";
+    /**
+     * Samples per segment for error checking.
+     * Default: 10.
+     */
+    samplesPerSegment?: number;
+    /**
+     * Catmull-Rom → Bezier tension factor (1.0 is standard).
+     * Smaller gives tighter curves. Default: 1.0.
+     */
+    tension?: number;
+    /**
+     * Optional logger.
+     */
+    onLog?: (msg: string) => void;
+}
+export interface SimplifyPathsStats {
+    totalPaths: number;
+    simplifiedPaths: number;
+    staticSimplified: number;
+    animatedSimplified: number;
+    avgVertexReduction?: number;
+    warnings: string[];
+}
+export interface SimplifyPathsResult {
+    data: LottieJSON;
+    stats: SimplifyPathsStats;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/plugins/simplify-paths/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/simplify-paths/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAClC,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpC,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,eAAe,GACvB,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,GAAG,MAAM,CAAC,GAC/C,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,gBAAgB,CAAA;CAAE,GAAG,MAAM,CAAC,GAC7C,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACT,CAAC,EACG,eAAe,GACf,YAAY,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;IACtB,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,CAAC;CAEZ;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,IAAI,EAAE,CAAC;IACV,CAAC,EAAE,IAAI,EAAE,CAAC;IACV,CAAC,EAAE,IAAI,EAAE,CAAC;IACV,CAAC,EAAE,OAAO,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,qBAAqB,GAAG,KAAK,CAAC;IAErD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;CAC3B"}