@lumy-pack/scene-sieve 0.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,79 @@
+export type ProgressPhase = 'EXTRACTING' | 'ANALYZING' | 'PRUNING' | 'FINALIZING';
+export type SieveInput = {
+    mode: 'file';
+    inputPath: string;
+} | {
+    mode: 'buffer';
+    inputBuffer: Buffer;
+} | {
+    mode: 'frames';
+    inputFrames: Buffer[];
+};
+export interface SieveOptionsBase {
+    count?: number;
+    threshold?: number;
+    outputPath?: string;
+    fps?: number;
+    scale?: number;
+    quality?: number;
+    debug?: boolean;
+    onProgress?: (phase: ProgressPhase, percent: number) => void;
+}
+export type SieveOptions = SieveOptionsBase & SieveInput;
+export interface ResolvedOptions {
+    mode: 'file' | 'buffer' | 'frames';
+    inputPath?: string;
+    count: number;
+    threshold?: number;
+    pruneMode: 'count' | 'threshold' | 'threshold-with-cap';
+    outputPath: string;
+    fps: number;
+    scale: number;
+    quality: number;
+    debug: boolean;
+}
+export interface SieveResult {
+    success: boolean;
+    originalFramesCount: number;
+    prunedFramesCount: number;
+    outputFiles: string[];
+    outputBuffers?: Buffer[];
+    executionTimeMs: number;
+}
+export interface FrameNode {
+    id: number;
+    timestamp: number;
+    extractPath: string;
+}
+export interface ScoreEdge {
+    sourceId: number;
+    targetId: number;
+    /**
+     * Information gain score (G(t)) between adjacent frames.
+     * Higher values = greater visual change (state transition) = should be preserved.
+     * Lower values = similar frames (little change) = candidates for pruning.
+     *
+     * Pruner removes frames with the LOWEST scores first (greedy ascending).
+     * Maps directly to G(t) from the vision analysis pipeline.
+     */
+    score: number;
+}
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface DBSCANResult {
+    labels: number[];
+    boundingBoxes: BoundingBox[];
+}
+export interface ProcessContext {
+    options: ResolvedOptions;
+    workspacePath: string;
+    frames: FrameNode[];
+    graph: ScoreEdge[];
+    status: 'INIT' | ProgressPhase | 'SUCCESS' | 'FAILED';
+    emitProgress: (percent: number) => void;
+    error?: Error;
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+export declare function setDebugMode(enabled: boolean): void;
+export declare const logger: {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+};

package/dist/utils/min-heap.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic binary min-heap.
+ *
+ * Elements are ordered by a numeric `score` field.
+ * push/pop: O(log N), size: O(1).
+ */
+export declare class MinHeap<T extends {
+    score: number;
+}> {
+    private readonly h;
+    get size(): number;
+    push(entry: T): void;
+    pop(): T | undefined;
+    private siftUp;
+    private siftDown;
+}

package/dist/utils/paths.d.ts

@@ -0,0 +1,9 @@
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function resolveAbsolute(p: string): string;
+/**
+ * Derive default output directory name from input file path.
+ * e.g., /path/to/video.mp4 -> /path/to/video_scenes
+ */
+export declare function deriveOutputPath(inputPath: string): string;
+export declare function isSupportedFile(filePath: string, extensions: string[]): boolean;

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@lumy-pack/scene-sieve",
+  "version": "0.0.1",
+  "description": "CLI tool for extracting key frames from video and GIF files",
+  "keywords": [
+    "cli",
+    "video",
+    "frames",
+    "scene",
+    "ffmpeg",
+    "opencv"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vincent-kk/lumy-pack.git",
+    "directory": "packages/scene-sieve"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Vincent K. Kelvin",
+    "email": "lunox273@gmail.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": "./dist/cli.mjs",
+  "files": [
+    "dist",
+    "!dist/tsconfig.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "tsup && yarn build:types",
+    "build:types": "tsc -p ./tsconfig.declarations.json",
+    "dev": "tsx src/cli.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"src/**/*.ts\"",
+    "publish:npm": "yarn npm publish --access public",
+    "test": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:run": "vitest run",
+    "version:major": "yarn version major",
+    "version:minor": "yarn version minor",
+    "version:patch": "yarn version patch"
+  },
+  "dependencies": {
+    "@ffprobe-installer/ffprobe": "^1.4.1",
+    "@techstark/opencv-js": "4.12.0-release.1",
+    "cli-progress": "^3.12.0",
+    "commander": "^12.1.0",
+    "ffmpeg-static": "^5.2.0",
+    "fluent-ffmpeg": "^2.1.3",
+    "ora": "^8.0.0",
+    "picocolors": "^1.1.1",
+    "sharp": "^0.33.0"
+  },
+  "devDependencies": {
+    "@types/cli-progress": "^3.11.6",
+    "@types/fluent-ffmpeg": "^2.1.27",
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^3.2.4"
+  }
+}