@workglow/util 0.2.14 → 0.2.16

package/dist/media-node.js.map

@@ -1,11 +1,14 @@
 {
   "version": 3,
-  "sources": ["../src/media/image.ts", "../src/media/image.node.ts"],
+  "sources": ["../src/media/imageTypes.ts", "../src/media/color.ts", "../src/media/imageRasterCodecRegistry.ts", "../src/media/MediaRawImage.ts", "../src/media/Image.ts"],
   "sourcesContent": [
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport type ImageChannels = 1 | 3 | 4; // grayscale, rgb, rgba\n\nexport type ImageDataSupport =\n  | \"Blob\"\n  | \"ImageBinary\"\n  | \"ImageBitmap\"\n  | \"OffscreenCanvas\"\n  | \"VideoFrame\"\n  | \"RawImage\"\n  | \"DataUri\"\n  | \"Sharp\";\n\nexport interface ImageBinary {\n  data: Uint8ClampedArray;\n  width: number;\n  height: number;\n  channels: ImageChannels;\n  rawChannels?: number | undefined;\n}\n\nexport function parseDataUri(dataUri: string): {\n  mimeType: string;\n  base64: string;\n} {\n  const match = dataUri.match(/^data:([^;]+);base64,(.+)$/);\n  if (!match) {\n    throw new Error(\"Invalid base64 data URI\");\n  }\n\n  return {\n    mimeType: match[1], // e.g. \"image/png\"\n    base64: match[2],\n  };\n}\n",
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ImageBinary, ImageChannels, ImageDataSupport } from \"./image\";\nimport { parseDataUri } from \"./image\";\n\nexport { parseDataUri };\nexport type { ImageBinary, ImageChannels, ImageDataSupport };\n\nasync function dataUriToBlob(string: string): Promise<Blob> {\n  const { mimeType, base64 } = parseDataUri(string);\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return new Blob([bytes], { type: mimeType });\n}\n\nexport async function convertImageDataToUseableForm(\n  imageData: unknown,\n  supports: ImageDataSupport[]\n): Promise<unknown> {\n  if (imageData === null || imageData === undefined) {\n    throw new Error(\"Image data is null or undefined\");\n  }\n\n  // first check if the image data is already in the supported format\n  if (supports.includes(\"Blob\") && imageData instanceof Blob) {\n    return imageData;\n  }\n\n  if (\n    supports.includes(\"ImageBinary\") &&\n    typeof imageData === \"object\" &&\n    \"data\" in imageData &&\n    \"width\" in imageData &&\n    \"height\" in imageData &&\n    \"channels\" in imageData\n  ) {\n    return {\n      data: imageData.data,\n      width: imageData.width,\n      height: imageData.height,\n      channels: imageData.channels,\n    };\n  }\n\n  // if not, convert it to the first supported format\n  if (supports.includes(\"Blob\") && typeof imageData === \"string\") {\n    return await dataUriToBlob(imageData);\n  }\n\n  if (\n    supports.includes(\"DataUri\") &&\n    typeof imageData === \"string\" &&\n    imageData.startsWith(\"data:\")\n  ) {\n    return imageData;\n  }\n\n  throw new Error(`Unsupported image data type: ${typeof imageData}`);\n}\n"
+    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport type ImageChannels = 1 | 3 | 4; // grayscale, rgb, rgba\n\nexport type ImageDataSupport =\n  | \"Blob\"\n  | \"ImageBinary\"\n  | \"ImageBitmap\"\n  | \"OffscreenCanvas\"\n  | \"VideoFrame\"\n  | \"RawImage\"\n  | \"DataUri\"\n  | \"Sharp\";\n\nexport interface ImageBinary {\n  data: Uint8ClampedArray;\n  width: number;\n  height: number;\n  channels: ImageChannels;\n  rawChannels?: number | undefined;\n}\n\n/** RGBA pixel buffer (`channels` is always 4). */\nexport type RgbaImageBinary = Readonly<\n  Omit<ImageBinary, \"channels\" | \"rawChannels\"> & { readonly channels: 4 }\n>;\n\nexport function parseDataUri(dataUri: string): {\n  mimeType: string;\n  base64: string;\n} {\n  const match = dataUri.match(/^data:([^;]+);base64,(.+)$/);\n  if (!match) {\n    throw new Error(\"Invalid base64 data URI\");\n  }\n\n  return {\n    mimeType: match[1], // e.g. \"image/png\"\n    base64: match[2],\n  };\n}\n",
+    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport interface ColorObject {\n  readonly r: number;\n  readonly g: number;\n  readonly b: number;\n  readonly a: number;\n}\n\nconst HEX_PATTERN = /^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;\n\n/**\n * Parse a `#RGB` / `#RGBA` / `#RRGGBB` / `#RRGGBBAA` hex color into a {@link ColorObject}.\n * Case-insensitive on input. No whitespace tolerance. Shorthand nibbles are doubled.\n * Throws on any malformed input.\n */\nexport function parseHexColor(hex: string): ColorObject {\n  if (typeof hex !== \"string\" || !HEX_PATTERN.test(hex)) {\n    throw new Error(`Invalid hex color: ${String(hex)}`);\n  }\n  const body = hex.slice(1);\n  const double = (nibble: string): number => parseInt(nibble + nibble, 16);\n  if (body.length === 3) {\n    return { r: double(body[0]!), g: double(body[1]!), b: double(body[2]!), a: 255 };\n  }\n  if (body.length === 4) {\n    return {\n      r: double(body[0]!),\n      g: double(body[1]!),\n      b: double(body[2]!),\n      a: double(body[3]!),\n    };\n  }\n  if (body.length === 6) {\n    return {\n      r: parseInt(body.slice(0, 2), 16),\n      g: parseInt(body.slice(2, 4), 16),\n      b: parseInt(body.slice(4, 6), 16),\n      a: 255,\n    };\n  }\n  return {\n    r: parseInt(body.slice(0, 2), 16),\n    g: parseInt(body.slice(2, 4), 16),\n    b: parseInt(body.slice(4, 6), 16),\n    a: parseInt(body.slice(6, 8), 16),\n  };\n}\n\nconst CHANNEL_MIN = 0;\nconst CHANNEL_MAX = 255;\n\nfunction assertChannel(name: string, value: number): void {\n  if (!Number.isInteger(value) || value < CHANNEL_MIN || value > CHANNEL_MAX) {\n    throw new Error(`Color channel ${name} out of range (0-255 integer): ${value}`);\n  }\n}\n\nfunction byteToHex(value: number): string {\n  return value.toString(16).padStart(2, \"0\");\n}\n\n/**\n * Emit a {@link ColorObject} as `#RRGGBB` when `a === 255`, otherwise `#RRGGBBAA`.\n * Always lowercase, never shorthand. Throws on non-integer or out-of-range channels.\n */\nexport function toHexColor(c: ColorObject): string {\n  assertChannel(\"r\", c.r);\n  assertChannel(\"g\", c.g);\n  assertChannel(\"b\", c.b);\n  assertChannel(\"a\", c.a);\n  const head = `#${byteToHex(c.r)}${byteToHex(c.g)}${byteToHex(c.b)}`;\n  return c.a === 255 ? head : `${head}${byteToHex(c.a)}`;\n}\n\nfunction isInRangeByte(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isInteger(value) && value >= 0 && value <= 255;\n}\n\n/**\n * Type guard for a {@link ColorObject}-shaped value (alpha optional).\n * Does not reject extra properties — JSON Schema validation handles that separately.\n */\nexport function isColorObject(value: unknown): value is ColorObject {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) return false;\n  const candidate = value as Record<string, unknown>;\n  if (!isInRangeByte(candidate.r)) return false;\n  if (!isInRangeByte(candidate.g)) return false;\n  if (!isInRangeByte(candidate.b)) return false;\n  if (candidate.a !== undefined && !isInRangeByte(candidate.a)) return false;\n  return true;\n}\n\n/** Type guard for a hex color string (same regex as `parseHexColor`). */\nexport function isHexColor(value: unknown): value is string {\n  return typeof value === \"string\" && HEX_PATTERN.test(value);\n}\n\n/**\n * Normalize either wire form to a full {@link ColorObject}. Object inputs default\n * `a` to 255. Throws on anything that's neither a valid hex string nor a valid\n * color object.\n */\nexport function resolveColor(\n  value: string | { r: number; g: number; b: number; a?: number }\n): ColorObject {\n  if (typeof value === \"string\") return parseHexColor(value);\n  if (!isColorObject(value)) {\n    throw new Error(`Invalid color value: ${JSON.stringify(value)}`);\n  }\n  return {\n    r: value.r,\n    g: value.g,\n    b: value.b,\n    a: value.a ?? 255,\n  };\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ImageBinary } from \"./imageTypes\";\n\nexport interface ImageRasterCodec {\n  decodeDataUri(dataUri: string): Promise<ImageBinary>;\n  encodeDataUri(image: ImageBinary, mimeType: string): Promise<string>;\n}\n\nlet codec: ImageRasterCodec | null = null;\n\nexport function registerImageRasterCodec(next: ImageRasterCodec): void {\n  codec = next;\n}\n\nexport function getImageRasterCodec(): ImageRasterCodec {\n  if (!codec) {\n    throw new Error(\n      \"Image raster codec is not registered. Ensure you import @workglow/tasks from the browser or Node entry (dist/browser.js or dist/node.js), or call registerImageRasterCodec() during startup.\"\n    );\n  }\n  return codec;\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Structural match for `RawImage` from `@huggingface/transformers`. The HF\n * class carries helpers (`save`, `toCanvas`, `rgb`, ...) that the provider\n * runtime does not invoke on inputs, so a minimal shim over the four data\n * fields is sufficient. If a consumer later needs HF-specific methods we can\n * widen this shim lazily — no need to pull the transformers dep into\n * `@workglow/util/media` today.\n */\nexport class MediaRawImage {\n  readonly data: Uint8ClampedArray;\n  readonly width: number;\n  readonly height: number;\n  readonly channels: number;\n\n  constructor(data: Uint8ClampedArray, width: number, height: number, channels: number) {\n    this.data = data;\n    this.width = width;\n    this.height = height;\n    this.channels = channels;\n  }\n}\n\nexport function isMediaRawImageShape(\n  value: unknown\n): value is { data: Uint8ClampedArray; width: number; height: number; channels: number } {\n  if (!value || typeof value !== \"object\") return false;\n  const v = value as Record<string, unknown>;\n  return (\n    v.data instanceof Uint8ClampedArray &&\n    typeof v.width === \"number\" &&\n    typeof v.height === \"number\" &&\n    typeof v.channels === \"number\"\n  );\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ImageBinary, ImageChannels, ImageDataSupport } from \"./imageTypes\";\nimport { parseDataUri } from \"./imageTypes\";\nimport { getImageRasterCodec } from \"./imageRasterCodecRegistry\";\nimport { MediaRawImage, isMediaRawImageShape } from \"./MediaRawImage\";\n\n/**\n * Legacy wire format: either a raw `data:image/...;base64,...` URI or a\n * serialized {@link ImageBinary} with `data` as a plain number array\n * (`Array.from(Uint8ClampedArray)`) to avoid the indexed-object pitfall\n * when stringified through `JSON.stringify`.\n */\nexport type ImageJson =\n  | string\n  | {\n      readonly data: readonly number[];\n      readonly width: number;\n      readonly height: number;\n      readonly channels: ImageChannels;\n    }\n  | {\n      // Sentinel for transient browser handles (bitmap / videoFrame /\n      // offscreenCanvas) whose pixels haven't been materialized. Lets\n      // JSON.stringify of a workflow holding such an image succeed instead\n      // of throwing; callers must await getPixels() or getDataUri() before\n      // serialization if they need a real round-trip.\n      readonly unsynced: true;\n      readonly kind: ImageSourceKind;\n    };\n\nexport type ImageSourceKind =\n  | \"dataUri\"\n  | \"pixels\"\n  | \"blob\"\n  | \"bitmap\"\n  | \"videoFrame\"\n  | \"offscreenCanvas\";\n\ntype ImageSource =\n  | { readonly kind: \"dataUri\"; readonly dataUri: string; readonly mimeType: string }\n  | { readonly kind: \"pixels\"; readonly pixels: ImageBinary }\n  | { readonly kind: \"blob\"; readonly blob: Blob }\n  | { readonly kind: \"bitmap\"; readonly bitmap: ImageBitmap }\n  | { readonly kind: \"videoFrame\"; readonly frame: VideoFrame }\n  | { readonly kind: \"offscreenCanvas\"; readonly canvas: OffscreenCanvas };\n\nconst IMAGE_BRAND = Symbol.for(\"@workglow/util/media/Image\");\n\nfunction parseDataUriMimeType(dataUri: string): string {\n  const match = dataUri.match(/^data:([^;,]+)/);\n  const raw = match?.[1]?.trim();\n  return raw ? raw.toLowerCase() : \"image/png\";\n}\n\nexport function dataUriToBlob(dataUri: string): Blob {\n  const { mimeType, base64 } = parseDataUri(dataUri);\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return new Blob([bytes], { type: mimeType });\n}\n\nfunction toImageBinary(value: {\n  data: unknown;\n  width: number;\n  height: number;\n  channels: number;\n  rawChannels?: number | undefined;\n}): ImageBinary {\n  const ch = value.channels;\n  if (ch !== 1 && ch !== 3 && ch !== 4) {\n    throw new Error(`Image: unsupported channel count ${ch}`);\n  }\n  const data = coerceToUint8ClampedArray(value.data);\n  return {\n    data,\n    width: value.width,\n    height: value.height,\n    channels: ch,\n    rawChannels: value.rawChannels,\n  };\n}\n\nfunction coerceToUint8ClampedArray(data: unknown): Uint8ClampedArray {\n  if (data instanceof Uint8ClampedArray) {\n    return data;\n  }\n  if (ArrayBuffer.isView(data)) {\n    return new Uint8ClampedArray(\n      (data as ArrayBufferView).buffer,\n      (data as ArrayBufferView).byteOffset,\n      (data as ArrayBufferView).byteLength\n    );\n  }\n  if (Array.isArray(data)) {\n    return Uint8ClampedArray.from(data as ArrayLike<number>);\n  }\n  if (data && typeof data === \"object\") {\n    // Indexed-object form produced by JSON.stringify(Uint8ClampedArray).\n    const obj = data as Record<string, unknown>;\n    const keys = Object.keys(obj);\n    if (keys.length > 0 && keys.every((k) => /^\\d+$/.test(k))) {\n      const arr = new Uint8ClampedArray(keys.length);\n      for (let i = 0; i < keys.length; i++) {\n        arr[i] = Number(obj[String(i)]);\n      }\n      return arr;\n    }\n  }\n  throw new Error(\"Image: pixel data is not array-like\");\n}\n\n/**\n * Unified image representation: holds a single source (dataUri, pixels, blob,\n * bitmap, video frame, or offscreen canvas) and converts on demand.\n *\n * - `toJSON()` normalizes to `{ kind, ... }`; no `Uint8ClampedArray` indexed-\n *   object serialization pitfall.\n * - `fromJSON()` accepts the new discriminated shape **and** legacy shapes\n *   (raw data URI, raw `ImageBinary`, indexed-object `data`) for migration.\n * - `toFirstSupported(supports[])` replaces `convertImageDataToUseableForm`.\n */\nexport class Image {\n  /** @internal brand so `Image.is` works across realms. */\n  readonly [IMAGE_BRAND]: true = true;\n\n  private source: ImageSource;\n  private pixelsCache: ImageBinary | undefined;\n  private dataUriCache: Map<string, string> = new Map();\n  private blobCache: Map<string, Blob> = new Map();\n\n  private constructor(source: ImageSource) {\n    this.source = source;\n  }\n\n  static fromDataUri(dataUri: string): Image {\n    if (!dataUri.startsWith(\"data:\")) {\n      throw new Error(\"Image.fromDataUri: input must start with 'data:'\");\n    }\n    return new Image({ kind: \"dataUri\", dataUri, mimeType: parseDataUriMimeType(dataUri) });\n  }\n\n  static fromPixels(pixels: ImageBinary): Image {\n    return new Image({ kind: \"pixels\", pixels });\n  }\n\n  static fromBlob(blob: Blob): Image {\n    return new Image({ kind: \"blob\", blob });\n  }\n\n  /** Accepts anything `convertImageDataToUseableForm` accepted today, plus `Image`. */\n  static from(value: unknown): Image {\n    if (Image.is(value)) {\n      return value;\n    }\n    if (typeof value === \"string\" && value.startsWith(\"data:\")) {\n      return Image.fromDataUri(value);\n    }\n    if (typeof Blob !== \"undefined\" && value instanceof Blob) {\n      return Image.fromBlob(value);\n    }\n    if (typeof ImageBitmap !== \"undefined\" && value instanceof ImageBitmap) {\n      return new Image({ kind: \"bitmap\", bitmap: value });\n    }\n    if (typeof VideoFrame !== \"undefined\" && value instanceof VideoFrame) {\n      return new Image({ kind: \"videoFrame\", frame: value });\n    }\n    if (typeof OffscreenCanvas !== \"undefined\" && value instanceof OffscreenCanvas) {\n      return new Image({ kind: \"offscreenCanvas\", canvas: value });\n    }\n    if (\n      value &&\n      typeof value === \"object\" &&\n      \"data\" in value &&\n      \"width\" in value &&\n      \"height\" in value &&\n      \"channels\" in value\n    ) {\n      return Image.fromPixels(toImageBinary(value as never));\n    }\n    throw new Error(`Image.from: unsupported image value of type ${typeof value}`);\n  }\n\n  static is(value: unknown): value is Image {\n    return (\n      typeof value === \"object\" &&\n      value !== null &&\n      (value as Record<symbol, unknown>)[IMAGE_BRAND] === true\n    );\n  }\n\n  /**\n   * Reconstruct an {@link Image} from its serialized form. Accepts a raw\n   * `data:` URI string, a pixel-backed object `{data,width,height,channels}`\n   * (with `data` as typed array, plain array, or the indexed-object pitfall\n   * produced by `JSON.stringify(Uint8ClampedArray)`), or an `Image` instance.\n   */\n  static fromJSON(value: unknown): Image {\n    if (Image.is(value)) {\n      return value;\n    }\n    if (typeof value === \"string\" && value.startsWith(\"data:\")) {\n      return Image.fromDataUri(value);\n    }\n    if (\n      value &&\n      typeof value === \"object\" &&\n      (value as { unsynced?: unknown }).unsynced === true\n    ) {\n      const kind = (value as { kind?: unknown }).kind;\n      throw new Error(\n        `Image.fromJSON: cannot reconstruct image from \"unsynced\" sentinel (kind=${String(kind)}); pixels were not materialized before serialization. Call await image.getPixels() before JSON.stringify.`\n      );\n    }\n    if (\n      value &&\n      typeof value === \"object\" &&\n      \"data\" in value &&\n      typeof (value as { width?: unknown }).width === \"number\" &&\n      typeof (value as { height?: unknown }).height === \"number\" &&\n      typeof (value as { channels?: unknown }).channels === \"number\"\n    ) {\n      const v = value as {\n        data: unknown;\n        width: number;\n        height: number;\n        channels: number;\n      };\n      return Image.fromPixels(\n        toImageBinary({\n          data: v.data,\n          width: v.width,\n          height: v.height,\n          channels: v.channels,\n        })\n      );\n    }\n    throw new Error(\"Image.fromJSON: value does not match any known Image shape\");\n  }\n\n  get kind(): ImageSourceKind {\n    return this.source.kind;\n  }\n\n  get mimeType(): string | undefined {\n    if (this.source.kind === \"dataUri\") return this.source.mimeType;\n    if (this.source.kind === \"blob\") return this.source.blob.type || undefined;\n    return undefined;\n  }\n\n  get width(): number | undefined {\n    if (this.source.kind === \"pixels\") return this.source.pixels.width;\n    if (this.source.kind === \"bitmap\") return this.source.bitmap.width;\n    if (this.source.kind === \"offscreenCanvas\") return this.source.canvas.width;\n    if (this.source.kind === \"videoFrame\") return this.source.frame.displayWidth;\n    return this.pixelsCache?.width;\n  }\n\n  get height(): number | undefined {\n    if (this.source.kind === \"pixels\") return this.source.pixels.height;\n    if (this.source.kind === \"bitmap\") return this.source.bitmap.height;\n    if (this.source.kind === \"offscreenCanvas\") return this.source.canvas.height;\n    if (this.source.kind === \"videoFrame\") return this.source.frame.displayHeight;\n    return this.pixelsCache?.height;\n  }\n\n  get channels(): ImageChannels | undefined {\n    if (this.source.kind === \"pixels\") return this.source.pixels.channels;\n    return this.pixelsCache?.channels;\n  }\n\n  async getPixels(): Promise<ImageBinary> {\n    if (this.pixelsCache) return this.pixelsCache;\n    if (this.source.kind === \"pixels\") {\n      this.pixelsCache = this.source.pixels;\n      return this.pixelsCache;\n    }\n    if (this.source.kind === \"dataUri\") {\n      this.pixelsCache = await getImageRasterCodec().decodeDataUri(this.source.dataUri);\n      return this.pixelsCache;\n    }\n    if (this.source.kind === \"blob\") {\n      const dataUri = await blobToDataUri(this.source.blob);\n      this.pixelsCache = await getImageRasterCodec().decodeDataUri(dataUri);\n      return this.pixelsCache;\n    }\n    throw new Error(\n      `Image.getPixels: browser-only source '${this.source.kind}' requires Image.browser augmentation`\n    );\n  }\n\n  async getDataUri(mimeType: string = \"image/png\"): Promise<string> {\n    if (this.source.kind === \"dataUri\") {\n      if (mimeType === this.source.mimeType) {\n        return this.source.dataUri;\n      }\n    }\n    const cached = this.dataUriCache.get(mimeType);\n    if (cached) return cached;\n    const pixels = await this.getPixels();\n    const dataUri = await getImageRasterCodec().encodeDataUri(pixels, mimeType);\n    this.dataUriCache.set(mimeType, dataUri);\n    return dataUri;\n  }\n\n  async getBlob(mimeType: string = \"image/png\"): Promise<Blob> {\n    if (this.source.kind === \"blob\" && (!mimeType || this.source.blob.type === mimeType)) {\n      return this.source.blob;\n    }\n    const cached = this.blobCache.get(mimeType);\n    if (cached) return cached;\n    if (this.source.kind === \"dataUri\" && this.source.mimeType === mimeType) {\n      const blob = dataUriToBlob(this.source.dataUri);\n      this.blobCache.set(mimeType, blob);\n      return blob;\n    }\n    const dataUri = await this.getDataUri(mimeType);\n    const blob = dataUriToBlob(dataUri);\n    this.blobCache.set(mimeType, blob);\n    return blob;\n  }\n\n  /**\n   * Return the first representation in `supports` that can be produced on\n   * this platform. Mirrors the list-order semantics of the former\n   * `convertImageDataToUseableForm`: earlier entries win.\n   */\n  async toFirstSupported(supports: readonly ImageDataSupport[]): Promise<unknown> {\n    const canonical = this.canonicalSupport();\n    if (canonical && supports.includes(canonical)) {\n      return this.currentSourceValue();\n    }\n    for (const want of supports) {\n      switch (want) {\n        case \"ImageBinary\":\n          return this.getPixels();\n        case \"Blob\":\n          return this.getBlob();\n        case \"DataUri\":\n          return this.getDataUri();\n        case \"RawImage\": {\n          const p = await this.getPixels();\n          return new MediaRawImage(p.data, p.width, p.height, p.channels);\n        }\n        case \"ImageBitmap\":\n        case \"VideoFrame\":\n        case \"OffscreenCanvas\": {\n          const asBrowser = this as unknown as {\n            toFirstSupportedBrowser?: (\n              want: ImageDataSupport\n            ) => Promise<unknown> | undefined;\n          };\n          if (asBrowser.toFirstSupportedBrowser) {\n            const produced = await asBrowser.toFirstSupportedBrowser(want);\n            if (produced !== undefined) return produced;\n          }\n          continue;\n        }\n        case \"Sharp\":\n          continue;\n      }\n    }\n    throw new Error(\n      `Image.toFirstSupported: none of [${supports.join(\", \")}] can be produced on this platform`\n    );\n  }\n\n  toJSON(): ImageJson {\n    if (this.source.kind === \"dataUri\") {\n      return this.source.dataUri;\n    }\n    const pixels =\n      this.source.kind === \"pixels\" ? this.source.pixels : this.pixelsCache;\n    if (pixels) {\n      return {\n        data: Array.from(pixels.data),\n        width: pixels.width,\n        height: pixels.height,\n        channels: pixels.channels,\n      };\n    }\n    return { unsynced: true, kind: this.source.kind };\n  }\n\n  private canonicalSupport(): ImageDataSupport | undefined {\n    switch (this.source.kind) {\n      case \"dataUri\":\n        return \"DataUri\";\n      case \"pixels\":\n        return \"ImageBinary\";\n      case \"blob\":\n        return \"Blob\";\n      case \"bitmap\":\n        return \"ImageBitmap\";\n      case \"videoFrame\":\n        return \"VideoFrame\";\n      case \"offscreenCanvas\":\n        return \"OffscreenCanvas\";\n    }\n  }\n\n  /** @internal */\n  getSource(): ImageSource {\n    return this.source;\n  }\n\n  /** @internal */\n  setPixelsCache(pixels: ImageBinary): void {\n    this.pixelsCache = pixels;\n  }\n\n  private currentSourceValue(): unknown {\n    switch (this.source.kind) {\n      case \"dataUri\":\n        return this.source.dataUri;\n      case \"pixels\":\n        return this.source.pixels;\n      case \"blob\":\n        return this.source.blob;\n      case \"bitmap\":\n        return this.source.bitmap;\n      case \"videoFrame\":\n        return this.source.frame;\n      case \"offscreenCanvas\":\n        return this.source.canvas;\n    }\n  }\n}\n\nasync function blobToDataUri(blob: Blob): Promise<string> {\n  const buffer = await blob.arrayBuffer();\n  const bytes = new Uint8Array(buffer);\n  let binary = \"\";\n  const CHUNK = 8192;\n  for (let i = 0; i < bytes.byteLength; i += CHUNK) {\n    binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK));\n  }\n  const mime = blob.type || \"image/png\";\n  return `data:${mime};base64,${btoa(binary)}`;\n}\n\nexport { MediaRawImage, isMediaRawImageShape };\n"
   ],
-  "mappings": ";AA0BO,SAAS,YAAY,CAAC,SAG3B;AAAA,EACA,MAAM,QAAQ,QAAQ,MAAM,4BAA4B;AAAA,EACxD,IAAI,CAAC,OAAO;AAAA,IACV,MAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAAA,EAEA,OAAO;AAAA,IACL,UAAU,MAAM;AAAA,IAChB,QAAQ,MAAM;AAAA,EAChB;AAAA;;AC1BF,eAAe,aAAa,CAAC,QAA+B;AAAA,EAC1D,QAAQ,UAAU,WAAW,aAAa,MAAM;AAAA,EAChD,MAAM,SAAS,KAAK,MAAM;AAAA,EAC1B,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;AAAA,EAC1C,SAAS,IAAI,EAAG,IAAI,OAAO,QAAQ,KAAK;AAAA,IACtC,MAAM,KAAK,OAAO,WAAW,CAAC;AAAA,EAChC;AAAA,EACA,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,MAAM,SAAS,CAAC;AAAA;AAG7C,eAAsB,6BAA6B,CACjD,WACA,UACkB;AAAA,EAClB,IAAI,cAAc,QAAQ,cAAc,WAAW;AAAA,IACjD,MAAM,IAAI,MAAM,iCAAiC;AAAA,EACnD;AAAA,EAGA,IAAI,SAAS,SAAS,MAAM,KAAK,qBAAqB,MAAM;AAAA,IAC1D,OAAO;AAAA,EACT;AAAA,EAEA,IACE,SAAS,SAAS,aAAa,KAC/B,OAAO,cAAc,YACrB,UAAU,aACV,WAAW,aACX,YAAY,aACZ,cAAc,WACd;AAAA,IACA,OAAO;AAAA,MACL,MAAM,UAAU;AAAA,MAChB,OAAO,UAAU;AAAA,MACjB,QAAQ,UAAU;AAAA,MAClB,UAAU,UAAU;AAAA,IACtB;AAAA,EACF;AAAA,EAGA,IAAI,SAAS,SAAS,MAAM,KAAK,OAAO,cAAc,UAAU;AAAA,IAC9D,OAAO,MAAM,cAAc,SAAS;AAAA,EACtC;AAAA,EAEA,IACE,SAAS,SAAS,SAAS,KAC3B,OAAO,cAAc,YACrB,UAAU,WAAW,OAAO,GAC5B;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,IAAI,MAAM,gCAAgC,OAAO,WAAW;AAAA;",
-  "debugId": "75A795737E74157164756E2164756E21",
+  "mappings": "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",
+  "debugId": "DC7CC1D941A4FA1F64756E2164756E21",
   "names": []
 }

package/dist/node.js

@@ -470,6 +470,28 @@ class NullLogger {
     return this;
   }
 }
+// src/utilities/runtimeEnv.ts
+function readRuntimeEnv(name) {
+  if (typeof process !== "undefined" && process.env) {
+    const fromProcess = process.env[name];
+    if (fromProcess !== undefined) {
+      return fromProcess;
+    }
+  }
+  const meta = import.meta.env;
+  if (!meta) {
+    return;
+  }
+  const value = meta[name];
+  if (value === undefined || value === null) {
+    return;
+  }
+  if (typeof value === "boolean") {
+    return value ? "true" : undefined;
+  }
+  return String(value);
+}
+
 // src/logging/LoggerRegistry.ts
 var LOGGER = createServiceToken("logger");
 var VALID_LOG_LEVELS = new Set([
@@ -479,24 +501,18 @@ var VALID_LOG_LEVELS = new Set([
   "error",
   "fatal"
 ]);
-function getEnv(name) {
-  if (typeof process !== "undefined" && process.env) {
-    return process.env[name];
-  }
-  return import.meta.env[name];
-}
 function isTruthy(value) {
   return value !== undefined && value !== "" && value !== "0" && value !== "false";
 }
 function createDefaultLogger() {
-  const levelEnv = getEnv("LOGGER_LEVEL")?.toLowerCase();
+  const levelEnv = readRuntimeEnv("LOGGER_LEVEL")?.toLowerCase();
   if (levelEnv && VALID_LOG_LEVELS.has(levelEnv)) {
     return new ConsoleLogger({
       level: levelEnv,
-      timings: isTruthy(getEnv("LOGGER_TIMINGS"))
+      timings: isTruthy(readRuntimeEnv("LOGGER_TIMINGS"))
     });
   }
-  if (getEnv("DEV")) {
+  if (isTruthy(readRuntimeEnv("DEV"))) {
     return new ConsoleLogger({
       level: "debug",
       timings: true
@@ -1727,20 +1743,14 @@ class OTelTelemetryProvider {
 }
 // src/telemetry/TelemetryRegistry.ts
 var TELEMETRY_PROVIDER = createServiceToken("telemetry");
-function getEnv2(name) {
-  if (typeof process !== "undefined" && process.env) {
-    return process.env[name];
-  }
-  return import.meta.env[name];
-}
 function isTruthy2(value) {
   return value !== undefined && value !== "" && value !== "0" && value !== "false";
 }
 function createDefaultTelemetryProvider() {
-  if (getEnv2("TELEMETRY")?.toLowerCase() === "console") {
+  if (readRuntimeEnv("TELEMETRY")?.toLowerCase() === "console") {
     return new ConsoleTelemetryProvider;
   }
-  if (isTruthy2(getEnv2("DEV")) && getEnv2("NODE_ENV") !== "test" && !isTruthy2(getEnv2("VITEST")) && !isTruthy2(getEnv2("CI"))) {
+  if (isTruthy2(readRuntimeEnv("DEV")) && readRuntimeEnv("NODE_ENV") !== "test" && !isTruthy2(readRuntimeEnv("VITEST")) && !isTruthy2(readRuntimeEnv("CI"))) {
     return new ConsoleTelemetryProvider;
   }
   return new NoopTelemetryProvider;
@@ -2092,4 +2102,4 @@ export {
   BaseError
 };
 
-//# debugId=43034B529CDB208664756E2164756E21
+//# debugId=579D75D2D9C0EBA264756E2164756E21