cursedbelt 2.7.0 → 3.0.0

package/dist/core/media/renderPlan.d.ts

@@ -1,64 +0,0 @@
-import { type TimelineTrack } from 'cwip/timeline';
-import type { VideoFormat, VideoQuality } from './types';
-/** An auxiliary text file the executor writes before running the commands. */
-export interface RenderPlanFile {
-    name: string;
-    text: string;
-}
-/** One ffmpeg invocation (argv without the binary). */
-export interface FfmpegCommand {
-    args: string[];
-    /** The file this command produces. */
-    outputName: string;
-    /** Output seconds this command encodes — weight for progress reporting
-     * (0 for stream-copy steps, which are ~instant). */
-    encodeSeconds: number;
-    label: string;
-}
-export interface TimelineRenderPlan {
-    files: RenderPlanFile[];
-    commands: FfmpegCommand[];
-    outputName: string;
-    /** Intermediates to delete after the export (NOT the inputs or the output). */
-    intermediateNames: string[];
-    totalEncodeSeconds: number;
-    /** Asset ids the executor must materialize under their mapped file names. */
-    requiredAssetIds: string[];
-}
-export interface NormalizeSpec {
-    width: number;
-    height: number;
-    fps: number;
-    audioRate: number;
-}
-/** 720p30 keeps in-browser (wasm) export times tolerable; hosts can raise it. */
-export declare const DEFAULT_NORMALIZE: NormalizeSpec;
-export interface TimelineRenderOptions {
-    /** assetId → file name in the executor's filesystem. */
-    assetFileNames: Record<string, string>;
-    /** assetId → whether the file HAS an audio stream (default true). Sources
-     * without one get a silent bed so every chunk concats consistently. */
-    assetHasAudio?: Record<string, boolean>;
-    outputName?: string;
-    format?: VideoFormat;
-    quality?: VideoQuality;
-    normalize?: NormalizeSpec;
-    /** Prefix for every intermediate file (default "csrp_"). */
-    intermediatePrefix?: string;
-}
-/**
- * ffmpeg's `atempo` only accepts 0.5–2.0 — chain filters for anything beyond
- * (4× → `atempo=2.0,atempo=2.0`).
- */
-export declare const buildAtempoChain: (speed: number) => string;
-/** Video/audio speed filter fragments for a clip (null at speed 1). */
-export declare const speedFilters: (speed: number) => {
-    video: string;
-    audio: string;
-} | null;
-/**
- * Compile the timeline into an ordered command list. Throws when the first
- * video track has no clips (nothing to render) or an asset is unmapped.
- */
-export declare const buildTimelineRenderPlan: (tracks: TimelineTrack[], options: TimelineRenderOptions) => TimelineRenderPlan;
-//# sourceMappingURL=renderPlan.d.ts.map

package/dist/core/media/renderPlan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"renderPlan.d.ts","sourceRoot":"","sources":["../../../src/core/media/renderPlan.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAiD,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB;wDACoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,aAK/B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;2EACuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAahD,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAGO,CAAC;AAwHxF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,aAAa,EAAE,EACvB,SAAS,qBAAqB,KAC7B,kBAyFF,CAAC"}

package/dist/core/media/renderPlan.js

@@ -1,233 +0,0 @@
-// Timeline → ffmpeg render plan. Pure compiler from a cwip/timeline document to
-// an ordered list of ffmpeg argv commands + auxiliary files — executor-agnostic:
-// the browser runs the SAME plan on ffmpeg.wasm (`react/media/ffmpeg-wasm`) and a
-// server can spawn native ffmpeg against it. Nothing here touches an FS.
-//
-// Pipeline shape (the two-pass normalize+concat that survives mixed sources):
-//   1. per video clip  — extract the source window, apply speed (setpts/atempo),
-//      volume, and NORMALIZE to one spec (scale+pad+fps, resampled audio, a
-//      silent bed when the source has no audio) → chunk_i
-//   2. concat          — all chunks share codec/fps/resolution, so `-c copy`
-//   3. audio mix       — audio-track clips are extracted the same way and
-//      `adelay`ed to their timeline offsets, then `amix`ed under the video lane
-//
-// v1 model notes: ONE video lane (the first video track) — clips are laid
-// end-to-end in timeline order, so close gaps before exporting if you want cuts
-// where the gaps were. Audio clip offsets are their absolute `timelineStart`.
-import { clipDuration, roundSeconds } from 'cwip/timeline';
-import { videoCodecPlan } from './ffmpeg';
-/** 720p30 keeps in-browser (wasm) export times tolerable; hosts can raise it. */
-export const DEFAULT_NORMALIZE = {
-    width: 1280,
-    height: 720,
-    fps: 30,
-    audioRate: 44100,
-};
-/**
- * ffmpeg's `atempo` only accepts 0.5–2.0 — chain filters for anything beyond
- * (4× → `atempo=2.0,atempo=2.0`).
- */
-export const buildAtempoChain = (speed) => {
-    const filters = [];
-    let remaining = speed;
-    while (remaining > 2) {
-        filters.push('atempo=2.0');
-        remaining /= 2;
-    }
-    while (remaining < 0.5) {
-        filters.push('atempo=0.5');
-        remaining /= 0.5;
-    }
-    filters.push(`atempo=${remaining.toFixed(4)}`);
-    return filters.join(',');
-};
-/** Video/audio speed filter fragments for a clip (null at speed 1). */
-export const speedFilters = (speed) => speed === 1
-    ? null
-    : { video: `setpts=${(1 / speed).toFixed(6)}*PTS`, audio: buildAtempoChain(speed) };
-const scalePad = (n) => `scale=${n.width}:${n.height}:force_original_aspect_ratio=decrease,` +
-    `pad=${n.width}:${n.height}:(ow-iw)/2:(oh-ih)/2,fps=${n.fps}`;
-/** The `-vf` chain for one clip: reset timestamps, speed, then normalize.
- * `setpts=PTS-STARTPTS` rebases the extracted window to t=0 — without it a
- * source whose first frame carries a non-zero PTS (common for screen/live
- * recordings) makes the `fps` filter emit a BLACK frame to fill the gap before
- * the real first frame, so the export opens on black instead of the picture. */
-const videoFilter = (clip, normalize) => {
-    const speed = speedFilters(clip.speed);
-    return ['setpts=PTS-STARTPTS', speed?.video, scalePad(normalize)].filter(Boolean).join(',');
-};
-/** The audio chain for one clip: reset timestamps, speed, volume, resample.
- * `asetpts=PTS-STARTPTS` mirrors the video rebase so audio stays aligned. */
-const audioFilter = (clip, normalize) => {
-    const speed = speedFilters(clip.speed);
-    const volume = clip.volume !== 1 ? `volume=${clip.volume.toFixed(3)}` : null;
-    return ['asetpts=PTS-STARTPTS', speed?.audio, volume, `aresample=${normalize.audioRate}`]
-        .filter(Boolean)
-        .join(',');
-};
-const BASE_ARGS = ['-hide_banner', '-nostdin', '-y'];
-const sourceFileOf = (ctx, clip) => {
-    const file = ctx.options.assetFileNames[clip.sourceAssetId];
-    if (!file) {
-        throw new Error(`[renderPlan] no file name mapped for asset "${clip.sourceAssetId}" (clip "${clip.name}") — add it to assetFileNames`);
-    }
-    return file;
-};
-const hasAudio = (ctx, clip) => ctx.options.assetHasAudio?.[clip.sourceAssetId] ?? true;
-/** Extract + normalize one VIDEO clip into a self-contained chunk. */
-const videoChunkCommand = (ctx, clip, index) => {
-    const plan = videoCodecPlan(ctx.options.format, ctx.options.quality);
-    const outputName = `${ctx.prefix}v${index}.${ctx.options.format === 'webm' ? 'webm' : 'mp4'}`;
-    const silent = !hasAudio(ctx, clip);
-    const args = [
-        ...BASE_ARGS,
-        '-ss',
-        String(clip.trackIn),
-        '-to',
-        String(clip.trackOut),
-        '-i',
-        sourceFileOf(ctx, clip),
-        // A silent stereo bed when the source has no audio track, so EVERY chunk
-        // carries an audio stream and the concat/copy step stays consistent.
-        ...(silent
-            ? [
-                '-f',
-                'lavfi',
-                '-t',
-                String(clipDuration(clip)),
-                '-i',
-                `anullsrc=channel_layout=stereo:sample_rate=${ctx.normalize.audioRate}`,
-            ]
-            : []),
-        '-vf',
-        videoFilter(clip, ctx.normalize),
-        ...(silent ? ['-map', '0:v:0', '-map', '1:a:0'] : ['-af', audioFilter(clip, ctx.normalize)]),
-        '-c:v',
-        plan.videoCodec,
-        '-preset',
-        plan.preset,
-        '-crf',
-        String(plan.crf),
-        '-c:a',
-        plan.audioCodec,
-        ...plan.extraOutputArgs,
-        outputName,
-    ];
-    return {
-        args,
-        outputName,
-        encodeSeconds: clipDuration(clip),
-        label: `video clip ${index + 1} (${clip.name})`,
-    };
-};
-/** Extract one AUDIO-track clip as a lone audio chunk (m4a). */
-const audioChunkCommand = (ctx, clip, index) => {
-    const outputName = `${ctx.prefix}a${index}.m4a`;
-    const args = [
-        ...BASE_ARGS,
-        '-ss',
-        String(clip.trackIn),
-        '-to',
-        String(clip.trackOut),
-        '-i',
-        sourceFileOf(ctx, clip),
-        '-vn',
-        '-af',
-        audioFilter(clip, ctx.normalize),
-        '-c:a',
-        'aac',
-        outputName,
-    ];
-    return {
-        args,
-        outputName,
-        encodeSeconds: clipDuration(clip),
-        label: `audio clip ${index + 1} (${clip.name})`,
-    };
-};
-/**
- * Compile the timeline into an ordered command list. Throws when the first
- * video track has no clips (nothing to render) or an asset is unmapped.
- */
-export const buildTimelineRenderPlan = (tracks, options) => {
-    const normalize = options.normalize ?? DEFAULT_NORMALIZE;
-    const prefix = options.intermediatePrefix ?? 'csrp_';
-    const outputName = options.outputName ?? 'output.mp4';
-    const ctx = { options: options, normalize, prefix };
-    const videoTrack = tracks.find((t) => t.type === 'video');
-    const videoClips = [...(videoTrack?.clips ?? [])].sort((a, b) => a.timelineStart - b.timelineStart);
-    if (videoClips.length === 0) {
-        throw new Error('[renderPlan] the timeline has no video clips — nothing to render');
-    }
-    const audioClips = tracks
-        .filter((t) => t.type === 'audio')
-        .flatMap((t) => t.clips)
-        .sort((a, b) => a.timelineStart - b.timelineStart);
-    const commands = [];
-    const files = [];
-    const intermediateNames = [];
-    // 1. video chunks
-    const videoChunks = videoClips.map((clip, i) => videoChunkCommand(ctx, clip, i));
-    commands.push(...videoChunks);
-    intermediateNames.push(...videoChunks.map((c) => c.outputName));
-    // 2. concat (stream copy — chunks are normalized to one spec)
-    const listName = `${prefix}concat.txt`;
-    files.push({ name: listName, text: videoChunks.map((c) => `file '${c.outputName}'`).join('\n') });
-    intermediateNames.push(listName);
-    const needsMix = audioClips.length > 0;
-    const videoLaneName = needsMix ? `${prefix}lane.mp4` : outputName;
-    commands.push({
-        args: [...BASE_ARGS, '-f', 'concat', '-safe', '0', '-i', listName, '-c', 'copy', videoLaneName],
-        outputName: videoLaneName,
-        encodeSeconds: 0,
-        label: 'concat video lane',
-    });
-    // 3. audio mix under the lane
-    if (needsMix) {
-        intermediateNames.push(videoLaneName);
-        const audioChunks = audioClips.map((clip, i) => audioChunkCommand(ctx, clip, i));
-        commands.push(...audioChunks);
-        intermediateNames.push(...audioChunks.map((c) => c.outputName));
-        const inputs = [videoLaneName, ...audioChunks.map((c) => c.outputName)];
-        const delays = audioClips.map((clip, i) => {
-            const ms = Math.max(0, Math.round(clip.timelineStart * 1000));
-            return `[${i + 1}:a]adelay=${ms}|${ms}[d${i}]`;
-        });
-        const mixInputs = ['[0:a]', ...audioClips.map((_, i) => `[d${i}]`)].join('');
-        const filterComplex = [
-            ...delays,
-            `${mixInputs}amix=inputs=${audioClips.length + 1}:duration=first:normalize=0[aout]`,
-        ].join(';');
-        commands.push({
-            args: [
-                ...BASE_ARGS,
-                ...inputs.flatMap((name) => ['-i', name]),
-                '-filter_complex',
-                filterComplex,
-                '-map',
-                '0:v',
-                '-map',
-                '[aout]',
-                '-c:v',
-                'copy',
-                '-c:a',
-                'aac',
-                outputName,
-            ],
-            outputName,
-            // re-encodes the full audio lane under a copied video stream — cheap but
-            // not instant; weight it by the lane length.
-            encodeSeconds: roundSeconds(videoClips.reduce((sum, c) => sum + clipDuration(c), 0)),
-            label: 'mix audio tracks',
-        });
-    }
-    return {
-        files,
-        commands,
-        outputName,
-        intermediateNames,
-        totalEncodeSeconds: roundSeconds(commands.reduce((sum, c) => sum + c.encodeSeconds, 0)),
-        requiredAssetIds: [...new Set([...videoClips, ...audioClips].map((c) => c.sourceAssetId))],
-    };
-};
-//# sourceMappingURL=renderPlan.js.map

package/dist/core/media/renderPlan.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"renderPlan.js","sourceRoot":"","sources":["../../../src/core/media/renderPlan.ts"],"names":[],"mappings":"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"}

package/dist/core/media/segment.d.ts

@@ -1,80 +0,0 @@
-/** A source image as raw RGBA pixels at its working dimensions. */
-export interface SegmentSource {
-    /** RGBA pixels, length `width * height * 4`. */
-    readonly data: Uint8ClampedArray;
-    readonly width: number;
-    readonly height: number;
-}
-/**
- * What to select. `point` = magic-wand from a clicked pixel; `box` = the dominant object
- * inside a dragged rectangle. Coordinates are in the SOURCE pixel space passed in `source`
- * (the painter downscales both the image and the prompt together for large images).
- */
-export type SegmentPrompt = {
-    readonly type: 'point';
-    readonly x: number;
-    readonly y: number;
-} | {
-    readonly type: 'box';
-    readonly x0: number;
-    readonly y0: number;
-    readonly x1: number;
-    readonly y1: number;
-};
-export interface SegmentOptions {
-    /**
-     * Color-distance tolerance (RGB euclidean, 0–441) for region growth: a neighbor joins
-     * the region when it is within this distance of the seed color. Higher = looser (selects
-     * more, leaks across gradients sooner). Default {@link DEFAULT_TOLERANCE}. The painter maps
-     * a 0–100 "sensitivity" slider onto this via {@link sensitivityToTolerance}.
-     */
-    readonly tolerance?: number;
-    /**
-     * Morphological close radius (px) applied after growth to fill speckle + small holes and
-     * smooth the edge. 0 disables it. Default {@link DEFAULT_CLOSE_RADIUS}.
-     */
-    readonly closeRadius?: number;
-}
-/**
- * A promptable image segmenter: `(source, prompt) → binary alpha plane (0/255)` at the
- * source's dimensions, white where selected. `segment` may be sync (the pure region grower)
- * or async (a model-backed engine); the painter always awaits it. `dispose` releases any
- * held resources (e.g. an ONNX session) and is optional.
- */
-export interface ImageSegmenter {
-    /** Stable identifier for diagnostics / telemetry (e.g. `'region-grow'`, `'mobile-sam'`). */
-    readonly id: string;
-    segment(source: SegmentSource, prompt: SegmentPrompt, options?: SegmentOptions): Uint8ClampedArray | Promise<Uint8ClampedArray>;
-    dispose?(): void;
-}
-export declare const DEFAULT_TOLERANCE = 28;
-export declare const DEFAULT_CLOSE_RADIUS = 2;
-/** Map a 0–100 "sensitivity" slider to a growth tolerance. 0 → tight (exact color), 100 →
- *  loose. A gentle quadratic keeps the low end fine-grained where most clicks land. */
-export declare function sensitivityToTolerance(sensitivity: number): number;
-/** 4-connected binary dilate (grow by 1px). */
-export declare function dilateMask(mask: Uint8ClampedArray, width: number, height: number): Uint8ClampedArray;
-/** 4-connected binary erode (shrink by 1px). */
-export declare function erodeMask(mask: Uint8ClampedArray, width: number, height: number): Uint8ClampedArray;
-/** Morphological close (dilate×r then erode×r): fills holes/gaps ≤ ~2·radius and smooths
- *  the edge without changing the overall area. */
-export declare function closeMask(mask: Uint8ClampedArray, width: number, height: number, radius: number): Uint8ClampedArray;
-/** Working size that fits within `maxPixels` while preserving aspect (never upsizes). */
-export declare function fitWorkingSize(width: number, height: number, maxPixels: number): {
-    width: number;
-    height: number;
-    scale: number;
-};
-/** Area-average downscale of an RGBA buffer (stable colors → cleaner growth than nearest). */
-export declare function downscaleRgba(data: Uint8ClampedArray, sw: number, sh: number, dw: number, dh: number): Uint8ClampedArray;
-/** Nearest-neighbor upscale of a 0/255 mask back to the source's natural dimensions. */
-export declare function upscaleMask(mask: Uint8ClampedArray, sw: number, sh: number, dw: number, dh: number): Uint8ClampedArray;
-/**
- * The default, pure region-growing segmenter — no model, no download, instant + offline.
- * `point` grows a magic-wand selection from the clicked pixel; `box` selects the dominant
- * object inside the rectangle by growing from a spread of interior seeds, clipped to the
- * box so it can't leak into the surrounding scene. Always returns a binary alpha plane at
- * the source dimensions; the painter lands it as an editable region for accept/refine.
- */
-export declare function createRegionSegmenter(defaults?: SegmentOptions): ImageSegmenter;
-//# sourceMappingURL=segment.d.ts.map

package/dist/core/media/segment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/core/media/segment.ts"],"names":[],"mappings":"AAcA,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CACL,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;uFACuF;AACvF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGlE;AAqFD,+CAA+C;AAC/C,wBAAgB,UAAU,CACxB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,iBAAiB,CAiBnB;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CACvB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,iBAAiB,CAiBnB;AAED;kDACkD;AAClD,wBAAgB,SAAS,CACvB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,iBAAiB,CAKnB;AAID,yFAAyF;AACzF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAYlD;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,iBAAiB,CAgCnB;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CACzB,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,iBAAiB,CAWnB;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,cAAmB,GAAG,cAAc,CAkCnF"}

package/dist/core/media/segment.js

@@ -1,248 +0,0 @@
-// Pure, dependency-free promptable image segmentation — the engine behind the
-// <MaskPainter>'s "auto-select" (Stage I, task 52). Given a source image's RGBA pixels
-// and a point/box prompt, it produces a BINARY alpha plane (0/255) marking the selected
-// object, which the painter lands as an EDITABLE mask region (never a final answer — the
-// owner refines or discards it). It is the object-select counterpart to {@link floodFillBGS}
-// (which clears an edge-connected BACKGROUND): both grow regions by color similarity, but
-// this one selects a FOREGROUND object from a user prompt and returns a mask, not an alpha.
-//
-// No DOM, no Bun, no npm dep — just typed pixel arrays — so it runs identically in the
-// browser, on a server (sharp's raw RGBA), and in unit tests, and is fully testable with no
-// canvas. The {@link ImageSegmenter} interface is the seam: the default region grower needs
-// no model download (instant, offline), and a heavier engine (SAM2-tiny / MobileSAM via
-// onnxruntime-web) can implement the SAME interface and drop in unchanged.
-export const DEFAULT_TOLERANCE = 28;
-export const DEFAULT_CLOSE_RADIUS = 2;
-/** Map a 0–100 "sensitivity" slider to a growth tolerance. 0 → tight (exact color), 100 →
- *  loose. A gentle quadratic keeps the low end fine-grained where most clicks land. */
-export function sensitivityToTolerance(sensitivity) {
-    const s = Math.max(0, Math.min(100, sensitivity)) / 100;
-    return Math.round(6 + s * s * 150); // ~6 (exact) … 156 (very loose)
-}
-// ── Region growth (the pure CV core) ───────────────────────────────────────────
-/** Flood a single connected region from `seed`, including 4-connected neighbors within
- *  `tolSq` of the SEED color and inside the inclusive `bounds`. Returns a 0/255 mask. */
-function floodFrom(data, width, seed, tolSq, bounds, out, visited, queue) {
-    const [bx0, by0, bx1, by1] = bounds;
-    const [sx, sy] = seed;
-    if (sx < bx0 || sy < by0 || sx > bx1 || sy > by1)
-        return;
-    const seedIdx = sy * width + sx;
-    if (visited[seedIdx])
-        return;
-    const sr = data[seedIdx * 4];
-    const sg = data[seedIdx * 4 + 1];
-    const sb = data[seedIdx * 4 + 2];
-    let head = 0;
-    let tail = 0;
-    visited[seedIdx] = 1;
-    queue[tail++] = seedIdx;
-    while (head < tail) {
-        const idx = queue[head++];
-        out[idx] = 255;
-        const x = idx % width;
-        const y = (idx - x) / width;
-        for (let k = 0; k < 4; k++) {
-            let n;
-            if (k === 0) {
-                if (x <= bx0)
-                    continue;
-                n = idx - 1;
-            }
-            else if (k === 1) {
-                if (x >= bx1)
-                    continue;
-                n = idx + 1;
-            }
-            else if (k === 2) {
-                if (y <= by0)
-                    continue;
-                n = idx - width;
-            }
-            else {
-                if (y >= by1)
-                    continue;
-                n = idx + width;
-            }
-            if (visited[n])
-                continue;
-            const dr = data[n * 4] - sr;
-            const dg = data[n * 4 + 1] - sg;
-            const db = data[n * 4 + 2] - sb;
-            if (dr * dr + dg * dg + db * db <= tolSq) {
-                visited[n] = 1;
-                queue[tail++] = n;
-            }
-        }
-    }
-}
-/** Grow + union a region from one or more seeds (each its own color-relative flood), then
- *  morphologically close it. The shared building block for both prompt types. */
-function growRegion(source, seeds, bounds, tolerance, closeRadius) {
-    const { data, width, height } = source;
-    const px = width * height;
-    const mask = new Uint8ClampedArray(px);
-    const queue = new Int32Array(px);
-    const tolSq = tolerance * tolerance;
-    // Independent floods (fresh `visited` each) unioned into `mask`, so a later seed isn't
-    // starved by an earlier seed's rejected pixels — important for multi-tone box selects.
-    for (const seed of seeds) {
-        floodFrom(data, width, seed, tolSq, bounds, mask, new Uint8Array(px), queue);
-    }
-    return closeRadius > 0 ? closeMask(mask, width, height, closeRadius) : mask;
-}
-// ── Morphology ──────────────────────────────────────────────────────────────────
-/** 4-connected binary dilate (grow by 1px). */
-export function dilateMask(mask, width, height) {
-    const out = new Uint8ClampedArray(mask.length);
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            const i = y * width + x;
-            if (mask[i] ||
-                (x > 0 && mask[i - 1]) ||
-                (x < width - 1 && mask[i + 1]) ||
-                (y > 0 && mask[i - width]) ||
-                (y < height - 1 && mask[i + width])) {
-                out[i] = 255;
-            }
-        }
-    }
-    return out;
-}
-/** 4-connected binary erode (shrink by 1px). */
-export function erodeMask(mask, width, height) {
-    const out = new Uint8ClampedArray(mask.length);
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            const i = y * width + x;
-            if (mask[i] &&
-                (x === 0 || mask[i - 1]) &&
-                (x === width - 1 || mask[i + 1]) &&
-                (y === 0 || mask[i - width]) &&
-                (y === height - 1 || mask[i + width])) {
-                out[i] = 255;
-            }
-        }
-    }
-    return out;
-}
-/** Morphological close (dilate×r then erode×r): fills holes/gaps ≤ ~2·radius and smooths
- *  the edge without changing the overall area. */
-export function closeMask(mask, width, height, radius) {
-    let m = mask;
-    for (let i = 0; i < radius; i++)
-        m = dilateMask(m, width, height);
-    for (let i = 0; i < radius; i++)
-        m = erodeMask(m, width, height);
-    return m;
-}
-// ── Resolution helpers (the painter caps work to keep auto-select ~instant) ──────
-/** Working size that fits within `maxPixels` while preserving aspect (never upsizes). */
-export function fitWorkingSize(width, height, maxPixels) {
-    if (width <= 0 || height <= 0)
-        return { width: 0, height: 0, scale: 1 };
-    const total = width * height;
-    if (total <= maxPixels)
-        return { width, height, scale: 1 };
-    const scale = Math.sqrt(maxPixels / total);
-    // Floor (not round) the dims so the working area is GUARANTEED ≤ maxPixels
-    // (floor(w·s)·floor(h·s) ≤ w·s·h·s = maxPixels), bounding auto-select latency.
-    return {
-        width: Math.max(1, Math.floor(width * scale)),
-        height: Math.max(1, Math.floor(height * scale)),
-        scale,
-    };
-}
-/** Area-average downscale of an RGBA buffer (stable colors → cleaner growth than nearest). */
-export function downscaleRgba(data, sw, sh, dw, dh) {
-    if (dw === sw && dh === sh)
-        return data;
-    const out = new Uint8ClampedArray(dw * dh * 4);
-    for (let y = 0; y < dh; y++) {
-        const sy0 = Math.floor((y * sh) / dh);
-        const sy1 = Math.max(sy0 + 1, Math.floor(((y + 1) * sh) / dh));
-        for (let x = 0; x < dw; x++) {
-            const sx0 = Math.floor((x * sw) / dw);
-            const sx1 = Math.max(sx0 + 1, Math.floor(((x + 1) * sw) / dw));
-            let r = 0;
-            let g = 0;
-            let b = 0;
-            let a = 0;
-            let count = 0;
-            for (let yy = sy0; yy < sy1 && yy < sh; yy++) {
-                for (let xx = sx0; xx < sx1 && xx < sw; xx++) {
-                    const s = (yy * sw + xx) << 2;
-                    r += data[s];
-                    g += data[s + 1];
-                    b += data[s + 2];
-                    a += data[s + 3];
-                    count++;
-                }
-            }
-            const o = (y * dw + x) << 2;
-            out[o] = count ? r / count : 0;
-            out[o + 1] = count ? g / count : 0;
-            out[o + 2] = count ? b / count : 0;
-            out[o + 3] = count ? a / count : 0;
-        }
-    }
-    return out;
-}
-/** Nearest-neighbor upscale of a 0/255 mask back to the source's natural dimensions. */
-export function upscaleMask(mask, sw, sh, dw, dh) {
-    if (sw === dw && sh === dh)
-        return mask;
-    const out = new Uint8ClampedArray(dw * dh);
-    for (let y = 0; y < dh; y++) {
-        const sy = Math.min(sh - 1, Math.floor((y * sh) / dh));
-        for (let x = 0; x < dw; x++) {
-            const sx = Math.min(sw - 1, Math.floor((x * sw) / dw));
-            out[y * dw + x] = mask[sy * sw + sx];
-        }
-    }
-    return out;
-}
-// ── The default engine ────────────────────────────────────────────────────────
-const clampInt = (v, lo, hi) => Math.max(lo, Math.min(hi, Math.round(v)));
-/**
- * The default, pure region-growing segmenter — no model, no download, instant + offline.
- * `point` grows a magic-wand selection from the clicked pixel; `box` selects the dominant
- * object inside the rectangle by growing from a spread of interior seeds, clipped to the
- * box so it can't leak into the surrounding scene. Always returns a binary alpha plane at
- * the source dimensions; the painter lands it as an editable region for accept/refine.
- */
-export function createRegionSegmenter(defaults = {}) {
-    return {
-        id: 'region-grow',
-        segment(source, prompt, options) {
-            const { width, height } = source;
-            if (width <= 0 || height <= 0)
-                return new Uint8ClampedArray(0);
-            const tolerance = options?.tolerance ?? defaults.tolerance ?? DEFAULT_TOLERANCE;
-            const closeRadius = options?.closeRadius ?? defaults.closeRadius ?? DEFAULT_CLOSE_RADIUS;
-            if (prompt.type === 'point') {
-                const seed = [
-                    clampInt(prompt.x, 0, width - 1),
-                    clampInt(prompt.y, 0, height - 1),
-                ];
-                return growRegion(source, [seed], [0, 0, width - 1, height - 1], tolerance, closeRadius);
-            }
-            // box — normalize + clamp, then seed a 3×3 grid of interior points and grow within bounds.
-            const bx0 = clampInt(Math.min(prompt.x0, prompt.x1), 0, width - 1);
-            const by0 = clampInt(Math.min(prompt.y0, prompt.y1), 0, height - 1);
-            const bx1 = clampInt(Math.max(prompt.x0, prompt.x1), 0, width - 1);
-            const by1 = clampInt(Math.max(prompt.y0, prompt.y1), 0, height - 1);
-            const seeds = [];
-            for (let r = 1; r <= 3; r++) {
-                for (let c = 1; c <= 3; c++) {
-                    seeds.push([
-                        clampInt(bx0 + ((bx1 - bx0) * c) / 4, bx0, bx1),
-                        clampInt(by0 + ((by1 - by0) * r) / 4, by0, by1),
-                    ]);
-                }
-            }
-            return growRegion(source, seeds, [bx0, by0, bx1, by1], tolerance, closeRadius);
-        },
-    };
-}
-//# sourceMappingURL=segment.js.map