bevy-ts 0.1.0-alpha.5 → 0.1.0-alpha.6

package/examples/arena/src/game.tsx

@@ -1,15 +1,15 @@
-// The arena: a player and a HUD in TSX, the enemies placed by assets/levels/arena.bsn, a camera, and
+// The arena: a player, a HUD and the sun in TSX, the enemies placed by assets/levels/arena.bsn, a camera, and
 // three systems that play. `bevy-ts dev src/game.tsx`.
 import { app, type Commands, type Entity, type Local, type Mut, type Query, ref, type Res, Startup, Time, Transform, type u32, Update, type With, type Without } from "bevy-ts";
+import { DirectionalLight } from "bevy-ts/bevy";
 import { Foe, Health } from "./enemy.tsx";
 import { Hud } from "./hud.tsx";
 import { Player, PlayerUnit } from "./player.tsx";
 
-/** The game's camera and light. The camera sits where the editor's first view does, so edit mode
- * opens on the same view. */
+/** The game's camera. It sits where the editor's first view does, so edit mode opens on the same
+ * view. */
 export function stage(commands: Commands) {
   commands.spawnNative("camera3d", { position: [-6, 5, 10], lookAt: [0, 0, 0] });
-  commands.spawnNative("directionalLight", { position: [3, 6, 2], lookAt: [0, 0, 0] });
 }
 
 /** Every 30 frames, each enemy within 10 units hurts the player by 5. */
@@ -44,6 +44,11 @@ export function cull(commands: Commands, enemies: Query<[Entity, Health], With<F
 const player = ref();
 app.scene("arena", () => (
   <>
+    {/* The sun is scene, not a startup's, so edit mode shows the arena lit. At (3, 6, 2), looking at the origin. */}
+    <entity name="sun">
+      <DirectionalLight shadow_maps_enabled />
+      <Transform translation={[3, 6, 2]} rotation={[-0.4341, 0.4107, 0.2323, 0.7674]} />
+    </entity>
     <PlayerUnit handle={player} />
     <Hud player={player} />
   </>

package/examples/cube/example.json

@@ -1,6 +1,6 @@
 {
   "id": "cube",
   "title": "Cube",
-  "description": "One cube bobbing on a sine wave: a component, a startup system and an update system.",
+  "description": "One cube bobbing on a sine wave: a scene, a component, a startup system and an update system.",
   "entry": "src/game.ts"
 }

package/examples/cube/src/cube.tsx

@@ -0,0 +1,19 @@
+// The cube's scene: the cube and the sun, so edit mode shows them before any system runs.
+// game.ts mounts it once `Mover` is defined.
+import { DirectionalLight, Transform } from "bevy-ts/bevy";
+import { Mover } from "./game.ts";
+
+export const Cube = () => (
+  <>
+    {/* At (3, 6, 2), looking at the origin. */}
+    <entity name="sun">
+      <DirectionalLight shadow_maps_enabled />
+      <Transform translation={[3, 6, 2]} rotation={[-0.4341, 0.4107, 0.2323, 0.7674]} />
+    </entity>
+    <entity name="cube">
+      <Transform />
+      <mesh shape="cuboid" size={[1, 1, 1]} color="#ff8800" />
+      <Mover />
+    </entity>
+  </>
+);

package/examples/cube/src/game.ts

@@ -1,16 +1,15 @@
 import { app, Component, type f32, Startup, Time, Transform, Update } from "bevy-ts";
 import type { Commands, Mut, Query, Res } from "bevy-ts";
+import { Cube } from "./cube.tsx";
 
 export class Mover extends Component {
   speed: f32 = 1;
   amplitude: f32 = 2;
 }
 
+/** The game's camera; the cube and the sun are the scene's, in cube.tsx. */
 export function scene(commands: Commands) {
   commands.spawnNative("camera3d", { position: [-3, 3, 6], lookAt: [0, 0, 0] });
-  commands.spawnNative("directionalLight", { position: [3, 6, 2], lookAt: [0, 0, 0] });
-  const cube = commands.spawnNative("cuboid", { size: [1, 1, 1], color: "#f80" });
-  commands.entity(cube).insert(Mover.of());
 }
 
 export function bob(time: Res<Time>, q: Query<[Mover, Mut<Transform>]>) {
@@ -19,4 +18,5 @@ export function bob(time: Res<Time>, q: Query<[Mover, Mut<Transform>]>) {
   });
 }
 
+app.scene("cube", Cube);
 app.addSystems(Startup, scene).addSystems(Update, bob);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bevy-ts",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.6",
   "description": "TypeScript for Bevy: components, systems and hot reload without recompiling Rust",
   "license": "MIT OR Apache-2.0",
   "repository": {
@@ -59,11 +59,11 @@
     "examples"
   ],
   "optionalDependencies": {
-    "@bevy-ts/darwin-arm64": "0.1.0-alpha.5",
-    "@bevy-ts/darwin-x64": "0.1.0-alpha.5",
-    "@bevy-ts/linux-arm64": "0.1.0-alpha.5",
-    "@bevy-ts/linux-x64": "0.1.0-alpha.5",
-    "@bevy-ts/win32-x64": "0.1.0-alpha.5"
+    "@bevy-ts/darwin-arm64": "0.1.0-alpha.6",
+    "@bevy-ts/darwin-x64": "0.1.0-alpha.6",
+    "@bevy-ts/linux-arm64": "0.1.0-alpha.6",
+    "@bevy-ts/linux-x64": "0.1.0-alpha.6",
+    "@bevy-ts/win32-x64": "0.1.0-alpha.6"
   },
   "devDependencies": {
     "json-schema-to-typescript": "^15.0.4",

package/protocol.d.ts

@@ -1,7 +1,7 @@
 // @generated by packages/bevy-ts/scripts/gen-protocol.mjs from protocol/bevy-ts.openrpc.json. Do not edit.
 
 /** The protocol version these types describe. */
-export const PROTOCOL_VERSION: "1.17.0";
+export const PROTOCOL_VERSION: "1.19.0";
 
 /**
  * An entity id: Entity::to_bits.
@@ -133,6 +133,13 @@ export type AssetLoadState = "not_loaded" | "loading" | "loaded" | "failed";
  * via the `definition` "LevelHash".
  */
 export type LevelHash = string;
+/**
+ * Who opened a level: app.level (ts), add_level (rust), bevy-ts/level_open (editor) or a scene's sidecar.
+ *
+ * This interface was referenced by `ProtocolTypes`'s JSON-Schema
+ * via the `definition` "LevelOpener".
+ */
+export type LevelOpener = "ts" | "rust" | "editor" | "sidecar";
 /**
  * A value the writer prints: a number (a float), {int}, a bool, a string, {type, lanes} for a vector or {path} for a variant or constant.
  *
@@ -307,6 +314,10 @@ export type LevelOp =
       path: string[];
       component: string;
     };
+/**
+ * Who opened a level: app.level (ts), add_level (rust), bevy-ts/level_open (editor) or a scene's sidecar.
+ */
+export type LevelOpener1 = "ts" | "rust" | "editor" | "sidecar";
 
 /**
  * This interface was referenced by `ProtocolTypes`'s JSON-Schema
@@ -1391,6 +1402,10 @@ export interface ViewportModeResult {
   ui: boolean;
   gamepadUnfocused: boolean;
   paused: boolean;
+  /**
+   * Whether the game's TS `Startup` systems have run in this world: false under `bevy-ts dev --edit` until the first play or step (1.18). Absent from older engines: treat the game as started.
+   */
+  started?: boolean;
 }
 /**
  * The editor camera's pose.
@@ -1900,6 +1915,7 @@ export interface LevelInfo {
    * The level's asset path.
    */
   path: string;
+  opener: LevelOpener;
   /**
    * The root file's hash as last applied.
    */
@@ -1921,6 +1937,55 @@ export interface LevelInfo {
 export interface LevelListResult {
   levels: LevelInfo[];
 }
+/**
+ * This interface was referenced by `ProtocolTypes`'s JSON-Schema
+ * via the `definition` "LevelOpenParams".
+ */
+export interface LevelOpenParams {
+  /**
+   * An asset path ending in .bsn.
+   */
+  file: string;
+}
+/**
+ * This interface was referenced by `ProtocolTypes`'s JSON-Schema
+ * via the `definition` "LevelOpenResult".
+ */
+export interface LevelOpenResult {
+  status: "opened" | "failed";
+  /**
+   * opened: the level's level_list entry.
+   */
+  level?: LevelInfo | null;
+  /**
+   * failed: invalid (not a .bsn path inside the asset root), not-found, or load (a file fails to parse or resolve).
+   */
+  reason?: string | null;
+  /**
+   * failed: each with its file, line and column where known.
+   */
+  diagnostics?: LevelDiagnostic[];
+}
+/**
+ * This interface was referenced by `ProtocolTypes`'s JSON-Schema
+ * via the `definition` "LevelCloseParams".
+ */
+export interface LevelCloseParams {
+  /**
+   * An open level's asset path.
+   */
+  file: string;
+}
+/**
+ * This interface was referenced by `ProtocolTypes`'s JSON-Schema
+ * via the `definition` "LevelCloseResult".
+ */
+export interface LevelCloseResult {
+  /**
+   * False when the level was not open.
+   */
+  closed: boolean;
+}
 /**
  * Give `entity`, or `level` and `namePath`.
  *
@@ -2097,7 +2162,7 @@ export interface LevelApplyResult {
  * via the `definition` "LevelWatchMessage".
  */
 export interface LevelWatchMessage {
-  event: "loaded" | "failed" | "written" | "external" | "rebased" | "conflict";
+  event: "opened" | "closed" | "loaded" | "failed" | "written" | "external" | "rebased" | "conflict";
   /**
    * The file the event is about.
    */
@@ -2110,6 +2175,7 @@ export interface LevelWatchMessage {
   id?: number | null;
   reason?: string | null;
   diagnostics?: LevelDiagnostic[];
+  opener?: LevelOpener1;
 }
 /**
  * This interface was referenced by `ProtocolTypes`'s JSON-Schema
@@ -2285,6 +2351,8 @@ export interface Methods {
   "bevy-ts/asset_preview_control": { params: AssetPreviewControlParams; result: AssetPreviewControlResult; crate: "bevy-ts-viewport"; watch: false };
   "bevy-ts/asset_preview_close": { params: AssetPreviewCloseParams; result: AssetPreviewCloseResult; crate: "bevy-ts-viewport"; watch: false };
   "bevy-ts/level_list": { params: undefined; result: LevelListResult; crate: "bevy-ts-levels"; watch: false };
+  "bevy-ts/level_open": { params: LevelOpenParams; result: LevelOpenResult; crate: "bevy-ts-levels"; watch: false };
+  "bevy-ts/level_close": { params: LevelCloseParams; result: LevelCloseResult; crate: "bevy-ts-levels"; watch: false };
   "bevy-ts/level_node": { params: LevelNodeParams; result: LevelNodeResult; crate: "bevy-ts-levels"; watch: false };
   "bevy-ts/level_catalog": { params: undefined; result: LevelCatalogResult; crate: "bevy-ts-levels"; watch: false };
   "bevy-ts/level_write": { params: LevelWriteParams; result: LevelWriteResult; crate: "bevy-ts-levels"; watch: false };