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

package/dist/core/CjsLibrary.js

@@ -1,692 +1,39 @@
-import { assertPlainObject, assertNonEmptyString } from '#utils/validation';
-import { SelectBackend } from './platform/backendSelection.js';
-import { Tr2PlatformInfo } from './platform/Tr2PlatformInfo.js';
-import { CjsResMan } from '#resource/CjsResMan';
-import { EveSOF as _EveSOF } from '../sof/EveSOF.js';
-import { CjsAudioMan } from '#audio/CjsAudioMan';
-
 /**
- * GPU-free CarbonEngineJS composition root.
+ * EMPTIED ON PURPOSE, 2026-09-17, by operator instruction.
  *
- * CjsLibrary owns service composition and resource-request policy. Resource
- * loading, decoding, device creation, and backend realization remain in the
- * supplied services.
- */
-
-const CjsServiceKey = Object.freeze({
-  RESOURCE_MANAGER: "resourceManager",
-  SPACE_OBJECT_FACTORY: "spaceObjectFactory",
-  DEVICE: "device",
-  AUDIO_MANAGER: "audioManager",
-  INPUT_MANAGER: "inputManager"
-});
-const OPTION_KEYS = new Set(["services", "resourceManager", "spaceObjectFactory", "audioManager", "capabilities", "resourceDefaults", "behaviors"]);
-const REQUEST_SELECTOR_KEYS = Object.freeze(["behavior", "resourceBehavior"]);
-
-/**
- * GPU-free CarbonEngineJS composition root and runtime service registry.
- */
-class CjsLibrary {
-  #services = new Map();
-  #capabilities = new Map();
-  #resourceBehaviors = new Map();
-  #resourceDefaults = Object.freeze({});
-  #behaviorOrder = 0;
-  #resourceManager = null;
-  #spaceObjectFactory = null;
-  #audioManager = null;
-  #backendSelection = null;
-  #initialized = false;
-
-  /** Creates a composition root from optional services, capabilities, and request policies. */
-  constructor(options = {}) {
-    this.SetValues(options);
-  }
-
-  /** Applies validated composition options and returns this library. */
-  SetValues(options = {}) {
-    assertPlainObject(options, "CjsLibrary options");
-    for (const key of Object.keys(options)) {
-      if (!OPTION_KEYS.has(key)) throw new TypeError(`CjsLibrary unknown option ${JSON.stringify(key)}.`);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "services")) {
-      assertPlainObject(options.services, "CjsLibrary.services");
-      for (const [key, service] of Object.entries(options.services)) this.SetService(key, service);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "resourceManager")) {
-      this.SetResourceManager(options.resourceManager);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "spaceObjectFactory")) {
-      this.SetSpaceObjectFactory(options.spaceObjectFactory);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "audioManager")) {
-      this.SetAudioManager(options.audioManager);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "capabilities")) {
-      this.RegisterCapabilities(options.capabilities);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "resourceDefaults")) {
-      this.SetResourceDefaults(options.resourceDefaults);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "behaviors")) {
-      RegisterBehaviorMap(this, options.behaviors);
-    }
-    return this;
-  }
-
-  /**
-   * Add service configuration using the same class-method vocabulary as the
-   * services being composed. Topic options are forwarded unchanged.
-   */
-  Register(options = {}) {
-    assertPlainObject(options, "CjsLibrary.Register options");
-    const known = new Set(["services", "resourceManager", "spaceObjectFactory", "audioManager", "capabilities", "resourceDefaults", "behaviors", "resMan", "sof", "audio"]);
-    for (const key of Object.keys(options)) {
-      if (!known.has(key)) throw new TypeError(`CjsLibrary.Register unknown topic ${JSON.stringify(key)}.`);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "services")) {
-      this.SetValues({
-        services: options.services
-      });
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "resourceManager")) {
-      this.SetResourceManager(options.resourceManager);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "spaceObjectFactory")) {
-      this.SetSpaceObjectFactory(options.spaceObjectFactory);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "audioManager")) {
-      this.SetAudioManager(options.audioManager);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "capabilities")) {
-      this.RegisterCapabilities(options.capabilities);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "resourceDefaults")) {
-      this.SetResourceDefaults(options.resourceDefaults);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "behaviors")) {
-      RegisterBehaviorMap(this, options.behaviors);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "resMan")) {
-      this.#resourceManager.Register(options.resMan);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "sof")) {
-      this.#spaceObjectFactory.Register(options.sof);
-    }
-    if (Object.prototype.hasOwnProperty.call(options, "audio")) {
-      this.#audioManager.InstallLibrary(options.audio);
-    }
-    return this;
-  }
-
-  /** Returns a snapshot of the configured services, capabilities, and request policies. */
-  GetValues() {
-    return {
-      initialized: this.#initialized,
-      resourceManager: this.#resourceManager,
-      spaceObjectFactory: this.#spaceObjectFactory,
-      audioManager: this.#audioManager,
-      services: Object.fromEntries(this.#services),
-      capabilities: this.GetCapabilities(),
-      resourceDefaults: this.GetResourceDefaults(),
-      resourceBehaviors: this.GetResourceBehaviors()
-    };
-  }
-
-  /** Applies options and marks the composition root initialized. */
-  Initialize(options = {}) {
-    this.SetValues(options);
-    this.#initialized = true;
-    return this;
-  }
-
-  // THE JOIN BETWEEN PROBING AND SELECTION. Probing, capability recording and
-  // backend choice all belong to the library - it is the thing that decides
-  // what to test, what to load and what to fall back to - but the policy
-  // itself lives in `backendSelection.js` as a plain function, so a caller
-  // composing without `CjsLibrary` reaches the identical decision. This
-  // method is the default caller, not the owner.
-  //
-  // It records and applies; it does not create. The device or context proof
-  // is the candidate's own asynchronous `Prove`, because runtime core must
-  // not create a GPU device and cannot import an engine to do it.
-
-  /**
-   * Probes the platform if it has not been told, then commits the library to
-   * exactly one backend from the candidates offered, recording the resulting
-   * capabilities. Returns the selection.
-   *
-   * `probe: false` skips detection and selects against already-registered
-   * capabilities, which is how a caller that probed elsewhere - or is
-   * replaying a known environment in a test - keeps one decision path.
-   */
-  async SelectBackendAsync(options = {}) {
-    assertPlainObject(options, "CjsLibrary.SelectBackendAsync options");
-    const {
-      candidates,
-      preference,
-      probe,
-      platform: supplied,
-      ...detectOptions
-    } = options;
-    let platform = supplied ?? null;
-    if (!platform && probe !== false) {
-      platform = await Tr2PlatformInfo.Detect(detectOptions);
-    }
-    if (platform) this.RegisterCapabilities(platform.GetCapabilities());
-    const selection = await SelectBackend({
-      candidates,
-      preference,
-      platform,
-      capabilities: platform ? undefined : this.GetCapabilities()
-    });
-
-    // The committed name is a capability because that is how a resource
-    // behavior reads it; the proof itself is the caller's to hold, since a
-    // device is a service and not a capability value.
-    this.SetCapability("backend", selection.effective);
-    this.#backendSelection = selection;
-    return selection;
-  }
-
-  /** The committed backend selection, or null before one is made. */
-  GetBackendSelection() {
-    return this.#backendSelection;
-  }
-
-  /** Initializes the library and optionally loads SOF data through the configured factory. */
-  async InitializeAsync(options = {}) {
-    const {
-      dataPath,
-      backend,
-      ...libraryOptions
-    } = options || {};
-    this.Initialize(libraryOptions);
-    if (backend !== undefined) {
-      await this.SelectBackendAsync(backend === true ? {} : backend);
-    }
-    if (dataPath !== undefined) {
-      const sof = this.#spaceObjectFactory;
-      if (!sof) {
-        const error = new Error("CjsLibrary cannot load SOF data without an async space object factory.");
-        error.code = "CJS_LIBRARY_SOF_MISSING";
-        throw error;
-      }
-      await sof.LoadDataAsync(dataPath);
-    } else if (this.#spaceObjectFactory) {
-      await this.#spaceObjectFactory.InitializeAsync();
-    }
-    return this;
-  }
-
-  /**
-   * Marks the composition root uninitialized and deactivates attached audio
-   * without disposing any caller-owned service.
-   */
-  Shutdown() {
-    if (this.#audioManager) {
-      this.#audioManager.Disable();
-      this.#audioManager.Detach();
-    }
-    // Switching backend is shutdown-and-reinitialize, never a hot swap, so
-    // the commitment is released here and nowhere else.
-    this.#backendSelection = null;
-    this.RemoveCapability("backend");
-    this.#initialized = false;
-    return this;
-  }
-
-  /** Registers or removes one named caller-owned service. */
-  SetService(key, service) {
-    const name = normalizeServiceKey(key);
-    assertOwnedService(name, service);
-    if (service === null || service === undefined) {
-      this.#services.delete(name);
-      if (name === CjsServiceKey.RESOURCE_MANAGER) this.#resourceManager = null;
-      if (name === CjsServiceKey.SPACE_OBJECT_FACTORY) this.#spaceObjectFactory = null;
-      if (name === CjsServiceKey.AUDIO_MANAGER) this.#audioManager = null;
-    } else {
-      this.#services.set(name, service);
-      if (name === CjsServiceKey.RESOURCE_MANAGER) this.#resourceManager = service;
-      if (name === CjsServiceKey.SPACE_OBJECT_FACTORY) this.#spaceObjectFactory = service;
-      if (name === CjsServiceKey.AUDIO_MANAGER) this.#audioManager = service;
-    }
-    return this;
-  }
-
-  /** Returns one named service, or null when it is not registered. */
-  GetService(key) {
-    return this.#services.get(normalizeServiceKey(key)) ?? null;
-  }
-
-  /** Reports whether one named service is registered. */
-  HasService(key) {
-    return this.#services.has(normalizeServiceKey(key));
-  }
-
-  /** Removes one named service and returns this library. */
-  RemoveService(key) {
-    this.SetService(key, null);
-    return this;
-  }
-
-  /** Registers the resource-manager service. */
-  SetResourceManager(resourceManager) {
-    return this.SetService(CjsServiceKey.RESOURCE_MANAGER, resourceManager);
-  }
-
-  /** Returns the registered resource-manager service. */
-  GetResourceManager() {
-    return this.#resourceManager;
-  }
-
-  /** Registers the space-object-factory service. */
-  SetSpaceObjectFactory(spaceObjectFactory) {
-    return this.SetService(CjsServiceKey.SPACE_OBJECT_FACTORY, spaceObjectFactory);
-  }
-
-  /** Returns the registered space-object-factory service. */
-  GetSpaceObjectFactory() {
-    return this.#spaceObjectFactory;
-  }
-
-  /** Registers the browser audio-manager service. */
-  SetAudioManager(audioManager) {
-    return this.SetService(CjsServiceKey.AUDIO_MANAGER, audioManager);
-  }
-
-  /** Returns the registered browser audio-manager service. */
-  GetAudioManager() {
-    return this.#audioManager;
-  }
-
-  /** Merge an already-probed synchronous capability report. */
-  RegisterCapabilities(capabilities = {}) {
-    assertPlainObject(capabilities, "CjsLibrary capabilities");
-    for (const [key, value] of Object.entries(capabilities)) this.SetCapability(key, value);
-    return this;
-  }
-
-  /** Sets or removes one named runtime capability. */
-  SetCapability(key, value) {
-    const name = normalizeCapabilityKey(key);
-    if (value === undefined) this.#capabilities.delete(name);else this.#capabilities.set(name, value);
-    return this;
-  }
-
-  /** Returns one named capability value. */
-  GetCapability(key) {
-    return this.#capabilities.get(normalizeCapabilityKey(key));
-  }
-
-  /** Reports whether one named capability is registered. */
-  HasCapability(key) {
-    return this.#capabilities.has(normalizeCapabilityKey(key));
-  }
-
-  /** Removes one named capability and returns this library. */
-  RemoveCapability(key) {
-    this.#capabilities.delete(normalizeCapabilityKey(key));
-    return this;
-  }
-
-  /** Returns an immutable snapshot of all registered capabilities. */
-  GetCapabilities() {
-    return Object.fromEntries(this.#capabilities);
-  }
-
-  /** Replaces the default options applied to resource requests. */
-  SetResourceDefaults(options = {}) {
-    assertPlainObject(options, "CjsLibrary resource defaults");
-    this.#resourceDefaults = freezeRequestOptions(stripRequestSelectors(options));
-    return this;
-  }
-
-  /** Returns the immutable default resource-request options. */
-  GetResourceDefaults() {
-    return this.#resourceDefaults;
-  }
-
-  /** Register a structural request policy without importing its owner. */
-  RegisterResourceBehavior(name, behavior, options = {}) {
-    const behaviorName = normalizeBehaviorName(name);
-    assertPlainObject(behavior, `CjsLibrary resource behavior ${JSON.stringify(behaviorName)}`);
-    assertPlainObject(options, "CjsLibrary resource behavior registration options");
-    for (const key of Object.keys(options)) {
-      if (key !== "default" && key !== "priority") {
-        throw new TypeError(`CjsLibrary resource behavior unknown registration option ${JSON.stringify(key)}.`);
-      }
-    }
-    if (Object.prototype.hasOwnProperty.call(behavior, "request")) {
-      assertPlainObject(behavior.request, `CjsLibrary resource behavior ${JSON.stringify(behaviorName)} request`);
-    }
-    if (behavior.CanResolveResourceRequest !== undefined && typeof behavior.CanResolveResourceRequest !== "function") {
-      throw new TypeError(`CjsLibrary resource behavior ${JSON.stringify(behaviorName)} CanResolveResourceRequest must be a function.`);
-    }
-    if (behavior.ResolveResourceRequest !== undefined && typeof behavior.ResolveResourceRequest !== "function") {
-      throw new TypeError(`CjsLibrary resource behavior ${JSON.stringify(behaviorName)} ResolveResourceRequest must be a function.`);
-    }
-    if (behavior.request === undefined && behavior.ResolveResourceRequest === undefined) {
-      throw new TypeError(`CjsLibrary resource behavior ${JSON.stringify(behaviorName)} must provide request or ResolveResourceRequest.`);
-    }
-    const isDefault = options.default ?? false;
-    const priority = options.priority ?? 0;
-    if (typeof isDefault !== "boolean") throw new TypeError("CjsLibrary resource behavior default must be boolean.");
-    if (!Number.isSafeInteger(priority)) throw new TypeError("CjsLibrary resource behavior priority must be a safe integer.");
-    this.#resourceBehaviors.set(behaviorName, {
-      name: behaviorName,
-      behavior,
-      default: isDefault,
-      priority,
-      order: this.#behaviorOrder++
-    });
-    return this;
-  }
-
-  /** Returns one registered resource behavior, or null when absent. */
-  GetResourceBehavior(name) {
-    return this.#resourceBehaviors.get(normalizeBehaviorName(name))?.behavior ?? null;
-  }
-
-  /** Reports whether one named resource behavior is registered. */
-  HasResourceBehavior(name) {
-    return this.#resourceBehaviors.has(normalizeBehaviorName(name));
-  }
-
-  /** Removes one resource behavior and returns this library. */
-  RemoveResourceBehavior(name) {
-    this.#resourceBehaviors.delete(normalizeBehaviorName(name));
-    return this;
-  }
-
-  /** Returns an immutable name-to-behavior snapshot. */
-  GetResourceBehaviors() {
-    return Object.fromEntries(Array.from(this.#resourceBehaviors, ([name, record]) => [name, record.behavior]));
-  }
-
-  /**
-   * Resolve one final ResMan source path and promised-output request.
-   *
-   * A terminal `@output` suffix is removed before behavior matching and is
-   * applied last as both `variant` and `emit`. This makes the source path and
-   * its requested result explicit without teaching ResMan about specifier
-   * syntax.
-   */
-  ResolveResourceRequest(path, options = {}) {
-    if (typeof path !== "string" || path.trim() === "") {
-      throw new TypeError("CjsLibrary resource path must be a non-empty string.");
-    }
-    assertPlainObject(options, "CjsLibrary resource request options");
-    const specifier = parseResourceSpecifier(path);
-    const requestedOptions = freezeRequestOptions(options);
-    const selector = getBehaviorSelector(options);
-    const callerOptions = stripRequestSelectors(options);
-    let selected = null;
-    const baseContext = {
-      path: specifier.path,
-      options: requestedOptions,
-      capabilities: this.GetCapabilities(),
-      services: Object.fromEntries(this.#services),
-      library: this
-    };
-    if (selector !== false) {
-      if (selector !== undefined) {
-        selected = this.#resourceBehaviors.get(normalizeBehaviorName(selector)) ?? null;
-        if (!selected) {
-          const error = new Error(`CjsLibrary resource behavior ${JSON.stringify(selector)} is not registered.`);
-          error.code = "CJS_LIBRARY_BEHAVIOR_UNKNOWN";
-          error.behavior = selector;
-          throw error;
-        }
-      } else {
-        const candidates = [];
-        for (const record of this.#resourceBehaviors.values()) {
-          if (!record.default) continue;
-          const matcher = record.behavior.CanResolveResourceRequest;
-          const matches = matcher ? assertSynchronousResult(matcher({
-            ...baseContext,
-            behaviorName: record.name
-          }), record.name, "CanResolveResourceRequest") : true;
-          if (typeof matches !== "boolean") {
-            throw new TypeError(`CjsLibrary resource behavior ${JSON.stringify(record.name)} CanResolveResourceRequest must return boolean.`);
-          }
-          if (matches) candidates.push(record);
-        }
-        candidates.sort((a, b) => b.priority - a.priority || a.order - b.order);
-        if (candidates.length > 1 && candidates[0].priority === candidates[1].priority) {
-          const error = new Error(`CjsLibrary resource behavior is ambiguous at priority ${candidates[0].priority}.`);
-          error.code = "CJS_LIBRARY_BEHAVIOR_AMBIGUOUS";
-          error.behaviors = candidates.filter(record => record.priority === candidates[0].priority).map(record => record.name);
-          throw error;
-        }
-        selected = candidates[0] ?? null;
-      }
-    }
-    let resolvedPath = specifier.path;
-    let resolvedOutput = specifier.output;
-    let behaviorOptions = {};
-    if (selected) {
-      if (selected.behavior.request !== undefined) {
-        behaviorOptions = stripRequestSelectors(selected.behavior.request);
-      }
-      const resolver = selected.behavior.ResolveResourceRequest;
-      if (resolver) {
-        const result = assertSynchronousResult(resolver({
-          ...baseContext,
-          behaviorName: selected.name
-        }), selected.name, "ResolveResourceRequest");
-        if (result !== undefined) {
-          assertPlainObject(result, `CjsLibrary resource behavior ${JSON.stringify(selected.name)} result`);
-          for (const key of Object.keys(result)) {
-            if (key !== "path" && key !== "options") {
-              throw new TypeError(`CjsLibrary resource behavior ${JSON.stringify(selected.name)} returned unknown key ${JSON.stringify(key)}.`);
-            }
-          }
-          if (result.path !== undefined) {
-            if (typeof result.path !== "string" || result.path.trim() === "") {
-              throw new TypeError(`CjsLibrary resource behavior ${JSON.stringify(selected.name)} path must be a non-empty string.`);
-            }
-            const resolvedSpecifier = parseResourceSpecifier(result.path);
-            resolvedPath = resolvedSpecifier.path;
-            if (resolvedOutput === null) resolvedOutput = resolvedSpecifier.output;
-          }
-          if (result.options !== undefined) {
-            assertPlainObject(result.options, `CjsLibrary resource behavior ${JSON.stringify(selected.name)} result options`);
-            behaviorOptions = mergeRequestOptions(behaviorOptions, stripRequestSelectors(result.options));
-          }
-        }
-      }
-    }
-    const outputOptions = resolvedOutput === null ? null : {
-      variant: resolvedOutput,
-      emit: resolvedOutput
-    };
-    const resolvedOptions = freezeRequestOptions(mergeRequestOptions(this.#resourceDefaults, behaviorOptions, callerOptions, outputOptions));
-    return {
-      sourcePath: specifier.path,
-      path: resolvedPath,
-      options: resolvedOptions,
-      behaviorName: selected?.name ?? null,
-      behavior: selected?.behavior ?? null
-    };
-  }
-
-  /** Resolves a request and obtains its resource handle synchronously. */
-  GetResource(path, options = {}) {
-    const request = this.ResolveResourceRequest(path, options);
-    return this.#resourceManager.GetResource(request.path, request.options);
-  }
-
-  /** Resolves a request and obtains its decoded object synchronously. */
-  GetObject(path, options = {}) {
-    const request = this.ResolveResourceRequest(path, options);
-    return this.#resourceManager.GetObject(request.path, request.options);
-  }
-
-  /** Resolves and asynchronously readies one resource handle. */
-  FetchResource(path, options = {}) {
-    const request = this.ResolveResourceRequest(path, options);
-    return this.#resourceManager.FetchResource(request.path, request.options);
-  }
-
-  /** Resolves and asynchronously obtains one decoded object. */
-  FetchObject(path, options = {}) {
-    const request = this.ResolveResourceRequest(path, options);
-    return this.#resourceManager.FetchObject(request.path, request.options);
-  }
-
-  /** Builds one plain SOF model-values graph through the configured factory. */
-  FetchDNA(dna, options = {}) {
-    const sof = this.#spaceObjectFactory;
-    if (!sof) {
-      const error = new Error("CjsLibrary cannot build DNA without a configured space object factory.");
-      error.code = "CJS_LIBRARY_SOF_MISSING";
-      throw error;
-    }
-    return sof.BuildValuesFromDNAAsync(dna, options);
-  }
-
-  /** Fetches DNA, a resource, or a decoded object according to the request options. */
-  Fetch(value, options = {}) {
-    if (options.kind === "dna" || IsDNAString(value)) return this.FetchDNA(value, options);
-    const request = this.ResolveResourceRequest(value, options);
-    return this.#resourceManager.Fetch(request.path, request.options);
-  }
-
-  /** Reports whether this composition root has been initialized. */
-  IsInitialized() {
-    return this.#initialized;
-  }
-}
-function normalizeServiceKey(key) {
-  return assertNonEmptyString(key, "CjsLibrary service key");
-}
-function assertOwnedService(name, service) {
-  if (service === null || service === undefined) return;
-  const expected = name === CjsServiceKey.RESOURCE_MANAGER ? CjsResMan : name === CjsServiceKey.SPACE_OBJECT_FACTORY ? _EveSOF : name === CjsServiceKey.AUDIO_MANAGER ? CjsAudioMan : null;
-  if (expected && !(service instanceof expected)) {
-    throw new TypeError(`CjsLibrary service ${JSON.stringify(name)} must be a ${expected.name}.`);
-  }
-}
-function normalizeCapabilityKey(key) {
-  return assertNonEmptyString(key, "CjsLibrary capability key");
-}
-function normalizeBehaviorName(name) {
-  return assertNonEmptyString(name, "CjsLibrary resource behavior name");
-}
-
-/**
- * Split one CjsLibrary resource specifier into its source path and optional
- * promised output suffix.
+ * What was here: 859 lines of service composition and resource-request policy,
+ * with no donor citation anywhere in the file. Nothing in `src` imported it -
+ * the only references were comments, five test files, and a generated demo
+ * bundle - so removing it cost no caller.
  *
- * The final `@tag` is reserved for output selection. Tags are normalized to
- * lowercase and intentionally exclude path/query delimiters; source services
- * therefore never see the suffix as part of the filename or extension.
+ * The two shapes that decided it:
  *
- * @param {string} value Non-empty resource specifier.
- * @returns {Readonly<{path: string, output: string|null}>} Source path and explicit output.
- * @throws {TypeError} If a present output suffix is malformed.
+ * - `resourceBehaviors`, a registry of named strategy objects carrying
+ *   `CanResolveResourceRequest`/`ResolveResourceRequest`, ordered by priority
+ *   with a default, consulted to decide what a resource request resolved to.
+ *   Carbon has no such concept; a search of the whole tree for the term returns
+ *   nothing. Carbon decides by path, extension and requested type, plus
+ *   constructors registered for `dynamic:/` names.
+ * - Two APIs for the same three services: named accessors
+ *   (`GetResourceManager`, `SetAudioManager`, ...) beside a generic keyed
+ *   registry (`SetService`, `GetService`, `HasService`, `RemoveService`).
+ *
+ * The class and its default export stay so the package surface is unchanged
+ * while the real one is written.
+ *
+ * What replaces it is decided, not open:
+ * `/docs/internal/decisions/composition-root-is-the-wrapper.md`. One instance
+ * per page. The root is the outward API a wrapping user holds - a ship from a
+ * name, a type, a graphic id, a type id plus skin id, a res path, or DNA - and
+ * what it owns is instantiation. Services live behind a holder named for
+ * Carbon's own prefix (`BeResMan` is `Be` + `ResMan`, and `Be` is Blue), so
+ * `blue.resMan` and `blue.paths`, in `global/blue`. Consumers reach a service
+ * THROUGH the holder and never capture it, which is what keeps the
+ * implementation swappable. An unconfigured service throws when asked.
  */
-function parseResourceSpecifier(value) {
-  const separator = value.lastIndexOf("@");
-  if (separator <= value.lastIndexOf("/")) {
-    return {
-      path: value,
-      output: null
-    };
-  }
-  const path = value.slice(0, separator);
-  const output = value.slice(separator + 1).trim().toLowerCase();
-  if (!path || !/^[a-z0-9][a-z0-9._-]*$/u.test(output)) {
-    throw new TypeError("CjsLibrary resource @output must be a non-empty alphanumeric tag.");
-  }
-  return {
-    path,
-    output
-  };
-}
-function getBehaviorSelector(options) {
-  const hasBehavior = Object.prototype.hasOwnProperty.call(options, "behavior");
-  const hasResourceBehavior = Object.prototype.hasOwnProperty.call(options, "resourceBehavior");
-  if (hasBehavior && hasResourceBehavior && options.behavior !== options.resourceBehavior) {
-    throw new TypeError("CjsLibrary resource request behavior selectors conflict.");
-  }
-  const selector = hasBehavior ? options.behavior : options.resourceBehavior;
-  if (selector !== undefined && selector !== false && (typeof selector !== "string" || selector.trim() === "")) {
-    throw new TypeError("CjsLibrary resource request behavior must be a non-empty string or false.");
-  }
-  return selector;
-}
-function stripRequestSelectors(options) {
-  const result = {
-    ...options
-  };
-  for (const key of REQUEST_SELECTOR_KEYS) delete result[key];
-  if (Object.prototype.hasOwnProperty.call(result, "formatOptions") && result.formatOptions !== undefined) {
-    assertPlainObject(result.formatOptions, "CjsLibrary resource request formatOptions");
-    result.formatOptions = {
-      ...result.formatOptions
-    };
-  }
-  return result;
-}
-function mergeRequestOptions(...sources) {
-  const result = {};
-  let formatOptions = null;
-  for (const source of sources) {
-    if (!source) continue;
-    for (const [key, value] of Object.entries(source)) {
-      if (key === "formatOptions") {
-        if (value === undefined) {
-          formatOptions = null;
-          delete result.formatOptions;
-          continue;
-        }
-        assertPlainObject(value, "CjsLibrary resource request formatOptions");
-        formatOptions = {
-          ...(formatOptions ?? {}),
-          ...value
-        };
-        result.formatOptions = formatOptions;
-      } else if (!REQUEST_SELECTOR_KEYS.includes(key)) {
-        result[key] = value;
-      }
-    }
-  }
-  return result;
-}
-function freezeRequestOptions(options) {
-  const result = stripRequestSelectors(options);
-  if (result.formatOptions) result.formatOptions;
-  return result;
-}
-function assertSynchronousResult(result, behaviorName, method) {
-  if (result && typeof result.then === "function") {
-    const error = new Error(`CjsLibrary resource behavior ${JSON.stringify(behaviorName)} ${method} must be synchronous.`);
-    error.code = "CJS_LIBRARY_BEHAVIOR_ASYNC";
-    error.behavior = behaviorName;
-    error.method = method;
-    throw error;
-  }
-  return result;
-}
-function RegisterBehaviorMap(library, behaviors) {
-  assertPlainObject(behaviors, "CjsLibrary behaviors");
-  for (const [name, definition] of Object.entries(behaviors)) {
-    if (definition && typeof definition === "object" && !Array.isArray(definition) && Object.prototype.hasOwnProperty.call(definition, "behavior")) {
-      library.RegisterResourceBehavior(name, definition.behavior, {
-        default: definition.default ?? false,
-        priority: definition.priority ?? 0
-      });
-    } else {
-      library.RegisterResourceBehavior(name, definition);
-    }
-  }
-}
-function IsDNAString(value) {
-  if (typeof value !== "string" || value.includes(":/")) return false;
-  return value.split(":").length >= 3;
-}
 
-export { CjsLibrary, CjsServiceKey, CjsLibrary as default };
+/** CarbonEngineJS composition root. Awaiting rebuild; see the head comment. */
+class CjsLibrary {}
+
+export { CjsLibrary, CjsLibrary as default };
 //# sourceMappingURL=CjsLibrary.js.map