npm - castle-web-cli - Versions diffs - 0.4.128 → 0.4.130 - Mend

castle-web-cli 0.4.128 → 0.4.130

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (157) hide show

package/dist/agent-prompts.js +4 -4
package/dist/filesChanged.d.ts +2 -0
package/dist/filesChanged.js +6 -2
package/dist/ide.js +15 -4
package/dist/importBrowse.js +1 -0
package/dist/index.js +10 -4
package/dist/init.js +63 -15
package/dist/native/loop.js +1 -1
package/dist/native/tools.js +1 -1
package/dist/serve.d.ts +1 -0
package/dist/serve.js +20 -1
package/dist/shell/assets/index-BpOLUyVO.js +441 -0
package/dist/shell/assets/{index-CAq6f9B5.css → index-D6K-0YDB.css} +1 -1
package/dist/shell/index.html +2 -2
package/kits/physics-2d/CLAUDE.md +40 -23
package/kits/physics-2d/behaviors/Joints.jsx +4 -3
package/kits/physics-2d/behaviors/SoundPlayer.jsx +266 -0
package/kits/physics-2d/behaviors/Sprite.jsx +3 -3
package/kits/physics-2d/behaviors/Video.jsx +4 -3
package/kits/physics-2d/castle.json +1 -1
package/kits/physics-2d/editors/PlayOnly.jsx +15 -6
package/kits/physics-2d/editors/PxArtEditor.jsx +95 -31
package/kits/physics-2d/editors/SceneEditor.jsx +5 -5
package/kits/physics-2d/editors/SingleEditor.jsx +37 -8
package/kits/physics-2d/editors/StyleEditor.jsx +7 -4
package/kits/physics-2d/editors/pixelEditorChrome.jsx +7 -7
package/kits/physics-2d/editors/pixelInspector.jsx +13 -7
package/kits/physics-2d/editors/pxArtTimeline.jsx +29 -11
package/kits/physics-2d/editors/pxArtTimeline.module.css +11 -0
package/kits/physics-2d/engine/audioContext.js +41 -0
package/kits/physics-2d/engine/autoInspector.jsx +50 -33
package/kits/physics-2d/engine/blueprint.js +15 -3
package/kits/physics-2d/engine/liveReload.js +33 -21
package/kits/physics-2d/engine/media.js +29 -39
package/kits/physics-2d/engine/sound.js +316 -0
package/kits/physics-2d/engine/systemRegistry.js +1 -1
package/kits/physics-2d/engine/ui.jsx +274 -5
package/kits/physics-2d/engine/ui.module.css +137 -16
package/kits/physics-2d/scripts/testsounds.mjs +84 -0
package/kits/physics-2d/systems/media.js +31 -15
package/kits/physics-3d/CLAUDE.md +109 -0
package/kits/physics-3d/behaviors/Body.jsx +51 -0
package/kits/physics-3d/behaviors/Door.jsx +31 -0
package/kits/physics-3d/behaviors/Lookable.jsx +11 -0
package/kits/physics-3d/behaviors/Model.jsx +14 -0
package/kits/physics-3d/behaviors/Pickup.jsx +39 -0
package/kits/physics-3d/behaviors/Player.jsx +172 -0
package/kits/physics-3d/behaviors/Portal.jsx +19 -0
package/kits/physics-3d/behaviors/Shape.jsx +75 -0
package/kits/physics-3d/behaviors/Solid.jsx +11 -0
package/kits/physics-3d/behaviors/Transform.jsx +24 -0
package/kits/physics-3d/blueprints/barrel.scene +15 -0
package/kits/physics-3d/blueprints/crate.scene +29 -0
package/kits/physics-3d/blueprints/door.scene +35 -0
package/kits/physics-3d/blueprints/gem.scene +26 -0
package/kits/physics-3d/blueprints/pillar.scene +25 -0
package/kits/physics-3d/blueprints/platform.scene +23 -0
package/kits/physics-3d/blueprints/player.scene +29 -0
package/kits/physics-3d/blueprints/portal.scene +21 -0
package/kits/physics-3d/blueprints/rock.scene +14 -0
package/kits/physics-3d/blueprints/statue.scene +26 -0
package/kits/physics-3d/blueprints/tree.scene +14 -0
package/kits/physics-3d/blueprints/wall.scene +26 -0
package/kits/{basic-2d → physics-3d}/castle.json +23 -5
package/kits/physics-3d/docs/pxmodel-format.md +111 -0
package/kits/physics-3d/drawings/crate.pxart +26 -0
package/kits/physics-3d/drawings/door-edge.pxart +26 -0
package/kits/physics-3d/drawings/door.pxart +27 -0
package/kits/physics-3d/drawings/face.pxart +26 -0
package/kits/physics-3d/drawings/floor.pxart +27 -0
package/kits/physics-3d/drawings/platform.pxart +27 -0
package/kits/physics-3d/drawings/statue.pxart +27 -0
package/kits/physics-3d/drawings/wall.pxart +27 -0
package/kits/physics-3d/engine3d/PlayOnly3D.jsx +32 -0
package/kits/physics-3d/engine3d/PxModelEditor.jsx +619 -0
package/kits/physics-3d/engine3d/Scene3DEditor.jsx +618 -0
package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +309 -0
package/kits/physics-3d/engine3d/editor3dData.js +114 -0
package/kits/physics-3d/engine3d/editor3dInspector.jsx +404 -0
package/kits/physics-3d/engine3d/editorChrome.jsx +218 -0
package/kits/physics-3d/engine3d/editorWorld.js +249 -0
package/kits/physics-3d/engine3d/materials.js +174 -0
package/kits/physics-3d/engine3d/meshops.js +123 -0
package/kits/physics-3d/engine3d/modelEditorWorld.js +439 -0
package/kits/physics-3d/engine3d/modelFiles.js +139 -0
package/kits/physics-3d/engine3d/pxmodel.js +265 -0
package/kits/physics-3d/engine3d/thumbnails.js +137 -0
package/kits/physics-3d/engine3d/world3d.js +216 -0
package/kits/{basic-2d → physics-3d}/eslint.config.js +10 -25
package/kits/physics-3d/index.html +20 -0
package/kits/physics-3d/main.jsx +30 -0
package/kits/physics-3d/models/barrel.pxmodel +10 -0
package/kits/physics-3d/models/player.pxmodel +222 -0
package/kits/physics-3d/models/rock.pxmodel +30 -0
package/kits/physics-3d/models/tree.pxmodel +10 -0
package/kits/{basic-2d → physics-3d}/package-lock.json +140 -119
package/kits/{basic-2d → physics-3d}/package.json +11 -9
package/kits/{basic-2d → physics-3d}/pnpm-lock.yaml +162 -137
package/kits/physics-3d/scenes/main.scene +414 -0
package/kits/physics-3d/scenes/model-lab.scene +127 -0
package/kits/physics-3d/systems/physics3d.js +356 -0
package/package.json +5 -2
package/dist/shell/assets/index-DKu9ejyh.js +0 -436
package/kits/basic-2d/CLAUDE.md +0 -221
package/kits/basic-2d/behaviors/Camera.jsx +0 -43
package/kits/basic-2d/behaviors/Collider.jsx +0 -213
package/kits/basic-2d/behaviors/Layout.jsx +0 -53
package/kits/basic-2d/behaviors/Sprite.jsx +0 -357
package/kits/basic-2d/behaviors/tint.js +0 -47
package/kits/basic-2d/blueprints/cauldron.scene +0 -20
package/kits/basic-2d/docs/pxart-format.md +0 -377
package/kits/basic-2d/drawings/cauldron.pxart +0 -113
package/kits/basic-2d/editors/BlueprintLibrary.jsx +0 -270
package/kits/basic-2d/editors/ErrorBoundary.jsx +0 -59
package/kits/basic-2d/editors/PlayOnly.jsx +0 -31
package/kits/basic-2d/editors/PxArtEditor.jsx +0 -1092
package/kits/basic-2d/editors/SceneEditor.jsx +0 -1780
package/kits/basic-2d/editors/SelectionOverlay.jsx +0 -909
package/kits/basic-2d/editors/SingleEditor.jsx +0 -122
package/kits/basic-2d/editors/behaviorRegistry.js +0 -34
package/kits/basic-2d/editors/editorHistory.js +0 -157
package/kits/basic-2d/editors/inspectorSheet.js +0 -13
package/kits/basic-2d/editors/pixelCanvas.js +0 -11
package/kits/basic-2d/editors/pixelEditorChrome.jsx +0 -74
package/kits/basic-2d/editors/pixelGeometry.js +0 -140
package/kits/basic-2d/editors/pixelInspector.jsx +0 -633
package/kits/basic-2d/editors/pxArtEditorModel.js +0 -732
package/kits/basic-2d/editors/pxArtPlayback.js +0 -92
package/kits/basic-2d/editors/pxArtTimeline.jsx +0 -752
package/kits/basic-2d/editors/pxArtTimeline.module.css +0 -506
package/kits/basic-2d/editors/pxArtTools.js +0 -232
package/kits/basic-2d/editors/useArtboardFit.js +0 -105
package/kits/basic-2d/engine/ScenePlayer.jsx +0 -209
package/kits/basic-2d/engine/SceneUI.jsx +0 -59
package/kits/basic-2d/engine/assets.js +0 -15
package/kits/basic-2d/engine/autoInspector.jsx +0 -70
package/kits/basic-2d/engine/behaviorExtensions.js +0 -32
package/kits/basic-2d/engine/blueprint.js +0 -557
package/kits/basic-2d/engine/collider.js +0 -200
package/kits/basic-2d/engine/files.js +0 -141
package/kits/basic-2d/engine/liveReload.js +0 -88
package/kits/basic-2d/engine/pxart.js +0 -1032
package/kits/basic-2d/engine/pxartSmooth.js +0 -222
package/kits/basic-2d/engine/scene.js +0 -696
package/kits/basic-2d/engine/spriteGeometry.js +0 -32
package/kits/basic-2d/engine/systemRegistry.js +0 -16
package/kits/basic-2d/engine/ui.jsx +0 -695
package/kits/basic-2d/engine/ui.module.css +0 -2287
package/kits/basic-2d/index.html +0 -24
package/kits/basic-2d/main.jsx +0 -24
package/kits/basic-2d/scenes/main.scene +0 -16
package/kits/basic-2d/scripts/draw.mjs +0 -121
package/kits/physics-2d/behaviors/Sound.jsx +0 -163
package/kits/physics-2d/behaviors/Tone.jsx +0 -95
package/kits/physics-2d/engine/tone.js +0 -112
/package/kits/{basic-2d → physics-3d}/.prettierrc +0 -0
/package/kits/{basic-2d → physics-3d}/vite.config.js +0 -0

package/kits/basic-2d/index.html DELETED Viewed

@@ -1,24 +0,0 @@
-<!doctype html>
-<html>
-  <head>
-    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no" />
-    <meta name="color-scheme" content="dark" />
-    <title>Castle Basic 2D JS Kit</title>
-    <!-- Declare the dark scheme + opaque dark background statically, before the
-         JS-imported CSS module loads. Otherwise this frame paints with the
-         default (light) scheme first and only switches to dark once the module
-         applies -- and Safari fails to repaint a composited iframe on a
-         color-scheme change (WebKit bug 309097), leaving static panels like the
-         file list blank until a forced repaint (e.g. opening devtools). -->
-    <style>
-      html {
-        color-scheme: dark;
-        background: #0a0a0a;
-      }
-    </style>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/main.jsx"></script>
-  </body>
-</html>

package/kits/basic-2d/main.jsx DELETED Viewed

@@ -1,24 +0,0 @@
-import React from 'react';
-import { createRoot } from 'react-dom/client';
-import { isEdit, setup } from 'castle-web-sdk';
-import { PlayOnly } from './editors/PlayOnly';
-import { ErrorBoundary } from './editors/ErrorBoundary';
-import { SingleEditor } from './editors/SingleEditor';
-document.body.dataset.castleScreenshotTarget = 'viewport';
-setup();
-const root = document.getElementById('root');
-if (!root) throw new Error('Missing root element');
-// Route on URL params so the shell can mount each piece in its own panel iframe.
-// File browsing and the code/text editor are now builtin shell panels, so the
-// kit only renders the deck (play) and its rich per-file editors (scene/pxart):
-//   (no edit / ?edit=0)        -> play the deck (playtest panel)
-//   ?file=<path>[&editor=<id>] -> a single rich editor for that file
-const params = new URLSearchParams(window.location.search);
-function pick() {
-  const initialScene = params.get('scene') ?? undefined;
-  if (!isEdit()) return <PlayOnly initialScene={initialScene} />;
-  const file = params.get('file');
-  if (file) return <SingleEditor path={file} editor={params.get('editor') ?? undefined} />;
-  return <PlayOnly initialScene={initialScene} />;
-}
-createRoot(root).render(<ErrorBoundary>{pick()}</ErrorBoundary>);

package/kits/basic-2d/scenes/main.scene DELETED Viewed

@@ -1,16 +0,0 @@
-{
-  "background": "#1a1932",
-  "actors": [
-    {
-      "id": "cauldron",
-      "blueprint": "blueprints/cauldron.scene",
-      "components": {
-        "Layout": {
-          "x": 200,
-          "y": 300
-        }
-      }
-    }
-  ],
-  "name": "Main"
-}

package/kits/basic-2d/scripts/draw.mjs DELETED Viewed

@@ -1,121 +0,0 @@
-// `npm run draw -- <name>` — turn a terse svg-rect emission into a sprite.
-//
-// Reads an <svg> with one <rect> per pixel from stdin (or `--from <file>`),
-// decodes + palette-quantizes it onto the agent 16-color subset, and writes a
-// single-frame `drawings/<name>.pxart` in the deck (the script's cwd).
-//
-// This is a kit-layer concern: the `.pxart` format lives entirely in the kit
-// (engine/pxart.js); the harness has no knowledge of it.
-import * as fs from 'fs';
-import * as path from 'path';
-import {
-  svgRectToPxArt,
-  serializeCompact,
-  AGENT_PALETTE_16,
-  DEFAULT_RESOLUTION,
-} from '../engine/pxart.js';
-// Read all of stdin as a UTF-8 string. Resolves '' if stdin is a TTY with no
-// piped input so we can give a clear "no input" error instead of hanging.
-function readStdin() {
-  return new Promise((resolve, reject) => {
-    if (process.stdin.isTTY) {
-      resolve('');
-      return;
-    }
-    const chunks = [];
-    process.stdin.on('data', (c) => chunks.push(c));
-    process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
-    process.stdin.on('error', reject);
-  });
-}
-// Normalize a requested sprite name into a relative `drawings/<...>.pxart`
-// path. Tolerates a leading `drawings/` and/or a trailing `.pxart`/`.px.json`
-// so `draw ship`, `draw ship.pxart`, and `draw drawings/ship.pxart` all land in
-// the same place.
-function resolveSpritePath(dir, name) {
-  let rel = name.trim().replace(/\\/g, '/');
-  rel = rel.replace(/^\.?\/*/, '');
-  if (rel.startsWith('drawings/')) rel = rel.slice('drawings/'.length);
-  rel = rel.replace(/\.px\.json$/i, '').replace(/\.pxart$/i, '');
-  if (!rel) return null;
-  const drawingsDir = path.resolve(dir, 'drawings');
-  const filepath = path.resolve(drawingsDir, `${rel}.pxart`);
-  const within = path.relative(drawingsDir, filepath);
-  if (within.startsWith('..') || path.isAbsolute(within)) return null;
-  return filepath;
-}
-function getFlagValue(flag) {
-  const idx = process.argv.indexOf(flag);
-  return idx >= 0 ? process.argv[idx + 1] : undefined;
-}
-// All positional (non-flag) args after the script, in order.
-function positionals() {
-  const args = process.argv.slice(2);
-  const withValues = new Set(['--from']);
-  const out = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith('--')) {
-      if (withValues.has(args[i])) i++;
-      continue;
-    }
-    out.push(args[i]);
-  }
-  return out;
-}
-async function main() {
-  const name = positionals()[0];
-  if (!name) {
-    console.error('Usage: npm run draw -- <name> [--from FILE]   (svg-rect on stdin -> drawings/<name>.pxart)');
-    process.exit(1);
-  }
-  // The script's cwd is the deck; sprites land under <deck>/drawings/.
-  const dir = process.cwd();
-  const filepath = resolveSpritePath(dir, name);
-  if (!filepath) {
-    console.error(`Invalid sprite name: ${name}`);
-    process.exit(1);
-  }
-  const fromFile = getFlagValue('--from');
-  let svg;
-  if (fromFile) {
-    try {
-      svg = fs.readFileSync(path.resolve(fromFile), 'utf-8');
-    } catch (e) {
-      console.error(`Could not read --from file ${fromFile}: ${e instanceof Error ? e.message : String(e)}`);
-      process.exit(1);
-    }
-  } else {
-    svg = await readStdin();
-  }
-  if (!svg.trim()) {
-    console.error('No svg-rect input. Pipe an <svg> with <rect> cells via stdin or pass --from <file>.');
-    process.exit(1);
-  }
-  const art = svgRectToPxArt(svg, { resolution: DEFAULT_RESOLUTION, palette: AGENT_PALETTE_16 });
-  if (!art) {
-    console.error('Could not decode any pixels from the svg-rect input (no usable <rect fill="...">). Emit one <rect> per filled pixel on a 16x16 viewBox.');
-    process.exit(1);
-  }
-  fs.mkdirSync(path.dirname(filepath), { recursive: true });
-  fs.writeFileSync(filepath, serializeCompact(art), 'utf-8');
-  const rel = path.relative(path.resolve(dir), filepath);
-  console.log(`Wrote ${rel}`);
-}
-main().catch((e) => {
-  console.error(e instanceof Error ? e.message : String(e));
-  process.exit(1);
-});

package/kits/physics-2d/behaviors/Sound.jsx DELETED Viewed

@@ -1,163 +0,0 @@
-import { resolveDeckFile } from 'castle-web-sdk';
-import React from 'react';
-import { mediaElement, playMedia, playOneShot, setMediaPan, stopMedia } from '../engine/media';
-import { mediaFilesOfKind } from '../engine/files';
-import { Panel, SelectField } from '../engine/ui';
-import { AutoFields, overrideProps } from '../engine/autoInspector';
-import { PAN, UNIT } from '../engine/propertyRanges';
-// Plays a sound file (.mp3 / .wav / .m4a) from an actor.
-//
-// Two ways to use it. Set `playOnStart` and it plays when the scene starts --
-// music, ambience, a jingle on a game-over screen. Or leave it off and trigger
-// it from a behavior, through the handle this puts on the actor:
-//
-//   scene.getActor('sfx').runtime.sound.play();   // from the top
-//   await actor.runtime.sound.play();             // ...and wait for it to end
-//   actor.runtime.sound.stop();
-//
-// `play()` on a `polyphonic` sound overlaps copies instead of cutting the last
-// one off, which is what a sound effect fired twice in a row should do. Without
-// it, a second play restarts the one element, which is what music wants.
-//
-// Sound only plays during play, never in the editor: `update` is what wires the
-// element up, and the editor doesn't run it. Pressing Stop silences everything,
-// as does `scene.sound.stopAll()` (see systems/media.js).
-//
-// Browsers refuse to play audio until the player has touched the page. A sound
-// that starts before that isn't lost -- it's queued and starts on the first tap
-// or key (engine/media.js), which for a game is usually the first input anyway.
-export class Sound {
-  static behaviorName = 'Sound';
-  static defaultProps = {
-    file: '',
-    volume: 1,
-    playbackRate: 1,
-    pan: 0,
-    loop: false,
-    polyphonic: false,
-    playOnStart: true,
-  };
-  // Mirrors the clamps `readSettings` already applies at runtime, so the
-  // inspector can't author a value the sound would silently ignore -- including
-  // playbackRate's 0.01..10, where the classic editor's ceiling lives.
-  static propertyMeta = {
-    volume: UNIT,
-    playbackRate: { min: 0.01, max: 10, step: 0.05 },
-    pan: PAN,
-  };
-  constructor(props) {
-    this.props = props;
-  }
-  update(actor) {
-    if (!actor.runtime || actor.runtime.collected) return;
-    const file = resolveDeckFile(this.props.file);
-    const element = mediaElement(actor.id, 'audio', file);
-    if (!element) {
-      actor.runtime.sound = null;
-      return;
-    }
-    // Props are live: turning the volume down, the pitch up, or the loop on in
-    // the inspector takes effect on the sound already playing.
-    const settings = readSettings(this.props);
-    element.volume = settings.volume;
-    element.playbackRate = settings.playbackRate;
-    element.loop = settings.loop;
-    if (settings.pan !== 0) setMediaPan(element, settings.pan);
-    const handle = actor.runtime.sound;
-    if (!handle || handle.file !== file) {
-      actor.runtime.sound = makeHandle(file, element, () => readSettings(this.props));
-      if (this.props.playOnStart) void actor.runtime.sound.play();
-    } else {
-      handle.settings = settings;
-    }
-  }
-  static Inspector({ component, setComponent, override }) {
-    return (
-      <Panel title="Sound" overridden={override?.anyOverridden()}>
-        <SelectField
-          label="File"
-          value={component.file}
-          onChange={(file) => setComponent({ file })}
-          options={mediaFilesOfKind('audio')}
-          {...overrideProps(override, 'file')}
-        />
-        <AutoFields
-          defaultProps={Sound.defaultProps}
-          meta={Sound.propertyMeta}
-          component={component}
-          setComponent={setComponent}
-          only={['volume', 'playbackRate', 'pan', 'loop', 'polyphonic', 'playOnStart']}
-          override={override}
-        />
-      </Panel>
-    );
-  }
-}
-function clamp(value, min, max, fallback) {
-  return Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
-}
-function readSettings(props) {
-  return {
-    volume: clamp(props.volume, 0, 1, 1),
-    // The same ceiling the classic editor used: past 10x a sound is a click.
-    playbackRate: clamp(props.playbackRate, 0.01, 10, 1),
-    pan: clamp(props.pan, -1, 1, 0),
-    loop: Boolean(props.loop),
-    polyphonic: Boolean(props.polyphonic),
-  };
-}
-// What a behavior gets at `actor.runtime.sound`. Plain methods over the element,
-// so game code never has to know an <audio> is involved.
-//
-// `play()` returns a promise that resolves when the sound ends, so a behavior
-// can `await` one before doing the next thing. A looping sound resolves right
-// away rather than never -- awaiting something that by definition doesn't end
-// would hang the caller forever, and that is never what was meant.
-function makeHandle(file, element, currentSettings) {
-  const handle = {
-    file,
-    element,
-    settings: currentSettings(),
-    play() {
-      const s = handle.settings;
-      if (s.polyphonic) {
-        return playOneShot(file, { volume: s.volume, playbackRate: s.playbackRate, pan: s.pan });
-      }
-      try {
-        element.currentTime = 0;
-      } catch {
-        // Not seekable yet (still loading) -- it plays from the start anyway.
-      }
-      playMedia(element);
-      if (s.loop) return Promise.resolve();
-      return new Promise((resolve) => {
-        const done = () => resolve();
-        element.addEventListener('ended', done, { once: true });
-        element.addEventListener('error', done, { once: true });
-      });
-    },
-    resume() {
-      playMedia(element);
-    },
-    pause() {
-      element.pause();
-    },
-    stop() {
-      stopMedia(element);
-    },
-    get playing() {
-      return !element.paused;
-    },
-  };
-  return handle;
-}

package/kits/physics-2d/behaviors/Tone.jsx DELETED Viewed

@@ -1,95 +0,0 @@
-import React from 'react';
-import { playTone, WAVEFORMS } from '../engine/tone';
-import { Panel, SelectField } from '../engine/ui';
-import { AutoFields, overrideProps } from '../engine/autoInspector';
-import { PAN, POSITIVE, UNIT } from '../engine/propertyRanges';
-// Plays a synthesized note -- no audio file involved. This is the cheapest sound
-// a deck can make: a blip on a pickup, a thud on a miss, a rising scale as a
-// counter climbs. Nothing is downloaded and nothing is stored.
-//
-//   actor.runtime.tone.play();          // the note as configured
-//   actor.runtime.tone.play({ note: 72 });  // ...or override it per play
-//   await actor.runtime.tone.play();    // wait for the release to finish
-//
-// `note` is a MIDI number: 60 is middle C, 72 an octave up, +1 a semitone. The
-// envelope is attack (silence up to full) then release (full down to silence),
-// so the note's whole length is attack + release seconds.
-export class Tone {
-  static behaviorName = 'Tone';
-  static defaultProps = {
-    note: 60,
-    waveform: 'square',
-    attack: 0,
-    release: 0.3,
-    volume: 0.5,
-    pan: 0,
-    playOnStart: false,
-  };
-  // `note` is MIDI, which is genuinely 0..127. `attack`/`release` are seconds,
-  // so they get a floor but no ceiling.
-  static propertyMeta = {
-    note: { min: 0, max: 127, step: 1 },
-    attack: POSITIVE,
-    release: POSITIVE,
-    volume: UNIT,
-    pan: PAN,
-  };
-  constructor(props) {
-    this.props = props;
-  }
-  update(actor) {
-    if (!actor.runtime || actor.runtime.collected) return;
-    const handle = actor.runtime.tone;
-    if (!handle) {
-      actor.runtime.tone = makeHandle(() => this.props);
-      if (this.props.playOnStart) void actor.runtime.tone.play();
-    } else {
-      handle.props = this.props;
-    }
-  }
-  static Inspector({ component, setComponent, override }) {
-    return (
-      <Panel title="Tone" overridden={override?.anyOverridden()}>
-        <SelectField
-          label="Waveform"
-          value={component.waveform}
-          onChange={(waveform) => setComponent({ waveform })}
-          options={WAVEFORMS}
-          {...overrideProps(override, 'waveform')}
-        />
-        <AutoFields
-          defaultProps={Tone.defaultProps}
-          meta={Tone.propertyMeta}
-          component={component}
-          setComponent={setComponent}
-          only={['note', 'attack', 'release', 'volume', 'pan', 'playOnStart']}
-          override={override}
-        />
-      </Panel>
-    );
-  }
-}
-// `actor.runtime.tone`. `play(overrides)` takes the same fields as the props, so
-// one Tone actor can cover a whole scale without a component per note.
-function makeHandle(currentProps) {
-  const handle = {
-    props: currentProps(),
-    voice: null,
-    play(overrides) {
-      handle.voice = playTone({ ...handle.props, ...overrides });
-      return handle.voice.finished;
-    },
-    stop() {
-      handle.voice?.stop();
-      handle.voice = null;
-    },
-  };
-  return handle;
-}

package/kits/physics-2d/engine/tone.js DELETED Viewed

@@ -1,112 +0,0 @@
-// A synthesized note: one oscillator through an attack/release envelope. This
-// is the sound a deck can make with no audio file at all -- a blip on a pickup,
-// a beep on a wrong answer -- and it costs nothing to ship.
-//
-// Deliberately one voice and two envelope stages, matching what the classic
-// Castle editor's "tone" sample offers. Anything richer is an instrument, and an
-// instrument belongs in a music system, not here.
-import { getAudioContext, resumeAudioContext } from './audioContext';
-export const WAVEFORMS = ['square', 'sawtooth', 'sine', 'triangle', 'noise'];
-// Voices currently sounding, so play mode can be silenced on Stop.
-const voices = new Set();
-// MIDI note number to Hz. 69 is A440, 12 notes to the octave.
-export function noteToFrequency(note) {
-  const midi = Number.isFinite(note) ? note : 60;
-  return 440 * Math.pow(2, (midi - 69) / 12);
-}
-// A short burst of white noise, made once and reused. Noise is the one waveform
-// an oscillator can't produce, and it's what a percussive hit wants.
-let noiseBuffer = null;
-function getNoiseBuffer(ctx) {
-  if (noiseBuffer && noiseBuffer.sampleRate === ctx.sampleRate) return noiseBuffer;
-  const frames = Math.floor(ctx.sampleRate * 2);
-  const buffer = ctx.createBuffer(1, frames, ctx.sampleRate);
-  const data = buffer.getChannelData(0);
-  for (let i = 0; i < frames; i++) data[i] = Math.random() * 2 - 1;
-  noiseBuffer = buffer;
-  return buffer;
-}
-function makeSource(ctx, waveform, frequency) {
-  if (waveform === 'noise') {
-    const source = ctx.createBufferSource();
-    source.buffer = getNoiseBuffer(ctx);
-    source.loop = true;
-    return source;
-  }
-  const osc = ctx.createOscillator();
-  osc.type = WAVEFORMS.includes(waveform) ? waveform : 'square';
-  osc.frequency.value = frequency;
-  return osc;
-}
-// Play one note. Returns `{ stop, finished }` -- `finished` resolves when the
-// release has run out, so a caller can wait for it the way a Sound can.
-export function playTone({ note = 60, waveform = 'square', attack = 0, release = 0.4, volume = 1, pan = 0 } = {}) {
-  const ctx = getAudioContext();
-  if (!ctx) return { stop() {}, finished: Promise.resolve() };
-  resumeAudioContext();
-  const level = Number.isFinite(volume) ? Math.min(1, Math.max(0, volume)) : 1;
-  const rise = Math.max(0, Number.isFinite(attack) ? attack : 0);
-  // A note with no release at all clicks; give it a floor short enough to still
-  // read as instant.
-  const fall = Math.max(0.01, Number.isFinite(release) ? release : 0.4);
-  const start = ctx.currentTime;
-  const end = start + rise + fall;
-  const source = makeSource(ctx, waveform, noteToFrequency(note));
-  const gain = ctx.createGain();
-  gain.gain.setValueAtTime(0, start);
-  gain.gain.linearRampToValueAtTime(level, start + rise);
-  gain.gain.linearRampToValueAtTime(0, end);
-  let tail = gain;
-  if (pan && ctx.createStereoPanner) {
-    const panner = ctx.createStereoPanner();
-    panner.pan.value = Math.min(1, Math.max(-1, pan));
-    gain.connect(panner);
-    tail = panner;
-  }
-  source.connect(gain);
-  tail.connect(ctx.destination);
-  source.start(start);
-  source.stop(end);
-  const voice = { source, gain };
-  voices.add(voice);
-  const finished = new Promise((resolve) => {
-    source.addEventListener('ended', () => {
-      voices.delete(voice);
-      resolve();
-    });
-  });
-  return {
-    stop() {
-      voices.delete(voice);
-      try {
-        source.stop();
-      } catch {
-        // Already stopped -- nothing to do.
-      }
-    },
-    finished,
-  };
-}
-// Silence every sounding note. Play mode ending must not leave one ringing.
-export function stopAllTones() {
-  for (const voice of voices) {
-    try {
-      voice.source.stop();
-    } catch {
-      // Already stopped.
-    }
-  }
-  voices.clear();
-}

/package/kits/{basic-2d → physics-3d}/.prettierrc RENAMED Viewed

File without changes

/package/kits/{basic-2d → physics-3d}/vite.config.js RENAMED Viewed

File without changes