castle-web-cli 0.4.171 → 0.4.173

package/kits/physics-2d/CLAUDE.md

@@ -22,12 +22,12 @@ Do you already know what you want to make, or do you want to figure it out toget
 - Every actor is an instance of a **blueprint** (`blueprints/*.scene`) — see `## Blueprints` below. Always author the blueprint file yourself and reference it via `"blueprint"`. Don't write inline actors (full `components`, no `blueprint` field): the editor auto-migrates each one into its own new blueprint file on open, one per actor with no dedup, which litters the deck with junk blueprints.
 - Real game objects and scenery should usually be editable sprites: generate `.sprite` with `npm run draw -- name`, then place it via a `Sprite` component pointing at `drawings/name.sprite`. Dynamic UI/effects stay procedural.
 - A deck can also hold uploaded media (the Files panel's Upload button): `Sprite` draws image files as well as `.sprite`, and `Video` plays video files. Point their `file` at the deck path (`assets/logo.png`). For audio see `## Sound` below -- sound effects need no component at all.
-- The deck's body/UI font is picked in the Style editor (`theme.style`): canvas text reads `scene.font`. A second display face is imported in the behavior that uses it. See `## Deck font` below.
+- The deck's body/UI font is picked in the Theme editor (`theme.style`): canvas text reads `scene.font`. A second display face is imported in the behavior that uses it. See `## Deck font` below.
 - This kit is plain JavaScript. Use `.jsx` for files with JSX, `.js` otherwise; do not add TypeScript files or a new build step.
 - Space is reserved by the editor for play/stop; do not bind Space to gameplay.
 - Two render hooks: `draw(ctx)` is world space and scrolls with `Camera`; `drawUi(ctx)` is screen space (card units, camera-free). On-screen controls, gauges and HUD go in `drawUi`, never `draw`. The React `ui()` hook is deprecated — prefer `drawUi`.
 - Do not read `engine/`, `editors/`, or built-in behaviors (`Layout.jsx`, `Sprite.jsx`, `Collider.jsx`, `Camera.jsx`, and the physics ones — `RigidBody.jsx`, `Joints.jsx`, `Draggable.jsx`, `Slingshot.jsx`, `AnalogStick.jsx`) to build a game. Their public API is documented below. Forking is the exception: when you're deliberately copying a kit file into the deck to change it — an editor (see `## Editors`) or a behavior you're shadowing — read the original. `engine/` stays off-limits either way.
-- An editor is for content FILES the creator keeps coming back to (catalogs, dialogue, level tables) that nothing already opens. Scenes, sprites and styles have editors; per-actor settings belong on behavior props in the inspector — not in a new editor.
+- An editor is for content FILES the creator keeps coming back to (catalogs, dialogue, level tables) that nothing already opens. Scenes, sprites and themes have editors; per-actor settings belong on behavior props in the inspector — not in a new editor.
 - Details below: `## Behavior shape`, `## Scene file`, `## Blueprints`, `## Built-in behaviors`, `## Creating pixel art`, `## SceneRuntime API`, and `## Input shortcuts`.
 
 ## Editors
@@ -440,7 +440,7 @@ Name a sound by its filename without the extension, or by its full deck path. Tw
 
 ## Deck font
 
-A physics-2d deck picks its **deck font** in the Style editor — open
+A physics-2d deck picks its **deck font** in the Theme editor — open
 `theme.style` and choose one of the nine Castle faces, or None. That is the
 deck's body and UI face: `scene.font` returns it for `draw` / `drawUi`.
 
@@ -525,7 +525,8 @@ make it move.**
   - `bodyType: 'dynamic' | 'static' | 'kinematic'`. `dynamic` = simulated
     (gravity, collisions, forces). `static` = never moves (same as a lone
     Collider). `kinematic` = unpushable, but you move it by writing its Layout.
-  - `gravityScale` — multiplies world gravity for this body (`0` = floats).
+  - `gravityScale` — multiplies world gravity for this body (`0` = floats;
+    default, so newly added bodies don't fall until you opt in).
   - `drag` — linear damping (air resistance). `angularDrag` — spin damping.
   - `freezeRotation` — keep it from rotating (stays upright).
   - `velocityX` / `velocityY` — initial velocity, applied once when play starts.
@@ -649,7 +650,7 @@ see the SceneRuntime API below.
 ### Recipe: a launch-and-bounce game
 
 - Ball blueprint: `Layout` (square), `Sprite`, `Collider {shape:'circle',
-bounciness:0.6}`, `RigidBody {bodyType:'dynamic'}`, `Slingshot {}`.
+bounciness:0.6}`, `RigidBody {bodyType:'dynamic', gravityScale:1}`, `Slingshot {}`.
 - Walls/floor blueprint: `Layout`, `Collider {bounciness:0.4}` (no RigidBody →
   static).
 - Goal blueprint: `Collider {isTrigger:true}` + a `Goal` behavior with
@@ -835,7 +836,7 @@ To generate path art, emit an svg of **shapes** rather than per-pixel rects and
 - `scene.spawnFromBlueprint('blueprints/enemy.scene', { components: { Layout: { x, y } } })` — spawn an instance of a blueprint, same merge semantics as a placed instance. Prefer this over `spawnActor` when you're spawning copies of something that has (or should have) a blueprint, e.g. `scene.spawnFromBlueprint(actor.blueprint, { components: { Layout: { x: actor.components.Layout.x, y: actor.components.Layout.y } } })` to spawn another of the same kind as an existing actor.
 - `scene.despawnActor(id)` — remove an actor at runtime. Use this; don't `splice` + `delete` by hand.
 - `scene.sound` — the deck's sound library: `play(name, opts)`, `stopAll()`, `isLoaded`, `whenLoaded`, `has(name)`, `voiceCount`. See `## Sound`.
-- `scene.font` — the deck's font as a CSS family, for `ctx.font` in `draw` / `drawUi`. Always usable: the face picked in the Style editor, or a sans stack. See `## Deck font`.
+- `scene.font` — the deck's font as a CSS family, for `ctx.font` in `draw` / `drawUi`. Always usable: the face picked in the Theme editor, or a sans stack. See `## Deck font`.
 - `scene.status` — string you can set/read for game-state ('playing', 'gameover', ...).
 - `scene.load(sceneData)` — replace the running scene with the given scene data object.
 - `scene.readFromFile(name)` — read and parse a scene file (`'gameover.scene'`, `'levels/2.scene'`), returning its scene data. Use this instead of importing a `.scene` file.

package/kits/physics-2d/behaviors/Collider.jsx

@@ -304,7 +304,13 @@ export class Collider {
         </div>
 
         {/* Material (collider-wide) */}
-        <NumberField label="Density" value={density} onChange={(v) => setComponent({ density: v })} />
+        <NumberField
+          label="Density"
+          value={density}
+          min={0}
+          step={0.001}
+          onChange={(v) => setComponent({ density: v })}
+        />
         <AutoFields
           defaultProps={Collider.defaultProps}
           meta={Collider.propertyMeta}

package/kits/physics-2d/behaviors/RigidBody.jsx

@@ -24,7 +24,9 @@ export class RigidBody {
 
   static defaultProps = {
     bodyType: 'dynamic',
-    gravityScale: 1,
+    // New bodies float until the author opts into gravity — falling immediately
+    // on add is the common surprise when placing a dynamic body to push around.
+    gravityScale: 0,
     drag: 0.01,
     angularDrag: 0,
     freezeRotation: false,
@@ -44,10 +46,11 @@ export class RigidBody {
   // `drag`/`angularDrag` are matter's air friction, where values above 1 flip
   // the velocity sign and destabilize the body -- so 1 is a real ceiling, not a
   // convenience. `gravityScale` deliberately has none: negative is legitimate
-  // (it inverts gravity), as is scaling well past 1.
+  // (it inverts gravity), as is scaling well past 1. Drag steps at 0.005 so the
+  // scrubber lands on the default (0.01) and the finer authored values kits use.
   static propertyMeta = {
     gravityScale: { step: 0.1 },
-    drag: DAMPING,
+    drag: { ...DAMPING, step: 0.005 },
     angularDrag: DAMPING,
     angularVelocity: { step: 0.1 },
   };

package/kits/physics-2d/castle.json

@@ -59,7 +59,7 @@
       },
       {
         "ext": ".style",
-        "label": "Style",
+        "label": "Theme",
         "icon": "palette",
         "editor": "kit",
         "data": true
@@ -72,7 +72,7 @@
   "main": "main.jsx",
   "autoUpdateWhenImported": true,
   "title": "physics-2d",
-  "publishedVersion": "2026-09-10T20:09:53.271Z",
+  "publishedVersion": "2026-09-10T22:05:01.629Z",
   "imports": {
     "castle.base": {
       "deckId": "yRcmH4_aYllE",

package/kits/physics-2d/editors/SceneEditor.jsx

@@ -2303,6 +2303,7 @@ function BehaviorRow({
       component={component}
       setComponent={setComponent}
       override={override}
+      meta={Behavior?.propertyMeta}
     />
   );
   // Layout is core to every actor -- it cannot be removed. A component an

package/kits/physics-2d/editors/SingleEditor.jsx

@@ -1,7 +1,7 @@
 // Single-editor mount for the panel system. The shell (dockview) opens this as
 // its own iframe via the deck route in main.jsx:
 //   ?file=<path>[&editor=<id>]  -> <SingleEditor> (one editor for one file)
-// The shell only routes the kit's RICH file types here (scene / pxart / style);
+// The shell only routes the kit's RICH file types here (scene / pxart / theme);
 // file browsing and the code/text editor are now builtin shell panels.
 
 import React, { useCallback, useEffect, useRef, useState } from 'react';
@@ -29,7 +29,7 @@ import { collectAssets } from '../engine/assets';
 import { MainEditor, styles } from '../engine/ui';
 import { PxArtEditor } from './PxArtEditor';
 import { SceneEditor } from './SceneEditor';
-import { StyleEditor } from './StyleEditor';
+import { ThemeEditor } from './ThemeEditor';
 
 // Debounce per path on top of the SDK's save queue: this decides WHEN a change
 // is worth writing (a drag shouldn't write every frame), the queue decides that
@@ -308,9 +308,9 @@ export function SingleEditor({ path, editor, editorModule }) {
     body = (
       <PxArtEditor path={path} text={text} onChange={onChange} files={files} readOnly={readOnly} />
     );
-  } else if (kind === 'style') {
+  } else if (kind === 'theme') {
     body = (
-      <StyleEditor
+      <ThemeEditor
         path={path}
         text={text}
         onChange={onChange}

package/kits/physics-2d/editors/{StyleEditor.jsx → ThemeEditor.jsx}

@@ -1,4 +1,4 @@
-// Deck style picker for `theme.style`: a palette and a font.
+// Deck theme picker for `theme.style`: a palette and a font.
 //
 // Palettes: official entries come from OFFICIAL_PALETTES; a custom
 // `{ name, colors }` in the file shows as a read-only selected card.
@@ -19,8 +19,8 @@ import { OFFICIAL_PALETTES, parseThemeData, resolveDeckPalette } from '../engine
 import { EditorBody } from '../engine/ui';
 import { writeDeckFontModule } from './deckFont';
 import { usePreviewFaces } from './fontPreview';
-import { applyOfficialFont, applyOfficialPalette } from './styleTheme';
-import styles from './styleEditor.module.css';
+import { applyOfficialFont, applyOfficialPalette } from './theme';
+import styles from './themeEditor.module.css';
 
 function cardClassName(selected, clickable) {
   return [styles.card, selected ? styles.cardSelected : '', clickable ? '' : styles.cardStatic]
@@ -30,7 +30,7 @@ function cardClassName(selected, clickable) {
 
 // One card, palette or font: a head (name + meta) over whatever the type shows
 // of itself. A button when it can be picked, a plain div when it can't.
-function styleCard({ cardKey, name, meta, preview, selected, onPick }) {
+function themeCard({ cardKey, name, meta, preview, selected, onPick }) {
   // Inner wrapper is the flex column, not the <button>. WebKit still wraps
   // button contents in a shrink-to-fit anonymous box, so a flex button never
   // stretches its children on some iOS versions — the palette strip stays
@@ -70,7 +70,7 @@ function swatchStrip(colors) {
 }
 
 function paletteCard({ palette, selected, badge, onPick }) {
-  return styleCard({
+  return themeCard({
     cardKey: palette.id ?? 'custom',
     name: palette.name,
     meta: (
@@ -92,7 +92,7 @@ function paletteCard({ palette, selected, badge, onPick }) {
 // arrives it renders in the panel font, which reads as an ordinary label rather
 // than as a broken card.
 function fontCard({ face, loaded, selected, onPick }) {
-  return styleCard({
+  return themeCard({
     cardKey: face.name,
     name: face.label,
     preview: (
@@ -161,7 +161,7 @@ function FontSection({ text, onChange, onChangeFile, readOnly }) {
         code asks for another face.
       </p>
       <div className={styles.list}>
-        {styleCard({
+        {themeCard({
           cardKey: 'none',
           name: 'None',
           preview: <div className={styles.specimen}>The quick brown fox</div>,
@@ -181,7 +181,7 @@ function FontSection({ text, onChange, onChangeFile, readOnly }) {
   );
 }
 
-export function StyleEditor({ text, onChange, onChangeFile, readOnly = false }) {
+export function ThemeEditor({ text, onChange, onChangeFile, readOnly = false }) {
   // An editor host too old to hand over `onChangeFile` can still pick a
   // palette; a font needs a second file written, so it stays read-only there.
   const canPickFont = Boolean(onChangeFile) && !readOnly;

package/kits/physics-2d/editors/deckFont.js

@@ -24,7 +24,7 @@ const deleteFile = castleSdk.deleteFile ?? null;
 
 /** The whole content of `fonts.generated.js` for one face. */
 export function deckFontModuleSource(name) {
-  return `// Generated by the Style editor. Do not edit -- picking a font rewrites it.
+  return `// Generated by the Theme editor. Do not edit -- picking a font rewrites it.
 //
 // \`theme.style\` records that this deck's font is ${name}; this module is what
 // puts ${name}'s bytes in the published bundle. It has to name the face in a
@@ -39,7 +39,7 @@ export const deckFont = '${name}';
 /** An empty module, for the SDK too old to delete a file. Renders as no deck
  * font, same as the file being absent. */
 function emptyModuleSource() {
-  return `// Generated by the Style editor. Do not edit.
+  return `// Generated by the Theme editor. Do not edit.
 //
 // This deck has no font of its own; text renders in the default sans stack.
 export const deckFont = null;

package/kits/physics-2d/editors/{styleEditor.module.css → themeEditor.module.css}

@@ -1,4 +1,4 @@
-/* Deck style picker for theme.style: palette + font. Tokens match
+/* Deck theme picker for theme.style: palette + font. Tokens match
    engine/ui.module.css. */
 
 .root {
@@ -56,7 +56,7 @@
 
 .card {
   /* Block, not flex: WebKit's button anonymous box shrink-wraps flex
-     children (style editor palette strips on some iOS). appearance wipe
+     children (theme editor palette strips on some iOS). appearance wipe
      matches other kit buttons. */
   display: block;
   box-sizing: border-box;

package/kits/physics-2d/engine/avatarArt.js

@@ -0,0 +1,185 @@
+// A player's avatar for drawing in a scene, read through `User.get` once per
+// user id and kept for the page. Two pictures: the round one, the photo clipped
+// to a circle with their frame over it, and the face, the photo alone, square,
+// for a surface it should cover edge to edge. A player with no photo has no
+// avatar, and a caller keeps its default look.
+//
+// `avatarCanvas` is for code that draws with a canvas context, like a Box.
+// `avatarSpritePath` and `avatarFacePath` register a picture as image art in
+// `scene.sprites`, so a `Sprite` or a model face can show it by file path.
+
+import { User } from 'castle-web-sdk';
+import { imageArt } from './art';
+
+const SIZE = 128;
+
+// A frame is drawn around a photo two thirds its size, the proportion Castle's
+// own profile views use.
+const FRAMED_INSET = SIZE / 6;
+
+// userId -> { canvas, face }, present from the first ask; both fill in when the
+// read completes.
+const avatars = new Map();
+
+// The avatar for one user id, or null until it is loaded or when there is none.
+export function avatarCanvas(userId) {
+  return entryFor(userId)?.canvas ?? null;
+}
+
+// The user's photo alone, square, or null as for `avatarCanvas`.
+export function avatarFace(userId) {
+  return entryFor(userId)?.face ?? null;
+}
+
+function entryFor(userId) {
+  if (!userId) {
+    return null;
+  }
+  let entry = avatars.get(userId);
+  if (!entry) {
+    entry = { canvas: null, face: null };
+    avatars.set(userId, entry);
+    void load(userId, entry);
+  }
+  return entry;
+}
+
+// The `scene.sprites` path holding this user's round avatar, or null while there
+// is none. A `Sprite` with this `file` draws it.
+export function avatarSpritePath(scene, userId) {
+  return registered(scene, `avatars/${userId}.png`, avatarCanvas(userId));
+}
+
+// The same for the square face.
+export function avatarFacePath(scene, userId) {
+  return registered(scene, `avatars/${userId}-face.png`, avatarFace(userId));
+}
+
+function registered(scene, path, canvas) {
+  if (!canvas) {
+    return null;
+  }
+  if (!scene.sprites[path]) {
+    scene.sprites[path] = imageArt(path, canvas.toDataURL());
+  }
+  return path;
+}
+
+async function load(userId, entry) {
+  try {
+    const user = await User.get(userId);
+    const [photo, frame] = await Promise.all([loadImage(user?.photoUrl), loadImage(user?.frameUrl)]);
+    if (photo) {
+      entry.canvas = compose(photo, frame);
+      entry.face = square(photo);
+    }
+  } catch {
+    // A failed read leaves the entry without a canvas; the next page asks again.
+  }
+}
+
+function loadImage(url) {
+  if (!url) {
+    return Promise.resolve(null);
+  }
+  return new Promise((resolve) => {
+    const image = new Image();
+    image.onload = () => resolve(image);
+    image.onerror = () => resolve(null);
+    image.src = url;
+  });
+}
+
+// How much of the opaque box is cut from each side, so a round photo's edge and
+// its anti-aliased rim stay off the face.
+const FACE_INSET = 0.12;
+
+// The opaque box is never taken smaller than this share of the photo on either
+// axis. Transparency reaching far inward would otherwise blow a few pixels up
+// to the whole face.
+const FACE_MIN = 0.55;
+
+// The photo cropped to its opaque pixels and then inset, filling the square.
+// Profile photos are circles on a transparent ground, and a face texture wants
+// no corners and no rim.
+function square(photo) {
+  const canvas = document.createElement('canvas');
+  canvas.width = SIZE;
+  canvas.height = SIZE;
+  const ctx = canvas.getContext('2d');
+  ctx.drawImage(photo, 0, 0, SIZE, SIZE);
+  const box = atLeast(opaqueBox(ctx.getImageData(0, 0, SIZE, SIZE)), SIZE * FACE_MIN, SIZE);
+  const inset = Math.round(Math.min(box.width, box.height) * FACE_INSET);
+  const face = {
+    x: box.x + inset,
+    y: box.y + inset,
+    width: box.width - 2 * inset,
+    height: box.height - 2 * inset,
+  };
+  if (face.width <= 0 || face.height <= 0) {
+    return canvas;
+  }
+  const source = document.createElement('canvas');
+  source.width = SIZE;
+  source.height = SIZE;
+  source.getContext('2d').drawImage(canvas, 0, 0);
+  ctx.clearRect(0, 0, SIZE, SIZE);
+  ctx.drawImage(source, face.x, face.y, face.width, face.height, 0, 0, SIZE, SIZE);
+  return canvas;
+}
+
+// The box grown around its centre to at least `min` on each axis, kept inside
+// `size`.
+function atLeast(box, min, size) {
+  const out = { ...box };
+  for (const [at, extent] of [
+    ['x', 'width'],
+    ['y', 'height'],
+  ]) {
+    if (out[extent] < min) {
+      out[at] = Math.round(Math.min(Math.max(0, out[at] + out[extent] / 2 - min / 2), size - min));
+      out[extent] = Math.round(min);
+    }
+  }
+  return out;
+}
+
+// The smallest box holding every pixel with alpha over a small threshold.
+function opaqueBox({ data, width, height }) {
+  let left = width;
+  let top = height;
+  let right = -1;
+  let bottom = -1;
+  for (let y = 0; y < height; y += 1) {
+    for (let x = 0; x < width; x += 1) {
+      if (data[(y * width + x) * 4 + 3] > 16) {
+        left = Math.min(left, x);
+        top = Math.min(top, y);
+        right = Math.max(right, x);
+        bottom = Math.max(bottom, y);
+      }
+    }
+  }
+  if (right < 0) {
+    return { x: 0, y: 0, width, height };
+  }
+  return { x: left, y: top, width: right - left + 1, height: bottom - top + 1 };
+}
+
+function compose(photo, frame) {
+  const canvas = document.createElement('canvas');
+  canvas.width = SIZE;
+  canvas.height = SIZE;
+  const ctx = canvas.getContext('2d');
+  const inset = frame ? FRAMED_INSET : 0;
+  ctx.save();
+  ctx.beginPath();
+  ctx.arc(SIZE / 2, SIZE / 2, SIZE / 2 - inset, 0, Math.PI * 2);
+  ctx.clip();
+  ctx.drawImage(photo, inset, inset, SIZE - 2 * inset, SIZE - 2 * inset);
+  ctx.restore();
+  if (frame) {
+    ctx.drawImage(frame, 0, 0, SIZE, SIZE);
+  }
+  return canvas;
+}

package/kits/physics-2d/engine/files.js

@@ -119,13 +119,13 @@ export function mediaFilesOfKind(kind) {
 }
 // Which editor a file opens in when no `editorModule` was resolved. Media
 // viewing (image / audio / video) lives on castle.base now; this only covers
-// types this kit still routes itself (scene / sprite / style). Each extension
+// types this kit still routes itself (scene / sprite / theme). Each extension
 // gets its own line: legacy tooling matched one `endsWith` per `return`.
 export function getFileKind(path) {
   if (path.endsWith('.scene')) return 'scene';
   if (path.endsWith('.sprite')) return 'pxart';
   if (path.endsWith('.pxart')) return 'pxart';
-  if (path.endsWith('.style')) return 'style';
+  if (path.endsWith('.style')) return 'theme';
   if (path.endsWith('.js') || path.endsWith('.jsx')) return 'code';
   return 'text';
 }

package/kits/physics-2d/engine/physics/matterBridge.js

@@ -147,7 +147,7 @@ export function patchBody(body, actor) {
   // used the retired `kind: 'pickup'` label are still honored as sensors.
   body.isSensor = Boolean(collider.isTrigger || collider.kind === 'pickup');
   body.frictionAir = rb?.drag ?? 0.01;
-  body.plugin.gravityScale = rb?.gravityScale ?? 1;
+  body.plugin.gravityScale = rb?.gravityScale ?? 0;
   body.plugin.angularDrag = rb?.angularDrag ?? 0;
   // Density sets mass (= density x area) -- DYNAMIC bodies only. On a static or
   // kinematic body, setDensity would replace the infinite mass that setStatic
@@ -172,7 +172,7 @@ export function syncBodyToPoint(body, point, angleDeg) {
 export function applyWorldGravity(bodies, gravity) {
   for (const body of bodies) {
     if (body.isStatic || body.isSleeping) continue;
-    const scale = (body.plugin.gravityScale ?? 1) * gravity.scale;
+    const scale = (body.plugin.gravityScale ?? 0) * gravity.scale;
     body.force.x += body.mass * gravity.x * scale;
     body.force.y += body.mass * gravity.y * scale;
   }

package/kits/physics-2d/engine/scene.js

@@ -66,7 +66,7 @@ export class SceneRuntime {
     this.camera = undefined;
     this.status = undefined;
     // The deck's font as a CSS font-family value, always usable: the face
-    // picked in the Style editor, or a plain sans stack when there is none.
+    // picked in the Theme editor, or a plain sans stack when there is none.
     // For `draw` / `drawUi` hooks -- `ctx.font = `20px ${scene.font}`` -- since
     // canvas takes a family name, not a class. Prefer `drawUi` for HUD text;
     // the deprecated React `ui` overlay still inherits this face via CSS.

package/kits/physics-2d/fonts.generated.js

@@ -1,4 +1,4 @@
-// Generated by the Style editor. Do not edit -- picking a font rewrites it.
+// Generated by the Theme editor. Do not edit -- picking a font rewrites it.
 //
 // `theme.style` records that this deck's font is DMSans; this module is what
 // puts DMSans's bytes in the published bundle. It has to name the face in a

package/kits/physics-2d/package-lock.json

@@ -32,7 +32,7 @@
     },
     "../../sdk": {
       "name": "castle-web-sdk",
-      "version": "0.4.26",
+      "version": "0.4.28",
       "dev": true,
       "devDependencies": {
         "eslint": "^9.0.0",

package/kits/physics-3d/behaviors/Body.jsx

@@ -6,6 +6,7 @@
 import React from 'react';
 import { SelectField } from '@imports/castle.physics-2d/engine/ui';
 import { AutoFields, overrideProps } from '@imports/castle.physics-2d/engine/autoInspector';
+import { POSITIVE } from '@imports/castle.physics-2d/engine/propertyRanges';
 
 const TYPE_OPTIONS = [
   { value: 'fixed', label: 'Fixed' },
@@ -25,6 +26,7 @@ function BodyInspector({ component, setComponent, override }) {
       />
       <AutoFields
         defaultProps={Body.defaultProps}
+        meta={Body.propertyMeta}
         component={component}
         setComponent={setComponent}
         exclude={['type']}
@@ -41,10 +43,17 @@ export class Body {
     type: 'fixed', // 'fixed' | 'dynamic' | 'kinematic'
     friction: 0.6,
     restitution: 0,
-    gravityScale: 1,
+    // Match physics-2d RigidBody: newly added dynamics float until opted in.
+    gravityScale: 0,
     lockRotations: false,
   };
 
+  static propertyMeta = {
+    friction: POSITIVE,
+    restitution: POSITIVE,
+    gravityScale: { step: 0.1 },
+  };
+
   constructor(props) {
     this.props = props;
   }

package/kits/physics-3d/behaviors/Door.jsx

@@ -4,6 +4,11 @@
 export class Door {
   static behaviorName = 'Door';
   static defaultProps = { range: 3, slide: 2.1, speed: 2.5 };
+  static propertyMeta = {
+    range: { min: 0, step: 0.1 },
+    slide: { min: 0, step: 0.1 },
+    speed: { min: 0, step: 0.1 },
+  };
 
   constructor(props) {
     this.props = props;

package/kits/physics-3d/behaviors/Lookable.jsx

@@ -4,6 +4,9 @@
 export class Lookable {
   static behaviorName = 'Lookable';
   static defaultProps = { text: '', range: 4 };
+  static propertyMeta = {
+    range: { min: 0, step: 0.5 },
+  };
 
   constructor(props) {
     this.props = props;

package/kits/physics-3d/behaviors/Model.jsx

@@ -7,6 +7,10 @@
 export class Model {
   static behaviorName = 'Model';
   static defaultProps = { file: '', scale: 1, yOffset: 0 };
+  static propertyMeta = {
+    scale: { min: 0, step: 0.05 },
+    yOffset: { step: 0.05 },
+  };
 
   constructor(props) {
     this.props = props;

package/kits/physics-3d/behaviors/Pickup.jsx

@@ -14,6 +14,10 @@ function pickupKey(scene, actor) {
 export class Pickup {
   static behaviorName = 'Pickup';
   static defaultProps = { bob: 0.12, spin: 120 };
+  static propertyMeta = {
+    bob: { min: 0, step: 0.01 },
+    spin: { min: 0, step: 5 },
+  };
 
   constructor(props) {
     this.props = props;

package/kits/physics-3d/behaviors/Player.jsx

@@ -112,6 +112,13 @@ function findLookText(scene, actor, t, facing) {
 export class Player {
   static behaviorName = 'Player';
   static defaultProps = { speed: 6, turnSpeed: 2.4, jumpSpeed: 8, camDistance: 9, camHeight: 7 };
+  static propertyMeta = {
+    speed: { min: 0, step: 0.5 },
+    turnSpeed: { min: 0, step: 0.1 },
+    jumpSpeed: { min: 0, step: 0.5 },
+    camDistance: { min: 0, step: 0.5 },
+    camHeight: { min: 0, step: 0.5 },
+  };
 
   constructor(props) {
     this.props = props;

package/kits/physics-3d/behaviors/Shape.jsx

@@ -8,6 +8,7 @@
 import React from 'react';
 import { SelectField, TextField } from '@imports/castle.physics-2d/engine/ui';
 import { AutoFields, overrideProps } from '@imports/castle.physics-2d/engine/autoInspector';
+import { POSITIVE, UNIT } from '@imports/castle.physics-2d/engine/propertyRanges';
 
 const KIND_OPTIONS = [
   { value: 'box', label: 'Box' },
@@ -39,6 +40,7 @@ function ShapeInspector({ component, setComponent, override }) {
       )}
       <AutoFields
         defaultProps={Shape.defaultProps}
+        meta={Shape.propertyMeta}
         component={component}
         setComponent={setComponent}
         exclude={['kind', 'art', 'artRepeat']}
@@ -69,6 +71,17 @@ export class Shape {
     solid: false,
   };
 
+  static propertyMeta = {
+    width: POSITIVE,
+    height: POSITIVE,
+    depth: POSITIVE,
+    radius: POSITIVE,
+    roughness: UNIT,
+    metalness: UNIT,
+    clearcoat: UNIT,
+    emissiveIntensity: POSITIVE,
+  };
+
   constructor(props) {
     this.props = props;
   }

package/kits/physics-3d/castle.json

@@ -69,5 +69,5 @@
   "autoUpdateWhenImported": true,
   "deckId": "JH0SclbPVP0y",
   "cardId": "eXfAaUdbSU5A",
-  "publishedVersion": "2026-09-10T20:10:28.916Z"
+  "publishedVersion": "2026-09-10T22:05:11.276Z"
 }

package/kits/physics-3d/engine3d/editor3dInspector.jsx

@@ -332,6 +332,7 @@ function BehaviorPanel({
       component={component}
       setComponent={setComponent}
       override={override}
+      meta={Behavior?.propertyMeta}
     />
   );
   // Transform is core to every actor; a component an instance only has via

package/kits/physics-3d/fonts.generated.js

@@ -1,4 +1,4 @@
-// Generated by the Style editor. Do not edit -- picking a font rewrites it.
+// Generated by the Theme editor. Do not edit -- picking a font rewrites it.
 //
 // `theme.style` records that this deck's font is DMSans; this module is what
 // puts DMSans's bytes in the published bundle. It has to name the face in a