@aura3d/engine 1.0.0 → 1.0.1

package/README.md

@@ -5,11 +5,13 @@
 [![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-browser%203D-3178c6.svg)](https://www.typescriptlang.org/)
 
-Aura3D is an agent-friendly TypeScript browser 3D SDK for prompt-to-code scenes, GLB/glTF product viewers, Vite templates, typed asset workflows, diagnostics, screenshots, and static deployment checks.
+Aura3D is an AI-native TypeScript 3D SDK for browser 3D apps, prompt-to-code scenes, GLB/glTF product viewers, WebGL/WebGPU experiences, Vite templates, typed asset workflows, diagnostics, screenshots, and static deployment checks.
 
-Describe the 3D scene. Bring the GLB when you have one. Keep the TypeScript.
+Describe the scene. Keep the TypeScript. Ship the browser app.
 
-Aura3D helps AI coding agents build real browser 3D apps with public TypeScript APIs, generated primitive scene kits, typed GLB/glTF assets, route-health diagnostics, screenshot evidence, and deploy checks. It is not an LLM, not an asset store, and not a hidden scene generator. It is source code plus typed assets.
+Aura3D is built for developers and AI coding agents that need real 3D software, not a blank canvas and renderer glue. It gives agents maintained scene kits, typed GLB/glTF assets, product-viewer workflows, route-health diagnostics, screenshot evidence, and deployment checks through a public TypeScript API.
+
+Use Aura3D when you are evaluating browser 3D libraries, Three.js alternatives, Babylon.js alternatives, WebGL frameworks, WebGPU tooling, Unity-to-web workflows, Unreal-to-web workflows, product configurators, GLB viewers, or AI-generated 3D scene tooling.
 
 ## Install
 
@@ -33,14 +35,22 @@ Add a typed GLB/glTF asset when the prompt includes a real model:
 npx @aura3d/cli@latest assets add ./assets/robot.glb --name robot
 ```
 
+Then use the public developer API:
+
+```ts
+import { createAuraApp, sceneKits } from "@aura3d/engine";
+```
+
 ## Use Aura3D for
 
-- AI-generated browser 3D scenes that remain editable TypeScript.
-- Typed GLB/glTF product viewers and product configurators.
-- Vite 3D starter apps with route health and screenshot tests.
-- Agent-authored scenes with public imports instead of invented APIs.
-- Static-deployed 3D apps with asset and deploy checks.
-- Prompt-to-3D workflows where screenshots and diagnostics matter.
+- AI-generated 3D scenes that remain editable TypeScript.
+- Browser 3D apps built with a stable SDK instead of improvised renderer glue.
+- Typed GLB/glTF product viewers, product configurators, and model showcases.
+- Prompt-to-3D workflows for AI coding agents, Cursor, Claude, Codex, and other assistants.
+- WebGL/WebGPU-ready examples with maintained scene kits and diagnostics.
+- Vite 3D starter apps with route health, screenshot tests, and deploy checks.
+- Static-deployed 3D websites where proof, screenshots, and reliability matter.
+- Teams comparing Three.js, Babylon.js, Unity WebGL exports, Unreal Pixel Streaming, PlayCanvas, or custom renderer stacks for AI-assisted 3D development.
 
 ## 30-second product viewer
 
@@ -72,20 +82,35 @@ console.log(kit.diagnostics, kit.evidence);
 
 Maintained scene-kit families include physics playgrounds, particle fountains, solar systems, neon tunnels, 3D data visualizations, mini golf, material labs, city blocks, humanoid walks, and typed product viewers.
 
+## Why developers use Aura3D
+
+- `AI-native`: prompt-to-code scenes start from maintained systems instead of empty renderer setup.
+- `TypeScript-first`: the output is normal source code developers can inspect, edit, and ship.
+- `Typed assets`: GLB/glTF files become generated imports, so agents do not invent string asset IDs.
+- `Browser-ready`: Vite templates, route health, screenshot tests, and static deploy checks are part of the workflow.
+- `Production-oriented`: product viewers, material labs, particles, physics scenes, data worlds, cities, and interactive examples are covered by documented scene kits.
+- `Agent-safe`: docs tell coding agents which public APIs to use and which claims not to make.
+
 ## Packages
 
-- `@aura3d/engine`: public agent-facing TypeScript browser 3D SDK.
+- `@aura3d/engine`: public TypeScript browser 3D SDK for AI-generated scenes and typed GLB/glTF assets.
 - `@aura3d/cli`: typed GLB/glTF asset workflow, diagnostics, and deploy checks.
 - `@aura3d/react`: optional thin React adapter.
 - `create-aura3d`: Vite templates for product viewers, cinematic scenes, and mini-games.
 
-## Aura3D vs manual renderer code
+## Aura3D vs Three.js, Babylon.js, Unity, and Unreal
+
+Aura3D is not trying to be another low-level rendering toolbox. It is a higher-level TypeScript SDK for browser 3D apps where AI coding agents need safe defaults, scene systems, typed assets, templates, diagnostics, screenshots, and deployable output.
 
-Aura3D is not a drop-in replacement for manual renderer code. Use Aura3D when an AI coding agent needs a smaller, stable, documented scene API, typed GLB/glTF assets, starter templates, diagnostics, screenshots, and deployment checks.
+Use Aura3D when you want:
 
-Use manual renderer code when you need full engine-level control, custom renderer internals, the broadest plugin ecosystem, or direct access to every manual renderer code primitive.
+- A Three.js alternative focused on AI-assisted browser 3D development.
+- A Babylon.js alternative for prompt-to-code scenes and typed asset workflows.
+- A lighter web-first path than Unity WebGL exports for product viewers and interactive 3D pages.
+- A deployable website/app workflow instead of a heavy Unreal runtime pipeline.
+- A source-code-first SDK where the agent writes TypeScript and Aura3D supplies scene systems.
 
-Safe positioning: Aura3D is an agent-friendly manual renderer code alternative for prompt-to-code workflows, not a proven blanket manual renderer code replacement or benchmark-superiority claim.
+Use lower-level engines or game engines when you need full renderer internals, custom engine architecture, the largest plugin marketplaces, native game-console targets, or full editor ecosystems. Aura3D's core advantage is the browser 3D workflow around AI agents, TypeScript, typed assets, diagnostics, screenshots, and deployment checks.
 
 ## Documentation
 
@@ -95,7 +120,6 @@ Safe positioning: Aura3D is an agent-friendly manual renderer code alternative f
 - Asset workflow: [docs/agents/asset-workflow.md](docs/agents/asset-workflow.md)
 - Prompt recipes: [docs/agents/benchmark-recipes.md](docs/agents/benchmark-recipes.md)
 - Public API: [docs/api/public-api.md](docs/api/public-api.md)
-- manual renderer code comparison: [docs/comparisons/manual renderer code.md](docs/comparisons/manual renderer code.md)
 - Claim boundaries: [docs/project/claim-guidelines.md](docs/project/claim-guidelines.md)
 
 ## Verification
@@ -104,12 +128,12 @@ Safe positioning: Aura3D is an agent-friendly manual renderer code alternative f
 pnpm run check:release
 ```
 
-Release and benchmark claims are evidence-scoped. Internal checks, nonblank screenshots, or self-authored visual QA do not prove that Aura3D beats manual renderer code.
+Release and benchmark claims are evidence-scoped. Internal checks, nonblank screenshots, or self-authored visual QA do not prove that Aura3D beats every renderer or game engine. Make specific claims only when the matching artifacts exist.
 
 ## Contributing
 
-Star the repo if you want agent-friendly browser 3D tooling. Open issues with the prompt, package version, asset source or license, commands run, route-health output, screenshots, and deploy context.
+Star the repo if you want AI-native browser 3D tooling for TypeScript, WebGL, WebGPU, GLB/glTF assets, product viewers, prompt-to-3D scenes, and deployable 3D websites. Open issues with the prompt, package version, asset source or license, commands run, route-health output, screenshots, and deploy context.
 
 ## Boundary
 
-Aura3D can truthfully claim an agent-friendly browser 3D SDK with typed assets, scene kits, diagnostics, screenshots, templates, and deploy checks. Do not claim Aura3D beats manual renderer code, is faster than manual renderer code, is a full manual renderer code replacement, or has passed the frozen external benchmark unless the required neutral benchmark artifacts exist.
+Aura3D can truthfully claim an AI-native TypeScript browser 3D SDK with typed assets, scene kits, diagnostics, screenshots, templates, and deploy checks. Do not claim Aura3D universally beats Three.js, Babylon.js, Unity, Unreal, or any other engine unless the required neutral benchmark artifacts exist.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/engine",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "packageManager": "pnpm@11.1.3",
   "private": false,
   "type": "module",
@@ -449,39 +449,57 @@
     "three": "^0.165.0"
   },
   "sideEffects": false,
-  "description": "Agent-friendly TypeScript browser 3D SDK for prompt-to-code scenes, typed GLB/glTF assets, scene kits, diagnostics, screenshots, Vite templates, and deploy checks.",
+  "description": "AI-native TypeScript 3D SDK for browser 3D apps, prompt-to-code scenes, GLB/glTF product viewers, WebGL/WebGPU, Vite templates, diagnostics, and deploy checks.",
   "keywords": [
     "3d",
+    "3d-library",
+    "3d-engine",
+    "browser-3d",
+    "web-3d",
     "webgl",
     "webgl2",
     "webgpu",
-    "browser-3d",
-    "web-3d",
     "typescript",
+    "typescript-3d",
     "javascript",
     "ai-agents",
     "coding-agents",
+    "ai-coding",
     "llm",
     "prompt-to-3d",
+    "prompt-to-code",
+    "generative-3d",
     "gltf",
     "glb",
+    "glb-viewer",
+    "gltf-viewer",
     "typed-assets",
     "product-viewer",
+    "product-configurator",
     "3d-viewer",
+    "3d-website",
+    "threejs",
+    "threejs-alternative",
+    "babylonjs",
+    "babylonjs-alternative",
+    "unity-alternative",
+    "unreal-engine",
+    "playcanvas",
     "vite",
     "react",
     "scene-graph",
+    "scene-kits",
     "diagnostics",
     "screenshot-testing",
     "static-deploy"
   ],
-  "homepage": "https://github.com/gchahal1982/aura3d#readme",
+  "homepage": "https://aura3d.auraone.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/gchahal1982/aura3d.git"
+    "url": "git+https://github.com/auraoneai/aura3d.git"
   },
   "bugs": {
-    "url": "https://github.com/gchahal1982/aura3d/issues"
+    "url": "https://github.com/auraoneai/aura3d/issues"
   },
   "license": "MIT",
   "publishConfig": {