@lumy-pack/scene-sieve 0.0.3 → 0.0.5

package/dist/commands/Sieve.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+export interface SieveViewProps {
+    input: string;
+    count?: number;
+    threshold?: number;
+    output?: string;
+    fps: number;
+    maxFrames: number;
+    scale: number;
+    quality: number;
+    debug: boolean;
+}
+export declare const SieveView: React.FC<SieveViewProps>;

package/dist/components/PhaseStep.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export type PhaseStatus = 'pending' | 'running' | 'done' | 'failed';
+export interface PhaseState {
+    label: string;
+    status: PhaseStatus;
+    hasProgress: boolean;
+    percent: number;
+    durationMs?: number;
+}
+interface PhaseStepProps {
+    phase: PhaseState;
+}
+export declare const PhaseStep: React.FC<PhaseStepProps>;
+export {};

package/dist/components/ProgressBar.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface ProgressBarProps {
+    percent: number;
+    width?: number;
+}
+export declare const ProgressBar: React.FC<ProgressBarProps>;
+export {};

package/dist/constants.d.ts

@@ -4,6 +4,7 @@ export declare const DEFAULT_THRESHOLD = 0.5;
 export declare const DEFAULT_FPS = 5;
 export declare const DEFAULT_SCALE = 720;
 export declare const DEFAULT_QUALITY = 80;
+export declare const DEFAULT_MAX_FRAMES = 300;
 export declare const NORMALIZATION_PERCENTILE = 0.9;
 export declare const WORKSPACE_PREFIX = "scene-sieve-";
 export declare const TEMP_BASE_DIR: string;
@@ -18,7 +19,7 @@ export declare const DBSCAN_MIN_PTS = 4;
 export declare const IOU_THRESHOLD = 0.9;
 export declare const DECAY_LAMBDA = 0.95;
 export declare const ANIMATION_FRAME_THRESHOLD = 5;
-export declare const MATCH_DISTANCE_THRESHOLD = 0.75;
+export declare const MATCH_DISTANCE_THRESHOLD = 0.25;
 export declare const PIXELDIFF_GAUSSIAN_KERNEL = 3;
 export declare const PIXELDIFF_BINARY_THRESHOLD = 30;
 export declare const PIXELDIFF_CONTOUR_MIN_AREA = 100;

package/dist/core/extractor.d.ts

@@ -1,7 +1,7 @@
 import type { FrameNode, ProcessContext } from '../types/index.js';
 /**
  * Extract frames from video/GIF using FFmpeg.
- * Attempts I-Frame extraction first; falls back to fixed FPS if insufficient.
- * GIF inputs always use FPS fallback.
+ * Always uses FPS-based extraction. For long videos, FPS is automatically
+ * reduced to stay within maxFrames budget.
  */
 export declare function extractFrames(ctx: ProcessContext): Promise<FrameNode[]>;

package/dist/core/pipeline-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/run-in-worker.d.ts

@@ -0,0 +1,9 @@
+import type { ProgressPhase, SieveInput, SieveOptionsBase, SieveResult } from '../types/index.js';
+export type SieveWorkerOptions = Omit<SieveOptionsBase, 'onProgress'> & SieveInput;
+/**
+ * Run the pipeline, choosing the best execution strategy:
+ *
+ * - Production (bundled .mjs): Worker thread — spinner never freezes
+ * - Dev mode (tsx .ts): Main thread — simpler, spinner may stutter during CPU work
+ */
+export declare function runPipelineInWorker(options: SieveWorkerOptions, onProgress: (phase: ProgressPhase, percent: number) => void): Promise<SieveResult>;

package/dist/core/workspace.d.ts

@@ -2,6 +2,11 @@ import type { FrameNode, ProcessContext } from '../types/index.js';
 export declare function createWorkspace(sessionId: string): Promise<string>;
 export declare function finalizeOutput(ctx: ProcessContext, selectedFrames: FrameNode[]): Promise<string[]>;
 export declare function cleanupWorkspace(workspacePath: string): Promise<void>;
+/**
+ * Remove stale workspace directories left by previous interrupted runs.
+ * Only deletes directories older than 1 hour to avoid removing active workspaces.
+ */
+export declare function cleanupStaleWorkspaces(): Promise<void>;
 /**
  * Write a video buffer to a temp file in the workspace and return the path.
  * Used by 'buffer' input mode.

package/dist/index.cjs

@@ -84,6 +84,7 @@ var DEFAULT_THRESHOLD = 0.5;
 var DEFAULT_FPS = 5;
 var DEFAULT_SCALE = 720;
 var DEFAULT_QUALITY = 80;
+var DEFAULT_MAX_FRAMES = 300;
 var NORMALIZATION_PERCENTILE = 0.9;
 var WORKSPACE_PREFIX = `${APP_NAME}-`;
 var TEMP_BASE_DIR = (0, import_node_os.tmpdir)();
@@ -97,13 +98,12 @@ var SUPPORTED_VIDEO_EXTENSIONS = [
 var SUPPORTED_GIF_EXTENSIONS = [".gif"];
 var FRAME_OUTPUT_EXTENSION = ".jpg";
 var OPENCV_BATCH_SIZE = 10;
-var MIN_IFRAME_COUNT = 3;
 var DBSCAN_ALPHA = 0.03;
 var DBSCAN_MIN_PTS = 4;
 var IOU_THRESHOLD = 0.9;
 var DECAY_LAMBDA = 0.95;
 var ANIMATION_FRAME_THRESHOLD = 5;
-var MATCH_DISTANCE_THRESHOLD = 0.75;
+var MATCH_DISTANCE_THRESHOLD = 0.25;
 var PIXELDIFF_GAUSSIAN_KERNEL = 3;
 var PIXELDIFF_BINARY_THRESHOLD = 30;
 var PIXELDIFF_CONTOUR_MIN_AREA = 100;
@@ -216,7 +216,7 @@ async function ensureOpenCV() {
 async function preprocessFrame(framePath, scale) {
   const { data, info } = await (0, import_sharp.default)(framePath).resize({ width: scale, withoutEnlargement: true }).grayscale().blur(1).raw().toBuffer({ resolveWithObject: true });
   return {
-    data: new Uint8Array(data.buffer),
+    data: new Uint8Array(data.buffer, data.byteOffset, data.byteLength),
     width: info.width,
     height: info.height
   };
@@ -297,16 +297,11 @@ var IoUTracker = class {
   }
 };
 async function computeAKAZEDiff(cvLib, frame1, frame2) {
-  const mat1 = cvLib.matFromImageData({
-    data: frame1.data,
-    width: frame1.width,
-    height: frame1.height
-  });
-  const mat2 = cvLib.matFromImageData({
-    data: frame2.data,
-    width: frame2.width,
-    height: frame2.height
-  });
+  const cv = cvLib;
+  const mat1 = new cv.Mat(frame1.height, frame1.width, cv.CV_8UC1);
+  mat1.data.set(frame1.data);
+  const mat2 = new cv.Mat(frame2.height, frame2.width, cv.CV_8UC1);
+  mat2.data.set(frame2.data);
   const kp1 = new cvLib.KeyPointVector();
   const kp2 = new cvLib.KeyPointVector();
   const desc1 = new cvLib.Mat();
@@ -582,7 +577,7 @@ function isSupportedFile(filePath, extensions) {
 // src/core/extractor.ts
 async function extractFrames(ctx) {
   const framesDir = (0, import_node_path3.join)(ctx.workspacePath, "frames");
-  const { inputPath, fps, scale } = ctx.options;
+  const { inputPath, fps, maxFrames, scale } = ctx.options;
   if (!inputPath) {
     throw new Error("inputPath is required for frame extraction");
   }
@@ -599,39 +594,21 @@ async function extractFrames(ctx) {
   }
   logger.debug(`Extracting frames from: ${inputPath}`);
   await ensureDir(framesDir);
-  const isGif = isSupportedFile(inputPath, SUPPORTED_GIF_EXTENSIONS);
-  let frames;
-  if (isGif) {
-    logger.debug("GIF detected \u2014 using FPS extraction");
-    frames = await extractByFps(inputPath, framesDir, fps, scale);
-  } else {
-    frames = await extractIFrames(inputPath, framesDir, scale);
-    if (frames.length < MIN_IFRAME_COUNT) {
-      logger.debug(
-        `Insufficient I-frames (${frames.length}), falling back to FPS mode`
-      );
-      frames = await extractByFps(inputPath, framesDir, fps, scale);
-    }
+  let effectiveFps = fps;
+  const duration = await getVideoDuration(inputPath).catch(() => 0);
+  if (duration > 0) {
+    const fpsCap = maxFrames / duration;
+    effectiveFps = Math.min(fps, fpsCap);
+    effectiveFps = Math.max(0.5, effectiveFps);
+    logger.debug(
+      `Duration: ${duration.toFixed(1)}s, FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
+    );
   }
+  const frames = await extractByFps(inputPath, framesDir, effectiveFps, scale);
   ctx.emitProgress(100);
   logger.debug(`Extracted ${frames.length} frames`);
   return frames;
 }
-async function extractIFrames(inputPath, outputDir, scale) {
-  const outputPattern = (0, import_node_path3.join)(outputDir, "frame_%06d.jpg");
-  await (0, import_execa.execa)(import_ffmpeg_static.default, [
-    "-i",
-    inputPath,
-    "-vf",
-    `select='eq(pict_type,I)',scale=-1:${scale}`,
-    "-vsync",
-    "vfr",
-    "-q:v",
-    "2",
-    outputPattern
-  ]);
-  return buildFrameList(outputDir, inputPath);
-}
 async function extractByFps(inputPath, outputDir, fps, scale) {
   const outputPattern = (0, import_node_path3.join)(outputDir, "frame_%06d.jpg");
   await (0, import_execa.execa)(import_ffmpeg_static.default, [
@@ -704,6 +681,7 @@ async function finalizeOutput(ctx, selectedFrames) {
     outputFiles.push((0, import_node_path4.join)(outputPath, destName));
   }
   await ensureDir((0, import_node_path4.join)(outputPath, ".."));
+  await (0, import_promises3.rm)(outputPath, { recursive: true, force: true });
   await (0, import_promises3.rename)(stagingDir, outputPath);
   return outputFiles;
 }
@@ -714,6 +692,7 @@ async function cleanupWorkspace(workspacePath) {
   } catch {
   }
 }
+var STALE_THRESHOLD_MS = 60 * 60 * 1e3;
 async function writeInputBuffer(buffer, workspacePath) {
   const inputDir = (0, import_node_path4.join)(workspacePath, "input");
   await ensureDir(inputDir);
@@ -761,6 +740,7 @@ function resolveOptions(options) {
     pruneMode,
     outputPath,
     fps: options.fps ?? DEFAULT_FPS,
+    maxFrames: options.maxFrames ?? DEFAULT_MAX_FRAMES,
     scale: options.scale ?? DEFAULT_SCALE,
     quality: options.quality ?? DEFAULT_QUALITY,
     debug: options.debug ?? false

package/dist/index.mjs

@@ -44,6 +44,7 @@ var DEFAULT_THRESHOLD = 0.5;
 var DEFAULT_FPS = 5;
 var DEFAULT_SCALE = 720;
 var DEFAULT_QUALITY = 80;
+var DEFAULT_MAX_FRAMES = 300;
 var NORMALIZATION_PERCENTILE = 0.9;
 var WORKSPACE_PREFIX = `${APP_NAME}-`;
 var TEMP_BASE_DIR = tmpdir();
@@ -57,13 +58,12 @@ var SUPPORTED_VIDEO_EXTENSIONS = [
 var SUPPORTED_GIF_EXTENSIONS = [".gif"];
 var FRAME_OUTPUT_EXTENSION = ".jpg";
 var OPENCV_BATCH_SIZE = 10;
-var MIN_IFRAME_COUNT = 3;
 var DBSCAN_ALPHA = 0.03;
 var DBSCAN_MIN_PTS = 4;
 var IOU_THRESHOLD = 0.9;
 var DECAY_LAMBDA = 0.95;
 var ANIMATION_FRAME_THRESHOLD = 5;
-var MATCH_DISTANCE_THRESHOLD = 0.75;
+var MATCH_DISTANCE_THRESHOLD = 0.25;
 var PIXELDIFF_GAUSSIAN_KERNEL = 3;
 var PIXELDIFF_BINARY_THRESHOLD = 30;
 var PIXELDIFF_CONTOUR_MIN_AREA = 100;
@@ -176,7 +176,7 @@ async function ensureOpenCV() {
 async function preprocessFrame(framePath, scale) {
   const { data, info } = await sharp(framePath).resize({ width: scale, withoutEnlargement: true }).grayscale().blur(1).raw().toBuffer({ resolveWithObject: true });
   return {
-    data: new Uint8Array(data.buffer),
+    data: new Uint8Array(data.buffer, data.byteOffset, data.byteLength),
     width: info.width,
     height: info.height
   };
@@ -257,16 +257,11 @@ var IoUTracker = class {
   }
 };
 async function computeAKAZEDiff(cvLib, frame1, frame2) {
-  const mat1 = cvLib.matFromImageData({
-    data: frame1.data,
-    width: frame1.width,
-    height: frame1.height
-  });
-  const mat2 = cvLib.matFromImageData({
-    data: frame2.data,
-    width: frame2.width,
-    height: frame2.height
-  });
+  const cv = cvLib;
+  const mat1 = new cv.Mat(frame1.height, frame1.width, cv.CV_8UC1);
+  mat1.data.set(frame1.data);
+  const mat2 = new cv.Mat(frame2.height, frame2.width, cv.CV_8UC1);
+  mat2.data.set(frame2.data);
   const kp1 = new cvLib.KeyPointVector();
   const kp2 = new cvLib.KeyPointVector();
   const desc1 = new cvLib.Mat();
@@ -542,7 +537,7 @@ function isSupportedFile(filePath, extensions) {
 // src/core/extractor.ts
 async function extractFrames(ctx) {
   const framesDir = join2(ctx.workspacePath, "frames");
-  const { inputPath, fps, scale } = ctx.options;
+  const { inputPath, fps, maxFrames, scale } = ctx.options;
   if (!inputPath) {
     throw new Error("inputPath is required for frame extraction");
   }
@@ -559,39 +554,21 @@ async function extractFrames(ctx) {
   }
   logger.debug(`Extracting frames from: ${inputPath}`);
   await ensureDir(framesDir);
-  const isGif = isSupportedFile(inputPath, SUPPORTED_GIF_EXTENSIONS);
-  let frames;
-  if (isGif) {
-    logger.debug("GIF detected \u2014 using FPS extraction");
-    frames = await extractByFps(inputPath, framesDir, fps, scale);
-  } else {
-    frames = await extractIFrames(inputPath, framesDir, scale);
-    if (frames.length < MIN_IFRAME_COUNT) {
-      logger.debug(
-        `Insufficient I-frames (${frames.length}), falling back to FPS mode`
-      );
-      frames = await extractByFps(inputPath, framesDir, fps, scale);
-    }
+  let effectiveFps = fps;
+  const duration = await getVideoDuration(inputPath).catch(() => 0);
+  if (duration > 0) {
+    const fpsCap = maxFrames / duration;
+    effectiveFps = Math.min(fps, fpsCap);
+    effectiveFps = Math.max(0.5, effectiveFps);
+    logger.debug(
+      `Duration: ${duration.toFixed(1)}s, FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
+    );
   }
+  const frames = await extractByFps(inputPath, framesDir, effectiveFps, scale);
   ctx.emitProgress(100);
   logger.debug(`Extracted ${frames.length} frames`);
   return frames;
 }
-async function extractIFrames(inputPath, outputDir, scale) {
-  const outputPattern = join2(outputDir, "frame_%06d.jpg");
-  await execa(ffmpegPath, [
-    "-i",
-    inputPath,
-    "-vf",
-    `select='eq(pict_type,I)',scale=-1:${scale}`,
-    "-vsync",
-    "vfr",
-    "-q:v",
-    "2",
-    outputPattern
-  ]);
-  return buildFrameList(outputDir, inputPath);
-}
 async function extractByFps(inputPath, outputDir, fps, scale) {
   const outputPattern = join2(outputDir, "frame_%06d.jpg");
   await execa(ffmpegPath, [
@@ -642,7 +619,7 @@ async function buildFrameList(framesDir, inputPath) {
 import { join as join4 } from "path";
 
 // src/core/workspace.ts
-import { rename, rm, writeFile } from "fs/promises";
+import { readdir as readdir2, rename, rm, stat as stat2, writeFile } from "fs/promises";
 import { join as join3 } from "path";
 import sharp2 from "sharp";
 async function createWorkspace(sessionId) {
@@ -664,6 +641,7 @@ async function finalizeOutput(ctx, selectedFrames) {
     outputFiles.push(join3(outputPath, destName));
   }
   await ensureDir(join3(outputPath, ".."));
+  await rm(outputPath, { recursive: true, force: true });
   await rename(stagingDir, outputPath);
   return outputFiles;
 }
@@ -674,6 +652,7 @@ async function cleanupWorkspace(workspacePath) {
   } catch {
   }
 }
+var STALE_THRESHOLD_MS = 60 * 60 * 1e3;
 async function writeInputBuffer(buffer, workspacePath) {
   const inputDir = join3(workspacePath, "input");
   await ensureDir(inputDir);
@@ -721,6 +700,7 @@ function resolveOptions(options) {
     pruneMode,
     outputPath,
     fps: options.fps ?? DEFAULT_FPS,
+    maxFrames: options.maxFrames ?? DEFAULT_MAX_FRAMES,
     scale: options.scale ?? DEFAULT_SCALE,
     quality: options.quality ?? DEFAULT_QUALITY,
     debug: options.debug ?? false