vue-ssr-lite 0.1.13 → 0.1.14

package/README.md

@@ -971,29 +971,23 @@ writes into a shared store that a **sibling** component reads — because Vue do
 not block a sibling's render on an earlier sibling's `onServerPrefetch`. The
 sibling renders before the store is populated.
 
-The resolution contract handles this generically. In component setup:
+**Applications write no orchestration for this.** Reconcile resolved data into
+the store with `ssrWatch` exactly as you already would:
 
 ```ts
-import { useSsrResolution } from 'vue-ssr-lite'
-
-const resolution = useSsrResolution()
-let synchronous = true
-onServerPrefetch(async () => {
-  const data = await load()
-  store.set(key, data)
-  // Populated asynchronously, after the sibling already rendered: ask for one
-  // more pass. Inert in the browser.
-  if (resolution?.server && !synchronous) resolution.requestAdditionalPass()
-})
-synchronous = false
+const { result } = useMyQuery(vars, { ssr: true })
+ssrWatch(() => result.value, (data) => {
+  if (data) store.set(key, data)
+}, { immediate: true })
 ```
 
-On the next pass the plugin's cache is carried forward, the child's data
-hydrates the store synchronously at setup, the sibling sees it, and no further
-pass is requested — bounded, with no duplicate work. (This is exactly how
-`vue-apollo-client`'s section-query composables and their consumers behave; a
-warm request cache makes each query settle synchronously on the resumed pass, so
-no operation runs twice.)
+`ssrWatch` automatically requests one more render pass when it fires from the
+awaited prefetch (after a sibling already rendered). On the resumed pass the
+data is warm in the API client's request cache — `vue-apollo-client` settles it
+synchronously at setup — so the same `ssrWatch` runs on its immediate tick, the
+sibling sees the store, and no further pass is requested. Bounded, and each
+operation runs exactly once. Nothing app-specific, and nothing to repeat per
+component or per project.
 
 ## SSR-safe reactivity
 

package/dist/SsrReactivityRuntime.d.ts

@@ -39,6 +39,12 @@ export type SsrWatchOptions<Immediate extends boolean = boolean> = Omit<WatchOpt
  * Identical semantics to Vue's `watch` otherwise: pass `{ immediate: true }` to
  * run once on setup, and use the returned handle to stop it. Because the flush
  * is synchronous, avoid mutating the watched source from inside the callback.
+ *
+ * When the callback runs on the server AFTER creation (a dependency settled
+ * during the render, e.g. an awaited query result), it automatically requests
+ * one more render pass through the resolution contract so consumers that read
+ * the mutated state elsewhere reflect it. Applications write no SSR
+ * orchestration for this — it is a property of the primitive.
  */
 export declare function ssrWatch<T, Immediate extends boolean = false>(source: WatchSource<T>, callback: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: SsrWatchOptions<Immediate>): WatchStopHandle;
 export declare function ssrWatch<T extends readonly unknown[], Immediate extends boolean = false>(source: readonly [...T] | (() => T), callback: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: SsrWatchOptions<Immediate>): WatchStopHandle;
@@ -46,7 +52,8 @@ export declare function ssrWatch<T extends readonly unknown[], Immediate extends
  * `watchEffect`, pinned to `flush: 'sync'` so the effect is active during SSR.
  * The effect runs immediately and re-runs synchronously whenever a tracked
  * dependency changes — including changes that happen while the server render is
- * still in progress.
+ * still in progress. Post-creation server runs request one more render pass
+ * (see {@link ssrWatch}).
  */
 export declare const ssrWatchEffect: (effect: Parameters<typeof watchEffect>[0], options?: Omit<NonNullable<Parameters<typeof watchEffect>[1]>, "flush">) => WatchStopHandle;
 //# sourceMappingURL=SsrReactivityRuntime.d.ts.map

package/dist/SsrReactivityRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SsrReactivityRuntime.d.ts","sourceRoot":"","sources":["../src/SsrReactivityRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,KAAK,CAAA;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,OAAO,GAAG,OAAO,IAAI,IAAI,CACrE,YAAY,CAAC,SAAS,CAAC,EACvB,OAAO,CACR,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,SAAS,OAAO,GAAG,KAAK,EAC3D,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,SAAS,SAAS,IAAI,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,EACtE,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GACnC,eAAe,CAAA;AAClB,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,SAAS,SAAS,OAAO,GAAG,KAAK,EACtF,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EACnC,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,SAAS,SAAS,IAAI,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,EACtE,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GACnC,eAAe,CAAA;AASlB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,EACzC,UAAU,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KACtE,eAAqE,CAAA"}
+{"version":3,"file":"SsrReactivityRuntime.d.ts","sourceRoot":"","sources":["../src/SsrReactivityRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,KAAK,CAAA;AAwBZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,OAAO,GAAG,OAAO,IAAI,IAAI,CACrE,YAAY,CAAC,SAAS,CAAC,EACvB,OAAO,CACR,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,SAAS,OAAO,GAAG,KAAK,EAC3D,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,SAAS,SAAS,IAAI,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,EACtE,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GACnC,eAAe,CAAA;AAClB,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,SAAS,SAAS,OAAO,GAAG,KAAK,EACtF,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EACnC,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,SAAS,SAAS,IAAI,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,EACtE,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,GACnC,eAAe,CAAA;AAkBlB;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,EACzC,UAAU,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KACtE,eAaF,CAAA"}

package/dist/SsrRequestResolution.d.ts

@@ -45,7 +45,9 @@ export interface SsrRequestResolution {
     /**
      * Request one additional render pass even when no tracked promise is pending.
      * Use when work mutated shared state synchronously in a way the current tree
-     * did not observe. Honoured up to the configured pass bound.
+     * did not observe. Honoured up to the configured pass bound. The {@link
+     * ssrWatch} primitive calls this automatically, so applications rarely call it
+     * directly.
      */
     requestAdditionalPass(): void;
 }

package/dist/SsrRequestResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SsrRequestResolution.d.ts","sourceRoot":"","sources":["../src/SsrRequestResolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,KAAK,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACtC;;;;OAIG;IACH,qBAAqB,IAAI,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAE9B,YAAY,CAAC,oBAAoB,CAAC,CAAA;AAEvC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,QAAO,oBAAoB,GAAG,IACQ,CAAA;AAEnE,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,wEAAwE;IACxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;IACjC,wEAAwE;IACxE,uBAAuB,IAAI,OAAO,CAAA;IAClC;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,qEAAqE;IACrE,OAAO,IAAI,IAAI,CAAA;CAChB;AAYD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAQ,OAAuC,KAC9C,uBA4EF,CAAA"}
+{"version":3,"file":"SsrRequestResolution.d.ts","sourceRoot":"","sources":["../src/SsrRequestResolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,KAAK,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACtC;;;;;;OAMG;IACH,qBAAqB,IAAI,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAE9B,YAAY,CAAC,oBAAoB,CAAC,CAAA;AAEvC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,QAAO,oBAAoB,GAAG,IACQ,CAAA;AAEnE,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,wEAAwE;IACxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;IACjC,wEAAwE;IACxE,uBAAuB,IAAI,OAAO,CAAA;IAClC;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,qEAAqE;IACrE,OAAO,IAAI,IAAI,CAAA;CAChB;AAYD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAQ,OAAuC,KAC9C,uBA4EF,CAAA"}

package/dist/chunks/SsrReactivityRuntime-CB3IYMti.mjs

@@ -0,0 +1,28 @@
+import { watch as i, watchEffect as f, hasInjectionContext as p, inject as d } from "vue";
+import { S as h } from "./SsrApplicationRuntime-lMR_sMdk.mjs";
+const a = () => p() ? d(h, null) : null;
+function m(r, n, s) {
+  const t = a();
+  let e = !1;
+  const o = i(r, (...l) => {
+    const u = n(...l);
+    return e && t?.server && t.requestAdditionalPass(), u;
+  }, { ...s, flush: "sync" });
+  return e = !0, o;
+}
+const w = (r, n) => {
+  const s = a();
+  let t = !1;
+  const e = f(
+    ((c) => {
+      const o = r(c);
+      return t && s?.server && s.requestAdditionalPass(), o;
+    }),
+    { ...n, flush: "sync" }
+  );
+  return t = !0, e;
+};
+export {
+  w as a,
+  m as s
+};

package/dist/client.mjs

@@ -1,7 +1,7 @@
 import { c as i } from "./chunks/SsrApplicationRuntime-lMR_sMdk.mjs";
 import { S as E, u as v } from "./chunks/SsrApplicationRuntime-lMR_sMdk.mjs";
 import { g as d } from "./chunks/SsrSerialization-k-3aCFYt.mjs";
-import { s as g, a as R } from "./chunks/SsrReactivityRuntime-CUbPx7ew.mjs";
+import { s as g, a as R } from "./chunks/SsrReactivityRuntime-CB3IYMti.mjs";
 const u = (r, e, o, s) => ({
   requestId: `${o}-${Date.now().toString(36)}`,
   url: e,

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as o, b as S, S as n, c as i, d as c, e as l, f as R, u as f } from "./chunks/SsrApplicationRuntime-lMR_sMdk.mjs";
-import { s as d, a as E } from "./chunks/SsrReactivityRuntime-CUbPx7ew.mjs";
+import { s as d, a as E } from "./chunks/SsrReactivityRuntime-CB3IYMti.mjs";
 import { e as m, g as u, r as x, s as _, a as C } from "./chunks/SsrSerialization-k-3aCFYt.mjs";
 import { c as H } from "./chunks/SsrDiagnosticsRuntime-B5VbSgsA.mjs";
 const e = (s) => s, r = (s) => s;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue-ssr-lite",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Vue 3 SSR runtime with routing, generic plugin hydration, Vite, and Node server lifecycle.",
   "license": "MIT",
   "type": "module",

package/dist/chunks/SsrReactivityRuntime-CUbPx7ew.mjs

@@ -1,9 +0,0 @@
-import { watch as f, watchEffect as a } from "vue";
-function h(s, t, c) {
-  return f(s, t, { ...c, flush: "sync" });
-}
-const n = (s, t) => a(s, { ...t, flush: "sync" });
-export {
-  n as a,
-  h as s
-};