@origingame/engine 0.1.1 → 0.3.0

package/knowledge/wiki/video.md

@@ -0,0 +1,157 @@
+<!-- Generated from crates/og-api/api.ogt by `og api gen`. Do not edit: `og api check` fails on any difference; change api.ogt and regenerate. -->
+
+# The `video` module
+
+Footage in a game (docs/design.md §2.9): a `type video` asset cooked by ffmpeg into a texture array of its frames and its sound, loaded with og.load.video and played by og.VideoPlayer. The frame shown is a Texture (VideoInfo.texture, also VideoPlayer.texture) any material map, og.Sprite or UI image draws, and the sound plays on the entity's og.AudioSource in step with it.
+
+Playback is simulation: the og.video system (after the game's systems, before og.audio) advances VideoPlayer.time by the tick's dt times `speed` (not the time scale, so the picture stays with its sound), so the frame at a tick is the same on both hosts, in every run and after a snapshot is restored. With a 30 Hz tick a player started at 0 shows the source's frame 3 s in at tick 90.
+
+- **TypeScript**: functions are none at module level (its members live on the types below); components, resources and events are tokens on `og`.
+- **Publish builds**: kept (members may override).
+- **Skill**: `og-game`, which teaches the module (how much of it to use, and how to prove it).
+- **Index**: [every module and name](index.md).
+
+```ogt
+module video {
+  # declarations follow, each quoted below
+```
+
+<sub>`api.ogt` line 13361</sub>
+
+## Contents
+
+| Name | Kind | Summary |
+|---|---|---|
+| [`Video`](#type-Video) | handle | Cooked footage: its frames as a texture array, its sound (og.load.video). |
+| [`Video()`](#column-Video) | column kind | A Video handle field (0 is none). |
+| [`VideoInfo`](#type-VideoInfo) | struct | What og.load.video loaded. |
+| [`og.VideoPlayer`](#record-VideoPlayer) | component | Plays a loaded video: VideoInfo.texture shows its current frame (frame n is the source at n / fps seconds), and when the entity has an og.AudioSource the og.video system sets its sound, playing, pitch and loop each tick so the sound plays in step: a seek or a restart starts the sound again at the new time on the next tick (AudioSource.startOffset). Each player has a texture of its own (written to `texture`): the first player of a video takes VideoInfo.texture, each further one a texture the og.video system makes for it over the same decoded frames (one frame of GPU memory each), so two players at different times show different frames. Show a player's `texture`, not VideoInfo.texture, once a video has more than one player. |
+
+## Components, resources and events
+
+<a id="record-VideoPlayer"></a>
+
+### `og.VideoPlayer` (component)
+
+Plays a loaded video: VideoInfo.texture shows its current frame (frame n is the source at n / fps seconds), and when the entity has an og.AudioSource the og.video system sets its sound, playing, pitch and loop each tick so the sound plays in step: a seek or a restart starts the sound again at the new time on the next tick (AudioSource.startOffset). Each player has a texture of its own (written to `texture`): the first player of a video takes VideoInfo.texture, each further one a texture the og.video system makes for it over the same decoded frames (one frame of GPU memory each), so two players at different times show different frames. Show a player's `texture`, not VideoInfo.texture, once a video has more than one player.
+
+Token `og.VideoPlayer`, registered under the schema name `og.VideoPlayer`; its value type is `VideoPlayer`.
+
+| Field | Type | Default | Range | Unit | Notes | Doc |
+|---|---|---|---|---|---|---|
+| `video` | `Video` | `0` | — | — | — | The video (og.load.video's `video`); 0 plays nothing. |
+| `playing` | `boolean` | `true` | — | — | — | Whether time advances. |
+| `time` | `number` | `0` | ≥ 0 | `s` | — | Seconds into the video; written every tick, set it to seek. |
+| `speed` | `number` | `1` | 0 … 4 | — | tunable | The playback rate: 1 as cooked, 0.5 half speed (the sound's pitch follows). |
+| `loop` | `boolean` | `false` | — | — | — | Start again at 0 past the end; otherwise hold the last frame and set finished. |
+| `frame` | `number` | `0` | — | — | read only | Written: the frame shown, floor(time * fps). |
+| `finished` | `boolean` | `false` | — | — | read only | Written: a player without loop reached the end. |
+| `texture` | `Texture` | `0` | — | — | read only | Written: this player's texture (VideoInfo.texture for the video's first player, a texture of its own for each further one), for a material, sprite or UI image set up from the player. It keeps it while it lives. |
+
+```ogt
+component VideoPlayer {
+  doc "Plays a loaded video: VideoInfo.texture shows its current frame (frame n is the source at n / fps seconds), and when the entity has an og.AudioSource the og.video system sets its sound, playing, pitch and loop each tick so the sound plays in step: a seek or a restart starts the sound again at the new time on the next tick (AudioSource.startOffset). Each player has a texture of its own (written to `texture`): the first player of a video takes VideoInfo.texture, each further one a texture the og.video system makes for it over the same decoded frames (one frame of GPU memory each), so two players at different times show different frames. Show a player's `texture`, not VideoInfo.texture, once a video has more than one player."
+  field video Video "The video (og.load.video's `video`); 0 plays nothing."
+  field playing bool "Whether time advances." {
+    default true
+  }
+  field time f32 "Seconds into the video; written every tick, set it to seek." {
+    min 0
+    unit s
+  }
+  field speed f32 "The playback rate: 1 as cooked, 0.5 half speed (the sound's pitch follows)." {
+    default 1
+    min 0
+    max 4
+    tunable true
+  }
+  field loop bool "Start again at 0 past the end; otherwise hold the last frame and set finished."
+  field frame u32 "Written: the frame shown, floor(time * fps)." {
+    readonly true
+  }
+  field finished bool "Written: a player without loop reached the end." {
+    readonly true
+  }
+  field texture Texture "Written: this player's texture (VideoInfo.texture for the video's first player, a texture of its own for each further one), for a material, sprite or UI image set up from the player. It keeps it while it lives." {
+    readonly true
+  }
+}
+```
+
+<sub>`api.ogt` line 13393</sub>
+
+## Types
+
+<a id="type-Video"></a>
+
+### `Video` (handle)
+
+Cooked footage: its frames as a texture array, its sound (og.load.video).
+
+A generational handle: a number the engine hands out. A dead handle is an error value, never a crash.
+
+```ogt
+handle Video "Cooked footage: its frames as a texture array, its sound (og.load.video)."
+```
+
+<sub>`api.ogt` line 13366</sub>
+
+<a id="type-VideoInfo"></a>
+
+### `VideoInfo` (struct)
+
+What og.load.video loaded.
+
+| Field | Type | Default | Range | Unit | Notes | Doc |
+|---|---|---|---|---|---|---|
+| `video` | `Video` | `0` | — | — | — | The video. |
+| `texture` | `Texture` | `0` | — | — | — | The texture that shows the frame its og.VideoPlayer is at (frame 0 until one plays it). |
+| `sound` | `Sound` | `0` | — | — | — | Its sound track (og.load.sound's kind of handle, for an og.AudioSource); 0 when it has none or was cooked with `audio false`. |
+| `width` | `number` | `0` | — | — | — | Each frame's width in texels. |
+| `height` | `number` | `0` | — | — | — | Each frame's height in texels. |
+| `frames` | `number` | `0` | — | — | — | Frames kept (at most 256). |
+| `fps` | `number` | `0` | — | — | — | Frames per second kept. |
+| `seconds` | `number` | `0` | — | `s` | — | frames / fps. |
+| `format` | `string` | `""` | — | — | — | The frames' encoding on the GPU (`rgba8`, `bc7`, `astc4x4`, `etc2`). |
+| `bytes` | `number` | `0` | — | `bytes` | — | Bytes its frames take on the GPU. |
+
+```ogt
+struct VideoInfo {
+  doc "What og.load.video loaded."
+  field video Video "The video."
+  field texture Texture "The texture that shows the frame its og.VideoPlayer is at (frame 0 until one plays it)."
+  field sound Sound "Its sound track (og.load.sound's kind of handle, for an og.AudioSource); 0 when it has none or was cooked with `audio false`."
+  field width u32 "Each frame's width in texels."
+  field height u32 "Each frame's height in texels."
+  field frames u32 "Frames kept (at most 256)."
+  field fps u32 "Frames per second kept."
+  field seconds f32 "frames / fps." {
+    unit s
+  }
+  field format String "The frames' encoding on the GPU (`rgba8`, `bc7`, `astc4x4`, `etc2`)."
+  field bytes f64 "Bytes its frames take on the GPU." {
+    unit bytes
+  }
+}
+```
+
+<sub>`api.ogt` line 13375</sub>
+
+## Column kinds
+
+Each is a factory, `Video(value?, options?)`, that makes one field of a component or resource layout.
+
+| Column | Value | Typed array | Stride | Doc |
+|---|---|---|---|---|
+| <a id="column-Video"></a>`Video` | `Video` | `Uint32Array` | 2 | A Video handle field (0 is none). |
+
+```ogt
+column Video {
+  doc "A Video handle field (0 is none)."
+  array Uint32Array
+  stride 2
+  value Video
+}
+```
+
+<sub>`api.ogt` line 13368</sub>

package/knowledge/wiki/world.md

@@ -16,7 +16,7 @@ module world {
   # declarations follow, each quoted below
 ```
 
-<sub>`api.ogt` line 204</sub>
+<sub>`api.ogt` line 778</sub>
 
 ## Contents
 
@@ -26,11 +26,41 @@ module world {
 | [`Entity()`](#column-Entity) | column kind | An Entity field: (index, generation) pairs. |
 | [`SpawnDesc`](#type-SpawnDesc) | desc struct | How to spawn an entity. `{}` spawns an unnamed entity at the origin with a Transform. |
 | [`RestoreDesc`](#type-RestoreDesc) | desc struct | How world.restore takes a save. |
+| [`og.WorldRestored`](#record-WorldRestored) | event | A world.restore applied: the tick after it (the first whole tick after a save taken mid-tick, whose next step completes the saved tick) delivers this, read through world.events like any event. Everything in the world came back as saved, request numbers and resources the session filled included; the session did not (og-game §17), so a system that reads this resets what belongs to the session: it forgets requests answered long ago, asks the store again for the settings and progress, and closes a menu the player had open. Sent as that tick starts, not when the restore applies, so the world between the two hashes as the save did. |
 | [`QueryDesc`](#type-QueryDesc) | desc struct | Which entities a query matches. |
 | [`World`](#type-World) | interface | The world a system, a command or a game callback is handed. Game code never holds a world beyond the call it was passed to. |
 | [`Query`](#type-Query) | interface | A set of matched archetypes. Iterate archetypes, never entities one by one. |
 | [`ArchetypeView`](#type-ArchetypeView) | interface | One archetype's columns for this tick. Views are invalidated by structural changes; using a stale view throws with the tick and the system it belonged to. |
 
+## Components, resources and events
+
+<a id="record-WorldRestored"></a>
+
+### `og.WorldRestored` (event)
+
+A world.restore applied: the tick after it (the first whole tick after a save taken mid-tick, whose next step completes the saved tick) delivers this, read through world.events like any event. Everything in the world came back as saved, request numbers and resources the session filled included; the session did not (og-game §17), so a system that reads this resets what belongs to the session: it forgets requests answered long ago, asks the store again for the settings and progress, and closes a menu the player had open. Sent as that tick starts, not when the restore applies, so the world between the two hashes as the save did.
+
+Token `og.WorldRestored`, registered under the schema name `og.WorldRestored`; its value type is `WorldRestored`.
+
+| Field | Type | Default | Range | Unit | Notes | Doc |
+|---|---|---|---|---|---|---|
+| `from` | `number` | `0` | — | `ticks` | — | The tick the world was at when the restore applied. |
+| `tick` | `number` | `0` | — | `ticks` | — | The saved tick: og.Time's tick right after the restore. |
+
+```ogt
+event WorldRestored {
+  doc "A world.restore applied: the tick after it (the first whole tick after a save taken mid-tick, whose next step completes the saved tick) delivers this, read through world.events like any event. Everything in the world came back as saved, request numbers and resources the session filled included; the session did not (og-game §17), so a system that reads this resets what belongs to the session: it forgets requests answered long ago, asks the store again for the settings and progress, and closes a menu the player had open. Sent as that tick starts, not when the restore applies, so the world between the two hashes as the save did."
+  field from u32 "The tick the world was at when the restore applied." {
+    unit ticks
+  }
+  field tick u32 "The saved tick: og.Time's tick right after the restore." {
+    unit ticks
+  }
+}
+```
+
+<sub>`api.ogt` line 816</sub>
+
 ## Interfaces
 
 <a id="type-World"></a>
@@ -45,7 +75,7 @@ interface World {
   # members follow, each quoted below
 ```
 
-<sub>`api.ogt` line 249</sub>
+<sub>`api.ogt` line 833</sub>
 
 <a id="member-World-tick"></a>
 
@@ -63,7 +93,7 @@ Binding symbol `og_world_get_tick` · publish builds: kept
 prop tick u32 "Fixed steps taken since the world was created."
 ```
 
-<sub>`api.ogt` line 252</sub>
+<sub>`api.ogt` line 836</sub>
 
 <a id="member-World-spawn"></a>
 
@@ -91,7 +121,7 @@ fn spawn {
 }
 ```
 
-<sub>`api.ogt` line 254</sub>
+<sub>`api.ogt` line 838</sub>
 
 <a id="member-World-despawn"></a>
 
@@ -119,7 +149,7 @@ fn despawn {
 }
 ```
 
-<sub>`api.ogt` line 260</sub>
+<sub>`api.ogt` line 844</sub>
 
 <a id="member-World-alive"></a>
 
@@ -147,7 +177,7 @@ fn alive {
 }
 ```
 
-<sub>`api.ogt` line 266</sub>
+<sub>`api.ogt` line 850</sub>
 
 <a id="member-World-has"></a>
 
@@ -178,7 +208,7 @@ fn has {
 }
 ```
 
-<sub>`api.ogt` line 272</sub>
+<sub>`api.ogt` line 856</sub>
 
 <a id="member-World-insert"></a>
 
@@ -213,7 +243,7 @@ fn insert {
 }
 ```
 
-<sub>`api.ogt` line 280</sub>
+<sub>`api.ogt` line 864</sub>
 
 <a id="member-World-remove"></a>
 
@@ -244,7 +274,7 @@ fn remove {
 }
 ```
 
-<sub>`api.ogt` line 291</sub>
+<sub>`api.ogt` line 875</sub>
 
 <a id="member-World-get"></a>
 
@@ -275,7 +305,7 @@ fn get {
 }
 ```
 
-<sub>`api.ogt` line 299</sub>
+<sub>`api.ogt` line 883</sub>
 
 <a id="member-World-set"></a>
 
@@ -308,7 +338,7 @@ fn set {
 }
 ```
 
-<sub>`api.ogt` line 307</sub>
+<sub>`api.ogt` line 891</sub>
 
 <a id="member-World-resource"></a>
 
@@ -337,7 +367,7 @@ fn resource {
 }
 ```
 
-<sub>`api.ogt` line 316</sub>
+<sub>`api.ogt` line 900</sub>
 
 <a id="member-World-find"></a>
 
@@ -365,7 +395,7 @@ fn find {
 }
 ```
 
-<sub>`api.ogt` line 323</sub>
+<sub>`api.ogt` line 907</sub>
 
 <a id="member-World-nameOf"></a>
 
@@ -393,7 +423,7 @@ fn nameOf {
 }
 ```
 
-<sub>`api.ogt` line 329</sub>
+<sub>`api.ogt` line 913</sub>
 
 <a id="member-World-query"></a>
 
@@ -421,7 +451,7 @@ fn query {
 }
 ```
 
-<sub>`api.ogt` line 335</sub>
+<sub>`api.ogt` line 919</sub>
 
 <a id="member-World-events"></a>
 
@@ -450,7 +480,7 @@ fn events {
 }
 ```
 
-<sub>`api.ogt` line 341</sub>
+<sub>`api.ogt` line 925</sub>
 
 <a id="member-World-emit"></a>
 
@@ -481,7 +511,7 @@ fn emit {
 }
 ```
 
-<sub>`api.ogt` line 348</sub>
+<sub>`api.ogt` line 932</sub>
 
 <a id="member-World-instantiate"></a>
 
@@ -514,7 +544,7 @@ fn instantiate {
 }
 ```
 
-<sub>`api.ogt` line 356</sub>
+<sub>`api.ogt` line 940</sub>
 
 <a id="member-World-snapshot"></a>
 
@@ -537,13 +567,13 @@ fn snapshot {
 }
 ```
 
-<sub>`api.ogt` line 364</sub>
+<sub>`api.ogt` line 948</sub>
 
 <a id="member-World-restore"></a>
 
 #### `World.restore`
 
-Replace the world with a save that world.snapshot wrote: entities, components, names, resources, events and the modules' state, so the restored world hashes as the saved one did, on either host. The session stays: input (og.Input, og.Pointers, og.Gamepad), the player's bus volumes (og.Audio), the UI's focus and hover, and what lives outside the world (the platform's calls and clock, the language, the loaded assets, the command channel's scheduled steps, which keep their remaining delays though og.Time takes the saved tick). Called in a system or a command it applies when the tick ends, after the last system; elsewhere (GameDesc.start, between ticks) at once. A save a system took mid-tick restores to that moment of its tick (og.Time reads its tick): the next step completes it (the systems after the saver, then the engine's), so the ticks after it are the saved run's. The meshes and height fields its colliders name must be loaded or registered first (a save naming one that is not is refused). A save holds only the world: progress kept in module variables is not in it, so keep it in components and resources.
+Replace the world with a save that world.snapshot wrote: entities, components, names, resources, events and the modules' state, so the restored world hashes as the saved one did, on either host. The session stays: input (og.Input, og.Pointers, og.Gamepad), the player's bus volumes (og.Audio), the UI's focus and hover, and what lives outside the world (the platform's calls and clock, the language, the loaded assets, the command channel's scheduled steps, which keep their remaining delays though og.Time takes the saved tick, so an `og run --commands` script goes on to its last step or `quit` whether the save is of a later tick or an earlier one). Called in a system or a command it applies when the tick ends, after the last system; elsewhere (GameDesc.start, between ticks) at once. Either way the tick after it delivers og.WorldRestored, for the systems that reset what lives in the session. A save a system took mid-tick restores to that moment of its tick (og.Time reads its tick): the next step completes it (the systems after the saver, then the engine's), so the ticks after it are the saved run's. The meshes and height fields its colliders name must be loaded or registered first (a save naming one that is not is refused). A save holds only the world: progress kept in module variables is not in it, so keep it in components and resources.
 
 ```ts
 World.restore(save: string, desc?: RestoreDesc): Result<void>
@@ -560,14 +590,14 @@ Binding symbol `og_world_restore` · publish builds: kept
 
 ```ogt
 fn restore {
-  doc "Replace the world with a save that world.snapshot wrote: entities, components, names, resources, events and the modules' state, so the restored world hashes as the saved one did, on either host. The session stays: input (og.Input, og.Pointers, og.Gamepad), the player's bus volumes (og.Audio), the UI's focus and hover, and what lives outside the world (the platform's calls and clock, the language, the loaded assets, the command channel's scheduled steps, which keep their remaining delays though og.Time takes the saved tick). Called in a system or a command it applies when the tick ends, after the last system; elsewhere (GameDesc.start, between ticks) at once. A save a system took mid-tick restores to that moment of its tick (og.Time reads its tick): the next step completes it (the systems after the saver, then the engine's), so the ticks after it are the saved run's. The meshes and height fields its colliders name must be loaded or registered first (a save naming one that is not is refused). A save holds only the world: progress kept in module variables is not in it, so keep it in components and resources."
+  doc "Replace the world with a save that world.snapshot wrote: entities, components, names, resources, events and the modules' state, so the restored world hashes as the saved one did, on either host. The session stays: input (og.Input, og.Pointers, og.Gamepad), the player's bus volumes (og.Audio), the UI's focus and hover, and what lives outside the world (the platform's calls and clock, the language, the loaded assets, the command channel's scheduled steps, which keep their remaining delays though og.Time takes the saved tick, so an `og run --commands` script goes on to its last step or `quit` whether the save is of a later tick or an earlier one). Called in a system or a command it applies when the tick ends, after the last system; elsewhere (GameDesc.start, between ticks) at once. Either way the tick after it delivers og.WorldRestored, for the systems that reset what lives in the session. A save a system took mid-tick restores to that moment of its tick (og.Time reads its tick): the next step completes it (the systems after the saver, then the engine's), so the ticks after it are the saved run's. The meshes and height fields its colliders name must be loaded or registered first (a save naming one that is not is refused). A save holds only the world: progress kept in module variables is not in it, so keep it in components and resources."
   param save String "The text world.snapshot returned."
   param desc RestoreDesc "Whether a type whose layout changed since the save is mapped field by field."
   returns Result.Void "Refused, with nothing changed, for text world.snapshot did not write, a save from a newer engine, or a type whose layout changed since the save (a field added, removed or retyped, an enum's variants): the reason names the type and the fields, and the fix (`{ migrate: true }`, or keeping a saved type's fields stable between releases)."
 }
 ```
 
-<sub>`api.ogt` line 369</sub>
+<sub>`api.ogt` line 953</sub>
 
 <a id="type-Query"></a>
 
@@ -581,7 +611,7 @@ interface Query {
   # members follow, each quoted below
 ```
 
-<sub>`api.ogt` line 377</sub>
+<sub>`api.ogt` line 961</sub>
 
 <a id="member-Query-archetypes"></a>
 
@@ -604,7 +634,7 @@ fn archetypes {
 }
 ```
 
-<sub>`api.ogt` line 379</sub>
+<sub>`api.ogt` line 963</sub>
 
 <a id="member-Query-count"></a>
 
@@ -627,7 +657,7 @@ fn count {
 }
 ```
 
-<sub>`api.ogt` line 383</sub>
+<sub>`api.ogt` line 967</sub>
 
 <a id="type-ArchetypeView"></a>
 
@@ -641,7 +671,7 @@ interface ArchetypeView {
   # members follow, each quoted below
 ```
 
-<sub>`api.ogt` line 389</sub>
+<sub>`api.ogt` line 973</sub>
 
 <a id="member-ArchetypeView-count"></a>
 
@@ -659,7 +689,7 @@ Binding symbol `og_archetype_view_get_count` · publish builds: kept
 prop count u32 "The number of entities in the archetype."
 ```
 
-<sub>`api.ogt` line 391</sub>
+<sub>`api.ogt` line 975</sub>
 
 <a id="member-ArchetypeView-tick"></a>
 
@@ -677,7 +707,7 @@ Binding symbol `og_archetype_view_get_tick` · publish builds: kept
 prop tick u32 "The tick this view belongs to."
 ```
 
-<sub>`api.ogt` line 392</sub>
+<sub>`api.ogt` line 976</sub>
 
 <a id="member-ArchetypeView-entities"></a>
 
@@ -695,7 +725,7 @@ Binding symbol `og_archetype_view_get_entities` · publish builds: kept
 prop entities Uint32Array "The entities as (index, generation) pairs: entity i is at 2i and 2i + 1."
 ```
 
-<sub>`api.ogt` line 393</sub>
+<sub>`api.ogt` line 977</sub>
 
 <a id="member-ArchetypeView-entity"></a>
 
@@ -723,7 +753,7 @@ fn entity {
 }
 ```
 
-<sub>`api.ogt` line 394</sub>
+<sub>`api.ogt` line 978</sub>
 
 <a id="member-ArchetypeView-has"></a>
 
@@ -752,7 +782,7 @@ fn has {
 }
 ```
 
-<sub>`api.ogt` line 399</sub>
+<sub>`api.ogt` line 983</sub>
 
 <a id="member-ArchetypeView-column"></a>
 
@@ -784,7 +814,7 @@ fn column {
 }
 ```
 
-<sub>`api.ogt` line 405</sub>
+<sub>`api.ogt` line 989</sub>
 
 ## Types
 
@@ -805,7 +835,7 @@ handle Entity {
 }
 ```
 
-<sub>`api.ogt` line 209</sub>
+<sub>`api.ogt` line 783</sub>
 
 <a id="type-SpawnDesc"></a>
 
@@ -841,7 +871,7 @@ struct SpawnDesc {
 }
 ```
 
-<sub>`api.ogt` line 221</sub>
+<sub>`api.ogt` line 795</sub>
 
 <a id="type-RestoreDesc"></a>
 
@@ -863,7 +893,7 @@ struct RestoreDesc {
 }
 ```
 
-<sub>`api.ogt` line 236</sub>
+<sub>`api.ogt` line 810</sub>
 
 <a id="type-QueryDesc"></a>
 
@@ -887,7 +917,7 @@ struct QueryDesc {
 }
 ```
 
-<sub>`api.ogt` line 242</sub>
+<sub>`api.ogt` line 826</sub>
 
 ## Column kinds
 
@@ -906,4 +936,4 @@ column Entity {
 }
 ```
 
-<sub>`api.ogt` line 214</sub>
+<sub>`api.ogt` line 788</sub>

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@origingame/engine",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Origin Engine: the TypeScript API, generated from crates/og-api/api.ogt, its runtime on the web (wasm in a Worker) and native (napi addon) hosts, the player shell, and the agents' knowledge (skills, wiki, style catalogue) in knowledge/.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/fran0220/origin-engine.git",
+    "url": "git+https://github.com/originai-game/origin-engine.git",
     "directory": "packages/engine"
   },
-  "homepage": "https://github.com/fran0220/origin-engine#readme",
+  "homepage": "https://github.com/originai-game/origin-engine#readme",
   "bugs": {
-    "url": "https://github.com/fran0220/origin-engine/issues"
+    "url": "https://github.com/originai-game/origin-engine/issues"
   },
   "publishConfig": {
     "access": "public"
@@ -51,8 +51,9 @@
     "bun": ">=1.3"
   },
   "optionalDependencies": {
-    "@origingame/engine-darwin-arm64": "0.1.1",
-    "@origingame/engine-linux-x64": "0.1.1",
+    "@origingame/engine-darwin-arm64": "0.3.0",
+    "@origingame/engine-linux-x64": "0.3.0",
+    "@origingame/engine-win32-x64": "0.3.0",
     "@tsrs/darwin-arm64": "0.18.0-ts7.1.0-dev.20260929",
     "@tsrs/linux-arm64-gnu": "0.18.0-ts7.1.0-dev.20260929",
     "@tsrs/linux-arm64-musl": "0.18.0-ts7.1.0-dev.20260929",