@carbonenginejs/runtime-resource 0.9.1 → 0.10.0

package/dist/worker/CjsResManWorkerLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsResManWorkerLoader.js","sources":["../../../src/worker/CjsResManWorkerLoader.js"],"sourcesContent":["import { Message, Operation } from \"./protocol.js\";\nimport { CjsResManMainThreadLoader } from \"./CjsResManMainThreadLoader.js\";\n\nconst DEFAULT_WORKER_OPTIONS = Object.freeze({\n  type: \"module\",\n  name: \"CjsResManWorker\"\n});\n\n/**\n * Browser module-worker strategy that correlates source/format requests, transfers owned buffers, propagates cancellation and fatal failure, and delegates unsupported operations to a main-thread loader.\n *\n * One module worker can overlap fetch requests and serializes synchronous\n * reader work on its own event loop. Sources opt in through\n * `CreateWorkerRequest(path, options)`. Formats opt in through a static\n * `worker` declaration containing their module URL and export name.\n */\nexport class CjsResManWorkerLoader\n{\n  #boundError;\n  #boundMessage;\n  #nextId = 1;\n  #pending = new Map();\n\n  /**\n   * @param {object} [options={}] Worker construction and fallback options.\n   * @param {CjsResManMainThreadLoader|object} [options.fallback] Unsupported-operation fallback.\n   * @param {Worker|object} [options.worker] Existing Worker-compatible instance.\n   * @param {(url: string|URL, options: object) => Worker|object} [options.workerFactory] Worker factory.\n   * @param {string|URL} [options.workerUrl] Module worker entry URL.\n   * @param {object} [options.workerOptions] Options passed to the Worker constructor.\n   * @param {boolean} [options.enabled=true] Whether worker execution may be used.\n   */\n  constructor(options = {}) {\n    if (!options || typeof options !== \"object\" || Array.isArray(options)) {\n      throw new TypeError(\"CjsResManWorkerLoader options must be an object.\");\n    }\n\n    this.fallback = options.fallback || new CjsResManMainThreadLoader();\n    assertResourceLoader(this.fallback, \"fallback\");\n    this.workerFactory = options.workerFactory || defaultWorkerFactory;\n    if (typeof this.workerFactory !== \"function\") {\n      throw new TypeError(\"CjsResManWorkerLoader workerFactory must be a function.\");\n    }\n    this.workerUrl = options.workerUrl\n      || new URL(\"./CjsResManWorker.js\", import.meta.url);\n    this.workerOptions = Object.freeze({\n      ...DEFAULT_WORKER_OPTIONS,\n      ...(options.workerOptions || {})\n    });\n    this.enabled = options.enabled !== false;\n    this.failed = false;\n    this.worker = options.worker || null;\n    this.#boundMessage = event => this.#OnMessage(event);\n    this.#boundError = event => this.#OnError(event);\n    if (this.worker) this.#Attach(this.worker);\n  }\n\n  /**\n   * Enable and lazily create the configured worker.\n   *\n   * @param {string|URL} [workerUrl] Optional replacement worker URL.\n   * @returns {boolean} Whether a worker is ready.\n   */\n  Enable(workerUrl = this.workerUrl) {\n    this.enabled = true;\n    if (workerUrl !== undefined && workerUrl !== null) this.workerUrl = workerUrl;\n    if (this.worker) return true;\n    if (this.failed) return false;\n\n    try {\n      const worker = this.workerFactory(this.workerUrl, this.workerOptions);\n      if (!worker || typeof worker.postMessage !== \"function\") {\n        throw new TypeError(\"Worker factory did not return a Worker-compatible object.\");\n      }\n      this.worker = worker;\n      this.#Attach(worker);\n      return true;\n    } catch {\n      this.worker = null;\n      this.failed = true;\n      return false;\n    }\n  }\n\n  /**\n   * Stop worker use and reject every pending request.\n   *\n   * @param {*} [reason] Optional failure reason.\n   * @returns {CjsResManWorkerLoader} This loader.\n   */\n  Disable(reason = null) {\n    const worker = this.worker;\n    if (worker) {\n      this.#Detach(worker);\n      worker.terminate?.();\n    }\n    this.worker = null;\n    this.enabled = false;\n    this.failed = reason !== null && reason !== undefined;\n\n    if (this.#pending.size) {\n      const error = normalizeWorkerError(\n        reason || createWorkerUnavailableError(\"Resource worker was disabled.\")\n      );\n      for (const request of this.#pending.values()) {\n        cleanupPendingRequest(request);\n        request.reject(error);\n      }\n      this.#pending.clear();\n    }\n    return this;\n  }\n\n  /**\n   * Clear a previous creation/fatal failure so a later enable can retry.\n   *\n   * @returns {CjsResManWorkerLoader} This loader.\n   */\n  Reset() {\n    this.failed = false;\n    this.enabled = true;\n    return this;\n  }\n\n  /**\n   * Replace the unsupported-operation fallback.\n   *\n   * @param {CjsResManMainThreadLoader|object} fallback Loader exposing Read and ReadFormat.\n   * @returns {CjsResManWorkerLoader} This loader.\n   */\n  SetFallback(fallback) {\n    assertResourceLoader(fallback, \"fallback\");\n    this.fallback = fallback;\n    return this;\n  }\n\n  /**\n   * Report whether worker execution is configured and constructible.\n   *\n   * @returns {boolean}\n   */\n  IsAvailable() {\n    return this.enabled && (Boolean(this.worker) || this.Enable());\n  }\n\n  /**\n   * Read a source through its declared worker request, falling back when the\n   * source is not worker-aware or a worker cannot be created.\n   *\n   * @param {object|Function} source Source implementation.\n   * @param {string} path Normalized resource path.\n   * @param {object} [options={}] Source options.\n   * @returns {Promise<*>|*} Source result.\n   */\n  Read(source, path, options = {}) {\n    assertResourceSource(source);\n    if (typeof source.CreateWorkerRequest !== \"function\") {\n      return this.fallback.Read(source, path, options);\n    }\n\n    const request = normalizeWorkerRequest(source.CreateWorkerRequest(path, options));\n    if (!request || !this.IsAvailable()) {\n      return this.fallback.Read(source, path, options);\n    }\n    return this.Execute(request.operation, request.payload, {\n      signal: request.signal || options.signal,\n      transfer: request.transfer\n    });\n  }\n\n  /**\n   * Test whether a registered format can be safely dispatched to this worker.\n   *\n   * @param {object} descriptor Registered format descriptor.\n   * @param {object} [formatOptions={}] Normalized format options.\n   * @returns {boolean}\n   */\n  CanReadFormat(descriptor, formatOptions = {}) {\n    const declaration = normalizeFormatWorkerDeclaration(descriptor);\n    return Boolean(\n      declaration\n      && isWorkerFormatOutputSupported(declaration, formatOptions)\n      && canCloneWorkerValue(formatOptions)\n      && this.IsAvailable()\n    );\n  }\n\n  /**\n   * Execute a worker-safe format reader or use the main-thread fallback.\n   *\n   * Inputs are cloned by default so shared source-cache ownership is not\n   * detached. A format may explicitly declare `transferInput: true` when its\n   * caller guarantees exclusive ownership.\n   *\n   * @param {object} descriptor Registered format descriptor.\n   * @param {*} input Reader input.\n   * @param {object} [formatOptions={}] Normalized format options.\n   * @returns {Promise<*>} Format result.\n   */\n  ReadFormat(descriptor, input, formatOptions = {}) {\n    const declaration = normalizeFormatWorkerDeclaration(descriptor);\n    if (!declaration\n      || !isWorkerFormatOutputSupported(declaration, formatOptions)\n      || !canCloneWorkerValue(formatOptions)\n      || !this.IsAvailable()) {\n      return this.fallback.ReadFormat(descriptor, input, formatOptions);\n    }\n\n    const transfer = declaration.transferInput\n      ? getExclusiveInputTransferables(input)\n      : [];\n    return this.Execute(Operation.FORMAT_READ, {\n      module: declaration.module,\n      exportName: declaration.exportName,\n      input,\n      options: formatOptions\n    }, { transfer });\n  }\n\n  /**\n   * Dispatch one operation using the stable worker message protocol.\n   *\n   * @param {string} operation Operation name.\n   * @param {*} payload Structured-cloneable operation payload.\n   * @param {object} [options={}] Transfer and cancellation options.\n   * @returns {Promise<*>} Worker result.\n   */\n  Execute(operation, payload, options = {}) {\n    if (typeof operation !== \"string\" || operation.trim() === \"\") {\n      return Promise.reject(new TypeError(\"Worker operation must be a non-empty string.\"));\n    }\n    if (!this.IsAvailable()) {\n      return Promise.reject(createWorkerUnavailableError());\n    }\n    const signal = options.signal || null;\n    if (signal?.aborted) return Promise.reject(createAbortError(signal.reason));\n\n    const id = this.#nextId++;\n    let resolve;\n    let reject;\n    const promise = new Promise((onResolve, onReject) => {\n      resolve = onResolve;\n      reject = onReject;\n    });\n    const request = {\n      id,\n      resolve,\n      reject,\n      signal,\n      onAbort: null\n    };\n    if (signal && typeof signal.addEventListener === \"function\") {\n      request.onAbort = () => {\n        if (!this.#pending.delete(id)) return;\n        cleanupPendingRequest(request);\n        try {\n          this.worker?.postMessage({\n            type: Message.CANCEL,\n            id\n          });\n        } catch {\n          // The local abort remains authoritative if the worker is already gone.\n        }\n        reject(createAbortError(signal.reason));\n      };\n      signal.addEventListener(\"abort\", request.onAbort, { once: true });\n    }\n    this.#pending.set(id, request);\n\n    try {\n      this.worker.postMessage({\n        type: Message.EXECUTE,\n        id,\n        operation,\n        payload\n      }, normalizeTransferList(options.transfer));\n    } catch (error) {\n      this.#pending.delete(id);\n      cleanupPendingRequest(request);\n      reject(error);\n    }\n    return promise;\n  }\n\n  /**\n   * Return the number of unresolved worker requests.\n   *\n   * @returns {number}\n   */\n  GetPendingCount() {\n    return this.#pending.size;\n  }\n\n  /** Attach this loader's result and failure listeners to a worker. */\n  #Attach(worker) {\n    if (typeof worker.addEventListener === \"function\") {\n      worker.addEventListener(\"message\", this.#boundMessage);\n      worker.addEventListener(\"error\", this.#boundError);\n      worker.addEventListener(\"messageerror\", this.#boundError);\n    } else {\n      worker.onmessage = this.#boundMessage;\n      worker.onerror = this.#boundError;\n      worker.onmessageerror = this.#boundError;\n    }\n  }\n\n  /** Detach this loader's result and failure listeners from a worker. */\n  #Detach(worker) {\n    if (typeof worker.removeEventListener === \"function\") {\n      worker.removeEventListener(\"message\", this.#boundMessage);\n      worker.removeEventListener(\"error\", this.#boundError);\n      worker.removeEventListener(\"messageerror\", this.#boundError);\n    } else {\n      if (worker.onmessage === this.#boundMessage) worker.onmessage = null;\n      if (worker.onerror === this.#boundError) worker.onerror = null;\n      if (worker.onmessageerror === this.#boundError) worker.onmessageerror = null;\n    }\n  }\n\n  /** Settle the pending request identified by one worker result message. */\n  #OnMessage(event) {\n    const data = event?.data;\n    if (!data || data.type !== Message.RESULT) return;\n    const request = this.#pending.get(data.id);\n    if (!request) return;\n    this.#pending.delete(data.id);\n    cleanupPendingRequest(request);\n    if (data.ok) request.resolve(data.result);\n    else request.reject(normalizeWorkerError(data.error));\n  }\n\n  /** Disable worker execution after a fatal worker or message failure. */\n  #OnError(event) {\n    const reason = event?.error || event || new Error(\"Resource worker failed.\");\n    this.Disable(reason);\n  }\n}\n\nfunction assertResourceSource(source) {\n  if (!source || (typeof source !== \"object\" && typeof source !== \"function\")\n    || typeof source.Read !== \"function\") {\n    throw new TypeError(\"Resource source must provide Read(path, options).\");\n  }\n}\n\nfunction assertResourceLoader(loader, name = \"loader\") {\n  if (!loader || typeof loader.Read !== \"function\" || typeof loader.ReadFormat !== \"function\") {\n    throw new TypeError(`CjsResManWorkerLoader ${name} must provide Read and ReadFormat.`);\n  }\n}\n\nfunction defaultWorkerFactory(url, options) {\n  if (typeof Worker === \"undefined\") {\n    throw new ReferenceError(\"Browser Worker is not available.\");\n  }\n  return new Worker(url, options);\n}\n\nfunction normalizeWorkerRequest(request) {\n  if (request === null || request === undefined || request === false) return null;\n  if (!request || typeof request !== \"object\" || Array.isArray(request)) {\n    throw new TypeError(\"CreateWorkerRequest must return an object or null.\");\n  }\n  if (typeof request.operation !== \"string\" || request.operation.trim() === \"\") {\n    throw new TypeError(\"Worker source request requires a non-empty operation.\");\n  }\n  return {\n    operation: request.operation,\n    payload: request.payload,\n    signal: request.signal || null,\n    transfer: normalizeTransferList(request.transfer)\n  };\n}\n\nfunction normalizeFormatWorkerDeclaration(descriptor) {\n  const Format = descriptor?.Format;\n  const declaration = descriptor?.worker || Format?.worker;\n  if (!declaration) return null;\n\n  const value = typeof declaration === \"string\"\n    ? { module: declaration }\n    : declaration;\n  if (!value || typeof value !== \"object\" || !value.module) return null;\n  return Object.freeze({\n    module: String(value.module),\n    exportName: String(value.exportName || Format?.name || \"default\"),\n    outputTypes: Array.isArray(value.outputTypes)\n      ? Object.freeze(value.outputTypes.map(String))\n      : null,\n    defaultOutput: value.defaultOutput === undefined\n      ? undefined\n      : String(value.defaultOutput),\n    transferInput: value.transferInput === true\n  });\n}\n\nfunction isWorkerFormatOutputSupported(declaration, formatOptions) {\n  if (!declaration.outputTypes) return true;\n  const output = formatOptions.emit ?? declaration.defaultOutput;\n  return output !== undefined && declaration.outputTypes.includes(String(output));\n}\n\nfunction normalizeTransferList(value) {\n  if (value === null || value === undefined) return [];\n  if (!Array.isArray(value)) {\n    throw new TypeError(\"Worker transfer list must be an array.\");\n  }\n  return value;\n}\n\nfunction getExclusiveInputTransferables(input) {\n  if (input instanceof ArrayBuffer) return [ input ];\n  if (ArrayBuffer.isView(input)\n    && input.byteOffset === 0\n    && input.byteLength === input.buffer.byteLength) {\n    return [ input.buffer ];\n  }\n  return [];\n}\n\nfunction canCloneWorkerValue(value, seen = new Set()) {\n  if (value === null || value === undefined) return true;\n  const type = typeof value;\n  if (type === \"string\" || type === \"number\" || type === \"boolean\" || type === \"bigint\") {\n    return true;\n  }\n  if (type !== \"object\") return false;\n  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value) || value instanceof Date) {\n    return true;\n  }\n  if (seen.has(value)) return false;\n  seen.add(value);\n  if (Array.isArray(value)) {\n    return value.every(entry => canCloneWorkerValue(entry, seen));\n  }\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) return false;\n  return Object.values(value).every(entry => canCloneWorkerValue(entry, seen));\n}\n\nfunction cleanupPendingRequest(request) {\n  if (request.signal && request.onAbort\n    && typeof request.signal.removeEventListener === \"function\") {\n    request.signal.removeEventListener(\"abort\", request.onAbort);\n  }\n}\n\nfunction createWorkerUnavailableError(message = \"Resource worker is unavailable.\") {\n  const error = new Error(message);\n  error.name = \"CjsResManWorkerUnavailableError\";\n  error.code = \"CJS_RESOURCE_WORKER_UNAVAILABLE\";\n  return error;\n}\n\nfunction createAbortError(reason) {\n  if (reason instanceof Error) return reason;\n  const error = new Error(reason === undefined ? \"Resource worker request was aborted.\" : String(reason));\n  error.name = \"AbortError\";\n  error.code = \"ABORT_ERR\";\n  return error;\n}\n\nfunction normalizeWorkerError(value) {\n  if (value instanceof Error) return value;\n  const error = new Error(value?.message || \"Resource worker operation failed.\");\n  error.name = value?.name || \"CjsResManWorkerError\";\n  for (const key of [ \"code\", \"operation\", \"path\", \"status\", \"statusText\" ]) {\n    if (value?.[key] !== undefined) error[key] = value[key];\n  }\n  return error;\n}\n"],"names":["DEFAULT_WORKER_OPTIONS","Object","freeze","type","name","CjsResManWorkerLoader","Map","constructor","options","Array","isArray","TypeError","fallback","CjsResManMainThreadLoader","assertResourceLoader","workerFactory","defaultWorkerFactory","workerUrl","URL","import","meta","url","workerOptions","enabled","failed","worker","event","Enable","undefined","postMessage","Disable","reason","terminate","size","error","normalizeWorkerError","createWorkerUnavailableError","request","values","cleanupPendingRequest","reject","clear","Reset","SetFallback","IsAvailable","Boolean","Read","source","path","assertResourceSource","CreateWorkerRequest","normalizeWorkerRequest","Execute","operation","payload","signal","transfer","CanReadFormat","descriptor","formatOptions","declaration","normalizeFormatWorkerDeclaration","isWorkerFormatOutputSupported","canCloneWorkerValue","ReadFormat","input","transferInput","getExclusiveInputTransferables","Operation","FORMAT_READ","module","exportName","trim","Promise","aborted","createAbortError","id","resolve","promise","onResolve","onReject","onAbort","addEventListener","delete","Message","CANCEL","once","set","EXECUTE","normalizeTransferList","GetPendingCount","#Attach","onmessage","onerror","onmessageerror","#Detach","removeEventListener","#OnMessage","data","RESULT","get","ok","result","#OnError","Error","loader","Worker","ReferenceError","Format","value","String","outputTypes","map","defaultOutput","output","emit","includes","ArrayBuffer","isView","byteOffset","byteLength","buffer","seen","Set","Date","has","add","every","entry","prototype","getPrototypeOf","message","code","key"],"mappings":"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"}

package/dist/worker/protocol.js

@@ -0,0 +1,12 @@
+const Operation = Object.freeze({
+  FETCH: "source.fetch",
+  FORMAT_READ: "format.read"
+});
+const Message = Object.freeze({
+  CANCEL: "cancel",
+  EXECUTE: "execute",
+  RESULT: "result"
+});
+
+export { Message, Operation };
+//# sourceMappingURL=protocol.js.map

package/dist/worker/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sources":["../../../src/worker/protocol.js"],"sourcesContent":["export const Operation = Object.freeze({\n  FETCH: \"source.fetch\",\n  FORMAT_READ: \"format.read\"\n});\n\nexport const Message = Object.freeze({\n  CANCEL: \"cancel\",\n  EXECUTE: \"execute\",\n  RESULT: \"result\"\n});\n"],"names":["Operation","Object","freeze","FETCH","FORMAT_READ","Message","CANCEL","EXECUTE","RESULT"],"mappings":"MAAaA,SAAS,GAAGC,MAAM,CAACC,MAAM,CAAC;AACrCC,EAAAA,KAAK,EAAE,cAAc;AACrBC,EAAAA,WAAW,EAAE;AACf,CAAC;MAEYC,OAAO,GAAGJ,MAAM,CAACC,MAAM,CAAC;AACnCI,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,OAAO,EAAE,SAAS;AAClBC,EAAAA,MAAM,EAAE;AACV,CAAC;;;;"}

package/docs/README.md

@@ -9,9 +9,11 @@ Summary: Documentation home for the GPU-free resource lifecycle, cache, format,
 
 `@carbonenginejs/runtime-resource` owns the GPU-free resource layer of
 CarbonEngineJS: resource identity and state, the MotherLode cache, semantic
-resource classes, registered format readers, source adapters, and the queued
+resource classes, registered format readers, fetch providers, and the queued
 CPU load/publication pipeline. It stops at a published CPU payload; engine
-packages realize that payload into backend objects.
+packages realize that payload into backend objects. It also owns the canonical
+device-free `Tr2EffectRes`/`Tr2Shader` reflection graph and portable-reflection
+hydration boundary.
 
 ## Use this package when
 
@@ -19,19 +21,24 @@ packages realize that payload into backend objects.
   selection, `Ready()`/`GetObject()`) without choosing a GPU backend;
 - you need one of the non-shader format readers as a tree-shakeable subpath
   (`@carbonenginejs/runtime-resource/formats/<name>`);
+- you need canonical effect permutation selection or immutable shader
+  reflection records from `@carbonenginejs/runtime-resource/resource/shader`;
+- you need canonical raw audio resources for complete files or byte windows
+  over shared physical sources;
 - you are writing an engine adapter that consumes published CPU payloads and
   needs the documented retention, reload, and texture-array contracts.
 
 ## Where it fits
 
-- Foundations consumed: `@carbonenginejs/core-types` (event emitter, model
-  contracts) and `@carbonenginejs/core-math` where formats need math values.
+- Foundations consumed: `@carbonenginejs/runtime-utils` (event emitter, model
+  contracts) and `@carbonenginejs/runtime-utils` where formats need math values.
 - Normal consumers: `runtime-core` (configures and exposes a `CjsResMan`),
   `runtime-trinity` and `runtime-sof` (request GPU-free objects), and engine
   packages (`engine-webgpu`, future WebGL engines) that realize prepared
   resources.
 - Owned responsibility: resource identity, cache, CPU payload lifecycle,
-  format selection and conversion, and load/publication queues.
+  format selection and conversion, load/publication queues, and canonical
+  device-free effect/shader reflection hydration and selection.
 - Owned elsewhere: WebGL/WebGPU realization, device budgets, and device-loss
   recovery belong to engine packages; shader formats belong to the dedicated
   shader format packages.
@@ -54,6 +61,12 @@ packages realize that payload into backend objects.
   reload contract.
 - [reference/queues.md](reference/queues.md): queued CPU load, publication,
   registration, and the `Wait()` fence.
+- [reference/workers.md](reference/workers.md): browser-worker source and
+  declared worker-safe format execution.
+- [reference/classes/audio.md](reference/classes/audio.md): complete/shared
+  audio byte owners and individually addressable audio resource views.
+- [reference/classes/resources.md](reference/classes/resources.md): canonical
+  resource records, effect selection, and shader-reflection classes.
 - [reference/texture-arrays.md](reference/texture-arrays.md): texture-array
   proxies, update generations, and adapter commits.
 - [reference/texture-pipeline.md](reference/texture-pipeline.md):

package/docs/architecture.md

@@ -19,10 +19,13 @@ Engine adapters own device realization:
 LOADED -> PREPARING -> PREPARED
 ```
 
-The package selects and runs registered non-shader readers, hydrates or
-returns the promised CPU outcome, and stores lifecycle state, cache entries,
-and loaded payloads. It never creates WebGL/WebGPU textures, buffers, shader
-modules, pipelines, or bind groups, and it never inspects backend capability.
+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 format package's plain portable reflection, 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.
 
@@ -40,47 +43,67 @@ historical mapping.
 - `CjsResMan` semantic resource construction, registered-format selection,
   concurrency-limited source loading, staged prepare queues, layered
   source/read/resource deduplication, object loader dispatch, and prefetch.
-- `CjsTextureArrayRes` and `CjsTextureParameterProxy` for material-facing,
+- 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.
-- Raw `CjsEventEmitter` (from `core-types/model`) for manager/runtime events
+- `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.
-- Path normalization, extension helpers, and source adapters for memory and
-  `fetch`.
+- 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; portable hydration; permutation selection; and per-index caching.
 - `Tr2TexturePipeline` CPU-only texture steps and `Tr2TextureLodManager`
   membership.
 - Opaque engine-owned subobject slots for backend adapters.
-- Non-shader format implementations as explicit tree-shakeable subpaths under
+- 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 formats (`format-dxbc`, `format-hlsl`, `format-webgl`,
-  `format-webgpu` remain separate packages).
+- Shader binary decoding, backend translation, and package serialization remain
+  in the standalone shader-format packages. 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.
+  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).
 
 ## Source layout
 
 Authoring source is decorated JavaScript; published output is built ESM in
-`npm/dist`. Completed Carbon data classes live with maintained source under
-`src/resources`; `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.
+`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.

package/docs/concepts/resource-lifecycle.md

@@ -116,7 +116,8 @@ Application / runtime object
 | - mark resource REQUESTED                     |
 | - share one source operation per source/path  |
 | - obey maxConcurrentLoads                     |
-| - source.Read(path)                           |
+| - CjsResMan builds URL when provider needs it |
+| - provider.Read(sourcePath)                   |
 +===============================================+
         |
         | source bytes

package/docs/formats/README.md

@@ -29,6 +29,10 @@ through `SetPayload()`, validate their own required fields, and throw
 `GetPayload()`, `HasPayload()`, and `ReleasePayload()` manage transient CPU
 retention without introducing a parallel DTO class hierarchy.
 
+Clone-safe formats may additionally declare browser-worker execution
+metadata. Worker eligibility never changes the format's direct API; see
+[browser worker execution](../reference/workers.md).
+
 ## Format map
 
 | Format | Class | Import |

package/docs/reference/classes/README.md

@@ -21,12 +21,14 @@ documentation check against the actual source tree.
 
 ## Catalog pages
 
-- [core.md](core.md): the resource manager, MotherLode cache, resource and
-  source classes, and the format/probe bases.
+- [core.md](core.md): the resource manager, MotherLode cache, fetch provider,
+  core resource class, and the format/probe bases.
+- [audio.md](audio.md): raw audio-byte owners and individually addressable
+  audio resource views.
 - [resources.md](resources.md): the Carbon-shaped semantic resource and data
-  classes under `src/resources`.
+  classes in the `src/resource` family tree.
 - [texture.md](texture.md): texture-array aggregation classes under
-  `src/texture`.
+  `src/resource/texture`.
 - [formats.md](formats.md): format entry classes and their internal reader
   machinery under `src/formats`.
 - [dropped.md](dropped.md): retained native shapes under `src/dropped` that

package/docs/reference/classes/audio.md

@@ -0,0 +1,30 @@
+# Audio resource class catalog
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime-resource/resource/audio` classes
+Audience: Users, maintainers, and automated readers
+Summary: Catalogs raw audio-byte owners and individually addressable audio resource views.
+
+<!-- class:CjsAudioBufferRes -->
+## `CjsAudioBufferRes`
+
+Physical audio byte-owner resource whose payload may back one complete file or several logical audio files.
+
+- Export: `@carbonenginejs/runtime-resource/resource/audio`
+- Source: `src/resource/audio/CjsAudioBufferRes.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+- Notes: Owns raw payload retention and locks without interpreting media IDs,
+  bank members, decoding, or playback.
+
+<!-- class:CjsAudioRes -->
+## `CjsAudioRes`
+
+Individually addressable audio resource representing one complete file over either a complete or windowed physical source.
+
+- Export: `@carbonenginejs/runtime-resource/resource/audio`
+- Source: `src/resource/audio/CjsAudioRes.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+- Notes: Carries immutable media metadata, returns detached byte windows, and
+  delegates locks and payload liveness to its backing resource.

package/docs/reference/classes/core.md

@@ -1,7 +1,7 @@
 # Core class catalog
 
 Status: Evolving  
-Scope: `@carbonenginejs/runtime-resource` classes under `src/` and `src/format/`  
+Scope: `@carbonenginejs/runtime-resource` classes under `src/`, `src/resource`, and `src/format/`
 Audience: Users, maintainers, and automated readers  
 Summary: Provides one-sentence purpose descriptors for the resource manager, registry, resource, source, and format/probe base classes.
 
@@ -31,7 +31,7 @@ GPU-free resource manager that resolves paths through registered sources and for
 Small FIFO executor used inside `CjsResMan` that tracks item ids, pause state, concurrency, cancellation, and sync/async completion while queue policy stays in the manager.
 
 - Export: None
-- Source: `src/CjsResManQueue.js`
+- Source: `src/CjsResManWorkQueue.js`
 - Visibility: Internal
 - Kind: Internal implementation class
 
@@ -41,27 +41,47 @@ Small FIFO executor used inside `CjsResMan` that tracks item ids, pause state, c
 Base runtime resource handle that carries normalized path/extension/requirement identity, load state, and an attached CPU payload, with manager lifecycle callbacks supplied by `CjsResMan` after canonical insertion.
 
 - Export: `@carbonenginejs/runtime-resource`
-- Source: `src/CjsResource.js`
+- Source: `src/resource/CjsResource.js`
 - Visibility: Public
 - Kind: Adapted Carbon concept
 
-<!-- class:CjsMemoryResourceSource -->
-## `CjsMemoryResourceSource`
+<!-- class:CjsResManMainThreadLoader -->
+## `CjsResManMainThreadLoader`
 
-In-memory resource source that maps normalized resource paths to preset values and serves them to reads without any I/O.
+Direct execution strategy that reads through a structural source and invokes registered format facades on the caller thread.
 
 - Export: `@carbonenginejs/runtime-resource`
-- Source: `src/CjsResourceSource.js`
+- Source: `src/worker/CjsResManMainThreadLoader.js`
+- Visibility: Public
+- Kind: Adapted ccpwgl loader strategy
+
+<!-- class:CjsResManWorkerLoader -->
+## `CjsResManWorkerLoader`
+
+Browser module-worker strategy that correlates source/format requests, transfers owned buffers, propagates cancellation and fatal failure, and delegates unsupported operations to a main-thread loader.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/worker/CjsResManWorkerLoader.js`
+- Visibility: Public
+- Kind: Adapted ccpwgl loader strategy
+
+<!-- class:CjsResManWorker -->
+## `CjsResManWorker`
+
+Static browser-worker host that owns its operation/message vocabulary, executes clone-safe source and format operations, installs the message envelope, transfers owned buffers, and serializes failures for `CjsResMan`.
+
+- Export: `@carbonenginejs/runtime-resource/worker`
+- Source: `src/worker/CjsResManWorker.js`
 - Visibility: Public
 - Kind: Original CarbonEngineJS class
 
-<!-- class:CjsFetchResourceSource -->
-## `CjsFetchResourceSource`
+<!-- class:CjsResManFetchProvider -->
+## `CjsResManFetchProvider`
 
-Resource source that resolves a normalized path against an optional base URL and reads response bytes through an injected fetch implementation.
+`CjsResMan` provider that fetches an already-resolved URL on the caller thread or through the resource worker.
 
 - Export: `@carbonenginejs/runtime-resource`
-- Source: `src/CjsResourceSource.js`
+- Source: `src/CjsResManFetchProvider.js`
 - Visibility: Public
 - Kind: Original CarbonEngineJS class
 

package/docs/reference/classes/formats.md

@@ -380,7 +380,7 @@ PNG format profile that synchronously inspects chunk and header metadata and emi
 <!-- class:CjsRedFormat -->
 ## `CjsRedFormat`
 
-Red format profile that reads type-discriminated, self-referential Red YAML object graphs and emits a compact public payload, a neutral raw graph, or caller-supplied runtime classes through the core-types hydration adapter.
+Red format profile that reads type-discriminated, self-referential Red YAML object graphs and emits a compact public payload, a neutral raw graph, or caller-supplied runtime classes through the runtime-utils hydration adapter.
 
 - Export: `@carbonenginejs/runtime-resource/formats/red`
 - Source: `src/formats/red/CjsRedFormat.js`