npm - incanto - Versions diffs - 0.34.0 → 0.35.0 - Mend

incanto 0.34.0 → 0.35.0

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 (58) hide show

package/dist/2d.d.ts +5 -5
package/dist/2d.js +3 -3
package/dist/3d.d.ts +122 -14
package/dist/3d.js +5 -5
package/dist/{audit-C4kmDK0o.js → audit-C5oZGAru.js} +37 -0
package/dist/{behavior-CtPScDMo.d.ts → behavior-CGSCWOHB.d.ts} +310 -22
package/dist/{create-game-CFNqoqOX.js → create-game-B0Wfhi2-.js} +6 -5
package/dist/{create-game-QTfghzwM.js → create-game-BUD89Kqh.js} +20 -6
package/dist/debug.d.ts +1 -1
package/dist/{duplicate-DlOvknDO.js → duplicate-C716f-97.js} +1 -1
package/dist/{editor-switch-BJb-CWfA.d.ts → editor-switch-DyXEtH36.d.ts} +1 -1
package/dist/editor.js +1739 -1312
package/dist/env.d.ts +1 -1
package/dist/{environment-presets-B6WiUsaO.js → environment-presets-TAGvmM3z.js} +240 -74
package/dist/{errors-1dXlIwoR.d.ts → errors-BY2kL0hv.d.ts} +1 -1
package/dist/{gameplay-BxFtmfSe.js → gameplay-BvhcQbfJ.js} +75 -11
package/dist/gameplay.d.ts +12 -5
package/dist/gameplay.js +1 -1
package/dist/index.d.ts +22 -7
package/dist/index.js +6 -6
package/dist/{loader-DmXfj6Uv.d.ts → loader-CUcj00M8.d.ts} +19 -2
package/dist/{loader-BwR0DxeM.js → loader-Mig5fY4n.js} +97 -18
package/dist/net.d.ts +2 -2
package/dist/net.js +3 -3
package/dist/{particle-sim-CwJ5rI_P.d.ts → particle-sim-B-vZBF5R.d.ts} +1 -1
package/dist/{pathfinding-DRCe89SI.d.ts → pathfinding-DgOo2KNF.d.ts} +1 -1
package/dist/{physics-2d-BuyAwsW5.js → physics-2d-DqAclql-.js} +22 -9
package/dist/{physics-3d-C8Kn_Nyb.js → physics-3d-DxBH4sIF.js} +27 -11
package/dist/react.d.ts +2 -2
package/dist/react.js +1 -1
package/dist/{register-G3edsjJ2.js → register-BFLg0-_i.js} +490 -12
package/dist/{register-OodmuUMK.js → register-BjbPMA5B.js} +2 -2
package/dist/{register-BLPC10Mj.js → register-DSmIRAf7.js} +11 -5
package/dist/{schema-CcoWb32N.d.ts → schema-3ywbdlrv.d.ts} +10 -0
package/dist/{test-C4B5znap.js → test-9EokzbRd.js} +10 -10
package/dist/test.d.ts +4 -4
package/dist/test.js +2 -2
package/dist/vite.js +1 -1
package/editor/assets/{agent8-BTODHtdM.js → agent8-D3_GWeuh.js} +1 -1
package/editor/assets/{debug-CJEz4EwC.js → debug-CX0LDd1r.js} +1 -1
package/editor/assets/index-CMlKFT0C.js +10773 -0
package/editor/index.html +1 -1
package/package.json +1 -1
package/schemas/scene.schema.json +109 -0
package/skills/incanto-assets.md +21 -0
package/skills/incanto-behaviors-and-scripts.md +16 -0
package/skills/incanto-editor.md +17 -1
package/skills/incanto-gameplay-behaviors.md +6 -0
package/skills/incanto-hud.md +16 -0
package/skills/incanto-localization.md +132 -0
package/skills/incanto-node-reference.md +33 -18
package/skills/incanto-save-slots.md +152 -0
package/templates-app/beacon-isle-3d/package.json +1 -1
package/templates-app/tps-3d/package.json +1 -1
package/templates-app/village-quest-3d/PROJECT/Context.md +16 -0
package/templates-app/village-quest-3d/package.json +1 -1
package/templates-app/village-quest-3d/src/village.scene.json +25 -3
package/editor/assets/index-BYCso8Bf.js +0 -10696

package/editor/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Incanto Scene Editor</title>
     <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'><rect width='16' height='16' rx='3' fill='%236ee7dc'/><text x='8' y='12' text-anchor='middle' font-size='11' font-family='monospace' fill='%230e1018'>i</text></svg>" />
-    <script type="module" crossorigin src="./assets/index-BYCso8Bf.js"></script>
+    <script type="module" crossorigin src="./assets/index-CMlKFT0C.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "incanto",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/schemas/scene.schema.json CHANGED Viewed

@@ -325,6 +325,9 @@
         {
           "$ref": "#/$defs/UiImage"
         },
+        {
+          "$ref": "#/$defs/UiLanguageSelect"
+        },
         {
           "$ref": "#/$defs/UiPanel"
         },
@@ -1202,6 +1205,7 @@
             },
             "target": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "bone": {
@@ -1308,6 +1312,7 @@
             },
             "target": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "bone": {
@@ -1316,6 +1321,7 @@
             },
             "lookAt": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "maxAngleDeg": {
@@ -1423,6 +1429,7 @@
             },
             "follow": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "smoothing": {
@@ -2076,6 +2083,7 @@
             },
             "skinPath": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": "../Skin"
             },
             "skinYawOffset": {
@@ -2469,6 +2477,7 @@
             },
             "terrain": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             }
           },
@@ -2663,6 +2672,7 @@
             },
             "terrain": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             }
           },
@@ -2956,6 +2966,7 @@
             },
             "target": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "anchor": {
@@ -3093,6 +3104,7 @@
             },
             "target": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "anchor": {
@@ -4873,6 +4885,7 @@
             },
             "terrain": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             },
             "carve": {
@@ -5994,6 +6007,7 @@
             },
             "terrain": {
               "type": "string",
+              "description": "A node path: '%UniqueName', '/Absolute/From/Root', or relative to this node ('../Skin').",
               "default": ""
             }
           },
@@ -6609,6 +6623,101 @@
       },
       "required": ["name", "type"]
     },
+    "UiLanguageSelect": {
+      "type": "object",
+      "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped", "changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiLanguageSelect"
+        },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tags": {
+          "type": "object"
+        },
+        "props": {
+          "type": "object",
+          "properties": {
+            "anchor": {
+              "type": "string",
+              "enum": [
+                "topLeft",
+                "top",
+                "topRight",
+                "left",
+                "center",
+                "right",
+                "bottomLeft",
+                "bottom",
+                "bottomRight"
+              ],
+              "default": "topLeft"
+            },
+            "visible": {
+              "type": "boolean",
+              "default": true
+            },
+            "focusable": {
+              "type": "boolean",
+              "default": true
+            },
+            "draggable": {
+              "type": "boolean",
+              "default": false
+            },
+            "dropTarget": {
+              "type": "boolean",
+              "default": false
+            },
+            "label": {
+              "type": "string",
+              "default": "Language"
+            },
+            "options": {
+              "type": "string",
+              "default": ""
+            },
+            "value": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "additionalProperties": false
+        },
+        "script": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "props": {
+              "type": "object"
+            }
+          },
+          "required": ["name"]
+        },
+        "network": {
+          "type": "object"
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/node"
+          }
+        }
+      },
+      "required": ["name", "type"]
+    },
     "UiPanel": {
       "type": "object",
       "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped"],

package/skills/incanto-assets.md CHANGED Viewed

@@ -129,3 +129,24 @@ scene built that way stays plain JSON you can also hand-write.
 Swap in real art later by changing ONLY the `assets{}` entry — node props
 stay untouched.
+## Textures are shared automatically (3D)
+A hundred `Sprite3D`s pointing at one atlas cost **one** fetch, one decode and
+one GPU upload. The renderer's asset store keys textures by URL plus their
+sampler settings, so you never need to hoist a texture yourself or worry that
+spawning enemies re-downloads their sheet.
+Two consequences worth knowing:
+- **Do not mutate a texture you got from a node.** `Sprite3D` and `Terrain3D`
+  hold the shared master. The two nodes with per-node UV state
+  (`AnimatedSprite3D`'s frame window, `MeshInstance3D`'s `material.repeat`) get
+  a private clone automatically — you do not have to ask for it.
+- **`pixelArt: true` also turns mipmaps off**, which is what makes pixel art stay
+  crisp at distance instead of blurring into mud.
+A texture that 404s now shows up in `game.assetErrors()` alongside models, by the
+URL you wrote — so "why is my sprite invisible" is answerable without opening the
+network tab.

package/skills/incanto-behaviors-and-scripts.md CHANGED Viewed

@@ -38,6 +38,22 @@ class CoinCounter extends Behavior {
 registerBehavior('CoinCounter', CoinCounter);  // EXPLICIT — before loadScene
 ```
+**A behavior that holds progress should be able to save it.** `serialize()` /
+`deserialize(data)` are two more optional hooks in the same list, and they are
+what makes "continue where you left off" possible — see
+`incanto-save-slots.md`. Save only what a fresh `onReady` could not recreate.
+**A prop that holds a node path must say so.** Mark it `nodePath: true` and the
+editor rewrites it when the target is renamed; leave it off and the rename
+silently breaks the link (`getNodeOrNull` returns null, nothing throws).
+```ts
+static readonly props = {
+  target: { default: '', nodePath: true },   // fed to getNode/getNodeOrNull
+  damage: { default: 10 },
+};
+```
 ## The three-artifact contract (keep them in sync!)
 1. scene JSON `"script": {"name": "CoinCounter"}`

package/skills/incanto-editor.md CHANGED Viewed

@@ -81,9 +81,25 @@ Opens a local page (default `http://127.0.0.1:5179/`) with three panes:
   CharacterBody2D) are ROLLED BACK entirely with the error in the banner; the
   tree never shows a state the engine would reject. Right-click for
   duplicate / rename (or double-click the name) / cut / copy / paste-as-child /
-  delete — all act on the multi-selection. `+` adds a child of any registered
+  delete — all act on the multi-selection. **Rename REPAIRS references**: every
+  `connections[].from/to` and every node-path prop pointing at the node (or into
+  its subtree) is rewritten in the same edit, across all three path forms
+  (`%Unique`, `/root/…`, relative `../Skin`), and the editor reports what it
+  changed. A prop is rewritten only if its type declares `nodePath: true`, so a
+  text prop that merely reads "Player" is never touched. `+` adds a child of any registered
   type, `✕` deletes the selection. Selecting the ⚙ scene row edits the header
   (dimension, gravity with real inputs, environment/input/assets/multiplayer).
+- **CONNECTIONS on the selected node** — the inspector's last section shows what
+  the node **emits** and what it **receives**, each row being signal → target →
+  handler with a ✕ to remove and `+ connect` to add. Signals come from the node
+  type merged with its behavior's `static signals`; the target picker lists every
+  node in the scene; the handler is a dropdown of real methods when the target
+  has no script, and free text when it does (those handlers live in your
+  TypeScript, which the editor never loads). An end that no longer resolves is
+  marked red with the reason. For what a row cannot express — `filter`, `once`,
+  bound args — the scene header still has `connections` as raw JSON.
+  **Validation now runs WITH connections**: the editor used to strip them before
+  loading, so it reported green for a scene the game hard-fails to open.
 - **Viewport with DIRECT MANIPULATION** — a mode toolbar (top left) + the
   Unity/Godot keys: **W move · E rotate · R scale** (active mode highlighted).
   A collider-visibility toggle sits beside the mode tools, and it shows the

package/skills/incanto-gameplay-behaviors.md CHANGED Viewed

@@ -58,6 +58,12 @@ Two kinds of node path resolve from DIFFERENT origins — mixing them up is the
   enemy (a child of the Spawner) reaches the player with the ABSOLUTE
   `/root/Player`, never a bare `Player` (which would look under the enemy).
+Renaming a node in the editor now REWRITES both kinds for you (and reports what
+it changed), so the paths above stay valid across a rename. Hand-edited JSON
+still has to be kept in sync yourself — `bunx incanto-check` catches the
+connections, but a behavior prop pointing at a name that no longer exists
+resolves to null in silence.
 **Never write `/root/<RootName>/...`.** If your root node is named `Game`, the
 path is `/root/Player` — NOT `/root/Game/Player`: `/root/` already *is* the
 `Game` root, so `/root/Game/...` double-counts it and dangles at load. Likewise

package/skills/incanto-hud.md CHANGED Viewed

@@ -177,3 +177,19 @@ A drop on a CHILD of a slot counts as a drop on the slot (the cursor lands on th
 icon inside it, which is the normal case), a drop on nothing cancels, and a
 widget never drops onto itself.
+## More than one language
+Any text prop here can name a translation key instead of a literal:
+```json
+{ "name": "Score", "type": "UiText", "props": { "text": "@t:hud.score" } }
+```
+Strings live in the scene header's `strings` block, English is the base, and a
+key a locale omits falls back to English silently — which is the RIGHT answer
+whenever the English term is more precise or the translation would not fit.
+`UiLanguageSelect` is the picker, already wired.
+Read `incanto-localization.md` before adding a second language.

package/skills/incanto-localization.md ADDED Viewed

@@ -0,0 +1,132 @@
+---
+name: incanto-localization
+description: Ship a game in more than one language: a scene-header `strings` table, `"@t:key"` text props, `engine.t()`, and a ready-made UiLanguageSelect that switches live and persists. English is the base — a key a locale omits falls back to it silently, on purpose. Use whenever a game needs a language other than English, or a language setting.
+---
+# Localization — English base, other languages on top
+Ship a game in more than one language without a second build, a second scene, or
+a page reload.
+**English is the base and the default.** Every other locale is a partial overlay:
+anything it does not translate falls back to English, silently.
+## The rule that matters most
+> When a translation is ambiguous, when the English term is the more precise one,
+> or when the translation runs so much longer than the English that it breaks the
+> layout — **ship the English.**
+Leaving a key untranslated is a **decision**, not a gap to fill. `COMBO`,
+`BOSS`, `LV.`, `HP`, `x1.5` are usually clearer in English to players in every
+language, and a "Continue to the next chapter" that becomes three lines in a
+button will break your menu. Omit the key and the English appears. Nothing warns,
+nothing marks it, nothing logs.
+The only mistake worth reporting is a key **nothing** declares — a typo, which
+renders raw on screen. `bunx incanto-check` tells you at author time.
+## Declaring strings
+One `strings` block in the scene header, locale first:
+```json
+{
+  "format": 1, "type": "scene", "name": "Menu",
+  "strings": {
+    "en": {
+      "menu.start": "Start Game",
+      "menu.options": "Options",
+      "settings.language": "Language",
+      "hud.wave": "Wave {n}",
+      "hud.combo": "COMBO"
+    },
+    "ko": {
+      "menu.start": "게임 시작",
+      "menu.options": "설정",
+      "settings.language": "언어",
+      "hud.wave": "{n} 웨이브"
+    }
+  },
+  "root": { "...": "..." }
+}
+```
+`hud.combo` has no Korean entry on purpose — "COMBO" is the term players already
+read. It shows as `COMBO` in both languages, and that is correct.
+Tables **merge** across scenes: put your shared UI strings in the scene the game
+boots from, and a level that adds three lines of its own keeps them.
+## Using them
+A text prop becomes translatable by naming a key with `@t:` — the same shape as
+the `"$assetKey"` references you already write:
+```json
+{ "name": "Start", "type": "UiButton", "props": { "text": "@t:menu.start" } }
+{ "name": "Wave",  "type": "UiText",   "props": { "text": "@t:hud.wave" } }
+```
+Works on every text-bearing widget: `UiText.text`, `UiButton.text`,
+`UiBar.label`, `UiSelect.label`, `UiBanner.show()`, and `UiDialogue` lines,
+speakers and choices.
+From a behavior, `engine.t(key, params)`:
+```ts
+banner.show(this.engine.t('hud.wave', { n: this.wave }));
+```
+`{n}` slots are filled from `params`; a slot with no matching param is left
+alone rather than blanked.
+## The language picker
+One node. Do not build your own.
+```json
+{ "name": "Language", "type": "UiLanguageSelect",
+  "props": { "label": "@t:settings.language" } }
+```
+Its options are the locales your scene declares — a game shipping only English
+shows only English — each labeled with its own endonym (`한국어`, not `Korean`),
+because a player who cannot read the language on screen still has to find theirs.
+Picking one switches the game **live** and persists the choice through
+`engine.settings`, so the next visit opens in it.
+## What NOT to localize
+- **Values, not labels.** `UiSelect.options` are values the game compares
+  against (`"low,medium,high"`); translating them breaks the comparison.
+- **Node names, group names, asset keys, signal names, action names.** These are
+  identifiers.
+- **Anything a behavior parses.** If code does `if (value === 'start')`, that
+  string is an identifier wearing a label's clothes.
+## Verifying
+```bash
+bunx incanto-check src/scenes/menu.scene.json
+```
+Reports any `@t:` key that no locale declares. It says nothing about a key one
+locale omits — that is the design, not a warning.
+To check a language actually renders, set it and read the frame:
+```ts
+game.engine.locale.locale = 'ko';
+```
+Switching takes effect on the **next frame** — nothing to reload, nothing to
+invalidate. Widgets re-read their text every frame, which is what makes this
+work.
+## Fonts
+The engine's HUD uses the platform font stack. On a machine with no CJK face
+installed, Korean renders as boxes — that is the operating system, not the
+engine. If you ship Korean to an audience you do not control, add a webfont in
+your own page CSS and set it on the HUD layer.

package/skills/incanto-node-reference.md CHANGED Viewed

@@ -145,7 +145,7 @@ Signals: `finished`
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `snapToGround` | `null` | null |
-| `target` | `""` | string |
+| `target` | `""` | node path |
 | `bone` | `""` | string |
 ## `BoneLookAt3D` — `incanto/3d`
@@ -160,9 +160,9 @@ Signals: `finished`
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `snapToGround` | `null` | null |
-| `target` | `""` | string |
+| `target` | `""` | node path |
 | `bone` | `"Head"` | string |
-| `lookAt` | `""` | string |
+| `lookAt` | `""` | node path |
 | `maxAngleDeg` | `75` | number |
 | `weight` | `0.85` | number |
 | `forwardAxis` | `"+z"` | one of: `+x` `-x` `+y` `-y` `+z` `-z` |
@@ -178,7 +178,7 @@ Signals: `finished`
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
-| `follow` | `""` | string |
+| `follow` | `""` | node path |
 | `smoothing` | `0` | number |
 | `zoom` | `1` | number |
 | `limits` | `[]` | array |
@@ -289,7 +289,7 @@ Signals: `movementStateChanged(state)`
 | `moveAction` | `"move"` | string |
 | `jumpAction` | `"jump"` | string |
 | `sprintAction` | `"sprint"` | string |
-| `skinPath` | `"../Skin"` | string |
+| `skinPath` | `"../Skin"` | node path |
 | `skinYawOffset` | `0` | number |
 | `animations` | `{}` | object |
@@ -352,7 +352,7 @@ Signals: `movementStateChanged(state)`
 | `sway` | `0.5` | number |
 | `drape` | `null` | null |
 | `avoidWater` | `true` | boolean |
-| `terrain` | `""` | string |
+| `terrain` | `""` | node path |
 ## `Foliage3D` — `incanto/3d`
@@ -386,7 +386,7 @@ Signals: `movementStateChanged(state)`
 | `seed` | `1` | number |
 | `drape` | `null` | null |
 | `avoidWater` | `true` | boolean |
-| `terrain` | `""` | string |
+| `terrain` | `""` | node path |
 ## `HudLayer` — `incanto`
@@ -428,7 +428,7 @@ Signals: `movementStateChanged(state)`
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `type` | `"revolute"` | one of: `fixed` `revolute` `rope` `spring` |
-| `target` | `""` | string |
+| `target` | `""` | node path |
 | `anchor` | `[0,0]` | array |
 | `targetAnchor` | `[0,0]` | array |
 | `length` | `0` | number |
@@ -448,7 +448,7 @@ Signals: `movementStateChanged(state)`
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `snapToGround` | `null` | null |
 | `type` | `"spherical"` | one of: `fixed` `spherical` `rope` `spring` |
-| `target` | `""` | string |
+| `target` | `""` | node path |
 | `anchor` | `[0,0,0]` | array |
 | `targetAnchor` | `[0,0,0]` | array |
 | `length` | `0` | number |
@@ -731,7 +731,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `sunDirection` | `[0.5,0.8,0.3]` | array |
 | `sunColor` | `"#fff6e0"` | string |
 | `sunIntensity` | `1` | number |
-| `terrain` | `""` | string |
+| `terrain` | `""` | node path |
 | `carve` | `true` | boolean |
 | `flowForce` | `1` | number |
 | `spray` | `1` | number |
@@ -910,7 +910,7 @@ Signals: `timeout`
 | `leafFadeEnd` | `0` | number |
 | `leafShadows` | `true` | boolean |
 | `drape` | `null` | null |
-| `terrain` | `""` | string |
+| `terrain` | `""` | node path |
 ## `UILayer` — `incanto/2d`
@@ -1002,6 +1002,21 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `lineSh
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped`
+## `UiLanguageSelect` — `incanto`
+| Prop | Default | Kind |
+|---|---|---|
+| `anchor` | `"topLeft"` | one of: `topLeft` `top` `topRight` `left` `center` `right` `bottomLeft` `bottom` `bottomRight` |
+| `visible` | `true` | boolean |
+| `focusable` | `true` | boolean |
+| `draggable` | `false` | boolean |
+| `dropTarget` | `false` | boolean |
+| `label` | `"Language"` | string |
+| `options` | `""` | string |
+| `value` | `""` | string |
+Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
 ## `UiPanel` — `incanto`
 | Prop | Default | Kind |
@@ -1173,7 +1188,7 @@ wire their signals through scene `connections`. Full guide: `incanto-gameplay-be
 | Prop | Default | Kind |
 |---|---|---|
-| `water` | `""` | string |
+| `water` | `""` | node path |
 | `draft` | `0.35` | number |
 | `stiffness` | `3` | number |
 | `damping` | `3.5` | number |
@@ -1194,7 +1209,7 @@ Signals: `submerged` · `surfaced`
 | Prop | Default | Kind |
 |---|---|---|
-| `target` | `""` | string |
+| `target` | `""` | node path |
 | `speed` | `60` | number |
 | `stopRange` | `0` | number |
 | `loseRange` | `0` | number |
@@ -1248,7 +1263,7 @@ Signals: `dayPhaseChanged`
 | Prop | Default | Kind |
 |---|---|---|
-| `target` | `""` | string |
+| `target` | `""` | node path |
 | `offset` | `[]` | array |
 | `smoothing` | `0` | number |
 | `deadzone` | `0` | number |
@@ -1259,7 +1274,7 @@ Signals: `dayPhaseChanged`
 |---|---|---|
 | `restartAction` | `"restart"` | string |
 | `freezeOnEnd` | `true` | boolean |
-| `bannerPath` | `"%Banner"` | string |
+| `bannerPath` | `"%Banner"` | node path |
 Signals: `flowChanged`
@@ -1366,7 +1381,7 @@ Signals: `scoreChanged(score)` · `won` · `lost` · `lifeLost(lives)`
 | Prop | Default | Kind |
 |---|---|---|
-| `prefab` | `""` | string |
+| `prefab` | `""` | node path |
 | `interval` | `1` | number |
 | `max` | `0` | number |
 | `at` | `[]` | array |
@@ -1396,14 +1411,14 @@ Signals: `waveStarted(index)` · `waveCleared(index)` · `allCleared`
 | Prop | Default | Kind |
 |---|---|---|
-| `aggroTarget` | `""` | string |
+| `aggroTarget` | `""` | node path |
 | `aggroRange` | `12` | number |
 | `deAggroRange` | `0` | number |
 | `chaseSpeed` | `4` | number |
 | `wanderSpeed` | `1.4` | number |
 | `wanderRadius` | `8` | number |
 | `wanderChangeEvery` | `3` | number |
-| `goalTarget` | `""` | string |
+| `goalTarget` | `""` | node path |
 | `stopRange` | `1.2` | number |
 | `moveParent` | `false` | boolean |