@lumy-pack/scene-sieve 0.0.9 → 0.0.10

package/dist/types/index.d.ts

@@ -1,129 +0,0 @@
-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;
-    maxFrames?: number;
-    scale?: number;
-    quality?: number;
-    iouThreshold?: number;
-    animationThreshold?: number;
-    debug?: boolean;
-    onProgress?: (phase: ProgressPhase, percent: number) => void;
-    maxSegmentDuration?: number;
-    concurrency?: number;
-}
-export type SieveOptions = SieveOptionsBase & SieveInput;
-export interface ResolvedOptions {
-    mode: 'file' | 'buffer' | 'frames';
-    inputPath?: string;
-    count: number;
-    threshold: number;
-    pruneMode: 'threshold-with-cap';
-    outputPath: string;
-    fps: number;
-    maxFrames: number;
-    scale: number;
-    quality: number;
-    iouThreshold: number;
-    animationThreshold: number;
-    debug: boolean;
-    maxSegmentDuration: number;
-    concurrency: number;
-}
-export interface SieveResult {
-    success: boolean;
-    originalFramesCount: number;
-    prunedFramesCount: number;
-    outputFiles: string[];
-    outputBuffers?: Buffer[];
-    animations?: AnimationMetadata[];
-    video?: VideoMetadata;
-    executionTimeMs: number;
-}
-export interface AnimationMetadata {
-    type: string;
-    boundingBox: BoundingBox;
-    startFrameId: number;
-    endFrameId: number;
-    durationMs: number;
-}
-export interface VideoMetadata {
-    originalDurationMs: number;
-    fps: number;
-    resolution: {
-        width: number;
-        height: 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[];
-    animations?: AnimationMetadata[];
-    status: 'INIT' | ProgressPhase | 'SUCCESS' | 'FAILED';
-    emitProgress: (percent: number) => void;
-    error?: Error;
-}
-export interface AnalysisResult {
-    edges: ScoreEdge[];
-    animations: AnimationMetadata[];
-}
-export interface SegmentPlan {
-    index: number;
-    startTime: number;
-    endTime: number;
-    duration: number;
-    allocatedFrames: number;
-    effectiveFps: number;
-    overlapBefore: number;
-    overlapAfter: number;
-    extractStartTime: number;
-    extractDuration: number;
-}
-export interface SegmentResult {
-    segment: SegmentPlan;
-    frames: FrameNode[];
-    edges: ScoreEdge[];
-    animations: AnimationMetadata[];
-}

package/dist/utils/concurrency.d.ts

@@ -1,5 +0,0 @@
-/**
- * Creates a concurrency limiter that runs at most `limit` tasks in parallel.
- * Lightweight replacement for p-limit to avoid external dependency.
- */
-export declare function concurrencyLimit(limit: number): <T>(fn: () => Promise<T>) => Promise<T>;

package/dist/utils/logger.d.ts

@@ -1,8 +0,0 @@
-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/math.d.ts

@@ -1,27 +0,0 @@
-/**
- * Interface for objects that have a numeric score.
- */
-export interface ScoredItem {
-    score: number;
-}
-/**
- * Normalize raw scores to [0, 1] range via Robust Hybrid Normalization.
- *
- * This model combines two mathematical approaches to provide a stable "relative" threshold:
- *
- * 1. Logistic-Robust-Z (Intensity):
- *    Calculates Z-scores using Median and Median Absolute Deviation (MAD).
- *    Maps these to a sigmoid (logistic) curve. This suppresses noise (scores near median)
- *    and highlights significant signals (outliers) without letting extreme outliers
- *    crush other meaningful transitions.
- *
- * 2. CDF / Percentile Rank (Relative Position):
- *    Maps each score to its percentile rank in the sequence. This ensures that 't'
- *    always has a consistent meaning as a "relative rank" regardless of absolute values.
- *
- * The final score is a weighted sum (NORMALIZATION_ALPHA) of both.
- *
- * @param items - Array of items with scores to normalize
- * @returns normalized scores array (same length as input)
- */
-export declare function normalizeScores<T extends ScoredItem>(items: T[]): number[];

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

@@ -1,16 +0,0 @@
-/**
- * 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

@@ -1,18 +0,0 @@
-export declare function ensureDir(dirPath: string): Promise<void>;
-export declare function fileExists(filePath: string): Promise<boolean>;
-/**
- * Expand leading ~ to homedir. Node's path.resolve() does not expand ~,
- * so paths like ~/Desktop/foo depend on process.cwd() and can produce
- * different results when run from different directories.
- */
-export declare function expandTilde(p: string): string;
-/**
- * Resolve path to absolute. Expands ~ to homedir first so that the result
- * does not depend on process.cwd().
- */
-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;