creative-pipeline-mcp 0.2.14-alpha.0

package/examples/premiere-qc-e2e.mjs

@@ -0,0 +1,77 @@
+import { spawnSync } from "node:child_process";
+import { mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+
+const root = process.cwd();
+const artifacts = resolve(root, "artifacts", "examples", "premiere-e2e");
+mkdirSync(artifacts, { recursive: true });
+
+const source = resolve(artifacts, "source.mp4");
+run("ffmpeg", [
+  "-hide_banner",
+  "-y",
+  "-f",
+  "lavfi",
+  "-i",
+  "testsrc=duration=1:size=320x240:rate=30",
+  "-f",
+  "lavfi",
+  "-i",
+  "sine=frequency=880:duration=1",
+  "-shortest",
+  source
+]);
+
+const roughCut = callTool("premiere.make_rough_cut", {
+  path: source,
+  brief: "One-second generated QC sample",
+  targetDuration: 1
+});
+callTool("premiere.run_delivery_qc", {
+  path: source,
+  targetWidth: 320,
+  targetHeight: 240,
+  maxDuration: 2,
+  referencePath: source,
+  targetMinVmaf: 99
+});
+callTool("premiere.generate_thumbnail_plan", { path: source, count: 1 });
+
+const otioPath = roughCut.structuredContent.artifacts[0];
+callTool(
+  "premiere.build_timeline_from_otio",
+  { otioPath, sequenceName: "Creative Pipeline E2E" },
+  { CREATIVE_MCP_PERMISSION: "project_write" }
+);
+callTool("premiere.read_cep_status", {});
+
+function callTool(name, args, extraEnv = {}) {
+  const request = JSON.stringify({
+    jsonrpc: "2.0",
+    id: 1,
+    method: "tools/call",
+    params: { name, arguments: args }
+  });
+  const result = spawnSync("node", ["packages/premiere-pro-mcp/dist/server.js"], {
+    cwd: root,
+    input: `${request}\n`,
+    encoding: "utf8",
+    env: { ...process.env, ...extraEnv }
+  });
+  if (result.status !== 0) {
+    throw new Error(result.stderr || `Tool failed: ${name}`);
+  }
+  process.stdout.write(result.stdout);
+  const response = JSON.parse(result.stdout);
+  if (!response.result?.structuredContent?.ok && name !== "premiere.read_cep_status") {
+    throw new Error(`Tool returned not ok: ${name}`);
+  }
+  return response.result;
+}
+
+function run(command, args) {
+  const result = spawnSync(command, args, { cwd: root, encoding: "utf8" });
+  if (result.status !== 0) {
+    throw new Error(result.stderr || `${command} failed`);
+  }
+}

package/examples/sample-tool-call.json

@@ -0,0 +1,2 @@
+{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
+

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "creative-pipeline-mcp",
+  "version": "0.2.14-alpha.0",
+  "private": false,
+  "description": "QC-first MCP pipeline for Blender assets and Premiere media workflows.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taiyuhiga/creative-pipeline-mcp.git"
+  },
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
+  "files": [
+    "packages/*/dist/**",
+    "packages/*/src/**",
+    "packages/*/package.json",
+    "packages/premiere-cep-panel/CSXS",
+    "packages/premiere-cep-panel/index.html",
+    "packages/premiere-cep-panel/js",
+    "packages/premiere-cep-panel/jsx",
+    "packages/premiere-cep-panel/README.md",
+    "docs",
+    "examples",
+    "scripts",
+    "third_party_licenses",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "SECURITY.md"
+  ],
+  "bin": {
+    "creative-mcp-core": "packages/core/dist/server.js",
+    "blender-pro-mcp": "packages/blender-pro-mcp/dist/server.js",
+    "premiere-pro-mcp": "packages/premiere-pro-mcp/dist/server.js",
+    "creative-pipeline-director": "packages/director-agent/dist/server.js",
+    "creative-mcp-dashboard": "packages/dashboard/dist/server.js"
+  },
+  "exports": {
+    "./core": "./packages/core/dist/index.js",
+    "./blender": "./packages/blender-pro-mcp/dist/index.js",
+    "./premiere": "./packages/premiere-pro-mcp/dist/index.js",
+    "./director": "./packages/director-agent/dist/index.js",
+    "./blender-gpl-adapters": "./packages/blender-gpl-adapters/dist/index.js",
+    "./premiere-windows-adapter": "./packages/premiere-windows-adapter/dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -b packages/core packages/blender-pro-mcp packages/premiere-pro-mcp packages/director-agent packages/blender-gpl-adapters packages/premiere-windows-adapter packages/dashboard",
+    "clean": "tsc -b --clean packages/core packages/blender-pro-mcp packages/premiere-pro-mcp packages/director-agent packages/blender-gpl-adapters packages/premiere-windows-adapter packages/dashboard && rm -rf artifacts",
+    "test": "npm run build && node --test tests/*.mjs",
+    "prepack": "npm run build",
+    "check:adapters": "node scripts/check-adapters.mjs",
+    "release:assets": "node scripts/release-assets.mjs",
+    "blender:bridge-worker": "node scripts/blender-bridge-worker.mjs",
+    "simulate:premiere-cep": "node scripts/simulate-premiere-cep.mjs",
+    "package:premiere-cep": "node scripts/package-premiere-cep.mjs",
+    "install:premiere-cep": "node scripts/install-premiere-cep.mjs",
+    "uninstall:premiere-cep": "node scripts/install-premiere-cep.mjs --uninstall",
+    "start:core": "node packages/core/dist/server.js",
+    "start:blender": "node packages/blender-pro-mcp/dist/server.js",
+    "start:premiere": "node packages/premiere-pro-mcp/dist/server.js",
+    "start:director": "node packages/director-agent/dist/server.js",
+    "start:dashboard": "node packages/dashboard/dist/server.js"
+  },
+  "dependencies": {
+    "@gltf-transform/cli": "4.3.0",
+    "ajv": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/packages/blender-gpl-adapters/LICENSE

@@ -0,0 +1,6 @@
+GPL-3.0-or-later adapter package.
+
+This package intentionally contains only adapter manifests and process-boundary wrappers.
+Install and run GPL tools such as BlenderProc, BlenderGIS, and Sverchok separately, then
+connect them through command-line, socket, or Blender addon boundaries.
+

package/packages/blender-gpl-adapters/dist/index.d.ts

@@ -0,0 +1,10 @@
+export interface ExternalGplAdapterJob {
+    adapter: "blenderproc" | "blendergis" | "sverchok";
+    command: string;
+    args: string[];
+    inputJson: Record<string, unknown>;
+    license: "GPL-3.0-or-later";
+}
+export declare function createBlenderProcJob(inputJson: Record<string, unknown>): ExternalGplAdapterJob;
+export declare function createBlenderGisJob(inputJson: Record<string, unknown>): ExternalGplAdapterJob;
+export declare function createSverchokJob(inputJson: Record<string, unknown>): ExternalGplAdapterJob;

package/packages/blender-gpl-adapters/dist/index.js

@@ -0,0 +1,28 @@
+export function createBlenderProcJob(inputJson) {
+    return {
+        adapter: "blenderproc",
+        command: "blenderproc",
+        args: ["run", "--custom-blender-path", "${BLENDER_PATH}", "${SCRIPT_PATH}"],
+        inputJson,
+        license: "GPL-3.0-or-later"
+    };
+}
+export function createBlenderGisJob(inputJson) {
+    return {
+        adapter: "blendergis",
+        command: "blender",
+        args: ["--background", "--python", "${BLENDERGIS_BRIDGE_SCRIPT}"],
+        inputJson,
+        license: "GPL-3.0-or-later"
+    };
+}
+export function createSverchokJob(inputJson) {
+    return {
+        adapter: "sverchok",
+        command: "blender",
+        args: ["--background", "--python", "${SVERCHOK_BRIDGE_SCRIPT}"],
+        inputJson,
+        license: "GPL-3.0-or-later"
+    };
+}
+//# sourceMappingURL=index.js.map

package/packages/blender-gpl-adapters/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,oBAAoB,CAAC,SAAkC;IACrE,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,CAAC,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,CAAC;QAC3E,SAAS;QACT,OAAO,EAAE,kBAAkB;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAkC;IACpE,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,6BAA6B,CAAC;QACjE,SAAS;QACT,OAAO,EAAE,kBAAkB;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAkC;IAClE,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,2BAA2B,CAAC;QAC/D,SAAS;QACT,OAAO,EAAE,kBAAkB;KAC5B,CAAC;AACJ,CAAC"}

package/packages/blender-gpl-adapters/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@creative-pipeline-mcp/blender-gpl-adapters",
+  "version": "0.2.14-alpha.0",
+  "type": "module",
+  "license": "GPL-3.0-or-later",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": ["dist", "src", "LICENSE"],
+  "dependencies": {
+    "@creative-pipeline-mcp/core": "0.2.14-alpha.0"
+  }
+}

package/packages/blender-gpl-adapters/src/index.ts

@@ -0,0 +1,38 @@
+export interface ExternalGplAdapterJob {
+  adapter: "blenderproc" | "blendergis" | "sverchok";
+  command: string;
+  args: string[];
+  inputJson: Record<string, unknown>;
+  license: "GPL-3.0-or-later";
+}
+
+export function createBlenderProcJob(inputJson: Record<string, unknown>): ExternalGplAdapterJob {
+  return {
+    adapter: "blenderproc",
+    command: "blenderproc",
+    args: ["run", "--custom-blender-path", "${BLENDER_PATH}", "${SCRIPT_PATH}"],
+    inputJson,
+    license: "GPL-3.0-or-later"
+  };
+}
+
+export function createBlenderGisJob(inputJson: Record<string, unknown>): ExternalGplAdapterJob {
+  return {
+    adapter: "blendergis",
+    command: "blender",
+    args: ["--background", "--python", "${BLENDERGIS_BRIDGE_SCRIPT}"],
+    inputJson,
+    license: "GPL-3.0-or-later"
+  };
+}
+
+export function createSverchokJob(inputJson: Record<string, unknown>): ExternalGplAdapterJob {
+  return {
+    adapter: "sverchok",
+    command: "blender",
+    args: ["--background", "--python", "${SVERCHOK_BRIDGE_SCRIPT}"],
+    inputJson,
+    license: "GPL-3.0-or-later"
+  };
+}
+

package/packages/blender-pro-mcp/dist/adapters/blenderBridge.d.ts

@@ -0,0 +1,34 @@
+export interface BlenderBridgeCommand {
+    id: string;
+    type: "create_scene" | "create_asset" | "modify_asset" | "apply_material" | "run_safe_script";
+    payload: Record<string, unknown>;
+    createdAt: string;
+}
+export interface BlenderBridgeStatus {
+    schema: "creative.pipeline.blender.status.v1";
+    commandId?: string | null;
+    commandType: BlenderBridgeCommand["type"] | "unknown";
+    status: "success" | "accepted" | "error" | string;
+    message: string;
+    details: Record<string, unknown>;
+    command?: BlenderBridgeCommand;
+    processedAt?: string;
+    finishedAt?: string;
+}
+export declare function enqueueBlenderBridgeCommand(type: BlenderBridgeCommand["type"], payload: Record<string, unknown>): Promise<{
+    command: BlenderBridgeCommand;
+    path: string;
+}>;
+export declare function listBlenderBridgeStatuses(): Promise<Array<{
+    id: string;
+    path: string;
+    status: BlenderBridgeStatus;
+}>>;
+export declare function findBlenderBridgeStatus(criteria: {
+    commandId?: string;
+    commandType?: BlenderBridgeCommand["type"];
+}): Promise<{
+    id: string;
+    path: string;
+    status: BlenderBridgeStatus;
+} | undefined>;

package/packages/blender-pro-mcp/dist/adapters/blenderBridge.js

@@ -0,0 +1,79 @@
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+export async function enqueueBlenderBridgeCommand(type, payload) {
+    const queueDir = resolve(process.env.CREATIVE_MCP_BLENDER_IPC_DIR ?? "artifacts/blender/bridge_queue");
+    await mkdir(queueDir, { recursive: true });
+    const command = {
+        id: `${Date.now()}-${Math.random().toString(16).slice(2)}`,
+        type,
+        payload,
+        createdAt: new Date().toISOString()
+    };
+    const path = join(queueDir, `${command.id}.json`);
+    await writeFile(path, `${JSON.stringify(command, null, 2)}\n`, "utf8");
+    return { command, path };
+}
+export async function listBlenderBridgeStatuses() {
+    const statusDir = resolve(process.env.CREATIVE_MCP_BLENDER_STATUS_DIR ?? "artifacts/blender/bridge_status");
+    let entries;
+    try {
+        entries = await readdir(statusDir);
+    }
+    catch {
+        return [];
+    }
+    const statuses = [];
+    for (const entry of entries.filter((file) => file.endsWith(".json"))) {
+        const path = join(statusDir, entry);
+        try {
+            statuses.push({ id: entry, path, status: normalizeStatus(JSON.parse(await readFile(path, "utf8"))) });
+        }
+        catch {
+            statuses.push({
+                id: entry,
+                path,
+                status: {
+                    schema: "creative.pipeline.blender.status.v1",
+                    commandType: "unknown",
+                    status: "error",
+                    message: "unreadable status file",
+                    details: { unreadable: true }
+                }
+            });
+        }
+    }
+    return statuses;
+}
+export async function findBlenderBridgeStatus(criteria) {
+    const statuses = await listBlenderBridgeStatuses();
+    return statuses.find((entry) => {
+        const commandId = entry.status.commandId ?? entry.status.command?.id;
+        return (!criteria.commandId || commandId === criteria.commandId)
+            && (!criteria.commandType || entry.status.commandType === criteria.commandType);
+    });
+}
+function normalizeStatus(value) {
+    if (isStatus(value)) {
+        return value;
+    }
+    const legacy = value && typeof value === "object" ? value : {};
+    return {
+        schema: "creative.pipeline.blender.status.v1",
+        commandType: "unknown",
+        status: typeof legacy.status === "string" ? legacy.status : "accepted",
+        message: typeof legacy.message === "string" ? legacy.message : "legacy Blender bridge status",
+        details: legacy
+    };
+}
+function isStatus(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    return candidate.schema === "creative.pipeline.blender.status.v1"
+        && typeof candidate.commandType === "string"
+        && typeof candidate.status === "string"
+        && typeof candidate.message === "string"
+        && typeof candidate.details === "object";
+}
+//# sourceMappingURL=blenderBridge.js.map

package/packages/blender-pro-mcp/dist/adapters/blenderBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blenderBridge.js","sourceRoot":"","sources":["../../src/adapters/blenderBridge.ts"],"names":[],"mappings":"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"}

package/packages/blender-pro-mcp/dist/adapters/cli.d.ts

@@ -0,0 +1,11 @@
+export interface CliResult {
+    available: boolean;
+    command: string;
+    stdout?: string;
+    stderr?: string;
+    error?: string;
+}
+export declare function commandExists(command: string): Promise<boolean>;
+export declare function optimizeWithCli(source: string, target: string): Promise<CliResult>;
+export declare function renderWithHeadlessBlender(source: string, outputPng: string): Promise<CliResult>;
+export declare function runHeadlessBlenderScript(script: string): Promise<CliResult>;

package/packages/blender-pro-mcp/dist/adapters/cli.js

@@ -0,0 +1,121 @@
+import { access, mkdtemp, writeFile } from "node:fs/promises";
+import { constants, existsSync } from "node:fs";
+import { execFile } from "node:child_process";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function commandExists(command) {
+    const resolved = resolveCommand(command);
+    if (command.includes("/") || command.includes("\\")) {
+        try {
+            await access(command, constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        await execFileAsync(process.platform === "win32" ? "where" : "command", process.platform === "win32" ? [resolved] : ["-v", resolved], {
+            shell: process.platform !== "win32"
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function optimizeWithCli(source, target) {
+    const gltfTransform = process.env.GLTF_TRANSFORM_BIN ?? "gltf-transform";
+    const gltfTransformCommand = resolveCommand(gltfTransform);
+    if (await commandExists(gltfTransform)) {
+        try {
+            const { stdout, stderr } = await execFileAsync(gltfTransformCommand, ["optimize", source, target]);
+            return { available: true, command: gltfTransformCommand, stdout, stderr };
+        }
+        catch (error) {
+            return { available: true, command: gltfTransformCommand, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    const gltfpack = process.env.GLTFPACK_BIN ?? "gltfpack";
+    const gltfpackCommand = resolveCommand(gltfpack);
+    if (await commandExists(gltfpack)) {
+        try {
+            const { stdout, stderr } = await execFileAsync(gltfpackCommand, ["-i", source, "-o", target]);
+            return { available: true, command: gltfpackCommand, stdout, stderr };
+        }
+        catch (error) {
+            return { available: true, command: gltfpackCommand, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    return { available: false, command: "gltf-transform|gltfpack", error: "No glTF optimizer CLI found" };
+}
+export async function renderWithHeadlessBlender(source, outputPng) {
+    const blender = process.env.BLENDER_BIN ?? "blender";
+    const blenderCommand = resolveCommand(blender);
+    if (!(await commandExists(blender))) {
+        return { available: false, command: blenderCommand, error: "Blender executable not found" };
+    }
+    const tempDir = await mkdtemp(join(tmpdir(), "creative-mcp-blender-"));
+    const scriptPath = join(tempDir, "render_preview.py");
+    const script = `
+import bpy
+import os
+
+source = ${JSON.stringify(source)}
+output = ${JSON.stringify(outputPng)}
+
+bpy.ops.object.delete()
+if source.lower().endswith((".glb", ".gltf")):
+    bpy.ops.import_scene.gltf(filepath=source)
+elif source.lower().endswith(".blend"):
+    pass
+else:
+    raise RuntimeError("Unsupported preview source: " + source)
+
+if not bpy.context.scene.camera:
+    bpy.ops.object.light_add(type="AREA", location=(2, -3, 4))
+    bpy.context.object.data.energy = 400
+    bpy.ops.object.camera_add(location=(3, -5, 3), rotation=(1.1, 0, 0.55))
+    bpy.context.scene.camera = bpy.context.object
+
+bpy.context.scene.render.resolution_x = 1024
+bpy.context.scene.render.resolution_y = 1024
+bpy.context.scene.render.filepath = output
+bpy.ops.render.render(write_still=True)
+`;
+    await writeFile(scriptPath, script, "utf8");
+    try {
+        const { stdout, stderr } = await execFileAsync(blenderCommand, ["--background", source.endsWith(".blend") ? source : "--factory-startup", "--python", scriptPath]);
+        return { available: true, command: blenderCommand, stdout, stderr };
+    }
+    catch (error) {
+        return { available: true, command: blenderCommand, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+export async function runHeadlessBlenderScript(script) {
+    const blender = process.env.BLENDER_BIN ?? "blender";
+    const blenderCommand = resolveCommand(blender);
+    if (!(await commandExists(blender))) {
+        return { available: false, command: blenderCommand, error: "Blender executable not found" };
+    }
+    const tempDir = await mkdtemp(join(tmpdir(), "creative-mcp-blender-"));
+    const scriptPath = join(tempDir, "script.py");
+    await writeFile(scriptPath, script, "utf8");
+    try {
+        const { stdout, stderr } = await execFileAsync(blenderCommand, ["--background", "--factory-startup", "--python", scriptPath]);
+        return { available: true, command: blenderCommand, stdout, stderr };
+    }
+    catch (error) {
+        return { available: true, command: blenderCommand, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+function resolveCommand(command) {
+    if (command.includes("/") || command.includes("\\")) {
+        return command;
+    }
+    const local = resolve("node_modules", ".bin", process.platform === "win32" ? `${command}.cmd` : command);
+    return existsSync(local) ? local : command;
+}
+//# sourceMappingURL=cli.js.map

package/packages/blender-pro-mcp/dist/adapters/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/adapters/cli.ts"],"names":[],"mappings":"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"}

package/packages/blender-pro-mcp/dist/adapters/gltf.d.ts

@@ -0,0 +1,21 @@
+export interface GltfInspection {
+    format: "glb" | "gltf";
+    version?: string;
+    nodeCount: number;
+    meshCount: number;
+    materialCount: number;
+    textureCount: number;
+    imageCount: number;
+    primitiveCount: number;
+    vertexCount: number;
+    triangleCount: number;
+    primitivesMissingNormals: number;
+    primitivesMissingUvs: number;
+    missingTextureRefs: number;
+    materialTextureSlots: number;
+    boundingBox?: {
+        min: number[];
+        max: number[];
+    };
+}
+export declare function inspectGltf(path: string): Promise<GltfInspection>;

package/packages/blender-pro-mcp/dist/adapters/gltf.js

@@ -0,0 +1,99 @@
+import { readFile } from "node:fs/promises";
+export async function inspectGltf(path) {
+    const bytes = await readFile(path);
+    const json = path.toLowerCase().endsWith(".glb") ? readGlbJson(bytes) : JSON.parse(bytes.toString("utf8"));
+    return summarize(json, path.toLowerCase().endsWith(".glb") ? "glb" : "gltf");
+}
+function readGlbJson(bytes) {
+    if (bytes.length < 20 || bytes.readUInt32LE(0) !== 0x46546c67) {
+        throw new Error("Invalid GLB header");
+    }
+    let offset = 12;
+    while (offset + 8 <= bytes.length) {
+        const chunkLength = bytes.readUInt32LE(offset);
+        const chunkType = bytes.readUInt32LE(offset + 4);
+        offset += 8;
+        if (chunkType === 0x4e4f534a) {
+            return JSON.parse(bytes.subarray(offset, offset + chunkLength).toString("utf8").trim());
+        }
+        offset += chunkLength;
+    }
+    throw new Error("GLB JSON chunk not found");
+}
+function summarize(json, format) {
+    const accessors = json.accessors ?? [];
+    let primitiveCount = 0;
+    let vertexCount = 0;
+    let triangleCount = 0;
+    let primitivesMissingNormals = 0;
+    let primitivesMissingUvs = 0;
+    const bbox = { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] };
+    for (const mesh of json.meshes ?? []) {
+        for (const primitive of mesh.primitives ?? []) {
+            primitiveCount += 1;
+            const attributes = primitive.attributes;
+            if (typeof attributes?.NORMAL !== "number") {
+                primitivesMissingNormals += 1;
+            }
+            if (typeof attributes?.TEXCOORD_0 !== "number") {
+                primitivesMissingUvs += 1;
+            }
+            const positionAccessor = attributes ? accessors[attributes.POSITION] : undefined;
+            if (positionAccessor?.count) {
+                vertexCount += positionAccessor.count;
+            }
+            if (positionAccessor?.min && positionAccessor.max) {
+                for (let index = 0; index < 3; index += 1) {
+                    bbox.min[index] = Math.min(bbox.min[index], positionAccessor.min[index] ?? bbox.min[index]);
+                    bbox.max[index] = Math.max(bbox.max[index], positionAccessor.max[index] ?? bbox.max[index]);
+                }
+            }
+            const indicesIndex = primitive.indices;
+            const indexAccessor = typeof indicesIndex === "number" ? accessors[indicesIndex] : undefined;
+            if (indexAccessor?.count) {
+                triangleCount += Math.floor(indexAccessor.count / 3);
+            }
+            else if (positionAccessor?.count) {
+                triangleCount += Math.floor(positionAccessor.count / 3);
+            }
+        }
+    }
+    const images = json.images ?? [];
+    const missingTextureRefs = (json.textures ?? []).filter((texture) => {
+        return typeof texture.source !== "number" || !images[texture.source];
+    }).length;
+    const materialTextureSlots = (json.materials ?? []).reduce((count, material) => {
+        return count + countTextureSlots(material);
+    }, 0);
+    return {
+        format,
+        version: json.asset?.version,
+        nodeCount: json.nodes?.length ?? 0,
+        meshCount: json.meshes?.length ?? 0,
+        materialCount: json.materials?.length ?? 0,
+        textureCount: json.textures?.length ?? 0,
+        imageCount: images.length,
+        primitiveCount,
+        vertexCount,
+        triangleCount,
+        primitivesMissingNormals,
+        primitivesMissingUvs,
+        missingTextureRefs,
+        materialTextureSlots,
+        boundingBox: Number.isFinite(bbox.min[0]) ? bbox : undefined
+    };
+}
+function countTextureSlots(value) {
+    if (!value || typeof value !== "object") {
+        return 0;
+    }
+    let count = 0;
+    for (const [key, nested] of Object.entries(value)) {
+        if (key.endsWith("Texture") && nested && typeof nested === "object") {
+            count += 1;
+        }
+        count += countTextureSlots(nested);
+    }
+    return count;
+}
+//# sourceMappingURL=gltf.js.map