@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/format/CjsImageFormat.js

@@ -0,0 +1,282 @@
+import { CjsFormat } from './CjsFormat.js';
+import { ImageIOResult, Cutout, HostBitmap, BitmapDimensions } from '#imageio';
+import { PixelFormatFromCanonical, PixelFormat, IsCompressedFormat } from '#consts/render-context';
+import { canDecodeDdsBlockFormat, decodeDdsSlice } from '../formats/dds/core/helpers.js';
+
+/** PixelFormat -> the block decoders' format string (the inverse of PixelFormatFromCanonical). */
+const CANONICAL_BY_PIXEL_FORMAT = new Map(Object.entries(PixelFormatFromCanonical).map(([name, value]) => [value, name]));
+
+/** sRGB block formats decode to the sRGB variant of RGBA8; everything else to linear. */
+const SRGB_BLOCK_FORMATS = new Set([PixelFormat.PIXEL_FORMAT_BC1_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_BC2_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_BC3_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_BC7_UNORM_SRGB]);
+
+/**
+ * The base of every image format: it gives each subclass Carbon's image-handler
+ * table and the step that turns a native read into the format a caller asked
+ * for.
+ *
+ * `Format.carbon` IS Carbon's `ImageIO::ImageFormatFunctions`
+ * (imageio/include/Tr2ImageHandler.h:74-80) - `checkExtension`, `readImage`,
+ * `isSaveSupported`, `save` - built per subclass from its hooks, so the ImageIO
+ * registry in resource/imageio can register any image format the way Carbon's
+ * `RegisterImageIOHandlers` registers its handlers. Carbon has seven handlers;
+ * we have more formats, and each one gets the table by extending this class.
+ *
+ * A subclass supplies:
+ * - `static extensions` (already declared by every format) for checkExtension;
+ * - `static readImageNative(bytes, loadParameters, bitmap, metadata)`, which
+ *   fills the bitmap it is handed in its natural format and returns an
+ *   ImageIOResult. It calls methods on the bitmap; it never imports HostBitmap.
+ *
+ * NOT CARBON: `LoadParameters.requestedFormat`. When a caller asks for a format
+ * other than the native one, `readImage` converts after the native read
+ * (`convertImage`): HostBitmap's own ConvertFormat, then block decode. Encoding
+ * to a block format is the next step here, so every image format inherits it
+ * from this one place (/docs/projects/hostbitmap-port.md).
+ */
+class CjsImageFormat extends CjsFormat {
+  /**
+   * Carbon's handler table for this format class, built once per subclass.
+   *
+   * @returns {{checkExtension: Function, readImage: Function, isSaveSupported: Function, save: Function}} The table.
+   */
+  static get carbon() {
+    if (!Object.hasOwn(this, "_carbon")) {
+      this._carbon = {
+        checkExtension: extension => this.checkExtension(extension),
+        readImage: (bytes, loadParameters, bitmap, metadata = null) => this.readImage(bytes, loadParameters, bitmap, metadata),
+        // Not Carbon: see readImageAsync.
+        readImageAsync: (bytes, loadParameters, bitmap, metadata = null) => this.readImageAsync(bytes, loadParameters, bitmap, metadata),
+        isSaveSupported: dimensions => this.isSaveSupported(dimensions),
+        save: (bitmap, metadata = null) => this.save(bitmap, metadata)
+      };
+    }
+    return this._carbon;
+  }
+
+  /**
+   * Whether an extension (without the dot) is one of this format's, case-insensitively.
+   *
+   * @param {string} extension Extension.
+   * @returns {boolean} Whether this format reads it.
+   */
+  static checkExtension(extension) {
+    const wanted = `.${extension.toLowerCase()}`;
+    return this.extensions.includes(wanted);
+  }
+
+  /**
+   * Fill `bitmap` in the format's natural pixel format. Every image format
+   * implements this.
+   *
+   * @param {Uint8Array} _bytes File bytes.
+   * @param {LoadParameters} _loadParameters Load parameters.
+   * @param {object} _bitmap Destination HostBitmap.
+   * @param {object|null} _metadata Optional Metadata out.
+   * @returns {ImageIOResult} The result.
+   */
+  static readImageNative(_bytes, _loadParameters, _bitmap, _metadata) {
+    throw new Error(`${this.name}.readImageNative is not implemented`);
+  }
+
+  /**
+   * Fill a bitmap from one of our readers' RGBA8 outputs (`read(bytes, { emit: "rgba" })`),
+   * for the formats whose decoders already produce one: PNG, JPEG, TGA, GIF.
+   *
+   * The bitmap is a single-mip 2D B8G8R8A8_UNORM image, as Carbon's JPEG handler
+   * and its PNG/TGA handlers for images with alpha produce, and as the texture
+   * pipeline's pack step requires of its inputs (BGRA, BGRX or R8).
+   *
+   * adapted: Carbon's PNG/TGA handlers keep an opaque RGB image as BGRX and a
+   * grey one as R8 (Tr2PngHandler.cpp:125-160, Tr2TgaHandler.cpp:98-110); our
+   * decoders report RGBA only, so those arrive as BGRA with their alpha. The
+   * metadata cutout is the default: the PNG cutout chunk is not read yet.
+   *
+   * @param {object} payload An RGBA8 payload: width, height, data, strideBytes.
+   * @param {object} bitmap Destination HostBitmap.
+   * @param {object|null} [metadata] Optional Metadata out.
+   * @returns {ImageIOResult} The result.
+   */
+  static readImageFromRgbaPayload(payload, bitmap, metadata = null) {
+    if (!(payload.data instanceof Uint8Array)) {
+      return new ImageIOResult(ImageIOResult.Code.HEADER_NOT_SUPPORTED, `${payload.pixelFormat} is not an 8-bit image`);
+    }
+    if (!bitmap.Create(payload.width, payload.height, 1, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM)) {
+      return new ImageIOResult(ImageIOResult.Code.ERROR_CREATING_BITMAP);
+    }
+    const dst = bitmap.GetRawData();
+    const row = payload.width * 4;
+    const stride = payload.strideBytes || row;
+    for (let y = 0; y < payload.height; y++) {
+      dst.set(payload.data.subarray(y * stride, y * stride + row), y * row);
+    }
+    bitmap.ConvertFormat(PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM);
+    if (metadata) metadata.cutout = new Cutout();
+    return new ImageIOResult(ImageIOResult.Code.OK);
+  }
+
+  /**
+   * The asynchronous native read. Defaults to the synchronous one; a format
+   * whose decoder is asynchronous (PNG, which inflates through the browser's
+   * DecompressionStream) overrides this instead.
+   *
+   * @param {Uint8Array} bytes File bytes.
+   * @param {LoadParameters} loadParameters Load parameters.
+   * @param {object} bitmap Destination HostBitmap.
+   * @param {object|null} metadata Optional Metadata out.
+   * @returns {Promise<ImageIOResult>} The result.
+   */
+  static async readImageNativeAsync(bytes, loadParameters, bitmap, metadata) {
+    return this.readImageNative(bytes, loadParameters, bitmap, metadata);
+  }
+
+  /**
+   * `readImage` for any image format, including those whose decoder is
+   * asynchronous.
+   *
+   * Not Carbon: Carbon's ReadImage is synchronous because its zlib is. In a
+   * browser, inflation is DecompressionStream, which has only an asynchronous
+   * API, so PNG cannot answer the synchronous call. Resource loading is
+   * asynchronous anyway; every format answers this one.
+   *
+   * @param {Uint8Array} bytes File bytes.
+   * @param {LoadParameters} loadParameters Load parameters.
+   * @param {object} bitmap Destination HostBitmap.
+   * @param {object|null} [metadata] Optional Metadata out.
+   * @returns {Promise<ImageIOResult>} The result.
+   */
+  static async readImageAsync(bytes, loadParameters, bitmap, metadata = null) {
+    const result = await this.readImageNativeAsync(bytes, loadParameters, bitmap, metadata);
+    return this._finishRead(result, loadParameters, bitmap);
+  }
+
+  /**
+   * Read an image into `bitmap`, then convert it to `loadParameters.requestedFormat`
+   * when one is asked for.
+   *
+   * @param {Uint8Array} bytes File bytes.
+   * @param {LoadParameters} loadParameters Load parameters.
+   * @param {object} bitmap Destination HostBitmap.
+   * @param {object|null} [metadata] Optional Metadata out.
+   * @returns {ImageIOResult} The result.
+   */
+  static readImage(bytes, loadParameters, bitmap, metadata = null) {
+    return this._finishRead(this.readImageNative(bytes, loadParameters, bitmap, metadata), loadParameters, bitmap);
+  }
+
+  /** The conversion to the requested format, shared by both reads. */
+  static _finishRead(result, loadParameters, bitmap) {
+    if (!result.IsOk()) return result;
+    const requested = loadParameters.requestedFormat;
+    if (requested === null || requested === bitmap.GetFormat()) return result;
+    if (!this.convertImage(bitmap, requested)) {
+      return new ImageIOResult(ImageIOResult.Code.ERROR_CONVERTING_FORMAT, `cannot convert pixel format ${bitmap.GetFormat()} to ${requested} yet`);
+    }
+    return result;
+  }
+
+  /**
+   * Convert a bitmap in place to a pixel format, for every image format.
+   *
+   * First HostBitmap's own conversions (Carbon's ConvertFormat); then, for
+   * block-compressed data, a decode of every mip of every array element (and
+   * every slice of a volume) to RGBA8 - or RGBA32F for BC6H - followed by
+   * Carbon's conversion from there when the request was, say, BGRA. sRGB is
+   * kept: an sRGB block format decodes to R8G8B8A8_UNORM_SRGB.
+   *
+   * Not Carbon: D3D takes block formats directly, so Carbon never decodes. A
+   * browser may refuse a block format (/docs/projects/hostbitmap-port.md,
+   * "Declared divergence"). Encoding to a block format is the next step.
+   *
+   * @param {HostBitmap} bitmap Bitmap to convert in place.
+   * @param {number} requested A `PixelFormat` value.
+   * @returns {boolean} Whether the bitmap is now in the requested format.
+   */
+  static convertImage(bitmap, requested) {
+    if (bitmap.ConvertFormat(requested)) return true;
+    const source = bitmap.GetFormat();
+    const name = CANONICAL_BY_PIXEL_FORMAT.get(source);
+    if (!IsCompressedFormat(source) || !canDecodeDdsBlockFormat(name)) return false;
+    const decoded = this.decodeBlocks(bitmap, name);
+    if (!decoded) return false;
+    if (decoded.GetFormat() !== requested && !decoded.ConvertFormat(requested)) return false;
+    bitmap.Swap(decoded);
+    return true;
+  }
+
+  /**
+   * Decode a block-compressed bitmap into a new uncompressed one.
+   *
+   * @param {HostBitmap} bitmap Block-compressed source.
+   * @param {string} name The source's block format string, e.g. "bc7-rgba-unorm".
+   * @returns {HostBitmap|null} The decoded bitmap.
+   */
+  static decodeBlocks(bitmap, name) {
+    const isFloat = name.startsWith("bc6h-");
+    const format = isFloat ? PixelFormat.PIXEL_FORMAT_R32G32B32A32_FLOAT : SRGB_BLOCK_FORMATS.has(bitmap.GetFormat()) ? PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB : PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM;
+    const target = new HostBitmap();
+    const created = target.CreateFromBitmapDimensions(new BitmapDimensions({
+      type: bitmap.GetType(),
+      format,
+      width: bitmap.GetWidth(),
+      height: bitmap.GetHeight(),
+      depth: bitmap.GetDepth(),
+      mipCount: bitmap.GetMipCount(),
+      arraySize: bitmap.GetArraySize()
+    }));
+    if (!created) return null;
+    const mips = bitmap.GetTrueMipCount();
+    for (let element = 0; element < bitmap.GetArraySize(); element++) {
+      for (let mip = 0; mip < mips; mip++) {
+        const width = Math.max(bitmap.GetWidth() >>> mip, 1);
+        const height = Math.max(bitmap.GetHeight() >>> mip, 1);
+        const depth = bitmap.GetMipDepth(mip);
+        const sliceBytes = bitmap.GetMipSize(mip) / depth;
+        const rowPitch = bitmap.GetMipPitch(mip);
+        const src = bitmap.GetMipRawData(mip, element);
+        const dst = target.GetMipRawData(mip, element);
+        const dstSlice = target.GetMipSize(mip) / depth;
+        for (let slice = 0; slice < depth; slice++) {
+          const pixels = decodeDdsSlice(src.subarray(slice * sliceBytes, (slice + 1) * sliceBytes), {
+            width,
+            height,
+            pixelFormat: name
+          }, {
+            rowPitch
+          });
+          dst.set(new Uint8Array(pixels.buffer, pixels.byteOffset, pixels.byteLength), slice * dstSlice);
+        }
+      }
+    }
+    return target;
+  }
+
+  /**
+   * Whether this format can save a bitmap of these dimensions. Formats that
+   * write override this.
+   *
+   * @param {object} _dimensions BitmapDimensions.
+   * @returns {ImageIOResult} METHOD_NOT_SUPPORTED unless overridden.
+   */
+  static isSaveSupported(_dimensions) {
+    return new ImageIOResult(ImageIOResult.Code.METHOD_NOT_SUPPORTED);
+  }
+
+  /**
+   * Save a bitmap. Formats that write override this.
+   *
+   * adapted: Carbon writes to a stream; this returns `{result, bytes}`.
+   *
+   * @param {object} _bitmap HostBitmap.
+   * @param {object|null} _metadata Optional Metadata.
+   * @returns {{result: ImageIOResult, bytes: Uint8Array|null}} The outcome.
+   */
+  static save(_bitmap, _metadata = null) {
+    return {
+      result: new ImageIOResult(ImageIOResult.Code.METHOD_NOT_SUPPORTED),
+      bytes: null
+    };
+  }
+}
+
+export { CjsImageFormat };
+//# sourceMappingURL=CjsImageFormat.js.map

package/dist/resource/format/CjsImageFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsImageFormat.js","sources":["../../../../src/resource/format/CjsImageFormat.js"],"sourcesContent":["import { CjsFormat } from \"./CjsFormat.js\";\nimport { BitmapDimensions, Cutout, HostBitmap, ImageIOResult, LoadParameters } from \"#imageio\";\nimport { IsCompressedFormat, PixelFormat, PixelFormatFromCanonical } from \"#consts/render-context\";\nimport { canDecodeDdsBlockFormat, decodeDdsSlice } from \"../formats/dds/core/helpers.js\";\n\n/** PixelFormat -> the block decoders' format string (the inverse of PixelFormatFromCanonical). */\nconst CANONICAL_BY_PIXEL_FORMAT = new Map(Object.entries(PixelFormatFromCanonical).map(([ name, value ]) => [ value, name ]));\n\n/** sRGB block formats decode to the sRGB variant of RGBA8; everything else to linear. */\nconst SRGB_BLOCK_FORMATS = new Set([\n  PixelFormat.PIXEL_FORMAT_BC1_UNORM_SRGB,\n  PixelFormat.PIXEL_FORMAT_BC2_UNORM_SRGB,\n  PixelFormat.PIXEL_FORMAT_BC3_UNORM_SRGB,\n  PixelFormat.PIXEL_FORMAT_BC7_UNORM_SRGB\n]);\n\n/**\n * The base of every image format: it gives each subclass Carbon's image-handler\n * table and the step that turns a native read into the format a caller asked\n * for.\n *\n * `Format.carbon` IS Carbon's `ImageIO::ImageFormatFunctions`\n * (imageio/include/Tr2ImageHandler.h:74-80) - `checkExtension`, `readImage`,\n * `isSaveSupported`, `save` - built per subclass from its hooks, so the ImageIO\n * registry in resource/imageio can register any image format the way Carbon's\n * `RegisterImageIOHandlers` registers its handlers. Carbon has seven handlers;\n * we have more formats, and each one gets the table by extending this class.\n *\n * A subclass supplies:\n * - `static extensions` (already declared by every format) for checkExtension;\n * - `static readImageNative(bytes, loadParameters, bitmap, metadata)`, which\n *   fills the bitmap it is handed in its natural format and returns an\n *   ImageIOResult. It calls methods on the bitmap; it never imports HostBitmap.\n *\n * NOT CARBON: `LoadParameters.requestedFormat`. When a caller asks for a format\n * other than the native one, `readImage` converts after the native read\n * (`convertImage`): HostBitmap's own ConvertFormat, then block decode. Encoding\n * to a block format is the next step here, so every image format inherits it\n * from this one place (/docs/projects/hostbitmap-port.md).\n */\nexport class CjsImageFormat extends CjsFormat\n{\n\n  /**\n   * Carbon's handler table for this format class, built once per subclass.\n   *\n   * @returns {{checkExtension: Function, readImage: Function, isSaveSupported: Function, save: Function}} The table.\n   */\n  static get carbon()\n  {\n    if (!Object.hasOwn(this, \"_carbon\"))\n    {\n      this._carbon = {\n        checkExtension: extension => this.checkExtension(extension),\n        readImage: (bytes, loadParameters, bitmap, metadata = null) => this.readImage(bytes, loadParameters, bitmap, metadata),\n        // Not Carbon: see readImageAsync.\n        readImageAsync: (bytes, loadParameters, bitmap, metadata = null) => this.readImageAsync(bytes, loadParameters, bitmap, metadata),\n        isSaveSupported: dimensions => this.isSaveSupported(dimensions),\n        save: (bitmap, metadata = null) => this.save(bitmap, metadata)\n      };\n    }\n\n    return this._carbon;\n  }\n\n  /**\n   * Whether an extension (without the dot) is one of this format's, case-insensitively.\n   *\n   * @param {string} extension Extension.\n   * @returns {boolean} Whether this format reads it.\n   */\n  static checkExtension(extension)\n  {\n    const wanted = `.${extension.toLowerCase()}`;\n\n    return this.extensions.includes(wanted);\n  }\n\n  /**\n   * Fill `bitmap` in the format's natural pixel format. Every image format\n   * implements this.\n   *\n   * @param {Uint8Array} _bytes File bytes.\n   * @param {LoadParameters} _loadParameters Load parameters.\n   * @param {object} _bitmap Destination HostBitmap.\n   * @param {object|null} _metadata Optional Metadata out.\n   * @returns {ImageIOResult} The result.\n   */\n  static readImageNative(_bytes, _loadParameters, _bitmap, _metadata)\n  {\n    throw new Error(`${this.name}.readImageNative is not implemented`);\n  }\n\n  /**\n   * Fill a bitmap from one of our readers' RGBA8 outputs (`read(bytes, { emit: \"rgba\" })`),\n   * for the formats whose decoders already produce one: PNG, JPEG, TGA, GIF.\n   *\n   * The bitmap is a single-mip 2D B8G8R8A8_UNORM image, as Carbon's JPEG handler\n   * and its PNG/TGA handlers for images with alpha produce, and as the texture\n   * pipeline's pack step requires of its inputs (BGRA, BGRX or R8).\n   *\n   * adapted: Carbon's PNG/TGA handlers keep an opaque RGB image as BGRX and a\n   * grey one as R8 (Tr2PngHandler.cpp:125-160, Tr2TgaHandler.cpp:98-110); our\n   * decoders report RGBA only, so those arrive as BGRA with their alpha. The\n   * metadata cutout is the default: the PNG cutout chunk is not read yet.\n   *\n   * @param {object} payload An RGBA8 payload: width, height, data, strideBytes.\n   * @param {object} bitmap Destination HostBitmap.\n   * @param {object|null} [metadata] Optional Metadata out.\n   * @returns {ImageIOResult} The result.\n   */\n  static readImageFromRgbaPayload(payload, bitmap, metadata = null)\n  {\n    if (!(payload.data instanceof Uint8Array))\n    {\n      return new ImageIOResult(ImageIOResult.Code.HEADER_NOT_SUPPORTED, `${payload.pixelFormat} is not an 8-bit image`);\n    }\n\n    if (!bitmap.Create(payload.width, payload.height, 1, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM))\n    {\n      return new ImageIOResult(ImageIOResult.Code.ERROR_CREATING_BITMAP);\n    }\n\n    const dst = bitmap.GetRawData();\n    const row = payload.width * 4;\n    const stride = payload.strideBytes || row;\n\n    for (let y = 0; y < payload.height; y++)\n    {\n      dst.set(payload.data.subarray(y * stride, y * stride + row), y * row);\n    }\n\n    bitmap.ConvertFormat(PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM);\n\n    if (metadata) metadata.cutout = new Cutout();\n\n    return new ImageIOResult(ImageIOResult.Code.OK);\n  }\n\n  /**\n   * The asynchronous native read. Defaults to the synchronous one; a format\n   * whose decoder is asynchronous (PNG, which inflates through the browser's\n   * DecompressionStream) overrides this instead.\n   *\n   * @param {Uint8Array} bytes File bytes.\n   * @param {LoadParameters} loadParameters Load parameters.\n   * @param {object} bitmap Destination HostBitmap.\n   * @param {object|null} metadata Optional Metadata out.\n   * @returns {Promise<ImageIOResult>} The result.\n   */\n  static async readImageNativeAsync(bytes, loadParameters, bitmap, metadata)\n  {\n    return this.readImageNative(bytes, loadParameters, bitmap, metadata);\n  }\n\n  /**\n   * `readImage` for any image format, including those whose decoder is\n   * asynchronous.\n   *\n   * Not Carbon: Carbon's ReadImage is synchronous because its zlib is. In a\n   * browser, inflation is DecompressionStream, which has only an asynchronous\n   * API, so PNG cannot answer the synchronous call. Resource loading is\n   * asynchronous anyway; every format answers this one.\n   *\n   * @param {Uint8Array} bytes File bytes.\n   * @param {LoadParameters} loadParameters Load parameters.\n   * @param {object} bitmap Destination HostBitmap.\n   * @param {object|null} [metadata] Optional Metadata out.\n   * @returns {Promise<ImageIOResult>} The result.\n   */\n  static async readImageAsync(bytes, loadParameters, bitmap, metadata = null)\n  {\n    const result = await this.readImageNativeAsync(bytes, loadParameters, bitmap, metadata);\n\n    return this._finishRead(result, loadParameters, bitmap);\n  }\n\n  /**\n   * Read an image into `bitmap`, then convert it to `loadParameters.requestedFormat`\n   * when one is asked for.\n   *\n   * @param {Uint8Array} bytes File bytes.\n   * @param {LoadParameters} loadParameters Load parameters.\n   * @param {object} bitmap Destination HostBitmap.\n   * @param {object|null} [metadata] Optional Metadata out.\n   * @returns {ImageIOResult} The result.\n   */\n  static readImage(bytes, loadParameters, bitmap, metadata = null)\n  {\n    return this._finishRead(this.readImageNative(bytes, loadParameters, bitmap, metadata), loadParameters, bitmap);\n  }\n\n  /** The conversion to the requested format, shared by both reads. */\n  static _finishRead(result, loadParameters, bitmap)\n  {\n    if (!result.IsOk()) return result;\n\n    const requested = loadParameters.requestedFormat;\n\n    if (requested === null || requested === bitmap.GetFormat()) return result;\n\n    if (!this.convertImage(bitmap, requested))\n    {\n      return new ImageIOResult(ImageIOResult.Code.ERROR_CONVERTING_FORMAT,\n        `cannot convert pixel format ${bitmap.GetFormat()} to ${requested} yet`);\n    }\n\n    return result;\n  }\n\n  /**\n   * Convert a bitmap in place to a pixel format, for every image format.\n   *\n   * First HostBitmap's own conversions (Carbon's ConvertFormat); then, for\n   * block-compressed data, a decode of every mip of every array element (and\n   * every slice of a volume) to RGBA8 - or RGBA32F for BC6H - followed by\n   * Carbon's conversion from there when the request was, say, BGRA. sRGB is\n   * kept: an sRGB block format decodes to R8G8B8A8_UNORM_SRGB.\n   *\n   * Not Carbon: D3D takes block formats directly, so Carbon never decodes. A\n   * browser may refuse a block format (/docs/projects/hostbitmap-port.md,\n   * \"Declared divergence\"). Encoding to a block format is the next step.\n   *\n   * @param {HostBitmap} bitmap Bitmap to convert in place.\n   * @param {number} requested A `PixelFormat` value.\n   * @returns {boolean} Whether the bitmap is now in the requested format.\n   */\n  static convertImage(bitmap, requested)\n  {\n    if (bitmap.ConvertFormat(requested)) return true;\n\n    const source = bitmap.GetFormat();\n    const name = CANONICAL_BY_PIXEL_FORMAT.get(source);\n\n    if (!IsCompressedFormat(source) || !canDecodeDdsBlockFormat(name)) return false;\n\n    const decoded = this.decodeBlocks(bitmap, name);\n    if (!decoded) return false;\n\n    if (decoded.GetFormat() !== requested && !decoded.ConvertFormat(requested)) return false;\n\n    bitmap.Swap(decoded);\n\n    return true;\n  }\n\n  /**\n   * Decode a block-compressed bitmap into a new uncompressed one.\n   *\n   * @param {HostBitmap} bitmap Block-compressed source.\n   * @param {string} name The source's block format string, e.g. \"bc7-rgba-unorm\".\n   * @returns {HostBitmap|null} The decoded bitmap.\n   */\n  static decodeBlocks(bitmap, name)\n  {\n    const isFloat = name.startsWith(\"bc6h-\");\n    const format = isFloat\n      ? PixelFormat.PIXEL_FORMAT_R32G32B32A32_FLOAT\n      : (SRGB_BLOCK_FORMATS.has(bitmap.GetFormat()) ? PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB : PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM);\n\n    const target = new HostBitmap();\n    const created = target.CreateFromBitmapDimensions(new BitmapDimensions({\n      type: bitmap.GetType(),\n      format,\n      width: bitmap.GetWidth(),\n      height: bitmap.GetHeight(),\n      depth: bitmap.GetDepth(),\n      mipCount: bitmap.GetMipCount(),\n      arraySize: bitmap.GetArraySize()\n    }));\n\n    if (!created) return null;\n\n    const mips = bitmap.GetTrueMipCount();\n\n    for (let element = 0; element < bitmap.GetArraySize(); element++)\n    {\n      for (let mip = 0; mip < mips; mip++)\n      {\n        const width = Math.max(bitmap.GetWidth() >>> mip, 1);\n        const height = Math.max(bitmap.GetHeight() >>> mip, 1);\n        const depth = bitmap.GetMipDepth(mip);\n        const sliceBytes = bitmap.GetMipSize(mip) / depth;\n        const rowPitch = bitmap.GetMipPitch(mip);\n        const src = bitmap.GetMipRawData(mip, element);\n        const dst = target.GetMipRawData(mip, element);\n        const dstSlice = target.GetMipSize(mip) / depth;\n\n        for (let slice = 0; slice < depth; slice++)\n        {\n          const pixels = decodeDdsSlice(src.subarray(slice * sliceBytes, (slice + 1) * sliceBytes), { width, height, pixelFormat: name }, { rowPitch });\n          dst.set(new Uint8Array(pixels.buffer, pixels.byteOffset, pixels.byteLength), slice * dstSlice);\n        }\n      }\n    }\n\n    return target;\n  }\n\n  /**\n   * Whether this format can save a bitmap of these dimensions. Formats that\n   * write override this.\n   *\n   * @param {object} _dimensions BitmapDimensions.\n   * @returns {ImageIOResult} METHOD_NOT_SUPPORTED unless overridden.\n   */\n  static isSaveSupported(_dimensions)\n  {\n    return new ImageIOResult(ImageIOResult.Code.METHOD_NOT_SUPPORTED);\n  }\n\n  /**\n   * Save a bitmap. Formats that write override this.\n   *\n   * adapted: Carbon writes to a stream; this returns `{result, bytes}`.\n   *\n   * @param {object} _bitmap HostBitmap.\n   * @param {object|null} _metadata Optional Metadata.\n   * @returns {{result: ImageIOResult, bytes: Uint8Array|null}} The outcome.\n   */\n  static save(_bitmap, _metadata = null)\n  {\n    return { result: new ImageIOResult(ImageIOResult.Code.METHOD_NOT_SUPPORTED), bytes: null };\n  }\n\n}\n"],"names":["CANONICAL_BY_PIXEL_FORMAT","Map","Object","entries","PixelFormatFromCanonical","map","name","value","SRGB_BLOCK_FORMATS","Set","PixelFormat","PIXEL_FORMAT_BC1_UNORM_SRGB","PIXEL_FORMAT_BC2_UNORM_SRGB","PIXEL_FORMAT_BC3_UNORM_SRGB","PIXEL_FORMAT_BC7_UNORM_SRGB","CjsImageFormat","CjsFormat","carbon","hasOwn","_carbon","checkExtension","extension","readImage","bytes","loadParameters","bitmap","metadata","readImageAsync","isSaveSupported","dimensions","save","wanted","toLowerCase","extensions","includes","readImageNative","_bytes","_loadParameters","_bitmap","_metadata","Error","readImageFromRgbaPayload","payload","data","Uint8Array","ImageIOResult","Code","HEADER_NOT_SUPPORTED","pixelFormat","Create","width","height","PIXEL_FORMAT_R8G8B8A8_UNORM","ERROR_CREATING_BITMAP","dst","GetRawData","row","stride","strideBytes","y","set","subarray","ConvertFormat","PIXEL_FORMAT_B8G8R8A8_UNORM","cutout","Cutout","OK","readImageNativeAsync","result","_finishRead","IsOk","requested","requestedFormat","GetFormat","convertImage","ERROR_CONVERTING_FORMAT","source","get","IsCompressedFormat","canDecodeDdsBlockFormat","decoded","decodeBlocks","Swap","isFloat","startsWith","format","PIXEL_FORMAT_R32G32B32A32_FLOAT","has","PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB","target","HostBitmap","created","CreateFromBitmapDimensions","BitmapDimensions","type","GetType","GetWidth","GetHeight","depth","GetDepth","mipCount","GetMipCount","arraySize","GetArraySize","mips","GetTrueMipCount","element","mip","Math","max","GetMipDepth","sliceBytes","GetMipSize","rowPitch","GetMipPitch","src","GetMipRawData","dstSlice","slice","pixels","decodeDdsSlice","buffer","byteOffset","byteLength","_dimensions","METHOD_NOT_SUPPORTED"],"mappings":"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"}

package/dist/resource/format/CjsResourceProbe.js

@@ -1,14 +1,11 @@
-import { CjsModel } from '#model';
-import { CjsSchema, edit, type } from '#schema';
-
-/**
- * Persistable resource-layer view of a format support report.
- *
- * Concrete formats return decorator-free plain objects so their direct
- * subpaths stay importable without a build transform. Consumers that need a
- * model normalize those reports here with {@link CjsResourceProbe.from}.
+/**
+ * A format support report, normalized.
+ *
+ * Formats return plain report objects; this gives every field its type and
+ * default, and answers the two questions a caller asks of one. It is a plain
+ * record, never persisted or hydrated, so it carries no schema.
  */
-class CjsResourceProbe extends CjsModel {
+class CjsResourceProbe {
   format = "";
   source = "";
   recognized = false;
@@ -24,29 +21,16 @@ class CjsResourceProbe extends CjsModel {
   errors = [];
   error = null;
 
-  /**
-   * Create a normalized resource-layer support report.
-   * @param {object|null} [values] Plain format support report.
+  /**
+   * Create a normalized resource-layer support report.
+   * @param {object|null} [values] Plain format support report.
    */
   constructor(values = null) {
-    super();
-    this.SetValues(normalizeReport(values), {
-      skipUpdate: true,
-      skipEvents: true
-    });
-  }
-
-  /** Replace this report from a plain format result. */
-  Initialize(values = null) {
-    this.SetValues(normalizeReport(values), {
-      skipEvents: true
-    });
-    return this;
+    Object.assign(this, normalizeReport(values));
   }
 
-  /** Normalize a plain format report at the decorated resource boundary. */
+  /** Normalize a plain format report at the resource boundary. */
   static from(input) {
-    if (input instanceof CjsResourceProbe) return input;
     if (input && typeof input.toJSON === "function") return new this(input.toJSON());
     return new this(input);
   }
@@ -95,26 +79,6 @@ function normalizeCapability(input) {
     requires: Array.isArray(capability.requires) ? capability.requires.map(String) : []
   };
 }
-CjsSchema.define(CjsResourceProbe, {
-  className: "CjsResourceProbe",
-  family: "resource",
-  fields: {
-    format: [edit.persist, type.string],
-    source: [edit.persist, type.string],
-    recognized: [edit.persist, type.boolean],
-    output: [edit.persist, type.string],
-    supported: [edit.persist, type.boolean],
-    verified: [edit.persist, type.boolean],
-    preferredOutput: [edit.persist, type.string],
-    reason: [edit.persist, type.string],
-    metadata: [edit.persist, type.unknown],
-    capability: [edit.persist, type.unknown],
-    outputs: [edit.persist, type.list("unknown")],
-    warnings: [edit.persist, type.list("string")],
-    errors: [edit.persist, type.list("string")],
-    error: [edit.persist, type.unknown]
-  }
-});
 
 export { CjsResourceProbe };
 //# sourceMappingURL=CjsResourceProbe.js.map

package/dist/resource/format/CjsResourceProbe.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsResourceProbe.js","sources":["../../../../src/resource/format/CjsResourceProbe.js"],"sourcesContent":["import { CjsModel } from \"#model\";\r\nimport { CjsSchema, edit, type } from \"#schema\";\r\n\r\n/**\r\n * Persistable resource-layer view of a format support report.\r\n *\r\n * Concrete formats return decorator-free plain objects so their direct\r\n * subpaths stay importable without a build transform. Consumers that need a\r\n * model normalize those reports here with {@link CjsResourceProbe.from}.\r\n */\r\nexport class CjsResourceProbe extends CjsModel\r\n{\r\n  format = \"\";\r\n\r\n  source = \"\";\r\n\r\n  recognized = false;\r\n\r\n  output = \"\";\r\n\r\n  supported = false;\r\n\r\n  verified = false;\r\n\r\n  preferredOutput = \"\";\r\n\r\n  reason = \"\";\r\n\r\n  metadata = null;\r\n\r\n  capability = null;\r\n\r\n  outputs = [];\r\n\r\n  warnings = [];\r\n\r\n  errors = [];\r\n\r\n  error = null;\r\n\r\n  /**\r\n   * Create a normalized resource-layer support report.\r\n   * @param {object|null} [values] Plain format support report.\r\n   */\r\n  constructor(values = null)\r\n  {\r\n    super();\r\n    this.SetValues(normalizeReport(values), {\r\n      skipUpdate: true,\r\n      skipEvents: true\r\n    });\r\n  }\r\n\r\n  /** Replace this report from a plain format result. */\r\n  Initialize(values = null)\r\n  {\r\n    this.SetValues(normalizeReport(values), { skipEvents: true });\r\n    return this;\r\n  }\r\n\r\n  /** Normalize a plain format report at the decorated resource boundary. */\r\n  static from(input)\r\n  {\r\n    if (input instanceof CjsResourceProbe) return input;\r\n    if (input && typeof input.toJSON === \"function\") return new this(input.toJSON());\r\n    return new this(input);\r\n  }\r\n\r\n  /** Whether the selected output is usable, optionally requiring real proof. */\r\n  canUseSelected(options = null)\r\n  {\r\n    return this.supported === true && (!options?.verified || this.verified === true);\r\n  }\r\n\r\n  /** Whether one declared output is usable, optionally requiring real proof. */\r\n  canUse(output, options = null)\r\n  {\r\n    const normalized = String(output || \"\").toLowerCase();\r\n    const capability = this.outputs.find(entry =>\r\n      String(entry?.output || \"\").toLowerCase() === normalized);\r\n    return capability?.supported === true\r\n      && (!options?.verified || capability.verified === true);\r\n  }\r\n}\r\n\r\nfunction normalizeReport(input)\r\n{\r\n  const report = input && typeof input === \"object\" ? input : {};\r\n  const outputs = Array.isArray(report.outputs)\r\n    ? report.outputs.map(normalizeCapability)\r\n    : [];\r\n  const selected = report.capability && typeof report.capability === \"object\"\r\n    ? normalizeCapability(report.capability)\r\n    : outputs.find(entry => entry.output === report.output) || null;\r\n  return {\r\n    format: String(report.format || \"\"),\r\n    source: String(report.source || \"\"),\r\n    recognized: report.recognized === true,\r\n    output: String(report.output || \"\"),\r\n    supported: report.supported === true,\r\n    verified: report.verified === true,\r\n    preferredOutput: String(report.preferredOutput || \"\"),\r\n    reason: String(report.reason || \"\"),\r\n    metadata: report.metadata ?? null,\r\n    capability: selected,\r\n    outputs,\r\n    warnings: Array.isArray(report.warnings) ? report.warnings.map(String) : [],\r\n    errors: Array.isArray(report.errors) ? report.errors.map(String) : [],\r\n    error: report.error ?? null\r\n  };\r\n}\r\n\r\nfunction normalizeCapability(input)\r\n{\r\n  const capability = input && typeof input === \"object\" ? input : {};\r\n  return {\r\n    ...capability,\r\n    output: String(capability.output || \"\"),\r\n    payloadType: String(capability.payloadType || capability.output || \"\"),\r\n    supported: capability.supported === true,\r\n    verified: capability.verified === true,\r\n    requires: Array.isArray(capability.requires) ? capability.requires.map(String) : []\r\n  };\r\n}\r\n\r\nexport default CjsResourceProbe;\r\n\r\nCjsSchema.define(CjsResourceProbe, {\r\n  className: \"CjsResourceProbe\", family: \"resource\",\r\n  fields: {\r\n    format: [ edit.persist, type.string ],\r\n    source: [ edit.persist, type.string ],\r\n    recognized: [ edit.persist, type.boolean ],\r\n    output: [ edit.persist, type.string ],\r\n    supported: [ edit.persist, type.boolean ],\r\n    verified: [ edit.persist, type.boolean ],\r\n    preferredOutput: [ edit.persist, type.string ],\r\n    reason: [ edit.persist, type.string ],\r\n    metadata: [ edit.persist, type.unknown ],\r\n    capability: [ edit.persist, type.unknown ],\r\n    outputs: [ edit.persist, type.list(\"unknown\") ],\r\n    warnings: [ edit.persist, type.list(\"string\") ],\r\n    errors: [ edit.persist, type.list(\"string\") ],\r\n    error: [ edit.persist, type.unknown ]\r\n  }\r\n});\r\n"],"names":["CjsResourceProbe","CjsModel","format","source","recognized","output","supported","verified","preferredOutput","reason","metadata","capability","outputs","warnings","errors","error","constructor","values","SetValues","normalizeReport","skipUpdate","skipEvents","Initialize","from","input","toJSON","canUseSelected","options","canUse","normalized","String","toLowerCase","find","entry","report","Array","isArray","map","normalizeCapability","selected","payloadType","requires","CjsSchema","define","className","family","fields","edit","persist","type","string","boolean","unknown","list"],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gBAAgB,SAASC,QAAQ,CAC9C;AACEC,EAAAA,MAAM,GAAG,EAAE;AAEXC,EAAAA,MAAM,GAAG,EAAE;AAEXC,EAAAA,UAAU,GAAG,KAAK;AAElBC,EAAAA,MAAM,GAAG,EAAE;AAEXC,EAAAA,SAAS,GAAG,KAAK;AAEjBC,EAAAA,QAAQ,GAAG,KAAK;AAEhBC,EAAAA,eAAe,GAAG,EAAE;AAEpBC,EAAAA,MAAM,GAAG,EAAE;AAEXC,EAAAA,QAAQ,GAAG,IAAI;AAEfC,EAAAA,UAAU,GAAG,IAAI;AAEjBC,EAAAA,OAAO,GAAG,EAAE;AAEZC,EAAAA,QAAQ,GAAG,EAAE;AAEbC,EAAAA,MAAM,GAAG,EAAE;AAEXC,EAAAA,KAAK,GAAG,IAAI;;AAEZ;AACF;AACA;AACA;AACEC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAI,EACzB;AACE,IAAA,KAAK,EAAE;AACP,IAAA,IAAI,CAACC,SAAS,CAACC,eAAe,CAACF,MAAM,CAAC,EAAE;AACtCG,MAAAA,UAAU,EAAE,IAAI;AAChBC,MAAAA,UAAU,EAAE;AACd,KAAC,CAAC;AACJ,EAAA;;AAEA;AACAC,EAAAA,UAAUA,CAACL,MAAM,GAAG,IAAI,EACxB;AACE,IAAA,IAAI,CAACC,SAAS,CAACC,eAAe,CAACF,MAAM,CAAC,EAAE;AAAEI,MAAAA,UAAU,EAAE;AAAK,KAAC,CAAC;AAC7D,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;EACA,OAAOE,IAAIA,CAACC,KAAK,EACjB;AACE,IAAA,IAAIA,KAAK,YAAYxB,gBAAgB,EAAE,OAAOwB,KAAK;AACnD,IAAA,IAAIA,KAAK,IAAI,OAAOA,KAAK,CAACC,MAAM,KAAK,UAAU,EAAE,OAAO,IAAI,IAAI,CAACD,KAAK,CAACC,MAAM,EAAE,CAAC;AAChF,IAAA,OAAO,IAAI,IAAI,CAACD,KAAK,CAAC;AACxB,EAAA;;AAEA;AACAE,EAAAA,cAAcA,CAACC,OAAO,GAAG,IAAI,EAC7B;AACE,IAAA,OAAO,IAAI,CAACrB,SAAS,KAAK,IAAI,KAAK,CAACqB,OAAO,EAAEpB,QAAQ,IAAI,IAAI,CAACA,QAAQ,KAAK,IAAI,CAAC;AAClF,EAAA;;AAEA;AACAqB,EAAAA,MAAMA,CAACvB,MAAM,EAAEsB,OAAO,GAAG,IAAI,EAC7B;IACE,MAAME,UAAU,GAAGC,MAAM,CAACzB,MAAM,IAAI,EAAE,CAAC,CAAC0B,WAAW,EAAE;IACrD,MAAMpB,UAAU,GAAG,IAAI,CAACC,OAAO,CAACoB,IAAI,CAACC,KAAK,IACxCH,MAAM,CAACG,KAAK,EAAE5B,MAAM,IAAI,EAAE,CAAC,CAAC0B,WAAW,EAAE,KAAKF,UAAU,CAAC;AAC3D,IAAA,OAAOlB,UAAU,EAAEL,SAAS,KAAK,IAAI,KAC/B,CAACqB,OAAO,EAAEpB,QAAQ,IAAII,UAAU,CAACJ,QAAQ,KAAK,IAAI,CAAC;AAC3D,EAAA;AACF;AAEA,SAASY,eAAeA,CAACK,KAAK,EAC9B;AACE,EAAA,MAAMU,MAAM,GAAGV,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAG,EAAE;EAC9D,MAAMZ,OAAO,GAAGuB,KAAK,CAACC,OAAO,CAACF,MAAM,CAACtB,OAAO,CAAC,GACzCsB,MAAM,CAACtB,OAAO,CAACyB,GAAG,CAACC,mBAAmB,CAAC,GACvC,EAAE;AACN,EAAA,MAAMC,QAAQ,GAAGL,MAAM,CAACvB,UAAU,IAAI,OAAOuB,MAAM,CAACvB,UAAU,KAAK,QAAQ,GACvE2B,mBAAmB,CAACJ,MAAM,CAACvB,UAAU,CAAC,GACtCC,OAAO,CAACoB,IAAI,CAACC,KAAK,IAAIA,KAAK,CAAC5B,MAAM,KAAK6B,MAAM,CAAC7B,MAAM,CAAC,IAAI,IAAI;EACjE,OAAO;IACLH,MAAM,EAAE4B,MAAM,CAACI,MAAM,CAAChC,MAAM,IAAI,EAAE,CAAC;IACnCC,MAAM,EAAE2B,MAAM,CAACI,MAAM,CAAC/B,MAAM,IAAI,EAAE,CAAC;AACnCC,IAAAA,UAAU,EAAE8B,MAAM,CAAC9B,UAAU,KAAK,IAAI;IACtCC,MAAM,EAAEyB,MAAM,CAACI,MAAM,CAAC7B,MAAM,IAAI,EAAE,CAAC;AACnCC,IAAAA,SAAS,EAAE4B,MAAM,CAAC5B,SAAS,KAAK,IAAI;AACpCC,IAAAA,QAAQ,EAAE2B,MAAM,CAAC3B,QAAQ,KAAK,IAAI;IAClCC,eAAe,EAAEsB,MAAM,CAACI,MAAM,CAAC1B,eAAe,IAAI,EAAE,CAAC;IACrDC,MAAM,EAAEqB,MAAM,CAACI,MAAM,CAACzB,MAAM,IAAI,EAAE,CAAC;AACnCC,IAAAA,QAAQ,EAAEwB,MAAM,CAACxB,QAAQ,IAAI,IAAI;AACjCC,IAAAA,UAAU,EAAE4B,QAAQ;IACpB3B,OAAO;AACPC,IAAAA,QAAQ,EAAEsB,KAAK,CAACC,OAAO,CAACF,MAAM,CAACrB,QAAQ,CAAC,GAAGqB,MAAM,CAACrB,QAAQ,CAACwB,GAAG,CAACP,MAAM,CAAC,GAAG,EAAE;AAC3EhB,IAAAA,MAAM,EAAEqB,KAAK,CAACC,OAAO,CAACF,MAAM,CAACpB,MAAM,CAAC,GAAGoB,MAAM,CAACpB,MAAM,CAACuB,GAAG,CAACP,MAAM,CAAC,GAAG,EAAE;AACrEf,IAAAA,KAAK,EAAEmB,MAAM,CAACnB,KAAK,IAAI;GACxB;AACH;AAEA,SAASuB,mBAAmBA,CAACd,KAAK,EAClC;AACE,EAAA,MAAMb,UAAU,GAAGa,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAG,EAAE;EAClE,OAAO;AACL,IAAA,GAAGb,UAAU;IACbN,MAAM,EAAEyB,MAAM,CAACnB,UAAU,CAACN,MAAM,IAAI,EAAE,CAAC;AACvCmC,IAAAA,WAAW,EAAEV,MAAM,CAACnB,UAAU,CAAC6B,WAAW,IAAI7B,UAAU,CAACN,MAAM,IAAI,EAAE,CAAC;AACtEC,IAAAA,SAAS,EAAEK,UAAU,CAACL,SAAS,KAAK,IAAI;AACxCC,IAAAA,QAAQ,EAAEI,UAAU,CAACJ,QAAQ,KAAK,IAAI;AACtCkC,IAAAA,QAAQ,EAAEN,KAAK,CAACC,OAAO,CAACzB,UAAU,CAAC8B,QAAQ,CAAC,GAAG9B,UAAU,CAAC8B,QAAQ,CAACJ,GAAG,CAACP,MAAM,CAAC,GAAG;GAClF;AACH;AAIAY,SAAS,CAACC,MAAM,CAAC3C,gBAAgB,EAAE;AACjC4C,EAAAA,SAAS,EAAE,kBAAkB;AAAEC,EAAAA,MAAM,EAAE,UAAU;AACjDC,EAAAA,MAAM,EAAE;IACN5C,MAAM,EAAE,CAAE6C,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IACrC/C,MAAM,EAAE,CAAE4C,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IACrC9C,UAAU,EAAE,CAAE2C,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACE,OAAO,CAAE;IAC1C9C,MAAM,EAAE,CAAE0C,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IACrC5C,SAAS,EAAE,CAAEyC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACE,OAAO,CAAE;IACzC5C,QAAQ,EAAE,CAAEwC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACE,OAAO,CAAE;IACxC3C,eAAe,EAAE,CAAEuC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IAC9CzC,MAAM,EAAE,CAAEsC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IACrCxC,QAAQ,EAAE,CAAEqC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO,CAAE;IACxCzC,UAAU,EAAE,CAAEoC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO,CAAE;AAC1CxC,IAAAA,OAAO,EAAE,CAAEmC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACI,IAAI,CAAC,SAAS,CAAC,CAAE;AAC/CxC,IAAAA,QAAQ,EAAE,CAAEkC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACI,IAAI,CAAC,QAAQ,CAAC,CAAE;AAC/CvC,IAAAA,MAAM,EAAE,CAAEiC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACI,IAAI,CAAC,QAAQ,CAAC,CAAE;IAC7CtC,KAAK,EAAE,CAAEgC,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO;AACrC;AACF,CAAC,CAAC;;;;"}
+{"version":3,"file":"CjsResourceProbe.js","sources":["../../../../src/resource/format/CjsResourceProbe.js"],"sourcesContent":["/**\n * A format support report, normalized.\n *\n * Formats return plain report objects; this gives every field its type and\n * default, and answers the two questions a caller asks of one. It is a plain\n * record, never persisted or hydrated, so it carries no schema.\n */\nexport class CjsResourceProbe\n{\n  format = \"\";\n\n  source = \"\";\n\n  recognized = false;\n\n  output = \"\";\n\n  supported = false;\n\n  verified = false;\n\n  preferredOutput = \"\";\n\n  reason = \"\";\n\n  metadata = null;\n\n  capability = null;\n\n  outputs = [];\n\n  warnings = [];\n\n  errors = [];\n\n  error = null;\n\n  /**\n   * Create a normalized resource-layer support report.\n   * @param {object|null} [values] Plain format support report.\n   */\n  constructor(values = null)\n  {\n    Object.assign(this, normalizeReport(values));\n  }\n\n  /** Normalize a plain format report at the resource boundary. */\n  static from(input)\n  {\n    if (input && typeof input.toJSON === \"function\") return new this(input.toJSON());\n    return new this(input);\n  }\n\n  /** Whether the selected output is usable, optionally requiring real proof. */\n  canUseSelected(options = null)\n  {\n    return this.supported === true && (!options?.verified || this.verified === true);\n  }\n\n  /** Whether one declared output is usable, optionally requiring real proof. */\n  canUse(output, options = null)\n  {\n    const normalized = String(output || \"\").toLowerCase();\n    const capability = this.outputs.find(entry =>\n      String(entry?.output || \"\").toLowerCase() === normalized);\n    return capability?.supported === true\n      && (!options?.verified || capability.verified === true);\n  }\n}\n\nfunction normalizeReport(input)\n{\n  const report = input && typeof input === \"object\" ? input : {};\n  const outputs = Array.isArray(report.outputs)\n    ? report.outputs.map(normalizeCapability)\n    : [];\n  const selected = report.capability && typeof report.capability === \"object\"\n    ? normalizeCapability(report.capability)\n    : outputs.find(entry => entry.output === report.output) || null;\n  return {\n    format: String(report.format || \"\"),\n    source: String(report.source || \"\"),\n    recognized: report.recognized === true,\n    output: String(report.output || \"\"),\n    supported: report.supported === true,\n    verified: report.verified === true,\n    preferredOutput: String(report.preferredOutput || \"\"),\n    reason: String(report.reason || \"\"),\n    metadata: report.metadata ?? null,\n    capability: selected,\n    outputs,\n    warnings: Array.isArray(report.warnings) ? report.warnings.map(String) : [],\n    errors: Array.isArray(report.errors) ? report.errors.map(String) : [],\n    error: report.error ?? null\n  };\n}\n\nfunction normalizeCapability(input)\n{\n  const capability = input && typeof input === \"object\" ? input : {};\n  return {\n    ...capability,\n    output: String(capability.output || \"\"),\n    payloadType: String(capability.payloadType || capability.output || \"\"),\n    supported: capability.supported === true,\n    verified: capability.verified === true,\n    requires: Array.isArray(capability.requires) ? capability.requires.map(String) : []\n  };\n}\n\nexport default CjsResourceProbe;\n"],"names":["CjsResourceProbe","format","source","recognized","output","supported","verified","preferredOutput","reason","metadata","capability","outputs","warnings","errors","error","constructor","values","Object","assign","normalizeReport","from","input","toJSON","canUseSelected","options","canUse","normalized","String","toLowerCase","find","entry","report","Array","isArray","map","normalizeCapability","selected","payloadType","requires"],"mappings":"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"}

package/dist/resource/format/CjsStringTable.js

@@ -79,11 +79,11 @@ function hashBytes(bytes) {
  *   interning all late strings before the packing pass; we fail closed instead.
  */
 class CjsStringTable {
-  #blobs = [];
-  #buckets = new Map();
-  #byteLength = 0;
-  #offsets = null;
-  #handedOutOffsets = false;
+  _blobs = [];
+  _buckets = new Map();
+  _byteLength = 0;
+  _offsets = null;
+  _handedOutOffsets = false;
 
   /**
    * Returns the arena payload byte count, excluding the `u32` size prefix.
@@ -94,7 +94,7 @@ class CjsStringTable {
    * @returns {number} Payload byte count.
    */
   get byteLength() {
-    return this.#byteLength;
+    return this._byteLength;
   }
 
   /**
@@ -107,7 +107,7 @@ class CjsStringTable {
    * @returns {number} On-disk byte count.
    */
   get containerSize() {
-    return this.#byteLength + 4;
+    return this._byteLength + 4;
   }
 
   /**
@@ -116,7 +116,7 @@ class CjsStringTable {
    * @returns {number} Deduplicated entry count.
    */
   get entryCount() {
-    return this.#blobs.length;
+    return this._blobs.length;
   }
 
   /**
@@ -129,7 +129,7 @@ class CjsStringTable {
     const text = textEncoder.encode(String(value));
     const bytes = new Uint8Array(text.length + 1);
     bytes.set(text, 0);
-    return this.#add(bytes);
+    return this._add(bytes);
   }
 
   /**
@@ -140,7 +140,7 @@ class CjsStringTable {
    */
   addBytes(value) {
     const source = value instanceof Uint8Array ? value : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-    return this.#add(Uint8Array.from(source));
+    return this._add(Uint8Array.from(source));
   }
 
   /**
@@ -152,16 +152,16 @@ class CjsStringTable {
    * @returns {CjsStringTable} This table.
    */
   finish() {
-    if (this.#offsets) return this;
-    const order = this.#blobs.map((blob, index) => index);
-    order.sort((a, b) => compareTableBlobs(this.#blobs[a], this.#blobs[b]));
-    const offsets = new Array(this.#blobs.length);
+    if (this._offsets) return this;
+    const order = this._blobs.map((blob, index) => index);
+    order.sort((a, b) => compareTableBlobs(this._blobs[a], this._blobs[b]));
+    const offsets = new Array(this._blobs.length);
     let cursor = 0;
     for (const index of order) {
       offsets[index] = cursor;
-      cursor += this.#blobs[index].length;
+      cursor += this._blobs[index].length;
     }
-    this.#offsets = offsets;
+    this._offsets = offsets;
     return this;
   }
 
@@ -178,15 +178,15 @@ class CjsStringTable {
     if (reference === null || reference === undefined) {
       return CJS_STRING_TABLE_NULL_REFERENCE;
     }
-    if (!Number.isInteger(reference) || reference < 0 || reference >= this.#blobs.length) {
+    if (!Number.isInteger(reference) || reference < 0 || reference >= this._blobs.length) {
       throw new CjsFormatWriteError("Unknown string-table reference", {
         reference,
-        entryCount: this.#blobs.length
+        entryCount: this._blobs.length
       });
     }
     this.finish();
-    this.#handedOutOffsets = true;
-    return this.#offsets[reference];
+    this._handedOutOffsets = true;
+    return this._offsets[reference];
   }
 
   /**
@@ -196,13 +196,13 @@ class CjsStringTable {
    * @returns {Uint8Array} View over the interned bytes.
    */
   bytesOf(reference) {
-    if (!Number.isInteger(reference) || reference < 0 || reference >= this.#blobs.length) {
+    if (!Number.isInteger(reference) || reference < 0 || reference >= this._blobs.length) {
       throw new CjsFormatWriteError("Unknown string-table reference", {
         reference,
-        entryCount: this.#blobs.length
+        entryCount: this._blobs.length
       });
     }
-    return this.#blobs[reference];
+    return this._blobs[reference];
   }
 
   /**
@@ -212,9 +212,9 @@ class CjsStringTable {
    */
   toBytes() {
     this.finish();
-    const out = new Uint8Array(this.#byteLength);
-    for (let index = 0; index < this.#blobs.length; index += 1) {
-      out.set(this.#blobs[index], this.#offsets[index]);
+    const out = new Uint8Array(this._byteLength);
+    for (let index = 0; index < this._blobs.length; index += 1) {
+      out.set(this._blobs[index], this._offsets[index]);
     }
     return out;
   }
@@ -227,8 +227,8 @@ class CjsStringTable {
    */
   write(writer) {
     this.finish();
-    writer.u32(this.#byteLength);
-    if (this.#byteLength === 0) return;
+    writer.u32(this._byteLength);
+    if (this._byteLength === 0) return;
     writer.bytes(this.toBytes());
   }
 
@@ -240,26 +240,26 @@ class CjsStringTable {
    * @param {Uint8Array} bytes Owned bytes to intern.
    * @returns {number} Arena reference.
    */
-  #add(bytes) {
+  _add(bytes) {
     const key = hashBytes(bytes);
-    const bucket = this.#buckets.get(key);
+    const bucket = this._buckets.get(key);
     if (bucket) {
       for (const candidate of bucket) {
-        if (compareTableBlobs(this.#blobs[candidate], bytes) === 0) {
+        if (compareTableBlobs(this._blobs[candidate], bytes) === 0) {
           return candidate;
         }
       }
     }
-    if (this.#handedOutOffsets) {
+    if (this._handedOutOffsets) {
       throw new CjsFormatWriteError("String-table entry added after offsets were resolved; every offset already handed out would shift", {
         byteLength: bytes.length
       });
     }
-    const reference = this.#blobs.length;
-    this.#blobs.push(bytes);
-    this.#byteLength += bytes.length;
-    this.#offsets = null;
-    if (bucket) bucket.push(reference);else this.#buckets.set(key, [reference]);
+    const reference = this._blobs.length;
+    this._blobs.push(bytes);
+    this._byteLength += bytes.length;
+    this._offsets = null;
+    if (bucket) bucket.push(reference);else this._buckets.set(key, [reference]);
     return reference;
   }
 }