@almadar/kernel 19.0.1 → 19.2.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@almadar/kernel",
3
- "version": "19.0.1",
3
+ "version": "19.2.0",
4
4
  "orbRelease": { "severity": "normal" },
5
5
  "description": "The embedded Almadar kernel as WebAssembly: Kernel (client role) and Server (server role, I/O answered by the host) over JSON strings. `@almadar/kernel/client` is the browser build without the raw-socket store drivers.",
6
6
  "license": "BUSL-1.1",
@@ -1,6 +1,51 @@
1
1
  /* tslint:disable */
2
2
  /* eslint-disable */
3
3
 
4
+ export class Canvas3D {
5
+ private constructor();
6
+ free(): void;
7
+ [Symbol.dispose](): void;
8
+ /**
9
+ * The camera as the user moved it, as JSON (`eye`, `target`, `up`, `projection`, `near`, `far`).
10
+ */
11
+ camera(): string;
12
+ /**
13
+ * Opens (or joins) the shared device and makes a surface on `canvas`.
14
+ */
15
+ static create(canvas: HTMLCanvasElement): Promise<Canvas3D>;
16
+ /**
17
+ * Advances the canvas clock to `now_ms` (`performance.now()`) with the page clock `epoch_ms`
18
+ * (`performance.timeOrigin + now`); true when the frame changed.
19
+ */
20
+ frame(now_ms: number, epoch_ms: number): boolean;
21
+ lookAt(target_json: string): boolean;
22
+ pointerDown(id: number, x: number, y: number, button_code: number, touch: boolean): void;
23
+ pointerLeave(): void;
24
+ pointerMove(id: number, x: number, y: number): boolean;
25
+ /**
26
+ * What the release did, as JSON: `{"unit":{"id","x","z"}}`, `{"tile":{"x","z"}}`, `{"select":{"id"}}`,
27
+ * `{"move":{"id","x","y"}}`, `{"shape":<the pattern's click payload>}`, or `null`.
28
+ */
29
+ pointerUp(id: number, x: number, y: number, unit_events: boolean, tile_events: boolean): string;
30
+ render(): void;
31
+ resetCamera(): boolean;
32
+ resize(css_width: number, css_height: number, pixel_ratio: number): void;
33
+ /**
34
+ * `[x, y, z]` as JSON; true when the camera moved.
35
+ */
36
+ setCameraPosition(position_json: string): boolean;
37
+ setReducedMotion(reduced: boolean): void;
38
+ /**
39
+ * `node_json`: the 3D render node; `theme_json`: the page's resolved canvas theme, or `null` for none.
40
+ */
41
+ setScene(node_json: string, theme_json: string): void;
42
+ /**
43
+ * False when this canvas runs on the WebGL2 fallback (no GPU drawables there).
44
+ */
45
+ webgpu(): boolean;
46
+ wheel(delta_y: number): boolean;
47
+ }
48
+
4
49
  /**
5
50
  * The encrypted credential store for a host whose rows answer asynchronously: the host lists its rows and `load`s them,
6
51
  * runs an operation, then applies `takeWrites()` to its medium in order. See `credentials::VaultApi`.
@@ -28,6 +73,13 @@ export class CredentialVault {
28
73
  readonly enabled: boolean;
29
74
  }
30
75
 
76
+ export class GpuHost {
77
+ free(): void;
78
+ [Symbol.dispose](): void;
79
+ closeAll(): void;
80
+ constructor();
81
+ }
82
+
31
83
  export class Kernel {
32
84
  free(): void;
33
85
  [Symbol.dispose](): void;
@@ -37,11 +89,19 @@ export class Kernel {
37
89
  deliverEmitToListeners(flight: number, emitted_json: string): string;
38
90
  deliverOriginEmit(flight: number, emitted_json: string): string;
39
91
  dispatch(trait_name: string, entity_id: string | null | undefined, event: string, payload_json?: string | null): string;
92
+ /**
93
+ * Dispatch a held completion: `event` on `traitName` with the payload held under `heldPayload`, taken once.
94
+ */
95
+ dispatchHeld(trait_name: string, entity_id: string | null | undefined, event: string, held_payload: number): string;
40
96
  /**
41
97
  * The kernel's dispatch mode for a registered trait, as JSON text.
42
98
  */
43
99
  dispatchMode(trait_name: string): string;
44
- dispatchMount(seeds_json: string, entity_id?: string | null, payload_json?: string | null, route?: string | null): string;
100
+ dispatchMount(seeds_json: string, entity_id?: string | null, payload_json?: string | null, route?: string | null, crumb?: string | null): string;
101
+ /**
102
+ * Drop a held completion payload no dispatch will take (the host could not deliver it).
103
+ */
104
+ dropHeldPayload(held_payload: number): boolean;
45
105
  endFlight(flight: number): boolean;
46
106
  enter(route_path: string | null | undefined, mount_key: string, traits_json: string): string;
47
107
  /**
@@ -57,6 +117,12 @@ export class Kernel {
57
117
  frameResume(): void;
58
118
  framesSince(since: number): string;
59
119
  getState(trait_name: string, entity_id?: string | null): string;
120
+ /**
121
+ * Install the GPU answerer: from now on every `gpu/` ask is held in the kernel and answered here in ask order, and
122
+ * each outcome's route event is handed to `onCompletion` (see [`drain_client_gpu`]) for the host to dispatch with
123
+ * `dispatchHeld`, so no handle or byte crosses to JavaScript.
124
+ */
125
+ installGpu(gpu: GpuHost, on_completion: Function): void;
60
126
  lastError(): string;
61
127
  leave(): string;
62
128
  mount(traits_json: string): void;
@@ -138,6 +204,38 @@ export class MemoryStore {
138
204
  writeWhere(op_json: string): string;
139
205
  }
140
206
 
207
+ export class SceneCanvas {
208
+ private constructor();
209
+ free(): void;
210
+ [Symbol.dispose](): void;
211
+ static create(canvas: HTMLCanvasElement): Promise<SceneCanvas>;
212
+ doubleTap(x: number, y: number): void;
213
+ /**
214
+ * Advances the scene clock to `now_ms`; true while the page should keep drawing.
215
+ */
216
+ frame(now_ms: number): boolean;
217
+ /**
218
+ * A pointer event in CSS pixels: `touch-down`, `touch-move`, `touch-up` or `touch-cancel`.
219
+ */
220
+ input(kind: string, x: number, y: number, button: number): void;
221
+ render(): void;
222
+ resize(css_width: number, css_height: number, pixel_ratio: number): void;
223
+ setMotion(enabled: boolean): void;
224
+ /**
225
+ * `node_json`: the render node (`{ "type": "physics-canvas", … }`).
226
+ */
227
+ setScene(node_json: string): void;
228
+ /**
229
+ * The scene events input queued, as JSON `[{ "event", "payload" }]`.
230
+ */
231
+ takeEvents(): string;
232
+ webgpu(): boolean;
233
+ /**
234
+ * Whether the scene took the zoom; the page scrolls when it did not.
235
+ */
236
+ zoom(factor: number, x: number, y: number): boolean;
237
+ }
238
+
141
239
  /**
142
240
  * The server role: `start` a request, answer the I/O it asks for, `resume` the flight until it is done.
143
241
  */
@@ -145,7 +243,14 @@ export class Server {
145
243
  free(): void;
146
244
  [Symbol.dispose](): void;
147
245
  abandon(flight: number): boolean;
246
+ /**
247
+ * Answer the held `gpu/` ask `ticket` (an `IoRequestWire` of kind `gpu`): resolves to the `IoAnswerWire` JSON to
248
+ * reply with. A deferred completion is handed to `onCompletion` (see [`answer_held`]).
249
+ */
250
+ answerGpu(ticket: number, on_completion: Function): Promise<any>;
148
251
  bootMounts(side: string): string;
252
+ browserCompletionPayload(trait_name: string, payload_json: string): string;
253
+ clientView(response_json: string): string;
149
254
  closeSessionStream(id: number): boolean;
150
255
  /**
151
256
  * One question about the registered program (a `ContractQuery` as JSON): its answer as JSON.
@@ -153,6 +258,10 @@ export class Server {
153
258
  contractQuery(query_json: string): string;
154
259
  declaresTicks(): boolean;
155
260
  dispatchStream(): string;
261
+ /**
262
+ * Drop a held completion payload the host will not start (its call was cancelled).
263
+ */
264
+ dropHeldPayload(ticket: number): boolean;
156
265
  egressAllows(url: string): boolean;
157
266
  flushTickRelay(): string;
158
267
  /**
@@ -164,6 +273,11 @@ export class Server {
164
273
  getState(trait_name: string, entity_id?: string | null): string;
165
274
  holdsLane(flight: number): boolean;
166
275
  inFlight(): number;
276
+ /**
277
+ * Install the GPU answerer: from now on the server holds every `gpu/` ask, and the host answers it by ticket
278
+ * with `answerGpu`, so no argument or answer crosses to JavaScript.
279
+ */
280
+ installGpu(gpu: GpuHost): void;
167
281
  lastError(): string;
168
282
  liveItemDelivered(item_json: string, client_id?: string | null): boolean;
169
283
  mount(traits_json: string): void;
@@ -332,10 +446,29 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
332
446
 
333
447
  export interface InitOutput {
334
448
  readonly memory: WebAssembly.Memory;
449
+ readonly __wbg_canvas3d_free: (a: number, b: number) => void;
335
450
  readonly __wbg_credentialvault_free: (a: number, b: number) => void;
451
+ readonly __wbg_gpuhost_free: (a: number, b: number) => void;
336
452
  readonly __wbg_kernel_free: (a: number, b: number) => void;
337
453
  readonly __wbg_memorystore_free: (a: number, b: number) => void;
454
+ readonly __wbg_scenecanvas_free: (a: number, b: number) => void;
338
455
  readonly __wbg_server_free: (a: number, b: number) => void;
456
+ readonly canvas3d_camera: (a: number) => [number, number];
457
+ readonly canvas3d_create: (a: any) => any;
458
+ readonly canvas3d_frame: (a: number, b: number, c: number) => [number, number, number];
459
+ readonly canvas3d_lookAt: (a: number, b: number, c: number) => [number, number, number];
460
+ readonly canvas3d_pointerDown: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
461
+ readonly canvas3d_pointerLeave: (a: number) => void;
462
+ readonly canvas3d_pointerMove: (a: number, b: number, c: number, d: number) => [number, number, number];
463
+ readonly canvas3d_pointerUp: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
464
+ readonly canvas3d_render: (a: number) => [number, number];
465
+ readonly canvas3d_resetCamera: (a: number) => number;
466
+ readonly canvas3d_resize: (a: number, b: number, c: number, d: number) => void;
467
+ readonly canvas3d_setCameraPosition: (a: number, b: number, c: number) => [number, number, number];
468
+ readonly canvas3d_setReducedMotion: (a: number, b: number) => void;
469
+ readonly canvas3d_setScene: (a: number, b: number, c: number, d: number, e: number) => [number, number];
470
+ readonly canvas3d_webgpu: (a: number) => number;
471
+ readonly canvas3d_wheel: (a: number, b: number) => number;
339
472
  readonly checkMutationAccess: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
340
473
  readonly contractQueryWithoutProgram: (a: number, b: number) => [number, number, number, number];
341
474
  readonly credentialvault_connectAbandon: (a: number, b: number) => [number, number, number];
@@ -363,6 +496,8 @@ export interface InitOutput {
363
496
  readonly expandFxLayer: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
364
497
  readonly fxHash01: (a: number, b: number, c: number) => number;
365
498
  readonly fxLifecycle: (a: number, b: number, c: number, d: number) => [number, number, number, number];
499
+ readonly gpuhost_closeAll: (a: number) => void;
500
+ readonly gpuhost_new: () => number;
366
501
  readonly installLanguage: (a: number, b: number) => [number, number];
367
502
  readonly isPublicAddress: (a: number, b: number) => [number, number, number];
368
503
  readonly kernel_applyServerResponse: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
@@ -371,8 +506,10 @@ export interface InitOutput {
371
506
  readonly kernel_deliverEmitToListeners: (a: number, b: number, c: number, d: number) => [number, number, number, number];
372
507
  readonly kernel_deliverOriginEmit: (a: number, b: number, c: number, d: number) => [number, number, number, number];
373
508
  readonly kernel_dispatch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
509
+ readonly kernel_dispatchHeld: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
374
510
  readonly kernel_dispatchMode: (a: number, b: number, c: number) => [number, number, number, number];
375
- readonly kernel_dispatchMount: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
511
+ readonly kernel_dispatchMount: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number, number, number];
512
+ readonly kernel_dropHeldPayload: (a: number, b: number) => [number, number, number];
376
513
  readonly kernel_endFlight: (a: number, b: number) => number;
377
514
  readonly kernel_enter: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
378
515
  readonly kernel_foldBase: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
@@ -382,6 +519,7 @@ export interface InitOutput {
382
519
  readonly kernel_frameResume: (a: number) => void;
383
520
  readonly kernel_framesSince: (a: number, b: number) => [number, number, number, number];
384
521
  readonly kernel_getState: (a: number, b: number, c: number, d: number, e: number) => [number, number];
522
+ readonly kernel_installGpu: (a: number, b: number, c: any) => void;
385
523
  readonly kernel_lastError: (a: number) => [number, number];
386
524
  readonly kernel_leave: (a: number) => [number, number, number, number];
387
525
  readonly kernel_mount: (a: number, b: number, c: number) => [number, number];
@@ -435,13 +573,28 @@ export interface InitOutput {
435
573
  readonly resolveFxView: (a: number, b: number, c: number, d: number) => [number, number, number, number];
436
574
  readonly resolveRowBinding: (a: number, b: number, c: number, d: number) => [number, number, number, number];
437
575
  readonly resolveValues: (a: number, b: number, c: number, d: number) => [number, number, number, number];
576
+ readonly scenecanvas_create: (a: any) => any;
577
+ readonly scenecanvas_doubleTap: (a: number, b: number, c: number) => void;
578
+ readonly scenecanvas_frame: (a: number, b: number) => number;
579
+ readonly scenecanvas_input: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
580
+ readonly scenecanvas_render: (a: number) => [number, number];
581
+ readonly scenecanvas_resize: (a: number, b: number, c: number, d: number) => [number, number];
582
+ readonly scenecanvas_setMotion: (a: number, b: number) => void;
583
+ readonly scenecanvas_setScene: (a: number, b: number, c: number) => [number, number];
584
+ readonly scenecanvas_takeEvents: (a: number) => [number, number];
585
+ readonly scenecanvas_webgpu: (a: number) => number;
586
+ readonly scenecanvas_zoom: (a: number, b: number, c: number, d: number) => number;
438
587
  readonly scopeRows: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
439
588
  readonly server_abandon: (a: number, b: number) => [number, number, number];
589
+ readonly server_answerGpu: (a: number, b: number, c: any) => [number, number, number];
440
590
  readonly server_bootMounts: (a: number, b: number, c: number) => [number, number, number, number];
591
+ readonly server_browserCompletionPayload: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
592
+ readonly server_clientView: (a: number, b: number, c: number) => [number, number, number, number];
441
593
  readonly server_closeSessionStream: (a: number, b: number) => [number, number, number];
442
594
  readonly server_contractQuery: (a: number, b: number, c: number) => [number, number, number, number];
443
595
  readonly server_declaresTicks: (a: number) => number;
444
596
  readonly server_dispatchStream: (a: number) => [number, number, number, number];
597
+ readonly server_dropHeldPayload: (a: number, b: number) => [number, number, number];
445
598
  readonly server_egressAllows: (a: number, b: number, c: number) => number;
446
599
  readonly server_flushTickRelay: (a: number) => [number, number, number, number];
447
600
  readonly server_fork: (a: number) => [number, number, number];
@@ -449,6 +602,7 @@ export interface InitOutput {
449
602
  readonly server_getState: (a: number, b: number, c: number, d: number, e: number) => [number, number];
450
603
  readonly server_holdsLane: (a: number, b: number) => [number, number, number];
451
604
  readonly server_inFlight: (a: number) => number;
605
+ readonly server_installGpu: (a: number, b: number) => void;
452
606
  readonly server_lastError: (a: number) => [number, number];
453
607
  readonly server_liveItemDelivered: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
454
608
  readonly server_mount: (a: number, b: number, c: number) => [number, number];
@@ -490,6 +644,8 @@ export interface InitOutput {
490
644
  readonly traceEffects: (a: number, b: number, c: number, d: number) => [number, number, number, number];
491
645
  readonly validatePacks: (a: number, b: number) => [number, number];
492
646
  readonly orbital_canvas_add_font: (a: number, b: number, c: number, d: number) => number;
647
+ readonly orbital_canvas_asset_is_svg: (a: number, b: number) => number;
648
+ readonly orbital_canvas_decode_data_url: (a: number, b: number, c: number, d: number) => number;
493
649
  readonly orbital_canvas_destroy: (a: number) => void;
494
650
  readonly orbital_canvas_free_rgba: (a: number, b: number) => void;
495
651
  readonly orbital_canvas_free_string: (a: number) => void;
@@ -507,22 +663,25 @@ export interface InitOutput {
507
663
  readonly orbital_canvas_set_scale: (a: number, b: number) => number;
508
664
  readonly orbital_canvas_set_scene: (a: number, b: number) => number;
509
665
  readonly orbital_canvas_submit: (a: number, b: number) => void;
666
+ readonly orbital_canvas_svg_rasterize: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
667
+ readonly orbital_canvas_svg_size: (a: number, b: number, c: number, d: number, e: number) => number;
510
668
  readonly orbital_canvas_take_events: (a: number) => number;
511
669
  readonly orbital_canvas_take_missing_scripts: () => number;
512
670
  readonly orbital_canvas_view_command: (a: number, b: number) => number;
513
671
  readonly orbital_canvas_wants_frames: (a: number) => number;
514
672
  readonly orbital_canvas_zoom: (a: number, b: number, c: number, d: number) => void;
515
673
  readonly orbital_canvas_asset_generation: () => bigint;
516
- readonly wasm_bindgen__convert__closures_____invoke__h63cbec796bb507b5: (a: number, b: number, c: any) => [number, number];
517
- readonly wasm_bindgen__convert__closures_____invoke__hd92f3b0a1cff0691: (a: number, b: number, c: any) => void;
674
+ readonly wasm_bindgen__convert__closures_____invoke__h8eb4db3657af0602: (a: number, b: number, c: any) => [number, number];
675
+ readonly wasm_bindgen__convert__closures_____invoke__h5df8ebf7fa42a7ee: (a: number, b: number, c: any, d: any) => void;
676
+ readonly wasm_bindgen__convert__closures_____invoke__h6eb4df6a702050d9: (a: number, b: number, c: any) => void;
518
677
  readonly __wbindgen_malloc: (a: number, b: number) => number;
519
678
  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
520
679
  readonly __wbindgen_exn_store: (a: number) => void;
521
680
  readonly __externref_table_alloc: () => number;
522
681
  readonly __wbindgen_externrefs: WebAssembly.Table;
523
682
  readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
524
- readonly __externref_table_dealloc: (a: number) => void;
525
683
  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
684
+ readonly __externref_table_dealloc: (a: number) => void;
526
685
  readonly __wbindgen_start: () => void;
527
686
  }
528
687