@beeintel/batch-image 0.0.0-stage → 1.0.0

package/dist/types/batch/features/image-translation/params.d.ts

@@ -0,0 +1,257 @@
+export declare const MAX_TRANSLATION_REGIONS = 12;
+export declare const TRANSLATION_LANGUAGES: {
+    readonly en: "英语";
+    readonly de: "德语";
+    readonly fr: "法语";
+    readonly es: "西班牙语";
+    readonly ja: "日语";
+    readonly it: "意大利语";
+    readonly pt: "葡萄牙语";
+    readonly nl: "荷兰语";
+    readonly pl: "波兰语";
+    readonly sv: "瑞典语";
+    readonly ru: "俄语";
+};
+export type TranslationLanguage = keyof typeof TRANSLATION_LANGUAGES;
+export declare const TRANSLATION_TARGETS: readonly [{
+    readonly locale: "en-US";
+    readonly language: "en";
+    readonly flag: "🇺🇸";
+    readonly country: "US";
+}, {
+    readonly locale: "fr-FR";
+    readonly language: "fr";
+    readonly flag: "🇫🇷";
+    readonly country: "FR";
+}, {
+    readonly locale: "de-DE";
+    readonly language: "de";
+    readonly flag: "🇩🇪";
+    readonly country: "DE";
+}, {
+    readonly locale: "ja-JP";
+    readonly language: "ja";
+    readonly flag: "🇯🇵";
+    readonly country: "JP";
+}, {
+    readonly locale: "es-ES";
+    readonly language: "es";
+    readonly flag: "🇪🇸";
+    readonly country: "ES";
+}, {
+    readonly locale: "es-MX";
+    readonly language: "es";
+    readonly flag: "🇲🇽";
+    readonly country: "MX";
+}, {
+    readonly locale: "en-CA";
+    readonly language: "en";
+    readonly flag: "🇨🇦";
+    readonly country: "CA";
+}, {
+    readonly locale: "en-GB";
+    readonly language: "en";
+    readonly flag: "🇬🇧";
+    readonly country: "UK";
+}, {
+    readonly locale: "fr-CA";
+    readonly language: "fr";
+    readonly flag: "🇨🇦";
+    readonly country: "CA";
+}, {
+    readonly locale: "es-US";
+    readonly language: "es";
+    readonly flag: "🇺🇸";
+    readonly country: "US";
+}, {
+    readonly locale: "it-IT";
+    readonly language: "it";
+    readonly flag: "🇮🇹";
+    readonly country: "IT";
+}, {
+    readonly locale: "en-AU";
+    readonly language: "en";
+    readonly flag: "🇦🇺";
+    readonly country: "AU";
+}, {
+    readonly locale: "en-IN";
+    readonly language: "en";
+    readonly flag: "🇮🇳";
+    readonly country: "IN";
+}, {
+    readonly locale: "fr-BE";
+    readonly language: "fr";
+    readonly flag: "🇧🇪";
+    readonly country: "BE";
+}, {
+    readonly locale: "pt-BR";
+    readonly language: "pt";
+    readonly flag: "🇧🇷";
+    readonly country: "BR";
+}, {
+    readonly locale: "nl-NL";
+    readonly language: "nl";
+    readonly flag: "🇳🇱";
+    readonly country: "NL";
+}, {
+    readonly locale: "pl-PL";
+    readonly language: "pl";
+    readonly flag: "🇵🇱";
+    readonly country: "PL";
+}, {
+    readonly locale: "sv-SE";
+    readonly language: "sv";
+    readonly flag: "🇸🇪";
+    readonly country: "SE";
+}, {
+    readonly locale: "nl-BE";
+    readonly language: "nl";
+    readonly flag: "🇧🇪";
+    readonly country: "BE";
+}, {
+    readonly locale: "ru-RU";
+    readonly language: "ru";
+    readonly flag: "🇷🇺";
+    readonly country: "RU";
+}];
+export type TranslationLocale = (typeof TRANSLATION_TARGETS)[number]['locale'];
+export declare const translationTarget: (locale: unknown) => {
+    readonly locale: "en-US";
+    readonly language: "en";
+    readonly flag: "🇺🇸";
+    readonly country: "US";
+} | {
+    readonly locale: "fr-FR";
+    readonly language: "fr";
+    readonly flag: "🇫🇷";
+    readonly country: "FR";
+} | {
+    readonly locale: "de-DE";
+    readonly language: "de";
+    readonly flag: "🇩🇪";
+    readonly country: "DE";
+} | {
+    readonly locale: "ja-JP";
+    readonly language: "ja";
+    readonly flag: "🇯🇵";
+    readonly country: "JP";
+} | {
+    readonly locale: "es-ES";
+    readonly language: "es";
+    readonly flag: "🇪🇸";
+    readonly country: "ES";
+} | {
+    readonly locale: "es-MX";
+    readonly language: "es";
+    readonly flag: "🇲🇽";
+    readonly country: "MX";
+} | {
+    readonly locale: "en-CA";
+    readonly language: "en";
+    readonly flag: "🇨🇦";
+    readonly country: "CA";
+} | {
+    readonly locale: "en-GB";
+    readonly language: "en";
+    readonly flag: "🇬🇧";
+    readonly country: "UK";
+} | {
+    readonly locale: "fr-CA";
+    readonly language: "fr";
+    readonly flag: "🇨🇦";
+    readonly country: "CA";
+} | {
+    readonly locale: "es-US";
+    readonly language: "es";
+    readonly flag: "🇺🇸";
+    readonly country: "US";
+} | {
+    readonly locale: "it-IT";
+    readonly language: "it";
+    readonly flag: "🇮🇹";
+    readonly country: "IT";
+} | {
+    readonly locale: "en-AU";
+    readonly language: "en";
+    readonly flag: "🇦🇺";
+    readonly country: "AU";
+} | {
+    readonly locale: "en-IN";
+    readonly language: "en";
+    readonly flag: "🇮🇳";
+    readonly country: "IN";
+} | {
+    readonly locale: "fr-BE";
+    readonly language: "fr";
+    readonly flag: "🇧🇪";
+    readonly country: "BE";
+} | {
+    readonly locale: "pt-BR";
+    readonly language: "pt";
+    readonly flag: "🇧🇷";
+    readonly country: "BR";
+} | {
+    readonly locale: "nl-NL";
+    readonly language: "nl";
+    readonly flag: "🇳🇱";
+    readonly country: "NL";
+} | {
+    readonly locale: "pl-PL";
+    readonly language: "pl";
+    readonly flag: "🇵🇱";
+    readonly country: "PL";
+} | {
+    readonly locale: "sv-SE";
+    readonly language: "sv";
+    readonly flag: "🇸🇪";
+    readonly country: "SE";
+} | {
+    readonly locale: "nl-BE";
+    readonly language: "nl";
+    readonly flag: "🇧🇪";
+    readonly country: "BE";
+} | {
+    readonly locale: "ru-RU";
+    readonly language: "ru";
+    readonly flag: "🇷🇺";
+    readonly country: "RU";
+};
+export declare const translationTargetLabel: (locale: unknown, language: TranslationLanguage) => string;
+export declare function selectedTranslationLocale(draft: TranslationDraft): string;
+export type TranslationDraft = {
+    targetCode?: string;
+    targetLanguage: TranslationLanguage | null;
+    targetLocale?: TranslationLocale;
+    termsText: string;
+    notes: string;
+};
+export type TranslationParams = {
+    targetLanguage: TranslationLanguage;
+    targetLocale?: TranslationLocale;
+    preserveTerms: string[];
+    notes: string;
+};
+export type TranslationDetails = {
+    sourceLanguage: string;
+    targetLanguage: TranslationLanguage;
+    targetLocale?: TranslationLocale | null;
+    promptVersion: string;
+    replacements: {
+        source: string;
+        target: string;
+        box: [number, number, number, number];
+    }[];
+    verification?: {
+        passed: boolean;
+        reason: string;
+        remainingSourceText: string[];
+        preservationIssues: string[];
+    };
+};
+export declare const newTranslationDraft: () => TranslationDraft;
+export declare function translationLanguageLabel(value: string): string;
+export declare function translationParams(draft: TranslationDraft): TranslationParams | {
+    targetCode: string;
+};
+export declare function translationError(draft: TranslationDraft): string;
+export declare function translationSkipLabel(code: 'already_target_language' | 'no_editable_text' | undefined): string;

package/dist/types/batch/features/listing-remake/transport.d.ts

@@ -0,0 +1,21 @@
+import { type TaskResponse } from '../../receipts';
+export type PinnedAsset = {
+    assetId: string;
+    assetVersionId: string;
+    sha256: string;
+};
+export type LirSegmentSubmission = {
+    operationId: string;
+    serviceEpoch?: string;
+    params: Record<string, unknown>;
+    references: {
+        clientRequestId: string;
+        itemId: string;
+        inputVersionId: string;
+        asset: PinnedAsset;
+    }[];
+};
+export declare function parseLirSegment(value: unknown, body: LirSegmentSubmission): {
+    segmentId: string;
+    tasks: TaskResponse[];
+};

package/dist/types/batch/features/metadata/bytes.d.mts

@@ -0,0 +1,13 @@
+export const MAX_INPUT: number;
+export const MAX_PACKET: number;
+export function invalid(detail?: string): never;
+export function ascii(bytes: Uint8Array, start?: number, end?: number): string;
+export function starts(bytes: Uint8Array, at: number, text: string): boolean;
+export function encode(value: string): Uint8Array<ArrayBuffer>;
+export function utf8(bytes: Uint8Array): string;
+export function join(parts: ReadonlyArray<Uint8Array>): Uint8Array<ArrayBuffer>;
+export function view(bytes: Uint8Array): DataView<ArrayBufferLike>;
+export function uint32(value: number, little?: boolean): Uint8Array<ArrayBuffer>;
+export function crc32(bytes: Uint8Array): number;
+export function pngChunk(type: string, data: Uint8Array): Uint8Array<ArrayBuffer>;
+export function riffChunk(type: string, data: Uint8Array): Uint8Array<ArrayBuffer>;

package/dist/types/batch/features/metadata/containers.d.mts

@@ -0,0 +1,20 @@
+export interface PngVisitor {
+  header?(header: { width: number; height: number }): void;
+  chunk?(type: string, data: Uint8Array): void;
+  exif?(data: Uint8Array): Uint8Array | undefined;
+  pngText?(text: {
+    type: string;
+    key: string;
+    data: Uint8Array;
+    payload: number;
+    compressed: boolean;
+  }): Uint8Array | undefined;
+}
+
+export function cleanPng(
+  bytes: Uint8Array,
+  params: Record<string, boolean>,
+  removed: Record<string, number>,
+  registerXmp: () => void,
+  visitor?: PngVisitor,
+): Uint8Array;

package/dist/types/batch/features/metadata/declaration.d.mts

@@ -0,0 +1,5 @@
+import type { MetadataCleanResult, DeclarationParams } from './contracts';
+export function declarePerson(bytes: Uint8Array): MetadataCleanResult;
+export function hasPersonDeclaration(bytes: Uint8Array): boolean;
+
+export function validateDeclaration(value: unknown): DeclarationParams;

package/dist/types/batch/features/metadata/engine.d.mts

@@ -0,0 +1,9 @@
+import type { MetadataParams, MetadataCleanResult } from './contracts';
+export type { MetadataParams, MetadataCleanResult, MetadataCategory } from './contracts';
+
+export const DEFAULT_METADATA: Readonly<MetadataParams>;
+export function validateMetadata(value: unknown): MetadataParams;
+/** Selectively remove supported standard fields without decoding or re-encoding pixels.
+ * Malformed containers and unsupported ambiguous metadata fail without modifying input.
+ */
+export function cleanMetadata(bytes: Uint8Array, params: MetadataParams): MetadataCleanResult;

package/dist/types/batch/features/metadata/exchange.d.mts

@@ -0,0 +1,48 @@
+import type { MetadataParams } from './contracts';
+
+export type MetadataFormat = 'png' | 'jpeg' | 'webp';
+export type MetadataMime = 'image/png' | 'image/jpeg' | 'image/webp';
+export interface ImageHeader {
+  readonly format: MetadataFormat;
+  readonly mime: MetadataMime;
+  readonly width: number;
+  readonly height: number;
+  readonly orientation: number;
+  readonly displayWidth: number;
+  readonly displayHeight: number;
+  readonly byteLength: number;
+  readonly pixelCount: number;
+  readonly withinBudget: boolean;
+}
+export interface MetadataText {
+  readonly keyword: string;
+  readonly text: string;
+}
+export interface MetadataSnapshot extends ImageHeader {
+  readonly schemaVersion: 1;
+  readonly packets: {
+    readonly exif: ReadonlyArray<number> | null;
+    readonly xmp: string | null;
+    readonly text: ReadonlyArray<MetadataText>;
+    readonly comments: ReadonlyArray<ReadonlyArray<number>>;
+    readonly photoshop: ReadonlyArray<number> | null;
+    readonly iptc: ReadonlyArray<ReadonlyArray<number>>;
+    readonly opaque: ReadonlyArray<{ readonly kind: string; readonly data: ReadonlyArray<number> }>;
+  };
+  readonly sourceColor: { readonly iccPresent: boolean; readonly iccBytes: number };
+  readonly conversion: { readonly supported: boolean; readonly reasons: ReadonlyArray<string> };
+}
+export interface MetadataRewriteOptions {
+  width: number;
+  height: number;
+  orientation: 1;
+  colorSpace: 'srgb';
+  privacy?: MetadataParams;
+}
+export function inspectImageHeader(bytes: Uint8Array): ImageHeader;
+export function readMetadata(bytes: Uint8Array): MetadataSnapshot;
+export function rewriteMetadata(
+  encodedBytes: Uint8Array,
+  snapshot: MetadataSnapshot,
+  options: MetadataRewriteOptions,
+): Uint8Array;

package/dist/types/batch/features/shadow/contracts.d.ts

@@ -0,0 +1,43 @@
+export interface ShadowParams {
+    version: 1;
+    color: `#${string}`;
+    offsetX: number;
+    offsetY: number;
+    blur: number;
+    opacity: number;
+    lockSize?: boolean;
+}
+export interface AlphaBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ShadowAlphaInspection {
+    bounds?: AlphaBounds;
+    hasTransparency: boolean;
+}
+export interface ShadowGeometry {
+    width: number;
+    height: number;
+    sourceX: number;
+    sourceY: number;
+    padding: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+export type ShadowPixelsResult = {
+    kind: 'analysis';
+    skipped: true;
+    reason: string;
+} | {
+    kind: 'image';
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+    sourceX: number;
+    sourceY: number;
+};

package/dist/types/batch/features/shadow/engine.d.mts

@@ -0,0 +1,33 @@
+import type {
+  ShadowParams,
+  ShadowGeometry,
+  ShadowPixelsResult,
+  AlphaBounds,
+  ShadowAlphaInspection,
+} from './contracts';
+export type {
+  ShadowParams,
+  ShadowGeometry,
+  ShadowPixelsResult,
+  AlphaBounds,
+  ShadowAlphaInspection,
+} from './contracts';
+export const DEFAULT_SHADOW: Readonly<ShadowParams>;
+export function validateShadow(value: unknown): ShadowParams;
+export function inspectShadowAlpha(
+  rgba: Uint8ClampedArray,
+  width: number,
+  height: number,
+): ShadowAlphaInspection;
+export function computeShadowGeometry(
+  width: number,
+  height: number,
+  params: ShadowParams,
+  bounds?: AlphaBounds,
+): ShadowGeometry;
+export function shadowPixels(
+  rgba: Uint8ClampedArray,
+  width: number,
+  height: number,
+  params: ShadowParams,
+): ShadowPixelsResult;

package/dist/types/batch/features/svg-export/download-contract.d.ts

@@ -0,0 +1,33 @@
+import type { Attempt } from '../../model';
+export type SvgDownloadEntry = {
+    attempt: Readonly<Pick<Attempt, 'id' | 'status' | 'exportArtifact' | 'submittedParams'>>;
+    name: string;
+};
+export type SvgDownloadIssue = {
+    attemptId: string;
+    name: string;
+    kind: 'excluded' | 'preparation';
+    reason: string;
+};
+export type SvgDownloadResult = {
+    kind: 'ready';
+    blob: Blob;
+    filename: string;
+    issues: SvgDownloadIssue[];
+} | {
+    kind: 'unavailable';
+    issues: SvgDownloadIssue[];
+} | {
+    kind: 'cancelled';
+};
+export type SvgExportChoice = 'raw' | 'p3' | 'p2' | 'p1';
+export type SvgDownloadVariant = 'raw' | 'optimized';
+export declare function svgDownloadEligibility(entry: SvgDownloadEntry, variant: SvgDownloadVariant, exportChoice?: SvgExportChoice): "failed" | "cancelled" | "waiting_dependency" | "blocked_dependency" | "waiting_source" | "ready_to_submit" | "submitting" | "submission_unknown" | "accepted" | "queued" | "running" | "optimization_disabled";
+export type SvgDownloadInput = {
+    entries: readonly SvgDownloadEntry[];
+    variant: SvgDownloadVariant;
+    container: 'single' | 'zip';
+    readonly exportChoice?: SvgExportChoice;
+    signal?: AbortSignal;
+};
+export type SvgAssetReader = (reference: import('../../public/contracts').WorkspaceAssetReference, signal?: AbortSignal) => Promise<Blob>;

package/dist/types/batch/features/svg-export/download-prepare.d.ts

@@ -0,0 +1,2 @@
+import { type SvgDownloadInput, type SvgDownloadResult, type SvgAssetReader } from './download-contract';
+export declare function prepareSvgDownload(input: SvgDownloadInput, readAsset?: SvgAssetReader): Promise<SvgDownloadResult>;

package/dist/types/batch/features/svg-export/download.d.ts

@@ -0,0 +1,7 @@
+import type { SvgDownloadInput, SvgDownloadResult, SvgAssetReader } from './download-contract';
+export { svgDownloadEligibility } from './download-contract';
+export type { SvgDownloadEntry, SvgDownloadIssue, SvgDownloadResult, SvgDownloadVariant, } from './download-contract';
+export declare function prepareSvgDownload(input: SvgDownloadInput, readAsset?: SvgAssetReader): Promise<SvgDownloadResult>;
+export declare function saveSvgDownload(result: Extract<SvgDownloadResult, {
+    kind: 'ready';
+}>): () => void;

package/dist/types/batch/features/svg-export/imagetracer.d.ts

@@ -0,0 +1,6 @@
+declare module 'imagetracerjs' {
+  const tracer: {
+    imagedataToSVG(image: ImageData, options: Record<string, number | boolean>): string;
+  };
+  export default tracer;
+}

package/dist/types/batch/features/svg-export/optimizer.d.ts

@@ -0,0 +1,2 @@
+export type SvgOptimizationProfile = 'p3' | 'p2' | 'p1';
+export declare function optimizeSvg(source: string, profile?: SvgOptimizationProfile): string;

package/dist/types/batch/ids.d.ts

@@ -0,0 +1 @@
+export declare const newId: (prefix: string) => string;