incanto 0.6.0 → 0.7.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 (32) hide show
  1. package/dist/2d.d.ts +7 -2
  2. package/dist/2d.js +3 -3
  3. package/dist/3d.d.ts +9 -3
  4. package/dist/3d.js +3 -3
  5. package/dist/{audio-player-DkBqRTs4.d.ts → audio-player-VSjk_vG8.d.ts} +1 -1
  6. package/dist/{behavior-CWhW3oa6.d.ts → behavior-e3kAmPGC.d.ts} +11 -0
  7. package/dist/{create-game-DkbZCNaV.js → create-game-CEFoFN8d.js} +3 -3
  8. package/dist/{create-game-B_sW_eiE.js → create-game-X5iRu6pf.js} +3 -3
  9. package/dist/debug.d.ts +3 -1
  10. package/dist/debug.js +56 -6
  11. package/dist/gameplay.d.ts +1 -1
  12. package/dist/index.d.ts +21 -4
  13. package/dist/index.js +3 -3
  14. package/dist/{loader-D2u0fVW2.d.ts → loader-y_X4zYO0.d.ts} +1 -1
  15. package/dist/net.d.ts +1 -1
  16. package/dist/{particle-sim-CFkILGwh.js → particle-sim-CrTE7c02.js} +36 -2
  17. package/dist/{physics-2d-Cgli1aju.js → physics-2d-DmQ540uR.js} +1 -1
  18. package/dist/{physics-3d-CBAQ12LY.js → physics-3d-CDjuhtt_.js} +1 -1
  19. package/dist/react.d.ts +1 -1
  20. package/dist/react.js +1 -1
  21. package/dist/{register-BJCfuuZ2.js → register-ClKnoILk.js} +34 -5
  22. package/dist/{register-Dd7Juujf.js → register-CscQqB7V.js} +44 -3
  23. package/dist/test.d.ts +2 -2
  24. package/dist/test.js +7 -7
  25. package/editor/assets/{agent8-MciFwn0v.js → agent8-1WJU-yXr.js} +1 -1
  26. package/editor/assets/{index-mofVSmuA.js → index-DzYFgZbl.js} +81 -81
  27. package/editor/index.html +1 -1
  28. package/package.json +1 -1
  29. package/schemas/scene.schema.json +175 -0
  30. package/skills/incanto-behaviors-and-scripts.md +25 -0
  31. package/skills/incanto-node-reference.md +35 -0
  32. package/skills/incanto-scene-json-authoring.md +19 -0
package/editor/index.html CHANGED
@@ -5,7 +5,7 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <title>Incanto Scene Editor</title>
7
7
  <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>" />
8
- <script type="module" crossorigin src="./assets/index-mofVSmuA.js"></script>
8
+ <script type="module" crossorigin src="./assets/index-DzYFgZbl.js"></script>
9
9
  <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
10
10
  <link rel="stylesheet" crossorigin href="./assets/index-DF3tMeKJ.css">
11
11
  </head>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "incanto",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
5
5
  "keywords": [
6
6
  "game-engine",
package/schemas/scene.schema.json CHANGED
@@ -415,6 +415,11 @@
415
415
  "type": "number",
416
416
  "default": 0
417
417
  },
418
+ "orderGroup": {
419
+ "type": "string",
420
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
421
+ "default": "default"
422
+ },
418
423
  "visible": {
419
424
  "type": "boolean",
420
425
  "default": true
@@ -551,6 +556,11 @@
551
556
  "type": "number",
552
557
  "default": 0
553
558
  },
559
+ "orderGroup": {
560
+ "type": "string",
561
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
562
+ "default": "default"
563
+ },
554
564
  "texture": {
555
565
  "type": "string",
556
566
  "default": ""
@@ -709,6 +719,11 @@
709
719
  "type": "number",
710
720
  "default": 0
711
721
  },
722
+ "orderGroup": {
723
+ "type": "string",
724
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
725
+ "default": "default"
726
+ },
712
727
  "visible": {
713
728
  "type": "boolean",
714
729
  "default": true
@@ -808,6 +823,11 @@
808
823
  "type": "number",
809
824
  "default": 0
810
825
  },
826
+ "orderGroup": {
827
+ "type": "string",
828
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
829
+ "default": "default"
830
+ },
811
831
  "collider": {
812
832
  "type": "object",
813
833
  "default": {}
@@ -1021,6 +1041,11 @@
1021
1041
  "type": "number",
1022
1042
  "default": 0
1023
1043
  },
1044
+ "orderGroup": {
1045
+ "type": "string",
1046
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1047
+ "default": "default"
1048
+ },
1024
1049
  "mode": {
1025
1050
  "type": "string",
1026
1051
  "enum": ["screen", "y", "none"],
@@ -1107,6 +1132,11 @@
1107
1132
  "type": "number",
1108
1133
  "default": 0
1109
1134
  },
1135
+ "orderGroup": {
1136
+ "type": "string",
1137
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1138
+ "default": "default"
1139
+ },
1110
1140
  "visible": {
1111
1141
  "type": "boolean",
1112
1142
  "default": true
@@ -1221,6 +1251,11 @@
1221
1251
  "type": "number",
1222
1252
  "default": 0
1223
1253
  },
1254
+ "orderGroup": {
1255
+ "type": "string",
1256
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1257
+ "default": "default"
1258
+ },
1224
1259
  "fov": {
1225
1260
  "type": "number",
1226
1261
  "default": 60
@@ -1319,6 +1354,11 @@
1319
1354
  "type": "number",
1320
1355
  "default": 0
1321
1356
  },
1357
+ "orderGroup": {
1358
+ "type": "string",
1359
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1360
+ "default": "default"
1361
+ },
1322
1362
  "visible": {
1323
1363
  "type": "boolean",
1324
1364
  "default": true
@@ -1435,6 +1475,11 @@
1435
1475
  "type": "number",
1436
1476
  "default": 0
1437
1477
  },
1478
+ "orderGroup": {
1479
+ "type": "string",
1480
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1481
+ "default": "default"
1482
+ },
1438
1483
  "collider": {
1439
1484
  "type": "object",
1440
1485
  "default": {}
@@ -1619,6 +1664,11 @@
1619
1664
  "type": "number",
1620
1665
  "default": 0
1621
1666
  },
1667
+ "orderGroup": {
1668
+ "type": "string",
1669
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1670
+ "default": "default"
1671
+ },
1622
1672
  "view": {
1623
1673
  "type": "string",
1624
1674
  "enum": ["free", "firstPerson", "quarter", "side"],
@@ -1785,6 +1835,11 @@
1785
1835
  "type": "number",
1786
1836
  "default": 0
1787
1837
  },
1838
+ "orderGroup": {
1839
+ "type": "string",
1840
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1841
+ "default": "default"
1842
+ },
1788
1843
  "visible": {
1789
1844
  "type": "boolean",
1790
1845
  "default": true
@@ -1905,6 +1960,11 @@
1905
1960
  "type": "number",
1906
1961
  "default": 0
1907
1962
  },
1963
+ "orderGroup": {
1964
+ "type": "string",
1965
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
1966
+ "default": "default"
1967
+ },
1908
1968
  "color": {
1909
1969
  "type": "string",
1910
1970
  "default": "#ffffff"
@@ -2019,6 +2079,11 @@
2019
2079
  "type": "number",
2020
2080
  "default": 0
2021
2081
  },
2082
+ "orderGroup": {
2083
+ "type": "string",
2084
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2085
+ "default": "default"
2086
+ },
2022
2087
  "density": {
2023
2088
  "type": "string",
2024
2089
  "enum": ["lush", "sparse", "none"],
@@ -2155,6 +2220,11 @@
2155
2220
  "type": "number",
2156
2221
  "default": 2
2157
2222
  },
2223
+ "orderGroup": {
2224
+ "type": "string",
2225
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2226
+ "default": "default"
2227
+ },
2158
2228
  "kind": {
2159
2229
  "type": "string",
2160
2230
  "enum": ["grass", "flowers", "reeds"],
@@ -2388,6 +2458,11 @@
2388
2458
  "type": "number",
2389
2459
  "default": 0
2390
2460
  },
2461
+ "orderGroup": {
2462
+ "type": "string",
2463
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2464
+ "default": "default"
2465
+ },
2391
2466
  "visible": {
2392
2467
  "type": "boolean",
2393
2468
  "default": true
@@ -2521,6 +2596,11 @@
2521
2596
  "type": "number",
2522
2597
  "default": 0
2523
2598
  },
2599
+ "orderGroup": {
2600
+ "type": "string",
2601
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2602
+ "default": "default"
2603
+ },
2524
2604
  "type": {
2525
2605
  "type": "string",
2526
2606
  "enum": ["fixed", "spherical", "rope", "spring"],
@@ -2641,6 +2721,11 @@
2641
2721
  "type": "number",
2642
2722
  "default": 0
2643
2723
  },
2724
+ "orderGroup": {
2725
+ "type": "string",
2726
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2727
+ "default": "default"
2728
+ },
2644
2729
  "visible": {
2645
2730
  "type": "boolean",
2646
2731
  "default": true
@@ -2755,6 +2840,11 @@
2755
2840
  "type": "number",
2756
2841
  "default": 0
2757
2842
  },
2843
+ "orderGroup": {
2844
+ "type": "string",
2845
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2846
+ "default": "default"
2847
+ },
2758
2848
  "sections": {
2759
2849
  "type": "array",
2760
2850
  "default": []
@@ -2869,6 +2959,11 @@
2869
2959
  "type": "number",
2870
2960
  "default": 0
2871
2961
  },
2962
+ "orderGroup": {
2963
+ "type": "string",
2964
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
2965
+ "default": "default"
2966
+ },
2872
2967
  "mesh": {
2873
2968
  "type": "string",
2874
2969
  "enum": ["box", "sphere", "capsule", "plane", "cylinder", "gem"],
@@ -2986,6 +3081,11 @@
2986
3081
  "type": "number",
2987
3082
  "default": 0
2988
3083
  },
3084
+ "orderGroup": {
3085
+ "type": "string",
3086
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
3087
+ "default": "default"
3088
+ },
2989
3089
  "model": {
2990
3090
  "type": "string",
2991
3091
  "default": ""
@@ -3217,6 +3317,11 @@
3217
3317
  "type": "number",
3218
3318
  "default": 0
3219
3319
  },
3320
+ "orderGroup": {
3321
+ "type": "string",
3322
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
3323
+ "default": "default"
3324
+ },
3220
3325
  "visible": {
3221
3326
  "type": "boolean",
3222
3327
  "default": true
@@ -3310,6 +3415,11 @@
3310
3415
  "renderOrder": {
3311
3416
  "type": "number",
3312
3417
  "default": 0
3418
+ },
3419
+ "orderGroup": {
3420
+ "type": "string",
3421
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
3422
+ "default": "default"
3313
3423
  }
3314
3424
  },
3315
3425
  "additionalProperties": false
@@ -3401,6 +3511,11 @@
3401
3511
  "type": "number",
3402
3512
  "default": 0
3403
3513
  },
3514
+ "orderGroup": {
3515
+ "type": "string",
3516
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
3517
+ "default": "default"
3518
+ },
3404
3519
  "color": {
3405
3520
  "type": "string",
3406
3521
  "default": "#ffffff"
@@ -3495,6 +3610,11 @@
3495
3610
  "type": "number",
3496
3611
  "default": 0
3497
3612
  },
3613
+ "orderGroup": {
3614
+ "type": "string",
3615
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
3616
+ "default": "effects"
3617
+ },
3498
3618
  "visible": {
3499
3619
  "type": "boolean",
3500
3620
  "default": true
@@ -3699,6 +3819,11 @@
3699
3819
  "type": "number",
3700
3820
  "default": 0
3701
3821
  },
3822
+ "orderGroup": {
3823
+ "type": "string",
3824
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
3825
+ "default": "effects"
3826
+ },
3702
3827
  "preset": {
3703
3828
  "type": "string",
3704
3829
  "enum": [
@@ -3894,6 +4019,11 @@
3894
4019
  "type": "number",
3895
4020
  "default": 0
3896
4021
  },
4022
+ "orderGroup": {
4023
+ "type": "string",
4024
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4025
+ "default": "default"
4026
+ },
3897
4027
  "visible": {
3898
4028
  "type": "boolean",
3899
4029
  "default": true
@@ -4022,6 +4152,11 @@
4022
4152
  "type": "number",
4023
4153
  "default": 0
4024
4154
  },
4155
+ "orderGroup": {
4156
+ "type": "string",
4157
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4158
+ "default": "default"
4159
+ },
4025
4160
  "collider": {
4026
4161
  "type": "object",
4027
4162
  "default": {}
@@ -4136,6 +4271,11 @@
4136
4271
  "type": "number",
4137
4272
  "default": 0
4138
4273
  },
4274
+ "orderGroup": {
4275
+ "type": "string",
4276
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4277
+ "default": "default"
4278
+ },
4139
4279
  "visible": {
4140
4280
  "type": "boolean",
4141
4281
  "default": true
@@ -4259,6 +4399,11 @@
4259
4399
  "type": "number",
4260
4400
  "default": 0
4261
4401
  },
4402
+ "orderGroup": {
4403
+ "type": "string",
4404
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4405
+ "default": "default"
4406
+ },
4262
4407
  "texture": {
4263
4408
  "type": "string",
4264
4409
  "default": ""
@@ -4397,6 +4542,11 @@
4397
4542
  "type": "number",
4398
4543
  "default": 0
4399
4544
  },
4545
+ "orderGroup": {
4546
+ "type": "string",
4547
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4548
+ "default": "default"
4549
+ },
4400
4550
  "visible": {
4401
4551
  "type": "boolean",
4402
4552
  "default": true
@@ -4496,6 +4646,11 @@
4496
4646
  "type": "number",
4497
4647
  "default": 0
4498
4648
  },
4649
+ "orderGroup": {
4650
+ "type": "string",
4651
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4652
+ "default": "default"
4653
+ },
4499
4654
  "collider": {
4500
4655
  "type": "object",
4501
4656
  "default": {}
@@ -4590,6 +4745,11 @@
4590
4745
  "type": "number",
4591
4746
  "default": 0
4592
4747
  },
4748
+ "orderGroup": {
4749
+ "type": "string",
4750
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4751
+ "default": "terrain"
4752
+ },
4593
4753
  "size": {
4594
4754
  "type": "array",
4595
4755
  "items": {
@@ -4809,6 +4969,11 @@
4809
4969
  "type": "number",
4810
4970
  "default": 0
4811
4971
  },
4972
+ "orderGroup": {
4973
+ "type": "string",
4974
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
4975
+ "default": "default"
4976
+ },
4812
4977
  "tier": {
4813
4978
  "type": "string",
4814
4979
  "enum": ["simple", "medium", "high"],
@@ -5300,6 +5465,11 @@
5300
5465
  "type": "number",
5301
5466
  "default": 0
5302
5467
  },
5468
+ "orderGroup": {
5469
+ "type": "string",
5470
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
5471
+ "default": "default"
5472
+ },
5303
5473
  "voxels": {
5304
5474
  "type": "array",
5305
5475
  "default": []
@@ -5395,6 +5565,11 @@
5395
5565
  "type": "number",
5396
5566
  "default": 1
5397
5567
  },
5568
+ "orderGroup": {
5569
+ "type": "string",
5570
+ "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
5571
+ "default": "default"
5572
+ },
5398
5573
  "size": {
5399
5574
  "type": "array",
5400
5575
  "items": {
package/skills/incanto-behaviors-and-scripts.md CHANGED
@@ -167,3 +167,28 @@ import { Sprite2D } from 'incanto/2d'; // node classes live in their dimension e
167
167
  const coin = new Sprite2D('Coin');
168
168
  coin.uid = newUid(); // n_xxxxxxxxxxxxxxxx (crypto, 16 base36 chars)
169
169
  ```
170
+
171
+ ## Time & frame-rate independence (Unity Time equivalents)
172
+
173
+ Movement is frame-rate independent when you multiply by `dt` — the seconds
174
+ (already `timeScale`-adjusted) your update callbacks receive:
175
+
176
+ ```ts
177
+ override update(dt: number): void {
178
+ // 1 meter per second at ANY fps — 30, 60, or 144:
179
+ node.position[0] += 1 * dt;
180
+ }
181
+ ```
182
+
183
+ | Unity | Incanto |
184
+ |---|---|
185
+ | `Time.deltaTime` | the `dt` argument of `update(dt)` / `fixedUpdate(dt)` |
186
+ | `Time.time` | `engine.time` (elapsed game seconds, scaled; resets per scene) |
187
+ | `Time.unscaledTime` | `engine.unscaledTime` (real seconds — UI during slow-mo) |
188
+ | `Time.timeScale` | `engine.timeScale` (1 realtime · 0.5 slow-mo · 0 frozen) |
189
+ | `Time.fixedDeltaTime` | the `dt` of `fixedUpdate` (1/60 by default) |
190
+
191
+ `engine.timeScale` scales variable AND fixed updates together — physics,
192
+ timers, animations and behaviors all slow down as one. Bullet-time:
193
+ `engine.timeScale = 0.3`; freeze frames: `hitStop(engine, 0.08)` from
194
+ `incanto/gameplay`.