@combos-fun/plugin-renderer-3d-graphics 0.0.6 → 0.0.8

package/README.md

@@ -0,0 +1,27 @@
+# @combos-fun/plugin-renderer-3d-graphics
+
+@combos-fun/plugin-renderer-3d-graphics — part of the Combos Fun engine monorepo.
+
+Keywords: `3d`, `graphics`, `primitives`, `box`, `sphere`, `cylinder`, `plane`.
+
+## Documentation
+
+- Per-package agent / developer notes: [`agent-skill.md`](./agent-skill.md)
+- Machine-readable manifest: [`combos-plugin.json`](./combos-plugin.json)
+  (validated against `schemas/combos-plugin.schema.json` in the repo
+  root)
+- Entry skill (single source of truth for AI agents working with this
+  monorepo): `skills/combos-engine-development/SKILL.md`
+
+When consumed from npm, the manifest and agent notes are exposed as
+stable subpaths:
+
+```ts
+import manifest from '@combos-fun/plugin-renderer-3d-graphics/plugin-manifest';
+// or fetch the markdown directly:
+// require.resolve('@combos-fun/plugin-renderer-3d-graphics/agent-skill')
+```
+
+## License
+
+Internal workspace package, part of the Combos Fun engine monorepo.

package/agent-skill.md

@@ -0,0 +1,61 @@
+# `@combos-fun/plugin-renderer-3d-graphics` — Agent notes
+
+Procedural 3D primitive shapes for the 3D pipeline. Produces a `THREE.Mesh` with a `MeshStandardMaterial` based on the chosen `shape`.
+
+## When to read
+
+Read for any procedural primitive: box, sphere, cylinder, plane, cone, torus, debug placeholders, simple terrain.
+
+## Public API
+
+```ts
+import { Graphics3D, Graphics3DSystem, type Graphics3DParams } from '@combos-fun/plugin-renderer-3d-graphics';
+```
+
+`componentName = 'Graphics3D'`, `systemName = 'Graphics3DSystem'`.
+
+### `Graphics3DParams`
+
+| Field | Type | Default |
+|-------|------|---------|
+| `shape` | `'box' \| 'sphere' \| 'cylinder' \| 'plane' \| 'cone' \| 'torus'` | `'box'` |
+| `color` | `number` | `0x00ff00` |
+| `wireframe` | `boolean` | `false` |
+| `width` / `height` / `depth` | `number` | `1` |
+| `radius` | `number` | `0.5` |
+| `segments` | `number` | `32` |
+| `positionX` / `Y` / `Z` | `number` | `0` |
+| `rotationX` / `Y` / `Z` | `number` | `0` |
+| `scaleX` / `Y` / `Z` | `number` | `1` |
+| `opacity` | `number` | `1` |
+
+Shape → Three.js geometry: `box → BoxGeometry`, `sphere → SphereGeometry`, `cylinder → CylinderGeometry`, `plane → PlaneGeometry`, `cone → ConeGeometry`, `torus → TorusGeometry`.
+
+## Required setup
+
+`Renderer3DSystem` then `Graphics3DSystem`.
+
+## Common pitfalls
+
+| Symptom | Fix |
+|---------|-----|
+| Plane invisible from one side | Add `doubleSide`-style material, or rotate to face the camera |
+| Sphere very dark | Increase scene light or use `MeshBasicMaterial`-style flat shading (not exposed; use `Img3D` if you need flat) |
+| Wireframe shimmer | `wireframe: true` — that's by design |
+| Sync drift with `Physics3D` | Make sure both are on the same `GameObject`; `Physics3D.update()` writes positions back automatically |
+
+## Minimal example
+
+```ts
+const box = new GameObject('box');
+box.addComponent(new Graphics3D({
+  shape: 'box',
+  width: 1, height: 1, depth: 1,
+  color: 0xff0000,
+  positionX: 0, positionY: 1, positionZ: 0,
+}));
+```
+
+## Verification
+
+`pnpm --filter @combos-fun/plugin-renderer-3d-graphics run build`.

package/combos-plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "@combos-fun/plugin-renderer-3d-graphics",
+  "pluginId": "renderer-3d-graphics",
+  "category": "rendering",
+  "dimension": "3d",
+  "isCore": false,
+  "keywords": ["3d", "graphics", "primitives", "box", "sphere", "cylinder", "plane"],
+  "agentSkill": "./agent-skill.md",
+  "requires": ["@combos-fun/engine", "@combos-fun/plugin-renderer-3d"],
+  "exports": ["Graphics3D", "Graphics3DSystem"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/plugin-renderer-3d-graphics",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "@combos-fun/plugin-renderer-3d-graphics",
   "main": "index.js",
   "module": "dist/plugin-renderer-3d-graphics.esm.js",
@@ -9,13 +9,27 @@
   "types": "dist/plugin-renderer-3d-graphics.d.ts",
   "files": [
     "index.js",
-    "dist"
+    "dist",
+    "agent-skill.md",
+    "combos-plugin.json"
   ],
+  "exports": {
+    ".": {
+      "import": "./dist/plugin-renderer-3d-graphics.esm.js",
+      "require": "./index.js",
+      "types": "./dist/plugin-renderer-3d-graphics.d.ts"
+    },
+    "./plugin-manifest": "./combos-plugin.json",
+    "./agent-skill": "./agent-skill.md"
+  },
+  "combos": {
+    "pluginManifest": "./combos-plugin.json"
+  },
   "dependencies": {
     "three": "^0.172.0",
-    "@combos-fun/engine": "0.0.6",
-    "@combos-fun/inspector-decorator": "0.0.6",
-    "@combos-fun/plugin-renderer-3d": "0.0.6"
+    "@combos-fun/plugin-renderer-3d": "0.0.8",
+    "@combos-fun/inspector-decorator": "0.0.8",
+    "@combos-fun/engine": "0.0.8"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs"