@lumy-pack/scene-sieve 0.1.0 → 0.2.0

package/dist/types/index.d.ts

@@ -14,6 +14,7 @@ export interface SieveOptionsBase {
     threshold?: number;
     outputPath?: string;
     fps?: number;
+    /** Strict file/buffer candidate frame limit (default: 300); ignored in frames mode. */
     maxFrames?: number;
     scale?: number;
     quality?: number;
@@ -60,8 +61,11 @@ export interface AnimationMetadata {
     durationMs: number;
 }
 export interface VideoMetadata {
+    /** Source duration from ffprobe, or the final candidate timestamp in frames mode. */
     originalDurationMs: number;
+    /** Effective sampling frequency; frames mode uses one frame per second. */
     fps: number;
+    /** Actual output JPEG dimensions; zero when no candidate exists. */
     resolution: {
         width: number;
         height: number;
@@ -97,6 +101,15 @@ export interface DBSCANResult {
 }
 export interface ProcessContext {
     options: ResolvedOptions;
+    /** Actual extraction grid frequency; frames mode uses one-second intervals. */
+    effectiveFps?: number;
+    /** Original video duration reported by ffprobe, in seconds. */
+    sourceDurationSec?: number;
+    /** Dimensions of analysis-space boxes; absent or zero if no pair was analyzed. */
+    analysisResolution?: {
+        width: number;
+        height: number;
+    };
     workspacePath: string;
     frames: FrameNode[];
     graph: ScoreEdge[];
@@ -108,16 +121,23 @@ export interface ProcessContext {
 export interface AnalysisResult {
     edges: ScoreEdge[];
     animations: AnimationMetadata[];
+    /** First analyzed image dimensions, or zero dimensions when no pair exists. */
+    analysisResolution: {
+        width: number;
+        height: number;
+    };
 }
 export interface SegmentPlan {
     index: number;
     startTime: number;
     endTime: number;
     duration: number;
+    /** FFmpeg output limit, including overlap slots; a single segment uses the full budget. */
     allocatedFrames: number;
     effectiveFps: number;
     overlapBefore: number;
     overlapAfter: number;
+    /** First extraction grid time in seconds, including overlap. */
     extractStartTime: number;
     extractDuration: number;
 }
@@ -126,4 +146,9 @@ export interface SegmentResult {
     frames: FrameNode[];
     edges: ScoreEdge[];
     animations: AnimationMetadata[];
+    /** Analysis coordinates retained through merging for output-only box scaling. */
+    analysisResolution: {
+        width: number;
+        height: number;
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumy-pack/scene-sieve",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI tool for extracting key frames from video and GIF files",
   "keywords": [
     "cli",

package/dist/constants.d.ts

@@ -1,32 +0,0 @@
-export declare const APP_NAME = "scene-sieve";
-export declare const DEFAULT_COUNT = 20;
-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_MIN_PERCENTILE = 0.1;
-export declare const NORMALIZATION_MAX_PERCENTILE = 0.9;
-export declare const NORMALIZATION_LOGISTIC_K = 3;
-export declare const NORMALIZATION_ALPHA = 0.4;
-export declare const NORMALIZATION_MAD_COEFFICIENT = 1.4826;
-export declare const NORMALIZATION_MIN_SAMPLE_SIZE = 10;
-export declare const WORKSPACE_PREFIX = "scene-sieve-";
-export declare const TEMP_BASE_DIR: string;
-export declare const FRAME_OUTPUT_EXTENSION = ".jpg";
-export declare const FRAME_FILENAME_PATTERN = "frame_%06d.jpg";
-export declare const OPENCV_BATCH_SIZE = 10;
-export declare const MIN_IFRAME_COUNT = 3;
-export declare const DBSCAN_ALPHA = 0.03;
-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.25;
-export declare const PIXELDIFF_GAUSSIAN_KERNEL = 3;
-export declare const PIXELDIFF_BINARY_THRESHOLD = 30;
-export declare const PIXELDIFF_CONTOUR_MIN_AREA = 100;
-export declare const PIXELDIFF_SAMPLE_SPACING = 8;
-export declare const DEFAULT_MAX_SEGMENT_DURATION = 300;
-export declare const DEFAULT_SEGMENT_CONCURRENCY = 2;
-export declare function getTempWorkspaceDir(sessionId: string): string;