@carbonenginejs/runtime-resource 0.20.0 → 0.22.0

package/dist/resource/texture/TriTextureRes.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriTextureRes.js","sources":["../../../../src/resource/texture/TriTextureRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriTextureRes.h\n// Source: trinity/trinity/Resources/TriTextureRes.cpp\n// Source: trinity/trinity/Resources/TriTextureRes_Blue.cpp\nimport { CjsSchema, carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport {\n  ResourcePayloadType,\n  validateRgbaPayload,\n  validateTexturePayload,\n  validateVideoPayload\n} from \"../../format/payloadContract.js\";\nimport {\n  resourceBoundaryError,\n  resourcePayloadError,\n  validateResourcePayload\n} from \"../resourceBoundary.js\";\n\n/**\n * Resource record that owns Carbon-style texture identity and validated\n * texture, RGBA, or video payload facts with mirrored dimension/format\n * metadata, while engine packages decide what those facts become on a device.\n *\n * The resource never creates or retains a backend texture.\n */\nexport class TriTextureRes extends CjsResource\n{\n  format = null;\n  type = null;\n  averageColor = [0, 0, 0, 0];\n  depth = 0;\n  cutoutHeight = 1;\n  height = 0;\n  lodEnabled = false;\n  hadLodRequests = false;\n  cpuMip = 0;\n  gpuMip = 0;\n  wrappedRenderTarget = null;\n  originalResolution = 0;\n  originalMemoryUsage = 0;\n  name = \"\";\n  arraySize = 0;\n  cutoutWidth = 1;\n  width = 0;\n  cutoutX = 0;\n  cutoutY = 0;\n\n  /** Creates a TriTextureRes with caller-provided initial state. */\n  constructor(values = null) {\n    super();\n    this.SetValues(values || {}, {\n      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Attach a plain texture, RGBA, or video payload and mirror Carbon-exposed\n   * metadata. Invalid payloads are rejected before replacing the current one.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {TriTextureRes}\n   */\n  SetPayload(payload = null, options = null) {\n    if (payload === null) {\n      super.SetPayload(null);\n      return this;\n    }\n\n    const validator = {\n      [ResourcePayloadType.RGBA]: validateRgbaPayload,\n      [ResourcePayloadType.TEXTURE]: validateTexturePayload,\n      [ResourcePayloadType.VIDEO]: validateVideoPayload\n    }[payload?.payloadType];\n    if (!validator) {\n      throw resourcePayloadError(\n        \"TriTextureRes\",\n        'Expected payloadType \"rgba\", \"texture\", or \"video\".',\n        \"payloadType\"\n      );\n    }\n    validateResourcePayload(\"TriTextureRes\", payload, validator);\n\n    const values = { ...(options || {}) };\n    if (payload.pixelFormat !== undefined || payload.format !== undefined) values.format = payload.pixelFormat || payload.format;\n    if (payload.width !== undefined) values.width = payload.width;\n    if (payload.height !== undefined) values.height = payload.height;\n    if (payload.depth !== undefined) values.depth = payload.depth;\n    if (payload.arraySize !== undefined) values.arraySize = payload.arraySize;\n    else if (Array.isArray(payload.faces)) values.arraySize = payload.faces.length;\n    if (payload.mipCount !== undefined) values.cpuMip = payload.mipCount;\n    else if (payload.payloadType === ResourcePayloadType.RGBA) values.cpuMip = 1;\n    if (payload.hadLodRequests !== undefined) values.hadLodRequests = !!payload.hadLodRequests;\n    values.originalMemoryUsage = getPayloadMemoryUsage(payload);\n    values.originalResolution = Math.max(payload.width || 0, payload.height || 0, this.originalResolution || 0);\n\n    super.SetPayload(payload);\n    this.SetValues(values);\n    return this;\n  }\n\n  /**\n   * Return the number of mip levels known to this texture resource.\n   *\n   * @returns {number}\n   */\n  GetMipCount() {\n    return this.GetPayload()?.mipCount || this.cpuMip || 0;\n  }\n\n  /**\n   * Return the multisample type for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaType() {\n    const payload = this.GetPayload();\n    return payload?.multiSampleType ?? payload?.msaaType ?? payload?.samples ?? 1;\n  }\n\n  /**\n   * Return the multisample quality for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaQuality() {\n    const payload = this.GetPayload();\n    return payload?.multiSampleQuality ?? payload?.msaaQuality ?? 0;\n  }\n\n  /**\n   * Return true if this texture has received LOD requests.\n   *\n   * @returns {boolean}\n   */\n  HadLodRequests() {\n    return this.hadLodRequests;\n  }\n\n  /**\n   * Return the shader-resource-view heap index when a backend owns one.\n   *\n   * @returns {number}\n   */\n  GetSrvIndexInHeap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"GetSrvIndexInHeap\", \"Runtime-resource does not own descriptor heaps.\");\n  }\n\n  /**\n   * Save this texture asynchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  SaveAsync(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"SaveAsync\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Save this texture synchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  Save(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"Save\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Return true if an asynchronous save is active.\n   *\n   * @returns {boolean}\n   */\n  IsSaving() {\n    return false;\n  }\n\n  /**\n   * Return true if the asynchronous save operation has completed.\n   *\n   * @returns {boolean}\n   */\n  IsSaveCompleted() {\n    return true;\n  }\n\n  /**\n   * Return true if the asynchronous save operation succeeded.\n   *\n   * @returns {boolean}\n   */\n  IsSaveSucceeded() {\n    return false;\n  }\n\n  /**\n   * Wait for an asynchronous save operation.\n   *\n   * @returns {boolean}\n   */\n  WaitForSave() {\n    return this.IsSaveCompleted();\n  }\n\n  /**\n   * Device texture allocation belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  CreateEmptyTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateEmptyTexture\", \"Use engine-gpu to allocate device textures.\");\n  }\n\n  /**\n   * Render-target wrapping belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  SetFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"SetFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a texture copy from a render target.\n   *\n   * @throws {Error}\n   */\n  CreateAndCopyFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateAndCopyFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a device texture from a host bitmap.\n   *\n   * @throws {Error}\n   */\n  CreateFromHostBitmap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromHostBitmap\", \"Use engine-gpu to allocate and upload texture data.\");\n  }\n\n  /**\n   * Create this texture from another texture resource.\n   *\n   * @throws {Error}\n   */\n  CreateFromTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromTexture\", \"Use engine-gpu to copy device textures.\");\n  }\n\n  /**\n   * Return true if this texture owns a backend allocation object.\n   *\n   * @param {string|number} type\n   * @param {string|number} object\n   * @returns {boolean}\n   */\n  HasALObject(type, object) {\n    return this.HasAdapterResource(`${type}:${object}`);\n  }\n\n  /**\n   * Return an engine-owned texture pipeline object when attached.\n   *\n   * @returns {*}\n   */\n  GetPipeline() {\n    return this.GetAdapterResource(\"pipeline\");\n  }\n\n  /**\n   * Return memory size for the original non-LODed texture.\n   *\n   * @returns {number}\n   */\n  GetOriginalMemoryUsage() {\n    return this.originalMemoryUsage || getPayloadMemoryUsage(this.GetPayload());\n  }\n\n  /**\n   * Store the average color reported by decoded texture data.\n   *\n   * @param {number} red\n   * @param {number} green\n   * @param {number} blue\n   * @param {number} alpha\n   * @returns {TriTextureRes}\n   */\n  SetAverageColor(red = 0, green = 0, blue = 0, alpha = 0) {\n    this.averageColor = [red, green, blue, alpha];\n    return this;\n  }\n\n  /**\n   * Update a texture subresource.\n   *\n   * @throws {Error}\n   */\n  UpdateSubresource() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"UpdateSubresource\", \"Use engine-gpu to upload texture bytes.\");\n  }\n\n  /**\n   * Resource preparation does not decide device upload policy.\n   *\n   * @returns {boolean}\n   */\n  PrepareResources() {\n    return this.IsPrepared();\n  }\n\n  static payload = \"texture\";\n}\n\nfunction getPayloadMemoryUsage(payload)\n{\n  if (!payload || typeof payload !== \"object\") return 0;\n  if (Number.isSafeInteger(payload.originalMemoryUsage) && payload.originalMemoryUsage >= 0)\n  {\n    return payload.originalMemoryUsage;\n  }\n  return ArrayBuffer.isView(payload.data) || payload.data instanceof ArrayBuffer\n    ? payload.data.byteLength\n    : 0;\n}\n\n// Declared as data rather than with decorators, so the resource tree loads from\n// source without a transform. Field order is key order, and GetValues() exports\n// in that order.\nCjsSchema.define(TriTextureRes, {\n  className: \"TriTextureRes\",\n  family: \"resources\",\n  fields: {\n    format: [ type.unknown, io.read ],\n    type: [ type.unknown, io.persist ],\n    averageColor: [ type.color, io.read ],\n    depth: [ type.uint32, io.read ],\n    cutoutHeight: [ type.float32, io.readwrite ],\n    height: [ type.uint32, io.read ],\n    lodEnabled: [ type.boolean, io.read ],\n    hadLodRequests: [ type.boolean, io.read ],\n    cpuMip: [ type.uint32, io.read ],\n    gpuMip: [ type.uint32, io.read ],\n    wrappedRenderTarget: [ type.unknown, io.read ],\n    originalResolution: [ type.uint32, io.read ],\n    originalMemoryUsage: [ type.uint64, io.read ],\n    name: [ type.string, io.readwrite ],\n    arraySize: [ type.uint32, io.read ],\n    cutoutWidth: [ type.float32, io.readwrite ],\n    width: [ type.uint32, io.read ],\n    cutoutX: [ type.float32, io.readwrite ],\n    cutoutY: [ type.float32, io.readwrite ]\n  },\n  methods: {\n    GetMipCount: [ carbon.method, impl.adapted ],\n    GetMsaaType: [ carbon.method, impl.adapted ],\n    GetMsaaQuality: [ carbon.method, impl.adapted ],\n    HadLodRequests: [ carbon.method, impl.adapted ],\n    GetSrvIndexInHeap: [ carbon.method, impl.notSupported ],\n    SaveAsync: [ carbon.method, impl.notSupported ],\n    Save: [ carbon.method, impl.notSupported ],\n    IsSaving: [ carbon.method, impl.noop ],\n    IsSaveCompleted: [ carbon.method, impl.noop ],\n    IsSaveSucceeded: [ carbon.method, impl.noop ],\n    WaitForSave: [ carbon.method, impl.noop ],\n    CreateEmptyTexture: [ carbon.method, impl.notSupported ],\n    SetFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateAndCopyFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateFromHostBitmap: [ carbon.method, impl.notSupported ],\n    CreateFromTexture: [ carbon.method, impl.notSupported ],\n    HasALObject: [ carbon.method, impl.adapted ],\n    GetPipeline: [ carbon.method, impl.adapted ],\n    GetOriginalMemoryUsage: [ carbon.method, impl.adapted ],\n    SetAverageColor: [ carbon.method, impl.adapted ],\n    UpdateSubresource: [ carbon.method, impl.notSupported ],\n    PrepareResources: [ carbon.method, impl.adapted ]\n  }\n});\n"],"names":["TriTextureRes","CjsResource","format","type","averageColor","depth","cutoutHeight","height","lodEnabled","hadLodRequests","cpuMip","gpuMip","wrappedRenderTarget","originalResolution","originalMemoryUsage","name","arraySize","cutoutWidth","width","cutoutX","cutoutY","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","SetPayload","payload","options","validator","ResourcePayloadType","RGBA","validateRgbaPayload","TEXTURE","validateTexturePayload","VIDEO","validateVideoPayload","payloadType","resourcePayloadError","validateResourcePayload","pixelFormat","undefined","Array","isArray","faces","length","mipCount","getPayloadMemoryUsage","Math","max","GetMipCount","GetPayload","GetMsaaType","multiSampleType","msaaType","samples","GetMsaaQuality","multiSampleQuality","msaaQuality","HadLodRequests","GetSrvIndexInHeap","resourceBoundaryError","SaveAsync","path","Save","IsSaving","IsSaveCompleted","IsSaveSucceeded","WaitForSave","CreateEmptyTexture","SetFromRenderTarget","CreateAndCopyFromRenderTarget","CreateFromHostBitmap","CreateFromTexture","HasALObject","object","HasAdapterResource","GetPipeline","GetAdapterResource","GetOriginalMemoryUsage","SetAverageColor","red","green","blue","alpha","UpdateSubresource","PrepareResources","IsPrepared","Number","isSafeInteger","ArrayBuffer","isView","data","byteLength","CjsSchema","define","className","family","fields","unknown","io","read","persist","color","uint32","float32","readwrite","boolean","uint64","string","methods","carbon","method","impl","adapted","notSupported","noop"],"mappings":"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"}
+{"version":3,"file":"TriTextureRes.js","sources":["../../../../src/resource/texture/TriTextureRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriTextureRes.h\n// Source: trinity/trinity/Resources/TriTextureRes.cpp\n// Source: trinity/trinity/Resources/TriTextureRes_Blue.cpp\nimport { CjsSchema, carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport { ResourceRequirement } from \"../ResourceRequirement.js\";\nimport {\n  ResourcePayloadType,\n  validateRgbaPayload,\n  validateTexturePayload,\n  validateVideoPayload\n} from \"../../format/payloadContract.js\";\nimport {\n  resourceBoundaryError,\n  resourceFormatRequiredError,\n  resourcePayloadError,\n  validateResourcePayload\n} from \"../resourceBoundary.js\";\n\n/**\n * Resource record that owns Carbon-style texture identity and validated\n * texture, RGBA, or video payload facts with mirrored dimension/format\n * metadata, while engine packages decide what those facts become on a device.\n *\n * The resource never creates or retains a backend texture.\n */\nexport class TriTextureRes extends CjsResource\n{\n  format = null;\n  type = null;\n  averageColor = [0, 0, 0, 0];\n  depth = 0;\n  cutoutHeight = 1;\n  height = 0;\n  lodEnabled = false;\n  hadLodRequests = false;\n  cpuMip = 0;\n  gpuMip = 0;\n  wrappedRenderTarget = null;\n  originalResolution = 0;\n  originalMemoryUsage = 0;\n  name = \"\";\n  arraySize = 0;\n  cutoutWidth = 1;\n  width = 0;\n  cutoutX = 0;\n  cutoutY = 0;\n\n  /** Creates a TriTextureRes with caller-provided initial state. */\n  constructor(values = null) {\n    super();\n    this.SetValues(values || {}, {\n      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Attach a plain texture, RGBA, or video payload and mirror Carbon-exposed\n   * metadata. Invalid payloads are rejected before replacing the current one.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {TriTextureRes}\n   */\n  SetPayload(payload = null, options = null) {\n    if (payload === null) {\n      super.SetPayload(null);\n      return this;\n    }\n\n    const validator = {\n      [ResourcePayloadType.RGBA]: validateRgbaPayload,\n      [ResourcePayloadType.TEXTURE]: validateTexturePayload,\n      [ResourcePayloadType.VIDEO]: validateVideoPayload\n    }[payload?.payloadType];\n    if (!validator) {\n      throw resourcePayloadError(\n        \"TriTextureRes\",\n        'Expected payloadType \"rgba\", \"texture\", or \"video\".',\n        \"payloadType\"\n      );\n    }\n    validateResourcePayload(\"TriTextureRes\", payload, validator);\n\n    const values = { ...(options || {}) };\n    if (payload.pixelFormat !== undefined || payload.format !== undefined) values.format = payload.pixelFormat || payload.format;\n    if (payload.width !== undefined) values.width = payload.width;\n    if (payload.height !== undefined) values.height = payload.height;\n    if (payload.depth !== undefined) values.depth = payload.depth;\n    if (payload.arraySize !== undefined) values.arraySize = payload.arraySize;\n    else if (Array.isArray(payload.faces)) values.arraySize = payload.faces.length;\n    if (payload.mipCount !== undefined) values.cpuMip = payload.mipCount;\n    else if (payload.payloadType === ResourcePayloadType.RGBA) values.cpuMip = 1;\n    if (payload.hadLodRequests !== undefined) values.hadLodRequests = !!payload.hadLodRequests;\n    values.originalMemoryUsage = getPayloadMemoryUsage(payload);\n    values.originalResolution = Math.max(payload.width || 0, payload.height || 0, this.originalResolution || 0);\n\n    super.SetPayload(payload);\n    this.SetValues(values);\n    return this;\n  }\n\n  /**\n   * Turn source bytes into this texture.\n   *\n   * This is the family the route design exists for. One `.dds` is readable as a\n   * compressed `texture` or decoded `rgba`, and six formats — dds, png, jpeg,\n   * tga, gif, webp — populate this same resource. Which reader and which\n   * representation is a registration decision, so neither is written here.\n   *\n   * The resource imports none of them. A texture resource that imported its\n   * formats would drag all six into anything that touches a texture, which is\n   * the whole reason the store exists.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|object} data Source bytes, or a payload already read.\n   * @param {object|null} [options] `{ format, read, output }` plus values applied after the read.\n   * @returns {TriTextureRes} This resource.\n   */\n  DoLoad(data, options = null) {\n    const { format = null, read = null, output = null, ...values } = options || {};\n\n    // Already a payload: the manager read it, and there is nothing to route.\n    if (data?.payloadType !== undefined) return this.SetPayload(data, values);\n\n    const route = this.ResolveFormat(data, format ? { format, read, output } : { output });\n    if (!route) throw resourceFormatRequiredError(\"TriTextureRes\", this.ext, output);\n    return this.SetPayload(route.Read(data), values);\n  }\n\n  /**\n   * Return the number of mip levels known to this texture resource.\n   *\n   * @returns {number}\n   */\n  GetMipCount() {\n    return this.GetPayload()?.mipCount || this.cpuMip || 0;\n  }\n\n  /**\n   * Return the multisample type for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaType() {\n    const payload = this.GetPayload();\n    return payload?.multiSampleType ?? payload?.msaaType ?? payload?.samples ?? 1;\n  }\n\n  /**\n   * Return the multisample quality for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaQuality() {\n    const payload = this.GetPayload();\n    return payload?.multiSampleQuality ?? payload?.msaaQuality ?? 0;\n  }\n\n  /**\n   * Return true if this texture has received LOD requests.\n   *\n   * @returns {boolean}\n   */\n  HadLodRequests() {\n    return this.hadLodRequests;\n  }\n\n  /**\n   * Return the shader-resource-view heap index when a backend owns one.\n   *\n   * @returns {number}\n   */\n  GetSrvIndexInHeap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"GetSrvIndexInHeap\", \"Runtime-resource does not own descriptor heaps.\");\n  }\n\n  /**\n   * Save this texture asynchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  SaveAsync(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"SaveAsync\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Save this texture synchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  Save(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"Save\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Return true if an asynchronous save is active.\n   *\n   * @returns {boolean}\n   */\n  IsSaving() {\n    return false;\n  }\n\n  /**\n   * Return true if the asynchronous save operation has completed.\n   *\n   * @returns {boolean}\n   */\n  IsSaveCompleted() {\n    return true;\n  }\n\n  /**\n   * Return true if the asynchronous save operation succeeded.\n   *\n   * @returns {boolean}\n   */\n  IsSaveSucceeded() {\n    return false;\n  }\n\n  /**\n   * Wait for an asynchronous save operation.\n   *\n   * @returns {boolean}\n   */\n  WaitForSave() {\n    return this.IsSaveCompleted();\n  }\n\n  /**\n   * Device texture allocation belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  CreateEmptyTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateEmptyTexture\", \"Use engine-gpu to allocate device textures.\");\n  }\n\n  /**\n   * Render-target wrapping belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  SetFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"SetFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a texture copy from a render target.\n   *\n   * @throws {Error}\n   */\n  CreateAndCopyFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateAndCopyFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a device texture from a host bitmap.\n   *\n   * @throws {Error}\n   */\n  CreateFromHostBitmap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromHostBitmap\", \"Use engine-gpu to allocate and upload texture data.\");\n  }\n\n  /**\n   * Create this texture from another texture resource.\n   *\n   * @throws {Error}\n   */\n  CreateFromTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromTexture\", \"Use engine-gpu to copy device textures.\");\n  }\n\n  /**\n   * Return true if this texture owns a backend allocation object.\n   *\n   * @param {string|number} type\n   * @param {string|number} object\n   * @returns {boolean}\n   */\n  HasALObject(type, object) {\n    return this.HasAdapterResource(`${type}:${object}`);\n  }\n\n  /**\n   * Return an engine-owned texture pipeline object when attached.\n   *\n   * @returns {*}\n   */\n  GetPipeline() {\n    return this.GetAdapterResource(\"pipeline\");\n  }\n\n  /**\n   * Return memory size for the original non-LODed texture.\n   *\n   * @returns {number}\n   */\n  GetOriginalMemoryUsage() {\n    return this.originalMemoryUsage || getPayloadMemoryUsage(this.GetPayload());\n  }\n\n  /**\n   * Store the average color reported by decoded texture data.\n   *\n   * @param {number} red\n   * @param {number} green\n   * @param {number} blue\n   * @param {number} alpha\n   * @returns {TriTextureRes}\n   */\n  SetAverageColor(red = 0, green = 0, blue = 0, alpha = 0) {\n    this.averageColor = [red, green, blue, alpha];\n    return this;\n  }\n\n  /**\n   * Update a texture subresource.\n   *\n   * @throws {Error}\n   */\n  UpdateSubresource() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"UpdateSubresource\", \"Use engine-gpu to upload texture bytes.\");\n  }\n\n  /**\n   * Resource preparation does not decide device upload policy.\n   *\n   * @returns {boolean}\n   */\n  PrepareResources() {\n    return this.IsPrepared();\n  }\n\n  static payload = ResourceRequirement.TEXTURE;\n}\n\nfunction getPayloadMemoryUsage(payload)\n{\n  if (!payload || typeof payload !== \"object\") return 0;\n  if (Number.isSafeInteger(payload.originalMemoryUsage) && payload.originalMemoryUsage >= 0)\n  {\n    return payload.originalMemoryUsage;\n  }\n  return ArrayBuffer.isView(payload.data) || payload.data instanceof ArrayBuffer\n    ? payload.data.byteLength\n    : 0;\n}\n\n// Declared as data rather than with decorators, so the resource tree loads from\n// source without a transform. Field order is key order, and GetValues() exports\n// in that order.\nCjsSchema.define(TriTextureRes, {\n  className: \"TriTextureRes\",\n  family: \"resources\",\n  fields: {\n    format: [ type.unknown, io.read ],\n    type: [ type.unknown, io.persist ],\n    averageColor: [ type.color, io.read ],\n    depth: [ type.uint32, io.read ],\n    cutoutHeight: [ type.float32, io.readwrite ],\n    height: [ type.uint32, io.read ],\n    lodEnabled: [ type.boolean, io.read ],\n    hadLodRequests: [ type.boolean, io.read ],\n    cpuMip: [ type.uint32, io.read ],\n    gpuMip: [ type.uint32, io.read ],\n    wrappedRenderTarget: [ type.unknown, io.read ],\n    originalResolution: [ type.uint32, io.read ],\n    originalMemoryUsage: [ type.uint64, io.read ],\n    name: [ type.string, io.readwrite ],\n    arraySize: [ type.uint32, io.read ],\n    cutoutWidth: [ type.float32, io.readwrite ],\n    width: [ type.uint32, io.read ],\n    cutoutX: [ type.float32, io.readwrite ],\n    cutoutY: [ type.float32, io.readwrite ]\n  },\n  methods: {\n    GetMipCount: [ carbon.method, impl.adapted ],\n    GetMsaaType: [ carbon.method, impl.adapted ],\n    GetMsaaQuality: [ carbon.method, impl.adapted ],\n    HadLodRequests: [ carbon.method, impl.adapted ],\n    GetSrvIndexInHeap: [ carbon.method, impl.notSupported ],\n    SaveAsync: [ carbon.method, impl.notSupported ],\n    Save: [ carbon.method, impl.notSupported ],\n    IsSaving: [ carbon.method, impl.noop ],\n    IsSaveCompleted: [ carbon.method, impl.noop ],\n    IsSaveSucceeded: [ carbon.method, impl.noop ],\n    WaitForSave: [ carbon.method, impl.noop ],\n    CreateEmptyTexture: [ carbon.method, impl.notSupported ],\n    SetFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateAndCopyFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateFromHostBitmap: [ carbon.method, impl.notSupported ],\n    CreateFromTexture: [ carbon.method, impl.notSupported ],\n    HasALObject: [ carbon.method, impl.adapted ],\n    GetPipeline: [ carbon.method, impl.adapted ],\n    GetOriginalMemoryUsage: [ carbon.method, impl.adapted ],\n    SetAverageColor: [ carbon.method, impl.adapted ],\n    UpdateSubresource: [ carbon.method, impl.notSupported ],\n    PrepareResources: [ carbon.method, impl.adapted ]\n  }\n});\n"],"names":["TriTextureRes","CjsResource","format","type","averageColor","depth","cutoutHeight","height","lodEnabled","hadLodRequests","cpuMip","gpuMip","wrappedRenderTarget","originalResolution","originalMemoryUsage","name","arraySize","cutoutWidth","width","cutoutX","cutoutY","constructor","values","SetValues","markDirty","skipUpdate","skipEvents","SetPayload","payload","options","validator","ResourcePayloadType","RGBA","validateRgbaPayload","TEXTURE","validateTexturePayload","VIDEO","validateVideoPayload","payloadType","resourcePayloadError","validateResourcePayload","pixelFormat","undefined","Array","isArray","faces","length","mipCount","getPayloadMemoryUsage","Math","max","DoLoad","data","read","output","route","ResolveFormat","resourceFormatRequiredError","ext","Read","GetMipCount","GetPayload","GetMsaaType","multiSampleType","msaaType","samples","GetMsaaQuality","multiSampleQuality","msaaQuality","HadLodRequests","GetSrvIndexInHeap","resourceBoundaryError","SaveAsync","path","Save","IsSaving","IsSaveCompleted","IsSaveSucceeded","WaitForSave","CreateEmptyTexture","SetFromRenderTarget","CreateAndCopyFromRenderTarget","CreateFromHostBitmap","CreateFromTexture","HasALObject","object","HasAdapterResource","GetPipeline","GetAdapterResource","GetOriginalMemoryUsage","SetAverageColor","red","green","blue","alpha","UpdateSubresource","PrepareResources","IsPrepared","ResourceRequirement","Number","isSafeInteger","ArrayBuffer","isView","byteLength","CjsSchema","define","className","family","fields","unknown","io","persist","color","uint32","float32","readwrite","boolean","uint64","string","methods","carbon","method","impl","adapted","notSupported","noop"],"mappings":"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"}

package/docs/architecture.md

@@ -1,118 +1,123 @@
-# Architecture and boundaries
-
-Status: Evolving  
-Scope: `@carbonenginejs/runtime-resource`  
-Audience: Users and integrators  
-Summary: Defines the GPU-free boundary this package owns and how engine and runtime packages relate to it.
-
-## The GPU-free split
-
-`runtime-resource` owns the GPU-free half of the Carbon resource lifecycle:
-
-```text
-EMPTY -> REQUESTED/LOADING -> LOADED
-```
-
-Engine adapters own device realization:
-
-```text
-LOADED -> PREPARING -> PREPARED
-```
-
-The package selects and runs registered readers, hydrates or returns the
-promised CPU outcome, and stores lifecycle state, cache entries, and loaded
-payloads. For compiled effects it independently validates complete permutation
-topology and the Carbon v15 container records it read itself, selects a
-permutation, and hydrates a canonical device-free `Tr2Shader` graph. It never
-creates WebGL/WebGPU textures, buffers, shader modules, pipelines, or bind
-groups, and it never inspects backend capability.
-A realization failure destroys its candidate and returns the resource to
-`LOADED` without discarding the valid CPU payload.
-
-This deliberately differs from Carbon and ccpwgl, whose resource classes live
-inside an engine that can prepare GPU objects directly. Keeping the
-format/resource layer reusable means stopping before GPU work; see
-[resource lifecycle concepts](concepts/resource-lifecycle.md) for the
-historical mapping.
-
-## What the package owns
-
-- `CjsResource` state and Carbon-style resource methods.
-- `CjsMotherLode` canonical identity, explicit replacement results, activity
-  and lock metadata, deterministic payload/adapter cleanup, and cache stats.
-- `CjsResMan` extension-selected resource/object handlers, semantic resource
-  overrides, ordered and legacy registered-format selection,
-  concurrency-limited source loading, staged prepare queues, layered
-  source/read/resource deduplication, object loader dispatch, and prefetch.
-- Main-thread and browser-worker resource execution strategies, including
-  transferable fetch results and declared worker-safe CPU readers.
-- `CjsTextureArrayRes` and `CjsTextureArrayResParameterProxy` for material-facing,
-  frame-coalesced texture-array inputs.
-- `CjsAudioBufferRes` for physical audio-byte ownership and `CjsAudioRes` for
-  complete or windowed individually addressable audio files.
-- Raw `CjsEventEmitter` (from `runtime-utils/model`) for manager/runtime events
-  without requiring `CjsModel` inheritance.
-- Resource-path normalization and URL resolution, including prefix bases and
-  an injectable complete resolver, with fetch execution delegated to a
-  URL-only provider.
-- Resource-specific geometry traversal and payload adaptation, composed with
-  shared vector, matrix, bounds, sphere, ray, and mesh math from
-  `runtime-utils` rather than maintaining another math implementation here.
-- Plain reader/converter payload objects with focused shared validators.
-- Canonical Carbon resource classes that validate and hold CPU payloads
-  privately: `TriTextureRes`, `TriGeometryRes`, `Tr2EffectRes`, `Tr2ImageRes`,
-  `TriGrannyRes`, `Tr2GrannyStateRes`, and `Tr2LightProfileRes`.
-- Canonical device-free shader/reflection classes: `Tr2Shader`, its effect,
-  technique, pass, stage, constant, resource, sampler, annotation, and library
-  records; Carbon-binary hydration; permutation selection; and per-index caching.
-- `Tr2TexturePipeline` CPU-only texture steps and `Tr2TextureLodManager`
-  membership.
-- Opaque engine-owned subobject slots for backend adapters.
+# Architecture and boundaries
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource`  
+Audience: Users and integrators  
+Summary: Defines the GPU-free boundary this package owns and how engine and runtime packages relate to it.
+
+## The GPU-free split
+
+`runtime-resource` owns the GPU-free half of the Carbon resource lifecycle:
+
+```text
+EMPTY -> REQUESTED/LOADING -> LOADED
+```
+
+Engine adapters own device realization:
+
+```text
+LOADED -> PREPARING -> PREPARED
+```
+
+The package selects and runs registered readers, hydrates or returns the
+promised CPU outcome, and stores lifecycle state, cache entries, and loaded
+payloads. For compiled effects it independently validates complete permutation
+topology and the Carbon v15 container records it read itself, selects a
+permutation, and hydrates a canonical device-free `Tr2Shader` graph. It never
+creates WebGL/WebGPU textures, buffers, shader modules, pipelines, or bind
+groups, and it never inspects backend capability.
+A realization failure destroys its candidate and returns the resource to
+`LOADED` without discarding the valid CPU payload.
+
+This deliberately differs from Carbon and ccpwgl, whose resource classes live
+inside an engine that can prepare GPU objects directly. Keeping the
+format/resource layer reusable means stopping before GPU work; see
+[resource lifecycle concepts](concepts/resource-lifecycle.md) for the
+historical mapping.
+
+## What the package owns
+
+- `CjsResource` state and Carbon-style resource methods.
+- `CjsMotherLode` canonical identity, explicit replacement results, activity
+  and lock metadata, deterministic payload/adapter cleanup, and cache stats.
+- `CjsResMan` extension-selected resource/object handlers, semantic resource
+  overrides, ordered and legacy registered-format selection,
+  concurrency-limited source loading, staged prepare queues, layered
+  source/read/resource deduplication, object loader dispatch, and prefetch.
+- Main-thread and browser-worker resource execution strategies, including
+  transferable fetch results and declared worker-safe CPU readers.
+- `CjsTextureArrayRes` and `CjsTextureArrayResParameterProxy` for material-facing,
+  frame-coalesced texture-array inputs.
+- `CjsAudioBufferRes` for physical audio-byte ownership and `CjsAudioRes` for
+  complete or windowed individually addressable audio files.
+- Raw `CjsEventEmitter` (from `runtime-utils/model`) for manager/runtime events
+  without requiring `CjsModel` inheritance.
+- Resource-path normalization and URL resolution, including prefix bases and
+  an injectable complete resolver, with fetch execution delegated to a
+  URL-only provider.
+- Resource-specific geometry traversal and payload adaptation, composed with
+  shared vector, matrix, bounds, sphere, ray, and mesh math from
+  `runtime-utils` rather than maintaining another math implementation here.
+- Plain reader/converter payload objects with focused shared validators.
+- Canonical Carbon resource classes that validate and hold CPU payloads
+  privately: `TriTextureRes`, `TriGeometryRes`, `Tr2EffectRes`, `Tr2ImageRes`,
+  `TriGrannyRes`, `Tr2GrannyStateRes`, and `Tr2LightProfileRes`.
+- Canonical device-free shader/reflection classes: `Tr2Shader`, its effect,
+  technique, pass, stage, constant, resource, sampler, annotation, and library
+  records; Carbon-binary hydration; permutation selection; and per-index caching.
+- `Tr2TexturePipeline` CPU-only texture steps and `Tr2TextureLodManager`
+  membership.
+- Opaque engine-owned subobject slots for backend adapters.
 - Format implementations as explicit tree-shakeable subpaths under
   `@carbonenginejs/runtime-resource/formats/<name>`.
-
-## What the package does not own
-
-- WebGL/WebGPU realization, allocations, upload accounting, device budgets,
-  capability limits, and device-loss recovery (engine packages).
-- Shader binary decoding, backend translation, and package serialization live
-  in the explicit `runtime-resource/formats/{hlsl,dxbc,webgl,webgpu}` subpaths.
-  Backend shader objects remain in engine packages.
-- AudioBuffer construction, playback, or audio manager behavior.
-- Audio-library document construction, enrichment, media-ID interpretation,
-  and delivery-route selection.
-
-## Package relationships
-
-- `runtime-core` may configure and expose a `CjsResMan`, but does not own its
-  implementation.
-- `runtime-trinity` and `runtime-sof` may request GPU-free objects and
-  resources without selecting an engine. Trinity owns the mutable
-  `Tr2Effect`/`Tr2Material` facade, parameters, options, and sampler overrides;
-  it consumes the resource-owned shader graph.
-- `engine-webgpu` and future WebGL engines consume loaded resources and own
-  all backend allocations, preparation, replacement, and destruction.
-
-Concrete formats are not imported or registered by the package root; see
-[formats/README.md](formats/README.md) for the import rule and map.
-Worker-safe formats provide their own exact module declaration and remain
-explicit registrations; see [browser worker execution](reference/workers.md).
-
-Extension routes are manager-local configuration. They bind an extension to a
-handler plus one format or an ordered format chain. The handler's
-`ResourceHandlerMode` declaration determines whether path-only `Fetch()`
-returns the stable resource or the constructed object. The route snapshot is
-captured by the canonical handle, so later registration changes affect only a
-new identity after explicit deletion or clearing. Target construction and
-dynamic identification run after any worker decode on the main thread.
-
-## Source layout
-
-Authoring source is decorated JavaScript; published output is built ESM in
-`npm/dist`. Resource owners and their direct Carbon data records live under
-`src/resource`, grouped as `audio`, `geometry`, `geometry/granny`, `shader`,
-and `texture`; worker execution and its message protocol live under `src/worker`;
-`src/generated` is reserved for unresolved active ports and is currently
-absent. Native shapes that JavaScript replaces or does not use are retained
-only under `src/dropped`, with their disposition documented there, and are
-never exported or bundled.
+- Acquisition-free FSD byte validation, schema decoding, and approved dataset
+  readers under `formats/fsd`. The format keeps separate `32` and `64`
+  implementation directories: legacy headerless FSD is identified explicitly
+  but is not yet decoded, while modern cFSD uses the 64-bit implementation.
+
+## What the package does not own
+
+- WebGL/WebGPU realization, allocations, upload accounting, device budgets,
+  capability limits, and device-loss recovery (engine packages).
+- Shader binary decoding, backend translation, and package serialization live
+  in the explicit `runtime-resource/formats/{hlsl,dxbc,webgl,webgpu}` subpaths.
+  Backend shader objects remain in engine packages.
+- AudioBuffer construction, playback, or audio manager behavior.
+- Audio-library document construction, enrichment, media-ID interpretation,
+  and delivery-route selection.
+
+## Package relationships
+
+- `runtime-core` may configure and expose a `CjsResMan`, but does not own its
+  implementation.
+- `runtime-trinity` and `runtime-sof` may request GPU-free objects and
+  resources without selecting an engine. Trinity owns the mutable
+  `Tr2Effect`/`Tr2Material` facade, parameters, options, and sampler overrides;
+  it consumes the resource-owned shader graph.
+- `engine-webgpu` and future WebGL engines consume loaded resources and own
+  all backend allocations, preparation, replacement, and destruction.
+
+Concrete formats are not imported or registered by the package root; see
+[formats/README.md](formats/README.md) for the import rule and map.
+Worker-safe formats provide their own exact module declaration and remain
+explicit registrations; see [browser worker execution](reference/workers.md).
+
+Extension routes are manager-local configuration. They bind an extension to a
+handler plus one format or an ordered format chain. The handler's
+`ResourceHandlerMode` declaration determines whether path-only `Fetch()`
+returns the stable resource or the constructed object. The route snapshot is
+captured by the canonical handle, so later registration changes affect only a
+new identity after explicit deletion or clearing. Target construction and
+dynamic identification run after any worker decode on the main thread.
+
+## Source layout
+
+Authoring source is decorated JavaScript; published output is built ESM in
+`npm/dist`. Resource owners and their direct Carbon data records live under
+`src/resource`, grouped as `audio`, `geometry`, `geometry/granny`, `shader`,
+and `texture`; worker execution and its message protocol live under `src/worker`.
+Reviewed, unresolved active ports live under `src/generated` and are exposed
+only through the explicit `./generated` package subpath until promotion. Native
+shapes that JavaScript replaces or does not use are retained only under
+`src/dropped`, with their disposition documented there, and are never exported
+or bundled.

package/docs/concepts/format-capabilities.md

@@ -0,0 +1,90 @@
+# Format identification and capabilities
+
+Status: Stable
+Scope: `CjsFormat`, `CjsResourceProbe`, and every concrete format facade
+Audience: Format authors, runtime integrators, and diagnostics tooling
+Summary: Separates synchronous routing facts from advisory output support and exact asynchronous proof.
+
+## One format contract
+
+Every concrete format extends the decorator-free `CjsFormat` base and declares:
+
+- `id`: stable format identity;
+- `mediaTypes`: canonical runtime-utils media categories;
+- `extensions`: lowercase dotted file suffixes used for routing;
+- `outputs`: a frozen map of exact output selectors and their capabilities;
+- `requestResponseType`: source acquisition response type; and
+- `worker`: `null` or a frozen browser-worker execution descriptor.
+
+An output descriptor records `output`, `payloadType`, `role`, `readMode`,
+`decoded`, `passthrough`, `default`, `probes`, and `requires`. It declares a
+reader path; it never claims that path has run for a particular input.
+
+The former parallel statics and result flags are retired. In particular,
+formats do not declare `type`, `inputTypes`, `outputTypes`,
+`debugOutputTypes`, or `implementationStatus`, and payloads do not use
+`containerOnly`, `isDecoded`, or codec-specific decode booleans. Consumers ask
+the format for the relevant output capability instead.
+
+## The four questions
+
+`Format.is(input, options)` is a synchronous routing predicate. It returns only
+a boolean and answers whether this format recognizes the input. It does not
+claim that a requested decoder output works.
+
+`Format.inspect(input, options)` is synchronous and returns structural
+metadata. It describes what the bytes contain without making runtime support
+or verification claims.
+
+`Format.getSupport(input, options)` is synchronous advice. It combines the
+format's structural probe with its declared output map and returns a plain,
+frozen report. `options.emit` selects one exact output; omitting it selects the
+declared default. Every returned capability has `verified: false` because no
+decode has been executed.
+
+`await Format.verifySupport(input, options)` is exact proof. It calls the real
+`readAsync(input, { ...options, emit })` path for the selected output. Success
+returns `supported: true` and `verified: true`. Failure returns
+`supported: false`, `verified: true`, and a structured error with name, code,
+message, details, and cause.
+
+Normal resource loading does not call `verifySupport()` and then decode again.
+A successful ordinary `readAsync()` is already proof for that load;
+`verifySupport()` exists for diagnostics, setup checks, and consumers that need
+to establish capability before committing to a route.
+
+For example, runtime-core can prove that the actual DDS RGBA path works for a
+specific payload and environment:
+
+```js
+const report = await CjsDdsFormat.verifySupport(bytes, { emit: "rgba" });
+
+if (!report.supported)
+{
+  throw new Error(report.error.message);
+}
+```
+
+That result says nothing about DDS `texture`, `image`, or `raw`; support is
+always output-specific.
+
+## Decorator boundary
+
+Format subpaths must remain importable from authored source, so they return
+plain report objects and never import decorated model code. A resource-layer
+consumer that needs persistence or model metadata calls
+`CjsResourceProbe.from(report)`. The model exposes `canUseSelected()` and
+`canUse(output)` without changing the format-layer contract.
+
+## Routing rule
+
+`CjsFormatStore` and `CjsResMan` use `Format.is()` only when content must break
+an extension tie. Support reports do not select routes: a truthy report object
+must never become an accidental match, and a decoder limitation must not make
+the system forget which format the bytes are.
+
+## Related documentation
+
+- [Format subpaths](../formats/README.md)
+- [Resource lifecycle](resource-lifecycle.md)
+- [Browser worker execution](../reference/workers.md)

package/docs/formats/README.md

@@ -15,11 +15,17 @@ touches one stops being loadable from source. Every consumer reading `src/`
 directly then fails with a bare syntax error pointing at the decorator rather
 than at the import that reached it, which is a long way from the mistake.
 
-The practical consequence is that a format reports a **plain probe-shaped
-object** from `isSupported()` and `resolveType()` rather than constructing a
-`CjsResourceProbe`, which is decorated. `CjsResourceProbe.from()` normalizes
-those payloads wherever a real probe instance is wanted. See
-[format type resolution](../concepts/format-type-resolution.md).
+The practical consequence is that `inspect()`, `getSupport()`, and
+`verifySupport()` return plain objects rather than constructing a decorated
+`CjsResourceProbe`. `CjsResourceProbe.from()` is the optional resource-layer
+normalization boundary. `is()` remains the boolean-only synchronous routing
+predicate. See [format capabilities](../concepts/format-capabilities.md).
+
+Every format extends `CjsFormat` and exposes one normalized static contract:
+`id`, frozen `mediaTypes`, frozen dotted `extensions`, a frozen `outputs` map,
+`requestResponseType`, and `worker`. `getSupport()` is synchronous structural
+advice and always reports `verified: false`; `verifySupport()` asynchronously
+executes the real `readAsync()` path for one exact output.
 
 ## Import rule
 
@@ -60,9 +66,10 @@ metadata. Worker eligibility never changes the format's direct API; see
 | DXBC (shader bytecode) | `CjsDxbcFormat` | `@carbonenginejs/runtime-resource/formats/dxbc` |
 | Compiled effect (`.sm_hi`, `.sm_lo`, `.sm_depth`) | `CjsHlslFormat` | `@carbonenginejs/runtime-resource/formats/hlsl` |
 | Carbon WebGL WebGL effect package | `CjsWebglFormat` | `@carbonenginejs/runtime-resource/formats/webgl` |
-| Carbon WebGPU WebGPU effect package | `CjsWebgpuFormat` | `@carbonenginejs/runtime-resource/formats/webgpu` |
+| Carbon WebGPU effect package (`.carbonwebgpu`) | `CjsWebgpuFormat` | `@carbonenginejs/runtime-resource/formats/webgpu` |
 | FBX (`.fbx`) | `CjsFbxFormat` | `@carbonenginejs/runtime-resource/formats/fbx` |
 | FLAC (`.flac`) | `CjsFlacFormat` | `@carbonenginejs/runtime-resource/formats/flac` |
+| FSD (`.fsdbinary`; legacy 32-bit and modern 64-bit cFSD) | `CjsFsdFormat` | `@carbonenginejs/runtime-resource/formats/fsd` |
 | GIF (`.gif`) | `CjsGifFormat` | `@carbonenginejs/runtime-resource/formats/gif` |
 | glTF (`.gltf`/`.glb`) | `CjsGltfFormat` | `@carbonenginejs/runtime-resource/formats/gltf` |
 | Granny GR2/GSF (`.gr2`/`.gsf`) | `CjsGr2Format` | `@carbonenginejs/runtime-resource/formats/gr2` |
@@ -86,6 +93,7 @@ metadata. Worker eligibility never changes the format's direct API; see
 | YAML (`.yaml`/`.yml`) | `CjsYamlFormat` | `@carbonenginejs/runtime-resource/formats/yaml` |
 
 Detailed pages: [Granny GR2 and GSF](gr2.md),
+[FSD and cFSD](fsd.md),
 [data-only pickle protocol 0](pickle.md),
 [client `.static` container identification](static.md),
 [schema-bound containers](schemabound.md),

package/docs/formats/fsd.md

@@ -0,0 +1,104 @@
+# FSD and cFSD
+
+Status: Experimental
+Scope: `@carbonenginejs/runtime-resource/formats/fsd`
+Audience: Runtime and tooling integrators decoding caller-supplied static data
+Summary: Distinguishes legacy 32-bit FSD from modern 64-bit cFSD and owns the browser-safe decoder for the modern format.
+
+## Two related formats
+
+The FSD facade deliberately keeps two implementation directories:
+
+| Variant | Directory | Identification | Reading |
+|---|---|---|---|
+| Legacy Carbon FSD | `formats/fsd/32` | Caller/profile declaration (`bitWidth: 32` or `variant: "fsd32"`) | Reserved; throws `CJS_FSD_32_UNSUPPORTED` |
+| Modern cFSD | `formats/fsd/64` | Valid 32-byte envelope whose 64-bit payload length matches the supplied bytes | Supported through an explicit dataset reader |
+
+Legacy FSD is headerless and its layout is supplied separately, so arbitrary
+bytes cannot identify themselves as that format. `CjsFsdFormat` never treats a
+failed modern probe as legacy. The `32` directory is the stable home for a
+future schema-driven implementation without flattening two layouts into one
+reader or changing public subpaths.
+
+## Use through the format pipeline
+
+```js
+import { CjsFormatStore } from "@carbonenginejs/runtime-resource/format";
+import { CjsFsdFormat } from "@carbonenginejs/runtime-resource/formats/fsd";
+import { CjsFsd64Reader } from "@carbonenginejs/runtime-resource/formats/fsd/64";
+import {
+  CjsFsd64ReaderSetCharacterStaticData
+} from "@carbonenginejs/runtime-resource/formats/fsd/64/readers";
+
+const reader = CjsFsd64ReaderSetCharacterStaticData.registerAll(new CjsFsd64Reader());
+const route = new CjsFormatStore()
+  .Register(CjsFsdFormat)
+  .Resolve(".fsdbinary", bytes);
+
+const records = await route.Read(bytes, {
+  path: "res:/staticdata/ancestries.fsdbinary",
+  reader
+});
+```
+
+`readJSON()` or `emit: "json"` requests plain JSON-compatible output. Wide
+identifiers remain lossless decimal strings. The ordinary `Read()` path keeps
+the typed `Map` representation exposed by the lower-level readers.
+
+## Dataset layouts
+
+Each reviewed layout is a JSON-shaped JavaScript object defined directly on
+its owning, namespaced class. The class and file share one identity, such as
+`CjsFsd64SchemaRaces` in `CjsFsd64SchemaRaces.js`. No separate schema sidecar
+has to remain paired with the reader.
+
+```js
+import {
+  CjsFsd64SchemaRaces
+} from "@carbonenginejs/runtime-resource/formats/fsd/64/readers";
+
+const definition = CjsFsd64SchemaRaces.getFsdSchema();
+```
+
+`getFsdSchema()` returns the same validated JSON-shaped object on every call.
+There is no public backing `fsdSchema` property. The FSD-specific name is
+deliberate: `schema` and `getSchema` remain free for the `CjsModel` schema
+namespace and are not defined by these reader classes.
+
+To report identified legacy bytes without decoding them:
+
+```js
+const metadata = CjsFsdFormat.inspect(bytes, { bitWidth: 32 });
+// metadata.variant === "fsd32"; metadata.decodable === false
+
+CjsFsdFormat.read(bytes, { bitWidth: 32 });
+// throws CJS_FSD_32_UNSUPPORTED
+```
+
+## Ownership boundary
+
+This format owns byte validation, declarative layouts, schema decoding, exact-path
+reader registration, and approved dataset readers. It performs no filesystem
+discovery, network access, provider selection, build selection, caching, native
+loader inspection, localization enrichment, or output-tree construction.
+
+Acquisition and target/build profiles belong to tooling. Runtime packages own
+interpretation and construction of prepared domain libraries. The reader
+subpath contains no acquired `.fsdbinary` files, native modules, decoded
+datasets, or generated game tables.
+
+## Errors
+
+| Code | When |
+|---|---|
+| `CJS_FSD_32_UNSUPPORTED` | The caller identified legacy 32-bit FSD, whose future reader belongs in `formats/fsd/32` |
+| `CJS_FSD_VARIANT_UNKNOWN` | Bytes are neither explicitly declared legacy FSD nor a valid modern cFSD container |
+| `CJS_FSD_READER_REQUIRED` | Modern cFSD was recognized but no reader/registry exposing `Read` or `ReadJSON` was supplied |
+| `CJS_FSD_READER_NOT_FOUND` | A registry has no reader for the normalized logical path |
+| `CJS_FSD_SCHEMA_UNSUPPORTED` | A dataset reader does not accept the container's layout identity |
+
+## Related documentation
+
+- [Formats](README.md)
+- [Format ownership and fork provenance](provenance.md)
+- [Format capabilities](../concepts/format-capabilities.md)

package/docs/formats/gr2.md

@@ -33,7 +33,7 @@ const asynchronousGraph = await CjsGr2Format.readAsync(bytes);
 ```
 
 `CjsGr2Format` is the one public class: the reader engine plus the normal
-runtime-resource format metadata and the `isSupported(bytes)` magic probe.
+runtime-resource format metadata and the boolean `is(bytes)` magic probe.
 The barrel exports nothing else.
 
 Register it with `CjsResMan` when GR2/GSF should participate in ordinary