@solidjs/web 2.0.0-rc.2 → 2.0.0-rc.3

package/frames/dist/server.js

@@ -1,8 +1,8 @@
-import { createMemo, runWithOwner, createOwner, sharedConfig, createRoot, ssrHandleError, getOwner, inServerComponentScope, creationStamp, NoHydration, runInServerComponentScope, Hydration, getProjectionTrace } from 'solid-js';
+import { sharedConfig, createRoot, ssrHandleError, getOwner, runWithOwner, inServerComponentScope, creationStamp, NoHydration, runInServerComponentScope, createMemo, Hydration, createOwner, getProjectionTrace } from 'solid-js';
 import { Feature, createStream, toCrossJSONStream, Serializer, getCrossReferenceHeader } from 'seroval';
 import { AbortSignalPlugin, CustomEventPlugin, DOMExceptionPlugin, EventPlugin, FormDataPlugin, HeadersPlugin, ReadableStreamPlugin, RequestPlugin, ResponsePlugin, URLSearchParamsPlugin, URLPlugin } from 'seroval-plugins/web';
 
-const STATE = Symbol.for("dom-expressions.container-trace-state");
+const STATE = Symbol.for("solid.container-trace-state");
 const state = globalThis[STATE] || (globalThis[STATE] = {
   materialized: new WeakMap(),
   materializedValues: new WeakSet()
@@ -17,7 +17,7 @@ function isContainerTraced(value) {
   const resolve = state.resolveTrace;
   return !!(resolve && value && typeof value === "object" && resolve(value));
 }
-const TRACE = Symbol.for("dom-expressions.container-trace");
+const TRACE = Symbol.for("solid.container-trace");
 function envelopeContainerTraces(value) {
   if (!state.resolveTrace || value == null || typeof value !== "object") return value;
   const trace = state.resolveTrace(value);
@@ -68,7 +68,7 @@ function parseTrace(value, ctx) {
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -99,13 +99,6 @@ const ContainerTracePlugin = {
   }
 };
 
-const runWithHydrationScope = (id, fn) => runWithOwner(createOwner({
-  id
-}), fn);
-const ssrAsyncValue = value => createMemo(() => value, {
-  serialize: false
-});
-
 setContainerTraceStreamMint(iterable => {
   const stream = createStream();
   (async () => {
@@ -1816,6 +1809,15 @@ function createLiveHoles(sink, scoped) {
   const stamp = typeof creationStamp === "function" ? creationStamp : () => 0;
   const inScope = scoped && typeof inServerComponentScope === "function" ? inServerComponentScope : null;
   const stripMarkers = html => html.replace(/<!--lh:\/?\d+-->/g, "");
+  const swept = (owner, ctx, fn) => {
+    const prev = sharedConfig.context;
+    sharedConfig.context = ctx;
+    try {
+      return owner ? runWithOwner(owner, fn) : fn();
+    } finally {
+      sharedConfig.context = prev;
+    }
+  };
   function resolveHoleValue(hole) {
     const result = {
       t: [""],
@@ -1881,6 +1883,7 @@ function createLiveHoles(sink, scoped) {
       const recordsBefore = engine.recordStamp;
       const ownersBefore = stamp();
       const owner = getOwner();
+      const holeCtx = sharedConfig.context;
       const b = {
         key: null,
         children: [],
@@ -1894,7 +1897,7 @@ function createLiveHoles(sink, scoped) {
           const sweepOwnersBefore = stamp();
           let res;
           try {
-            res = owner ? runWithOwner(owner, () => resolveHoleValue(hole)) : resolveHoleValue(hole);
+            res = swept(owner, holeCtx, () => resolveHoleValue(hole));
           } catch (err) {
             b.closed = true;
             sink.closeBinding(b.key);
@@ -2002,6 +2005,7 @@ function createLiveHoles(sink, scoped) {
     },
     attr(cap) {
       const owner = getOwner();
+      const holeCtx = sharedConfig.context;
       const b = {
         key: "lha:" + cap.id,
         children: [],
@@ -2037,7 +2041,7 @@ function createLiveHoles(sink, scoped) {
                 if (vt === "string" || vt === "number") html += v;
               }
             };
-            owner ? runWithOwner(owner, run) : run();
+            swept(owner, holeCtx, run);
           } catch (err) {
             if (ssrHandleError(err, true)) return;
             b.closed = true;
@@ -2297,7 +2301,7 @@ function ssr(t) {
   };
   return result;
 }
-const CLAIM_PROP = /*#__PURE__*/Symbol.for("dom-expressions.claim-prop");
+const CLAIM_PROP = /*#__PURE__*/Symbol.for("solid.claim-prop");
 const CLAIMS_STREAM = 1;
 const CLAIMS_DOCUMENT = 2;
 function resolveSSRSelectValues(html) {
@@ -2668,9 +2672,9 @@ const FRAME_STREAM_HEADER = "X-Frame-Stream";
 function isFrameStreamResponse(response) {
   return response.headers.has(FRAME_STREAM_HEADER);
 }
-const SERVER_COMPONENT = /*#__PURE__*/Symbol.for("dom-expressions.server-component");
-const SERVER_COMPONENT_SOURCE = /*#__PURE__*/Symbol.for("dom-expressions.server-component-source");
-const SERVER_COMPONENT_ADDRESS = /*#__PURE__*/Symbol.for("dom-expressions.server-component-address");
+const SERVER_COMPONENT = /*#__PURE__*/Symbol.for("solid.server-component");
+const SERVER_COMPONENT_SOURCE = /*#__PURE__*/Symbol.for("solid.server-component-source");
+const SERVER_COMPONENT_ADDRESS = /*#__PURE__*/Symbol.for("solid.server-component-address");
 let serverComponentRegistryExpr;
 function setServerComponentBootstrap(resolve) {
   serverComponentRegistryExpr = resolve;
@@ -2682,7 +2686,7 @@ function parseServerComponent(value, ctx) {
   };
 }
 const ServerComponentPlugin = {
-  tag: "dom-expressions/server-component",
+  tag: "solid/server-component",
   test(value) {
     return typeof value === "function" && SERVER_COMPONENT in value;
   },
@@ -2715,6 +2719,12 @@ function flightCodec(codec) {
   };
 }
 
+const runWithHydrationScope = (id, fn) => runWithOwner(createOwner({
+  id
+}), fn);
+const ssrAsyncValue = value => createMemo(() => value, {
+  serialize: false
+});
 const scopeStamp = typeof creationStamp === "function" ? creationStamp : () => 0;
 function serverOwned(render) {
   return NoHydration ? NoHydration({
@@ -3293,7 +3303,7 @@ function createDocumentSlotProps(clientProps, frameId) {
     }
   });
 }
-const FRAME_TAG = "dx-frame";
+const FRAME_TAG = "solid-frame";
 const FRAME_ID_ATTR = "data-fid";
 function frameElementOpen(id) {
   const escaped = sharedConfig.context ? sharedConfig.context.escape(String(id), true) : String(id);

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@solidjs/web",
   "description": "Solid's web runtime: client rendering, hydration, SSR, and DOM-specific control flow (Portal, Dynamic).",
-  "version": "2.0.0-rc.2",
+  "version": "2.0.0-rc.3",
   "author": "Ryan Carniato",
   "license": "MIT",
   "homepage": "https://solidjs.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/solidjs/solid.git",
-    "directory": "packages/solid-web"
+    "directory": "packages/web"
   },
   "publishConfig": {
     "access": "public"
@@ -373,32 +373,18 @@
     },
     "./types/*": "./types/*"
   },
-  "dependencies": {
-    "seroval": "~1.5.4",
-    "seroval-plugins": "~1.5.4"
-  },
-  "peerDependencies": {
-    "solid-js": "^2.0.0-rc.2"
-  },
-  "devDependencies": {
-    "@codspeed/vitest-plugin": "^5.4.0",
-    "solid-js": "2.0.0-rc.2"
-  },
   "scripts": {
     "build": "npm-run-all -nl build:clean types:copy-jsx build:js",
     "build:clean": "rimraf dist/",
     "build:js": "rollup -c",
     "link": "symlink-dir . node_modules/@solidjs/web",
-    "types": "npm-run-all -nl types:clean types:copy-jsx types:web types:copy-web types:web-storage types:copy-server-functions types:copy-serialization types:web-frames types:copy-frames types:cjs",
-    "types:clean": "rimraf types/ types-cjs/ storage/types/ storage/types-cjs/ serialization/types/ serialization/types-cjs/ frames/types/",
-    "types:copy-jsx": "ncp ../../node_modules/@dom-expressions/runtime/src/jsx.d.ts ./src/jsx.d.ts && ncp ../../node_modules/@dom-expressions/runtime/src/jsx-properties.d.ts ./src/jsx-properties.d.ts && dom-expressions-jsx-types --input ./src/jsx.d.ts --element \"SolidElement | Node | ArrayElement\" --import 'import type { Element as SolidElement } from \"solid-js\";'",
+    "types": "npm-run-all -nl types:clean types:copy-jsx types:web types:copy-web types:web-storage types:cjs",
+    "types:clean": "rimraf types/ types-cjs/ storage/types/ storage/types-cjs/ serialization/types/ serialization/types-cjs/ frames/types/ .types-build/",
+    "jsx-sync": "node ./scripts/jsx-sync.mjs --compile --element \"SolidElement | Node | ArrayElement\" --import \"import type { Element as SolidElement } from \\\"solid-js\\\";\"",
+    "types:copy-jsx": "pnpm run jsx-sync",
     "types:web": "tsc --project ./tsconfig.build.json",
-    "types:copy-web": "node -e \"const src = fs.readFileSync('../../node_modules/@dom-expressions/runtime/src/client.d.ts', 'utf8'); const marker = 'export type { RequestEventLocals } from'; if (!src.includes(marker)) throw new Error('client.d.ts drift: the type-only RequestEventLocals re-export was not found — revisit the augmentation-identity rewrite'); fs.writeFileSync('./types/client.d.ts', src.replace(marker, 'export { RequestEventLocals } from'));\" && ncp ../../node_modules/@dom-expressions/runtime/src/server.d.ts ./types/server.d.ts && ncp ../../node_modules/@dom-expressions/runtime/src/serializer.d.ts ./types/serializer.d.ts && ncp ../../node_modules/@dom-expressions/runtime/src/serializer-decode.d.ts ./types/serializer-decode.d.ts && ncp ../../node_modules/@dom-expressions/runtime/src/response.d.ts ./types/response.d.ts && ncp ../../node_modules/@dom-expressions/runtime/src/cookies.d.ts ./types/cookies.d.ts && ncp ./src/jsx.d.ts ./types/jsx.d.ts && ncp ./src/jsx-properties.d.ts ./types/jsx-properties.d.ts",
+    "types:copy-web": "node ./scripts/copy-types.mjs",
     "types:web-storage": "tsc --project ./storage/tsconfig.build.json",
-    "types:web-frames": "tsc --project ./frames/tsconfig.build.json",
-    "types:copy-serialization": "node -e \"fs.mkdirSync('./serialization/types', { recursive: true }); fs.copyFileSync('../../node_modules/@dom-expressions/runtime/src/serializer.d.ts', './serialization/types/index.d.ts'); fs.copyFileSync('../../node_modules/@dom-expressions/runtime/src/serializer-decode.d.ts', './serialization/types/serializer-decode.d.ts');\"",
-    "types:copy-server-functions": "node -e \"fs.mkdirSync('./types/server-functions', { recursive: true }); for (const f of ['shared', 'flash', 'client', 'server', 'rich-args']) fs.copyFileSync('../../node_modules/@dom-expressions/runtime/src/server-functions/' + f + '.d.ts', './types/server-functions/' + f + '.d.ts');\"",
-    "types:copy-frames": "node -e \"fs.mkdirSync('./types/frames', { recursive: true }); for (const f of ['frame-client', 'frame-transport', 'frame-sink', 'serializer']) fs.copyFileSync('../../node_modules/@dom-expressions/runtime/src/' + f + '.d.ts', './types/frames/' + f + '.d.ts'); for (const f of ['client', 'server']) fs.writeFileSync('./types/frames/' + f + '.d.ts', fs.readFileSync('./frames/types/' + f + '.d.ts', 'utf8').replaceAll('@dom-expressions/runtime/src/', './'));\"",
     "types:cjs": "node ../../scripts/sync-dual-types.mjs ./types ./types-cjs ./storage/types ./storage/types-cjs ./serialization/types ./serialization/types-cjs",
     "test": "vitest run && vitest run --config vite.config.server.mjs && vitest run --config vite.config.hydrate.mjs",
     "test:server": "vitest run --config vite.config.server.mjs",
@@ -406,5 +392,17 @@
     "bench": "vitest bench --run",
     "bench:server": "vitest bench --run --config vite.config.server-bench.mjs",
     "test-types": "tsc --project tsconfig.test.json"
+  },
+  "dependencies": {
+    "seroval": "~1.5.4",
+    "seroval-plugins": "~1.5.4"
+  },
+  "peerDependencies": {
+    "solid-js": "^2.0.0-rc.3"
+  },
+  "devDependencies": {
+    "@codspeed/vitest-plugin": "^5.4.0",
+    "@solidjs/signals": "workspace:*",
+    "solid-js": "workspace:*"
   }
-}
+}

package/serialization/dist/decode.cjs

@@ -3,7 +3,7 @@
 var seroval = require('seroval');
 var web = require('seroval-plugins/web');
 
-const STATE = Symbol.for("dom-expressions.container-trace-state");
+const STATE = Symbol.for("solid.container-trace-state");
 const state = globalThis[STATE] || (globalThis[STATE] = {
   materialized: new WeakMap(),
   materializedValues: new WeakSet()
@@ -11,7 +11,7 @@ const state = globalThis[STATE] || (globalThis[STATE] = {
 function setContainerTraceStreamMint(fn) {
   state.streamOf = fn;
 }
-const TRACE = Symbol.for("dom-expressions.container-trace");
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -30,7 +30,7 @@ function parseTrace(value, ctx) {
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },

package/serialization/dist/decode.js

@@ -1,7 +1,7 @@
 import { Feature, fromCrossJSON, createStream } from 'seroval';
 import { AbortSignalPlugin, CustomEventPlugin, DOMExceptionPlugin, EventPlugin, FormDataPlugin, HeadersPlugin, ReadableStreamPlugin, RequestPlugin, ResponsePlugin, URLSearchParamsPlugin, URLPlugin } from 'seroval-plugins/web';
 
-const STATE = Symbol.for("dom-expressions.container-trace-state");
+const STATE = Symbol.for("solid.container-trace-state");
 const state = globalThis[STATE] || (globalThis[STATE] = {
   materialized: new WeakMap(),
   materializedValues: new WeakSet()
@@ -9,7 +9,7 @@ const state = globalThis[STATE] || (globalThis[STATE] = {
 function setContainerTraceStreamMint(fn) {
   state.streamOf = fn;
 }
-const TRACE = Symbol.for("dom-expressions.container-trace");
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -28,7 +28,7 @@ function parseTrace(value, ctx) {
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },

package/serialization/dist/serialization.cjs

@@ -3,7 +3,7 @@
 var seroval = require('seroval');
 var web = require('seroval-plugins/web');
 
-const STATE = Symbol.for("dom-expressions.container-trace-state");
+const STATE = Symbol.for("solid.container-trace-state");
 const state = globalThis[STATE] || (globalThis[STATE] = {
   materialized: new WeakMap(),
   materializedValues: new WeakSet()
@@ -11,7 +11,7 @@ const state = globalThis[STATE] || (globalThis[STATE] = {
 function setContainerTraceStreamMint(fn) {
   state.streamOf = fn;
 }
-const TRACE = Symbol.for("dom-expressions.container-trace");
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -30,7 +30,7 @@ function parseTrace(value, ctx) {
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -135,6 +135,8 @@ function createJSONDataTable(options) {
 const DEFAULT_DISABLED_FEATURES = seroval.Feature.AggregateError | seroval.Feature.BigIntTypedArray;
 const serializeOnlyDisabledFeatures = () => process.env.NODE_ENV === "development" ? 0 : seroval.Feature.ErrorPrototypeStack;
 const HYDRATION_GLOBAL = "_$HY.r";
+const createPlugin = seroval.createPlugin;
+const OpaqueReference = seroval.OpaqueReference;
 function createSerializer(options) {
   return new seroval.Serializer({
     ...options,
@@ -242,19 +244,13 @@ function createJSONSerializer({
   };
 }
 
-Object.defineProperty(exports, "OpaqueReference", {
-  enumerable: true,
-  get: function () { return seroval.OpaqueReference; }
-});
-Object.defineProperty(exports, "createPlugin", {
-  enumerable: true,
-  get: function () { return seroval.createPlugin; }
-});
 exports.DEFAULT_WEB_PLUGINS = DEFAULT_WEB_PLUGINS;
+exports.OpaqueReference = OpaqueReference;
 exports.createHydrationSerializer = createHydrationSerializer;
 exports.createJSONDataTable = createJSONDataTable;
 exports.createJSONDeserializer = createJSONDeserializer;
 exports.createJSONSerializer = createJSONSerializer;
+exports.createPlugin = createPlugin;
 exports.createSerializer = createSerializer;
 exports.getLocalHeaderScript = getLocalHeaderScript;
 exports.resolveSerializerPlugins = resolveSerializerPlugins;

package/serialization/dist/serialization.js

@@ -1,8 +1,7 @@
-import { Feature, fromCrossJSON, createStream, toCrossJSONStream, Serializer, getCrossReferenceHeader } from 'seroval';
-export { OpaqueReference, createPlugin } from 'seroval';
+import { Feature, fromCrossJSON, createStream, OpaqueReference as OpaqueReference$1, createPlugin as createPlugin$1, toCrossJSONStream, Serializer, getCrossReferenceHeader } from 'seroval';
 import { AbortSignalPlugin, CustomEventPlugin, DOMExceptionPlugin, EventPlugin, FormDataPlugin, HeadersPlugin, ReadableStreamPlugin, RequestPlugin, ResponsePlugin, URLSearchParamsPlugin, URLPlugin } from 'seroval-plugins/web';
 
-const STATE = Symbol.for("dom-expressions.container-trace-state");
+const STATE = Symbol.for("solid.container-trace-state");
 const state = globalThis[STATE] || (globalThis[STATE] = {
   materialized: new WeakMap(),
   materializedValues: new WeakSet()
@@ -10,7 +9,7 @@ const state = globalThis[STATE] || (globalThis[STATE] = {
 function setContainerTraceStreamMint(fn) {
   state.streamOf = fn;
 }
-const TRACE = Symbol.for("dom-expressions.container-trace");
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -29,7 +28,7 @@ function parseTrace(value, ctx) {
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -134,6 +133,8 @@ function createJSONDataTable(options) {
 const DEFAULT_DISABLED_FEATURES = Feature.AggregateError | Feature.BigIntTypedArray;
 const serializeOnlyDisabledFeatures = () => process.env.NODE_ENV === "development" ? 0 : Feature.ErrorPrototypeStack;
 const HYDRATION_GLOBAL = "_$HY.r";
+const createPlugin = createPlugin$1;
+const OpaqueReference = OpaqueReference$1;
 function createSerializer(options) {
   return new Serializer({
     ...options,
@@ -241,4 +242,4 @@ function createJSONSerializer({
   };
 }
 
-export { DEFAULT_WEB_PLUGINS, createHydrationSerializer, createJSONDataTable, createJSONDeserializer, createJSONSerializer, createSerializer, getLocalHeaderScript, resolveSerializerPlugins, serializeJSON };
+export { DEFAULT_WEB_PLUGINS, OpaqueReference, createHydrationSerializer, createJSONDataTable, createJSONDeserializer, createJSONSerializer, createPlugin, createSerializer, getLocalHeaderScript, resolveSerializerPlugins, serializeJSON };

package/serialization/types/index.d.ts

@@ -1,182 +1,94 @@
-// Serialization surface (published as `@solidjs/web/serialization`): the
-// runtime's Seroval machinery, exposed for the runtime's own entries and
-// for integrations building transports on the same codec. This is
-// INTEGRATION-FACING plumbing, not application API — it is exempt from the
-// 2.0 stability guarantee and may change between releases. Application and
-// router code should configure `codec` on the server-function entries
-// instead of importing from here.
-import type { Serializer } from "seroval";
-import {
-  JSONCodecOptions,
-  PluginInfo,
-  SerializerPlugin,
-  SerovalNode
-} from "./serializer-decode.js";
-
-// The decode half — `SerovalNode`, the plugin TYPES, `DEFAULT_WEB_PLUGINS`,
-// `resolveSerializerPlugins`, `JSONCodecOptions`, `createJSONDeserializer`,
-// `createJSONDataTable` — is declared in serializer-decode.d.ts (published
-// as `@solidjs/web/serialization/decode`, the module lazy client consumers
-// load) and re-exported here so this remains the full surface.
-export * from "./serializer-decode.js";
-
-// ---- Plugin authoring ----
-//
-// Unlike the rest of this entry, plugin authoring is APPLICATION-FACING —
-// it is the supported way to feed the serializers' `plugins` options and
-// the server-function entries' `codec.plugins`. The values re-export
-// seroval's own (`createPlugin`, `OpaqueReference` — see serializer.js);
-// the plugin TYPES live in serializer-decode.d.ts (hand-declared there —
-// see its banner for why).
-
-/**
- * Builds a `SerializerPlugin` — seroval's `createPlugin`, re-exported so
- * plugin authors stay on the exact seroval instance/version the runtime
- * serializes with. Import it from HERE, not from your own `seroval`
- * dependency: a plugin built against a different copy/version would not
- * fail the build — it would emit nodes the other peer can't interpret.
- *
- * Application-facing (see the plugin-authoring banner above).
- */
-export function createPlugin<Value, Info extends PluginInfo>(
-  plugin: SerializerPlugin<Value, Info>
-): SerializerPlugin<Value, Info>;
-
-/**
- * Seroval's `OpaqueReference`, re-exported from the runtime's own instance
- * (an `OpaqueReference` from another seroval copy fails the serializer's
- * instanceof check and serializes as a plain value): wraps a value so it
- * crosses the wire as its `replacement` (default `undefined`) while
- * staying readable in-process through `.value`.
- *
- * Application-facing (see the plugin-authoring banner above).
- */
-export class OpaqueReference<V, R = undefined> {
-  readonly value: V;
-  readonly replacement?: R;
-  constructor(value: V, replacement?: R);
-}
-
+import { Serializer } from "seroval";
+import type { JSONCodecOptions, PluginInfo, SerializerPlugin, SerovalNode } from "./serializer-decode.js";
+export { DEFAULT_WEB_PLUGINS, createJSONDataTable, createJSONDeserializer, resolveSerializerPlugins } from "./serializer-decode.js";
+export type * from "./serializer-decode.js";
 /**
  * Options for `createSerializer`.
  *
  * Integration-facing; may change (see the entry banner).
  */
 export interface WebSerializerOptions {
-  /** Name of the global object the emitted scripts write resolved values into. */
-  globalIdentifier: string;
-  /** Cross-reference scope id, for isolating multiple streams on one page. */
-  scopeId?: string;
-  /**
-   * Seroval feature bitflags to exclude from output. Defaults to disabling
-   * post-ES2017 features (AggregateError, BigInt typed arrays). Outside
-   * development, `Error.prototype.stack` is additionally stripped on top of
-   * any override — serialized stacks leak server paths to the client.
-   */
-  disabledFeatures?: number;
-  /** Extra plugins, composed ahead of `DEFAULT_WEB_PLUGINS`. */
-  plugins?: SerializerPlugin[];
-  /** Receives each emitted script chunk. */
-  onData: (result: string) => void;
-  onError?: (error: unknown) => void;
-  /** Fires once all async values have settled. */
-  onDone?: () => void;
+    /** Name of the global object the emitted scripts write resolved values into. */
+    globalIdentifier: string;
+    /** Cross-reference scope id, for isolating multiple streams on one page. */
+    scopeId?: string;
+    /**
+     * Seroval feature bitflags to exclude from output. Defaults to disabling
+     * post-ES2017 features (AggregateError, BigInt typed arrays). Outside
+     * development, `Error.prototype.stack` is additionally stripped on top of
+     * any override — serialized stacks leak server paths to the client.
+     */
+    disabledFeatures?: number;
+    /** Extra plugins, composed ahead of `DEFAULT_WEB_PLUGINS`. */
+    plugins?: SerializerPlugin[];
+    /** Receives each emitted script chunk. */
+    onData: (result: string) => void;
+    onError?: (error: unknown) => void;
+    /** Fires once all async values have settled. */
+    onDone?: () => void;
 }
-
-/**
- * Creates a streaming Seroval serializer preconfigured with the web plugin
- * set and the default feature policy. Emits JavaScript chunks (through
- * `onData`) that reconstruct the values under `globalIdentifier` when
- * evaluated — the script-injection form of serialization renderers build
- * on. For a JSON-based wire codec (no eval on the receiving side), use
- * `serializeJSON` / `createJSONDeserializer` instead.
- *
- * Integration-facing; may change (see the entry banner).
- */
-export function createSerializer(options: WebSerializerOptions): Serializer;
-
 /**
  * Options for `createHydrationSerializer` — `WebSerializerOptions` minus
  * the knobs hydration pins (`globalIdentifier`, `disabledFeatures`).
  * @internal
  */
-export type HydrationSerializerOptions = Omit<
-  WebSerializerOptions,
-  "globalIdentifier" | "disabledFeatures"
->;
-
-/**
- * Renderer primitive — the serializer SSR uses for hydration output. Pins
- * the hydration global (`_$HY.r`) and feature policy; only the wiring
- * options (callbacks, scope, extra plugins) are configurable. Not meant
- * for hand-written code — custom serialization should use
- * `createSerializer` or the JSON codec.
- * @internal
- */
-export function createHydrationSerializer(options: HydrationSerializerOptions): Serializer;
-
-/**
- * Renderer primitive — returns the cross-reference bootstrap script SSR
- * emits ahead of hydration data for a render scope. Not meant for
- * hand-written code.
- * @internal
- */
-export function getLocalHeaderScript(id?: string): string;
-
-// ---- JSON codec (server function transports) ----
-// (`JSONCodecOptions` and the decode half are declared in
-// serializer-decode.d.ts and re-exported above.)
-
+export type HydrationSerializerOptions = Omit<WebSerializerOptions, "globalIdentifier" | "disabledFeatures">;
 /**
  * Options for `serializeJSON`.
  *
  * Integration-facing; may change (see the entry banner).
  */
 export interface JSONSerializeOptions extends JSONCodecOptions {
-  /**
-   * Receives each serialized node; `initial` is true for the first chunk
-   * (the source value itself). Async values produce additional chunks as
-   * they resolve.
-   */
-  onParse: (node: SerovalNode, initial: boolean) => void;
-  onError?: (error: unknown) => void;
-  /** Fires once all async values have settled. */
-  onDone?: () => void;
+    /**
+     * Receives each serialized node; `initial` is true for the first chunk
+     * (the source value itself). Async values produce additional chunks as
+     * they resolve.
+     */
+    onParse: (node: SerovalNode, initial: boolean) => void;
+    onError?: (error: unknown) => void;
+    /** Fires once all async values have settled. */
+    onDone?: () => void;
 }
-
-/**
- * Serializes `value` as SerovalNode chunks delivered through `onParse` —
- * the encoding half of the eval-free JSON codec (RPC-style transports;
- * the deserializing peer needs no script evaluation, so CSP-safe). Wire
- * framing of the nodes is the transport's concern. Returns a cancel
- * function that aborts pending async serialization.
- *
- * Integration-facing; may change (see the entry banner).
- */
-export function serializeJSON(value: unknown, options: JSONSerializeOptions): () => void;
-
 /** Options for `createJSONSerializer`. */
 export interface JSONSerializerOptions extends JSONCodecOptions {
-  /**
-   * Receives each keyed record — `initial` is true for a key's first node
-   * (the written value itself); async values patch through later records
-   * under the same key. The decoding peer is `createJSONDataTable`.
-   */
-  onData: (record: { key: string; node: SerovalNode; initial: boolean }) => void;
-  onError?: (error: unknown) => void;
-  /** Fires once `flush()` has been called and every pending value settled. */
-  onDone?: () => void;
+    /**
+     * Receives each keyed record — `initial` is true for a key's first node
+     * (the written value itself); async values patch through later records
+     * under the same key. The decoding peer is `createJSONDataTable`.
+     */
+    onData: (record: {
+        key: string;
+        node: SerovalNode;
+        initial: boolean;
+    }) => void;
+    onError?: (error: unknown) => void;
+    /** Fires once `flush()` has been called and every pending value settled. */
+    onDone?: () => void;
+}
+export declare const createPlugin: <Value, Info extends PluginInfo>(plugin: SerializerPlugin<Value, Info>) => SerializerPlugin<Value, Info>;
+export interface OpaqueReference<V = unknown, R = undefined> {
+    readonly value: V;
+    readonly replacement?: R;
 }
-
+export declare const OpaqueReference: {
+    new <V, R = undefined>(value: V, replacement?: R): OpaqueReference<V, R>;
+};
 /**
- * The keyed, streaming encoder of the eval-free JSON codec — the render
- * stream's data serializer (frames default to it). Each `write(key, value)`
- * shares one reference space, so cross-record identity holds; `flush()`
- * marks the write set complete (writes after it are dropped, mirroring the
- * hydration serializer); `close()` aborts pending async serialization.
+ * Creates a streaming Seroval serializer preconfigured with the web plugin
+ * set and the default feature policy. Emits JavaScript chunks (through
+ * `onData`) that reconstruct the values under `globalIdentifier` when
+ * evaluated — the script-injection form of serialization renderers build
+ * on. For a JSON-based wire codec (no eval on the receiving side), use
+ * `serializeJSON` / `createJSONDeserializer` instead.
+ *
+ * Integration-facing; may change (see the entry banner).
  */
-export function createJSONSerializer(options: JSONSerializerOptions): {
-  write(key: string, value: unknown): void;
-  flush(): void;
-  close(): void;
+export declare function createSerializer(options: WebSerializerOptions): Serializer;
+export declare function createHydrationSerializer(options: HydrationSerializerOptions): Serializer;
+export declare function getLocalHeaderScript(id?: string): string;
+export declare function serializeJSON(value: unknown, options: JSONSerializeOptions): () => void;
+export declare function createJSONSerializer(options: JSONSerializerOptions): {
+    write(key: string, value: unknown): void;
+    flush(): void;
+    close(): void;
 };