cursedbelt 0.0.0

package/dist/react/media/imageEditorSpec.d.ts

@@ -0,0 +1,70 @@
+import type { ImageOutputFormat, ImagePipelineSpec } from '../../core/media';
+import type { ImageEditorOperation } from './types';
+/** filerobot TABS ids (inlined; see react-filerobot-image-editor's `TABS`). */
+export declare const FILEROBOT_TABS: {
+    readonly ADJUST: "Adjust";
+    readonly FINETUNE: "Finetune";
+    readonly FILTERS: "Filters";
+    readonly RESIZE: "Resize";
+    readonly ANNOTATE: "Annotate";
+    readonly WATERMARK: "Watermark";
+};
+export type FilerobotTabId = (typeof FILEROBOT_TABS)[keyof typeof FILEROBOT_TABS];
+/**
+ * Map our capability list to filerobot tab ids. Crop/rotate/flip all live under the
+ * Adjust tab; resize → Resize; filters → Filters + Finetune. `remove-bg` has no
+ * filerobot tab (it is a server pipeline op), so it does not add a tab. `undefined` =
+ * the full default set.
+ */
+export declare function tabsForOperations(ops?: ImageEditorOperation[]): FilerobotTabId[];
+/** The subset of filerobot's `imageDesignState` we translate to pipeline ops. */
+export interface FilerobotDesignState {
+    adjustments?: {
+        crop?: {
+            x?: number;
+            y?: number;
+            width?: number;
+            height?: number;
+        };
+        isFlippedX?: boolean;
+        isFlippedY?: boolean;
+        rotation?: number;
+    };
+    resize?: {
+        width?: number;
+        height?: number;
+    };
+    shownImageDimensions?: {
+        width: number;
+        height: number;
+        scaledBy: number;
+    };
+}
+/**
+ * Translate filerobot design state → an ordered {@link ImagePipelineSpec}. Crop
+ * coordinates are in the SHOWN (scaled) image space, so they are divided by
+ * `scaledBy` back to source pixels. Order: crop → rotate → flip → resize.
+ */
+export declare function filerobotDesignToPipelineSpec(input: {
+    designState: FilerobotDesignState;
+    src: string;
+    output: {
+        format: ImageOutputFormat;
+        quality?: number;
+    };
+}): ImagePipelineSpec;
+/** filerobot's `savedImageData` (the subset we read to build a client blob). */
+export interface FilerobotSavedImage {
+    imageBase64?: string;
+    imageCanvas?: HTMLCanvasElement;
+    mimeType?: string;
+    fullName?: string;
+    name?: string;
+}
+/**
+ * Turn filerobot's saved output into a Blob. Prefers the base64 data URL (carries the
+ * chosen quality); falls back to the canvas. Browser-only (uses fetch/canvas) — never
+ * reached in unit tests, which exercise the pure spec mapper above.
+ */
+export declare function savedImageToBlob(saved: FilerobotSavedImage): Promise<Blob>;
+//# sourceMappingURL=imageEditorSpec.d.ts.map

package/dist/react/media/imageEditorSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageEditorSpec.d.ts","sourceRoot":"","sources":["../../../src/react/media/imageEditorSpec.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAkB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAWlF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,oBAAoB,EAAE,GAAG,cAAc,EAAE,CAwBhF;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE;YAAE,CAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnE,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,oBAAoB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E;AAKD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,oBAAoB,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,GAAG,iBAAiB,CA6BpB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAahF"}

package/dist/react/media/imageEditorSpec.js

@@ -0,0 +1,110 @@
+// Pure glue for <ImageEditor>: filerobot toolbar-tab selection + translation of
+// filerobot's design state into a media-core ImagePipelineSpec (the `server` save
+// path). No React, no filerobot import — so the structural mapping (the bit that must
+// be correct) is unit-tested directly. The filerobot TABS values are inlined as string
+// constants so importing this file never eagerly loads the (large) editor bundle.
+/** filerobot TABS ids (inlined; see react-filerobot-image-editor's `TABS`). */
+export const FILEROBOT_TABS = {
+    ADJUST: 'Adjust',
+    FINETUNE: 'Finetune',
+    FILTERS: 'Filters',
+    RESIZE: 'Resize',
+    ANNOTATE: 'Annotate',
+    WATERMARK: 'Watermark',
+};
+const ALL_TABS = [
+    FILEROBOT_TABS.ADJUST,
+    FILEROBOT_TABS.FINETUNE,
+    FILEROBOT_TABS.FILTERS,
+    FILEROBOT_TABS.RESIZE,
+    FILEROBOT_TABS.ANNOTATE,
+    FILEROBOT_TABS.WATERMARK,
+];
+/**
+ * Map our capability list to filerobot tab ids. Crop/rotate/flip all live under the
+ * Adjust tab; resize → Resize; filters → Filters + Finetune. `remove-bg` has no
+ * filerobot tab (it is a server pipeline op), so it does not add a tab. `undefined` =
+ * the full default set.
+ */
+export function tabsForOperations(ops) {
+    if (!ops || ops.length === 0)
+        return [...ALL_TABS];
+    const tabs = new Set();
+    for (const op of ops) {
+        switch (op) {
+            case 'crop':
+            case 'rotate':
+            case 'flip':
+                tabs.add(FILEROBOT_TABS.ADJUST);
+                break;
+            case 'resize':
+                tabs.add(FILEROBOT_TABS.RESIZE);
+                break;
+            case 'filters':
+                tabs.add(FILEROBOT_TABS.FILTERS);
+                tabs.add(FILEROBOT_TABS.FINETUNE);
+                break;
+            case 'remove-bg':
+                break;
+        }
+    }
+    // Always keep Adjust available so the user can at least crop/rotate.
+    if (tabs.size === 0)
+        tabs.add(FILEROBOT_TABS.ADJUST);
+    return ALL_TABS.filter((t) => tabs.has(t));
+}
+const isPos = (n) => typeof n === 'number' && Number.isFinite(n) && n > 0;
+const isNum = (n) => typeof n === 'number' && Number.isFinite(n);
+/**
+ * Translate filerobot design state → an ordered {@link ImagePipelineSpec}. Crop
+ * coordinates are in the SHOWN (scaled) image space, so they are divided by
+ * `scaledBy` back to source pixels. Order: crop → rotate → flip → resize.
+ */
+export function filerobotDesignToPipelineSpec(input) {
+    const { designState, src, output } = input;
+    const ops = [];
+    const adj = designState.adjustments ?? {};
+    const scaledBy = designState.shownImageDimensions?.scaledBy;
+    const unscale = (v) => (isPos(scaledBy) ? Math.round(v / scaledBy) : Math.round(v));
+    const crop = adj.crop;
+    if (crop && isPos(crop.width) && isPos(crop.height)) {
+        ops.push({
+            type: 'crop',
+            left: Math.max(0, unscale(crop.x ?? 0)),
+            top: Math.max(0, unscale(crop.y ?? 0)),
+            width: unscale(crop.width),
+            height: unscale(crop.height),
+        });
+    }
+    if (isNum(adj.rotation) && adj.rotation % 360 !== 0) {
+        ops.push({ type: 'rotate', angle: adj.rotation });
+    }
+    if (adj.isFlippedX)
+        ops.push({ type: 'flip', direction: 'horizontal' });
+    if (adj.isFlippedY)
+        ops.push({ type: 'flip', direction: 'vertical' });
+    const resize = designState.resize;
+    if (resize && (isPos(resize.width) || isPos(resize.height))) {
+        ops.push({ type: 'resize', width: resize.width, height: resize.height, fit: 'fill' });
+    }
+    return { input: src, operations: ops, output };
+}
+/**
+ * Turn filerobot's saved output into a Blob. Prefers the base64 data URL (carries the
+ * chosen quality); falls back to the canvas. Browser-only (uses fetch/canvas) — never
+ * reached in unit tests, which exercise the pure spec mapper above.
+ */
+export async function savedImageToBlob(saved) {
+    if (saved.imageBase64) {
+        const res = await fetch(saved.imageBase64);
+        return res.blob();
+    }
+    if (saved.imageCanvas) {
+        const canvas = saved.imageCanvas;
+        const blob = await new Promise((resolve) => canvas.toBlob((b) => resolve(b), saved.mimeType ?? 'image/png'));
+        if (blob)
+            return blob;
+    }
+    throw new Error('ImageEditor: save produced no image data');
+}
+//# sourceMappingURL=imageEditorSpec.js.map

package/dist/react/media/imageEditorSpec.js.map

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

package/dist/react/media/index.d.ts

@@ -0,0 +1,11 @@
+export { type AutoMaskCombine, AutoMaskControls, type AutoMaskControlsProps, type AutoMaskSensitivity, } from './AutoMaskControls';
+export { ImageEditor } from './ImageEditor';
+export { MaskPainter } from './MaskPainter';
+export { MediaCatalogueViewer } from './MediaCatalogueViewer';
+export { MediaLightbox, type MediaLightboxProps } from './MediaLightbox';
+export { type MediaPhoto, type MediaVideoSlide, mediaItemsToPhotos, mediaItemsToSlides, mediaItemToPhoto, mediaItemToSlide, } from './mediaPhoto';
+export type { ImageEditorMode, ImageEditorOperation, ImageEditorProps, ImageEditorResult, MaskPainterProps, MaskRegionResult, MediaCatalogueLayout, MediaCatalogueViewerProps, VideoTrimmerProps, } from './types';
+export { useIntersectionObserver } from './useIntersectionObserver';
+export { VideoTrimmer } from './VideoTrimmer';
+export { createVideoThumbnailer, type VideoThumbnailer } from './videoThumbnailer';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/media/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/react/media/index.js

@@ -0,0 +1,18 @@
+// cursedbelt/react/media — the media component subsystem. A DEDICATED entry (not the
+// main `cursedbelt/react` barrel) because its libraries are heavy, browser-only
+// OPTIONAL peers (react-filerobot-image-editor, mediabunny, react-photo-album,
+// @tanstack/react-virtual, yet-another-react-lightbox, @vidstack/react) — apps that
+// don't show media never bundle them, exactly like charts + spreadsheet. Consumers add
+// these to vite `resolve.dedupe` so cursedbelt + the app share one copy.
+//
+//   import { MediaCatalogueViewer, ImageEditor, VideoTrimmer, MaskPainter } from 'cursedbelt/react/media';
+export { AutoMaskControls, } from './AutoMaskControls';
+export { ImageEditor } from './ImageEditor';
+export { MaskPainter } from './MaskPainter';
+export { MediaCatalogueViewer } from './MediaCatalogueViewer';
+export { MediaLightbox } from './MediaLightbox';
+export { mediaItemsToPhotos, mediaItemsToSlides, mediaItemToPhoto, mediaItemToSlide, } from './mediaPhoto';
+export { useIntersectionObserver } from './useIntersectionObserver';
+export { VideoTrimmer } from './VideoTrimmer';
+export { createVideoThumbnailer } from './videoThumbnailer';
+//# sourceMappingURL=index.js.map

package/dist/react/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/media/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,gFAAgF;AAChF,+EAA+E;AAC/E,oFAAoF;AACpF,uFAAuF;AACvF,yEAAyE;AACzE,EAAE;AACF,2GAA2G;AAE3G,OAAO,EAEL,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAA2B,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAGL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAYtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAyB,MAAM,oBAAoB,CAAC"}

package/dist/react/media/maskGeometry.d.ts

@@ -0,0 +1,42 @@
+import type { MaskPoint } from './maskModel';
+export interface MaskView {
+    /** Display px per natural px (contain-fit × zoom). */
+    scale: number;
+    /** Top-left of the rendered image within the canvas, in display px (negative when zoomed
+     *  or panned past an edge). */
+    offsetX: number;
+    offsetY: number;
+    /** The rendered image box size, in display px. */
+    displayWidth: number;
+    displayHeight: number;
+}
+export interface Pan {
+    x: number;
+    y: number;
+}
+/**
+ * Contain-fit the natural image inside the container, apply `zoom`, center it, then add
+ * `pan`. All values are CSS (display) pixels — device-pixel-ratio is a render-only concern
+ * (the backing store is scaled separately), so this stays DPR-independent and identical on
+ * any screen. That independence is what makes the coordinate mapping testable + reliable.
+ */
+export declare function computeMaskView(naturalWidth: number, naturalHeight: number, containerWidth: number, containerHeight: number, zoom?: number, pan?: Pan): MaskView;
+/**
+ * Map a pointer position (client coords) to natural-image pixel coords, given the canvas's
+ * bounding rect + the current view. Returns UNCLAMPED coords — the rasterizer clips strokes
+ * to bounds, so a stroke that runs off the edge still paints the in-bounds part correctly.
+ */
+export declare function displayToNatural(clientX: number, clientY: number, rect: {
+    left: number;
+    top: number;
+}, view: MaskView): MaskPoint;
+/** Map a natural-image point back to display (canvas) coords — used to draw the overlay. */
+export declare function naturalToDisplay(point: MaskPoint, view: MaskView): {
+    x: number;
+    y: number;
+};
+/** Clamp + round a brush diameter to the configured range. */
+export declare function clampBrushSize(size: number, min: number, max: number): number;
+/** Clamp a zoom factor to a sane range so the image can't vanish or explode. */
+export declare function clampZoom(zoom: number, min?: number, max?: number): number;
+//# sourceMappingURL=maskGeometry.d.ts.map

package/dist/react/media/maskGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskGeometry.d.ts","sourceRoot":"","sources":["../../../src/react/media/maskGeometry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd;mCAC+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAUD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,IAAI,SAAI,EACR,GAAG,GAAE,GAAoB,GACxB,QAAQ,CAeV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACnC,IAAI,EAAE,QAAQ,GACb,SAAS,CAMX;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK3F;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAM,EAAE,GAAG,SAAI,GAAG,MAAM,CAGlE"}

package/dist/react/media/maskGeometry.js

@@ -0,0 +1,66 @@
+// Pure geometry mapping the on-screen (display) canvas to the source image's NATURAL pixel
+// grid. The mask is painted in display space but stored + exported in natural space, so this
+// mapping is where dimension exactness is won or lost: a 1px / wrong-scale error shifts the
+// edited region — exactly the failure mode the owner hit with off-tool (Florence2) masks.
+const IDENTITY_VIEW = {
+    scale: 1,
+    offsetX: 0,
+    offsetY: 0,
+    displayWidth: 0,
+    displayHeight: 0,
+};
+/**
+ * Contain-fit the natural image inside the container, apply `zoom`, center it, then add
+ * `pan`. All values are CSS (display) pixels — device-pixel-ratio is a render-only concern
+ * (the backing store is scaled separately), so this stays DPR-independent and identical on
+ * any screen. That independence is what makes the coordinate mapping testable + reliable.
+ */
+export function computeMaskView(naturalWidth, naturalHeight, containerWidth, containerHeight, zoom = 1, pan = { x: 0, y: 0 }) {
+    if (naturalWidth <= 0 || naturalHeight <= 0 || containerWidth <= 0 || containerHeight <= 0) {
+        return IDENTITY_VIEW;
+    }
+    const base = Math.min(containerWidth / naturalWidth, containerHeight / naturalHeight);
+    const scale = base * zoom;
+    const displayWidth = naturalWidth * scale;
+    const displayHeight = naturalHeight * scale;
+    return {
+        scale,
+        offsetX: (containerWidth - displayWidth) / 2 + pan.x,
+        offsetY: (containerHeight - displayHeight) / 2 + pan.y,
+        displayWidth,
+        displayHeight,
+    };
+}
+/**
+ * Map a pointer position (client coords) to natural-image pixel coords, given the canvas's
+ * bounding rect + the current view. Returns UNCLAMPED coords — the rasterizer clips strokes
+ * to bounds, so a stroke that runs off the edge still paints the in-bounds part correctly.
+ */
+export function displayToNatural(clientX, clientY, rect, view) {
+    if (view.scale <= 0)
+        return { x: 0, y: 0 };
+    return {
+        x: (clientX - rect.left - view.offsetX) / view.scale,
+        y: (clientY - rect.top - view.offsetY) / view.scale,
+    };
+}
+/** Map a natural-image point back to display (canvas) coords — used to draw the overlay. */
+export function naturalToDisplay(point, view) {
+    return {
+        x: point.x * view.scale + view.offsetX,
+        y: point.y * view.scale + view.offsetY,
+    };
+}
+/** Clamp + round a brush diameter to the configured range. */
+export function clampBrushSize(size, min, max) {
+    if (!Number.isFinite(size))
+        return min;
+    return Math.max(min, Math.min(max, Math.round(size)));
+}
+/** Clamp a zoom factor to a sane range so the image can't vanish or explode. */
+export function clampZoom(zoom, min = 0.5, max = 8) {
+    if (!Number.isFinite(zoom))
+        return 1;
+    return Math.max(min, Math.min(max, zoom));
+}
+//# sourceMappingURL=maskGeometry.js.map

package/dist/react/media/maskGeometry.js.map

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

package/dist/react/media/maskModel.d.ts

@@ -0,0 +1,65 @@
+/** The active painting tool / mode. `pan` drags the (zoomed) image; `select-*` run the
+ *  injected segmenter on a click / dragged box; `describe` opens the worded-region panel.
+ *  None but the brush/eraser actually paint — the rest are interaction modes over the canvas. */
+export type MaskTool = 'brush' | 'eraser' | 'pan' | 'select-point' | 'select-box' | 'describe';
+/** A single point in the SOURCE image's natural-pixel coordinate space. */
+export interface MaskPoint {
+    x: number;
+    y: number;
+}
+/**
+ * One continuous brush stroke. `paint` adds to the mask, `erase` subtracts. `size` is the
+ * brush DIAMETER in natural pixels, so a stroke covers the same source region at any
+ * zoom/screen.
+ */
+export interface StrokeOp {
+    kind: 'stroke';
+    mode: 'paint' | 'erase';
+    size: number;
+    points: MaskPoint[];
+}
+/**
+ * A whole binary region dropped onto the mask at natural dimensions (0/255 alpha plane):
+ * `replace` overwrites the running mask, `add` unions, `subtract` clears. The product of an
+ * auto-select (click/box/describe) or a resumed `initialMask`. `label` is a short human note
+ * shown in the painter (e.g. "Auto-select", "Loaded mask").
+ */
+export interface RegionOp {
+    kind: 'region';
+    mode: 'replace' | 'add' | 'subtract';
+    mask: Uint8ClampedArray;
+    width: number;
+    height: number;
+    label?: string;
+}
+export type MaskOp = StrokeOp | RegionOp;
+/**
+ * The full editable state. `ops` are committed (in apply order); `redo` holds undone ops for
+ * redo; `inverted` flips the mask meaning (selected = keep) at render + export.
+ */
+export interface MaskModel {
+    ops: MaskOp[];
+    redo: MaskOp[];
+    inverted: boolean;
+}
+export declare function emptyMaskModel(): MaskModel;
+/**
+ * Commit a finished brush stroke. A stroke with no points is dropped (a tap still records
+ * one point — see the component).
+ */
+export declare function commitStroke(model: MaskModel, stroke: Omit<StrokeOp, 'kind'>): MaskModel;
+/** Apply an auto-select / loaded region as an editable, undoable layer. */
+export declare function applyRegion(model: MaskModel, region: Omit<RegionOp, 'kind'>): MaskModel;
+export declare function undo(model: MaskModel): MaskModel;
+export declare function redo(model: MaskModel): MaskModel;
+/** Wipe all ops and the invert flag — a deliberate reset, not part of undo history. */
+export declare function clearAll(): MaskModel;
+export declare function toggleInvert(model: MaskModel): MaskModel;
+export declare function canUndo(model: MaskModel): boolean;
+export declare function canRedo(model: MaskModel): boolean;
+/**
+ * True when there is nothing to export: no ops AND not inverted (an all-black mask). An
+ * inverted-empty model means "the whole image is the change region", so it is NOT empty.
+ */
+export declare function isModelEmpty(model: MaskModel): boolean;
+//# sourceMappingURL=maskModel.d.ts.map

package/dist/react/media/maskModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskModel.d.ts","sourceRoot":"","sources":["../../../src/react/media/maskModel.ts"],"names":[],"mappings":"AAYA;;iGAEiG;AACjG,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAE/F,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,IAAI,SAAS,CAE1C;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,SAAS,CAGxF;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,SAAS,CAEvF;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAIhD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAIhD;AAED,uFAAuF;AACvF,wBAAgB,QAAQ,IAAI,SAAS,CAEpC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAExD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEjD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEtD"}

package/dist/react/media/maskModel.js

@@ -0,0 +1,64 @@
+// Pure, DOM-free model for a mask-painting session: an ordered stack of OPERATIONS plus an
+// undo/redo journal and an invert flag. An op is either a brush/erase STROKE or a REGION (a
+// binary plane dropped in whole — an `initialMask` resumed for editing, or an auto-select
+// result from the <MaskPainter>'s click/box/describe modes, task 52). Folding strokes AND
+// regions through one ordered stack is what makes an auto-mask a first-class, UNDOABLE,
+// refinable layer rather than a separate "base" the brush can't take back.
+//
+// Everything the painter needs to reproduce a mask lives here as plain data, so the whole
+// edit pipeline (auto-select → paint → undo → invert → export) is unit-testable without a
+// canvas — and the natural-dimension export is DERIVED from this model (see maskRaster), never
+// read back from the lossy, DPR-scaled display canvas.
+export function emptyMaskModel() {
+    return { ops: [], redo: [], inverted: false };
+}
+/** Append an op, forking history (the redo journal is cleared on any new edit). */
+function pushOp(model, op) {
+    return { ...model, ops: [...model.ops, op], redo: [] };
+}
+/**
+ * Commit a finished brush stroke. A stroke with no points is dropped (a tap still records
+ * one point — see the component).
+ */
+export function commitStroke(model, stroke) {
+    if (stroke.points.length === 0)
+        return model;
+    return pushOp(model, { kind: 'stroke', ...stroke });
+}
+/** Apply an auto-select / loaded region as an editable, undoable layer. */
+export function applyRegion(model, region) {
+    return pushOp(model, { kind: 'region', ...region });
+}
+export function undo(model) {
+    if (model.ops.length === 0)
+        return model;
+    const last = model.ops[model.ops.length - 1];
+    return { ...model, ops: model.ops.slice(0, -1), redo: [...model.redo, last] };
+}
+export function redo(model) {
+    if (model.redo.length === 0)
+        return model;
+    const next = model.redo[model.redo.length - 1];
+    return { ...model, ops: [...model.ops, next], redo: model.redo.slice(0, -1) };
+}
+/** Wipe all ops and the invert flag — a deliberate reset, not part of undo history. */
+export function clearAll() {
+    return emptyMaskModel();
+}
+export function toggleInvert(model) {
+    return { ...model, inverted: !model.inverted };
+}
+export function canUndo(model) {
+    return model.ops.length > 0;
+}
+export function canRedo(model) {
+    return model.redo.length > 0;
+}
+/**
+ * True when there is nothing to export: no ops AND not inverted (an all-black mask). An
+ * inverted-empty model means "the whole image is the change region", so it is NOT empty.
+ */
+export function isModelEmpty(model) {
+    return model.ops.length === 0 && !model.inverted;
+}
+//# sourceMappingURL=maskModel.js.map

package/dist/react/media/maskModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskModel.js","sourceRoot":"","sources":["../../../src/react/media/maskModel.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,4FAA4F;AAC5F,0FAA0F;AAC1F,0FAA0F;AAC1F,wFAAwF;AACxF,2EAA2E;AAC3E,EAAE;AACF,0FAA0F;AAC1F,0FAA0F;AAC1F,+FAA+F;AAC/F,uDAAuD;AAoDvD,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,SAAS,MAAM,CAAC,KAAgB,EAAE,EAAU;IAC1C,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB,EAAE,MAA8B;IAC3E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,MAA8B;IAC1E,OAAO,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,QAAQ;IACtB,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAgB;IACtC,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAgB;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;AACnD,CAAC"}

package/dist/react/media/maskRaster.d.ts

@@ -0,0 +1,40 @@
+import type { MaskOp } from './maskModel';
+/** Stamp a filled disc of `value` into the alpha plane (clipped to bounds). */
+export declare function paintDisc(alpha: Uint8ClampedArray, width: number, height: number, cx: number, cy: number, radius: number, value: number): void;
+/**
+ * Fold the ordered op stack into the natural-dimension alpha plane. Order matters: an erase
+ * stroke only clears what was painted before it, a `replace` region resets the plane, etc. —
+ * exactly mirroring how the painter's overlay is composited, so what you see is what exports.
+ */
+export declare function rasterizeOps(ops: MaskOp[], width: number, height: number): Uint8ClampedArray;
+/** Threshold an alpha plane to pure 0/255. Anti-aliased input ≥ threshold becomes 255. */
+export declare function binarizeAlpha(alpha: Uint8ClampedArray, threshold?: number): Uint8ClampedArray;
+/**
+ * Reduce a loaded mask image's RGBA pixels to an alpha plane: a pixel counts as painted
+ * (change) when it is opaque and bright (white = change, per the contract). Lets the
+ * component seed a region from an `initialMask` PNG — or a describe-path mask returned by the
+ * compute host — so it resumes as an editable layer.
+ */
+export declare function rgbaToAlpha(rgba: Uint8ClampedArray, threshold?: number): Uint8ClampedArray;
+export interface MaskImageData {
+    /** RGBA pixels, length width*height*4 — opaque black/white. */
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+}
+export interface BuildMaskOptions {
+    ops: MaskOp[];
+    width: number;
+    height: number;
+    inverted?: boolean;
+    threshold?: number;
+}
+/**
+ * The export pipeline as PURE data: fold ops → binarize → (optional) invert → opaque
+ * black/white RGBA at natural dims. WHITE (255,255,255,255) = change, BLACK (0,0,0,255) =
+ * keep — the exact input task 47's `mask_binary_id` expects. The component wraps this in
+ * `new ImageData(...) → putImageData → toBlob('image/png')`; tests assert on it directly,
+ * so "exported PNG is exactly W×H, white only where selected" is verified without a canvas.
+ */
+export declare function buildMaskImageData({ ops, width, height, inverted, threshold, }: BuildMaskOptions): MaskImageData;
+//# sourceMappingURL=maskRaster.d.ts.map

package/dist/react/media/maskRaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskRaster.d.ts","sourceRoot":"","sources":["../../../src/react/media/maskRaster.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,aAAa,CAAC;AAErD,+EAA+E;AAC/E,wBAAgB,SAAS,CACvB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CAeN;AA+CD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAI5F;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,SAAI,GAAG,iBAAiB,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,SAAM,GAAG,iBAAiB,CAOvF;AAED,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,KAAK,EACL,MAAM,EACN,QAAgB,EAChB,SAAa,GACd,EAAE,gBAAgB,GAAG,aAAa,CAalC"}