@nifrajs/web-svelte 3.5.0 → 4.0.2

package/dist/Chain.svelte

@@ -11,13 +11,18 @@
   layout, so the array is already empty by then, and leaving it alone keeps that true if it ever moves.
 -->
 <script>
-  import { setContext } from "svelte"
+  import { hasContext, setContext } from "svelte"
   import Self from "./Chain.svelte"
   let { chain, props, layoutData } = $props()
   // Provide the validated search as a getter (so `useSearch` reads the current value reactively) - the
   // same value the server put in RenderProps.search, so a query-reading page hydrates with no drift. The
   // key string is kept in sync with router.ts's `useSearch`.
   setContext("@nifrajs/web-svelte:search", () => props.search ?? {})
+  // The props `useMatches` reads, provided once by the outermost Chain, where `layoutData` is still
+  // whole (each nested Chain holds only its own tail). The key string is kept in sync with router.ts.
+  if (!hasContext("@nifrajs/web-svelte:props")) {
+    setContext("@nifrajs/web-svelte:props", () => ({ ...props, layoutData }))
+  }
 </script>
 
 {#if chain.length <= 1}

package/dist/I18nProvider.svelte

@@ -1,5 +1,6 @@
 <!--
-  I18nProvider.svelte - provides a nifra i18n `Formatter` (built from `locale` + `messages`) to the
+  I18nProvider.svelte - provides a nifra i18n `Formatter` (built from `locale` + `messages`, with the
+  optional `fallback`, `onMissing`, `timeZone` and `numberingSystem` of `createFormatter`) to the
   subtree via Svelte context; consumers read it with `useT()` from `@nifrajs/web-svelte/i18n`. The
   formatter is `$derived`, so switching locale rebuilds it. `locale` + `messages` are serializable, so
   SSR renders the negotiated catalog and the client rebuilds the same formatter on hydrate (no
@@ -10,9 +11,11 @@
   import { createFormatter } from "@nifrajs/i18n"
   import { setContext } from "svelte"
 
-  let { locale, messages, children } = $props()
+  let { locale, messages, fallback, onMissing, timeZone, numberingSystem, children } = $props()
 
-  const formatter = $derived(createFormatter(locale, messages))
+  const formatter = $derived(
+    createFormatter(locale, messages, { fallback, onMissing, timeZone, numberingSystem }),
+  )
   // A getter (not the value) so consumers read the current `$derived` formatter reactively.
   setContext("@nifrajs/web-svelte:i18n", () => formatter)
 </script>

package/dist/I18nProvider.svelte.d.ts

@@ -1,12 +1,12 @@
-import type { Messages } from "@nifrajs/i18n"
+import type { FormatterOptions, Translation } from "@nifrajs/i18n"
 import type { Component, Snippet } from "svelte"
 
 /** Hand-written types for `I18nProvider.svelte` (consumers resolve these via the `./i18n` re-export). */
-export interface I18nProviderProps {
+export interface I18nProviderProps extends FormatterOptions {
   /** The active locale (e.g. `"en"`, `"fr-CA"`). */
   locale: string
-  /** The ICU message catalog for `locale`. */
-  messages: Messages
+  /** The catalog for `locale`, checked against the registered catalog type when one is declared. */
+  messages: Translation
   /** The subtree that reads the formatter via `useT()`. */
   children?: Snippet
 }

package/dist/Rich.svelte

@@ -0,0 +1,32 @@
+<!--
+  Rich.svelte - renders the catalog message at `key` with its tags (`<b>…</b>`, `<br/>`) drawn by the
+  snippets in `tags`, from the formatter `<I18nProvider>` provides. No HTML and no `{@html}`: each
+  snippet receives its tag's content as a snippet (`{#snippet b(content)}<strong>{@render
+  content()}</strong>{/snippet}`), a tag with no snippet renders its content as text, `<br/>` is a
+  `<br>` unless `tags.br` is given, and interpolated `vars` are always text. Plain-JS script; the
+  context key is the string i18n.ts's `useT` reads.
+-->
+<script>
+  import { rich } from "@nifrajs/i18n/rich"
+  import { getContext } from "svelte"
+
+  let { key, tags = {}, vars } = $props()
+
+  const formatter = getContext("@nifrajs/web-svelte:i18n")
+  if (formatter === undefined) {
+    throw new Error("[nifra/web-svelte] <Rich> must be used within an <I18nProvider>")
+  }
+
+  // Each tag becomes a plain `{ tag, chunks }` record; the template below draws it with the caller's
+  // snippet. Null prototype, own names only, so `<constructor>` is never a handler.
+  const parts = $derived.by(() => {
+    const handlers = Object.create(null)
+    handlers.br = (chunks) => ({ tag: "br", chunks })
+    for (const name of Object.keys(tags)) {
+      if (typeof tags[name] === "function") handlers[name] = (chunks) => ({ tag: name, chunks })
+    }
+    return rich(formatter(), key, handlers, vars)
+  })
+</script>
+
+{#snippet draw(chunks)}{#each chunks as chunk}{#if typeof chunk === "string"}{chunk}{:else}{#snippet content()}{@render draw(chunk.chunks)}{/snippet}{#if Object.hasOwn(tags, chunk.tag) && typeof tags[chunk.tag] === "function"}{@render tags[chunk.tag](content)}{:else}<br />{@render content()}{/if}{/if}{/each}{/snippet}{@render draw(parts)}

package/dist/Rich.svelte.d.ts

@@ -0,0 +1,15 @@
+import type { MessageKey, RegisteredMessages } from "@nifrajs/i18n"
+import type { Component, Snippet } from "svelte"
+
+/** Hand-written types for `Rich.svelte` (consumers resolve these via the `./i18n` re-export). */
+export interface RichProps {
+  /** The catalog key, checked against the registered catalog type when one is declared. */
+  key: MessageKey<RegisteredMessages>
+  /** Snippets by tag name; each receives its tag's content as a snippet to render. */
+  tags?: Readonly<Record<string, Snippet<[Snippet]>>>
+  /** Values for the message's placeholders - always rendered as text. */
+  vars?: Readonly<Record<string, unknown>>
+}
+
+declare const Rich: Component<RichProps>
+export default Rich

package/dist/Router.svelte

@@ -15,7 +15,7 @@
   // browser-safe half, and it is where every other adapter takes this from.
   import { searchOfChain } from "@nifrajs/web/client"
   import Chain from "./Chain.svelte"
-  let { router, routes, searchSchemas } = $props()
+  let { router, routes, searchSchemas, matchChains } = $props()
 
   // Capturing the INITIAL `router` is the intent, not an oversight: one router instance is created
   // once per page and mounted here, so it never changes identity for this component's lifetime, and
@@ -35,11 +35,18 @@
       data: snapshot.data,
       actionData: snapshot.actionData,
       pending: snapshot.pending,
+      // The same `params`/`path` the server render received, so `useMatches` reports the same chain.
+      params: snapshot.params,
+      path: snapshot.path,
       search: searchOfChain(searchSchemas?.[snapshot.routeId] ?? [], q === -1 ? "" : snapshot.path.slice(q)),
       ...(snapshot.submission ? { submission: snapshot.submission } : {}),
       ...(snapshot.boundaries !== undefined ? { boundaries: snapshot.boundaries } : {}),
+      // The chain `useMatches` reports - the server passed the same one to the SSR render.
+      ...(matchChains?.[snapshot.routeId] !== undefined ? { matchChain: matchChains[snapshot.routeId] } : {}),
     }
   })
 </script>
 
-<Chain {chain} {props} />
+<!-- Each layout's own loader data, from the same snapshot. Without it a layout renders `data: null` on
+     the client while the server rendered it with its data. -->
+<Chain {chain} {props} layoutData={snapshot.layoutData} />

package/dist/client.js

@@ -47,7 +47,7 @@ export const hydrationAssuranceHook = Object.freeze({
  * matched route), so hydration reconciles cleanly.
  */
 export function mountRouter(options) {
-    const { router, routes, searchSchemas, container } = options;
+    const { router, routes, searchSchemas, matchChains, container } = options;
     setMountedRouter(router); // expose it to useFetcher/useFetchers (same page, client-only)
     const warning = assuranceWarning();
     const originalWarn = console.warn;
@@ -56,7 +56,7 @@ export function mountRouter(options) {
     try {
         svelteHydrate(Router, {
             target: container,
-            props: { router, routes, searchSchemas },
+            props: { router, routes, searchSchemas, matchChains },
         });
     }
     finally {

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;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"}
+{"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,WAAW,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IACzE,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,WAAW,EAAE;SACtD,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;IACxD,CAAC;AACH,CAAC"}

package/dist/i18n.d.ts

@@ -1,11 +1,14 @@
 /**
  * `@nifrajs/web-svelte/i18n` - Svelte bindings for `@nifrajs/i18n`: the `<I18nProvider>` component (re-exported
  * from `I18nProvider.svelte`) plus `useT()`, which reads the provided `Formatter` from Svelte context.
- * Call `useT()` during a component's initialization (like any `getContext`).
+ * Call `useT()` during a component's initialization (like any `getContext`). `<Rich>` renders a
+ * message's tags with snippets; `rich()` returns the same message as a parts array.
  */
 import type { Formatter } from "@nifrajs/i18n";
+export { type RichChunks, type RichTags, rich } from "@nifrajs/i18n/rich";
 export { default as I18nProvider, type I18nProviderProps } from "./I18nProvider.svelte";
-/** Read the current {@link Formatter} (`{ locale, t, n, d }`). Throws if no `<I18nProvider>` is above.
+export { default as Rich, type RichProps } from "./Rich.svelte";
+/** Read the current {@link Formatter} (`{ locale, t, get, n, d }`). Throws if no `<I18nProvider>` is above.
  * nifra switches locale by re-navigating, which re-runs the consuming component with the new catalog. */
 export declare function useT(): Formatter;
 //# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAMvF;yGACyG;AACzG,wBAAgB,IAAI,IAAI,SAAS,CAMhC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACvF,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAM/D;yGACyG;AACzG,wBAAgB,IAAI,IAAI,SAAS,CAMhC"}

package/dist/i18n.js

@@ -1,9 +1,11 @@
 import { getContext } from "svelte";
+export { rich } from "@nifrajs/i18n/rich";
 export { default as I18nProvider } from "./I18nProvider.svelte";
+export { default as Rich } from "./Rich.svelte";
 // Must match the string key `I18nProvider.svelte` passes to `setContext` (a string avoids a
 // `.svelte` → `.ts` import that wouldn't resolve once the .svelte is copied to dist).
 const I18N_KEY = "@nifrajs/web-svelte:i18n";
-/** Read the current {@link Formatter} (`{ locale, t, n, d }`). Throws if no `<I18nProvider>` is above.
+/** Read the current {@link Formatter} (`{ locale, t, get, n, d }`). Throws if no `<I18nProvider>` is above.
  * nifra switches locale by re-navigating, which re-runs the consuming component with the new catalog. */
 export function useT() {
     const get = getContext(I18N_KEY);

package/dist/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC,OAAO,EAAE,OAAO,IAAI,YAAY,EAA0B,MAAM,uBAAuB,CAAA;AAEvF,4FAA4F;AAC5F,sFAAsF;AACtF,MAAM,QAAQ,GAAG,0BAA0B,CAAA;AAE3C;yGACyG;AACzG,MAAM,UAAU,IAAI;IAClB,MAAM,GAAG,GAAG,UAAU,CAAgC,QAAQ,CAAC,CAAA;IAC/D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,GAAG,EAAE,CAAA;AACd,CAAC"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC,OAAO,EAAkC,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EAAE,OAAO,IAAI,YAAY,EAA0B,MAAM,uBAAuB,CAAA;AACvF,OAAO,EAAE,OAAO,IAAI,IAAI,EAAkB,MAAM,eAAe,CAAA;AAE/D,4FAA4F;AAC5F,sFAAsF;AACtF,MAAM,QAAQ,GAAG,0BAA0B,CAAA;AAE3C;yGACyG;AACzG,MAAM,UAAU,IAAI;IAClB,MAAM,GAAG,GAAG,UAAU,CAAgC,QAAQ,CAAC,CAAA;IAC/D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,GAAG,EAAE,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,12 @@
+/**
+ * @nifrajs/web-svelte - the Svelte 5 render adapter for @nifrajs/web (server side). SSR via Svelte's
+ * `render` (svelte/server), which returns HTML strings (Svelte SSR is string-based, not a stream),
+ * wrapped in a one-chunk Web `ReadableStream` (the seam's shape). The layout-chain fold is the recursive
+ * `Chain.svelte`. Client hydration lives in `@nifrajs/web-svelte/client`. Svelte components compile from
+ * `.svelte` files, so this adapter ships a build plugin at `@nifrajs/web-svelte/plugin` (like
+ * `@nifrajs/web-solid/plugin`) - there is no callable-component runtime.
+ */
 import type { RenderAdapter } from "@nifrajs/web";
-export { svelteBunPlugin } from "./plugin.js";
 /** The Svelte server render adapter - pass to @nifrajs/web's `renderPage`. */
 export declare const svelteAdapter: RenderAdapter;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,cAAc,CAAA;AAM9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAgF7C,8EAA8E;AAC9E,eAAO,MAAM,aAAa,EAAE,aA8B3B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,cAAc,CAAA;AAqF9D,8EAA8E;AAC9E,eAAO,MAAM,aAAa,EAAE,aA8B3B,CAAA"}

package/dist/index.js

@@ -1,16 +1,5 @@
-/**
- * @nifrajs/web-svelte - the Svelte 5 render adapter for @nifrajs/web (server side) + the `.svelte` compiler
- * Bun-plugin. SSR via Svelte's `render` (svelte/server), which returns HTML strings (Svelte SSR is
- * string-based, not a stream), wrapped in a one-chunk Web `ReadableStream` (the seam's shape). The
- * layout-chain fold is the recursive `Chain.svelte`. Client hydration lives in `@nifrajs/web-svelte/client`.
- * Svelte components compile from `.svelte` files, so this adapter ships a build plugin (like
- * `@nifrajs/web-solid`'s Babel plugin) - there is no callable-component runtime.
- */
-import { fileURLToPath } from "node:url";
 import { ssrModuleLoader } from "@nifrajs/web";
 import { render as runtimeRender } from "svelte/server";
-// Re-export the compiler plugin for convenience.
-export { svelteBunPlugin } from "./plugin.js";
 let chainComponent;
 let chainPromise;
 /**
@@ -32,7 +21,9 @@ const loadChain = () => {
     const load = ssrModuleLoader();
     chainPromise ??= (load !== undefined
         ? Promise.all([
-            load(fileURLToPath(new URL("./Chain.svelte", import.meta.url))),
+            // `import.meta.dirname`, not `node:url`: edge bundles resolve that to a browser polyfill with
+            // no `fileURLToPath`, and this module is in every Svelte server bundle.
+            load(`${import.meta.dirname}/Chain.svelte`),
             load("svelte/server"),
         ]).then(([mod, server]) => {
             render = server.render;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAsBpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAEtF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CA8DlE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAsBpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAEtF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CA4ElE"}

package/dist/plugin.js

@@ -1,4 +1,4 @@
-import { devHotComponent, devServerCompile, normalizeFilePath, portablePath, rewriteSsrImports, } from "@nifrajs/web/plugins/kit";
+import { devHotComponent, devServerCompile, normalizeFilePath, portablePath, rewriteSsrImports, withDevSourceMap, } from "@nifrajs/web/plugins/kit";
 import { compile } from "svelte/compiler";
 /**
  * `@nifrajs/web-svelte/plugin` - the `.svelte` compiler Bun-plugin, in its OWN module (no `.svelte`
@@ -81,15 +81,19 @@ export function svelteBunPlugin(generate) {
                     dev,
                     hmr: dev && generate === "dom" && devHotComponent(path),
                 });
+                const map = { ...js.map, version: 3 };
                 if (generate === "dom" && css?.code) {
                     cssByPath.set(portablePath(path), css.code);
                     // Import the virtual style module so the bundler pulls the scoped CSS into the app stylesheet.
                     return {
-                        contents: `${js.code}\nimport ${JSON.stringify(portablePath(path) + STYLE_SUFFIX)}\n`,
+                        contents: withDevSourceMap(`${js.code}\nimport ${JSON.stringify(portablePath(path) + STYLE_SUFFIX)}\n`, map, path, generate),
                         loader: "js",
                     };
                 }
-                return { contents: rewriteSsrImports(js.code, path, generate), loader: "js" };
+                return {
+                    contents: withDevSourceMap(rewriteSsrImports(js.code, path, generate), map, path, generate),
+                    loader: "js",
+                };
             });
             // Virtual CSS module: `<file>.svelte?svelte-css` → the compiled scoped stylesheet (css loader).
             build.onResolve({ filter: /\?svelte-css$/ }, (args) => ({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,YAAY,GAAG,aAAa,CAAA;AAClC,MAAM,QAAQ,GAAG,kBAAkB,CAAA;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,QAAQ,EAAwB;IAClE,OAAO,EAAE,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAuB;IACrD,uGAAuG;IACvG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC3C,OAAO;QACL,IAAI,EAAE,gBAAgB,QAAQ,EAAE;QAChC,KAAK,CAAC,KAAK;YACT,6FAA6F;YAC7F,qDAAqD;YACrD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACzC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC1C,4FAA4F;gBAC5F,iDAAiD;gBACjD,EAAE;gBACF,gGAAgG;gBAChG,gGAAgG;gBAChG,+FAA+F;gBAC/F,mFAAmF;gBACnF,EAAE;gBACF,gGAAgG;gBAChG,+FAA+F;gBAC/F,gGAAgG;gBAChG,+FAA+F;gBAC/F,0EAA0E;gBAC1E,EAAE;gBACF,0FAA0F;gBAC1F,8FAA8F;gBAC9F,2FAA2F;gBAC3F,0FAA0F;gBAC1F,8FAA8F;gBAC9F,wFAAwF;gBACxF,8FAA8F;gBAC9F,gDAAgD;gBAChD,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAA;gBAC9B,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE;oBAClC,QAAQ,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAClD,QAAQ,EAAE,IAAI;oBACd,GAAG,EAAE,UAAU,EAAE,mEAAmE;oBACpF,GAAG;oBACH,GAAG,EAAE,GAAG,IAAI,QAAQ,KAAK,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC;iBACxD,CAAC,CAAA;gBACF,IAAI,QAAQ,KAAK,KAAK,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;oBACpC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;oBAC3C,+FAA+F;oBAC/F,OAAO;wBACL,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI;wBACrF,MAAM,EAAE,IAAI;qBACb,CAAA;gBACH,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YAC/E,CAAC,CAAC,CAAA;YACF,gGAAgG;YAChG,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC,CAAA;YACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7D,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE;gBACrF,MAAM,EAAE,KAAK;aACd,CAAC,CAAC,CAAA;QACL,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/router.d.ts

@@ -1,5 +1,5 @@
 import type { InferOutput, StandardSchemaV1 } from "@nifrajs/core/server";
-import type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@nifrajs/web";
+import type { Blocker, BlockerFunction, BlockerState, NavigateFunction, UIMatch } from "@nifrajs/web";
 /**
  * `@nifrajs/web-svelte/router` - Svelte routing bindings over the agnostic `@nifrajs/web` history layer,
  * as plain `.ts` (no runes/compiler needed): `useNavigate` (programmatic navigation), `useBlocker` (the
@@ -9,7 +9,7 @@ import type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@
  * context on SSR + client alike. Idle before hydration (native `<a>` navigation still works). SSR-safe.
  */
 import { type Readable } from "svelte/store";
-export type { Blocker, BlockerFunction, BlockerState, NavigateFunction };
+export type { Blocker, BlockerFunction, BlockerState, NavigateFunction, UIMatch };
 /**
  * The route's typed, validated search params as a reactive accessor - the SAME value the loader received
  * as `ctx.search`. SSR-correct: `Chain.svelte` provides it from the URL server-side and from the
@@ -25,6 +25,23 @@ export type { Blocker, BlockerFunction, BlockerState, NavigateFunction };
  * ```
  */
 export declare function useSearch<Schema extends StandardSchemaV1 | undefined = undefined>(): () => Schema extends StandardSchemaV1 ? InferOutput<Schema> : Record<string, unknown>;
+/**
+ * The rendered chain - each layout, then the page - with the URL prefix, params and loader data each
+ * one owns, plus its `handle` export, as an accessor. The same list on the server render and the client
+ * mount, so a layout can render breadcrumbs from its children's `handle`s without a hydration mismatch.
+ * Call it in a `$derived` or the template - it updates on navigation.
+ *
+ * ```svelte
+ * <script module>
+ *   export const handle = { crumb: "Settings" }
+ * </script>
+ * <script>
+ *   const matches = useMatches()
+ *   const crumbs = $derived(matches().flatMap((m) => m.handle?.crumb ?? []))
+ * </script>
+ * ```
+ */
+export declare function useMatches(): () => readonly UIMatch[];
 /** Get the {@link NavigateFunction} (a string path, a history delta, or a typed `{ to, search }` object).
  * Resolves the browser navigate at call time, so it works as soon as `installHistory` has run and no-ops
  * before then / on the server. */

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAIzE,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,YAAY,EACZ,gBAAgB,EAGjB,MAAM,cAAc,CAAA;AAUrB;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAA;AAEtD,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAQxE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,KACpD,MAAM,MAAM,SAAS,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzF;AAED;;kCAEkC;AAClC,wBAAgB,WAAW,IAAI,gBAAgB,CAO9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CAOpF"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAIzE,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,YAAY,EACZ,gBAAgB,EAIhB,OAAO,EACR,MAAM,cAAc,CAAA;AAYrB;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAA;AAEtD,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAA;AAQjF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,KACpD,MAAM,MAAM,SAAS,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzF;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,IAAI,MAAM,SAAS,OAAO,EAAE,CAGrD;AAED;;kCAEkC;AAClC,wBAAgB,WAAW,IAAI,gBAAgB,CAO9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CAOpF"}

package/dist/router.js

@@ -1,6 +1,8 @@
 // `/client`, not the root - these are DOM values, and the root's graph carries the
 // server, which Vite's dev server evaluates rather than tree-shakes.
 import { getBrowserNavigate, IDLE_BLOCKER, registerBlocker, resolveNavigate, } from "@nifrajs/web/client";
+// Its own subpath, so an app that never calls `useMatches` never bundles it.
+import { chainMatches } from "@nifrajs/web/internal/matches-runtime";
 import { getContext } from "svelte";
 /**
  * `@nifrajs/web-svelte/router` - Svelte routing bindings over the agnostic `@nifrajs/web` history layer,
@@ -34,6 +36,30 @@ export function useSearch() {
     const get = getContext(SEARCH_KEY);
     return (get ?? EMPTY_SEARCH_ACCESSOR);
 }
+// Must match the string key the outermost `Chain.svelte` provides its props under.
+const PROPS_KEY = "@nifrajs/web-svelte:props";
+const NO_MATCHES = Object.freeze([]);
+const NO_MATCHES_ACCESSOR = () => NO_MATCHES;
+/**
+ * The rendered chain - each layout, then the page - with the URL prefix, params and loader data each
+ * one owns, plus its `handle` export, as an accessor. The same list on the server render and the client
+ * mount, so a layout can render breadcrumbs from its children's `handle`s without a hydration mismatch.
+ * Call it in a `$derived` or the template - it updates on navigation.
+ *
+ * ```svelte
+ * <script module>
+ *   export const handle = { crumb: "Settings" }
+ * </script>
+ * <script>
+ *   const matches = useMatches()
+ *   const crumbs = $derived(matches().flatMap((m) => m.handle?.crumb ?? []))
+ * </script>
+ * ```
+ */
+export function useMatches() {
+    const get = getContext(PROPS_KEY);
+    return get === undefined ? NO_MATCHES_ACCESSOR : () => chainMatches(get());
+}
 /** Get the {@link NavigateFunction} (a string path, a history delta, or a typed `{ to, search }` object).
  * Resolves the browser navigate at call time, so it works as soon as `installHistory` has run and no-ops
  * before then / on the server. */

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAYA,mFAAmF;AACnF,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC;;;;;;;GAOG;AACH,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAA;AAItD,uGAAuG;AACvG,oEAAoE;AACpE,MAAM,UAAU,GAAG,4BAA4B,CAAA;AAC/C,MAAM,YAAY,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACzE,MAAM,qBAAqB,GAAG,GAA4B,EAAE,CAAC,YAAY,CAAA;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS;IAGvB,MAAM,GAAG,GAAG,UAAU,CAA8C,UAAU,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,IAAI,qBAAqB,CAET,CAAA;AAC7B,CAAC;AAED;;kCAEkC;AAClC,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,CAAC,EAAyC,EAAE,OAAyB,EAAE,EAAE;QAC/E,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAM;QAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC,CAAqB,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,WAAsC;IAC/D,OAAO,QAAQ,CAAU,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAC7C,eAAe,CACb,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAC/E,GAAG,CACJ,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAcA,mFAAmF;AACnF,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,6EAA6E;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC;;;;;;;GAOG;AACH,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAA;AAItD,uGAAuG;AACvG,oEAAoE;AACpE,MAAM,UAAU,GAAG,4BAA4B,CAAA;AAC/C,MAAM,YAAY,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACzE,MAAM,qBAAqB,GAAG,GAA4B,EAAE,CAAC,YAAY,CAAA;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS;IAGvB,MAAM,GAAG,GAAG,UAAU,CAA8C,UAAU,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,IAAI,qBAAqB,CAET,CAAA;AAC7B,CAAC;AAED,mFAAmF;AACnF,MAAM,SAAS,GAAG,2BAA2B,CAAA;AAC7C,MAAM,UAAU,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACxD,MAAM,mBAAmB,GAAG,GAAuB,EAAE,CAAC,UAAU,CAAA;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,UAAU,CAAkC,SAAS,CAAC,CAAA;IAClE,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAA;AAC5E,CAAC;AAED;;kCAEkC;AAClC,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,CAAC,EAAyC,EAAE,OAAyB,EAAE,EAAE;QAC/E,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAM;QAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC,CAAqB,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,WAAsC;IAC/D,OAAO,QAAQ,CAAU,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAC7C,eAAe,CACb,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAC/E,GAAG,CACJ,CACF,CAAA;AACH,CAAC"}

package/dist/svg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAGpC,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;wBACwB;AACxB,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAe9E"}
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AASpC,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB/C;AAED;wBACwB;AACxB,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAe9E"}

package/dist/svg.js

@@ -9,11 +9,27 @@
  * a plain `import "./icon.svg"` (asset URL) is untouched - only `?component` matches.
  */
 import { normalizeFilePath } from "@nifrajs/web/plugins/kit";
-import { SVG_COMPONENT_FILTER, stripSvgPreamble } from "@nifrajs/web/plugins/svg";
+import { SVG_COMPONENT_FILTER, svgTemplateMarkup } from "@nifrajs/web/plugins/svg";
 import { compile } from "svelte/compiler";
+/** A brace as a character reference: in Svelte markup, text or an attribute value, it opens an expression. */
+const braces = (text) => text.replace(/[{}]/g, (char) => `&#${char.charCodeAt(0)};`);
+/** Names Svelte reads as directives or special elements, never as SVG. */
+const SVELTE_DIRECTIVE = /^(?:on|bind|use|class|style|transition|in|out|animate|let|attach):/;
 /** Wrap raw SVG XML in a Svelte 5 component: strip XML noise, spread props onto the root `<svg>`. */
 export function svgToSvelte(xml) {
-    const cleaned = stripSvgPreamble(xml);
+    const cleaned = svgTemplateMarkup(xml, {
+        text: (text, cdata) => braces(cdata ? text.replaceAll("&", "&amp;").replaceAll("<", "&lt;") : text),
+        attributeValue: braces,
+        // A nested <style> or <script> is raw text to Svelte, so its braces are not expressions.
+        rawText: new Set(["style", "script"]),
+        refuse: (name, kind) => kind === "attribute"
+            ? SVELTE_DIRECTIVE.test(name)
+                ? `the attribute ${name} is a Svelte directive`
+                : undefined
+            : name.startsWith("svelte:") || name.includes(".") || /^[A-Z]/.test(name)
+                ? `Svelte reads the element <${name}> as a component or special element`
+                : undefined,
+    });
     // `$props()` opts the component into runes (Svelte 5); spread onto the root so user attrs win.
     const withSpread = cleaned.replace(/^(<svg\b[^>]*?)>/, "$1 {...props}>");
     return `<script>const props = $props()</script>\n${withSpread}\n`;

package/dist/svg.js.map

@@ -1 +1 @@
-{"version":3,"file":"svg.js","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEjF,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IACrC,+FAA+F;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAA;IACxE,OAAO,4CAA4C,UAAU,IAAI,CAAA;AACnE,CAAC;AAED;wBACwB;AACxB,MAAM,UAAU,2BAA2B,CAAC,QAAuB;IACjE,OAAO;QACL,IAAI,EAAE,oBAAoB,QAAQ,EAAE;QACpC,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC5D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;gBACvC,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;oBACvC,QAAQ,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAClD,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAA;gBACF,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YAC5C,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC,8GAA8G;AAC9G,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAEpG,0EAA0E;AAC1E,MAAM,gBAAgB,GAAG,oEAAoE,CAAA;AAE7F,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE;QACrC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,cAAc,EAAE,MAAM;QACtB,yFAAyF;QACzF,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACrB,IAAI,KAAK,WAAW;YAClB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,CAAC,CAAC,iBAAiB,IAAI,wBAAwB;gBAC/C,CAAC,CAAC,SAAS;YACb,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBACvE,CAAC,CAAC,6BAA6B,IAAI,qCAAqC;gBACxE,CAAC,CAAC,SAAS;KAClB,CAAC,CAAA;IACF,+FAA+F;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAA;IACxE,OAAO,4CAA4C,UAAU,IAAI,CAAA;AACnE,CAAC;AAED;wBACwB;AACxB,MAAM,UAAU,2BAA2B,CAAC,QAAuB;IACjE,OAAO;QACL,IAAI,EAAE,oBAAoB,QAAQ,EAAE;QACpC,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC5D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;gBACvC,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;oBACvC,QAAQ,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAClD,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAA;gBACF,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YAC5C,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nifrajs/web-svelte",
-  "version": "3.5.0",
-  "description": "Svelte 5 render adapter for @nifrajs/web - SSR + hydration + the .svelte compiler Bun-plugin.",
+  "version": "4.0.2",
+  "description": "Svelte 5 render adapter for @nifrajs/web - SSR + hydration, with the .svelte compiler Bun plugin (@nifrajs/web-svelte/plugin).",
   "keywords": [
     "bun",
     "typescript",
@@ -14,6 +14,9 @@
     "full-stack"
   ],
   "type": "module",
+  "nifra": {
+    "environment": "library"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -100,10 +103,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@nifrajs/core": "3.5.0",
-    "@nifrajs/i18n": "3.5.0",
-    "@nifrajs/image": "3.5.0",
-    "@nifrajs/web": "3.5.0"
+    "@nifrajs/core": "4.0.2",
+    "@nifrajs/i18n": "4.0.2",
+    "@nifrajs/image": "4.0.2",
+    "@nifrajs/web": "4.0.2"
   },
   "peerDependencies": {
     "mdsvex": "^0.12",

package/src/Chain.svelte

@@ -11,13 +11,18 @@
   layout, so the array is already empty by then, and leaving it alone keeps that true if it ever moves.
 -->
 <script>
-  import { setContext } from "svelte"
+  import { hasContext, setContext } from "svelte"
   import Self from "./Chain.svelte"
   let { chain, props, layoutData } = $props()
   // Provide the validated search as a getter (so `useSearch` reads the current value reactively) - the
   // same value the server put in RenderProps.search, so a query-reading page hydrates with no drift. The
   // key string is kept in sync with router.ts's `useSearch`.
   setContext("@nifrajs/web-svelte:search", () => props.search ?? {})
+  // The props `useMatches` reads, provided once by the outermost Chain, where `layoutData` is still
+  // whole (each nested Chain holds only its own tail). The key string is kept in sync with router.ts.
+  if (!hasContext("@nifrajs/web-svelte:props")) {
+    setContext("@nifrajs/web-svelte:props", () => ({ ...props, layoutData }))
+  }
 </script>
 
 {#if chain.length <= 1}

package/src/I18nProvider.svelte

@@ -1,5 +1,6 @@
 <!--
-  I18nProvider.svelte - provides a nifra i18n `Formatter` (built from `locale` + `messages`) to the
+  I18nProvider.svelte - provides a nifra i18n `Formatter` (built from `locale` + `messages`, with the
+  optional `fallback`, `onMissing`, `timeZone` and `numberingSystem` of `createFormatter`) to the
   subtree via Svelte context; consumers read it with `useT()` from `@nifrajs/web-svelte/i18n`. The
   formatter is `$derived`, so switching locale rebuilds it. `locale` + `messages` are serializable, so
   SSR renders the negotiated catalog and the client rebuilds the same formatter on hydrate (no
@@ -10,9 +11,11 @@
   import { createFormatter } from "@nifrajs/i18n"
   import { setContext } from "svelte"
 
-  let { locale, messages, children } = $props()
+  let { locale, messages, fallback, onMissing, timeZone, numberingSystem, children } = $props()
 
-  const formatter = $derived(createFormatter(locale, messages))
+  const formatter = $derived(
+    createFormatter(locale, messages, { fallback, onMissing, timeZone, numberingSystem }),
+  )
   // A getter (not the value) so consumers read the current `$derived` formatter reactively.
   setContext("@nifrajs/web-svelte:i18n", () => formatter)
 </script>

package/src/I18nProvider.svelte.d.ts

@@ -1,12 +1,12 @@
-import type { Messages } from "@nifrajs/i18n"
+import type { FormatterOptions, Translation } from "@nifrajs/i18n"
 import type { Component, Snippet } from "svelte"
 
 /** Hand-written types for `I18nProvider.svelte` (consumers resolve these via the `./i18n` re-export). */
-export interface I18nProviderProps {
+export interface I18nProviderProps extends FormatterOptions {
   /** The active locale (e.g. `"en"`, `"fr-CA"`). */
   locale: string
-  /** The ICU message catalog for `locale`. */
-  messages: Messages
+  /** The catalog for `locale`, checked against the registered catalog type when one is declared. */
+  messages: Translation
   /** The subtree that reads the formatter via `useT()`. */
   children?: Snippet
 }

package/src/Rich.svelte

@@ -0,0 +1,32 @@
+<!--
+  Rich.svelte - renders the catalog message at `key` with its tags (`<b>…</b>`, `<br/>`) drawn by the
+  snippets in `tags`, from the formatter `<I18nProvider>` provides. No HTML and no `{@html}`: each
+  snippet receives its tag's content as a snippet (`{#snippet b(content)}<strong>{@render
+  content()}</strong>{/snippet}`), a tag with no snippet renders its content as text, `<br/>` is a
+  `<br>` unless `tags.br` is given, and interpolated `vars` are always text. Plain-JS script; the
+  context key is the string i18n.ts's `useT` reads.
+-->
+<script>
+  import { rich } from "@nifrajs/i18n/rich"
+  import { getContext } from "svelte"
+
+  let { key, tags = {}, vars } = $props()
+
+  const formatter = getContext("@nifrajs/web-svelte:i18n")
+  if (formatter === undefined) {
+    throw new Error("[nifra/web-svelte] <Rich> must be used within an <I18nProvider>")
+  }
+
+  // Each tag becomes a plain `{ tag, chunks }` record; the template below draws it with the caller's
+  // snippet. Null prototype, own names only, so `<constructor>` is never a handler.
+  const parts = $derived.by(() => {
+    const handlers = Object.create(null)
+    handlers.br = (chunks) => ({ tag: "br", chunks })
+    for (const name of Object.keys(tags)) {
+      if (typeof tags[name] === "function") handlers[name] = (chunks) => ({ tag: name, chunks })
+    }
+    return rich(formatter(), key, handlers, vars)
+  })
+</script>
+
+{#snippet draw(chunks)}{#each chunks as chunk}{#if typeof chunk === "string"}{chunk}{:else}{#snippet content()}{@render draw(chunk.chunks)}{/snippet}{#if Object.hasOwn(tags, chunk.tag) && typeof tags[chunk.tag] === "function"}{@render tags[chunk.tag](content)}{:else}<br />{@render content()}{/if}{/if}{/each}{/snippet}{@render draw(parts)}

package/src/Rich.svelte.d.ts

@@ -0,0 +1,15 @@
+import type { MessageKey, RegisteredMessages } from "@nifrajs/i18n"
+import type { Component, Snippet } from "svelte"
+
+/** Hand-written types for `Rich.svelte` (consumers resolve these via the `./i18n` re-export). */
+export interface RichProps {
+  /** The catalog key, checked against the registered catalog type when one is declared. */
+  key: MessageKey<RegisteredMessages>
+  /** Snippets by tag name; each receives its tag's content as a snippet to render. */
+  tags?: Readonly<Record<string, Snippet<[Snippet]>>>
+  /** Values for the message's placeholders - always rendered as text. */
+  vars?: Readonly<Record<string, unknown>>
+}
+
+declare const Rich: Component<RichProps>
+export default Rich

package/src/Router.svelte

@@ -15,7 +15,7 @@
   // browser-safe half, and it is where every other adapter takes this from.
   import { searchOfChain } from "@nifrajs/web/client"
   import Chain from "./Chain.svelte"
-  let { router, routes, searchSchemas } = $props()
+  let { router, routes, searchSchemas, matchChains } = $props()
 
   // Capturing the INITIAL `router` is the intent, not an oversight: one router instance is created
   // once per page and mounted here, so it never changes identity for this component's lifetime, and
@@ -35,11 +35,18 @@
       data: snapshot.data,
       actionData: snapshot.actionData,
       pending: snapshot.pending,
+      // The same `params`/`path` the server render received, so `useMatches` reports the same chain.
+      params: snapshot.params,
+      path: snapshot.path,
       search: searchOfChain(searchSchemas?.[snapshot.routeId] ?? [], q === -1 ? "" : snapshot.path.slice(q)),
       ...(snapshot.submission ? { submission: snapshot.submission } : {}),
       ...(snapshot.boundaries !== undefined ? { boundaries: snapshot.boundaries } : {}),
+      // The chain `useMatches` reports - the server passed the same one to the SSR render.
+      ...(matchChains?.[snapshot.routeId] !== undefined ? { matchChain: matchChains[snapshot.routeId] } : {}),
     }
   })
 </script>
 
-<Chain {chain} {props} />
+<!-- Each layout's own loader data, from the same snapshot. Without it a layout renders `data: null` on
+     the client while the server rendered it with its data. -->
+<Chain {chain} {props} layoutData={snapshot.layoutData} />

package/src/client.ts

@@ -61,7 +61,7 @@ export const hydrationAssuranceHook = Object.freeze({
  * matched route), so hydration reconciles cleanly.
  */
 export function mountRouter(options: MountRouterOptions): void {
-  const { router, routes, searchSchemas, container } = options
+  const { router, routes, searchSchemas, matchChains, container } = options
   setMountedRouter(router) // expose it to useFetcher/useFetchers (same page, client-only)
   const warning = assuranceWarning()
   const originalWarn = console.warn
@@ -69,7 +69,7 @@ export function mountRouter(options: MountRouterOptions): void {
   try {
     svelteHydrate(Router, {
       target: container as Element,
-      props: { router, routes, searchSchemas },
+      props: { router, routes, searchSchemas, matchChains },
     })
   } finally {
     if (warning !== undefined) console.warn = originalWarn

package/src/i18n.ts

@@ -1,18 +1,21 @@
 /**
  * `@nifrajs/web-svelte/i18n` - Svelte bindings for `@nifrajs/i18n`: the `<I18nProvider>` component (re-exported
  * from `I18nProvider.svelte`) plus `useT()`, which reads the provided `Formatter` from Svelte context.
- * Call `useT()` during a component's initialization (like any `getContext`).
+ * Call `useT()` during a component's initialization (like any `getContext`). `<Rich>` renders a
+ * message's tags with snippets; `rich()` returns the same message as a parts array.
  */
 import type { Formatter } from "@nifrajs/i18n"
 import { getContext } from "svelte"
 
+export { type RichChunks, type RichTags, rich } from "@nifrajs/i18n/rich"
 export { default as I18nProvider, type I18nProviderProps } from "./I18nProvider.svelte"
+export { default as Rich, type RichProps } from "./Rich.svelte"
 
 // Must match the string key `I18nProvider.svelte` passes to `setContext` (a string avoids a
 // `.svelte` → `.ts` import that wouldn't resolve once the .svelte is copied to dist).
 const I18N_KEY = "@nifrajs/web-svelte:i18n"
 
-/** Read the current {@link Formatter} (`{ locale, t, n, d }`). Throws if no `<I18nProvider>` is above.
+/** Read the current {@link Formatter} (`{ locale, t, get, n, d }`). Throws if no `<I18nProvider>` is above.
  * nifra switches locale by re-navigating, which re-runs the consuming component with the new catalog. */
 export function useT(): Formatter {
   const get = getContext<(() => Formatter) | undefined>(I18N_KEY)

package/src/index.ts

@@ -1,20 +1,16 @@
 /**
- * @nifrajs/web-svelte - the Svelte 5 render adapter for @nifrajs/web (server side) + the `.svelte` compiler
- * Bun-plugin. SSR via Svelte's `render` (svelte/server), which returns HTML strings (Svelte SSR is
- * string-based, not a stream), wrapped in a one-chunk Web `ReadableStream` (the seam's shape). The
- * layout-chain fold is the recursive `Chain.svelte`. Client hydration lives in `@nifrajs/web-svelte/client`.
- * Svelte components compile from `.svelte` files, so this adapter ships a build plugin (like
- * `@nifrajs/web-solid`'s Babel plugin) - there is no callable-component runtime.
+ * @nifrajs/web-svelte - the Svelte 5 render adapter for @nifrajs/web (server side). SSR via Svelte's
+ * `render` (svelte/server), which returns HTML strings (Svelte SSR is string-based, not a stream),
+ * wrapped in a one-chunk Web `ReadableStream` (the seam's shape). The layout-chain fold is the recursive
+ * `Chain.svelte`. Client hydration lives in `@nifrajs/web-svelte/client`. Svelte components compile from
+ * `.svelte` files, so this adapter ships a build plugin at `@nifrajs/web-svelte/plugin` (like
+ * `@nifrajs/web-solid/plugin`) - there is no callable-component runtime.
  */
-import { fileURLToPath } from "node:url"
 import type { RenderAdapter, RenderProps } from "@nifrajs/web"
 import { ssrModuleLoader } from "@nifrajs/web"
 import type { Component } from "svelte"
 import { render as runtimeRender } from "svelte/server"
 
-// Re-export the compiler plugin for convenience.
-export { svelteBunPlugin } from "./plugin.ts"
-
 /**
  * `Chain.svelte` is loaded on FIRST RENDER, not at module load.
  *
@@ -68,7 +64,9 @@ const loadChain = (): Component<ChainProps> | Promise<Component<ChainProps>> =>
   chainPromise ??= (
     load !== undefined
       ? Promise.all([
-          load(fileURLToPath(new URL("./Chain.svelte", import.meta.url))),
+          // `import.meta.dirname`, not `node:url`: edge bundles resolve that to a browser polyfill with
+          // no `fileURLToPath`, and this module is in every Svelte server bundle.
+          load(`${import.meta.dirname}/Chain.svelte`),
           load("svelte/server"),
         ]).then(([mod, server]) => {
           render = (server as { render: typeof runtimeRender }).render

package/src/plugin.ts

@@ -4,6 +4,7 @@ import {
   normalizeFilePath,
   portablePath,
   rewriteSsrImports,
+  withDevSourceMap,
 } from "@nifrajs/web/plugins/kit"
 import type { BunPlugin } from "bun"
 import { compile } from "svelte/compiler"
@@ -91,15 +92,29 @@ export function svelteBunPlugin(generate: "dom" | "ssr"): BunPlugin {
           dev,
           hmr: dev && generate === "dom" && devHotComponent(path),
         })
+        const map = { ...js.map, version: 3 }
         if (generate === "dom" && css?.code) {
           cssByPath.set(portablePath(path), css.code)
           // Import the virtual style module so the bundler pulls the scoped CSS into the app stylesheet.
           return {
-            contents: `${js.code}\nimport ${JSON.stringify(portablePath(path) + STYLE_SUFFIX)}\n`,
+            contents: withDevSourceMap(
+              `${js.code}\nimport ${JSON.stringify(portablePath(path) + STYLE_SUFFIX)}\n`,
+              map,
+              path,
+              generate,
+            ),
             loader: "js",
           }
         }
-        return { contents: rewriteSsrImports(js.code, path, generate), loader: "js" }
+        return {
+          contents: withDevSourceMap(
+            rewriteSsrImports(js.code, path, generate),
+            map,
+            path,
+            generate,
+          ),
+          loader: "js",
+        }
       })
       // Virtual CSS module: `<file>.svelte?svelte-css` → the compiled scoped stylesheet (css loader).
       build.onResolve({ filter: /\?svelte-css$/ }, (args) => ({

package/src/router.ts

@@ -9,6 +9,8 @@ import type {
   NavigateFunction,
   NavigateOptions,
   NavigateTargetInput,
+  RenderProps,
+  UIMatch,
 } from "@nifrajs/web"
 // `/client`, not the root - these are DOM values, and the root's graph carries the
 // server, which Vite's dev server evaluates rather than tree-shakes.
@@ -18,6 +20,8 @@ import {
   registerBlocker,
   resolveNavigate,
 } from "@nifrajs/web/client"
+// Its own subpath, so an app that never calls `useMatches` never bundles it.
+import { chainMatches } from "@nifrajs/web/internal/matches-runtime"
 import { getContext } from "svelte"
 /**
  * `@nifrajs/web-svelte/router` - Svelte routing bindings over the agnostic `@nifrajs/web` history layer,
@@ -29,7 +33,7 @@ import { getContext } from "svelte"
  */
 import { type Readable, readable } from "svelte/store"
 
-export type { Blocker, BlockerFunction, BlockerState, NavigateFunction }
+export type { Blocker, BlockerFunction, BlockerState, NavigateFunction, UIMatch }
 
 // Must match the string key `Chain.svelte` passes to `setContext` (a string avoids a `.svelte` → `.ts`
 // import that wouldn't resolve once the .svelte is copied to dist).
@@ -60,6 +64,32 @@ export function useSearch<
     : Record<string, unknown>
 }
 
+// Must match the string key the outermost `Chain.svelte` provides its props under.
+const PROPS_KEY = "@nifrajs/web-svelte:props"
+const NO_MATCHES: readonly UIMatch[] = Object.freeze([])
+const NO_MATCHES_ACCESSOR = (): readonly UIMatch[] => NO_MATCHES
+
+/**
+ * The rendered chain - each layout, then the page - with the URL prefix, params and loader data each
+ * one owns, plus its `handle` export, as an accessor. The same list on the server render and the client
+ * mount, so a layout can render breadcrumbs from its children's `handle`s without a hydration mismatch.
+ * Call it in a `$derived` or the template - it updates on navigation.
+ *
+ * ```svelte
+ * <script module>
+ *   export const handle = { crumb: "Settings" }
+ * </script>
+ * <script>
+ *   const matches = useMatches()
+ *   const crumbs = $derived(matches().flatMap((m) => m.handle?.crumb ?? []))
+ * </script>
+ * ```
+ */
+export function useMatches(): () => readonly UIMatch[] {
+  const get = getContext<(() => RenderProps) | undefined>(PROPS_KEY)
+  return get === undefined ? NO_MATCHES_ACCESSOR : () => chainMatches(get())
+}
+
 /** Get the {@link NavigateFunction} (a string path, a history delta, or a typed `{ to, search }` object).
  * Resolves the browser navigate at call time, so it works as soon as `installHistory` has run and no-ops
  * before then / on the server. */

package/src/svg.ts

@@ -10,13 +10,33 @@
  */
 
 import { normalizeFilePath } from "@nifrajs/web/plugins/kit"
-import { SVG_COMPONENT_FILTER, stripSvgPreamble } from "@nifrajs/web/plugins/svg"
+import { SVG_COMPONENT_FILTER, svgTemplateMarkup } from "@nifrajs/web/plugins/svg"
 import type { BunPlugin } from "bun"
 import { compile } from "svelte/compiler"
 
+/** A brace as a character reference: in Svelte markup, text or an attribute value, it opens an expression. */
+const braces = (text: string): string => text.replace(/[{}]/g, (char) => `&#${char.charCodeAt(0)};`)
+
+/** Names Svelte reads as directives or special elements, never as SVG. */
+const SVELTE_DIRECTIVE = /^(?:on|bind|use|class|style|transition|in|out|animate|let|attach):/
+
 /** Wrap raw SVG XML in a Svelte 5 component: strip XML noise, spread props onto the root `<svg>`. */
 export function svgToSvelte(xml: string): string {
-  const cleaned = stripSvgPreamble(xml)
+  const cleaned = svgTemplateMarkup(xml, {
+    text: (text, cdata) =>
+      braces(cdata ? text.replaceAll("&", "&amp;").replaceAll("<", "&lt;") : text),
+    attributeValue: braces,
+    // A nested <style> or <script> is raw text to Svelte, so its braces are not expressions.
+    rawText: new Set(["style", "script"]),
+    refuse: (name, kind) =>
+      kind === "attribute"
+        ? SVELTE_DIRECTIVE.test(name)
+          ? `the attribute ${name} is a Svelte directive`
+          : undefined
+        : name.startsWith("svelte:") || name.includes(".") || /^[A-Z]/.test(name)
+          ? `Svelte reads the element <${name}> as a component or special element`
+          : undefined,
+  })
   // `$props()` opts the component into runes (Svelte 5); spread onto the root so user attrs win.
   const withSpread = cleaned.replace(/^(<svg\b[^>]*?)>/, "$1 {...props}>")
   return `<script>const props = $props()</script>\n${withSpread}\n`