@almadar/kernel 19.2.0 → 19.4.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.2.0",
3
+ "version": "19.4.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",
@@ -13,11 +13,19 @@
13
13
  "types": "./pkg/orbital_wasm.d.ts",
14
14
  "default": "./pkg/orbital_wasm.js"
15
15
  },
16
+ "./instance": {
17
+ "types": "./pkg/orbital_wasm_instance.d.ts",
18
+ "default": "./pkg/orbital_wasm_instance.js"
19
+ },
16
20
  "./kernel.wasm": "./pkg/orbital_wasm_bg.wasm",
17
21
  "./client": {
18
22
  "types": "./pkg-client/orbital_wasm.d.ts",
19
23
  "default": "./pkg-client/orbital_wasm.js"
20
24
  },
25
+ "./client/instance": {
26
+ "types": "./pkg-client/orbital_wasm_instance.d.ts",
27
+ "default": "./pkg-client/orbital_wasm_instance.js"
28
+ },
21
29
  "./client.wasm": "./pkg-client/orbital_wasm_bg.wasm"
22
30
  },
23
31
  "files": [
@@ -28,7 +36,11 @@
28
36
  "pkg-client/orbital_wasm.js",
29
37
  "pkg-client/orbital_wasm.d.ts",
30
38
  "pkg-client/orbital_wasm_bg.wasm",
31
- "pkg-client/orbital_wasm_bg.wasm.d.ts"
39
+ "pkg-client/orbital_wasm_bg.wasm.d.ts",
40
+ "pkg/orbital_wasm_instance.js",
41
+ "pkg/orbital_wasm_instance.d.ts",
42
+ "pkg-client/orbital_wasm_instance.js",
43
+ "pkg-client/orbital_wasm_instance.d.ts"
32
44
  ],
33
45
  "sideEffects": false,
34
46
  "engines": {
@@ -39,7 +51,7 @@
39
51
  },
40
52
  "scripts": {
41
53
  "build": "sh scripts/build.sh",
42
- "test": "node --test test/*.test.mjs",
43
- "test:client": "KERNEL_PKG=pkg-client node --test test/kernel.test.mjs test/server.test.mjs test/client.test.mjs"
54
+ "test": "node --expose-gc --test test/*.test.mjs",
55
+ "test:client": "KERNEL_PKG=pkg-client node --expose-gc --test test/kernel.test.mjs test/server.test.mjs test/client.test.mjs"
44
56
  }
45
57
  }
@@ -84,6 +84,10 @@ export class Kernel {
84
84
  free(): void;
85
85
  [Symbol.dispose](): void;
86
86
  applyServerResponse(response_json: string, already_delivered_json?: string | null, base_json?: string | null): string;
87
+ /**
88
+ * The blobs (EXEC-DIST-16b) the kernel has let go of since the last call: a JSON array of ids.
89
+ */
90
+ blobsReleased(): string;
87
91
  bootMounts(side: string): string;
88
92
  contractQuery(query_json: string): string;
89
93
  deliverEmitToListeners(flight: number, emitted_json: string): string;
@@ -108,7 +112,7 @@ export class Kernel {
108
112
  * `undefined` when the leg carried no rows to fold against.
109
113
  */
110
114
  foldBase(carried_json: string | null | undefined, seeded_json: string, entity_id?: string | null): string | undefined;
111
- foldInOrder(flight: number, response_json: string, already_delivered_json?: string | null, base_json?: string | null): string;
115
+ foldInOrder(flight: number, response_json: Uint8Array, already_delivered_json?: string | null, base_json?: string | null, blobs_json?: string | null): string;
112
116
  /**
113
117
  * `undefined` when no tick is due this frame.
114
118
  */
@@ -117,6 +121,10 @@ export class Kernel {
117
121
  frameResume(): void;
118
122
  framesSince(since: number): string;
119
123
  getState(trait_name: string, entity_id?: string | null): string;
124
+ /**
125
+ * The held render values (EXEC-DIST-16) the kernel has let go of since the last call: a JSON array of ids.
126
+ */
127
+ heldReleased(): string;
120
128
  /**
121
129
  * Install the GPU answerer: from now on every `gpu/` ask is held in the kernel and answered here in ask order, and
122
130
  * each outcome's route event is handed to `onCompletion` (see [`drain_client_gpu`]) for the host to dispatch with
@@ -125,11 +133,19 @@ export class Kernel {
125
133
  installGpu(gpu: GpuHost, on_completion: Function): void;
126
134
  lastError(): string;
127
135
  leave(): string;
136
+ /**
137
+ * The page entered under `mountKey` closes; `[]` when another page of this kernel entered since.
138
+ */
139
+ leaveMount(mount_key: string): string;
128
140
  mount(traits_json: string): void;
129
- constructor(resolved_schema_json: string, client_id: string);
141
+ constructor(resolved_schema_json: Uint8Array, client_id: string);
130
142
  nextFold(): string | undefined;
131
143
  openFlight(): number;
132
144
  pageCircuit(page?: string | null, route?: string | null): string;
145
+ /**
146
+ * Load a lazy page's resolved program into this kernel, so the page runs in its program's one kernel (EXEC-LOAD-2).
147
+ */
148
+ registerLazy(resolved_schema_json: Uint8Array): void;
133
149
  remount(traits_json: string): string;
134
150
  reseedLeg(seeds_json: string, entity_id?: string | null): string;
135
151
  /**
@@ -139,6 +155,15 @@ export class Kernel {
139
155
  restore(trait_name: string, entity_id: string | null | undefined, snapshot_json: string): string;
140
156
  routeMounts(route_path: string): string;
141
157
  seed(entity_type: string, rows_json: string): void;
158
+ /**
159
+ * Seed the identity the browser kept from an earlier visit (`FrameIdentity` JSON) before any server frame; `false`
160
+ * when the kernel already holds one. The first server frame replaces it (EXEC-IDENTITY-4).
161
+ */
162
+ seedIdentity(identity_json: string): boolean;
163
+ /**
164
+ * The identity this client holds (`FrameIdentity` JSON), or `undefined` while no server frame or seed set one.
165
+ */
166
+ sessionIdentity(): string | undefined;
142
167
  /**
143
168
  * The theme key bound to this client's session (`theme/set`, mirrored from the server's frames), or `undefined`.
144
169
  */
@@ -157,6 +182,10 @@ export class Kernel {
157
182
  */
158
183
  setRecordEntityAfter(record: boolean): void;
159
184
  setThemeMode(mode: string): void;
185
+ /**
186
+ * Measure each recorded dispatch while on (EXEC-COST-1).
187
+ */
188
+ setTraceCost(on: boolean): void;
160
189
  /**
161
190
  * Record each dispatch as a trace item while on, for the host's `program/live { kind: "trace" }` streams.
162
191
  */
@@ -175,6 +204,10 @@ export class Kernel {
175
204
  * The trace items recorded since the last take, in dispatch order: a JSON array.
176
205
  */
177
206
  takeTrace(): string;
207
+ /**
208
+ * The items recorded since the last take, each `{ plain, costed? }` (EXEC-COST-1): a JSON array.
209
+ */
210
+ takeTraceViews(): string;
178
211
  tick(trait_name: string, tick_name: string, entity_id?: string | null): string;
179
212
  tickCount(): number;
180
213
  /**
@@ -208,18 +241,43 @@ export class SceneCanvas {
208
241
  private constructor();
209
242
  free(): void;
210
243
  [Symbol.dispose](): void;
244
+ /**
245
+ * `focus`, `activate`, `increment` or `decrement`; any other string is an error.
246
+ */
247
+ accessAction(target: string, action: string): void;
248
+ /**
249
+ * The texts below WCAG 2.2 AA contrast against the pixels painted behind them, as JSON
250
+ * `[{ index, text, size, weight, ratio, required, rect }]` (`ratio` null where nothing is painted behind).
251
+ * The audit is taken now and runs without holding this canvas, so frames keep drawing while it reads back.
252
+ */
253
+ contrastAudit(): Promise<any>;
254
+ /**
255
+ * [`Self::contrast_audit`] with every text and its measured ratio.
256
+ */
257
+ contrastAuditAll(): Promise<any>;
211
258
  static create(canvas: HTMLCanvasElement): Promise<SceneCanvas>;
212
259
  doubleTap(x: number, y: number): void;
213
260
  /**
214
- * Advances the scene clock to `now_ms`; true while the page should keep drawing.
261
+ * Advances the scene clock to `now_ms` (`performance.now()`) with the page clock `epoch_ms`
262
+ * (`performance.timeOrigin + now`); true while the page should keep drawing.
215
263
  */
216
- frame(now_ms: number): boolean;
264
+ frame(now_ms: number, epoch_ms: number): boolean;
217
265
  /**
218
266
  * A pointer event in CSS pixels: `touch-down`, `touch-move`, `touch-up` or `touch-cancel`.
219
267
  */
220
268
  input(kind: string, x: number, y: number, button: number): void;
269
+ /**
270
+ * [`Self::input`] from one of several pointers (`PointerEvent.pointerId`): a further finger reaches the
271
+ * region that holds capture, and a multi-touch gesture's events carry `touches`.
272
+ */
273
+ inputPointer(kind: string, x: number, y: number, button: number, pointer_id: number): void;
274
+ keyInput(target: string, key: string, shift: boolean, alt: boolean, ctrl: boolean, meta: boolean): void;
221
275
  render(): void;
222
276
  resize(css_width: number, css_height: number, pixel_ratio: number): void;
277
+ /**
278
+ * The semantic tree as JSON, rects in CSS pixels.
279
+ */
280
+ semanticTree(): string;
223
281
  setMotion(enabled: boolean): void;
224
282
  /**
225
283
  * `node_json`: the render node (`{ "type": "physics-canvas", … }`).
@@ -229,7 +287,13 @@ export class SceneCanvas {
229
287
  * The scene events input queued, as JSON `[{ "event", "payload" }]`.
230
288
  */
231
289
  takeEvents(): string;
290
+ textInput(target: string, text: string, composing: boolean): void;
232
291
  webgpu(): boolean;
292
+ /**
293
+ * The wheel at a point in CSS pixels with its pixel deltas; true when the canvas declares `wheelEvent`
294
+ * (the page must not take the wheel).
295
+ */
296
+ wheel(x: number, y: number, dx: number, dy: number): boolean;
233
297
  /**
234
298
  * Whether the scene took the zoom; the page scrolls when it did not.
235
299
  */
@@ -250,6 +314,7 @@ export class Server {
250
314
  answerGpu(ticket: number, on_completion: Function): Promise<any>;
251
315
  bootMounts(side: string): string;
252
316
  browserCompletionPayload(trait_name: string, payload_json: string): string;
317
+ browserRuns(trait_name: string): boolean;
253
318
  clientView(response_json: string): string;
254
319
  closeSessionStream(id: number): boolean;
255
320
  /**
@@ -319,6 +384,11 @@ export class Server {
319
384
  unmountClient(client: string, orbital: string, traits_json: string): void;
320
385
  }
321
386
 
387
+ /**
388
+ * The `{ event, payload }` a deferred keyed `call-service` outcome fires on its call site, with the program's key, or `null`.
389
+ */
390
+ export function callCompletionEvent(site_json: string, key: string | null | undefined, outcome_json: string): string;
391
+
322
392
  /**
323
393
  * Whether a row may be created, updated or deleted under a directive (`MutationVerdictWire` as JSON).
324
394
  */
@@ -453,6 +523,7 @@ export interface InitOutput {
453
523
  readonly __wbg_memorystore_free: (a: number, b: number) => void;
454
524
  readonly __wbg_scenecanvas_free: (a: number, b: number) => void;
455
525
  readonly __wbg_server_free: (a: number, b: number) => void;
526
+ readonly callCompletionEvent: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
456
527
  readonly canvas3d_camera: (a: number) => [number, number];
457
528
  readonly canvas3d_create: (a: any) => any;
458
529
  readonly canvas3d_frame: (a: number, b: number, c: number) => [number, number, number];
@@ -501,6 +572,7 @@ export interface InitOutput {
501
572
  readonly installLanguage: (a: number, b: number) => [number, number];
502
573
  readonly isPublicAddress: (a: number, b: number) => [number, number, number];
503
574
  readonly kernel_applyServerResponse: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
575
+ readonly kernel_blobsReleased: (a: number) => [number, number];
504
576
  readonly kernel_bootMounts: (a: number, b: number, c: number) => [number, number, number, number];
505
577
  readonly kernel_contractQuery: (a: number, b: number, c: number) => [number, number, number, number];
506
578
  readonly kernel_deliverEmitToListeners: (a: number, b: number, c: number, d: number) => [number, number, number, number];
@@ -513,37 +585,44 @@ export interface InitOutput {
513
585
  readonly kernel_endFlight: (a: number, b: number) => number;
514
586
  readonly kernel_enter: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
515
587
  readonly kernel_foldBase: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
516
- readonly kernel_foldInOrder: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
588
+ readonly kernel_foldInOrder: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
517
589
  readonly kernel_frame: (a: number, b: number) => [number, number, number, number];
518
590
  readonly kernel_framePause: (a: number) => void;
519
591
  readonly kernel_frameResume: (a: number) => void;
520
592
  readonly kernel_framesSince: (a: number, b: number) => [number, number, number, number];
521
593
  readonly kernel_getState: (a: number, b: number, c: number, d: number, e: number) => [number, number];
594
+ readonly kernel_heldReleased: (a: number) => [number, number];
522
595
  readonly kernel_installGpu: (a: number, b: number, c: any) => void;
523
596
  readonly kernel_lastError: (a: number) => [number, number];
524
597
  readonly kernel_leave: (a: number) => [number, number, number, number];
598
+ readonly kernel_leaveMount: (a: number, b: number, c: number) => [number, number, number, number];
525
599
  readonly kernel_mount: (a: number, b: number, c: number) => [number, number];
526
600
  readonly kernel_new: (a: number, b: number, c: number, d: number) => [number, number, number];
527
601
  readonly kernel_nextFold: (a: number) => [number, number, number, number];
528
602
  readonly kernel_openFlight: (a: number) => number;
529
603
  readonly kernel_pageCircuit: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
604
+ readonly kernel_registerLazy: (a: number, b: number, c: number) => [number, number];
530
605
  readonly kernel_remount: (a: number, b: number, c: number) => [number, number, number, number];
531
606
  readonly kernel_reseedLeg: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
532
607
  readonly kernel_resolveRows: (a: number, b: number, c: number) => [number, number, number, number];
533
608
  readonly kernel_restore: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
534
609
  readonly kernel_routeMounts: (a: number, b: number, c: number) => [number, number, number, number];
535
610
  readonly kernel_seed: (a: number, b: number, c: number, d: number, e: number) => [number, number];
611
+ readonly kernel_seedIdentity: (a: number, b: number, c: number) => [number, number, number];
612
+ readonly kernel_sessionIdentity: (a: number) => [number, number, number, number];
536
613
  readonly kernel_sessionTheme: (a: number) => [number, number];
537
614
  readonly kernel_setFrameEffectResults: (a: number, b: number) => void;
538
615
  readonly kernel_setHostFansOut: (a: number, b: number) => void;
539
616
  readonly kernel_setRecordEntityAfter: (a: number, b: number) => void;
540
617
  readonly kernel_setThemeMode: (a: number, b: number, c: number) => [number, number];
618
+ readonly kernel_setTraceCost: (a: number, b: number) => void;
541
619
  readonly kernel_setTraceOn: (a: number, b: number) => void;
542
620
  readonly kernel_setTraitOnScreen: (a: number, b: number, c: number, d: number) => void;
543
621
  readonly kernel_setViewerLocale: (a: number, b: number, c: number) => [number, number];
544
622
  readonly kernel_snapshot: (a: number) => [number, number, number, number];
545
623
  readonly kernel_statefulLeg: (a: number, b: number, c: number) => [number, number, number, number];
546
624
  readonly kernel_takeTrace: (a: number) => [number, number, number, number];
625
+ readonly kernel_takeTraceViews: (a: number) => [number, number, number, number];
547
626
  readonly kernel_tick: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
548
627
  readonly kernel_tickCount: (a: number) => number;
549
628
  readonly kernel_traitConfig: (a: number, b: number, c: number) => [number, number, number, number];
@@ -573,22 +652,31 @@ export interface InitOutput {
573
652
  readonly resolveFxView: (a: number, b: number, c: number, d: number) => [number, number, number, number];
574
653
  readonly resolveRowBinding: (a: number, b: number, c: number, d: number) => [number, number, number, number];
575
654
  readonly resolveValues: (a: number, b: number, c: number, d: number) => [number, number, number, number];
655
+ readonly scenecanvas_accessAction: (a: number, b: number, c: number, d: number, e: number) => [number, number];
656
+ readonly scenecanvas_contrastAudit: (a: number) => any;
657
+ readonly scenecanvas_contrastAuditAll: (a: number) => any;
576
658
  readonly scenecanvas_create: (a: any) => any;
577
659
  readonly scenecanvas_doubleTap: (a: number, b: number, c: number) => void;
578
- readonly scenecanvas_frame: (a: number, b: number) => number;
660
+ readonly scenecanvas_frame: (a: number, b: number, c: number) => number;
579
661
  readonly scenecanvas_input: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
662
+ readonly scenecanvas_inputPointer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
663
+ readonly scenecanvas_keyInput: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
580
664
  readonly scenecanvas_render: (a: number) => [number, number];
581
665
  readonly scenecanvas_resize: (a: number, b: number, c: number, d: number) => [number, number];
666
+ readonly scenecanvas_semanticTree: (a: number) => [number, number];
582
667
  readonly scenecanvas_setMotion: (a: number, b: number) => void;
583
668
  readonly scenecanvas_setScene: (a: number, b: number, c: number) => [number, number];
584
669
  readonly scenecanvas_takeEvents: (a: number) => [number, number];
670
+ readonly scenecanvas_textInput: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
585
671
  readonly scenecanvas_webgpu: (a: number) => number;
672
+ readonly scenecanvas_wheel: (a: number, b: number, c: number, d: number, e: number) => number;
586
673
  readonly scenecanvas_zoom: (a: number, b: number, c: number, d: number) => number;
587
674
  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];
588
675
  readonly server_abandon: (a: number, b: number) => [number, number, number];
589
676
  readonly server_answerGpu: (a: number, b: number, c: any) => [number, number, number];
590
677
  readonly server_bootMounts: (a: number, b: number, c: number) => [number, number, number, number];
591
678
  readonly server_browserCompletionPayload: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
679
+ readonly server_browserRuns: (a: number, b: number, c: number) => number;
592
680
  readonly server_clientView: (a: number, b: number, c: number) => [number, number, number, number];
593
681
  readonly server_closeSessionStream: (a: number, b: number) => [number, number, number];
594
682
  readonly server_contractQuery: (a: number, b: number, c: number) => [number, number, number, number];
@@ -644,6 +732,7 @@ export interface InitOutput {
644
732
  readonly traceEffects: (a: number, b: number, c: number, d: number) => [number, number, number, number];
645
733
  readonly validatePacks: (a: number, b: number) => [number, number];
646
734
  readonly orbital_canvas_add_font: (a: number, b: number, c: number, d: number) => number;
735
+ readonly orbital_canvas_asset_generation: () => bigint;
647
736
  readonly orbital_canvas_asset_is_svg: (a: number, b: number) => number;
648
737
  readonly orbital_canvas_decode_data_url: (a: number, b: number, c: number, d: number) => number;
649
738
  readonly orbital_canvas_destroy: (a: number) => void;
@@ -670,18 +759,17 @@ export interface InitOutput {
670
759
  readonly orbital_canvas_view_command: (a: number, b: number) => number;
671
760
  readonly orbital_canvas_wants_frames: (a: number) => number;
672
761
  readonly orbital_canvas_zoom: (a: number, b: number, c: number, d: number) => void;
673
- readonly orbital_canvas_asset_generation: () => bigint;
674
762
  readonly wasm_bindgen__convert__closures_____invoke__h8eb4db3657af0602: (a: number, b: number, c: any) => [number, number];
675
763
  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;
764
+ readonly wasm_bindgen__convert__closures_____invoke__h1103375f71c7ec6c: (a: number, b: number, c: any) => void;
677
765
  readonly __wbindgen_malloc: (a: number, b: number) => number;
678
766
  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
679
767
  readonly __wbindgen_exn_store: (a: number) => void;
680
768
  readonly __externref_table_alloc: () => number;
681
769
  readonly __wbindgen_externrefs: WebAssembly.Table;
682
770
  readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
683
- readonly __wbindgen_free: (a: number, b: number, c: number) => void;
684
771
  readonly __externref_table_dealloc: (a: number) => void;
772
+ readonly __wbindgen_free: (a: number, b: number, c: number) => void;
685
773
  readonly __wbindgen_start: () => void;
686
774
  }
687
775