@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/resource/formats/pickle/CjsPickleFormat.js

@@ -11,105 +11,105 @@ const DEFAULT_VALUES = {
   limits: PICKLE_PROTOCOL_0_LIMITS
 };
 
-/**
- * Data-only Python pickle format facade that currently decodes protocol 0 into
- * JSON-compatible values or identity-preserving payload graphs while rejecting
- * callable and object-construction opcodes.
+/**
+ * Data-only Python pickle format facade that currently decodes protocol 0 into
+ * JSON-compatible values or identity-preserving payload graphs while rejecting
+ * callable and object-construction opcodes.
  */
 class CjsPickleFormat extends CjsFormat {
   #values = DEFAULT_VALUES;
 
-  /**
-   * Create a reusable protocol-0 pickle format profile.
-   *
-   * @param {object} [options] Emit mode and bounded decoder limits.
+  /**
+   * Create a reusable protocol-0 pickle format profile.
+   *
+   * @param {object} [options] Emit mode and bounded decoder limits.
    */
   constructor(options = {}) {
     super();
     this.SetValues(options);
   }
 
-  /**
-   * Apply supported format options to this profile.
-   *
-   * @param {object} [options] Emit mode and partial decoder limits.
-   * @returns {CjsPickleFormat} This format profile.
+  /**
+   * Apply supported format options to this profile.
+   *
+   * @param {object} [options] Emit mode and partial decoder limits.
+   * @returns {CjsPickleFormat} This format profile.
    */
   SetValues(options = {}) {
     this.#values = this.constructor.normalizeValues(this.#values, options);
     return this;
   }
 
-  /**
-   * Return normalized format values with optional per-call overrides.
-   *
-   * @param {object} [options] Per-call format options.
-   * @returns {object} Detached effective values.
+  /**
+   * Return normalized format values with optional per-call overrides.
+   *
+   * @param {object} [options] Per-call format options.
+   * @returns {object} Detached effective values.
    */
   GetValues(options = {}) {
     return this.constructor.normalizeValues(this.#values, options);
   }
 
-  /**
-   * Decode according to the effective emit mode.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Per-call format options.
-   * @returns {*} Decoded value graph.
+  /**
+   * Decode according to the effective emit mode.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Per-call format options.
+   * @returns {*} Decoded value graph.
    */
   Read(input, options = {}) {
     return CjsPickleFormat.read(input, this.GetValues(options));
   }
 
-  /**
-   * Decode a JSON-compatible graph, rejecting cyclic memo references.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Per-call format options.
-   * @returns {*} JSON-compatible decoded graph.
+  /**
+   * Decode a JSON-compatible graph, rejecting cyclic memo references.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Per-call format options.
+   * @returns {*} JSON-compatible decoded graph.
    */
   ReadJSON(input, options = {}) {
     return CjsPickleFormat.readJSON(input, this.GetValues(options));
   }
 
-  /**
-   * Decode the inert payload while preserving memo object identity.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Per-call format options.
-   * @returns {*} Decoded payload graph.
+  /**
+   * Decode the inert payload while preserving memo object identity.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Per-call format options.
+   * @returns {*} Decoded payload graph.
    */
   ReadPayload(input, options = {}) {
     return CjsPickleFormat.readPayload(input, this.GetValues(options));
   }
 
-  /**
-   * Decode the exact inert graph while preserving memo aliases and cycles.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Per-call format options.
-   * @returns {*} Decoded raw graph.
+  /**
+   * Decode the exact inert graph while preserving memo aliases and cycles.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Per-call format options.
+   * @returns {*} Decoded raw graph.
    */
   ReadRaw(input, options = {}) {
     return CjsPickleFormat.readRaw(input, this.GetValues(options));
   }
 
-  /**
-   * Verify that a decoded graph is JSON-compatible without changing its shape.
-   *
-   * @param {*} value Candidate decoded graph.
-   * @returns {*} The supplied value.
+  /**
+   * Verify that a decoded graph is JSON-compatible without changing its shape.
+   *
+   * @param {*} value Candidate decoded graph.
+   * @returns {*} The supplied value.
    */
   ToJSON(value) {
     return CjsPickleFormat.toJSON(value);
   }
 
-  /**
-   * Decode according to the requested emit mode.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Format options.
-   * @returns {*} Decoded value graph.
+  /**
+   * Decode according to the requested emit mode.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Format options.
+   * @returns {*} Decoded value graph.
    */
   static read(input, options = {}) {
     const values = this.normalizeValues(DEFAULT_VALUES, options);
@@ -118,46 +118,46 @@ class CjsPickleFormat extends CjsFormat {
     return this.readJSON(input, values);
   }
 
-  /**
-   * Decode a JSON-compatible graph through the protocol-0 implementation.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Format options.
-   * @returns {*} JSON-compatible decoded graph.
+  /**
+   * Decode a JSON-compatible graph through the protocol-0 implementation.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Format options.
+   * @returns {*} JSON-compatible decoded graph.
    */
   static readJSON(input, options = {}) {
     const values = this.normalizeValues(DEFAULT_VALUES, options);
     return new CjsPickleProtocol0Reader(input, values).ReadJSON();
   }
 
-  /**
-   * Decode an inert payload while preserving pickle memo identity.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Format options.
-   * @returns {*} Decoded payload graph.
+  /**
+   * Decode an inert payload while preserving pickle memo identity.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Format options.
+   * @returns {*} Decoded payload graph.
    */
   static readPayload(input, options = {}) {
     const values = this.normalizeValues(DEFAULT_VALUES, options);
     return new CjsPickleProtocol0Reader(input, values).Read();
   }
 
-  /**
-   * Decode the exact inert graph while preserving memo aliases and cycles.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
-   * @param {object} [options] Format options.
-   * @returns {*} Decoded raw graph.
+  /**
+   * Decode the exact inert graph while preserving memo aliases and cycles.
+   *
+   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.
+   * @param {object} [options] Format options.
+   * @returns {*} Decoded raw graph.
    */
   static readRaw(input, options = {}) {
     return this.readPayload(input, options);
   }
 
-  /**
-   * Verify that a decoded graph is JSON-compatible without changing its shape.
-   *
-   * @param {*} value Candidate decoded graph.
-   * @returns {*} The supplied value.
+  /**
+   * Verify that a decoded graph is JSON-compatible without changing its shape.
+   *
+   * @param {*} value Candidate decoded graph.
+   * @returns {*} The supplied value.
    */
   static toJSON(value) {
     return CjsPickleProtocol0Reader.ToJSON(value);
@@ -179,45 +179,14 @@ class CjsPickleFormat extends CjsFormat {
   }
 
   /** Return synchronous advisory support from a bounded protocol-0 decode. */
-  static probeSupport(input, options = {}) {
-    try {
-      return {
-        format: this.id,
-        recognized: true,
-        supported: true,
-        preferredOutput: OUTPUT_JSON,
-        metadata: this.inspect(input, options),
-        variants: [{
-          kind: OUTPUT_JSON,
-          supported: true
-        }, {
-          kind: OUTPUT_PAYLOAD,
-          supported: true
-        }, {
-          kind: OUTPUT_RAW,
-          supported: true
-        }],
-        reason: "The input is a supported inert protocol-0 pickle."
-      };
-    } catch (error) {
-      return {
-        format: this.id,
-        recognized: false,
-        supported: false,
-        metadata: null,
-        reason: error.message,
-        errors: [error.message]
-      };
-    }
-  }
 
-  /**
-   * Normalize a format profile and partial override into detached effective
-   * values.
-   *
-   * @param {object} base Existing normalized values.
-   * @param {object} [options] Partial emit and limit overrides.
-   * @returns {object} Detached normalized values.
+  /**
+   * Normalize a format profile and partial override into detached effective
+   * values.
+   *
+   * @param {object} base Existing normalized values.
+   * @param {object} [options] Partial emit and limit overrides.
+   * @returns {object} Detached normalized values.
    */
   static normalizeValues(base, options = {}) {
     if (!options || typeof options !== "object" || Array.isArray(options)) {

package/dist/resource/formats/pickle/CjsPickleFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsPickleFormat.js","sources":["../../../../../src/resource/formats/pickle/CjsPickleFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\r\nimport {\r\n  CjsPickleProtocol0Reader,\r\n  PICKLE_PROTOCOL_0_LIMITS\r\n} from \"./core/CjsPickleProtocol0Reader.js\";\r\n\r\nconst OUTPUT_JSON = \"json\";\r\nconst OUTPUT_PAYLOAD = \"payload\";\r\nconst OUTPUT_RAW = \"raw\";\r\nconst OUTPUTS = new Set([ OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW ]);\r\nconst OPTION_NAMES = new Set([ \"emit\", \"limits\" ]);\r\nconst DEFAULT_VALUES = {\r\n  emit: OUTPUT_JSON,\r\n  limits: PICKLE_PROTOCOL_0_LIMITS\r\n};\r\n\r\n/**\r\n * Data-only Python pickle format facade that currently decodes protocol 0 into\r\n * JSON-compatible values or identity-preserving payload graphs while rejecting\r\n * callable and object-construction opcodes.\r\n */\r\nexport class CjsPickleFormat extends CjsFormat\r\n{\r\n  #values = DEFAULT_VALUES;\r\n\r\n  /**\r\n   * Create a reusable protocol-0 pickle format profile.\r\n   *\r\n   * @param {object} [options] Emit mode and bounded decoder limits.\r\n   */\r\n  constructor(options = {})\r\n  {\r\n    super();\r\n    this.SetValues(options);\r\n  }\r\n\r\n  /**\r\n   * Apply supported format options to this profile.\r\n   *\r\n   * @param {object} [options] Emit mode and partial decoder limits.\r\n   * @returns {CjsPickleFormat} This format profile.\r\n   */\r\n  SetValues(options = {})\r\n  {\r\n    this.#values = this.constructor.normalizeValues(this.#values, options);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Return normalized format values with optional per-call overrides.\r\n   *\r\n   * @param {object} [options] Per-call format options.\r\n   * @returns {object} Detached effective values.\r\n   */\r\n  GetValues(options = {})\r\n  {\r\n    return this.constructor.normalizeValues(this.#values, options);\r\n  }\r\n\r\n  /**\r\n   * Decode according to the effective emit mode.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Per-call format options.\r\n   * @returns {*} Decoded value graph.\r\n   */\r\n  Read(input, options = {})\r\n  {\r\n    return CjsPickleFormat.read(input, this.GetValues(options));\r\n  }\r\n\r\n  /**\r\n   * Decode a JSON-compatible graph, rejecting cyclic memo references.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Per-call format options.\r\n   * @returns {*} JSON-compatible decoded graph.\r\n   */\r\n  ReadJSON(input, options = {})\r\n  {\r\n    return CjsPickleFormat.readJSON(input, this.GetValues(options));\r\n  }\r\n\r\n  /**\r\n   * Decode the inert payload while preserving memo object identity.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Per-call format options.\r\n   * @returns {*} Decoded payload graph.\r\n   */\r\n  ReadPayload(input, options = {})\r\n  {\r\n    return CjsPickleFormat.readPayload(input, this.GetValues(options));\r\n  }\r\n\r\n  /**\r\n   * Decode the exact inert graph while preserving memo aliases and cycles.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Per-call format options.\r\n   * @returns {*} Decoded raw graph.\r\n   */\r\n  ReadRaw(input, options = {})\r\n  {\r\n    return CjsPickleFormat.readRaw(input, this.GetValues(options));\r\n  }\r\n\r\n  /**\r\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\r\n   *\r\n   * @param {*} value Candidate decoded graph.\r\n   * @returns {*} The supplied value.\r\n   */\r\n  ToJSON(value)\r\n  {\r\n    return CjsPickleFormat.toJSON(value);\r\n  }\r\n\r\n  /**\r\n   * Decode according to the requested emit mode.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Format options.\r\n   * @returns {*} Decoded value graph.\r\n   */\r\n  static read(input, options = {})\r\n  {\r\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\r\n    if (values.emit === OUTPUT_RAW) return this.readRaw(input, values);\r\n    if (values.emit === OUTPUT_PAYLOAD) return this.readPayload(input, values);\r\n    return this.readJSON(input, values);\r\n  }\r\n\r\n  /**\r\n   * Decode a JSON-compatible graph through the protocol-0 implementation.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Format options.\r\n   * @returns {*} JSON-compatible decoded graph.\r\n   */\r\n  static readJSON(input, options = {})\r\n  {\r\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\r\n    return new CjsPickleProtocol0Reader(input, values).ReadJSON();\r\n  }\r\n\r\n  /**\r\n   * Decode an inert payload while preserving pickle memo identity.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Format options.\r\n   * @returns {*} Decoded payload graph.\r\n   */\r\n  static readPayload(input, options = {})\r\n  {\r\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\r\n    return new CjsPickleProtocol0Reader(input, values).Read();\r\n  }\r\n\r\n  /**\r\n   * Decode the exact inert graph while preserving memo aliases and cycles.\r\n   *\r\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\r\n   * @param {object} [options] Format options.\r\n   * @returns {*} Decoded raw graph.\r\n   */\r\n  static readRaw(input, options = {})\r\n  {\r\n    return this.readPayload(input, options);\r\n  }\r\n\r\n  /**\r\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\r\n   *\r\n   * @param {*} value Candidate decoded graph.\r\n   * @returns {*} The supplied value.\r\n   */\r\n  static toJSON(value)\r\n  {\r\n    return CjsPickleProtocol0Reader.ToJSON(value);\r\n  }\r\n\r\n  /** Validate protocol-0 structure and return format metadata. */\r\n  static inspect(input, options = {})\r\n  {\r\n    const { source: _source, ...readOptions } = options;\r\n    const value = this.readPayload(input, readOptions);\r\n    const byteLength = input instanceof ArrayBuffer\r\n      ? input.byteLength\r\n      : ArrayBuffer.isView(input) ? input.byteLength : 0;\r\n    return {\r\n      protocol: 0,\r\n      byteLength,\r\n      rootType: value === null ? \"null\" : Array.isArray(value) ? \"array\" : typeof value\r\n    };\r\n  }\r\n\r\n  /** Return synchronous advisory support from a bounded protocol-0 decode. */\r\n  static probeSupport(input, options = {})\r\n  {\r\n    try\r\n    {\r\n      return {\r\n        format: this.id,\r\n        recognized: true,\r\n        supported: true,\r\n        preferredOutput: OUTPUT_JSON,\r\n        metadata: this.inspect(input, options),\r\n        variants: [\r\n          { kind: OUTPUT_JSON, supported: true },\r\n          { kind: OUTPUT_PAYLOAD, supported: true },\r\n          { kind: OUTPUT_RAW, supported: true }\r\n        ],\r\n        reason: \"The input is a supported inert protocol-0 pickle.\"\r\n      };\r\n    }\r\n    catch (error)\r\n    {\r\n      return {\r\n        format: this.id,\r\n        recognized: false,\r\n        supported: false,\r\n        metadata: null,\r\n        reason: error.message,\r\n        errors: [ error.message ]\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Normalize a format profile and partial override into detached effective\r\n   * values.\r\n   *\r\n   * @param {object} base Existing normalized values.\r\n   * @param {object} [options] Partial emit and limit overrides.\r\n   * @returns {object} Detached normalized values.\r\n   */\r\n  static normalizeValues(base, options = {})\r\n  {\r\n    if (!options || typeof options !== \"object\" || Array.isArray(options))\r\n    {\r\n      throw new TypeError(\"CjsPickleFormat options must be an object.\");\r\n    }\r\n    for (const name of Object.keys(options))\r\n    {\r\n      if (!OPTION_NAMES.has(name))\r\n      {\r\n        throw new TypeError(`CjsPickleFormat unknown option ${JSON.stringify(name)}.`);\r\n      }\r\n    }\r\n\r\n    const emit = options.emit ?? base.emit;\r\n    if (!OUTPUTS.has(emit))\r\n    {\r\n      throw new TypeError(`CjsPickleFormat unknown emit value ${JSON.stringify(emit)}.`);\r\n    }\r\n\r\n    const baseLimits = base.limits || PICKLE_PROTOCOL_0_LIMITS;\r\n    const optionLimits = options.limits ?? {};\r\n    if (!optionLimits || typeof optionLimits !== \"object\" || Array.isArray(optionLimits))\r\n    {\r\n      throw new TypeError(\"CjsPickleFormat limits must be an object.\");\r\n    }\r\n\r\n    return {\r\n      emit,\r\n      limits: {\r\n        ...baseLimits,\r\n        ...optionLimits\r\n      }\r\n    };\r\n  }\r\n\r\n  static Output = Object.freeze({\r\n    JSON: OUTPUT_JSON,\r\n    PAYLOAD: OUTPUT_PAYLOAD,\r\n    RAW: OUTPUT_RAW\r\n  });\r\n  static supportedProtocols = Object.freeze([ 0 ]);\r\n  static id = \"pickle\";\r\n  static extensions = Object.freeze([ \".pickle\" ]);\r\n  static mediaTypes = Object.freeze([ \"data\" ]);\r\n  static outputs = CjsFormat.defineOutputs({\r\n      json: { default: true, decoded: true },\r\n      payload: { decoded: true },\r\n      raw: { role: \"debug\", decoded: true }\r\n  });\r\n}\r\n\r\nexport default CjsPickleFormat;\r\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RAW","OUTPUTS","Set","OPTION_NAMES","DEFAULT_VALUES","emit","limits","PICKLE_PROTOCOL_0_LIMITS","CjsPickleFormat","CjsFormat","constructor","options","SetValues","normalizeValues","GetValues","Read","input","read","ReadJSON","readJSON","ReadPayload","readPayload","ReadRaw","readRaw","ToJSON","value","toJSON","values","CjsPickleProtocol0Reader","inspect","source","_source","readOptions","byteLength","ArrayBuffer","isView","protocol","rootType","Array","isArray","probeSupport","format","id","recognized","supported","preferredOutput","metadata","variants","kind","reason","error","message","errors","base","TypeError","name","Object","keys","has","JSON","stringify","baseLimits","optionLimits","Output","freeze","PAYLOAD","RAW","supportedProtocols","extensions","mediaTypes","outputs","defineOutputs","json","default","decoded","payload","raw","role"],"mappings":"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"}
+{"version":3,"file":"CjsPickleFormat.js","sources":["../../../../../src/resource/formats/pickle/CjsPickleFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n  CjsPickleProtocol0Reader,\n  PICKLE_PROTOCOL_0_LIMITS\n} from \"./core/CjsPickleProtocol0Reader.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst OUTPUT_RAW = \"raw\";\nconst OUTPUTS = new Set([ OUTPUT_JSON, OUTPUT_PAYLOAD, OUTPUT_RAW ]);\nconst OPTION_NAMES = new Set([ \"emit\", \"limits\" ]);\nconst DEFAULT_VALUES = {\n  emit: OUTPUT_JSON,\n  limits: PICKLE_PROTOCOL_0_LIMITS\n};\n\n/**\n * Data-only Python pickle format facade that currently decodes protocol 0 into\n * JSON-compatible values or identity-preserving payload graphs while rejecting\n * callable and object-construction opcodes.\n */\nexport class CjsPickleFormat extends CjsFormat\n{\n  #values = DEFAULT_VALUES;\n\n  /**\n   * Create a reusable protocol-0 pickle format profile.\n   *\n   * @param {object} [options] Emit mode and bounded decoder limits.\n   */\n  constructor(options = {})\n  {\n    super();\n    this.SetValues(options);\n  }\n\n  /**\n   * Apply supported format options to this profile.\n   *\n   * @param {object} [options] Emit mode and partial decoder limits.\n   * @returns {CjsPickleFormat} This format profile.\n   */\n  SetValues(options = {})\n  {\n    this.#values = this.constructor.normalizeValues(this.#values, options);\n    return this;\n  }\n\n  /**\n   * Return normalized format values with optional per-call overrides.\n   *\n   * @param {object} [options] Per-call format options.\n   * @returns {object} Detached effective values.\n   */\n  GetValues(options = {})\n  {\n    return this.constructor.normalizeValues(this.#values, options);\n  }\n\n  /**\n   * Decode according to the effective emit mode.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded value graph.\n   */\n  Read(input, options = {})\n  {\n    return CjsPickleFormat.read(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode a JSON-compatible graph, rejecting cyclic memo references.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} JSON-compatible decoded graph.\n   */\n  ReadJSON(input, options = {})\n  {\n    return CjsPickleFormat.readJSON(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode the inert payload while preserving memo object identity.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded payload graph.\n   */\n  ReadPayload(input, options = {})\n  {\n    return CjsPickleFormat.readPayload(input, this.GetValues(options));\n  }\n\n  /**\n   * Decode the exact inert graph while preserving memo aliases and cycles.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Per-call format options.\n   * @returns {*} Decoded raw graph.\n   */\n  ReadRaw(input, options = {})\n  {\n    return CjsPickleFormat.readRaw(input, this.GetValues(options));\n  }\n\n  /**\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\n   *\n   * @param {*} value Candidate decoded graph.\n   * @returns {*} The supplied value.\n   */\n  ToJSON(value)\n  {\n    return CjsPickleFormat.toJSON(value);\n  }\n\n  /**\n   * Decode according to the requested emit mode.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded value graph.\n   */\n  static read(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    if (values.emit === OUTPUT_RAW) return this.readRaw(input, values);\n    if (values.emit === OUTPUT_PAYLOAD) return this.readPayload(input, values);\n    return this.readJSON(input, values);\n  }\n\n  /**\n   * Decode a JSON-compatible graph through the protocol-0 implementation.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} JSON-compatible decoded graph.\n   */\n  static readJSON(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    return new CjsPickleProtocol0Reader(input, values).ReadJSON();\n  }\n\n  /**\n   * Decode an inert payload while preserving pickle memo identity.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded payload graph.\n   */\n  static readPayload(input, options = {})\n  {\n    const values = this.normalizeValues(DEFAULT_VALUES, options);\n    return new CjsPickleProtocol0Reader(input, values).Read();\n  }\n\n  /**\n   * Decode the exact inert graph while preserving memo aliases and cycles.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Pickle bytes.\n   * @param {object} [options] Format options.\n   * @returns {*} Decoded raw graph.\n   */\n  static readRaw(input, options = {})\n  {\n    return this.readPayload(input, options);\n  }\n\n  /**\n   * Verify that a decoded graph is JSON-compatible without changing its shape.\n   *\n   * @param {*} value Candidate decoded graph.\n   * @returns {*} The supplied value.\n   */\n  static toJSON(value)\n  {\n    return CjsPickleProtocol0Reader.ToJSON(value);\n  }\n\n  /** Validate protocol-0 structure and return format metadata. */\n  static inspect(input, options = {})\n  {\n    const { source: _source, ...readOptions } = options;\n    const value = this.readPayload(input, readOptions);\n    const byteLength = input instanceof ArrayBuffer\n      ? input.byteLength\n      : ArrayBuffer.isView(input) ? input.byteLength : 0;\n    return {\n      protocol: 0,\n      byteLength,\n      rootType: value === null ? \"null\" : Array.isArray(value) ? \"array\" : typeof value\n    };\n  }\n\n  /** Return synchronous advisory support from a bounded protocol-0 decode. */\n\n  /**\n   * Normalize a format profile and partial override into detached effective\n   * values.\n   *\n   * @param {object} base Existing normalized values.\n   * @param {object} [options] Partial emit and limit overrides.\n   * @returns {object} Detached normalized values.\n   */\n  static normalizeValues(base, options = {})\n  {\n    if (!options || typeof options !== \"object\" || Array.isArray(options))\n    {\n      throw new TypeError(\"CjsPickleFormat options must be an object.\");\n    }\n    for (const name of Object.keys(options))\n    {\n      if (!OPTION_NAMES.has(name))\n      {\n        throw new TypeError(`CjsPickleFormat unknown option ${JSON.stringify(name)}.`);\n      }\n    }\n\n    const emit = options.emit ?? base.emit;\n    if (!OUTPUTS.has(emit))\n    {\n      throw new TypeError(`CjsPickleFormat unknown emit value ${JSON.stringify(emit)}.`);\n    }\n\n    const baseLimits = base.limits || PICKLE_PROTOCOL_0_LIMITS;\n    const optionLimits = options.limits ?? {};\n    if (!optionLimits || typeof optionLimits !== \"object\" || Array.isArray(optionLimits))\n    {\n      throw new TypeError(\"CjsPickleFormat limits must be an object.\");\n    }\n\n    return {\n      emit,\n      limits: {\n        ...baseLimits,\n        ...optionLimits\n      }\n    };\n  }\n\n  static Output = Object.freeze({\n    JSON: OUTPUT_JSON,\n    PAYLOAD: OUTPUT_PAYLOAD,\n    RAW: OUTPUT_RAW\n  });\n  static supportedProtocols = Object.freeze([ 0 ]);\n  static id = \"pickle\";\n  static extensions = Object.freeze([ \".pickle\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = CjsFormat.defineOutputs({\n      json: { default: true, decoded: true },\n      payload: { decoded: true },\n      raw: { role: \"debug\", decoded: true }\n  });\n}\n\nexport default CjsPickleFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RAW","OUTPUTS","Set","OPTION_NAMES","DEFAULT_VALUES","emit","limits","PICKLE_PROTOCOL_0_LIMITS","CjsPickleFormat","CjsFormat","constructor","options","SetValues","normalizeValues","GetValues","Read","input","read","ReadJSON","readJSON","ReadPayload","readPayload","ReadRaw","readRaw","ToJSON","value","toJSON","values","CjsPickleProtocol0Reader","inspect","source","_source","readOptions","byteLength","ArrayBuffer","isView","protocol","rootType","Array","isArray","base","TypeError","name","Object","keys","has","JSON","stringify","baseLimits","optionLimits","Output","freeze","PAYLOAD","RAW","supportedProtocols","id","extensions","mediaTypes","outputs","defineOutputs","json","default","decoded","payload","raw","role"],"mappings":"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"}

package/dist/resource/formats/png/CjsPngFormat.js

@@ -1,7 +1,9 @@
 import { asUint8Array } from '#utils/bytes';
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { DEFAULT_VALUES, normalizeValues, readWithValues, readWithValuesAsync, inspectWithValues, toJsonValue, probeSupportWithValues, isPNG, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, OUTPUT_IMAGE } from './core/helpers.js';
+import { DEFAULT_VALUES, normalizeValues, readWithValues, readWithValuesAsync, inspectWithValues, probeSupportWithValues, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, OUTPUT_IMAGE } from './core/helpers.js';
 import { encodePng, encodePngAsync } from './core/writer.js';
+import { toJsonWithByteSummary } from '../../format/jsonPolicies.js';
+import { isPNG } from '../../format/imageSignatures.js';
 
 const FORMAT_NAME = "CjsPngFormat";
 
@@ -130,7 +132,7 @@ class CjsPngFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   ToJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**
@@ -196,7 +198,7 @@ class CjsPngFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   static toJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**

package/dist/resource/formats/png/CjsPngFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsPngFormat.js","sources":["../../../../../src/resource/formats/png/CjsPngFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_IMAGE,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    OUTPUT_RGBA,\n    inspectWithValues,\n    isPNG,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    readWithValuesAsync,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { encodePng, encodePngAsync } from \"./core/writer.js\";\n\nconst FORMAT_NAME = \"CjsPngFormat\";\n\n/**\n * PNG format profile that synchronously inspects chunk and header metadata\n * and emits raw bytes or debug JSON, with RGBA decoding available on the\n * asynchronous read path.\n */\nexport class CjsPngFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * One-shot PNG write from a normalized RGBA payload, without compressing.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Uint8Array} PNG bytes.\n     */\n    static write(payload, options = {})\n    {\n        return encodePng(payload, options);\n    }\n\n    /**\n     * One-shot compressed PNG write from a normalized RGBA payload.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Promise<Uint8Array>} PNG bytes.\n     */\n    static async writeAsync(payload, options = {})\n    {\n        return encodePngAsync(payload, options);\n    }\n\n    /**\n     * Write a normalized RGBA payload as PNG bytes, without compressing.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Uint8Array} PNG bytes.\n     */\n    Write(payload, options = {})\n    {\n        return encodePng(payload, options);\n    }\n\n    /**\n     * Write a normalized RGBA payload as compressed PNG bytes.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Promise<Uint8Array>} PNG bytes.\n     */\n    async WriteAsync(payload, options = {})\n    {\n        return encodePngAsync(payload, options);\n    }\n\n    /**\n     * Create a reusable PNG format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsPngFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"png\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"png\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Read PNG bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options), \"png\");\n    }\n\n    /**\n     * Read PNG bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return readWithValuesAsync(input, this.GetValues(options), \"png\");\n    }\n\n    /**\n     * Inspect PNG bytes without decoding image data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} PNG header metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options), \"png\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot PNG read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * One-shot asynchronous PNG read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return readWithValuesAsync(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * One-shot PNG inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} PNG header metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * One-shot PNG support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a PNG file.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate PNG bytes.\n     * @returns {boolean} True when the PNG signature is present.\n     */\n    static isPNG(input)\n    {\n        try\n        {\n            return isPNG(asUint8Array(input, \"Image input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        IMAGE: OUTPUT_IMAGE,\n        RGBA: OUTPUT_RGBA,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON\n    });\n    static OUTPUT_PNG_JSON = \"pngJson\";\n    static id = \"png\";\n    static mediaTypes = Object.freeze([ \"image\" ]);\n    static inputs = CjsFormat.defineInputs({\n        // async because the compressing path is the real one; the sync writer\n        // emits stored blocks and is the fallback, not the intent.\n        rgba: { default: true, writeMode: \"async\", options: [ \"compression\" ] }\n    });\n\n    static outputs = CjsFormat.defineOutputs({\n        image: { readMode: \"async\", decoded: true, probes: [ \"image\", \"rgba\" ] },\n        rgba: { readMode: \"async\", decoded: true },\n        pngJson: { role: \"debug\", probes: [ \"pngJson\", \"raw\" ] },\n        raw: { role: \"debug\", default: true, passthrough: true }\n    });\n    static extensions = Object.freeze([ \".png\" ]);\n}\n\nexport default CjsPngFormat;\n"],"names":["FORMAT_NAME","CjsPngFormat","CjsFormat","DEFAULT_VALUES","write","payload","options","encodePng","writeAsync","encodePngAsync","Write","WriteAsync","constructor","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","readWithValuesAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","toJSON","isPNG","asUint8Array","Output","Object","freeze","IMAGE","OUTPUT_IMAGE","RGBA","OUTPUT_RGBA","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","OUTPUT_PNG_JSON","id","mediaTypes","inputs","defineInputs","rgba","default","writeMode","outputs","defineOutputs","image","readMode","decoded","probes","pngJson","role","raw","passthrough","extensions"],"mappings":"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"}
+{"version":3,"file":"CjsPngFormat.js","sources":["../../../../../src/resource/formats/png/CjsPngFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_IMAGE,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    OUTPUT_RGBA,\n    inspectWithValues,\n    isPNG,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    readWithValuesAsync,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { encodePng, encodePngAsync } from \"./core/writer.js\";\n\nconst FORMAT_NAME = \"CjsPngFormat\";\n\n/**\n * PNG format profile that synchronously inspects chunk and header metadata\n * and emits raw bytes or debug JSON, with RGBA decoding available on the\n * asynchronous read path.\n */\nexport class CjsPngFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * One-shot PNG write from a normalized RGBA payload, without compressing.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Uint8Array} PNG bytes.\n     */\n    static write(payload, options = {})\n    {\n        return encodePng(payload, options);\n    }\n\n    /**\n     * One-shot compressed PNG write from a normalized RGBA payload.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Promise<Uint8Array>} PNG bytes.\n     */\n    static async writeAsync(payload, options = {})\n    {\n        return encodePngAsync(payload, options);\n    }\n\n    /**\n     * Write a normalized RGBA payload as PNG bytes, without compressing.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Uint8Array} PNG bytes.\n     */\n    Write(payload, options = {})\n    {\n        return encodePng(payload, options);\n    }\n\n    /**\n     * Write a normalized RGBA payload as compressed PNG bytes.\n     *\n     * @param {object} payload As emitted for `rgba`.\n     * @returns {Promise<Uint8Array>} PNG bytes.\n     */\n    async WriteAsync(payload, options = {})\n    {\n        return encodePngAsync(payload, options);\n    }\n\n    /**\n     * Create a reusable PNG format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsPngFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, { inputType: \"png\", ...options }, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, { inputType: \"png\", ...options }, FORMAT_NAME);\n    }\n\n    /**\n     * Read PNG bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options), \"png\");\n    }\n\n    /**\n     * Read PNG bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return readWithValuesAsync(input, this.GetValues(options), \"png\");\n    }\n\n    /**\n     * Inspect PNG bytes without decoding image data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} PNG header metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options), \"png\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot PNG read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * One-shot asynchronous PNG read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return readWithValuesAsync(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * One-shot PNG inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} PNG header metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * One-shot PNG support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input PNG bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, { inputType: \"png\", ...options }, FORMAT_NAME), \"png\");\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a PNG file.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate PNG bytes.\n     * @returns {boolean} True when the PNG signature is present.\n     */\n    static isPNG(input)\n    {\n        try\n        {\n            return isPNG(asUint8Array(input, \"Image input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        IMAGE: OUTPUT_IMAGE,\n        RGBA: OUTPUT_RGBA,\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON\n    });\n    static OUTPUT_PNG_JSON = \"pngJson\";\n    static id = \"png\";\n    static mediaTypes = Object.freeze([ \"image\" ]);\n    static inputs = CjsFormat.defineInputs({\n        // async because the compressing path is the real one; the sync writer\n        // emits stored blocks and is the fallback, not the intent.\n        rgba: { default: true, writeMode: \"async\", options: [ \"compression\" ] }\n    });\n\n    static outputs = CjsFormat.defineOutputs({\n        image: { readMode: \"async\", decoded: true, probes: [ \"image\", \"rgba\" ] },\n        rgba: { readMode: \"async\", decoded: true },\n        pngJson: { role: \"debug\", probes: [ \"pngJson\", \"raw\" ] },\n        raw: { role: \"debug\", default: true, passthrough: true }\n    });\n    static extensions = Object.freeze([ \".png\" ]);\n}\n\nexport default CjsPngFormat;\n"],"names":["FORMAT_NAME","CjsPngFormat","CjsFormat","DEFAULT_VALUES","write","payload","options","encodePng","writeAsync","encodePngAsync","Write","WriteAsync","constructor","SetValues","normalizeValues","inputType","GetValues","Read","input","readWithValues","ReadAsync","readWithValuesAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","toJSON","isPNG","asUint8Array","Output","Object","freeze","IMAGE","OUTPUT_IMAGE","RGBA","OUTPUT_RGBA","RAW","OUTPUT_RAW","JSON","OUTPUT_JSON","OUTPUT_PNG_JSON","id","mediaTypes","inputs","defineInputs","rgba","default","writeMode","outputs","defineOutputs","image","readMode","decoded","probes","pngJson","role","raw","passthrough","extensions"],"mappings":"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"}