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

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.1",
+  "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.1"
-  },
-  "devDependencies": {
-    "@codspeed/vitest-plugin": "^5.4.0",
-    "solid-js": "2.0.0-rc.1"
-  },
   "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,12 +3,15 @@
 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()
 });
-const TRACE = Symbol.for("dom-expressions.container-trace");
+function setContainerTraceStreamMint(fn) {
+  state.streamOf = fn;
+}
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -20,13 +23,14 @@ function materialize(marker) {
 }
 function parseTrace(value, ctx) {
   const trace = value[TRACE];
+  const sub = trace.subscribe();
   return {
     a: trace.array ? 1 : 0,
-    i: ctx.parse(trace.subscribe())
+    i: ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -36,9 +40,10 @@ const ContainerTracePlugin = {
     },
     async async(value, ctx) {
       const trace = value[TRACE];
+      const sub = trace.subscribe();
       return {
         a: trace.array ? 1 : 0,
-        i: await ctx.parse(trace.subscribe())
+        i: await ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
       };
     },
     stream: parseTrace
@@ -56,6 +61,18 @@ const ContainerTracePlugin = {
   }
 };
 
+setContainerTraceStreamMint(iterable => {
+  const stream = seroval.createStream();
+  (async () => {
+    try {
+      for await (const value of iterable) stream.next(value);
+      stream.return(undefined);
+    } catch (error) {
+      stream.throw(error);
+    }
+  })();
+  return stream;
+});
 const DEFAULT_WEB_PLUGINS = Object.freeze([web.AbortSignalPlugin,
 web.CustomEventPlugin, web.DOMExceptionPlugin, web.EventPlugin,
 web.FormDataPlugin, web.HeadersPlugin, web.ReadableStreamPlugin, web.RequestPlugin, web.ResponsePlugin, web.URLSearchParamsPlugin, web.URLPlugin,

package/serialization/dist/decode.js

@@ -1,12 +1,15 @@
-import { Feature, fromCrossJSON } from 'seroval';
+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()
 });
-const TRACE = Symbol.for("dom-expressions.container-trace");
+function setContainerTraceStreamMint(fn) {
+  state.streamOf = fn;
+}
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -18,13 +21,14 @@ function materialize(marker) {
 }
 function parseTrace(value, ctx) {
   const trace = value[TRACE];
+  const sub = trace.subscribe();
   return {
     a: trace.array ? 1 : 0,
-    i: ctx.parse(trace.subscribe())
+    i: ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -34,9 +38,10 @@ const ContainerTracePlugin = {
     },
     async async(value, ctx) {
       const trace = value[TRACE];
+      const sub = trace.subscribe();
       return {
         a: trace.array ? 1 : 0,
-        i: await ctx.parse(trace.subscribe())
+        i: await ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
       };
     },
     stream: parseTrace
@@ -54,6 +59,18 @@ const ContainerTracePlugin = {
   }
 };
 
+setContainerTraceStreamMint(iterable => {
+  const stream = createStream();
+  (async () => {
+    try {
+      for await (const value of iterable) stream.next(value);
+      stream.return(undefined);
+    } catch (error) {
+      stream.throw(error);
+    }
+  })();
+  return stream;
+});
 const DEFAULT_WEB_PLUGINS = Object.freeze([AbortSignalPlugin,
 CustomEventPlugin, DOMExceptionPlugin, EventPlugin,
 FormDataPlugin, HeadersPlugin, ReadableStreamPlugin, RequestPlugin, ResponsePlugin, URLSearchParamsPlugin, URLPlugin,

package/serialization/dist/serialization.cjs

@@ -3,12 +3,15 @@
 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()
 });
-const TRACE = Symbol.for("dom-expressions.container-trace");
+function setContainerTraceStreamMint(fn) {
+  state.streamOf = fn;
+}
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -20,13 +23,14 @@ function materialize(marker) {
 }
 function parseTrace(value, ctx) {
   const trace = value[TRACE];
+  const sub = trace.subscribe();
   return {
     a: trace.array ? 1 : 0,
-    i: ctx.parse(trace.subscribe())
+    i: ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -36,9 +40,10 @@ const ContainerTracePlugin = {
     },
     async async(value, ctx) {
       const trace = value[TRACE];
+      const sub = trace.subscribe();
       return {
         a: trace.array ? 1 : 0,
-        i: await ctx.parse(trace.subscribe())
+        i: await ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
       };
     },
     stream: parseTrace
@@ -56,6 +61,18 @@ const ContainerTracePlugin = {
   }
 };
 
+setContainerTraceStreamMint(iterable => {
+  const stream = seroval.createStream();
+  (async () => {
+    try {
+      for await (const value of iterable) stream.next(value);
+      stream.return(undefined);
+    } catch (error) {
+      stream.throw(error);
+    }
+  })();
+  return stream;
+});
 const DEFAULT_WEB_PLUGINS = Object.freeze([web.AbortSignalPlugin,
 web.CustomEventPlugin, web.DOMExceptionPlugin, web.EventPlugin,
 web.FormDataPlugin, web.HeadersPlugin, web.ReadableStreamPlugin, web.RequestPlugin, web.ResponsePlugin, web.URLSearchParamsPlugin, web.URLPlugin,
@@ -118,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,
@@ -225,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,13 +1,15 @@
-import { Feature, fromCrossJSON, 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()
 });
-const TRACE = Symbol.for("dom-expressions.container-trace");
+function setContainerTraceStreamMint(fn) {
+  state.streamOf = fn;
+}
+const TRACE = Symbol.for("solid.container-trace");
 function materialize(marker) {
   let value = state.materialized.get(marker.$tr);
   if (value === undefined) {
@@ -19,13 +21,14 @@ function materialize(marker) {
 }
 function parseTrace(value, ctx) {
   const trace = value[TRACE];
+  const sub = trace.subscribe();
   return {
     a: trace.array ? 1 : 0,
-    i: ctx.parse(trace.subscribe())
+    i: ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
   };
 }
 const ContainerTracePlugin = {
-  tag: "dom-expressions/container-trace",
+  tag: "solid/container-trace",
   test(value) {
     return value != null && typeof value === "object" && TRACE in value;
   },
@@ -35,9 +38,10 @@ const ContainerTracePlugin = {
     },
     async async(value, ctx) {
       const trace = value[TRACE];
+      const sub = trace.subscribe();
       return {
         a: trace.array ? 1 : 0,
-        i: await ctx.parse(trace.subscribe())
+        i: await ctx.parse(state.streamOf ? state.streamOf(sub) : sub)
       };
     },
     stream: parseTrace
@@ -55,6 +59,18 @@ const ContainerTracePlugin = {
   }
 };
 
+setContainerTraceStreamMint(iterable => {
+  const stream = createStream();
+  (async () => {
+    try {
+      for await (const value of iterable) stream.next(value);
+      stream.return(undefined);
+    } catch (error) {
+      stream.throw(error);
+    }
+  })();
+  return stream;
+});
 const DEFAULT_WEB_PLUGINS = Object.freeze([AbortSignalPlugin,
 CustomEventPlugin, DOMExceptionPlugin, EventPlugin,
 FormDataPlugin, HeadersPlugin, ReadableStreamPlugin, RequestPlugin, ResponsePlugin, URLSearchParamsPlugin, URLPlugin,
@@ -117,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,
@@ -224,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;
 };