@zkmake/three-audit 0.1.0 → 0.2.0

package/dist/load-nqfCU3-k.js

@@ -0,0 +1,216 @@
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import { BufferAttribute, BufferGeometry, InterleavedBuffer, InterleavedBufferAttribute } from "three";
+//#region src/node/draco.ts
+/**
+* Draco for `GLTFLoader` in Node. three's `DRACOLoader` decodes in Web Workers, which Node lacks;
+* this is its decode run in-process on `draco3dgltf` (Google's Node build of the decoder),
+* shaped like the two methods `GLTFLoader` calls on it.
+*/
+const DATA_TYPES = {
+	Float32Array: "DT_FLOAT32",
+	Int8Array: "DT_INT8",
+	Int16Array: "DT_INT16",
+	Int32Array: "DT_INT32",
+	Uint8Array: "DT_UINT8",
+	Uint16Array: "DT_UINT16",
+	Uint32Array: "DT_UINT32"
+};
+const decodeAttribute = (draco, decoder, mesh, attribute, ArrayType) => {
+	const count = mesh.num_points();
+	const itemSize = attribute.num_components();
+	const srcBytes = itemSize * ArrayType.BYTES_PER_ELEMENT;
+	const stride = Math.ceil(srcBytes / 4) * 4 / ArrayType.BYTES_PER_ELEMENT;
+	const byteLength = count * srcBytes;
+	const pointer = draco._malloc(byteLength);
+	decoder.GetAttributeDataArrayForAllPoints(mesh, attribute, draco[DATA_TYPES[ArrayType.name]], byteLength, pointer);
+	const source = new ArrayType(draco.HEAPF32.buffer, pointer, byteLength / ArrayType.BYTES_PER_ELEMENT);
+	let array;
+	if (stride === itemSize) array = source.slice();
+	else {
+		array = new ArrayType(count * stride);
+		for (let i = 0; i < count; i += 1) for (let k = 0; k < itemSize; k += 1) array[i * stride + k] = source[i * itemSize + k];
+	}
+	draco._free(pointer);
+	return stride === itemSize ? new BufferAttribute(array, itemSize) : new InterleavedBufferAttribute(new InterleavedBuffer(array, stride), itemSize, 0);
+};
+const decode = (draco, buffer, attributeIds, attributeTypes) => {
+	const decoder = new draco.Decoder();
+	const array = new Int8Array(buffer);
+	if (decoder.GetEncodedGeometryType(array) !== draco.TRIANGULAR_MESH) {
+		draco.destroy(decoder);
+		throw new Error("three-audit: Draco point clouds aren't supported");
+	}
+	const mesh = new draco.Mesh();
+	const status = decoder.DecodeArrayToMesh(array, array.byteLength, mesh);
+	if (!status.ok() || mesh.ptr === 0) {
+		draco.destroy(mesh);
+		draco.destroy(decoder);
+		throw new Error(`three-audit: Draco decoding failed: ${status.error_msg()}`);
+	}
+	const geometry = new BufferGeometry();
+	for (const [name, id] of Object.entries(attributeIds)) {
+		const ArrayType = globalThis[attributeTypes[name] ?? "Float32Array"];
+		geometry.setAttribute(name, decodeAttribute(draco, decoder, mesh, decoder.GetAttributeByUniqueId(mesh, id), ArrayType));
+	}
+	const indices = mesh.num_faces() * 3;
+	const pointer = draco._malloc(indices * 4);
+	decoder.GetTrianglesUInt32Array(mesh, indices * 4, pointer);
+	geometry.setIndex(new BufferAttribute(new Uint32Array(draco.HEAPF32.buffer, pointer, indices).slice(), 1));
+	draco._free(pointer);
+	draco.destroy(mesh);
+	draco.destroy(decoder);
+	return geometry;
+};
+/** Stands in for `DRACOLoader` in `gltfLoader.setDRACOLoader(...)`. Needs `draco3dgltf`. */
+const createNodeDracoLoader = async () => {
+	let module;
+	try {
+		module = (await import("draco3dgltf")).default;
+	} catch {
+		throw new Error("three-audit: this model is Draco-compressed; install draco3dgltf to read it (npm i -D draco3dgltf)");
+	}
+	const draco = await module.createDecoderModule({});
+	return {
+		preload() {
+			return this;
+		},
+		decodeDracoFile(buffer, callback, attributeIds, attributeTypes, _colorSpace, onError = () => {}) {
+			try {
+				callback(decode(draco, buffer, attributeIds, attributeTypes));
+			} catch (error) {
+				onError(error);
+			}
+		}
+	};
+};
+//#endregion
+//#region src/node/load.ts
+/**
+* Load a glTF model in Node for the checks: `.glb`, or `.gltf` with its buffers beside it.
+*
+* Textures are stripped before parsing: no check reads them, and decoding images needs a DOM.
+* Draco (`draco3dgltf`) and Meshopt (`meshoptimizer`) compressed geometry decode when those
+* packages are installed.
+*/
+const GLB_MAGIC = 1179937895;
+const JSON_CHUNK = 1313821514;
+const BIN_CHUNK = 5130562;
+const TEXTURE_EXTENSIONS = [
+	"KHR_texture_basisu",
+	"KHR_texture_transform",
+	"EXT_texture_webp",
+	"EXT_texture_avif"
+];
+/** Every `…Texture` reference in a material, extensions included. */
+const dropTextureRefs = (value) => {
+	if (value === null || typeof value !== "object") return;
+	for (const [key, child] of Object.entries(value)) if (key.endsWith("Texture") && child !== null && typeof child === "object" && "index" in child) delete value[key];
+	else dropTextureRefs(child);
+};
+const stripTextures = (json) => {
+	delete json.images;
+	delete json.textures;
+	delete json.samplers;
+	dropTextureRefs(json.materials);
+	for (const key of ["extensionsUsed", "extensionsRequired"]) if (Array.isArray(json[key])) json[key] = json[key].filter((name) => !TEXTURE_EXTENSIONS.includes(name));
+};
+const uses = (json, extension) => Array.isArray(json.extensionsUsed) && json.extensionsUsed.includes(extension);
+/** Split a GLB into its JSON and binary chunks. */
+const readGlb = (bytes) => {
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	let json = null;
+	let bin = null;
+	for (let offset = 12; offset < bytes.byteLength;) {
+		const length = view.getUint32(offset, true);
+		const type = view.getUint32(offset + 4, true);
+		const chunk = bytes.subarray(offset + 8, offset + 8 + length);
+		if (type === JSON_CHUNK) json = JSON.parse(new TextDecoder().decode(chunk));
+		else if (type === BIN_CHUNK) bin = chunk;
+		offset += 8 + length;
+	}
+	if (!json) throw new Error("three-audit: GLB has no JSON chunk");
+	return {
+		json,
+		bin
+	};
+};
+/** A GLB from JSON and an optional binary chunk, each padded to four bytes. */
+const writeGlb = (json, bin) => {
+	const text = new TextEncoder().encode(JSON.stringify(json));
+	const jsonLength = Math.ceil(text.byteLength / 4) * 4;
+	const binLength = bin ? Math.ceil(bin.byteLength / 4) * 4 : 0;
+	const total = 20 + jsonLength + (bin ? 8 + binLength : 0);
+	const out = new Uint8Array(total);
+	const view = new DataView(out.buffer);
+	view.setUint32(0, GLB_MAGIC, true);
+	view.setUint32(4, 2, true);
+	view.setUint32(8, total, true);
+	view.setUint32(12, jsonLength, true);
+	view.setUint32(16, JSON_CHUNK, true);
+	out.fill(32, 20, 20 + jsonLength);
+	out.set(text, 20);
+	if (bin) {
+		view.setUint32(20 + jsonLength, binLength, true);
+		view.setUint32(24 + jsonLength, BIN_CHUNK, true);
+		out.set(bin, 28 + jsonLength);
+	}
+	return out.buffer;
+};
+/** A buffer's bytes: the GLB's binary chunk, a data URI, or a file beside the model. */
+const bufferBytes = async (buffer, index, bin, directory) => {
+	if (buffer.uri === void 0) {
+		if (index !== 0 || !bin) throw new Error("three-audit: a buffer without a uri must be the GLB's binary chunk");
+		return bin;
+	}
+	if (buffer.uri.startsWith("data:")) return new Uint8Array(Buffer.from(buffer.uri.slice(buffer.uri.indexOf(",") + 1), "base64"));
+	return new Uint8Array(await readFile(resolve(directory, decodeURIComponent(buffer.uri))));
+};
+/**
+* Every buffer folded into one binary chunk, the buffer views re-pointed into it. The result is a
+* self-contained GLB, so the loader never fetches: three's `FileLoader` needs browser globals.
+*/
+const packBuffers = async (json, bin, directory) => {
+	const buffers = json.buffers ?? [];
+	const parts = await Promise.all(buffers.map((buffer, i) => bufferBytes(buffer, i, bin, directory)));
+	const offsets = [];
+	let total = 0;
+	for (const part of parts) {
+		offsets.push(total);
+		total += Math.ceil(part.byteLength / 4) * 4;
+	}
+	const packed = new Uint8Array(total);
+	parts.forEach((part, i) => packed.set(part, offsets[i]));
+	for (const view of json.bufferViews ?? []) {
+		view.byteOffset = (view.byteOffset ?? 0) + offsets[view.buffer];
+		view.buffer = 0;
+	}
+	json.buffers = parts.length > 0 ? [{ byteLength: total }] : [];
+	return parts.length > 0 ? packed : null;
+};
+/** Parse glTF bytes (GLB or JSON) into a three scene, textures stripped. */
+const parseModel = async (bytes, directory = ".") => {
+	const { json, bin } = bytes.byteLength >= 12 && new DataView(bytes.buffer, bytes.byteOffset).getUint32(0, true) === GLB_MAGIC ? readGlb(bytes) : {
+		json: JSON.parse(new TextDecoder().decode(bytes)),
+		bin: null
+	};
+	stripTextures(json);
+	const data = writeGlb(json, await packBuffers(json, bin, directory));
+	const loader = new GLTFLoader();
+	if (uses(json, "KHR_draco_mesh_compression")) loader.setDRACOLoader(await createNodeDracoLoader());
+	if (uses(json, "EXT_meshopt_compression") || uses(json, "KHR_meshopt_compression")) try {
+		const { MeshoptDecoder } = await import("meshoptimizer");
+		await MeshoptDecoder.ready;
+		loader.setMeshoptDecoder(MeshoptDecoder);
+	} catch {
+		throw new Error("three-audit: this model is Meshopt-compressed; install meshoptimizer to read it (npm i -D meshoptimizer)");
+	}
+	return (await loader.parseAsync(data, "")).scene;
+};
+/** Read and parse a `.glb` or `.gltf` file into a three scene, ready for the checks. */
+const loadModel = async (path) => parseModel(await readFile(path), dirname(path));
+//#endregion
+export { parseModel as n, createNodeDracoLoader as r, loadModel as t };
+
+//# sourceMappingURL=load-nqfCU3-k.js.map

package/dist/load-nqfCU3-k.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-nqfCU3-k.js","names":[],"sources":["../src/node/draco.ts","../src/node/load.ts"],"sourcesContent":["/**\n * Draco for `GLTFLoader` in Node. three's `DRACOLoader` decodes in Web Workers, which Node lacks;\n * this is its decode run in-process on `draco3dgltf` (Google's Node build of the decoder),\n * shaped like the two methods `GLTFLoader` calls on it.\n */\nimport {\n  BufferAttribute,\n  BufferGeometry,\n  InterleavedBuffer,\n  InterleavedBufferAttribute,\n} from \"three\";\n\ntype TypedArray =\n  | Float32Array\n  | Int8Array\n  | Int16Array\n  | Int32Array\n  | Uint8Array\n  | Uint16Array\n  | Uint32Array;\ntype TypedArrayConstructor = {\n  new (length: number): TypedArray;\n  new (buffer: ArrayBufferLike, offset: number, length: number): TypedArray;\n  BYTES_PER_ELEMENT: number;\n};\n\n/* The slice of the emscripten module this uses. */\ntype DracoAttribute = { num_components(): number };\ntype DracoMesh = { num_faces(): number; num_points(): number; ptr: number };\ntype DracoDecoder = {\n  GetEncodedGeometryType(array: Int8Array): number;\n  DecodeArrayToMesh(\n    array: Int8Array,\n    length: number,\n    mesh: DracoMesh,\n  ): { ok(): boolean; error_msg(): string };\n  GetAttributeByUniqueId(mesh: DracoMesh, id: number): DracoAttribute;\n  GetAttributeDataArrayForAllPoints(\n    mesh: DracoMesh,\n    attribute: DracoAttribute,\n    type: number,\n    byteLength: number,\n    pointer: number,\n  ): boolean;\n  GetTrianglesUInt32Array(mesh: DracoMesh, byteLength: number, pointer: number): boolean;\n};\ntype DracoModule = {\n  Decoder: new () => DracoDecoder;\n  Mesh: new () => DracoMesh;\n  TRIANGULAR_MESH: number;\n  HEAPF32: Float32Array;\n  _malloc(bytes: number): number;\n  _free(pointer: number): void;\n  destroy(object: unknown): void;\n  [type: `DT_${string}`]: number;\n};\n\nconst DATA_TYPES: Record<string, string> = {\n  Float32Array: \"DT_FLOAT32\",\n  Int8Array: \"DT_INT8\",\n  Int16Array: \"DT_INT16\",\n  Int32Array: \"DT_INT32\",\n  Uint8Array: \"DT_UINT8\",\n  Uint16Array: \"DT_UINT16\",\n  Uint32Array: \"DT_UINT32\",\n};\n\nconst decodeAttribute = (\n  draco: DracoModule,\n  decoder: DracoDecoder,\n  mesh: DracoMesh,\n  attribute: DracoAttribute,\n  ArrayType: TypedArrayConstructor,\n) => {\n  const count = mesh.num_points();\n  const itemSize = attribute.num_components();\n  // glTF aligns every vertex to 4 bytes; a narrower one is read interleaved.\n  const srcBytes = itemSize * ArrayType.BYTES_PER_ELEMENT;\n  const stride = (Math.ceil(srcBytes / 4) * 4) / ArrayType.BYTES_PER_ELEMENT;\n  const byteLength = count * srcBytes;\n  const pointer = draco._malloc(byteLength);\n\n  decoder.GetAttributeDataArrayForAllPoints(\n    mesh,\n    attribute,\n    draco[DATA_TYPES[ArrayType.name] as `DT_${string}`]!,\n    byteLength,\n    pointer,\n  );\n\n  const source = new ArrayType(\n    draco.HEAPF32.buffer,\n    pointer,\n    byteLength / ArrayType.BYTES_PER_ELEMENT,\n  );\n  let array: TypedArray;\n\n  if (stride === itemSize) {\n    array = source.slice();\n  } else {\n    array = new ArrayType(count * stride);\n\n    for (let i = 0; i < count; i += 1) {\n      for (let k = 0; k < itemSize; k += 1) {\n        array[i * stride + k] = source[i * itemSize + k]!;\n      }\n    }\n  }\n\n  draco._free(pointer);\n\n  return stride === itemSize\n    ? new BufferAttribute(array, itemSize)\n    : new InterleavedBufferAttribute(new InterleavedBuffer(array, stride), itemSize, 0);\n};\n\nconst decode = (\n  draco: DracoModule,\n  buffer: ArrayBuffer,\n  attributeIds: Record<string, number>,\n  attributeTypes: Record<string, string>,\n) => {\n  const decoder = new draco.Decoder();\n  const array = new Int8Array(buffer);\n\n  if (decoder.GetEncodedGeometryType(array) !== draco.TRIANGULAR_MESH) {\n    draco.destroy(decoder);\n    throw new Error(\"three-audit: Draco point clouds aren't supported\");\n  }\n\n  const mesh = new draco.Mesh();\n  const status = decoder.DecodeArrayToMesh(array, array.byteLength, mesh);\n\n  if (!status.ok() || mesh.ptr === 0) {\n    draco.destroy(mesh);\n    draco.destroy(decoder);\n    throw new Error(`three-audit: Draco decoding failed: ${status.error_msg()}`);\n  }\n\n  const geometry = new BufferGeometry();\n\n  for (const [name, id] of Object.entries(attributeIds)) {\n    const ArrayType = (globalThis as unknown as Record<string, TypedArrayConstructor>)[\n      attributeTypes[name] ?? \"Float32Array\"\n    ]!;\n\n    geometry.setAttribute(\n      name,\n      decodeAttribute(draco, decoder, mesh, decoder.GetAttributeByUniqueId(mesh, id), ArrayType),\n    );\n  }\n\n  const indices = mesh.num_faces() * 3;\n  const pointer = draco._malloc(indices * 4);\n\n  decoder.GetTrianglesUInt32Array(mesh, indices * 4, pointer);\n  geometry.setIndex(\n    new BufferAttribute(new Uint32Array(draco.HEAPF32.buffer, pointer, indices).slice(), 1),\n  );\n  draco._free(pointer);\n  draco.destroy(mesh);\n  draco.destroy(decoder);\n\n  return geometry;\n};\n\n/** Stands in for `DRACOLoader` in `gltfLoader.setDRACOLoader(...)`. Needs `draco3dgltf`. */\nexport const createNodeDracoLoader = async () => {\n  let module: { createDecoderModule(options: object): Promise<DracoModule> };\n\n  try {\n    module = ((await import(\"draco3dgltf\")) as { default: typeof module }).default;\n  } catch {\n    throw new Error(\n      \"three-audit: this model is Draco-compressed; install draco3dgltf to read it (npm i -D draco3dgltf)\",\n    );\n  }\n\n  const draco = await module.createDecoderModule({});\n\n  return {\n    preload() {\n      return this;\n    },\n    decodeDracoFile(\n      buffer: ArrayBuffer,\n      callback: (geometry: BufferGeometry) => void,\n      attributeIds: Record<string, number>,\n      attributeTypes: Record<string, string>,\n      _colorSpace?: string,\n      onError: (error: unknown) => void = () => {},\n    ) {\n      try {\n        callback(decode(draco, buffer, attributeIds, attributeTypes));\n      } catch (error) {\n        onError(error);\n      }\n    },\n  };\n};\n","/**\n * Load a glTF model in Node for the checks: `.glb`, or `.gltf` with its buffers beside it.\n *\n * Textures are stripped before parsing: no check reads them, and decoding images needs a DOM.\n * Draco (`draco3dgltf`) and Meshopt (`meshoptimizer`) compressed geometry decode when those\n * packages are installed.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport type { Group } from \"three\";\nimport { GLTFLoader } from \"three/addons/loaders/GLTFLoader.js\";\n\nimport { createNodeDracoLoader } from \"./draco.ts\";\n\ntype Json = Record<string, unknown>;\n\nconst GLB_MAGIC = 0x46546c67;\nconst JSON_CHUNK = 0x4e4f534a;\nconst BIN_CHUNK = 0x004e4942;\nconst TEXTURE_EXTENSIONS = [\n  \"KHR_texture_basisu\",\n  \"KHR_texture_transform\",\n  \"EXT_texture_webp\",\n  \"EXT_texture_avif\",\n];\n\n/** Every `…Texture` reference in a material, extensions included. */\nconst dropTextureRefs = (value: unknown) => {\n  if (value === null || typeof value !== \"object\") {\n    return;\n  }\n\n  for (const [key, child] of Object.entries(value)) {\n    if (\n      key.endsWith(\"Texture\") &&\n      child !== null &&\n      typeof child === \"object\" &&\n      \"index\" in child\n    ) {\n      delete (value as Json)[key];\n    } else {\n      dropTextureRefs(child);\n    }\n  }\n};\n\nconst stripTextures = (json: Json) => {\n  delete json.images;\n  delete json.textures;\n  delete json.samplers;\n  dropTextureRefs(json.materials);\n\n  for (const key of [\"extensionsUsed\", \"extensionsRequired\"]) {\n    if (Array.isArray(json[key])) {\n      json[key] = (json[key] as string[]).filter((name) => !TEXTURE_EXTENSIONS.includes(name));\n    }\n  }\n};\n\nconst uses = (json: Json, extension: string) =>\n  Array.isArray(json.extensionsUsed) && (json.extensionsUsed as string[]).includes(extension);\n\n/** Split a GLB into its JSON and binary chunks. */\nconst readGlb = (bytes: Uint8Array) => {\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  let json: Json | null = null;\n  let bin: Uint8Array | null = null;\n\n  for (let offset = 12; offset < bytes.byteLength;) {\n    const length = view.getUint32(offset, true);\n    const type = view.getUint32(offset + 4, true);\n    const chunk = bytes.subarray(offset + 8, offset + 8 + length);\n\n    if (type === JSON_CHUNK) {\n      json = JSON.parse(new TextDecoder().decode(chunk)) as Json;\n    } else if (type === BIN_CHUNK) {\n      bin = chunk;\n    }\n\n    offset += 8 + length;\n  }\n\n  if (!json) {\n    throw new Error(\"three-audit: GLB has no JSON chunk\");\n  }\n\n  return { json, bin };\n};\n\n/** A GLB from JSON and an optional binary chunk, each padded to four bytes. */\nconst writeGlb = (json: Json, bin: Uint8Array | null) => {\n  const text = new TextEncoder().encode(JSON.stringify(json));\n  const jsonLength = Math.ceil(text.byteLength / 4) * 4;\n  const binLength = bin ? Math.ceil(bin.byteLength / 4) * 4 : 0;\n  const total = 12 + 8 + jsonLength + (bin ? 8 + binLength : 0);\n  const out = new Uint8Array(total);\n  const view = new DataView(out.buffer);\n\n  view.setUint32(0, GLB_MAGIC, true);\n  view.setUint32(4, 2, true);\n  view.setUint32(8, total, true);\n  view.setUint32(12, jsonLength, true);\n  view.setUint32(16, JSON_CHUNK, true);\n  out.fill(0x20, 20, 20 + jsonLength);\n  out.set(text, 20);\n\n  if (bin) {\n    view.setUint32(20 + jsonLength, binLength, true);\n    view.setUint32(24 + jsonLength, BIN_CHUNK, true);\n    out.set(bin, 28 + jsonLength);\n  }\n\n  return out.buffer;\n};\n\n/** A buffer's bytes: the GLB's binary chunk, a data URI, or a file beside the model. */\nconst bufferBytes = async (\n  buffer: { uri?: string },\n  index: number,\n  bin: Uint8Array | null,\n  directory: string,\n) => {\n  if (buffer.uri === undefined) {\n    if (index !== 0 || !bin) {\n      throw new Error(\"three-audit: a buffer without a uri must be the GLB's binary chunk\");\n    }\n\n    return bin;\n  }\n\n  if (buffer.uri.startsWith(\"data:\")) {\n    return new Uint8Array(Buffer.from(buffer.uri.slice(buffer.uri.indexOf(\",\") + 1), \"base64\"));\n  }\n\n  return new Uint8Array(await readFile(resolve(directory, decodeURIComponent(buffer.uri))));\n};\n\n/**\n * Every buffer folded into one binary chunk, the buffer views re-pointed into it. The result is a\n * self-contained GLB, so the loader never fetches: three's `FileLoader` needs browser globals.\n */\nconst packBuffers = async (json: Json, bin: Uint8Array | null, directory: string) => {\n  const buffers = (json.buffers ?? []) as { uri?: string }[];\n  const parts = await Promise.all(\n    buffers.map((buffer, i) => bufferBytes(buffer, i, bin, directory)),\n  );\n  const offsets: number[] = [];\n  let total = 0;\n\n  for (const part of parts) {\n    offsets.push(total);\n    total += Math.ceil(part.byteLength / 4) * 4;\n  }\n\n  const packed = new Uint8Array(total);\n\n  parts.forEach((part, i) => packed.set(part, offsets[i]));\n\n  for (const view of (json.bufferViews ?? []) as { buffer: number; byteOffset?: number }[]) {\n    view.byteOffset = (view.byteOffset ?? 0) + offsets[view.buffer]!;\n    view.buffer = 0;\n  }\n\n  json.buffers = parts.length > 0 ? [{ byteLength: total }] : [];\n\n  return parts.length > 0 ? packed : null;\n};\n\n/** Parse glTF bytes (GLB or JSON) into a three scene, textures stripped. */\nexport const parseModel = async (bytes: Uint8Array, directory = \".\"): Promise<Group> => {\n  const isGlb =\n    bytes.byteLength >= 12 &&\n    new DataView(bytes.buffer, bytes.byteOffset).getUint32(0, true) === GLB_MAGIC;\n  const { json, bin } = isGlb\n    ? readGlb(bytes)\n    : { json: JSON.parse(new TextDecoder().decode(bytes)) as Json, bin: null };\n\n  stripTextures(json);\n\n  const data = writeGlb(json, await packBuffers(json, bin, directory));\n  const loader = new GLTFLoader();\n\n  if (uses(json, \"KHR_draco_mesh_compression\")) {\n    loader.setDRACOLoader((await createNodeDracoLoader()) as never);\n  }\n\n  if (uses(json, \"EXT_meshopt_compression\") || uses(json, \"KHR_meshopt_compression\")) {\n    try {\n      const { MeshoptDecoder } = await import(\"meshoptimizer\");\n\n      await MeshoptDecoder.ready;\n      loader.setMeshoptDecoder(MeshoptDecoder);\n    } catch {\n      throw new Error(\n        \"three-audit: this model is Meshopt-compressed; install meshoptimizer to read it (npm i -D meshoptimizer)\",\n      );\n    }\n  }\n\n  const gltf = await loader.parseAsync(data, \"\");\n\n  return gltf.scene;\n};\n\n/** Read and parse a `.glb` or `.gltf` file into a three scene, ready for the checks. */\nexport const loadModel = async (path: string): Promise<Group> =>\n  parseModel(await readFile(path), dirname(path));\n"],"mappings":"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"}

package/dist/node.d.ts

@@ -0,0 +1,15 @@
+import { BufferGeometry, Group } from "three";
+//#region src/node/load.d.ts
+/** Parse glTF bytes (GLB or JSON) into a three scene, textures stripped. */
+export declare const parseModel: (bytes: Uint8Array, directory?: string) => Promise<Group>;
+/** Read and parse a `.glb` or `.gltf` file into a three scene, ready for the checks. */
+export declare const loadModel: (path: string) => Promise<Group>;
+//#endregion
+//#region src/node/draco.d.ts
+/** Stands in for `DRACOLoader` in `gltfLoader.setDRACOLoader(...)`. Needs `draco3dgltf`. */
+export declare const createNodeDracoLoader: () => Promise<{
+  preload(): /*elided*/ any;
+  decodeDracoFile(buffer: ArrayBuffer, callback: (geometry: BufferGeometry) => void, attributeIds: Record<string, number>, attributeTypes: Record<string, string>, _colorSpace?: string, onError?: (error: unknown) => void): void;
+}>;
+//#endregion
+//# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -0,0 +1,2 @@
+import { n as parseModel, r as createNodeDracoLoader, t as loadModel } from "./load-nqfCU3-k.js";
+export { createNodeDracoLoader, loadModel, parseModel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkmake/three-audit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Scene checks for three.js: triangle counts, cost census, NaN normals, z-fighting, black frames and a one-frame draw-call ledger. Zero dependencies.",
   "keywords": [
     "audit",
@@ -22,6 +22,9 @@
     "url": "git+https://github.com/zkmake/three-kit.git",
     "directory": "packages/three-audit"
   },
+  "bin": {
+    "three-audit": "./dist/cli.js"
+  },
   "files": [
     "dist",
     "README.md",
@@ -31,6 +34,7 @@
   "sideEffects": false,
   "exports": {
     ".": "./dist/index.js",
+    "./node": "./dist/node.js",
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -46,7 +50,10 @@
   },
   "devDependencies": {
     "@arethetypeswrong/core": "catalog:",
+    "@types/node": "catalog:",
     "@types/three": "catalog:",
+    "draco3dgltf": "catalog:",
+    "meshoptimizer": "catalog:",
     "publint": "catalog:",
     "three": "catalog:",
     "tsdown": "catalog:",
@@ -54,8 +61,18 @@
     "vitest": "catalog:"
   },
   "peerDependencies": {
+    "draco3dgltf": ">=1.5",
+    "meshoptimizer": ">=0.21",
     "three": ">=0.160"
   },
+  "peerDependenciesMeta": {
+    "draco3dgltf": {
+      "optional": true
+    },
+    "meshoptimizer": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=20.19"
   }