@levo-so/site-runtime 0.3.24 → 0.3.25

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @levo-so/site-runtime
 
+## 0.3.25
+
+### Patch Changes
+
+- 12bdba7: Adds `LevoLink`, the router's `<Link>` with a `to` that accepts any site path. On a multi-variant site, shared chrome (navbar, footer, CTAs) must link to the language-neutral path (`/about-us`) so the doorway sends each visitor to their own variant, but `<Link to="/about-us">` fails the publish type check because the neutral path is not a registered route. `LevoLink` is that link with the typing escape in one place and the reason attached, instead of a cast in every site; navigation is unchanged and still goes through the root route's locale redirect.
+- 07c0850: Dynamic pages type-check with the loader attached. The loader from `createLevoLoader` no longer declares `params` on its context type: TanStack inferred a route's params from that annotation instead of from the file path, so `Route.useParams()` on a `$slug` route was typed `{ [x: string]: string } | undefined` and `const { slug } = Route.useParams()` failed the publish type check (#4696). A plain `$slug` route now gets `slug: string`, a route under a `$locale` layout keeps `locale`, a `levoParams` route keeps its split variables, and a static route has no params. The loader still reads the route params at runtime and prefetches the same sources; sites can drop the `Route.useParams() ?? {}` workaround.
+  - @levo-so/core@0.3.25
+  - @levo-so/insights@0.3.25
+
 ## 0.3.24
 
 ### Patch Changes

package/index.d.ts

@@ -1,3 +1,4 @@
+import { AnyRouter } from '@tanstack/react-router';
 import { ILemaCollection } from '@levo-so/core';
 import { ILevoClient } from '@levo-so/core';
 import { ILevoInsights } from '@levo-so/insights';
@@ -5,6 +6,7 @@ import { ILevoMembership } from '@levo-so/core';
 import { IMediaObject } from '@levo-so/core';
 import { JSX } from 'react/jsx-runtime';
 import { LevoQuery } from '@levo-so/core';
+import { LinkComponentProps } from '@tanstack/react-router';
 
 /**
  * Build the canonical + hreflang link set for one page.
@@ -55,7 +57,8 @@ export declare const createLevoHead: (site: ISiteJson) => (meta?: IPlatformMetaF
  * return them keyed by source key — that map is the route's `loaderData`, which
  * `levoHead`'s dynamic config reads for per-record heads. An empty `dataSources` ({})
  * resolves to an empty map. Context is typed structurally (just `queryClient`) so the
- * scaffold's router types never enter the package.
+ * scaffold's router types never enter the package — and WITHOUT `params`, see
+ * `ILevoLoaderContext`.
  *
  * Takes the raw `site.json` — same single input as `createLevoHead` and
  * `LevoSiteProvider` — and derives the client config itself.
@@ -72,12 +75,7 @@ export declare const createLevoHead: (site: ISiteJson) => (meta?: IPlatformMetaF
  * `meta` is optional so sites generated before this shipped keep working unchanged — they
  * simply prefetch as they always did (and have no gates to protect).
  */
-export declare const createLevoLoader: (site: ISiteJson) => (sources: ILevoDataSources, meta?: IPlatformMetaFile) => ({ context, params, }: {
-    context: {
-        queryClient: IQueryClientLike;
-    };
-    params?: Record<string, string>;
-}) => Promise<Record<string, unknown>>;
+export declare const createLevoLoader: (site: ISiteJson) => (sources: ILevoDataSources, meta?: IPlatformMetaFile) => (ctx: ILevoLoaderContext) => Promise<Record<string, unknown>>;
 
 /**
  * Build a route-existence matcher from a generated `routeTree`.
@@ -769,6 +767,41 @@ export declare interface ILevoFormTheme {
 /** How the form lays its fields out. */
 export declare type ILevoFormVariant = "default" | "single-field" | "steps" | "steps-2";
 
+/**
+ * `Link`'s props with `to` widened to any site path.
+ *
+ * `params` is dropped: a neutral path carries none, and a shared component that links to a
+ * dynamic page composes the string (`` `/accelerators/${slug}` ``).
+ */
+export declare interface ILevoLinkProps extends Omit<LinkComponentProps<"a", AnyRouter, string, string, string, string>, "to" | "params"> {
+    /** A site path — the neutral `/about-us` in shared chrome. Not checked against the routes. */
+    to: string;
+}
+
+/**
+ * The slice of the router's loader context the loader reads. Structural on purpose (like
+ * `IHeadCtx`) so the scaffold's router types never enter the package.
+ *
+ * `params` is deliberately NOT declared here, and must not be re-added in any form. TanStack
+ * infers a route's param type from the loader it is handed: `createFileRoute(path)({ loader })`
+ * carries a `TParams` type parameter whose DEFAULT is the params parsed from the path, and the
+ * loader argument's `params` property is an inference site for it. Any annotation on that
+ * property — `params?: Record<string, string>`, `params?: unknown`, a generic bound — becomes
+ * the inferred `TParams` and beats the default, so `Route.useParams()` on `$slug.tsx` read
+ * `{ [x: string]: string } | undefined` and `slug` failed the publish type check (#4696).
+ * Left undeclared, the loader contributes no candidate and the route keeps the params its
+ * path (or its `params.parse`) gives it. `loaderParams` reads them at runtime.
+ *
+ * Exported (and re-exported from the package root) because a route file's `Route` type
+ * carries its loader's type: a site that emits declarations (`Register { router }` makes the
+ * router an exported type) would otherwise fail with TS4023 "cannot be named".
+ */
+export declare interface ILevoLoaderContext {
+    context: {
+        queryClient: IQueryClientLike;
+    };
+}
+
 export declare interface ILevoLoginActions {
     /**
      * Send a verification code. `identifier` is the email address (medium `"email"`) or the
@@ -1802,6 +1835,19 @@ export declare const LevoEventRegister: ({ eventID, title, external, buttonText,
  */
 export declare const LevoForm: React.FC<ILevoFormProps>;
 
+/**
+ * `<Link>` whose `to` accepts any site path.
+ *
+ * Use it in shared chrome for the language-neutral path: `<LevoLink to="/about-us">`. Inside a
+ * variant folder (`src/routes/fr-FR/pricing.tsx`) keep `<Link to="/fr-FR/about">`: the variant
+ * is fixed there, and `Link` keeps that path checked against the routes, which this cannot.
+ * Everything else — `className`, `activeProps`, `preload`, `ref`, the render-function
+ * `children` — is `Link`'s own.
+ *
+ * @since 0.3.25
+ */
+export declare const LevoLink: React.FC<ILevoLinkProps>;
+
 export declare const levoParams: <TSegment extends string, TPattern extends string, TSiblings extends string = never>(key: TSegment, pattern: TPattern, _siblings?: readonly TSiblings[]) => ILevoParams<TSegment, TPattern, TSiblings>;
 
 /**