@julclang/julc-vm-wasm 0.1.0-pre21 → 0.1.0-pre22

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/README.md CHANGED
@@ -10,6 +10,26 @@ exact version. For the Java compiler, the decompiler and source debugging as wel
10
10
  **Experimental.** The JavaScript API is version 0 and may change in any release before 1.0; the release notes list
11
11
  every change. JuLC is a research project: do not treat a result as proof that a contract is safe to deploy.
12
12
 
13
+ ## Versions
14
+
15
+ The npm version is the JuLC release version. Dist-tags:
16
+
17
+ | Install | Gets |
18
+ |---|---|
19
+ | `npm install @julclang/julc-vm-wasm` | `latest`: the newest `-preN` until JuLC's first final release; then the newest final release, unless that final is older than the `-preN` on `latest` (see below) |
20
+ | `npm install @julclang/julc-vm-wasm@preview` | the newest `-preN` prerelease after a final release |
21
+ | `npm install @julclang/julc-vm-wasm@beta` | the newest `-betaN` |
22
+ | `npm install @julclang/julc-vm-wasm@next` | the newest release candidate of a final release (`X.Y.Z-rcN`) |
23
+
24
+ - A channel (`preview`, `beta`, `next`) exists only after its first version; until then installing it fails.
25
+ - A final release does not reset the channels, so after one a channel can name a version older than `latest`.
26
+ - No dist-tag ever moves to an older version: a version older than the one a tag names (a backfilled first final
27
+ after a `-preN` on `latest`, or a `-betaN` after a `-preN` of the same `X.Y.Z`, which semver orders below it) is on a
28
+ `release-<major>.<minor>` or `release-<version>` tag instead. Such a backfilled final leaves `latest` on that older
29
+ prerelease, and later `-preN`s go to `preview`, until a final higher than it is published.
30
+ - Pin a prerelease exactly (`"@julclang/julc-vm-wasm": "0.1.0-pre22"`): a caret range such as `^0.1.0-pre21` also
31
+ matches a later `0.1.0-rcN`.
32
+
13
33
  ## Use
14
34
 
15
35
  ```js
@@ -49,6 +69,8 @@ copies of them, for example for `@julclang/wasm-client`'s own `createJulc`.
49
69
  `--experimental-wasm-exnref`: the client checks for them before it starts its first worker and, when they are
50
70
  missing, sets that flag with `v8.setFlagsFromString`. The flag is process-wide. Node 24 needs nothing. The engine
51
71
  also loads inside your own `worker_threads` worker.
72
+ - **Node.js security releases:** `engines` (`>=22.3.0`) is the lowest version that works, not a recommendation. Run a
73
+ supported Node.js release line, updated to its latest security release.
52
74
  - **Content Security Policy:** `script-src 'self' 'wasm-unsafe-eval'`, on the page and on the responses of the worker
53
75
  scripts, the runtime and the launcher (a worker script has its own policy). No `'unsafe-eval'` is needed.
54
76
  - **Origins:** in a browser the worker loads the engine's files only from its own origin, which must not be opaque.
@@ -91,4 +113,4 @@ The engine's files are named by `new URL('./engine/…', import.meta.url)` in `e
91
113
  copy files named by `new URL`: keep the packages external (`--packages=external`, or `external: ['@julclang/*']`).
92
114
  **Next.js with `--webpack`** rewrites the URLs: list both packages in `serverExternalPackages`.
93
115
 
94
- Version 0.1.0-pre21. Source, issues and the design (ADR-077): https://github.com/bloxbean/julc
116
+ Version 0.1.0-pre22. Source, issues and the design (ADR-077): https://github.com/bloxbean/julc
@@ -1 +1 @@
1
- {"version":"90278477499e","launcher":"julc-vm-90278477499e.js","variant":"vm","api":0,"groups":["vm","debug"],"julcVersion":"0.1.0-pre21"}
1
+ {"version":"47a30d49de00","launcher":"julc-vm-47a30d49de00.js","variant":"vm","api":0,"groups":["vm","debug"],"julcVersion":"0.1.0-pre22"}
package/engine.d.ts CHANGED
@@ -1,13 +1,13 @@
1
- // Generated at build time (ADR-077 D2): the engine files of @julclang/julc-vm-wasm 0.1.0-pre21.
1
+ // Generated at build time (ADR-077 D2): the engine files of @julclang/julc-vm-wasm 0.1.0-pre22.
2
2
  import type {FeatureGroup, Manifest} from '@julclang/wasm-client';
3
3
 
4
4
  /** engine/engine.json, inlined and frozen, groups included. */
5
5
  export declare const manifest: Readonly<Omit<Manifest, 'groups'>> & {readonly groups?: readonly FeatureGroup[]};
6
- /** The launcher, engine/julc-vm-90278477499e.js. */
6
+ /** The launcher, engine/julc-vm-47a30d49de00.js. */
7
7
  export declare const launcherUrl: URL;
8
- /** The WebAssembly module, engine/julc-vm-90278477499e.js.wasm. */
8
+ /** The WebAssembly module, engine/julc-vm-47a30d49de00.js.wasm. */
9
9
  export declare const moduleUrl: URL;
10
10
  /** The JuLC release of this package, its engine and the client it needs. */
11
- export declare const version: "0.1.0-pre21";
11
+ export declare const version: "0.1.0-pre22";
12
12
  /** New objects describing the engine on every call; createJulc's package mode takes them as they are. */
13
- export declare function engineFiles(): {manifest: Manifest; launcherUrl: URL; moduleUrl: URL; version: "0.1.0-pre21"};
13
+ export declare function engineFiles(): {manifest: Manifest; launcherUrl: URL; moduleUrl: URL; version: "0.1.0-pre22"};
package/engine.js CHANGED
@@ -1,20 +1,20 @@
1
- // Generated at build time from engine/engine.json (ADR-077 D2): the engine files of @julclang/julc-vm-wasm 0.1.0-pre21.
1
+ // Generated at build time from engine/engine.json (ADR-077 D2): the engine files of @julclang/julc-vm-wasm 0.1.0-pre22.
2
2
  // Each is named by a string literal, so bundlers copy it and it resolves beside this module.
3
3
  const freeze = value => {
4
4
  for (const member of Object.values(value)) if (typeof member === 'object' && member !== null) freeze(member);
5
5
  return Object.freeze(value);
6
6
  };
7
- export const manifest = freeze({"version":"90278477499e","launcher":"julc-vm-90278477499e.js","variant":"vm","api":0,"groups":["vm","debug"],"julcVersion":"0.1.0-pre21"});
8
- export const launcherUrl = new URL('./engine/julc-vm-90278477499e.js', import.meta.url);
9
- export const moduleUrl = new URL('./engine/julc-vm-90278477499e.js.wasm', import.meta.url);
10
- export const version = "0.1.0-pre21";
7
+ export const manifest = freeze({"version":"47a30d49de00","launcher":"julc-vm-47a30d49de00.js","variant":"vm","api":0,"groups":["vm","debug"],"julcVersion":"0.1.0-pre22"});
8
+ export const launcherUrl = new URL('./engine/julc-vm-47a30d49de00.js', import.meta.url);
9
+ export const moduleUrl = new URL('./engine/julc-vm-47a30d49de00.js.wasm', import.meta.url);
10
+ export const version = "0.1.0-pre22";
11
11
 
12
12
  /** New objects describing the engine on every call, independent of the exports above. */
13
13
  export function engineFiles() {
14
14
  return {
15
- manifest: {"version":"90278477499e","launcher":"julc-vm-90278477499e.js","variant":"vm","api":0,"groups":["vm","debug"],"julcVersion":"0.1.0-pre21"},
16
- launcherUrl: new URL('./engine/julc-vm-90278477499e.js', import.meta.url),
17
- moduleUrl: new URL('./engine/julc-vm-90278477499e.js.wasm', import.meta.url),
18
- version: "0.1.0-pre21",
15
+ manifest: {"version":"47a30d49de00","launcher":"julc-vm-47a30d49de00.js","variant":"vm","api":0,"groups":["vm","debug"],"julcVersion":"0.1.0-pre22"},
16
+ launcherUrl: new URL('./engine/julc-vm-47a30d49de00.js', import.meta.url),
17
+ moduleUrl: new URL('./engine/julc-vm-47a30d49de00.js.wasm', import.meta.url),
18
+ version: "0.1.0-pre22",
19
19
  };
20
20
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@julclang/julc-vm-wasm",
3
- "version": "0.1.0-pre21",
3
+ "version": "0.1.0-pre22",
4
4
  "description": "JuLC's Plutus VM as WebAssembly, for browsers and Node.js: decode, hash, apply parameters to, evaluate and debug Plutus V1, V2 and V3 scripts. Experimental: API version 0.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -30,7 +30,7 @@
30
30
  "node": ">=22.3.0"
31
31
  },
32
32
  "dependencies": {
33
- "@julclang/wasm-client": "0.1.0-pre21"
33
+ "@julclang/wasm-client": "0.1.0-pre22"
34
34
  },
35
35
  "files": [
36
36
  "LICENSE",