3draft 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vívó Péter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# 3Draft
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Minimalist AI first 3D engine.
+
+> Status: **pre-alpha**. The `0.0.x` releases reserve the package name and
+> pin down the direction; the engine itself is built step by step in this repo.
+
+```sh
+npm install 3draft
+```
+
+```js
+import { info } from '3draft';
+
+console.log(info());
+```
+
+## Idea
+
+- **One material, one palette texture.** Every face's UV points at a single
+  texel of a small palette texture, so a whole scene is one pipeline, one bind
+  group and instanced draw calls.
+- **Thin WASM core.** Transforms, culling and animation live in a WASM module
+  (HEXAW and/or Rust) behind a small, documented ABI. JS only uploads buffers.
+- **WebGPU first, WebGL2 fallback** behind a minimal `Renderer` interface.
+- **AI first.** A deterministic SVG preview and structured `inspect` reports
+  (plus an MCP server) let an AI build and verify models from text.
+
+## Roadmap
+
+1. ABI description + reference JS kernel + spinning instanced cube
+2. SVG/PNG preview renderer and MCP `render` / `inspect`
+3. Text modelling language + palette/UV validator
+4. HEXAW kernel next to the JS reference, with differential tests
+5. Rust core only if the logic outgrows HEXAW
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "3draft",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Minimalist AI first 3D engine: palette-texture, WASM core, WebGPU/WebGL2 renderer.",
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "!src/**/*.test.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "3d",
+    "webgpu",
+    "webgl2",
+    "wasm",
+    "hexaw",
+    "minimalist",
+    "engine",
+    "ai-first",
+    "mcp"
+  ],
+  "author": {
+    "name": "Vívó Péter",
+    "url": "https://github.com/Pengeszikra"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pengeszikra/3Draft.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Pengeszikra/3Draft/issues"
+  },
+  "homepage": "https://github.com/Pengeszikra/3Draft#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,11 @@
+export const name: '3draft';
+export const version: string;
+
+export interface Info {
+  name: string;
+  version: string;
+  stage: 'pre-alpha';
+  goals: string[];
+}
+
+export function info(): Info;

package/src/index.js

@@ -0,0 +1,19 @@
+// 3Draft: minimalist AI first 3D engine.
+// Early placeholder release: the real engine (palette-texture meshes,
+// WASM core, WebGPU/WebGL2 renderer, SVG preview) is built on top of this.
+
+export const name = '3draft';
+export const version = '0.0.1';
+
+/** Short, machine-readable description of the current state of the package. */
+export const info = () => ({
+  name,
+  version,
+  stage: 'pre-alpha',
+  goals: [
+    'single palette texture, UVs point at one texel per face',
+    'WASM core (HEXAW / Rust) behind a thin ABI',
+    'WebGPU renderer with WebGL2 fallback',
+    'deterministic SVG preview for AI feedback loops',
+  ],
+});