threejs-debug-compose 0.1.0

package/dist/types/shader-cost/material-cost.d.ts

@@ -0,0 +1,15 @@
+import { Material } from "three";
+export interface MaterialCostEntry {
+    cost: number;
+    signature: string;
+    signals: readonly string[];
+}
+export interface MaterialCostCache {
+    get(material: Material): MaterialCostEntry;
+    clear(): void;
+    readonly size: number;
+}
+export declare function scoreMaterialCost(material: Material): number;
+export declare function createMaterialCostCache(): MaterialCostCache;
+export declare function getMaterialCostSignature(material: Material): string;
+export declare function getMaterialCostSignals(material: Material): string[];

package/dist/types/use-debug-views-controls.d.ts

@@ -0,0 +1,16 @@
+interface UseDebugViewsControlsOptions {
+    viewLabels?: string[];
+    maxLayoutSlots?: number;
+}
+export declare function useDebugViewsControls(options?: UseDebugViewsControlsOptions): {
+    mode: string;
+    layout: string;
+    activeView: number;
+    overlayOpacity: number;
+    columns: number;
+    rows: number;
+    slots: number;
+    showLabels: boolean;
+    enabled: boolean;
+};
+export {};

package/dist/use-debug-views-controls.js

@@ -0,0 +1,77 @@
+import { useControls as e } from "leva";
+//#region components/debug-views/use-debug-views-controls.ts
+function t(t = {}) {
+	let { viewLabels: n = [
+		"Beauty",
+		"Normal",
+		"Depth"
+	], maxLayoutSlots: r } = t, i = Math.max(1, r ?? n.length), a = Math.min(4, i), o = {};
+	for (let e = 0; e < n.length; e++) o[n[e]] = e;
+	return e("Debug", {
+		enabled: {
+			label: "Enabled",
+			value: !0
+		},
+		showLabels: {
+			label: "Viewport labels",
+			value: !0
+		},
+		mode: {
+			label: "Mode",
+			value: "compose",
+			options: {
+				Compose: "compose",
+				Viewport: "viewport"
+			}
+		},
+		activeView: {
+			label: "View",
+			value: 0,
+			options: o
+		},
+		layout: {
+			label: "Layout",
+			value: "single",
+			options: {
+				Single: "single",
+				Overlay: "overlay",
+				"Split H": "split-h",
+				"Split V": "split-v",
+				Quad: "quad",
+				Row: "row",
+				Column: "column",
+				Grid: "grid"
+			}
+		},
+		slots: {
+			label: "Slots",
+			value: a,
+			min: 1,
+			max: i,
+			step: 1
+		},
+		columns: {
+			label: "Columns",
+			value: 2,
+			min: 1,
+			max: i,
+			step: 1
+		},
+		rows: {
+			label: "Rows",
+			value: 2,
+			min: 1,
+			max: i,
+			step: 1
+		},
+		overlayOpacity: {
+			label: "Blend opacity",
+			value: .35,
+			min: 0,
+			max: 1,
+			step: .01
+		}
+	});
+}
+//#endregion
+export { t as useDebugViewsControls };

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "threejs-debug-compose",
+  "version": "0.1.0",
+  "description": "Composable TSL debug views for Three.js WebGPU render pipelines.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/types/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "assets/readme-compose-banner.png",
+    "assets/viewport-compose-quad.png",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "C:\\Progra~1\\nodejs\\node.exe ./node_modules/vite/bin/vite.js --host 0.0.0.0 --port 3000",
+    "preview": "C:\\Progra~1\\nodejs\\node.exe ./node_modules/vite/bin/vite.js preview --host 0.0.0.0 --port 3000",
+    "build": "pnpm build:lib && pnpm build:types",
+    "build:lib": "C:\\Progra~1\\nodejs\\node.exe ./node_modules/vite/bin/vite.js build",
+    "build:types": "C:\\Progra~1\\nodejs\\node.exe ./node_modules/typescript/bin/tsc -p tsconfig.build.json",
+    "typecheck": "C:\\Progra~1\\nodejs\\node.exe ./node_modules/typescript/bin/tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build",
+    "docs:dev": "pnpm --filter @threejs-debug-compose/docs dev",
+    "docs:build": "pnpm --filter @threejs-debug-compose/docs build",
+    "docs:preview": "pnpm --filter @threejs-debug-compose/docs preview"
+  },
+  "peerDependencies": {
+    "@react-three/drei": ">=10",
+    "@react-three/fiber": ">=9",
+    "leva": ">=0.10",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "three": ">=0.184"
+  },
+  "peerDependenciesMeta": {
+    "@react-three/drei": {
+      "optional": true
+    },
+    "@react-three/fiber": {
+      "optional": true
+    },
+    "leva": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@react-three/drei": "10.7.7",
+    "@react-three/fiber": "9.6.1",
+    "@types/node": "25.9.1",
+    "@types/react": "19.2.15",
+    "@types/react-dom": "19.2.3",
+    "@types/three": "0.184.1",
+    "@vitejs/plugin-react": "6.0.2",
+    "leva": "0.10.1",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
+    "three": "0.184.0",
+    "typescript": "6.0.3",
+    "vite": "8.0.14",
+    "vitest": "^4.1.7"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tonyblu331/threejs-debug-compose.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tonyblu331/threejs-debug-compose/issues"
+  },
+  "homepage": "https://github.com/tonyblu331/threejs-debug-compose#readme",
+  "keywords": [
+    "threejs",
+    "webgpu",
+    "tsl",
+    "debug",
+    "rendering"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}