@forgeax/engine-fbx 0.1.4 → 0.1.7

package/dist/index.mjs

@@ -1,6 +1,9 @@
-import { ImportError, IMPORT_ERROR_HINTS, reconcileMeshMaterialSlotTopology, resolveMeshMaterialSlotDefaultGuid, err, ok } from '@forgeax/engine-types';
+import { reconcileMeshMaterialSlotTopology, ImportError, IMPORT_ERROR_HINTS, resolveMeshMaterialSlotDefaultGuid, err, ok } from '@forgeax/engine-types';
 import { deriveAnimationTargetId } from '@forgeax/engine-animation/target-id';
+import '@forgeax/engine-pack';
 import { box3 } from '@forgeax/engine-math';
+import { AssetGuid } from '@forgeax/engine-pack/guid';
+import { MESH_BIN_HEADER_V4_BYTES, writeMeshBinHeader } from '@forgeax/engine-pack/mesh-bin-contract';
 
 // src/errors.ts
 var fbxErrorPolicy = {
@@ -242,20 +245,6 @@ function phongRoughness(shininess, maxGloss = 100) {
   return clamp(1 - Math.sqrt(shininess / maxGloss), 0, 1);
 }
 function parseMaterial(raw, sourceIndex) {
-  const textureBindings = raw.textureBindings?.map((binding) => ({
-    slot: binding.slot,
-    textureIndex: binding.textureIndex,
-    ...binding.texCoord === void 0 ? {} : { texCoord: binding.texCoord }
-  }));
-  const textureFields = textureBindings === void 0 || textureBindings.length === 0 ? {} : {
-    textureBindings,
-    ...Object.fromEntries(
-      textureBindings.map((binding) => [
-        binding.slot === "baseColorTexture" ? "baseColorTextureIndex" : binding.slot === "metallicRoughnessTexture" ? "metallicRoughnessTextureIndex" : binding.slot === "normalTexture" ? "normalTextureIndex" : binding.slot === "occlusionTexture" ? "occlusionTextureIndex" : binding.slot === "emissiveTexture" ? "emissiveTextureIndex" : "specularTintTextureIndex",
-        binding.textureIndex
-      ])
-    )
-  };
   switch (raw.kind) {
     case "stingray-pbs": {
       const sp = raw.stingrayProps ?? {};
@@ -268,8 +257,7 @@ function parseMaterial(raw, sourceIndex) {
           1
         ],
         metallicFactor: sp.metallic ?? 0,
-        roughnessFactor: sp.roughness ?? 0.5,
-        ...textureFields
+        roughnessFactor: sp.roughness ?? 0.5
       };
     }
     case "phong": {
@@ -279,8 +267,7 @@ function parseMaterial(raw, sourceIndex) {
         ...raw.name !== void 0 && { name: raw.name },
         baseColorFactor: [d[0] ?? 0.5, d[1] ?? 0.5, d[2] ?? 0.5, 1],
         metallicFactor: 0,
-        roughnessFactor: phongRoughness(gloss),
-        ...textureFields
+        roughnessFactor: phongRoughness(gloss)
       };
     }
     case "lambert": {
@@ -289,17 +276,15 @@ function parseMaterial(raw, sourceIndex) {
         ...raw.name !== void 0 && { name: raw.name },
         baseColorFactor: [d[0] ?? 0.5, d[1] ?? 0.5, d[2] ?? 0.5, 1],
         metallicFactor: 0,
-        roughnessFactor: 0.5,
+        roughnessFactor: 0.5
         // lambert has no specular → default roughness
-        ...textureFields
       };
     }
     default: {
       return {
         baseColorFactor: [0.5, 0.5, 0.5, 1],
         metallicFactor: 0,
-        roughnessFactor: 0.5,
-        ...textureFields
+        roughnessFactor: 0.5
       };
     }
   }
@@ -510,511 +495,14 @@ function parseSkin(doc) {
 }
 
 // src/parse-texture.ts
-function normalizePath(path) {
-  return path.replaceAll("\\", "/");
-}
 function parseTextures(raw) {
   const textures = raw.textures ?? [];
   return textures.map((t) => ({
-    name: t.name ?? t.filePath ?? t.relativeFilePath ?? `texture-${t.sourceIndex}`,
-    filePath: normalizePath(t.filePath ?? t.relativeFilePath ?? ""),
-    ...t.relativeFilePath === void 0 ? {} : { relativeFilePath: normalizePath(t.relativeFilePath) },
-    ...t.absoluteFilePath === void 0 ? {} : { absoluteFilePath: t.absoluteFilePath },
-    ...t.embeddedBytes === void 0 ? {} : { embeddedBytes: Uint8Array.from(t.embeddedBytes) },
-    ...t.type === void 0 ? {} : { type: t.type },
+    name: t.name ?? t.filePath,
+    filePath: t.filePath,
     sourceIndex: t.sourceIndex
   }));
 }
-
-// src/resolve-texture-path.ts
-function normalizeSourceRelativePath(raw) {
-  const value = raw.replaceAll("\\", "/");
-  if (value.startsWith("/") || /^[A-Za-z]:\//.test(value) || value.startsWith("//"))
-    return void 0;
-  const parts = [];
-  for (const part of value.split("/")) {
-    if (part === "" || part === ".") continue;
-    if (part === "..") {
-      if (parts.at(-1) !== void 0 && parts.at(-1) !== "..") parts.pop();
-      else parts.push("..");
-    } else {
-      parts.push(part);
-    }
-  }
-  return parts.join("/");
-}
-function requestSegments(raw) {
-  const value = raw.replaceAll("\\", "/").replace(/^[A-Za-z]:\//, "").replace(/^\/+/, "");
-  return value.split("/").filter((part) => part !== "" && part !== ".");
-}
-function uniqueMatches(paths, predicate) {
-  return [...new Set(paths.filter(predicate))];
-}
-function longestSuffixLength(request, candidate) {
-  let count = 0;
-  while (count < request.length && count < candidate.length && request[request.length - 1 - count]?.toLowerCase() === candidate[candidate.length - 1 - count]?.toLowerCase()) {
-    count++;
-  }
-  return count;
-}
-function resolveFbxTexturePath(sourcePath, request, candidates) {
-  const candidatePaths = candidates.flatMap((candidate) => {
-    const normalized = normalizeSourceRelativePath(candidate.relativePath);
-    return normalized === void 0 || normalized.length === 0 ? [] : [normalized];
-  });
-  const requestedPath = request.declaredRelativePath ?? request.declaredFilename ?? request.declaredAbsolutePath ?? "";
-  const choose = (matches, strategy) => {
-    const unique = [...new Set(matches)];
-    if (unique.length === 1) {
-      const relativePath = unique[0];
-      if (relativePath === void 0) return void 0;
-      return {
-        ok: true,
-        relativePath,
-        readUri: relativePath,
-        strategy
-      };
-    }
-    if (unique.length > 1) {
-      return {
-        ok: false,
-        code: "fbx-external-texture-ambiguous",
-        requestedPath,
-        candidates: unique
-      };
-    }
-    return void 0;
-  };
-  const relativeRequest = request.declaredRelativePath ?? request.declaredFilename;
-  if (relativeRequest !== void 0 && !/^(?:[A-Za-z]:[\\/]|[\\/])/.test(relativeRequest)) {
-    const normalizedRequest = normalizeSourceRelativePath(relativeRequest);
-    if (normalizedRequest !== void 0) {
-      const scopeExact = choose(
-        uniqueMatches(candidatePaths, (path) => path === normalizedRequest),
-        "exact"
-      );
-      if (scopeExact !== void 0) return scopeExact;
-      const scopeFolded = choose(
-        uniqueMatches(
-          candidatePaths,
-          (path) => path.toLowerCase() === normalizedRequest.toLowerCase()
-        ),
-        "case-folded"
-      );
-      if (scopeFolded !== void 0) return scopeFolded;
-    }
-  }
-  const requestedSegments = requestSegments(requestedPath);
-  if (requestedSegments.length > 0) {
-    const scored = candidatePaths.map((path) => ({
-      path,
-      score: longestSuffixLength(requestedSegments, path.split("/"))
-    }));
-    const bestScore = Math.max(0, ...scored.map((entry) => entry.score));
-    if (bestScore > 0) {
-      const best = scored.filter((entry) => entry.score === bestScore).map((entry) => entry.path);
-      const strategy = bestScore === 1 ? "basename" : "suffix";
-      const suffix = choose(best, strategy);
-      if (suffix !== void 0) return suffix;
-    }
-  }
-  return {
-    ok: false,
-    code: "fbx-external-texture-missing",
-    requestedPath,
-    candidates: candidatePaths
-  };
-}
-
-// ../../node_modules/.pnpm/uuidv7@1.2.1/node_modules/uuidv7/dist/index.js
-var DIGITS = "0123456789abcdef";
-var UUID = class _UUID {
-  /** @param bytes - The 16-byte byte array representation. */
-  constructor(bytes) {
-    this.bytes = bytes;
-  }
-  /**
-   * Creates an object from the internal representation, a 16-byte byte array
-   * containing the binary UUID representation in the big-endian byte order.
-   *
-   * This method does NOT shallow-copy the argument, and thus the created object
-   * holds the reference to the underlying buffer.
-   *
-   * @throws TypeError if the length of the argument is not 16.
-   */
-  static ofInner(bytes) {
-    if (bytes.length !== 16) {
-      throw new TypeError("not 128-bit length");
-    } else {
-      return new _UUID(bytes);
-    }
-  }
-  /**
-   * Builds a byte array from UUIDv7 field values.
-   *
-   * @param unixTsMs - A 48-bit `unix_ts_ms` field value.
-   * @param randA - A 12-bit `rand_a` field value.
-   * @param randBHi - The higher 30 bits of 62-bit `rand_b` field value.
-   * @param randBLo - The lower 32 bits of 62-bit `rand_b` field value.
-   * @throws RangeError if any field value is out of the specified range.
-   */
-  static fromFieldsV7(unixTsMs, randA, randBHi, randBLo) {
-    if (!Number.isInteger(unixTsMs) || !Number.isInteger(randA) || !Number.isInteger(randBHi) || !Number.isInteger(randBLo) || unixTsMs < 0 || randA < 0 || randBHi < 0 || randBLo < 0 || unixTsMs > 281474976710655 || randA > 4095 || randBHi > 1073741823 || randBLo > 4294967295) {
-      throw new RangeError("invalid field value");
-    }
-    const bytes = new Uint8Array(16);
-    bytes[0] = unixTsMs / 2 ** 40;
-    bytes[1] = unixTsMs / 2 ** 32;
-    bytes[2] = unixTsMs / 2 ** 24;
-    bytes[3] = unixTsMs / 2 ** 16;
-    bytes[4] = unixTsMs / 2 ** 8;
-    bytes[5] = unixTsMs;
-    bytes[6] = 112 | randA >>> 8;
-    bytes[7] = randA;
-    bytes[8] = 128 | randBHi >>> 24;
-    bytes[9] = randBHi >>> 16;
-    bytes[10] = randBHi >>> 8;
-    bytes[11] = randBHi;
-    bytes[12] = randBLo >>> 24;
-    bytes[13] = randBLo >>> 16;
-    bytes[14] = randBLo >>> 8;
-    bytes[15] = randBLo;
-    return new _UUID(bytes);
-  }
-  /**
-   * Builds a byte array from a string representation.
-   *
-   * This method accepts the following formats:
-   *
-   * - 32-digit hexadecimal format without hyphens: `0189dcd553117d408db09496a2eef37b`
-   * - 8-4-4-4-12 hyphenated format: `0189dcd5-5311-7d40-8db0-9496a2eef37b`
-   * - Hyphenated format with surrounding braces: `{0189dcd5-5311-7d40-8db0-9496a2eef37b}`
-   * - RFC 9562 URN format: `urn:uuid:0189dcd5-5311-7d40-8db0-9496a2eef37b`
-   *
-   * Leading and trailing whitespaces represents an error.
-   *
-   * @throws SyntaxError if the argument could not parse as a valid UUID string.
-   */
-  static parse(uuid) {
-    var _a, _b, _c, _d;
-    let hex = void 0;
-    switch (uuid.length) {
-      case 32:
-        hex = (_a = /^[0-9a-f]{32}$/i.exec(uuid)) === null || _a === void 0 ? void 0 : _a[0];
-        break;
-      case 36:
-        hex = (_b = /^([0-9a-f]{8})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{12})$/i.exec(uuid)) === null || _b === void 0 ? void 0 : _b.slice(1, 6).join("");
-        break;
-      case 38:
-        hex = (_c = /^\{([0-9a-f]{8})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{12})\}$/i.exec(uuid)) === null || _c === void 0 ? void 0 : _c.slice(1, 6).join("");
-        break;
-      case 45:
-        hex = (_d = /^urn:uuid:([0-9a-f]{8})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{12})$/i.exec(uuid)) === null || _d === void 0 ? void 0 : _d.slice(1, 6).join("");
-        break;
-    }
-    if (hex) {
-      const inner = new Uint8Array(16);
-      for (let i = 0; i < 16; i += 4) {
-        const n = parseInt(hex.substring(2 * i, 2 * i + 8), 16);
-        inner[i + 0] = n >>> 24;
-        inner[i + 1] = n >>> 16;
-        inner[i + 2] = n >>> 8;
-        inner[i + 3] = n;
-      }
-      return new _UUID(inner);
-    } else {
-      throw new SyntaxError("could not parse UUID string");
-    }
-  }
-  /**
-   * @returns The 8-4-4-4-12 canonical hexadecimal string representation
-   * (`0189dcd5-5311-7d40-8db0-9496a2eef37b`).
-   */
-  toString() {
-    let text = "";
-    for (let i = 0; i < this.bytes.length; i++) {
-      text += DIGITS.charAt(this.bytes[i] >>> 4);
-      text += DIGITS.charAt(this.bytes[i] & 15);
-      if (i === 3 || i === 5 || i === 7 || i === 9) {
-        text += "-";
-      }
-    }
-    return text;
-  }
-  /**
-   * @returns The 32-digit hexadecimal representation without hyphens
-   * (`0189dcd553117d408db09496a2eef37b`).
-   */
-  toHex() {
-    let text = "";
-    for (let i = 0; i < this.bytes.length; i++) {
-      text += DIGITS.charAt(this.bytes[i] >>> 4);
-      text += DIGITS.charAt(this.bytes[i] & 15);
-    }
-    return text;
-  }
-  /** @returns The 8-4-4-4-12 canonical hexadecimal string representation. */
-  toJSON() {
-    return this.toString();
-  }
-  /**
-   * Reports the variant field value of the UUID or, if appropriate, "NIL" or
-   * "MAX".
-   *
-   * For convenience, this method reports "NIL" or "MAX" if `this` represents
-   * the Nil or Max UUID, although the Nil and Max UUIDs are technically
-   * subsumed under the variants `0b0` and `0b111`, respectively.
-   */
-  getVariant() {
-    const n = this.bytes[8] >>> 4;
-    if (n < 0) {
-      throw new Error("unreachable");
-    } else if (n <= 7) {
-      return this.isNil() ? "NIL" : "VAR_0";
-    } else if (n <= 11) {
-      return "VAR_10";
-    } else if (n <= 13) {
-      return "VAR_110";
-    } else if (n <= 15) {
-      return this.isMax() ? "MAX" : "VAR_RESERVED";
-    } else {
-      throw new Error("unreachable");
-    }
-  }
-  /**
-   * Returns the version field value of the UUID or `undefined` if the UUID does
-   * not have the variant field value of `0b10`.
-   */
-  getVersion() {
-    return this.getVariant() === "VAR_10" ? this.bytes[6] >>> 4 : void 0;
-  }
-  /** Returns `true` if `this` is the Nil UUID. */
-  isNil() {
-    return this.bytes.every((e) => e === 0);
-  }
-  /** Returns `true` if `this` is the Max UUID. */
-  isMax() {
-    return this.bytes.every((e) => e === 255);
-  }
-  /** Creates an object from `this`. */
-  clone() {
-    return new _UUID(this.bytes.slice(0));
-  }
-  /** Returns true if `this` is equivalent to `other`. */
-  equals(other) {
-    return this.compareTo(other) === 0;
-  }
-  /**
-   * Returns a negative integer, zero, or positive integer if `this` is less
-   * than, equal to, or greater than `other`, respectively.
-   */
-  compareTo(other) {
-    for (let i = 0; i < 16; i++) {
-      const diff = this.bytes[i] - other.bytes[i];
-      if (diff !== 0) {
-        return Math.sign(diff);
-      }
-    }
-    return 0;
-  }
-};
-var V7Generator = class {
-  /**
-   * Creates a generator object with the default random number generator, or
-   * with the specified one if passed as an argument. The specified random
-   * number generator should be cryptographically strong and securely seeded.
-   */
-  constructor(randomNumberGenerator) {
-    this.timestampBiased = 0;
-    this.counter = 0;
-    this.rollbackAllowance = 1e4;
-    this.random = randomNumberGenerator !== null && randomNumberGenerator !== void 0 ? randomNumberGenerator : getDefaultRandom();
-  }
-  /**
-   * Sets the `rollbackAllowance` parameter of the generator.
-   *
-   * The `rollbackAllowance` parameter specifies the amount of `unixTsMs`
-   * rollback that is considered significant. The default value is `10_000`
-   * (milliseconds). See the {@link generate} or {@link generateOrAbort}
-   * documentation for the treatment of the significant rollback.
-   *
-   */
-  setRollbackAllowance(rollbackAllowance) {
-    if (rollbackAllowance < 0 || rollbackAllowance > 281474976710655) {
-      throw new RangeError("`rollbackAllowance` out of reasonable range");
-    }
-    this.rollbackAllowance = rollbackAllowance;
-  }
-  /**
-   * Generates a new UUIDv7 object from the current timestamp, or resets the
-   * generator upon significant timestamp rollback.
-   *
-   * This method returns a monotonically increasing UUID by reusing the previous
-   * timestamp even if the up-to-date timestamp is smaller than the immediately
-   * preceding UUID's. However, when such a clock rollback is considered
-   * significant (by default, more than ten seconds), this method resets the
-   * generator and returns a new UUID based on the given timestamp, breaking the
-   * increasing order of UUIDs.
-   *
-   * See {@link generateOrAbort} for the other mode of generation and
-   * {@link generateOrResetWithTs} for the variant accepting a custom timestamp.
-   */
-  generate() {
-    return this.generateOrResetWithTs(Date.now());
-  }
-  /**
-   * Generates a new UUIDv7 object from the current timestamp, or returns
-   * `undefined` upon significant timestamp rollback.
-   *
-   * This method returns a monotonically increasing UUID by reusing the previous
-   * timestamp even if the up-to-date timestamp is smaller than the immediately
-   * preceding UUID's. However, when such a clock rollback is considered
-   * significant (by default, more than ten seconds), this method aborts and
-   * returns `undefined` immediately.
-   *
-   * See {@link generate} for the other mode of generation and
-   * {@link generateOrAbortWithTs} for the variant accepting a custom timestamp.
-   */
-  generateOrAbort() {
-    return this.generateOrAbortWithTs(Date.now());
-  }
-  /**
-   * Generates a new UUIDv7 object from the `unixTsMs` passed, or resets the
-   * generator upon significant timestamp rollback.
-   *
-   * This method is equivalent to {@link generate} except that it takes a custom
-   * timestamp.
-   *
-   * @throws RangeError if `unixTsMs` is not a 48-bit unsigned integer.
-   */
-  generateOrResetWithTs(unixTsMs) {
-    let value = this.generateOrAbortWithTs(unixTsMs);
-    if (value === void 0) {
-      this.timestampBiased = 0;
-      value = this.generateOrAbortWithTs(unixTsMs);
-    }
-    return value;
-  }
-  /**
-   * Generates a new UUIDv7 object from the `unixTsMs` passed, or returns
-   * `undefined` upon significant timestamp rollback.
-   *
-   * This method is equivalent to {@link generateOrAbort} except that it takes a
-   * custom timestamp.
-   *
-   * @throws RangeError if `unixTsMs` is not a 48-bit unsigned integer.
-   */
-  generateOrAbortWithTs(unixTsMs) {
-    const MAX_COUNTER = 4398046511103;
-    if (!Number.isInteger(unixTsMs) || unixTsMs < 0 || unixTsMs > 281474976710655) {
-      throw new RangeError("`unixTsMs` must be a 48-bit unsigned integer");
-    }
-    unixTsMs++;
-    if (unixTsMs > this.timestampBiased) {
-      this.timestampBiased = unixTsMs;
-      this.resetCounter();
-    } else if (unixTsMs + this.rollbackAllowance >= this.timestampBiased) {
-      this.counter++;
-      if (this.counter > MAX_COUNTER) {
-        this.timestampBiased++;
-        this.resetCounter();
-      }
-    } else {
-      return void 0;
-    }
-    return UUID.fromFieldsV7(this.timestampBiased - 1, Math.trunc(this.counter / 2 ** 30), this.counter & 2 ** 30 - 1, this.random.nextUint32());
-  }
-  /**
-   * Generates a new UUIDv7 object from the `unixTsMs` passed, or resets the
-   * generator upon significant timestamp rollback.
-   *
-   * This method is a deprecated version of {@link generateOrResetWithTs} that
-   * accepts the `rollbackAllowance` parameter as an argument, rather than using
-   * the generator-level parameter.
-   *
-   * @param rollbackAllowance - The amount of `unixTsMs` rollback that is
-   * considered significant. A suggested value is `10_000` (milliseconds).
-   * @throws RangeError if `unixTsMs` is not a 48-bit unsigned integer.
-   * @deprecated Since v1.2.0. Use {@link generateOrResetWithTs} instead.
-   */
-  generateOrResetCore(unixTsMs, rollbackAllowance) {
-    const origRollbackAllowance = this.rollbackAllowance;
-    try {
-      this.setRollbackAllowance(rollbackAllowance);
-      return this.generateOrResetWithTs(unixTsMs);
-    } catch (e) {
-      throw e;
-    } finally {
-      this.rollbackAllowance = origRollbackAllowance;
-    }
-  }
-  /**
-   * Generates a new UUIDv7 object from the `unixTsMs` passed, or returns
-   * `undefined` upon significant timestamp rollback.
-   *
-   * This method is a deprecated version of {@link generateOrAbortWithTs} that
-   * accepts the `rollbackAllowance` parameter as an argument, rather than using
-   * the generator-level parameter.
-   *
-   * @param rollbackAllowance - The amount of `unixTsMs` rollback that is
-   * considered significant. A suggested value is `10_000` (milliseconds).
-   * @throws RangeError if `unixTsMs` is not a 48-bit unsigned integer.
-   * @deprecated Since v1.2.0. Use {@link generateOrAbortWithTs} instead.
-   */
-  generateOrAbortCore(unixTsMs, rollbackAllowance) {
-    const origRollbackAllowance = this.rollbackAllowance;
-    try {
-      this.setRollbackAllowance(rollbackAllowance);
-      return this.generateOrAbortWithTs(unixTsMs);
-    } catch (e) {
-      throw e;
-    } finally {
-      this.rollbackAllowance = origRollbackAllowance;
-    }
-  }
-  /** Initializes the counter at a 42-bit random integer. */
-  resetCounter() {
-    this.counter = this.random.nextUint32() * 1024 + (this.random.nextUint32() & 1023);
-  }
-  /**
-   * Generates a new UUIDv4 object utilizing the random number generator inside.
-   *
-   * @internal
-   */
-  generateV4() {
-    const bytes = new Uint8Array(Uint32Array.of(this.random.nextUint32(), this.random.nextUint32(), this.random.nextUint32(), this.random.nextUint32()).buffer);
-    bytes[6] = 64 | bytes[6] >>> 4;
-    bytes[8] = 128 | bytes[8] >>> 2;
-    return UUID.ofInner(bytes);
-  }
-};
-var getDefaultRandom = () => {
-  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues !== "undefined") {
-    return new BufferedCryptoRandom();
-  } else {
-    if (typeof UUIDV7_DENY_WEAK_RNG !== "undefined" && UUIDV7_DENY_WEAK_RNG) {
-      throw new Error("no cryptographically strong RNG available");
-    }
-    return {
-      nextUint32: () => Math.trunc(Math.random() * 65536) * 65536 + Math.trunc(Math.random() * 65536)
-    };
-  }
-};
-var BufferedCryptoRandom = class {
-  constructor() {
-    this.buffer = new Uint32Array(8);
-    this.cursor = 65535;
-  }
-  nextUint32() {
-    if (this.cursor >= this.buffer.length) {
-      crypto.getRandomValues(this.buffer);
-      this.cursor = 0;
-    }
-    return this.buffer[this.cursor++];
-  }
-};
-var defaultGenerator;
-var uuidv7obj = () => (defaultGenerator || (defaultGenerator = new V7Generator())).generate();
 var ATTRIBUTE_FORMAT_MAP = {
   position: "float32x3",
   normal: "float32x3",
@@ -1084,117 +572,6 @@ function deriveVertexLayoutProjection(map) {
     digest: fnv1a(digestInput)
   });
 }
-
-// ../pack/dist/guid.mjs
-var PackError = class extends Error {
-  code;
-  expected;
-  hint;
-  detail;
-  constructor(args) {
-    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);
-    this.name = "PackError";
-    this.code = args.code;
-    this.expected = args.expected;
-    this.hint = args.hint;
-    this.detail = args.detail;
-  }
-};
-function brand(bytes) {
-  return bytes;
-}
-var HEX_BYTE = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));
-function bytesToDashForm(bytes) {
-  const h = HEX_BYTE;
-  return `${h[bytes[0]]}${h[bytes[1]]}${h[bytes[2]]}${h[bytes[3]]}-${h[bytes[4]]}${h[bytes[5]]}-${h[bytes[6]]}${h[bytes[7]]}-${h[bytes[8]]}${h[bytes[9]]}-${h[bytes[10]]}${h[bytes[11]]}${h[bytes[12]]}${h[bytes[13]]}${h[bytes[14]]}${h[bytes[15]]}`;
-}
-var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function isValidAssetGuidString(value) {
-  return typeof value === "string" && UUID_RE.test(value);
-}
-function dashFormToBytes(dashForm) {
-  const hex = dashForm.replace(/-/g, "");
-  const bytes = new Uint8Array(16);
-  for (let i = 0; i < 16; i++) {
-    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-  }
-  return bytes;
-}
-var AssetGuid = {
-  /**
-   * Parse a 36-char RFC 4122 dash-form UUID string into an AssetGuid.
-   * Returns Ok(AssetGuid) on success or Err(PackError) with code 'pack-guid-malformed' on failure.
-   * Never throws for expected failures (requirements §4.2 / §14 / charter proposition 4).
-   */
-  parse(dashForm) {
-    if (!isValidAssetGuidString(dashForm)) {
-      return {
-        ok: false,
-        error: new PackError({
-          code: "pack-guid-malformed",
-          expected: "36-char RFC 4122 dash-form UUID",
-          hint: "use AssetGuid.random() or a UUIDv7 generator; all GUID fields must be 36-char RFC 4122 dash-form",
-          detail: {
-            raw: dashForm,
-            reason: "expected 36-char RFC 4122 dash-form UUID"
-          }
-        })
-      };
-    }
-    return { ok: true, value: brand(dashFormToBytes(dashForm)) };
-  },
-  /**
-   * Format an AssetGuid as a 36-char RFC 4122 lowercase dash-form string.
-   */
-  format(guid) {
-    return bytesToDashForm(guid);
-  },
-  /**
-   * Test byte-by-byte equality between two AssetGuids.
-   */
-  equals(a, b) {
-    for (let i = 0; i < 16; i++) {
-      if (a[i] !== b[i]) return false;
-    }
-    return true;
-  },
-  /**
-   * Mint a new time-ordered UUIDv7 as an AssetGuid.
-   * Works in both Node.js and browser environments.
-   */
-  random() {
-    const uuid = uuidv7obj();
-    const bytes = new Uint8Array(16);
-    bytes.set(uuid.bytes);
-    return brand(bytes);
-  }
-};
-
-// ../pack/dist/mesh-bin-contract.mjs
-var MESH_BIN_HEADER_V4_BYTES = 80;
-var MESH_BIN_DIGEST_BYTES = 32;
-function digestBytes(digest) {
-  const bytes = new Uint8Array(MESH_BIN_DIGEST_BYTES);
-  bytes.set(new TextEncoder().encode(digest).subarray(0, MESH_BIN_DIGEST_BYTES));
-  return bytes;
-}
-function writeMeshBinHeader(header, out) {
-  if (out.byteLength < MESH_BIN_HEADER_V4_BYTES) {
-    throw new RangeError("mesh-bin v4 header output is truncated");
-  }
-  const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
-  view.setUint32(0, header.version, true);
-  view.setUint32(4, header.projectionVersion, true);
-  view.setUint32(8, header.mask, true);
-  view.setUint32(12, header.stride, true);
-  view.setUint32(16, header.vertexCount, true);
-  view.setUint32(20, header.vertexBytes, true);
-  view.setUint32(24, header.indexCount, true);
-  view.setUint32(28, header.indexWidth, true);
-  view.setUint32(32, header.indexBytes, true);
-  view.setUint32(36, header.jsonBytes, true);
-  out.set(digestBytes(header.digest), 48);
-}
 function failure(sourceKey, expected, actual) {
   return {
     code: "mesh-bin-payload-invalid",
@@ -1596,44 +973,7 @@ function buildMeshAsset(pod, guid, influences, materialContext = {}) {
     }
   };
 }
-function materialBindings(pod) {
-  if (pod.textureBindings !== void 0) return pod.textureBindings;
-  const bindings = [];
-  const legacy = [
-    ["baseColorTexture", pod.baseColorTextureIndex],
-    ["metallicRoughnessTexture", pod.metallicRoughnessTextureIndex],
-    ["normalTexture", pod.normalTextureIndex],
-    ["specularTintTexture", pod.specularTintTextureIndex],
-    ["emissiveTexture", pod.emissiveTextureIndex],
-    ["occlusionTexture", pod.occlusionTextureIndex]
-  ];
-  for (const [slot, textureIndex] of legacy) {
-    if (textureIndex !== void 0) bindings.push({ slot, textureIndex });
-  }
-  return bindings;
-}
-function buildMaterialAsset(pod, guid, skinned = false, textureGuidByIndex = /* @__PURE__ */ new Map()) {
-  const values = {
-    baseColor: pod.baseColorFactor,
-    metallic: pod.metallicFactor,
-    roughness: pod.roughnessFactor
-  };
-  const refs = [];
-  for (const binding of materialBindings(pod)) {
-    const textureGuid = textureGuidByIndex.get(binding.textureIndex);
-    if (textureGuid === void 0) continue;
-    const textureValue = {
-      // Runtime material loading interprets texture handles as indexes into
-      // this asset's refs[]; the GUID is carried by the corresponding edge.
-      texture: refs.length,
-      ...binding.texCoord === void 0 ? {} : { coordinates: { set: binding.texCoord } }
-    };
-    values[binding.slot] = textureValue;
-    refs.push({
-      guid: textureGuid,
-      sourceField: { componentName: "<material>", fieldName: binding.slot }
-    });
-  }
+function buildMaterialAsset(pod, guid, skinned = false) {
   const mat = {
     kind: "material",
     colorSpace: "linear",
@@ -1644,14 +984,18 @@ function buildMaterialAsset(pod, guid, skinned = false, textureGuidByIndex = /*
         renderState: { tags: { LightMode: "Forward" }, queue: 2e3 }
       }
     ],
-    values
+    values: {
+      baseColor: pod.baseColorFactor,
+      metallic: pod.metallicFactor,
+      roughness: pod.roughnessFactor
+    }
   };
   return {
     guid,
     kind: "material",
     ...pod.name !== void 0 ? { name: pod.name } : {},
     payload: mat,
-    refs,
+    refs: [],
     artifacts: {}
   };
 }
@@ -1721,29 +1065,19 @@ function buildSceneAsset(pod, guid, ctx) {
     artifacts: {}
   };
 }
-function buildTextureAsset(pod, guid, decoded) {
+function buildTextureNote(_pod, _guid) {
   return {
-    guid,
+    guid: _guid,
     kind: "texture",
-    ...pod.name !== void 0 ? { name: pod.name } : {},
-    payload: decoded.texture,
+    ..._pod.name !== void 0 ? { name: _pod.name } : {},
+    payload: {},
     refs: [],
-    artifacts: {
-      body: {
-        mediaType: decoded.mediaType?.startsWith("image/ktx2") ? decoded.mediaType : "application/x-forgeax-rgba8",
-        ...decoded.assetCodec === void 0 ? {} : { assetCodec: decoded.assetCodec },
-        bytes: decoded.bytes
-      }
-    }
+    artifacts: {}
   };
 }
 function toAssetPack(params) {
   const assets = [];
   const guidOf = makeGuidResolver(params.subAssets);
-  const textureGuidByIndex = /* @__PURE__ */ new Map();
-  for (const texture of params.subAssets) {
-    if (texture.kind === "texture") textureGuidByIndex.set(texture.sourceIndex, texture.guid);
-  }
   const materialGuidByIndex = /* @__PURE__ */ new Map();
   const materialNameByIndex = /* @__PURE__ */ new Map();
   const materialSourceKeyByIndex = /* @__PURE__ */ new Map();
@@ -1793,19 +1127,11 @@ function toAssetPack(params) {
     const mat = params.materials[i];
     if (!mat) continue;
     const guid = guidOf("material", i);
-    if (guid !== void 0) {
-      assets.push(buildMaterialAsset(mat, guid, hasSkin, textureGuidByIndex));
-    }
+    if (guid !== void 0) assets.push(buildMaterialAsset(mat, guid, hasSkin));
   }
   for (const tex of params.textures) {
     const guid = guidOf("texture", tex.sourceIndex);
-    if (guid !== void 0) {
-      const decoded = params.decodedTextures?.get(tex.sourceIndex);
-      if (decoded === void 0) {
-        throw new Error(`fbx texture ${tex.sourceIndex} was declared but not decoded`);
-      }
-      assets.push(buildTextureAsset(tex, guid, decoded));
-    }
+    if (guid !== void 0) assets.push(buildTextureNote(tex, guid));
   }
   const declaredByKind = (kind) => params.subAssets.filter((s) => s.kind === kind).slice().sort((a, b) => a.sourceIndex - b.sourceIndex).map((s) => s.guid);
   const meshGuids = declaredByKind("mesh");
@@ -1915,8 +1241,6 @@ function toAssetPack(params) {
 function sourceKeyForFbxOutput(output) {
   const kind = output.kind.trim();
   if (kind.length === 0) return void 0;
-  const explicit = output.sourceKey?.trim();
-  if (explicit !== void 0 && explicit.length > 0) return explicit;
   const name = output.name?.trim();
   return name === void 0 || name.length === 0 ? `fbx:${kind}` : `fbx:${kind}:${name}`;
 }
@@ -1936,96 +1260,18 @@ function deriveFbxSourceKeys(outputs) {
   }
   return { ok: true, keys };
 }
-function validationError(ctx, textureIndex, code, actual, hint) {
-  const diagnostic = {
-    code,
-    severity: "error",
-    sourcePath: `${ctx.source}#textures[${textureIndex}]`,
-    sourceRange: { start: 0, end: 0, line: 1, column: 1 },
-    rule: "fbx-external-texture-dependency-closure",
-    expected: "every bound FBX texture resolves to one readable supported image in the authorized scope",
-    actual,
-    hint
-  };
-  return new ImportError({
-    code: "source-validation-failed",
-    expected: diagnostic.expected,
-    hint: IMPORT_ERROR_HINTS["source-validation-failed"],
-    detail: { diagnostics: [diagnostic] }
-  });
-}
-var FBX_PARSE_DIAGNOSTIC_MAX = 256;
-var FBX_PARSE_EXPECTED = "a readable FBX source that ufbx can parse";
-function boundedErrorMessage(error) {
-  const message = error instanceof Error ? error.message : String(error);
-  return message.length <= FBX_PARSE_DIAGNOSTIC_MAX ? message : `${message.slice(0, FBX_PARSE_DIAGNOSTIC_MAX - 3)}...`;
-}
-function parseValidationError(ctx, error) {
-  const actual = boundedErrorMessage(error);
-  const diagnostic = {
-    code: "fbx-source-parse-failed",
-    severity: "error",
-    sourcePath: ctx.source,
-    sourceRange: { start: 0, end: 0, line: 1, column: 1 },
-    rule: "fbx-source-parse",
-    expected: FBX_PARSE_EXPECTED,
-    actual,
-    hint: "repair or re-export the FBX source, then retry the same importer and source path"
-  };
-  return new ImportError({
-    code: "source-validation-failed",
-    expected: FBX_PARSE_EXPECTED,
-    actual,
-    hint: IMPORT_ERROR_HINTS["source-validation-failed"],
-    detail: { diagnostics: [diagnostic] }
-  });
-}
-function importCandidates(ctx) {
-  const raw = ctx.importSettings.fbxCandidatePaths;
-  if (!Array.isArray(raw)) return [];
-  return raw.flatMap(
-    (path) => typeof path === "string" ? [{ relativePath: path }] : []
-  );
-}
-function mimeForTexture(path, bytes) {
-  const lower = path.toLowerCase();
-  if (lower.endsWith(".png") || bytes[0] === 137 && bytes[1] === 80 && bytes[2] === 78) {
-    return "image/png";
-  }
-  if (lower.endsWith(".jpg") || lower.endsWith(".jpeg") || bytes[0] === 255 && bytes[1] === 216) {
-    return "image/jpeg";
-  }
-  return "image/x-tga";
-}
-function textureColorSpace(slot) {
-  return slot === "normalTexture" || slot === "metallicRoughnessTexture" || slot === "occlusionTexture" ? "linear" : "srgb";
-}
 var fbxImporter = {
   key: "fbx",
   async import(ctx) {
     const read = await ctx.readSource();
     if (!read.ok) {
-      return {
-        ok: false,
-        error: new ImportError({
-          code: "source-read-failed",
-          expected: `readable source file at meta.source "${ctx.source}"`,
-          hint: IMPORT_ERROR_HINTS["source-read-failed"],
-          detail: {
-            source: ctx.source,
-            reason: read.error instanceof Error ? read.error.message : String(read.error)
-          }
-        })
-      };
+      const wrapper = new Error(`fbx-source-unreadable: ${ctx.source}`);
+      wrapper.cause = read.error;
+      throw wrapper;
     }
     await initFbxWasm();
-    let doc;
-    try {
-      const jsonStr = parseFbx(read.value);
-      doc = JSON.parse(jsonStr);
-    } catch (error) {
-      return { ok: false, error: parseValidationError(ctx, error) };
-    }
+    const jsonStr = parseFbx(read.value);
+    const doc = JSON.parse(jsonStr);
     const maybeError = doc;
     if (maybeError.error?.code === "fbx-mesh-type-unsupported") {
       const e = fbxErr("fbx-mesh-type-unsupported", {
@@ -2057,101 +1303,6 @@ var fbxImporter = {
       throw wrapper;
     }
     const animationClips = parseAnimationClips(doc);
-    const textureSlots = /* @__PURE__ */ new Map();
-    for (const material of materials) {
-      for (const binding of material.textureBindings ?? []) {
-        const prior = textureSlots.get(binding.textureIndex);
-        const colorSpace = textureColorSpace(binding.slot);
-        if (prior !== void 0 && prior !== colorSpace) {
-          return {
-            ok: false,
-            error: validationError(
-              ctx,
-              binding.textureIndex,
-              "fbx-texture-color-space-conflict",
-              `texture ${binding.textureIndex} is used as both ${prior} and ${colorSpace}`,
-              "split the source texture or author one color-space semantic per FBX texture"
-            )
-          };
-        }
-        textureSlots.set(binding.textureIndex, colorSpace);
-      }
-    }
-    const decodedTextures = /* @__PURE__ */ new Map();
-    for (const texture of textures) {
-      const guidDeclared = ctx.subAssets.some(
-        (subAsset) => subAsset.kind === "texture" && subAsset.sourceIndex === texture.sourceIndex
-      );
-      if (!guidDeclared) continue;
-      let bytes;
-      let sourcePath = texture.filePath;
-      if (texture.embeddedBytes !== void 0 && texture.embeddedBytes.byteLength > 0) {
-        bytes = texture.embeddedBytes;
-        sourcePath = texture.relativeFilePath ?? texture.filePath;
-      } else {
-        if (texture.type !== void 0 && texture.type !== "file") {
-          return {
-            ok: false,
-            error: validationError(
-              ctx,
-              texture.sourceIndex,
-              "fbx-material-texture-slot-unsupported",
-              `texture type ${texture.type} is not a single file texture`,
-              "flatten layered/procedural FBX textures to a file texture before importing"
-            )
-          };
-        }
-        const resolution = resolveFbxTexturePath(
-          ctx.source,
-          {
-            ...texture.relativeFilePath === void 0 ? {} : { declaredRelativePath: texture.relativeFilePath },
-            ...texture.filePath.length === 0 ? {} : { declaredFilename: texture.filePath },
-            ...texture.absoluteFilePath === void 0 ? {} : { declaredAbsolutePath: texture.absoluteFilePath }
-          },
-          importCandidates(ctx)
-        );
-        if (!resolution.ok) {
-          return {
-            ok: false,
-            error: validationError(
-              ctx,
-              texture.sourceIndex,
-              resolution.code,
-              `${resolution.requestedPath}; candidates=${resolution.candidates.join(", ") || "<none>"}`,
-              resolution.code === "fbx-external-texture-ambiguous" ? "select a folder whose dependency path is unique; first-match guessing is disabled" : "select the containing folder so the FBX and its referenced texture are in the authorized candidate scope"
-            )
-          };
-        }
-        const read2 = await ctx.readSibling(resolution.readUri);
-        if (!read2.ok) return read2;
-        bytes = read2.value;
-        sourcePath = resolution.relativePath;
-      }
-      const slot = [...textureSlots.entries()].find(([index]) => index === texture.sourceIndex)?.[1] ?? "srgb";
-      const decoded = await ctx.decodeImage(bytes, mimeForTexture(sourcePath, bytes), {
-        ...ctx.importSettings,
-        colorSpace: slot
-      });
-      if (!decoded.ok) {
-        const reason = decoded.error.code === "image-decode-failed" ? decoded.error.detail.reason : `${decoded.error.code}: ${JSON.stringify(decoded.error.detail)}`;
-        return {
-          ok: false,
-          error: validationError(
-            ctx,
-            texture.sourceIndex,
-            "fbx-external-texture-decode-failed",
-            `${sourcePath}: ${reason}`,
-            "repair or re-export the referenced image, then retry the FBX import"
-          )
-        };
-      }
-      decodedTextures.set(texture.sourceIndex, {
-        texture: decoded.value.texture,
-        bytes: decoded.value.bytes,
-        ...decoded.value.mediaType === void 0 ? {} : { mediaType: decoded.value.mediaType },
-        ...decoded.value.assetCodec === void 0 ? {} : { assetCodec: decoded.value.assetCodec }
-      });
-    }
     return {
       ok: true,
       value: {
@@ -2164,7 +1315,6 @@ var fbxImporter = {
           skin,
           animationClips,
           subAssets: ctx.subAssets,
-          decodedTextures,
           ...ctx.sourceOverrides === void 0 ? {} : { sourceOverrides: ctx.sourceOverrides }
         }),
         sourceDependencies: []
@@ -2173,6 +1323,106 @@ var fbxImporter = {
   }
 };
 
+// src/resolve-texture-path.ts
+function normalizeSourceRelativePath(raw) {
+  const value = raw.replaceAll("\\", "/");
+  if (value.startsWith("/") || /^[A-Za-z]:\//.test(value) || value.startsWith("//"))
+    return void 0;
+  const parts = [];
+  for (const part of value.split("/")) {
+    if (part === "" || part === ".") continue;
+    if (part === "..") {
+      if (parts.at(-1) !== void 0 && parts.at(-1) !== "..") parts.pop();
+      else parts.push("..");
+    } else {
+      parts.push(part);
+    }
+  }
+  return parts.join("/");
+}
+function requestSegments(raw) {
+  const value = raw.replaceAll("\\", "/").replace(/^[A-Za-z]:\//, "").replace(/^\/+/, "");
+  return value.split("/").filter((part) => part !== "" && part !== ".");
+}
+function uniqueMatches(paths, predicate) {
+  return [...new Set(paths.filter(predicate))];
+}
+function longestSuffixLength(request, candidate) {
+  let count = 0;
+  while (count < request.length && count < candidate.length && request[request.length - 1 - count]?.toLowerCase() === candidate[candidate.length - 1 - count]?.toLowerCase()) {
+    count++;
+  }
+  return count;
+}
+function resolveFbxTexturePath(sourcePath, request, candidates) {
+  const candidatePaths = candidates.flatMap((candidate) => {
+    const normalized = normalizeSourceRelativePath(candidate.relativePath);
+    return normalized === void 0 || normalized.length === 0 ? [] : [normalized];
+  });
+  const requestedPath = request.declaredRelativePath ?? request.declaredFilename ?? request.declaredAbsolutePath ?? "";
+  const choose = (matches, strategy) => {
+    const unique = [...new Set(matches)];
+    if (unique.length === 1) {
+      const relativePath = unique[0];
+      if (relativePath === void 0) return void 0;
+      return {
+        ok: true,
+        relativePath,
+        readUri: relativePath,
+        strategy
+      };
+    }
+    if (unique.length > 1) {
+      return {
+        ok: false,
+        code: "fbx-external-texture-ambiguous",
+        requestedPath,
+        candidates: unique
+      };
+    }
+    return void 0;
+  };
+  const relativeRequest = request.declaredRelativePath ?? request.declaredFilename;
+  if (relativeRequest !== void 0 && !/^(?:[A-Za-z]:[\\/]|[\\/])/.test(relativeRequest)) {
+    const normalizedRequest = normalizeSourceRelativePath(relativeRequest);
+    if (normalizedRequest !== void 0) {
+      const scopeExact = choose(
+        uniqueMatches(candidatePaths, (path) => path === normalizedRequest),
+        "exact"
+      );
+      if (scopeExact !== void 0) return scopeExact;
+      const scopeFolded = choose(
+        uniqueMatches(
+          candidatePaths,
+          (path) => path.toLowerCase() === normalizedRequest.toLowerCase()
+        ),
+        "case-folded"
+      );
+      if (scopeFolded !== void 0) return scopeFolded;
+    }
+  }
+  const requestedSegments = requestSegments(requestedPath);
+  if (requestedSegments.length > 0) {
+    const scored = candidatePaths.map((path) => ({
+      path,
+      score: longestSuffixLength(requestedSegments, path.split("/"))
+    }));
+    const bestScore = Math.max(0, ...scored.map((entry) => entry.score));
+    if (bestScore > 0) {
+      const best = scored.filter((entry) => entry.score === bestScore).map((entry) => entry.path);
+      const strategy = bestScore === 1 ? "basename" : "suffix";
+      const suffix = choose(best, strategy);
+      if (suffix !== void 0) return suffix;
+    }
+  }
+  return {
+    ok: false,
+    code: "fbx-external-texture-missing",
+    requestedPath,
+    candidates: candidatePaths
+  };
+}
+
 // src/index.ts
 var wasmModule = null;
 var initPromise = null;
@@ -2243,18 +1493,6 @@ function parseFbxToObject(fbxBytes) {
 function isFbxWasmReady() {
   return wasmModule !== null;
 }
-/*! Bundled license information:
-
-uuidv7/dist/index.js:
-  (**
-   * uuidv7: A JavaScript implementation of UUID version 7
-   *
-   * Copyright 2021-2026 LiosK
-   *
-   * @license Apache-2.0
-   * @packageDocumentation
-   *)
-*/
 
 export { FBX_ERROR_HINTS, deriveFbxSourceKeys, fbxErr, fbxImporter, initFbxWasm, isFbxWasmReady, parseAnimationClips, parseFbx, parseFbxToObject, parseMaterial, parseMesh, parseScene, parseSkeleton, parseSkin, parseTextures, resolveFbxTexturePath, sourceKeyForFbxOutput, toAssetPack };
 //# sourceMappingURL=index.mjs.map