@needle-tools/engine 4.15.0-next.f391a30 → 4.15.0

package/lib/engine/export/gltf/EXT_mesh_gpu_instancing_exporter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EXT_mesh_gpu_instancing_exporter.js","sourceRoot":"","sources":["../../../../src/engine/export/gltf/EXT_mesh_gpu_instancing_exporter.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEF,OAAO,EACP,eAAe,EACf,OAAO,EACP,OAAO,EACP,UAAU,GACV,MAAM,OAAO,CAAC;AAEf,MAAM,CAAC,OAAO,OAAO,8BAA8B;IAElD,YAAa,MAAM;QAElB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAEvC,CAAC;IAED,SAAS,CAAE,IAAI,EAAE,OAAO;QAEvB,IAAG,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe;YAAE,OAAO;QAErD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC7C,MAAM,YAAY,GAAG,EAAE,CAAC;QAExB,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QAC9C,OAAO,CAAC,UAAU,CAAE,IAAI,CAAC,IAAI,CAAE,GAAG,YAAY,CAAC;QAE/C,IAAI,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QAEzB,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAClC;YACC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAEzB,IAAI,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;YAEtB,GAAG,CAAC,SAAS,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,CAAC;YAErB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvB;QAAA,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnC,YAAY,CAAC,UAAU,GAAG;YACzB,aAAa,EAAG,MAAM,CAAC,eAAe,CAAE,IAAI,eAAe,CAAE,GAAG,EAAE,CAAC,CAAE,CAAE;YACvE,UAAU,EAAG,MAAM,CAAC,eAAe,CAAE,IAAI,eAAe,CAAE,GAAG,EAAE,CAAC,CAAE,CAAE;YACpE,OAAO,EAAG,MAAM,CAAC,eAAe,CAAE,IAAI,eAAe,CAAE,GAAG,EAAE,CAAC,CAAE,CAAE;SACjE,CAAC;QAEF,cAAc,CAAE,IAAI,CAAC,IAAI,CAAE,GAAG,IAAI,CAAC;IAEpC,CAAC;CACD"}

package/plugins/common/needle-engine-skill.md

@@ -1,175 +0,0 @@
----
-name: needle-engine
-description: Automatically provides Needle Engine context when working in a Needle Engine web project. Use this skill when editing TypeScript components, Vite config, GLB assets, or anything related to @needle-tools/engine.
----
-
-# Needle Engine
-
-You are an expert in Needle Engine — a web-first 3D engine built on Three.js with a Unity/Blender-based workflow.
-
-## Key concepts
-
-**Needle Engine** ships 3D scenes from Unity (or Blender) as GLB files and renders them in the browser using Three.js. TypeScript components attached to GameObjects in Unity are serialized into the GLB and re-hydrated at runtime in the browser.
-
-### Embedding in HTML
-```html
-<!-- The <needle-engine> web component creates and manages a 3D context -->
-<needle-engine src="assets/scene.glb"></needle-engine>
-```
-Access the context programmatically: `document.querySelector("needle-engine").context`
-
-### Component lifecycle (mirrors Unity MonoBehaviour)
-```ts
-import { Behaviour, serializable, registerType } from "@needle-tools/engine";
-
-@registerType
-export class MyComponent extends Behaviour {
-  @serializable() myValue: number = 1;
-
-  awake()  {}   // called once when instantiated
-  start()  {}   // called once on first frame
-  update() {}   // called every frame
-  onEnable()  {}
-  onDisable() {}
-  onDestroy() {}
-  onBeforeRender(_frame: XRFrame | null) {}
-}
-```
-
-### Serialization
-- `@registerType` — makes the class discoverable by the GLB deserializer
-- `@serializable()` — marks a field for GLB deserialization (primitives)
-- `@serializable(Object3D)` — for Three.js object references
-- `@serializable(Texture)` — for textures (import Texture from "three")
-- `@serializable(RGBAColor)` — for colors
-
-### Accessing the scene
-```ts
-this.context.scene       // THREE.Scene
-this.context.mainCamera  // active camera (THREE.Camera)
-this.context.renderer    // THREE.WebGLRenderer
-this.context.time.frame  // current frame number
-this.context.time.deltaTime  // seconds since last frame
-this.gameObject          // the THREE.Object3D this component is on
-```
-
-### Finding components
-```ts
-this.gameObject.getComponent(MyComponent)
-this.gameObject.getComponentInChildren(MyComponent)
-this.context.scene.getComponentInChildren(MyComponent)
-
-// Global search (import as standalone functions from "@needle-tools/engine")
-import { findObjectOfType, findObjectsOfType } from "@needle-tools/engine";
-findObjectOfType(MyComponent, this.context)
-findObjectsOfType(MyComponent, this.context)
-```
-
-### Input handling
-```ts
-// Polling
-if (this.context.input.getPointerDown(0)) { /* pointer pressed */ }
-if (this.context.input.getKeyDown("Space")) { /* space pressed */ }
-
-// Event-based (NEPointerEvent works across mouse, touch, and XR controllers)
-this.gameObject.addEventListener("pointerdown", (e: NEPointerEvent) => { });
-```
-
-### Physics & raycasting
-```ts
-// Default raycasts hit visible geometry — no colliders needed
-// Uses mesh BVH (bounding volume hierarchy) for accelerated raycasting, BVH is generated on a worker
-const hits = this.context.physics.raycast();
-
-// Physics-based raycasts (require colliders, uses Rapier physics engine)
-const physicsHits = this.context.physics.raycastPhysics();
-```
-
-### Networking & multiplayer
-Needle Engine has built-in multiplayer. Add a `SyncedRoom` component to enable networking.
-
-- `@syncField()` — automatically syncs a field across all connected clients
-- Primitives (string, number, boolean) sync automatically on change
-- Complex types (arrays/objects) require reassignment to trigger sync: `this.myArray = this.myArray`
-- Key components: `SyncedRoom`, `SyncedTransform`, `PlayerSync`, `Voip`
-- Uses WebSockets + optional WebRTC peer-to-peer connections
-
-### WebXR (VR & AR)
-Needle Engine has built-in WebXR support for VR and AR across Meta Quest, Apple Vision Pro, and mobile AR.
-
-- Add the `WebXR` component to enable VR/AR sessions
-- Use `XRRig` to define the user's starting position — the user is parented to the rig during XR sessions
-- Available components: `WebXRImageTracking`, `WebXRPlaneTracking`, `XRControllerModel`, `NeedleXRSession`
-
-## Creating a new project
-
-Use `create-needle` to scaffold a new Needle Engine project:
-```bash
-npm create needle my-app            # default Vite template
-npm create needle my-app -t react   # React template
-npm create needle my-app -t vue     # Vue.js template
-```
-
-Available templates: `vite` (default), `react`, `vue`, `sveltekit`, `svelte`, `nextjs`, `react-three-fiber`.
-
-Use `npm create needle --list` to see all available templates.
-
-## Vite plugin system
-
-Needle Engine ships a set of Vite plugins via `needlePlugins(command, config, userSettings)`. Custom project plugins go in `vite.config.ts`.
-
-```ts
-import { defineConfig } from "vite";
-import { needlePlugins } from "@needle-tools/engine/vite";
-
-export default defineConfig(async ({ command }) => ({
-  plugins: [
-    ...(await needlePlugins(command, {}, {})),
-  ],
-}));
-```
-
-## Deployment
-
-Projects can be deployed to:
-- **Needle Cloud** — official hosting with automatic optimization (`npx needle-cloud deploy`)
-- **Vercel** / **Netlify** — standard web hosting
-- **itch.io** — for games and interactive experiences
-- **Any static host** — Needle Engine projects are standard Vite web apps
-
-From Unity, use built-in deployment components (e.g. `DeployToNeedleCloud`, `DeployToNetlify`).
-
-## Progressive loading (`@needle-tools/gltf-progressive`)
-
-Needle Engine includes `@needle-tools/gltf-progressive` for progressive streaming of 3D models and textures. It creates a tiny initial file with embedded low-quality proxy geometry, then streams higher-quality LODs on demand. Results in ~90% smaller initial downloads with instant display.
-
-Works standalone with any three.js project:
-```ts
-import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
-import { WebGLRenderer } from "three";
-import { useNeedleProgressive } from "@needle-tools/gltf-progressive";
-
-const gltfLoader = new GLTFLoader();
-const renderer = new WebGLRenderer();
-
-// Register once — progressive loading happens automatically for all subsequent loads
-useNeedleProgressive(gltfLoader, renderer);
-
-gltfLoader.load(url, (gltf) => scene.add(gltf.scene));
-```
-
-In Needle Engine projects, progressive loading is built in and can be configured via the **Compression & LOD Settings** component in Unity.
-
-## Important URLs
-- Docs: https://engine.needle.tools/docs/
-- Samples: https://engine.needle.tools/samples/
-- GitHub: https://github.com/needle-tools/needle-engine-support
-- npm: https://www.npmjs.com/package/@needle-tools/engine
-
-## Searching the documentation
-
-Use the `needle_search` MCP tool to find relevant docs, forum posts, and community answers.
-
-## Common gotchas
-- Components must use `@registerType` or they won't be instantiated from GLB (this is handled automatically when exporting from Unity or Blender, but must be added manually for hand-written components)
-- GLB assets are in `assets/`, static files in `include/` or `public/`

package/plugins/vite/ai.js

@@ -1,71 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const pluginName = "needle-ai";
-
-/**
- * Needle Engine Claude skill installer.
- *
- * Writes a Needle Engine skill to `.claude/skills/needle-engine/SKILL.md`.
- * Claude Code auto-loads skills based on their description frontmatter, so
- * Claude will automatically have Needle Engine context when working in the project.
- *
- * The skill is only written if `.claude/` already exists in the project root
- * (i.e. the developer is already using Claude Code). Old skill files are
- * always overwritten so the skill stays up to date with the engine version.
- *
- * @param {"build" | "serve"} command
- * @param {{} | undefined | null} config
- * @param {import('../types/index.js').userSettings} userSettings
- * @returns {import('vite').Plugin | null}
- */
-export const needleAI = (command, config, userSettings) => {
-    return {
-        name: pluginName,
-        enforce: "pre",
-        buildStart() {
-            installClaudeSkill();
-        },
-        configureServer() {
-            installClaudeSkill();
-        },
-    };
-};
-
-/** Read the engine version from our own package.json */
-function getEngineVersion() {
-    try {
-        const pkgPath = join(__dirname, "../../package.json");
-        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-        return pkg.version || "unknown";
-    }
-    catch {
-        return "unknown";
-    }
-}
-
-function writeSkill(claudeDir, version) {
-    const skillDir = join(claudeDir, "skills", "needle-engine");
-    if (!existsSync(skillDir)) {
-        mkdirSync(skillDir, { recursive: true });
-    }
-    const skillPath = join(skillDir, "SKILL.md");
-    const templatePath = join(__dirname, "../common/needle-engine-skill.md");
-    const template = readFileSync(templatePath, "utf8");
-    const content = template.replace("{{VERSION}}", version);
-    writeFileSync(skillPath, content, "utf8");
-    return skillPath;
-}
-
-function installClaudeSkill() {
-    const claudeDir = join(process.cwd(), ".claude");
-    if (!existsSync(claudeDir)) return; // only install if developer uses Claude Code
-
-    const version = getEngineVersion();
-    const path = writeSkill(claudeDir, version);
-    console.log(`[${pluginName}] Installed Needle Engine Claude skill → ${path}`);
-}