@lumy-pack/scene-sieve 0.0.11 → 0.0.12

package/dist/cli.mjs

@@ -173,6 +173,7 @@ var init_dbscan = __esm({
 
 // src/core/analyzer.ts
 import { createRequire } from "module";
+import { filter, map } from "@winglet/common-utils";
 import sharp from "sharp";
 async function ensureOpenCV() {
   if (!cvReady) {
@@ -356,7 +357,7 @@ function computeInformationGain(clusters, clusterPoints, imageArea, animationInd
 async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
   const edges = [];
   const preprocessed = await Promise.all(
-    frames.map((f) => preprocessFrame(f.extractPath, scale))
+    map(frames, (f) => preprocessFrame(f.extractPath, scale))
   );
   const imageWidth = preprocessed[0]?.width ?? scale;
   const imageHeight = preprocessed[0]?.height ?? Math.round(scale * 9 / 16);
@@ -398,7 +399,8 @@ async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
         }
       }
       const animationIndices = tracker.update(clusters, pairIndex);
-      const animationWeights = clusters.map(
+      const animationWeights = map(
+        clusters,
         (_, ci) => animationIndices.has(ci) ? tracker.getAnimationWeight(ci, clusters) : 0
       );
       const score = computeInformationGain(
@@ -524,7 +526,8 @@ var init_analyzer = __esm({
             this.collectAnimation(region);
           }
         }
-        this.regions = this.regions.filter(
+        this.regions = filter(
+          this.regions,
           (r, i) => r.weight > 0.01 || matched.has(i)
         );
         return animationIndices;
@@ -607,6 +610,7 @@ var init_paths = __esm({
 import { readdir } from "fs/promises";
 import { join as join2 } from "path";
 import { path as ffprobePath } from "@ffprobe-installer/ffprobe";
+import { filter as filter2, map as map2 } from "@winglet/common-utils";
 import { execa } from "execa";
 import ffmpegPath from "ffmpeg-static";
 async function extractFrames(ctx) {
@@ -685,11 +689,11 @@ async function getVideoMetadata(inputPath) {
 }
 async function buildFrameList(framesDir, duration) {
   const files = await readdir(framesDir);
-  const jpgFiles = files.filter((f) => f.endsWith(".jpg")).sort();
+  const jpgFiles = filter2(files, (f) => f.endsWith(".jpg")).sort();
   if (jpgFiles.length === 0) {
     return [];
   }
-  return jpgFiles.map((file, index) => ({
+  return map2(jpgFiles, (file, index) => ({
     id: index,
     timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
     extractPath: join2(framesDir, file)
@@ -724,6 +728,7 @@ var init_extractor = __esm({
 // src/core/workspace.ts
 import { readdir as readdir2, rename, rm, stat as stat2, writeFile } from "fs/promises";
 import { join as join3 } from "path";
+import { map as map3 } from "@winglet/common-utils";
 import sharp2 from "sharp";
 async function createWorkspace(sessionId) {
   const workspacePath = getTempWorkspaceDir(sessionId);
@@ -764,7 +769,7 @@ async function finalizeOutput(ctx, selectedFrames) {
       }
     },
     frames: framesMetadata,
-    animations: (ctx.animations || []).map((anim) => ({
+    animations: map3(ctx.animations || [], (anim) => ({
       ...anim,
       startFrameId: anim.startFrameId + 1,
       endFrameId: anim.endFrameId + 1,
@@ -831,7 +836,8 @@ async function writeInputFrames(frames, workspacePath) {
 }
 async function readFramesAsBuffers(frameNodes, quality) {
   return Promise.all(
-    frameNodes.map(
+    map3(
+      frameNodes,
       (f) => sharp2(f.extractPath).jpeg({ quality, mozjpeg: true }).toBuffer()
     )
   );
@@ -907,38 +913,42 @@ var init_input_resolver = __esm({
 });
 
 // src/utils/math.ts
+import { filter as filter3, map as map4 } from "@winglet/common-utils";
 function normalizeScores(items) {
   if (items.length === 0) return [];
-  const safeScores = items.map(
+  const safeScores = map4(
+    items,
     (e) => Number.isFinite(e.score) && e.score > 0 ? e.score : 0
   );
-  const positiveScores = safeScores.filter((s) => s > 0);
+  const positiveScores = filter3(safeScores, (s) => s > 0);
   if (positiveScores.length === 0) return safeScores;
   const sorted = [...positiveScores].sort((a, b) => a - b);
   if (positiveScores.length <= NORMALIZATION_MIN_SAMPLE_SIZE) {
     const min = sorted[0];
     const max = sorted[sorted.length - 1];
-    if (max === min) return safeScores.map((s) => s > 0 ? 1 : 0);
-    return safeScores.map(
+    if (max === min) return map4(safeScores, (s) => s > 0 ? 1 : 0);
+    return map4(
+      safeScores,
       (s) => s <= 0 ? 0 : Math.max(0, Math.min((s - min) / (max - min), 1))
     );
   }
   const median = sorted[Math.floor(sorted.length / 2)];
-  const absoluteDiffs = positiveScores.map((v) => Math.abs(v - median));
+  const absoluteDiffs = map4(positiveScores, (v) => Math.abs(v - median));
   const mad = [...absoluteDiffs].sort((a, b) => a - b)[Math.floor(absoluteDiffs.length / 2)];
   const scale = mad === 0 ? median : mad * NORMALIZATION_MAD_COEFFICIENT;
-  const logisticZ = safeScores.map((s) => {
+  const logisticZ = map4(safeScores, (s) => {
     if (s <= 0) return 0;
     if (scale === 0) return 1;
     const z = (s - median) / scale;
     return 1 / (1 + Math.exp(-NORMALIZATION_LOGISTIC_K * z));
   });
-  const cdf = safeScores.map((s) => {
+  const cdf = map4(safeScores, (s) => {
     if (s <= 0) return 0;
     const rank = sorted.findIndex((v) => v >= s);
     return rank / sorted.length;
   });
-  return logisticZ.map(
+  return map4(
+    logisticZ,
     (z, i) => z * (1 - NORMALIZATION_ALPHA) + cdf[i] * NORMALIZATION_ALPHA
   );
 }
@@ -1000,9 +1010,10 @@ var init_min_heap = __esm({
 });
 
 // src/core/pruner.ts
+import { filter as filter4, map as map5 } from "@winglet/common-utils";
 function pruneTo(graph, frames, targetCount) {
   if (frames.length <= targetCount) {
-    return new Set(frames.map((f) => f.id));
+    return new Set(map5(frames, (f) => f.id));
   }
   const prev = /* @__PURE__ */ new Map();
   const next = /* @__PURE__ */ new Map();
@@ -1020,7 +1031,7 @@ function pruneTo(graph, frames, targetCount) {
       tgtId: edge.targetId
     });
   }
-  const surviving = new Set(frames.map((f) => f.id));
+  const surviving = new Set(map5(frames, (f) => f.id));
   const firstId = frames[0].id;
   const lastId = frames[frames.length - 1].id;
   while (surviving.size > targetCount && heap.size > 0) {
@@ -1113,7 +1124,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
   if (thresholdSurvivors.size <= maxCount) {
     return thresholdSurvivors;
   }
-  const survivingFrames = frames.filter((f) => thresholdSurvivors.has(f.id));
+  const survivingFrames = filter4(frames, (f) => thresholdSurvivors.has(f.id));
   const idToOrigIdx = /* @__PURE__ */ new Map();
   for (let i = 0; i < frames.length; i++) {
     idToOrigIdx.set(frames[i].id, i);
@@ -1180,6 +1191,7 @@ var init_concurrency = __esm({
 // src/core/segmenter.ts
 import { randomUUID } from "crypto";
 import { join as join5 } from "path";
+import { filter as filter5, map as map6 } from "@winglet/common-utils";
 function shouldSegment(resolvedOptions, originalOptions) {
   if (resolvedOptions.mode === "frames") return false;
   if (originalOptions.mode === "file") {
@@ -1422,7 +1434,7 @@ async function runSegmentedPipeline(options, resolvedOptions) {
     logger.debug(`Segment plan: ${segments.length} segments`);
     const limit = concurrencyLimit(resolvedOptions.concurrency);
     const segmentProgresses = new Array(segments.length).fill(0);
-    const weights = segments.map((s) => s.duration / totalDuration);
+    const weights = map6(segments, (s) => s.duration / totalDuration);
     const emitOverallProgress = (phase) => {
       if (!options.onProgress) return;
       const overall = weights.reduce(
@@ -1433,7 +1445,8 @@ async function runSegmentedPipeline(options, resolvedOptions) {
     };
     options.onProgress?.("EXTRACTING", 0);
     const results = await Promise.all(
-      segments.map(
+      map6(
+        segments,
         (segment) => limit(async () => {
           const segWorkspace = await createSegmentWorkspace(
             mainWorkspace,
@@ -1465,7 +1478,7 @@ async function runSegmentedPipeline(options, resolvedOptions) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = filter5(frames, (f) => survivingIds.has(f.id));
     options.onProgress?.("PRUNING", 100);
     options.onProgress?.("FINALIZING", 0);
     const ctx = {
@@ -1539,6 +1552,7 @@ __export(orchestrator_exports, {
   runPipeline: () => runPipeline
 });
 import { randomUUID as randomUUID2 } from "crypto";
+import { filter as filter6 } from "@winglet/common-utils";
 async function runPipeline(options) {
   const debug = options.debug ?? false;
   if (debug) setDebugMode(true);
@@ -1592,7 +1606,7 @@ async function runPipeline(options) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = ctx.frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = filter6(ctx.frames, (f) => survivingIds.has(f.id));
     ctx.emitProgress(100);
     ctx.status = "FINALIZING";
     let outputFiles = [];
@@ -1656,7 +1670,6 @@ var init_orchestrator = __esm({
 
 // src/cli.ts
 import { createRequire as createRequire2 } from "module";
-import { Command } from "commander";
 
 // ../shared/src/respond.ts
 function respond(command, data, startTime, version2) {
@@ -1687,6 +1700,9 @@ function respondError(command, code, message, startTime, version2, details) {
   process.exitCode = 1;
 }
 
+// src/cli.ts
+import { Command } from "commander";
+
 // src/commands/Sieve.tsx
 import { existsSync } from "fs";
 import { Box as Box2, Text as Text3, useApp } from "ink";
@@ -2202,7 +2218,13 @@ if (process.argv.includes("--describe")) {
 }
 program.parseAsync(process.argv).catch((error) => {
   if (process.argv.includes("--json")) {
-    respondError("extract", SieveErrorCode.UNKNOWN, error.message, Date.now(), version);
+    respondError(
+      "extract",
+      SieveErrorCode.UNKNOWN,
+      error.message,
+      Date.now(),
+      version
+    );
   } else {
     console.error("Fatal error:", error.message);
   }

package/dist/index.cjs

@@ -40,6 +40,7 @@ var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
 // src/core/orchestrator.ts
 var import_node_crypto2 = require("crypto");
+var import_common_utils7 = require("@winglet/common-utils");
 
 // src/utils/logger.ts
 var import_picocolors = __toESM(require("picocolors"), 1);
@@ -73,6 +74,7 @@ ${import_picocolors.default.green("done")} ${message}`);
 
 // src/core/analyzer.ts
 var import_node_module = require("module");
+var import_common_utils = require("@winglet/common-utils");
 var import_sharp = __toESM(require("sharp"), 1);
 
 // src/constants.ts
@@ -289,7 +291,8 @@ var IoUTracker = class {
         this.collectAnimation(region);
       }
     }
-    this.regions = this.regions.filter(
+    this.regions = (0, import_common_utils.filter)(
+      this.regions,
       (r, i) => r.weight > 0.01 || matched.has(i)
     );
     return animationIndices;
@@ -470,7 +473,7 @@ function computeInformationGain(clusters, clusterPoints, imageArea, animationInd
 async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
   const edges = [];
   const preprocessed = await Promise.all(
-    frames.map((f) => preprocessFrame(f.extractPath, scale))
+    (0, import_common_utils.map)(frames, (f) => preprocessFrame(f.extractPath, scale))
   );
   const imageWidth = preprocessed[0]?.width ?? scale;
   const imageHeight = preprocessed[0]?.height ?? Math.round(scale * 9 / 16);
@@ -512,7 +515,8 @@ async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
         }
       }
       const animationIndices = tracker.update(clusters, pairIndex);
-      const animationWeights = clusters.map(
+      const animationWeights = (0, import_common_utils.map)(
+        clusters,
         (_, ci) => animationIndices.has(ci) ? tracker.getAnimationWeight(ci, clusters) : 0
       );
       const score = computeInformationGain(
@@ -577,6 +581,7 @@ async function analyzeFrames(ctx) {
 var import_promises2 = require("fs/promises");
 var import_node_path3 = require("path");
 var import_ffprobe = require("@ffprobe-installer/ffprobe");
+var import_common_utils2 = require("@winglet/common-utils");
 var import_execa = require("execa");
 var import_ffmpeg_static = __toESM(require("ffmpeg-static"), 1);
 
@@ -688,11 +693,11 @@ async function getVideoMetadata(inputPath) {
 }
 async function buildFrameList(framesDir, duration) {
   const files = await (0, import_promises2.readdir)(framesDir);
-  const jpgFiles = files.filter((f) => f.endsWith(".jpg")).sort();
+  const jpgFiles = (0, import_common_utils2.filter)(files, (f) => f.endsWith(".jpg")).sort();
   if (jpgFiles.length === 0) {
     return [];
   }
-  return jpgFiles.map((file, index) => ({
+  return (0, import_common_utils2.map)(jpgFiles, (file, index) => ({
     id: index,
     timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
     extractPath: (0, import_node_path3.join)(framesDir, file)
@@ -722,6 +727,7 @@ var import_node_path5 = require("path");
 // src/core/workspace.ts
 var import_promises3 = require("fs/promises");
 var import_node_path4 = require("path");
+var import_common_utils3 = require("@winglet/common-utils");
 var import_sharp2 = __toESM(require("sharp"), 1);
 async function createWorkspace(sessionId) {
   const workspacePath = getTempWorkspaceDir(sessionId);
@@ -762,7 +768,7 @@ async function finalizeOutput(ctx, selectedFrames) {
       }
     },
     frames: framesMetadata,
-    animations: (ctx.animations || []).map((anim) => ({
+    animations: (0, import_common_utils3.map)(ctx.animations || [], (anim) => ({
       ...anim,
       startFrameId: anim.startFrameId + 1,
       endFrameId: anim.endFrameId + 1,
@@ -815,7 +821,8 @@ async function writeInputFrames(frames, workspacePath) {
 }
 async function readFramesAsBuffers(frameNodes, quality) {
   return Promise.all(
-    frameNodes.map(
+    (0, import_common_utils3.map)(
+      frameNodes,
       (f) => (0, import_sharp2.default)(f.extractPath).jpeg({ quality, mozjpeg: true }).toBuffer()
     )
   );
@@ -872,39 +879,46 @@ async function resolveInput(options, workspacePath) {
   throw new Error(`Unsupported input mode: ${options.mode}`);
 }
 
+// src/core/pruner.ts
+var import_common_utils5 = require("@winglet/common-utils");
+
 // src/utils/math.ts
+var import_common_utils4 = require("@winglet/common-utils");
 function normalizeScores(items) {
   if (items.length === 0) return [];
-  const safeScores = items.map(
+  const safeScores = (0, import_common_utils4.map)(
+    items,
     (e) => Number.isFinite(e.score) && e.score > 0 ? e.score : 0
   );
-  const positiveScores = safeScores.filter((s) => s > 0);
+  const positiveScores = (0, import_common_utils4.filter)(safeScores, (s) => s > 0);
   if (positiveScores.length === 0) return safeScores;
   const sorted = [...positiveScores].sort((a, b) => a - b);
   if (positiveScores.length <= NORMALIZATION_MIN_SAMPLE_SIZE) {
     const min = sorted[0];
     const max = sorted[sorted.length - 1];
-    if (max === min) return safeScores.map((s) => s > 0 ? 1 : 0);
-    return safeScores.map(
+    if (max === min) return (0, import_common_utils4.map)(safeScores, (s) => s > 0 ? 1 : 0);
+    return (0, import_common_utils4.map)(
+      safeScores,
       (s) => s <= 0 ? 0 : Math.max(0, Math.min((s - min) / (max - min), 1))
     );
   }
   const median = sorted[Math.floor(sorted.length / 2)];
-  const absoluteDiffs = positiveScores.map((v) => Math.abs(v - median));
+  const absoluteDiffs = (0, import_common_utils4.map)(positiveScores, (v) => Math.abs(v - median));
   const mad = [...absoluteDiffs].sort((a, b) => a - b)[Math.floor(absoluteDiffs.length / 2)];
   const scale = mad === 0 ? median : mad * NORMALIZATION_MAD_COEFFICIENT;
-  const logisticZ = safeScores.map((s) => {
+  const logisticZ = (0, import_common_utils4.map)(safeScores, (s) => {
     if (s <= 0) return 0;
     if (scale === 0) return 1;
     const z = (s - median) / scale;
     return 1 / (1 + Math.exp(-NORMALIZATION_LOGISTIC_K * z));
   });
-  const cdf = safeScores.map((s) => {
+  const cdf = (0, import_common_utils4.map)(safeScores, (s) => {
     if (s <= 0) return 0;
     const rank = sorted.findIndex((v) => v >= s);
     return rank / sorted.length;
   });
-  return logisticZ.map(
+  return (0, import_common_utils4.map)(
+    logisticZ,
     (z, i) => z * (1 - NORMALIZATION_ALPHA) + cdf[i] * NORMALIZATION_ALPHA
   );
 }
@@ -956,7 +970,7 @@ var MinHeap = class {
 // src/core/pruner.ts
 function pruneTo(graph, frames, targetCount) {
   if (frames.length <= targetCount) {
-    return new Set(frames.map((f) => f.id));
+    return new Set((0, import_common_utils5.map)(frames, (f) => f.id));
   }
   const prev = /* @__PURE__ */ new Map();
   const next = /* @__PURE__ */ new Map();
@@ -974,7 +988,7 @@ function pruneTo(graph, frames, targetCount) {
       tgtId: edge.targetId
     });
   }
-  const surviving = new Set(frames.map((f) => f.id));
+  const surviving = new Set((0, import_common_utils5.map)(frames, (f) => f.id));
   const firstId = frames[0].id;
   const lastId = frames[frames.length - 1].id;
   while (surviving.size > targetCount && heap.size > 0) {
@@ -1067,7 +1081,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
   if (thresholdSurvivors.size <= maxCount) {
     return thresholdSurvivors;
   }
-  const survivingFrames = frames.filter((f) => thresholdSurvivors.has(f.id));
+  const survivingFrames = (0, import_common_utils5.filter)(frames, (f) => thresholdSurvivors.has(f.id));
   const idToOrigIdx = /* @__PURE__ */ new Map();
   for (let i = 0; i < frames.length; i++) {
     idToOrigIdx.set(frames[i].id, i);
@@ -1103,6 +1117,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
 // src/core/segmenter.ts
 var import_node_crypto = require("crypto");
 var import_node_path6 = require("path");
+var import_common_utils6 = require("@winglet/common-utils");
 
 // src/utils/concurrency.ts
 function concurrencyLimit(limit) {
@@ -1366,7 +1381,7 @@ async function runSegmentedPipeline(options, resolvedOptions) {
     logger.debug(`Segment plan: ${segments.length} segments`);
     const limit = concurrencyLimit(resolvedOptions.concurrency);
     const segmentProgresses = new Array(segments.length).fill(0);
-    const weights = segments.map((s) => s.duration / totalDuration);
+    const weights = (0, import_common_utils6.map)(segments, (s) => s.duration / totalDuration);
     const emitOverallProgress = (phase) => {
       if (!options.onProgress) return;
       const overall = weights.reduce(
@@ -1377,7 +1392,8 @@ async function runSegmentedPipeline(options, resolvedOptions) {
     };
     options.onProgress?.("EXTRACTING", 0);
     const results = await Promise.all(
-      segments.map(
+      (0, import_common_utils6.map)(
+        segments,
         (segment) => limit(async () => {
           const segWorkspace = await createSegmentWorkspace(
             mainWorkspace,
@@ -1409,7 +1425,7 @@ async function runSegmentedPipeline(options, resolvedOptions) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = (0, import_common_utils6.filter)(frames, (f) => survivingIds.has(f.id));
     options.onProgress?.("PRUNING", 100);
     options.onProgress?.("FINALIZING", 0);
     const ctx = {
@@ -1519,7 +1535,7 @@ async function runPipeline(options) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = ctx.frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = (0, import_common_utils7.filter)(ctx.frames, (f) => survivingIds.has(f.id));
     ctx.emitProgress(100);
     ctx.status = "FINALIZING";
     let outputFiles = [];

package/dist/index.mjs

@@ -1,5 +1,6 @@
 // src/core/orchestrator.ts
 import { randomUUID as randomUUID2 } from "crypto";
+import { filter as filter6 } from "@winglet/common-utils";
 
 // src/utils/logger.ts
 import pc from "picocolors";
@@ -33,6 +34,7 @@ ${pc.green("done")} ${message}`);
 
 // src/core/analyzer.ts
 import { createRequire } from "module";
+import { filter, map } from "@winglet/common-utils";
 import sharp from "sharp";
 
 // src/constants.ts
@@ -249,7 +251,8 @@ var IoUTracker = class {
         this.collectAnimation(region);
       }
     }
-    this.regions = this.regions.filter(
+    this.regions = filter(
+      this.regions,
       (r, i) => r.weight > 0.01 || matched.has(i)
     );
     return animationIndices;
@@ -430,7 +433,7 @@ function computeInformationGain(clusters, clusterPoints, imageArea, animationInd
 async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
   const edges = [];
   const preprocessed = await Promise.all(
-    frames.map((f) => preprocessFrame(f.extractPath, scale))
+    map(frames, (f) => preprocessFrame(f.extractPath, scale))
   );
   const imageWidth = preprocessed[0]?.width ?? scale;
   const imageHeight = preprocessed[0]?.height ?? Math.round(scale * 9 / 16);
@@ -472,7 +475,8 @@ async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
         }
       }
       const animationIndices = tracker.update(clusters, pairIndex);
-      const animationWeights = clusters.map(
+      const animationWeights = map(
+        clusters,
         (_, ci) => animationIndices.has(ci) ? tracker.getAnimationWeight(ci, clusters) : 0
       );
       const score = computeInformationGain(
@@ -537,6 +541,7 @@ async function analyzeFrames(ctx) {
 import { readdir } from "fs/promises";
 import { join as join2 } from "path";
 import { path as ffprobePath } from "@ffprobe-installer/ffprobe";
+import { filter as filter2, map as map2 } from "@winglet/common-utils";
 import { execa } from "execa";
 import ffmpegPath from "ffmpeg-static";
 
@@ -648,11 +653,11 @@ async function getVideoMetadata(inputPath) {
 }
 async function buildFrameList(framesDir, duration) {
   const files = await readdir(framesDir);
-  const jpgFiles = files.filter((f) => f.endsWith(".jpg")).sort();
+  const jpgFiles = filter2(files, (f) => f.endsWith(".jpg")).sort();
   if (jpgFiles.length === 0) {
     return [];
   }
-  return jpgFiles.map((file, index) => ({
+  return map2(jpgFiles, (file, index) => ({
     id: index,
     timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
     extractPath: join2(framesDir, file)
@@ -682,6 +687,7 @@ import { join as join4 } from "path";
 // src/core/workspace.ts
 import { readdir as readdir2, rename, rm, stat as stat2, writeFile } from "fs/promises";
 import { join as join3 } from "path";
+import { map as map3 } from "@winglet/common-utils";
 import sharp2 from "sharp";
 async function createWorkspace(sessionId) {
   const workspacePath = getTempWorkspaceDir(sessionId);
@@ -722,7 +728,7 @@ async function finalizeOutput(ctx, selectedFrames) {
       }
     },
     frames: framesMetadata,
-    animations: (ctx.animations || []).map((anim) => ({
+    animations: map3(ctx.animations || [], (anim) => ({
       ...anim,
       startFrameId: anim.startFrameId + 1,
       endFrameId: anim.endFrameId + 1,
@@ -775,7 +781,8 @@ async function writeInputFrames(frames, workspacePath) {
 }
 async function readFramesAsBuffers(frameNodes, quality) {
   return Promise.all(
-    frameNodes.map(
+    map3(
+      frameNodes,
       (f) => sharp2(f.extractPath).jpeg({ quality, mozjpeg: true }).toBuffer()
     )
   );
@@ -832,39 +839,46 @@ async function resolveInput(options, workspacePath) {
   throw new Error(`Unsupported input mode: ${options.mode}`);
 }
 
+// src/core/pruner.ts
+import { filter as filter4, map as map5 } from "@winglet/common-utils";
+
 // src/utils/math.ts
+import { filter as filter3, map as map4 } from "@winglet/common-utils";
 function normalizeScores(items) {
   if (items.length === 0) return [];
-  const safeScores = items.map(
+  const safeScores = map4(
+    items,
     (e) => Number.isFinite(e.score) && e.score > 0 ? e.score : 0
   );
-  const positiveScores = safeScores.filter((s) => s > 0);
+  const positiveScores = filter3(safeScores, (s) => s > 0);
   if (positiveScores.length === 0) return safeScores;
   const sorted = [...positiveScores].sort((a, b) => a - b);
   if (positiveScores.length <= NORMALIZATION_MIN_SAMPLE_SIZE) {
     const min = sorted[0];
     const max = sorted[sorted.length - 1];
-    if (max === min) return safeScores.map((s) => s > 0 ? 1 : 0);
-    return safeScores.map(
+    if (max === min) return map4(safeScores, (s) => s > 0 ? 1 : 0);
+    return map4(
+      safeScores,
       (s) => s <= 0 ? 0 : Math.max(0, Math.min((s - min) / (max - min), 1))
     );
   }
   const median = sorted[Math.floor(sorted.length / 2)];
-  const absoluteDiffs = positiveScores.map((v) => Math.abs(v - median));
+  const absoluteDiffs = map4(positiveScores, (v) => Math.abs(v - median));
   const mad = [...absoluteDiffs].sort((a, b) => a - b)[Math.floor(absoluteDiffs.length / 2)];
   const scale = mad === 0 ? median : mad * NORMALIZATION_MAD_COEFFICIENT;
-  const logisticZ = safeScores.map((s) => {
+  const logisticZ = map4(safeScores, (s) => {
     if (s <= 0) return 0;
     if (scale === 0) return 1;
     const z = (s - median) / scale;
     return 1 / (1 + Math.exp(-NORMALIZATION_LOGISTIC_K * z));
   });
-  const cdf = safeScores.map((s) => {
+  const cdf = map4(safeScores, (s) => {
     if (s <= 0) return 0;
     const rank = sorted.findIndex((v) => v >= s);
     return rank / sorted.length;
   });
-  return logisticZ.map(
+  return map4(
+    logisticZ,
     (z, i) => z * (1 - NORMALIZATION_ALPHA) + cdf[i] * NORMALIZATION_ALPHA
   );
 }
@@ -916,7 +930,7 @@ var MinHeap = class {
 // src/core/pruner.ts
 function pruneTo(graph, frames, targetCount) {
   if (frames.length <= targetCount) {
-    return new Set(frames.map((f) => f.id));
+    return new Set(map5(frames, (f) => f.id));
   }
   const prev = /* @__PURE__ */ new Map();
   const next = /* @__PURE__ */ new Map();
@@ -934,7 +948,7 @@ function pruneTo(graph, frames, targetCount) {
       tgtId: edge.targetId
     });
   }
-  const surviving = new Set(frames.map((f) => f.id));
+  const surviving = new Set(map5(frames, (f) => f.id));
   const firstId = frames[0].id;
   const lastId = frames[frames.length - 1].id;
   while (surviving.size > targetCount && heap.size > 0) {
@@ -1027,7 +1041,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
   if (thresholdSurvivors.size <= maxCount) {
     return thresholdSurvivors;
   }
-  const survivingFrames = frames.filter((f) => thresholdSurvivors.has(f.id));
+  const survivingFrames = filter4(frames, (f) => thresholdSurvivors.has(f.id));
   const idToOrigIdx = /* @__PURE__ */ new Map();
   for (let i = 0; i < frames.length; i++) {
     idToOrigIdx.set(frames[i].id, i);
@@ -1063,6 +1077,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
 // src/core/segmenter.ts
 import { randomUUID } from "crypto";
 import { join as join5 } from "path";
+import { filter as filter5, map as map6 } from "@winglet/common-utils";
 
 // src/utils/concurrency.ts
 function concurrencyLimit(limit) {
@@ -1326,7 +1341,7 @@ async function runSegmentedPipeline(options, resolvedOptions) {
     logger.debug(`Segment plan: ${segments.length} segments`);
     const limit = concurrencyLimit(resolvedOptions.concurrency);
     const segmentProgresses = new Array(segments.length).fill(0);
-    const weights = segments.map((s) => s.duration / totalDuration);
+    const weights = map6(segments, (s) => s.duration / totalDuration);
     const emitOverallProgress = (phase) => {
       if (!options.onProgress) return;
       const overall = weights.reduce(
@@ -1337,7 +1352,8 @@ async function runSegmentedPipeline(options, resolvedOptions) {
     };
     options.onProgress?.("EXTRACTING", 0);
     const results = await Promise.all(
-      segments.map(
+      map6(
+        segments,
         (segment) => limit(async () => {
           const segWorkspace = await createSegmentWorkspace(
             mainWorkspace,
@@ -1369,7 +1385,7 @@ async function runSegmentedPipeline(options, resolvedOptions) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = filter5(frames, (f) => survivingIds.has(f.id));
     options.onProgress?.("PRUNING", 100);
     options.onProgress?.("FINALIZING", 0);
     const ctx = {
@@ -1479,7 +1495,7 @@ async function runPipeline(options) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = ctx.frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = filter6(ctx.frames, (f) => survivingIds.has(f.id));
     ctx.emitProgress(100);
     ctx.status = "FINALIZING";
     let outputFiles = [];

package/dist/pipeline-worker.mjs

@@ -3,6 +3,7 @@ import { parentPort, workerData } from "worker_threads";
 
 // src/core/orchestrator.ts
 import { randomUUID as randomUUID2 } from "crypto";
+import { filter as filter6 } from "@winglet/common-utils";
 
 // src/utils/logger.ts
 import pc from "picocolors";
@@ -36,6 +37,7 @@ ${pc.green("done")} ${message}`);
 
 // src/core/analyzer.ts
 import { createRequire } from "module";
+import { filter, map } from "@winglet/common-utils";
 import sharp from "sharp";
 
 // src/constants.ts
@@ -252,7 +254,8 @@ var IoUTracker = class {
         this.collectAnimation(region);
       }
     }
-    this.regions = this.regions.filter(
+    this.regions = filter(
+      this.regions,
       (r, i) => r.weight > 0.01 || matched.has(i)
     );
     return animationIndices;
@@ -433,7 +436,7 @@ function computeInformationGain(clusters, clusterPoints, imageArea, animationInd
 async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
   const edges = [];
   const preprocessed = await Promise.all(
-    frames.map((f) => preprocessFrame(f.extractPath, scale))
+    map(frames, (f) => preprocessFrame(f.extractPath, scale))
   );
   const imageWidth = preprocessed[0]?.width ?? scale;
   const imageHeight = preprocessed[0]?.height ?? Math.round(scale * 9 / 16);
@@ -475,7 +478,8 @@ async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
         }
       }
       const animationIndices = tracker.update(clusters, pairIndex);
-      const animationWeights = clusters.map(
+      const animationWeights = map(
+        clusters,
         (_, ci) => animationIndices.has(ci) ? tracker.getAnimationWeight(ci, clusters) : 0
       );
       const score = computeInformationGain(
@@ -540,6 +544,7 @@ async function analyzeFrames(ctx) {
 import { readdir } from "fs/promises";
 import { join as join2 } from "path";
 import { path as ffprobePath } from "@ffprobe-installer/ffprobe";
+import { filter as filter2, map as map2 } from "@winglet/common-utils";
 import { execa } from "execa";
 import ffmpegPath from "ffmpeg-static";
 
@@ -651,11 +656,11 @@ async function getVideoMetadata(inputPath) {
 }
 async function buildFrameList(framesDir, duration) {
   const files = await readdir(framesDir);
-  const jpgFiles = files.filter((f) => f.endsWith(".jpg")).sort();
+  const jpgFiles = filter2(files, (f) => f.endsWith(".jpg")).sort();
   if (jpgFiles.length === 0) {
     return [];
   }
-  return jpgFiles.map((file, index) => ({
+  return map2(jpgFiles, (file, index) => ({
     id: index,
     timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
     extractPath: join2(framesDir, file)
@@ -685,6 +690,7 @@ import { join as join4 } from "path";
 // src/core/workspace.ts
 import { readdir as readdir2, rename, rm, stat as stat2, writeFile } from "fs/promises";
 import { join as join3 } from "path";
+import { map as map3 } from "@winglet/common-utils";
 import sharp2 from "sharp";
 async function createWorkspace(sessionId) {
   const workspacePath = getTempWorkspaceDir(sessionId);
@@ -725,7 +731,7 @@ async function finalizeOutput(ctx, selectedFrames) {
       }
     },
     frames: framesMetadata,
-    animations: (ctx.animations || []).map((anim) => ({
+    animations: map3(ctx.animations || [], (anim) => ({
       ...anim,
       startFrameId: anim.startFrameId + 1,
       endFrameId: anim.endFrameId + 1,
@@ -778,7 +784,8 @@ async function writeInputFrames(frames, workspacePath) {
 }
 async function readFramesAsBuffers(frameNodes, quality) {
   return Promise.all(
-    frameNodes.map(
+    map3(
+      frameNodes,
       (f) => sharp2(f.extractPath).jpeg({ quality, mozjpeg: true }).toBuffer()
     )
   );
@@ -835,39 +842,46 @@ async function resolveInput(options2, workspacePath) {
   throw new Error(`Unsupported input mode: ${options2.mode}`);
 }
 
+// src/core/pruner.ts
+import { filter as filter4, map as map5 } from "@winglet/common-utils";
+
 // src/utils/math.ts
+import { filter as filter3, map as map4 } from "@winglet/common-utils";
 function normalizeScores(items) {
   if (items.length === 0) return [];
-  const safeScores = items.map(
+  const safeScores = map4(
+    items,
     (e) => Number.isFinite(e.score) && e.score > 0 ? e.score : 0
   );
-  const positiveScores = safeScores.filter((s) => s > 0);
+  const positiveScores = filter3(safeScores, (s) => s > 0);
   if (positiveScores.length === 0) return safeScores;
   const sorted = [...positiveScores].sort((a, b) => a - b);
   if (positiveScores.length <= NORMALIZATION_MIN_SAMPLE_SIZE) {
     const min = sorted[0];
     const max = sorted[sorted.length - 1];
-    if (max === min) return safeScores.map((s) => s > 0 ? 1 : 0);
-    return safeScores.map(
+    if (max === min) return map4(safeScores, (s) => s > 0 ? 1 : 0);
+    return map4(
+      safeScores,
       (s) => s <= 0 ? 0 : Math.max(0, Math.min((s - min) / (max - min), 1))
     );
   }
   const median = sorted[Math.floor(sorted.length / 2)];
-  const absoluteDiffs = positiveScores.map((v) => Math.abs(v - median));
+  const absoluteDiffs = map4(positiveScores, (v) => Math.abs(v - median));
   const mad = [...absoluteDiffs].sort((a, b) => a - b)[Math.floor(absoluteDiffs.length / 2)];
   const scale = mad === 0 ? median : mad * NORMALIZATION_MAD_COEFFICIENT;
-  const logisticZ = safeScores.map((s) => {
+  const logisticZ = map4(safeScores, (s) => {
     if (s <= 0) return 0;
     if (scale === 0) return 1;
     const z = (s - median) / scale;
     return 1 / (1 + Math.exp(-NORMALIZATION_LOGISTIC_K * z));
   });
-  const cdf = safeScores.map((s) => {
+  const cdf = map4(safeScores, (s) => {
     if (s <= 0) return 0;
     const rank = sorted.findIndex((v) => v >= s);
     return rank / sorted.length;
   });
-  return logisticZ.map(
+  return map4(
+    logisticZ,
     (z, i) => z * (1 - NORMALIZATION_ALPHA) + cdf[i] * NORMALIZATION_ALPHA
   );
 }
@@ -919,7 +933,7 @@ var MinHeap = class {
 // src/core/pruner.ts
 function pruneTo(graph, frames, targetCount) {
   if (frames.length <= targetCount) {
-    return new Set(frames.map((f) => f.id));
+    return new Set(map5(frames, (f) => f.id));
   }
   const prev = /* @__PURE__ */ new Map();
   const next = /* @__PURE__ */ new Map();
@@ -937,7 +951,7 @@ function pruneTo(graph, frames, targetCount) {
       tgtId: edge.targetId
     });
   }
-  const surviving = new Set(frames.map((f) => f.id));
+  const surviving = new Set(map5(frames, (f) => f.id));
   const firstId = frames[0].id;
   const lastId = frames[frames.length - 1].id;
   while (surviving.size > targetCount && heap.size > 0) {
@@ -1030,7 +1044,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
   if (thresholdSurvivors.size <= maxCount) {
     return thresholdSurvivors;
   }
-  const survivingFrames = frames.filter((f) => thresholdSurvivors.has(f.id));
+  const survivingFrames = filter4(frames, (f) => thresholdSurvivors.has(f.id));
   const idToOrigIdx = /* @__PURE__ */ new Map();
   for (let i = 0; i < frames.length; i++) {
     idToOrigIdx.set(frames[i].id, i);
@@ -1066,6 +1080,7 @@ function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
 // src/core/segmenter.ts
 import { randomUUID } from "crypto";
 import { join as join5 } from "path";
+import { filter as filter5, map as map6 } from "@winglet/common-utils";
 
 // src/utils/concurrency.ts
 function concurrencyLimit(limit) {
@@ -1329,7 +1344,7 @@ async function runSegmentedPipeline(options2, resolvedOptions) {
     logger.debug(`Segment plan: ${segments.length} segments`);
     const limit = concurrencyLimit(resolvedOptions.concurrency);
     const segmentProgresses = new Array(segments.length).fill(0);
-    const weights = segments.map((s) => s.duration / totalDuration);
+    const weights = map6(segments, (s) => s.duration / totalDuration);
     const emitOverallProgress = (phase) => {
       if (!options2.onProgress) return;
       const overall = weights.reduce(
@@ -1340,7 +1355,8 @@ async function runSegmentedPipeline(options2, resolvedOptions) {
     };
     options2.onProgress?.("EXTRACTING", 0);
     const results = await Promise.all(
-      segments.map(
+      map6(
+        segments,
         (segment) => limit(async () => {
           const segWorkspace = await createSegmentWorkspace(
             mainWorkspace,
@@ -1372,7 +1388,7 @@ async function runSegmentedPipeline(options2, resolvedOptions) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = filter5(frames, (f) => survivingIds.has(f.id));
     options2.onProgress?.("PRUNING", 100);
     options2.onProgress?.("FINALIZING", 0);
     const ctx = {
@@ -1482,7 +1498,7 @@ async function runPipeline(options2) {
       resolvedOptions.threshold,
       resolvedOptions.count
     );
-    const prunedFrames = ctx.frames.filter((f) => survivingIds.has(f.id));
+    const prunedFrames = filter6(ctx.frames, (f) => survivingIds.has(f.id));
     ctx.emitProgress(100);
     ctx.status = "FINALIZING";
     let outputFiles = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumy-pack/scene-sieve",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "CLI tool for extracting key frames from video and GIF files",
   "keywords": [
     "cli",
@@ -56,6 +56,8 @@
   "dependencies": {
     "@ffprobe-installer/ffprobe": "^1.4.1",
     "@techstark/opencv-js": "4.12.0-release.1",
+    "@winglet/common-utils": "^0.11.2",
+    "@winglet/react-utils": "^0.11.2",
     "commander": "^12.1.0",
     "execa": "^9.5.0",
     "ffmpeg-static": "^5.2.0",