@levo-so/site-runtime 0.3.24 → 0.3.26

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`.
@@ -622,6 +620,23 @@ export declare interface ILevoDynamicHead {
     image?: string;
 }
 
+export declare interface ILevoEditFormProps {
+    /** The collection binding — same `dataSources` entry (`mode: "form"`) a `<LevoForm>` takes. */
+    source: ILevoFormConfig;
+    /** Values the form opens with — the entry being edited. Read once, when the form mounts. */
+    initialValues?: Record<string, unknown>;
+    /** Receives only the visible fields' values; hidden ones never reach the save. */
+    onSubmit: (values: Record<string, unknown>) => void;
+    /** Disables the submit button and shows "Saving" — pass the save's pending state. */
+    isLoading?: boolean;
+    /** Fields to hide, by key or id. */
+    hiddenFields?: string[];
+    submitLabel?: string;
+    /** Per-form color/radius overrides. Rarely needed — the form already follows the site theme. */
+    theme?: ILevoFormTheme;
+    className?: string;
+}
+
 export declare interface ILevoEntryFormProps {
     /** The gated collection's key — take it from the blocking rule's `options.collection`. */
     collection: string;
@@ -648,6 +663,11 @@ declare interface ILevoEventRegisterProps {
     endsAt?: string | Date | null;
     /** Joining link (`url`), attached to the calendar entry so it is one tap away at start time. */
     eventUrl?: string | null;
+    /**
+     * Lets one order hold several tickets: a quantity stepper per ticket type, then one set of
+     * attendee details per ticket, paid for together. Off by default — one ticket, one attendee.
+     */
+    enableMultipleTicketBooking?: boolean;
 }
 
 /**
@@ -769,6 +789,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
@@ -1753,6 +1808,16 @@ export declare const LEVO_PRIMARY_AUTH_METHODS: readonly ["otp", "magiclink", "w
  */
 export declare const LevoChat: React.FC<ILevoChatProps>;
 
+/**
+ * A collection's fields as an edit form, with no API calls of its own — the v3 counterpart of
+ * v2's studio `EditForm`. The page loads the entry (`initialValues`) and saves it in
+ * `onSubmit`, e.g. an "edit my profile" page over `getDraftEntry` + `editDraftEntry`.
+ * For new submissions use `<LevoForm>`; for the membership account, `<LevoProfileForm>`.
+ *
+ * Mount it once the entry has loaded: `initialValues` is read on mount only.
+ */
+export declare const LevoEditForm: React.FC<ILevoEditFormProps>;
+
 /**
  * The "request access" form for a `gating` rule — the collection's own fields, submitted as
  * an entry owned by the signed-in visitor.
@@ -1780,9 +1845,11 @@ export declare const LevoEntryForm: React.FC<ILevoEntryFormProps>;
  * auto-stamps the workspace on every request, so no auth/workspace wiring is needed.
  * `external` turns it into a plain link out to a third-party ticketing URL.
  *
+ * `enableMultipleTicketBooking` swaps in the cart flow (`CartRegister`): several tickets, one attendee each.
+ *
  * `?register=1` on the page URL opens the sheet on load, for campaign links and second CTAs.
  */
-export declare const LevoEventRegister: ({ eventID, title, external, buttonText, startsAt, endsAt, eventUrl, }: ILevoEventRegisterProps) => JSX.Element;
+export declare const LevoEventRegister: (props: ILevoEventRegisterProps) => JSX.Element;
 
 /**
  * A collection-backed form for generated Studio v3 sites — renders the collection's fields
@@ -1802,6 +1869,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>;
 
 /**