@aethervtt/shard-project 0.0.1 → 0.1.0

package/dist/docs.js

@@ -7,6 +7,7 @@ import { allComponents } from "@aethervtt/shard-core";
 import { allGenerators } from "@aethervtt/shard-procgen";
 import { saveJsonSchema } from "@aethervtt/shard-save";
 import { prefabJsonSchema, sceneJsonSchema } from "@aethervtt/shard-scene";
+import { capturePlanJsonSchema, perfRecordJsonSchema } from "@aethervtt/shard-verify";
 import { BUILTIN_PLUGINS, manifestJsonSchema } from "./manifest.js";
 const GENERATED_START = "<!-- shard:generated -->";
 const GENERATED_END = "<!-- /shard:generated -->";
@@ -343,9 +344,15 @@ Add \`"sprite"\` to \`plugins\` in \`shard.json\`. 2D uses the same renderer as
    "duration": 0.1 }, ...], "loop": "loop", "events": [{ "frame": 2, "name": "step" }] }\`, then
    \`"sprite/SpriteAnimation": { "clip": { "path": "assets/walk.clip.json" } }\`. Read events with
    \`world.reader(SpriteAnimationEvent)\`.
-4. Tilemaps: \`level.tilemap.json\` layers are base64 u16 tiles (atlas region + 1, 0 empty), and
-   \`"sprite/Tilemap": { "atlas": ..., "data": ..., "tileSize": [1, 1] }\`. Edit at runtime with
-   \`setTile(world, map, x, y, tile)\`; only that chunk re-uploads.
+4. Tilemaps: \`level.tilemap.json\` names tiles by atlas region in a \`palette\`, and stores each layer
+   as \`chunks\` of rows: \`"0,0": ["grass*12 stone*4", "grass stone:fx . water*13"]\` (runs of
+   \`name[:flags][*count]\`, \`.\` empty, flags \`fx\`/\`fy\`/\`r90\` joined by \`+\`), then
+   \`"sprite/Tilemap": { "atlas": ..., "data": ..., "tileSize": [1, 1] }\`. Read and edit cells by
+   name with MCP \`tilemap_read\` / \`tilemap_edit\` (live; \`save: true\` writes the file) or
+   \`shard tiles read|edit\`; \`shard tiles <file> --encoding base64\` compacts a big generated map.
+   In code: \`setTile(world, map, x, y, data.tileId('stone'))\`; only that chunk re-uploads. On a
+   tabletop, add \`"render/GroundLayer": { "band": 10 }\` and lay it flat (\`tilemapOnGround()\`'s
+   rotation): it draws among the ground bands, lit by 3D lights, and picks return the cell.
 5. Pixel art: \`"render/PixelPerfect": { "pixelsPerUnit": 16 }\` on an orthographic camera.
 6. Check: \`shard validate\`, MCP \`preview_asset\` on the atlas (regions outlined and numbered) or
    the clip, and \`render.describe\` \u2192 \`sprites\` (draw calls, sprites per layer, tilemap chunks).
@@ -1237,6 +1244,26 @@ g.label(position, 'target', [1, 1, 1, 1])
 - \`shard screenshot <scene> --out shot.png --frames 60\` renders headless (no window needed).
 - With the MCP server: \`screenshot\` returns the image; \`step\` advances frames; \`press\`/\`hold\`
   drive input; \`query_entities\` / \`get_entity\` read state; \`recent_errors\` shows what failed.
+`,
+  "check-in-browsers.md": `# Check it in real browsers
+
+Headless screenshots are for regressions. Filtering, color and canvas compositing only show in a
+browser, and so do real frame times.
+
+1. Write a plan (\`.shard/schemas/capture-plan.schema.json\`): the URL (\`shard dev\`'s, or a host
+   page), browsers, DPRs, viewport, and shots with a \`state\` the page's
+   \`installCapturePage(app, { apply })\` understands. \`shard dev\` pages take shots as they are.
+2. \`shard capture plan.json --out captures/latest --json\` takes them, runs \`steps\` and their
+   \`expect\` checks in every client, and records each \`scenario\` (\`records/*.json\`).
+3. \`shard compare captures/latest --approved captures/approved --json\` diffs against approved
+   images (\u0394E2000 and SSIM) and writes \`report.html\`. Changed or new shots fail.
+4. A change you meant: \`shard approve <shot> --reason "why it looks different"\`. A change you
+   didn't: fix it. Approvals without a reason are refused.
+5. \`shard perf-check captures/latest/records --plan plan.json\` fails on a broken threshold and
+   names the metric, the value and the budget.
+
+With the MCP server attached to a running page: \`metrics_reset\`, exercise the scene, then
+\`metrics_record\` returns the same record the scripts write.
 `
 };
 function agentsBlock(manifest) {
@@ -1252,13 +1279,15 @@ component schemas, game code is ECS (components, systems) in \`scripts/\`.
 shard validate --json     # manifest, assets, scenes: every error with a path
 shard import --json       # import new and changed asset files
 shard mv <from> <to>      # move an asset and rewrite references to it
+shard tiles read <map>    # tilemap cells as rows; tiles edit <map> --cell x,y=name
 shard run --frames 600    # headless run
 shard screenshot ${manifest.startScene} --out shot.png
 shard test --json         # gameplay tests in tests/
 shard check --json        # type-check scripts: file, line, column
 shard gen <generator> --seeds 1-9 --out sheet.png   # preview a generator's outputs
 shard dev                 # play it in a browser; saves hot reload in place
-shard docs                # regenerate this block, .agents/, and .shard/schemas/
+shard capture plan.json   # real-browser shots and perf records; then compare, approve, perf-check
+shard docs              # regenerate this block, .agents/, and .shard/schemas/
 shard mcp                 # MCP server for this project (see .mcp.json)
 \`\`\`
 
@@ -1309,6 +1338,11 @@ function generateDocs(manifest, errors) {
     ".shard/schemas/prefab.schema.json": `${JSON.stringify(prefabJsonSchema(), null, 2)}
 `,
     ".shard/schemas/save.schema.json": `${JSON.stringify(saveJsonSchema(), null, 2)}
+`,
+    // Browser verification (0062): other renderers' pages validate their records against it.
+    ".shard/schemas/perf-record.schema.json": `${JSON.stringify(perfRecordJsonSchema(), null, 2)}
+`,
+    ".shard/schemas/capture-plan.schema.json": `${JSON.stringify(capturePlanJsonSchema(), null, 2)}
 `
   };
   for (const [name, content] of Object.entries(SKILLS))

package/dist/host.d.ts

@@ -1,4 +1,4 @@
-import type { GpuContext } from '@aethervtt/shard-gpu';
+import type { BakedTranslations, GpuContext } from '@aethervtt/shard-gpu';
 import type { AudioBackend, InputSource, Platform } from '@aethervtt/shard-platform';
 import { type RenderTarget } from '@aethervtt/shard-render';
 import { App, type Plugin } from '@aethervtt/shard-runtime';
@@ -12,6 +12,11 @@ export interface BuildAppOptions {
     canvas?: HTMLCanvasElement | OffscreenCanvas;
     /** Headless stand-in for the window (CLI screenshots). */
     target?: RenderTarget;
+    /**
+     * The project's baked WebGL2 translations (`shard shaders bake`), or their URL: on WebGL2, the
+     * shaders they cover load without naga (0064). WebGPU never reads them.
+     */
+    webgl2Shaders?: string | URL | BakedTranslations;
     inputSource?: InputSource;
     /** Where sound goes (`platform.audio`). Without one, audio records voices (headless). */
     audio?: AudioBackend;

package/dist/host.js

@@ -1,7 +1,9 @@
 import { animationPlugin } from "@aethervtt/shard-animation";
 import { audioPlugin } from "@aethervtt/shard-audio";
+import { controlsPlugin } from "@aethervtt/shard-controls";
+import { dicePlugin } from "@aethervtt/shard-dice";
 import { gltfPlugin } from "@aethervtt/shard-gltf";
-import { inputPlugin } from "@aethervtt/shard-input";
+import { gesturesPlugin, inputPlugin } from "@aethervtt/shard-input";
 import { loadNavCache, Nav, navGridPlugin, navPlugin } from "@aethervtt/shard-nav";
 import { noisePlugin } from "@aethervtt/shard-noise";
 import { particlesPlugin } from "@aethervtt/shard-particles";
@@ -20,8 +22,13 @@ import { uiPlugin } from "@aethervtt/shard-ui";
 function buildApp(options) {
   const { manifest } = options;
   const names = new Set(manifest.plugins);
-  if (names.has("sprite") || names.has("text") || names.has("particles") || names.has("animation"))
+  if (names.has("sprite") || names.has("text") || names.has("particles") || names.has("animation") || names.has("dice"))
     names.add("render/forward");
+  if (names.has("controls")) {
+    names.add("gestures");
+    names.add("render/forward");
+  }
+  if (names.has("gestures")) names.add("input");
   if (names.has("render/forward")) {
     names.add("render");
     names.add("core/transform");
@@ -33,7 +40,12 @@ function buildApp(options) {
   if (names.has("core/transform")) app.addPlugin(TransformPlugin);
   if (names.has("render")) {
     app.addPlugin(
-      renderPlugin({ gpu: options.gpu, canvas: options.canvas, target: options.target })
+      renderPlugin({
+        gpu: options.gpu,
+        canvas: options.canvas,
+        target: options.target,
+        webgl2: options.webgl2Shaders ? { shaders: options.webgl2Shaders } : void 0
+      })
     );
   }
   if (names.has("render/forward")) {
@@ -44,9 +56,12 @@ function buildApp(options) {
   if (names.has("text")) app.addPlugin(textPlugin);
   if (names.has("particles")) app.addPlugin(particlesPlugin);
   if (names.has("animation")) app.addPlugin(animationPlugin);
-  if (names.has("physics3d")) app.addPlugin(physics3dPlugin);
-  if (names.has("physics2d")) app.addPlugin(physics2dPlugin);
+  if (names.has("dice")) app.addPlugin(dicePlugin());
+  if (names.has("physics3d")) app.addPlugin(physics3dPlugin());
+  if (names.has("physics2d")) app.addPlugin(physics2dPlugin());
   if (names.has("input")) app.addPlugin(inputPlugin({ source: options.inputSource }));
+  if (names.has("gestures")) app.addPlugin(gesturesPlugin);
+  if (names.has("controls")) app.addPlugin(controlsPlugin);
   if (names.has("audio")) app.addPlugin(audioPlugin({ backend: options.audio }));
   if (names.has("ui")) app.addPlugin(uiPlugin);
   if (names.has("nav")) app.addPlugin(navPlugin);

package/dist/manifest.d.ts

@@ -18,6 +18,9 @@ export declare const Manifest: import("@aethervtt/shard-core").ComponentDef<{
     readonly procgen: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
         cacheSize: import("@aethervtt/shard-core").FieldType<number, "u32">;
     }>, "object">;
+    readonly graphics: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        baseline: import("@aethervtt/shard-core").FieldType<"optional" | "required", "u8">;
+    }>, "object">;
     readonly plugins: import("@aethervtt/shard-core").FieldType<string[], "object">;
 }>;
 export type ManifestValue = Infer<typeof Manifest>;
@@ -34,11 +37,14 @@ export declare const BUILTIN_PLUGINS: {
     readonly physics3d: 'Rapier 3D rigid bodies, colliders, joints, raycasts (includes core/transform)';
     readonly physics2d: 'Rapier 2D physics in the XY plane (includes core/transform)';
     readonly input: 'keyboard, mouse, gamepad, touch, action maps';
+    readonly gestures: 'taps, long presses, drags, pinches, twists and the wheel as Gesture events, with claims and Escape to cancel (includes input)';
+    readonly controls: 'OrbitControls and MapControls on cameras, syncViews, PlaneDrag to drag entities along a plane, controls.describe (includes gestures, render/forward)';
     readonly audio: 'AudioSource, AudioListener, playSound, buses and ducking, spatial audio, voice limits (includes core/transform)';
     readonly ui: 'UiNode trees under a UiRoot: flexbox layout, text, images, buttons, sliders, text fields, world-anchored markers, themes (includes core/transform)';
     readonly nav: 'navigation: NavGrid A* (2D), NavMesh baked by Recast from NavSource geometry, OffMeshLink, path queries, NavAgent steering (includes core/transform)';
     readonly 'nav/grid': 'navigation on NavGrids only, without loading the Recast WASM (includes core/transform)';
     readonly terrain: 'planets: Planet cube-sphere terrain from noise graphs with LOD, geomorphing, oceans, biomes, collider chunks around characters, navmeshes on the surface; terrain.* methods (includes core/transform; add render/forward to draw it, physics3d for colliders)';
+    readonly dice: 'the dice table (0054): dice skins, face layouts and effect recipes as data, dice.play and dice.describe, dice/RollRequest in scenes; tracks record on the calling thread (includes render/forward)';
     readonly 'core/transform': 'Transform and hierarchy propagation';
 };
 export declare function manifestJsonSchema(): JsonSchema;

package/dist/manifest.js

@@ -39,9 +39,18 @@ const Manifest = defineSchema(
       },
       { description: "Generators (0042): output cache limits." }
     ),
+    graphics: t.struct(
+      {
+        baseline: t.enum(["optional", "required"], {
+          default: "optional",
+          description: "required: the project must run at the baseline tier (WebGPU compatibility mode, WebGL2), and shard validate checks it. optional: what the tier can't run is reported when it runs."
+        })
+      },
+      { description: "Graphics tiers (0064)." }
+    ),
     plugins: t.list(t.string, {
       default: ["render/forward", "input"],
-      description: "Engine plugins to enable, by name: render, render/forward, sprite, text, particles, animation, physics3d, physics2d, input, audio, ui, nav, nav/grid, core/transform."
+      description: "Engine plugins to enable, by name: render, render/forward, sprite, text, particles, animation, physics3d, physics2d, input, gestures, controls, audio, ui, nav, nav/grid, dice, core/transform."
     })
   },
   { description: "shard.json: the project manifest." }
@@ -89,11 +98,14 @@ const BUILTIN_PLUGINS = {
   physics3d: "Rapier 3D rigid bodies, colliders, joints, raycasts (includes core/transform)",
   physics2d: "Rapier 2D physics in the XY plane (includes core/transform)",
   input: "keyboard, mouse, gamepad, touch, action maps",
+  gestures: "taps, long presses, drags, pinches, twists and the wheel as Gesture events, with claims and Escape to cancel (includes input)",
+  controls: "OrbitControls and MapControls on cameras, syncViews, PlaneDrag to drag entities along a plane, controls.describe (includes gestures, render/forward)",
   audio: "AudioSource, AudioListener, playSound, buses and ducking, spatial audio, voice limits (includes core/transform)",
   ui: "UiNode trees under a UiRoot: flexbox layout, text, images, buttons, sliders, text fields, world-anchored markers, themes (includes core/transform)",
   nav: "navigation: NavGrid A* (2D), NavMesh baked by Recast from NavSource geometry, OffMeshLink, path queries, NavAgent steering (includes core/transform)",
   "nav/grid": "navigation on NavGrids only, without loading the Recast WASM (includes core/transform)",
   terrain: "planets: Planet cube-sphere terrain from noise graphs with LOD, geomorphing, oceans, biomes, collider chunks around characters, navmeshes on the surface; terrain.* methods (includes core/transform; add render/forward to draw it, physics3d for colliders)",
+  dice: "the dice table (0054): dice skins, face layouts and effect recipes as data, dice.play and dice.describe, dice/RollRequest in scenes; tracks record on the calling thread (includes render/forward)",
   "core/transform": "Transform and hierarchy propagation"
 };
 function manifestJsonSchema() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-project",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -16,29 +16,33 @@
     "README.md"
   ],
   "dependencies": {
-    "@aethervtt/shard-animation": "0.0.1",
-    "@aethervtt/shard-assets": "0.0.1",
-    "@aethervtt/shard-audio": "0.0.1",
-    "@aethervtt/shard-core": "0.0.1",
-    "@aethervtt/shard-gltf": "0.0.1",
-    "@aethervtt/shard-gpu": "0.0.1",
-    "@aethervtt/shard-input": "0.0.1",
-    "@aethervtt/shard-nav": "0.0.1",
-    "@aethervtt/shard-noise": "0.0.1",
-    "@aethervtt/shard-particles": "0.0.1",
-    "@aethervtt/shard-physics": "0.0.1",
-    "@aethervtt/shard-platform": "0.0.1",
-    "@aethervtt/shard-procgen": "0.0.1",
-    "@aethervtt/shard-protocol": "0.0.1",
-    "@aethervtt/shard-render": "0.0.1",
-    "@aethervtt/shard-runtime": "0.0.1",
-    "@aethervtt/shard-save": "0.0.1",
-    "@aethervtt/shard-scene": "0.0.1",
-    "@aethervtt/shard-sprite": "0.0.1",
-    "@aethervtt/shard-terrain": "0.0.1",
-    "@aethervtt/shard-text": "0.0.1",
-    "@aethervtt/shard-transform": "0.0.1",
-    "@aethervtt/shard-ui": "0.0.1"
+    "@aethervtt/shard-animation": "0.1.0",
+    "@aethervtt/shard-assets": "0.1.0",
+    "@aethervtt/shard-audio": "0.1.0",
+    "@aethervtt/shard-controls": "0.1.0",
+    "@aethervtt/shard-core": "0.1.0",
+    "@aethervtt/shard-dice": "0.1.0",
+    "@aethervtt/shard-fog": "0.1.0",
+    "@aethervtt/shard-gltf": "0.1.0",
+    "@aethervtt/shard-gpu": "0.1.0",
+    "@aethervtt/shard-input": "0.1.0",
+    "@aethervtt/shard-nav": "0.1.0",
+    "@aethervtt/shard-noise": "0.1.0",
+    "@aethervtt/shard-particles": "0.1.0",
+    "@aethervtt/shard-physics": "0.1.0",
+    "@aethervtt/shard-platform": "0.1.0",
+    "@aethervtt/shard-procgen": "0.1.0",
+    "@aethervtt/shard-protocol": "0.1.0",
+    "@aethervtt/shard-render": "0.1.0",
+    "@aethervtt/shard-runtime": "0.1.0",
+    "@aethervtt/shard-save": "0.1.0",
+    "@aethervtt/shard-scene": "0.1.0",
+    "@aethervtt/shard-sprite": "0.1.0",
+    "@aethervtt/shard-terrain": "0.1.0",
+    "@aethervtt/shard-text": "0.1.0",
+    "@aethervtt/shard-transform": "0.1.0",
+    "@aethervtt/shard-ui": "0.1.0",
+    "@aethervtt/shard-verify": "0.1.0"
   },
   "repository": {
     "type": "git",
@@ -50,6 +54,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+    "buildSha": "8e14c9896f82a3554b156f1ffdd68f2cc3e7d78a"
   }
 }