@polyengine/runtime 0.1.0-pre.g633468a

package/esm/jspi/suspending.js

@@ -0,0 +1,15 @@
+// The per-declaration suspendability marker (contracts/embedder-api.md
+// §"Functions and async", amendments A1/A2; docs/architecture.md §5).
+//
+// The canonical definitions live in `@polyengine/protocol` since amendment A9:
+// the mark is a process-global `Symbol.for("polyengine.suspending/1")` brand, so
+// a function marked by ANY runtime copy is honored by every other copy
+// (issue #83 — a module-local symbol made a copy-B mark invisible to copy A's
+// `anySuspendingImport`, silently downgrading the calling convention and
+// surfacing far away as `NeedsJspi`).
+//
+// Layering: this module was import-free on purpose (jspi/ stays standalone);
+// A9 relaxes that to "imports `@polyengine/protocol` only" — the protocol package
+// is itself dependency-free, so jspi/ still pulls in no runtime machinery.
+// The embedder surface re-exports `suspending` from `@polyengine/runtime/embedder`.
+export { anySuspendingImport, isSuspending, suspending } from "@polyengine/protocol";

package/esm/jspi/types.js

@@ -0,0 +1,29 @@
+// Module-scoped types + accessor for the JS Promise Integration (JSPI) API.
+//
+// JSPI is phase 4 (docs/architecture.md §3) and not yet part of TypeScript's/Deno's
+// built-in `lib.dom`/`lib.deno` typings. These declarations match the shape
+// implemented by V8 (observed via Deno 2.9.5 / V8 15.0.245.2-rusty) and
+// described by the js-promise-integration proposal Overview
+// (https://github.com/WebAssembly/js-promise-integration).
+//
+// Deliberately NOT a `declare global` augmentation (it was one until JSR's
+// server-side validation refused the package: "modifying global types is
+// not allowed"). The registry policy and the truth agree here: JSPI is an
+// OPTIONAL engine capability this runtime probes at runtime, and a global
+// augmentation asserted it unconditionally for every downstream consumer.
+// The module-scoped view keeps the assertion where the evidence is —
+// `jspiApi()` returns the surface only when the engine actually has it.
+// (Tests keep their own ambient declarations in
+// runtime/tests/jspi/global_types.ts; test files are never published.)
+/**
+ * The engine's JSPI API, or `null` where the proposal is not implemented.
+ * The one sanctioned way to reach `WebAssembly.Suspending`/`promising`
+ * from this codebase's published modules.
+ */
+export function jspiApi() {
+    const wa = WebAssembly;
+    return typeof wa.promising === "function" &&
+        typeof wa.Suspending === "function"
+        ? wa
+        : null;
+}

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/plan/format.js

@@ -0,0 +1,5 @@
+// Plan v0 wire format (contracts/plan-format.md) — TypeScript mirror of the
+// shim's serde schema (crates/translator-shim/src/plan.rs). Field names and
+// shapes must track the Rust side tag-for-tag; the shim is the producer of
+// record.
+export {};