@aura3d/engine 1.0.0 → 1.0.2

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 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.
+Aura3D is built for the AI-assisted browser 3D era. It gives teams a higher-level TypeScript workflow than renderer-first libraries and a lighter web-native path than heavyweight game-engine exports.
 
-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.
+Use Aura3D when you want:
 
-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.
+- A Three.js alternative focused on prompt-to-code scenes, typed assets, and deployable browser output.
+- A Babylon.js alternative for teams that want AI agents to build real TypeScript scenes without hand-rolling every system.
+- A faster product-viewer and 3D website workflow than Unity WebGL export pipelines.
+- A web-first alternative to Unreal-heavy runtime delivery for interactive product, data, and cinematic scenes.
+- A source-code-first SDK where agents generate maintainable TypeScript instead of opaque scene blobs.
+
+Aura3D combines scene kits, GLB/glTF asset typing, product viewers, physics scenes, particles, material labs, data worlds, route diagnostics, screenshot workflows, and static deployment into one agent-ready SDK.
 
 ## Documentation
 
@@ -95,8 +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 +127,9 @@ 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.
+Use release checks to confirm package integrity, generated assets, examples, and static deployment output before shipping.
 
 ## 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.
-
-## Boundary
+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.
 
-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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/engine",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "packageManager": "pnpm@11.1.3",
   "private": false,
   "type": "module",
@@ -449,39 +449,66 @@
     "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"
+    "static-deploy",
+    "threejs-competitor",
+    "babylonjs-competitor",
+    "unity-webgl-alternative",
+    "unreal-alternative",
+    "webgl-framework",
+    "webgpu-framework",
+    "ai-3d",
+    "3d-sdk",
+    "browser-3d-engine"
   ],
-  "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": {

package/templates/product-viewer/src/main.ts

@@ -17,7 +17,6 @@ const plan = definePromptPlan({
   ],
   negativeCriteria: [
     "Do not use string asset ids or invented product URLs",
-    "Do not ship a lone GLB without plinth, contact, fit, and rotation evidence"
   ]
 } as const);