@nifrajs/web-svelte 2.11.0 → 2.12.0

package/dist/client.d.ts

@@ -1,7 +1,15 @@
 import type { MountRouterOptions, RenderProps } from "@nifrajs/web";
 export { errorBoundary } from "./error.js";
 /** Hydrate a server-rendered Svelte layout `chain` (with the loader `props`) inside `container`. */
-export declare function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown): void;
+export interface HydrationAssuranceOptions {
+    readonly onWarning?: (message: string) => void;
+}
+export declare function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown, options?: HydrationAssuranceOptions): void;
+/** Testing hook used by verification runners to observe Svelte warnings and identity. */
+export declare const hydrationAssuranceHook: Readonly<{
+    framework: "svelte";
+    runtimeIdentity: () => object;
+}>;
 /**
  * Hydrate a stateful Svelte Router. The `Router` component holds the store snapshot in `$state` and
  * re-renders the matched layout chain on each store change - so client navigations swap routes without

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAenE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAK/F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAI7D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAenE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,oGAAoG;AACpG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/C;AAWD,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,yBAAyB,GAClC,IAAI,CAYN;AAED,yFAAyF;AACzF,eAAO,MAAM,sBAAsB;;2BAEZ,MAAM;EAC3B,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAc7D"}

package/dist/client.js

@@ -12,13 +12,34 @@ import Router from "./Router.svelte";
 // The `_error` boundary marker - Chain.svelte renders it as a <svelte:boundary>. Re-exported here so
 // nifra's client codegen resolves it from `@nifrajs/web-svelte/client` alongside `mountRouter`.
 export { errorBoundary } from "./error.js";
-/** Hydrate a server-rendered Svelte layout `chain` (with the loader `props`) inside `container`. */
-export function hydrate(chain, props, container) {
-    svelteHydrate(Chain, {
-        target: container,
-        props: { chain, props, layoutData: props.layoutData },
-    });
+function assuranceWarning() {
+    const value = globalThis[Symbol.for("nifra.hydration.assurance")];
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const callback = value.onWarning;
+    return typeof callback === "function" ? callback : undefined;
 }
+export function hydrate(chain, props, container, options) {
+    const warning = options?.onWarning ?? assuranceWarning();
+    const originalWarn = console.warn;
+    if (warning !== undefined)
+        console.warn = (...args) => warning(args.map(String).join(" "));
+    try {
+        svelteHydrate(Chain, {
+            target: container,
+            props: { chain, props, layoutData: props.layoutData },
+        });
+    }
+    finally {
+        if (warning !== undefined)
+            console.warn = originalWarn;
+    }
+}
+/** Testing hook used by verification runners to observe Svelte warnings and identity. */
+export const hydrationAssuranceHook = Object.freeze({
+    framework: "svelte",
+    runtimeIdentity: () => svelteHydrate,
+});
 /**
  * Hydrate a stateful Svelte Router. The `Router` component holds the store snapshot in `$state` and
  * re-renders the matched layout chain on each store change - so client navigations swap routes without
@@ -28,6 +49,19 @@ export function hydrate(chain, props, container) {
 export function mountRouter(options) {
     const { router, routes, searchSchemas, container } = options;
     setMountedRouter(router); // expose it to useFetcher/useFetchers (same page, client-only)
-    svelteHydrate(Router, { target: container, props: { router, routes, searchSchemas } });
+    const warning = assuranceWarning();
+    const originalWarn = console.warn;
+    if (warning !== undefined)
+        console.warn = (...args) => warning(args.map(String).join(" "));
+    try {
+        svelteHydrate(Router, {
+            target: container,
+            props: { router, routes, searchSchemas },
+        });
+    }
+    finally {
+        if (warning !== undefined)
+            console.warn = originalWarn;
+    }
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,MAAM,gBAAgB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,MAAM,MAAM,iBAAiB,CAAA;AAEpC,qGAAqG;AACrG,gGAAgG;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,oGAAoG;AACpG,MAAM,UAAU,OAAO,CAAC,KAAyB,EAAE,KAAkB,EAAE,SAAkB;IACvF,aAAa,CAAC,KAAK,EAAE;QACnB,MAAM,EAAE,SAAoB;QAC5B,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;KACtD,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAC5D,gBAAgB,CAAC,MAAM,CAAC,CAAA,CAAC,+DAA+D;IACxF,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnG,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,MAAM,gBAAgB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,MAAM,MAAM,iBAAiB,CAAA;AAEpC,qGAAqG;AACrG,gGAAgG;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO1C,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAI,UAAsD,CACnE,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,QAAQ,GAAI,KAAiC,CAAC,SAAS,CAAA;IAC7D,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,QAAsC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7F,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,KAAyB,EACzB,KAAkB,EAClB,SAAkB,EAClB,OAAmC;IAEnC,MAAM,OAAO,GAAG,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,CAAA;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1F,IAAI,CAAC;QACH,aAAa,CAAC,KAAK,EAAE;YACnB,MAAM,EAAE,SAAoB;YAC5B,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;SACtD,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;IACxD,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,QAAiB;IAC5B,eAAe,EAAE,GAAW,EAAE,CAAC,aAAa;CAC7C,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAC5D,gBAAgB,CAAC,MAAM,CAAC,CAAA,CAAC,+DAA+D;IACxF,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAA;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1F,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,EAAE;YACpB,MAAM,EAAE,SAAoB;YAC5B,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE;SACzC,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;IACxD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@nifrajs/web-svelte",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Svelte 5 render adapter for @nifrajs/web - SSR + hydration + the .svelte compiler Bun-plugin.",
   "keywords": [
     "bun",
     "typescript",
     "nifra",
-    "web-framework",
-    "full-stack",
-    "edge",
-    "ssr"
+    "svelte",
+    "svelte5",
+    "ssr",
+    "hydration",
+    "render-adapter",
+    "full-stack"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -98,10 +100,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@nifrajs/core": "2.11.0",
-    "@nifrajs/i18n": "2.11.0",
-    "@nifrajs/image": "2.11.0",
-    "@nifrajs/web": "2.11.0"
+    "@nifrajs/core": "2.12.0",
+    "@nifrajs/i18n": "2.12.0",
+    "@nifrajs/image": "2.12.0",
+    "@nifrajs/web": "2.12.0"
   },
   "peerDependencies": {
     "mdsvex": "^0.12",

package/src/client.ts

@@ -16,13 +16,44 @@ import Router from "./Router.svelte"
 export { errorBoundary } from "./error.ts"
 
 /** Hydrate a server-rendered Svelte layout `chain` (with the loader `props`) inside `container`. */
-export function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown): void {
-  svelteHydrate(Chain, {
-    target: container as Element,
-    props: { chain, props, layoutData: props.layoutData },
-  })
+export interface HydrationAssuranceOptions {
+  readonly onWarning?: (message: string) => void
 }
 
+function assuranceWarning(): ((message: string) => void) | undefined {
+  const value = (globalThis as unknown as Record<PropertyKey, unknown>)[
+    Symbol.for("nifra.hydration.assurance")
+  ]
+  if (typeof value !== "object" || value === null) return undefined
+  const callback = (value as { onWarning?: unknown }).onWarning
+  return typeof callback === "function" ? (callback as (message: string) => void) : undefined
+}
+
+export function hydrate(
+  chain: readonly unknown[],
+  props: RenderProps,
+  container: unknown,
+  options?: HydrationAssuranceOptions,
+): void {
+  const warning = options?.onWarning ?? assuranceWarning()
+  const originalWarn = console.warn
+  if (warning !== undefined) console.warn = (...args) => warning(args.map(String).join(" "))
+  try {
+    svelteHydrate(Chain, {
+      target: container as Element,
+      props: { chain, props, layoutData: props.layoutData },
+    })
+  } finally {
+    if (warning !== undefined) console.warn = originalWarn
+  }
+}
+
+/** Testing hook used by verification runners to observe Svelte warnings and identity. */
+export const hydrationAssuranceHook = Object.freeze({
+  framework: "svelte" as const,
+  runtimeIdentity: (): object => svelteHydrate,
+})
+
 /**
  * Hydrate a stateful Svelte Router. The `Router` component holds the store snapshot in `$state` and
  * re-renders the matched layout chain on each store change - so client navigations swap routes without
@@ -32,5 +63,15 @@ export function hydrate(chain: readonly unknown[], props: RenderProps, container
 export function mountRouter(options: MountRouterOptions): void {
   const { router, routes, searchSchemas, container } = options
   setMountedRouter(router) // expose it to useFetcher/useFetchers (same page, client-only)
-  svelteHydrate(Router, { target: container as Element, props: { router, routes, searchSchemas } })
+  const warning = assuranceWarning()
+  const originalWarn = console.warn
+  if (warning !== undefined) console.warn = (...args) => warning(args.map(String).join(" "))
+  try {
+    svelteHydrate(Router, {
+      target: container as Element,
+      props: { router, routes, searchSchemas },
+    })
+  } finally {
+    if (warning !== undefined) console.warn = originalWarn
+  }
 }