@beeintel/batch-image 0.0.0-stage → 1.0.0

package/dist/types/batch/features/image-effects/contracts.d.ts

@@ -0,0 +1,58 @@
+import type { PaperTextureV9Request } from './profiles-v9';
+import { type V8ImageEffectParams } from './profiles-v8';
+import type { XeroxNoiseV6Request } from './profiles-v6';
+import type { XeroxNoiseV7Request, V7ImageEffectParams } from './profiles-v7';
+import type { PhotoProcessingAudit } from './photo-audit';
+import type { HoloStickerV5Request } from './profiles-v5';
+import { type V4ImageEffectParams } from './profiles-v4';
+export declare const LEGACY_IMAGE_EFFECT_IDS: readonly ["holo_sticker", "halftone", "duotone", "glitch_art", "motion_blur", "xerox_noise", "textured_glass", "glitch_blur", "lo_fi", "posterize", "ascii_art"];
+export declare const IMAGE_EFFECT_IDS: readonly ["holo_sticker", "halftone", "duotone", "glitch_art", "motion_blur", "xerox_noise", "textured_glass", "glitch_blur", "lo_fi", "posterize", "ascii_art", "light_leak", "engraving", "sparkle", "glow", "lens_flare", "tilt_shift", "paper_texture", "glass_tiles", "watercolor", "dither", "contour_lines", "film_stock", "gradient_map", "tritone", "kaleidoscope", "mirror_collage", "wave_distortion"];
+export type LegacyImageEffectId = (typeof LEGACY_IMAGE_EFFECT_IDS)[number];
+export type ImageEffectId = (typeof IMAGE_EFFECT_IDS)[number];
+export type ImageEffectVersion = '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+export type ImageEffectOutputKind = 'image' | 'svg';
+export type ImageEffectStage = 'decode' | 'process' | 'encode';
+export type ImageEffectProgress = Readonly<{
+    stage: ImageEffectStage;
+    completed: number;
+    total?: number;
+}>;
+export type ImageEffectResult = Readonly<{
+    blob: Blob;
+    mime: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/svg+xml';
+    width: number;
+    height: number;
+    alpha: boolean;
+    outputKind: ImageEffectOutputKind;
+    inputSha256: string;
+    outputSha256: string;
+    stages: readonly ImageEffectProgress[];
+    processingAudit?: PhotoProcessingAudit;
+}>;
+export type ImageEffectsDraft = Readonly<{
+    effectId: ImageEffectId;
+    effectVersion?: ImageEffectVersion;
+    params: Record<string, unknown>;
+}>;
+export type ImageEffectParams = XeroxNoiseV7Request | PaperTextureV9Request | V8ImageEffectParams | V7ImageEffectParams | XeroxNoiseV6Request | HoloStickerV5Request | V4ImageEffectParams | Readonly<{
+    schemaVersion: 1;
+    effectVersion: '1' | '2' | '3';
+    execution: 'browser';
+    effectId: LegacyImageEffectId;
+    params: Readonly<Record<string, unknown>>;
+}>;
+export type LegacyImageEffectParams = Exclude<ImageEffectParams, V4ImageEffectParams | HoloStickerV5Request | XeroxNoiseV6Request | XeroxNoiseV7Request | V7ImageEffectParams | V8ImageEffectParams | PaperTextureV9Request>;
+export declare const V1_EFFECT_IDS: readonly ImageEffectId[];
+export declare const V2_EFFECT_IDS: readonly ImageEffectId[];
+export declare function effectVersion(id: ImageEffectId): ImageEffectVersion;
+export declare function isLegacyImageEffectId(value: unknown): value is LegacyImageEffectId;
+export declare function isImageEffectId(value: unknown): value is ImageEffectId;
+export type ImageEffectCapability = Readonly<{
+    effectId: ImageEffectId;
+    effectVersion: ImageEffectVersion;
+    execution: 'browser-image-effects';
+    outputKind: ImageEffectOutputKind;
+    mime: 'image/png' | 'image/svg+xml';
+    geometry: 'preserve';
+    alpha: 'preserve' | 'resample' | 'cell-opacity' | 'sticker';
+}>;

package/dist/types/batch/features/image-effects/gpu-pixel-runtime.d.ts

@@ -0,0 +1,15 @@
+import { type PhotoPixels } from "./photo-v7-cpu";
+export declare const PHOTO_GPU_FALLBACK_REASONS: readonly ["no-api", "no-adapter", "initialization", "compilation", "device-lost", "limits", "execution", "timeout"];
+export type GpuFallbackReason = (typeof PHOTO_GPU_FALLBACK_REASONS)[number];
+export declare class PhotoGpuError extends Error {
+    readonly reason: GpuFallbackReason;
+    constructor(reason: GpuFallbackReason);
+}
+export type PhotoGpuOptions = Readonly<{
+    fault?: GpuFallbackReason;
+    gpuTimeoutMs?: number;
+}>;
+export declare function runGpuPixels(source: PhotoPixels, dispatch: Readonly<{
+    shader: string;
+    params: () => Float32Array;
+}>, options?: PhotoGpuOptions): Promise<PhotoPixels>;

package/dist/types/batch/features/image-effects/photo-audit.d.ts

@@ -0,0 +1,21 @@
+import { type GpuFallbackReason } from "./gpu-pixel-runtime";
+export type VersionPhotoProcessingAudit<A extends "photo-v7.1" | "photo-v8.1" | "photo-v9.1"> = Readonly<{
+    algorithm: A;
+    width: number;
+    height: number;
+    injected: boolean;
+} & ({
+    backend: "webgpu";
+} | {
+    backend: "cpu";
+    selection: "forced";
+} | {
+    backend: "cpu";
+    selection: "fallback";
+    fallbackReason: GpuFallbackReason;
+})>;
+export type PhotoV7Audit = VersionPhotoProcessingAudit<"photo-v7.1">;
+export type PhotoV8Audit = VersionPhotoProcessingAudit<"photo-v8.1">;
+export type PhotoV9Audit = VersionPhotoProcessingAudit<"photo-v9.1">;
+export type PhotoProcessingAudit = PhotoV7Audit | PhotoV8Audit | PhotoV9Audit;
+export declare function isPhotoProcessingAuditFor(version: "7" | "8" | "9", value: unknown): value is PhotoProcessingAudit;

package/dist/types/batch/features/image-effects/photo-v7-cpu.d.ts

@@ -0,0 +1,9 @@
+import type { V7ImageEffectParams } from './profiles-v7';
+export type PhotoPixels = Readonly<{
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+}>;
+export declare function validatePhotoPixels(source: PhotoPixels): void;
+export declare function photoV7Uniforms(source: PhotoPixels, request: V7ImageEffectParams): Float32Array;
+export declare function renderPhotoV7Cpu(source: PhotoPixels, request: V7ImageEffectParams): PhotoPixels;

package/dist/types/batch/features/image-effects/profiles-v4.d.ts

@@ -0,0 +1,157 @@
+export declare const V4_EFFECT_IDS: readonly ["holo_sticker", "motion_blur", "halftone", "duotone"];
+export type V4EffectId = (typeof V4_EFFECT_IDS)[number];
+declare const ramps: readonly [{
+    readonly id: "fire";
+    readonly colors: readonly ["#000000", "#b41414", "#ffdc32", "#ffffff"];
+}, {
+    readonly id: "ocean";
+    readonly colors: readonly ["#071b40", "#125ec0", "#22c8db", "#e6fbff"];
+}, {
+    readonly id: "viridis";
+    readonly colors: readonly ["#440154", "#3b528b", "#21918c", "#5ec962", "#fde725"];
+}, {
+    readonly id: "plasma";
+    readonly colors: readonly ["#0d0887", "#7e03a8", "#cc4778", "#f89540", "#f0f921"];
+}, {
+    readonly id: "sunset";
+    readonly colors: readonly ["#25124d", "#b83c75", "#ff9a62", "#ffe9a8"];
+}, {
+    readonly id: "forest";
+    readonly colors: readonly ["#082b25", "#287c4b", "#9bc86b", "#eff9bc"];
+}, {
+    readonly id: "lavender";
+    readonly colors: readonly ["#251c48", "#7561ae", "#c7a4dd", "#f7eafa"];
+}, {
+    readonly id: "rose";
+    readonly colors: readonly ["#39172a", "#a03562", "#eb8caa", "#ffe6df"];
+}, {
+    readonly id: "amber";
+    readonly colors: readonly ["#291a0b", "#946018", "#e5b64c", "#fff1bd"];
+}, {
+    readonly id: "ice";
+    readonly colors: readonly ["#122c46", "#447f9f", "#a3dbe3", "#f1ffff"];
+}, {
+    readonly id: "mono";
+    readonly colors: readonly ["#000000", "#ffffff"];
+}, {
+    readonly id: "sepia";
+    readonly colors: readonly ["#24170f", "#806044", "#c3a67d", "#f6ecd3"];
+}];
+export type PaletteId = (typeof ramps)[number]['id'];
+export declare const DUOTONE_PALETTES: readonly Readonly<{
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "fire";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "ocean";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "viridis";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "plasma";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "sunset";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "forest";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "lavender";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "rose";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "amber";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "ice";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "mono";
+} | {
+    colors: readonly ("#000000" | "#b41414" | "#ffdc32" | "#ffffff" | "#071b40" | "#125ec0" | "#22c8db" | "#e6fbff" | "#440154" | "#3b528b" | "#21918c" | "#5ec962" | "#fde725" | "#0d0887" | "#7e03a8" | "#cc4778" | "#f89540" | "#f0f921" | "#25124d" | "#b83c75" | "#ff9a62" | "#ffe9a8" | "#082b25" | "#287c4b" | "#9bc86b" | "#eff9bc" | "#251c48" | "#7561ae" | "#c7a4dd" | "#f7eafa" | "#39172a" | "#a03562" | "#eb8caa" | "#ffe6df" | "#291a0b" | "#946018" | "#e5b64c" | "#fff1bd" | "#122c46" | "#447f9f" | "#a3dbe3" | "#f1ffff" | "#24170f" | "#806044" | "#c3a67d" | "#f6ecd3")[];
+    id: "sepia";
+}>[];
+export type HoloStickerV4Params = Readonly<{
+    holoIntensity: number;
+    holoDensity: number;
+    borderSize: number;
+    topRightPeel: boolean;
+    edgeMaterial: 'holographic' | 'white';
+}>;
+export type MotionBlurV4Params = Readonly<{
+    blurType: 'linear';
+    strength: number;
+    direction: number;
+} | {
+    blurType: 'radial' | 'zoom';
+    strength: number;
+}>;
+export type HalftoneV4Params = Readonly<{
+    dotSize: number;
+    inkAmount: number;
+    softness: number;
+}>;
+export type DuotoneV4Params = Readonly<{
+    preset: PaletteId;
+    intensity: number;
+} | {
+    preset: 'custom';
+    intensity: number;
+    shadowColor: string;
+    highlightColor: string;
+}>;
+export type V4ParamsById = {
+    holo_sticker: HoloStickerV4Params;
+    motion_blur: MotionBlurV4Params;
+    halftone: HalftoneV4Params;
+    duotone: DuotoneV4Params;
+};
+export type V4ImageEffectParams = {
+    [K in V4EffectId]: Readonly<{
+        schemaVersion: 1;
+        effectVersion: '4';
+        execution: 'browser';
+        effectId: K;
+        params: V4ParamsById[K];
+    }>;
+}[V4EffectId];
+export type EffectControl = Readonly<{
+    key: string;
+    kind: 'number' | 'color' | 'select' | 'boolean' | 'palette' | 'material';
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    options?: readonly string[];
+}>;
+export declare const V4_DEFAULTS: {
+    holo_sticker: {
+        holoIntensity: number;
+        holoDensity: number;
+        borderSize: number;
+        topRightPeel: true;
+        edgeMaterial: "holographic";
+    };
+    motion_blur: {
+        blurType: "linear";
+        strength: number;
+        direction: number;
+    };
+    halftone: {
+        dotSize: number;
+        inkAmount: number;
+        softness: number;
+    };
+    duotone: {
+        preset: "ocean";
+        intensity: number;
+    };
+};
+export declare function isV4EffectId(id: unknown): id is V4EffectId;
+export declare function v4Controls(id: V4EffectId, params: Readonly<Record<string, unknown>>): readonly EffectControl[];
+export declare function parseV4Params(id: V4EffectId, input: Readonly<Record<string, unknown>>): V4ImageEffectParams;
+export {};

package/dist/types/batch/features/image-effects/profiles-v5.d.ts

@@ -0,0 +1,20 @@
+import { type EffectControl, type HoloStickerV4Params } from './profiles-v4';
+type CommonHoloParams = Omit<HoloStickerV4Params, 'edgeMaterial'>;
+export type HoloStickerV5Params = Readonly<CommonHoloParams & ({
+    edgeMaterial: 'holographic' | 'white';
+} | {
+    edgeMaterial: 'custom';
+    edgeColor: string;
+})>;
+export type HoloStickerV5Request = Readonly<{
+    schemaVersion: 1;
+    effectVersion: '5';
+    execution: 'browser';
+    effectId: 'holo_sticker';
+    params: HoloStickerV5Params;
+}>;
+export declare const HOLO_STICKER_V5_CUSTOM_COLOR = "#b8a2dc";
+export declare const HOLO_STICKER_V5_DEFAULTS: HoloStickerV5Params;
+export declare function holoStickerV5Controls(params: Readonly<Record<string, unknown>>): readonly EffectControl[];
+export declare function parseHoloStickerV5Params(input: Readonly<Record<string, unknown>>): HoloStickerV5Request;
+export {};

package/dist/types/batch/features/image-effects/profiles-v6.d.ts

@@ -0,0 +1,14 @@
+export type XeroxNoiseV6Params = Readonly<{
+    threshold: number;
+    noise: number;
+    ink: number;
+}>;
+export type XeroxNoiseV6Request = Readonly<{
+    schemaVersion: 1;
+    effectVersion: '6';
+    execution: 'browser';
+    effectId: 'xerox_noise';
+    params: XeroxNoiseV6Params;
+}>;
+export declare const XEROX_NOISE_V6_DEFAULTS: XeroxNoiseV6Params;
+export declare function parseXeroxNoiseV6Params(input: Readonly<Record<string, unknown>>): XeroxNoiseV6Request;

package/dist/types/batch/features/image-effects/profiles-v7.d.ts

@@ -0,0 +1,53 @@
+import { type XeroxNoiseV6Params } from './profiles-v6';
+import type { EffectControl } from './profiles-v4';
+export declare const XEROX_STYLES: readonly ["clear", "standard", "repeated"];
+export type XeroxStyle = (typeof XEROX_STYLES)[number];
+export type XeroxNoiseV7Params = Readonly<XeroxNoiseV6Params & {
+    style: XeroxStyle;
+}>;
+export declare const XEROX_NOISE_V7_DEFAULTS: XeroxNoiseV7Params;
+export type XeroxNoiseV7Request = Readonly<{
+    schemaVersion: 1;
+    effectVersion: '7';
+    execution: 'browser';
+    effectId: 'xerox_noise';
+    params: XeroxNoiseV7Params;
+}>;
+export declare function parseXeroxNoiseV7Params(input: Readonly<Record<string, unknown>>): XeroxNoiseV7Request;
+export declare const V7_EFFECT_IDS: readonly ["textured_glass", "light_leak", "engraving"];
+export type V7EffectId = (typeof V7_EFFECT_IDS)[number];
+export type V7ParamsById = {
+    textured_glass: Readonly<{
+        pattern: 'fluted' | 'waves';
+        angle: number;
+        density: number;
+        refraction: number;
+        highlight: number;
+    }>;
+    light_leak: Readonly<{
+        position: 'left' | 'right' | 'top' | 'bottom';
+        spread: number;
+        intensity: number;
+        color: string;
+    }>;
+    engraving: Readonly<{
+        density: number;
+        angle: number;
+        contrast: number;
+        inkColor: string;
+        paperColor: string;
+    }>;
+};
+export type V7ImageEffectParams = {
+    [K in V7EffectId]: Readonly<{
+        schemaVersion: 1;
+        effectVersion: '7';
+        execution: 'browser';
+        effectId: K;
+        params: V7ParamsById[K];
+    }>;
+}[V7EffectId];
+export declare const V7_DEFAULTS: Readonly<V7ParamsById>;
+export declare function isV7EffectId(value: unknown): value is V7EffectId;
+export declare function v7Controls(id: V7EffectId, _params?: V7ParamsById[V7EffectId]): EffectControl[];
+export declare function parseV7Params(id: V7EffectId, input: Readonly<Record<string, unknown>>): V7ImageEffectParams;

package/dist/types/batch/features/image-effects/profiles-v8.d.ts

@@ -0,0 +1,113 @@
+import type { EffectControl } from "./profiles-v4";
+export declare const V8_EFFECT_IDS: readonly ["sparkle", "glow", "lens_flare", "tilt_shift", "paper_texture", "glass_tiles", "watercolor", "dither", "contour_lines", "film_stock", "gradient_map", "tritone", "kaleidoscope", "mirror_collage", "wave_distortion"];
+export type V8EffectId = (typeof V8_EFFECT_IDS)[number];
+export type V8ParamsById = {
+    sparkle: Readonly<{
+        spacing: number;
+        size: number;
+        strength: number;
+        threshold: number;
+        seed: number;
+    }>;
+    glow: Readonly<{
+        radius: number;
+        strength: number;
+        threshold: number;
+    }>;
+    lens_flare: Readonly<{
+        lightX: number;
+        lightY: number;
+        size: number;
+        strength: number;
+        color: string;
+    }>;
+    tilt_shift: Readonly<{
+        center: number;
+        width: number;
+        angle: number;
+        falloff: number;
+        strength: number;
+    }>;
+    paper_texture: Readonly<{
+        roughness: number;
+        scale: number;
+        strength: number;
+        seed: number;
+    }>;
+    glass_tiles: Readonly<{
+        count: number;
+        refraction: number;
+        angle: number;
+        highlight: number;
+    }>;
+    watercolor: Readonly<{
+        brushSize: number;
+        bleed: number;
+        strength: number;
+        paper: number;
+        seed: number;
+    }>;
+    dither: Readonly<{
+        pattern: "bayer4" | "bayer8";
+        cellSize: number;
+        threshold: number;
+        inkColor: string;
+        paperColor: string;
+    }>;
+    contour_lines: Readonly<{
+        levels: number;
+        lineWidth: number;
+        strength: number;
+        inkColor: string;
+    }>;
+    film_stock: Readonly<{
+        preset: "warm" | "cool" | "faded";
+        strength: number;
+        grain: number;
+        fade: number;
+        seed: number;
+    }>;
+    gradient_map: Readonly<{
+        shadowColor: string;
+        midColor: string;
+        highlightColor: string;
+        strength: number;
+    }>;
+    tritone: Readonly<{
+        shadowColor: string;
+        midColor: string;
+        highlightColor: string;
+        balance: number;
+        softness: number;
+    }>;
+    kaleidoscope: Readonly<{
+        segments: number;
+        rotation: number;
+        zoom: number;
+    }>;
+    mirror_collage: Readonly<{
+        mode: "horizontal" | "vertical" | "quad";
+        centerX: number;
+        centerY: number;
+    }>;
+    wave_distortion: Readonly<{
+        mode: "sine" | "ripple";
+        amplitude: number;
+        frequency: number;
+        angle: number;
+    }>;
+};
+export type V8ImageEffectParams = {
+    [K in V8EffectId]: Readonly<{
+        schemaVersion: 1;
+        effectVersion: "8";
+        execution: "browser";
+        effectId: K;
+        params: V8ParamsById[K];
+    }>;
+}[V8EffectId];
+export declare const V8_DEFAULTS: Readonly<V8ParamsById>;
+export declare function isV8EffectId(value: unknown): value is V8EffectId;
+export declare function v8Controls(id: V8EffectId): EffectControl[];
+export declare function parseV8Params(id: V8EffectId, raw: Readonly<Record<string, unknown>>): V8ImageEffectParams;
+export declare const V8_ALPHA_POLICY: Readonly<Record<V8EffectId, "preserve" | "resample">>;

package/dist/types/batch/features/image-effects/profiles-v9.d.ts

@@ -0,0 +1,20 @@
+import { type V8ParamsById } from './profiles-v8';
+export type PaperTextureV9Params = V8ParamsById['paper_texture'];
+export type PaperTextureV9Request = Readonly<{
+    schemaVersion: 1;
+    effectVersion: '9';
+    execution: 'browser';
+    effectId: 'paper_texture';
+    params: PaperTextureV9Params;
+}>;
+export declare const PAPER_TEXTURE_V9_DEFAULTS: PaperTextureV9Params;
+export declare const paperTextureV9Controls: () => Readonly<{
+    key: string;
+    kind: "number" | "color" | "select" | "boolean" | "palette" | "material";
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    options?: readonly string[];
+}>[];
+export declare function parsePaperTextureV9Params(raw: Readonly<Record<string, unknown>>): PaperTextureV9Request;