@voltro/web 0.52.0 → 0.54.0

package/THIRD-PARTY-NOTICES.md

@@ -5,7 +5,7 @@ property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/web itself, which is proprietary (see LICENSE).
 
-Generated from the resolved runtime dependency closure (6 packages).
+Generated from the resolved runtime dependency closure (16 packages).
 
 ---
 
@@ -37,6 +37,230 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## @standard-schema/spec@1.1.0
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2024 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/devtools-event-client@0.4.4
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2025 TanStack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/form-core@1.33.5
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2021-present Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/pacer-lite@0.1.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2025 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/react-store@0.11.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2021 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## @tanstack/store@0.11.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2021 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## effect@3.22.0
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2023 Effectful Technologies Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## fast-check@3.23.2
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2017 Nicolas DUBIEN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## jose@6.2.8
 
 License: MIT
@@ -93,6 +317,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## pure-rand@6.1.0
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2018 Nicolas DUBIEN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## typeid-js@1.2.0
 
 License: Apache-2.0
@@ -329,6 +581,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## use-sync-external-store@1.6.0
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## uuid@11.1.1
 
 License: MIT

package/dist/index.d.ts

@@ -376,7 +376,7 @@ export declare type HydrateStrategy =
 *  instead of hydrating. Astro's `client:only`. */
 | 'only';
 
-declare const Image_2: ({ src, alt, width, height, fill, sizes, priority, loader, placeholder, blurDataURL, style, ...rest }: ImageProps) => ReactElement;
+declare const Image_2: ({ src, alt, width, height, fill, sizes, priority, loader, quality, placeholder, blurDataURL, style, ...rest }: ImageProps) => ReactElement;
 export { Image_2 as Image }
 
 /** App-level default loader for every `<Image>` below it. A per-image
@@ -388,14 +388,16 @@ export declare const ImageConfigProvider: ({ loader, children, }: {
 
 /** Maps a logical src + a target pixel width to a concrete URL. The hook
  *  for on-the-fly resizing — e.g. `({src,width}) => \`${src}?w=${width}\``
- *  against an image CDN or the storage serve endpoint. */
+ *  against an image CDN or the storage serve endpoint. `quality` is set when
+ *  the `<Image quality>` prop is — forward it if your CDN supports it. */
 export declare type ImageLoader = (params: {
     readonly src: string;
     readonly width: number;
+    readonly quality?: number;
 }) => string;
 
 export declare interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'width' | 'height' | 'loading' | 'srcSet'> {
-    readonly src: string;
+    readonly src: string | OptimizedImageAsset;
     /** Required — accessibility. Use `alt=""` for purely decorative images. */
     readonly alt: string;
     /** Intrinsic width in px. Required unless `fill`. */
@@ -412,7 +414,14 @@ export declare interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElem
     readonly priority?: boolean;
     /** Per-image URL loader (overrides the ImageConfigProvider default). */
     readonly loader?: ImageLoader;
-    /** `'blur'` paints `blurDataURL` behind the image until it loads. */
+    /** Encode quality hint 1–100 forwarded to the URL loader (a hero wants 90,
+     *  a thumbnail 50). For a build-optimized `?image` asset the quality was
+     *  baked at build time (`images.quality` in app.config.ts) — this prop
+     *  applies to loader/CDN-resolved URLs. */
+    readonly quality?: number;
+    /** `'blur'` paints `blurDataURL` behind the image until it loads. A
+     *  build-optimized asset carries its own blur and defaults to `'blur'`;
+     *  pass `'empty'` to opt out. */
     readonly placeholder?: 'blur' | 'empty';
     readonly blurDataURL?: string;
 }
@@ -676,6 +685,21 @@ export declare type LoaderFn<T = unknown, Procedures = unknown> = (ctx: LoaderCo
  */
 export declare type LoaderQuery<Procedures = unknown> = Procedures extends ProcedureTypeMap ? <Tag extends keyof Procedures & string>(tag: Tag, ...input: Record<string, never> extends ProcedureInput<Procedures[Tag]> ? [input?: ProcedureInput<Procedures[Tag]>] : [input: ProcedureInput<Procedures[Tag]>]) => Promise<ProcedureOutput<Procedures[Tag]>> : <T = unknown>(tag: string, input?: Record<string, unknown>) => Promise<T>;
 
+/**
+ * Reference a family declared in `app.config.ts` `fonts:`.
+ *
+ *   const inter = localFont('Inter')
+ *   <main style={{ fontFamily: inter.fontFamily }}>…</main>
+ */
+export declare const localFont: (family: string) => LocalFontHandle;
+
+export declare interface LocalFontHandle {
+    /** The CSS custom property the shell defines: `--font-<slug>`. */
+    readonly variable: string;
+    /** Ready-to-use `font-family` value: `var(--font-<slug>)`. */
+    readonly fontFamily: string;
+}
+
 /** The URL path a logical page takes for a given locale under URL-prefix
  *  routing: the default locale keeps the bare path, every other locale gets a
  *  `/<locale>` prefix. `/about` @ `de` → `/de/about`; @ the default → `/about`. */
@@ -788,6 +812,31 @@ export declare class NotFoundError extends Error {
 
 export declare const noticeIslandsShipTheFullBundle: (isDev: boolean) => void;
 
+/**
+ * A build-optimized static asset — what a `?image` import resolves to:
+ *
+ *   import hero from './hero.jpg?image'
+ *   <Image src={hero} alt="…" />
+ *
+ * The CLI's sharp pipeline produced the variants at build time (on demand in
+ * dev); `<Image>` renders them as a `<picture>` with one `<source>` per
+ * modern format and infers width/height/blur — the CLS-required intrinsic
+ * size stops being a hand-written prop for imported assets.
+ */
+export declare interface OptimizedImageAsset {
+    readonly src: string;
+    readonly width: number;
+    readonly height: number;
+    readonly blurDataURL: string;
+    /** Fallback-format srcSet (jpeg/png). */
+    readonly srcSet: string;
+    /** Modern-format sources, in preference order (avif before webp). */
+    readonly sources: ReadonlyArray<{
+        readonly type: string;
+        readonly srcSet: string;
+    }>;
+}
+
 export declare const PAGE_SLOT_ATTR = "data-voltro-page-slot";
 
 export declare interface PageDescriptor<TLoaderData = unknown> {
@@ -840,6 +889,19 @@ export declare interface PageDescriptor<TLoaderData = unknown> {
      *  set this to `'islands'` so only marked interactive zones
      *  hydrate; the rest stays pure static HTML. */
     readonly interactive?: InteractiveMode | undefined;
+    /**
+     * Intercepting route (modal-with-URL): when a SOFT navigation reaches this
+     * page FROM one of the `from` route patterns, the page renders as an
+     * OVERLAY above the still-mounted origin page instead of replacing it —
+     * URL changes, Back closes the overlay, a hard load of the same URL
+     * renders the page standalone. `from` is one or more route PATTERNS
+     * (`'/photos'`, `'/albums/[id]'`); a soft navigation from any other route
+     * renders standalone. Full-hydration pages only (`interactive: 'full'`) —
+     * islands/none pages have no client router to intercept with.
+     */
+    readonly intercept?: {
+        readonly from: string | ReadonlyArray<string>;
+    } | undefined;
 }
 
 export declare interface PageMeta {
@@ -1010,6 +1072,9 @@ export declare type RenderMode = (typeof RENDER_MODES)[number];
 
 /* Excluded from this release type: renderRouterProviderTree */
 
+/** Test seam. */
+export declare const resetScriptRegistryForTest: () => void;
+
 /**
  * Decide whether a click on (or inside) an anchor should be handled by the
  * SPA router or left to the browser. Pure — no side effects, no
@@ -1136,6 +1201,40 @@ declare interface RouteSnapshot {
     readonly loaderData: unknown;
 }
 
+/**
+ * Declarative third-party script. Renders NOTHING into the HTML — the tag is
+ * injected client-side per `strategy`, deduplicated process-wide by `src`
+ * (external) or `id` (inline). Behavior per `interactive` mode is decided,
+ * not accidental: on an `interactive: 'none'` page the app bundle never runs,
+ * so a `<Script>` never fires (the build warns by name); on an islands page
+ * only `<Script>` INSIDE an island ever mounts — a `visible` island's script
+ * loads when the island hydrates (the build warns about `<Script>` in the
+ * static part).
+ */
+export declare const Script: ({ src, children, id, strategy, onLoad, onError, nonce, attributes, }: ScriptProps) => ReactElement | null;
+
+export declare interface ScriptProps {
+    /** External script URL. Exactly one of `src` / `children` is required. */
+    readonly src?: string;
+    /** Inline script body. Requires `id` (the dedupe key — inline code has no
+     *  src to key on). */
+    readonly children?: string;
+    /** Dedupe key for inline scripts; optional label for external ones. */
+    readonly id?: string;
+    /** `afterInteractive` (default): inject once this component mounts —
+     *  i.e. after hydration. `lazyOnload`: wait for browser idle. */
+    readonly strategy?: 'afterInteractive' | 'lazyOnload';
+    /** Fires when the script has executed — ALSO on a re-mount of the same
+     *  script, answered from the registry (the script itself is never
+     *  re-fetched or re-run). */
+    readonly onLoad?: () => void;
+    readonly onError?: (error: unknown) => void;
+    /** CSP nonce. Absent → the document's nonce is propagated when one exists. */
+    readonly nonce?: string;
+    /** Extra attributes for the tag (`data-*`, `crossorigin`, …). */
+    readonly attributes?: Readonly<Record<string, string>>;
+}
+
 declare const SEARCH_PARAMS_BRAND: unique symbol;
 
 /** The next search-params value: either the params object directly, or an