@levo-so/studio 0.1.108 → 0.1.110

package/index.d.ts

@@ -217,6 +217,28 @@ declare interface BaseIframeProps extends BaseElementProps, Omit<default_2.HTMLA
 
 declare type BaseImageProps = ImageProps & HTMLImageProps;
 
+/**
+ * Published-site language switcher, modeled as a studio element (like `UserMenu`).
+ *
+ * Reads the page's sibling language variants from context (via `useLocalizedPages`)
+ * — no data wiring needed — and navigates to the selected language's localized URL
+ * on a full reload. Dynamic-page placeholder slugs are resolved from the current
+ * path before navigating.
+ *
+ * Renders nothing when the page has at most one language. Hide it deliberately by
+ * setting `config.enabled = false` on its element — `withBlockProps` gates on that.
+ */
+export declare const BaseLanguageSwitcher: React_2.FC<BaseLanguageSwitcherProps>;
+
+export declare interface BaseLanguageSwitcherProps extends Omit<BaseElementProps, "content"> {
+    /** Class applied to the wrapper. */
+    className?: string;
+    /** Class applied to the dropdown menu content. */
+    contentClassName?: string;
+    /** Menu alignment relative to the trigger. Defaults to "end". */
+    align?: "start" | "center" | "end";
+}
+
 declare interface BaseLinkProps extends BaseElementProps, Omit<React.HTMLAttributes<HTMLAnchorElement>, "content"> {
 }
 
@@ -284,6 +306,8 @@ declare type BlockProviderInput = {
     renderMode: IRenderMode;
     workspace_id: string;
     pageSource: IPage["source"];
+    localizedPages?: IPage["localized_pages"];
+    language?: IPage["language"];
 };
 
 export declare const BlockSourceModuleList: readonly ["collection", "event", "blog", "community", "context", "form", "blog_author", "blog_category", "blog_tag"];
@@ -361,6 +385,26 @@ export declare const BookingSummary: default_2.FC<IBookingSummaryProps>;
 
 export declare const Box: WithBlockPropsComponent<BaseBoxProps & default_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Builds the navigation target for switching to a sibling language.
+ *
+ * Static pages: the sibling's `live_url` is already concrete — return it as-is.
+ *
+ * Dynamic pages: `live_url` carries `{placeholder}` slugs (e.g.
+ * `https://x.com/fr-FR/industry/{industries}`). The current entry's `live_url`
+ * is the same template for the page being served, so aligning it segment-by-segment
+ * against the actual `currentPathname` recovers each slug's real value, which is
+ * then substituted into the target template.
+ *
+ * Falls back to the raw target `live_url` whenever alignment is not possible
+ * (no current template, unparseable URL, or mismatched segment counts).
+ */
+export declare const buildLocalizedHref: ({ current, target, currentPathname, }: {
+    current?: ILocalizedPage;
+    target: ILocalizedPage;
+    currentPathname: string;
+}) => string;
+
 /**
  * Built-in background effect presets organized by category
  */
@@ -402,8 +446,6 @@ declare interface CarouselProps extends BaseElementProps {
  */
 export declare const CategoryFilter: React.FC<ICategoryFilterProps>;
 
-export declare const CollectionFormBuilder: default_2.FC<ICollectionFormBuilderProps>;
-
 export declare const colorOptions: {
     readonly brand: {
         readonly label: "Brand";
@@ -543,6 +585,39 @@ export declare const DATA_ATTRIBUTES: {
     readonly GROUP: "data-levo_group";
 };
 
+/**
+ * Display kind — what facet of the moment is shown.
+ * `date` and `time` are self-explanatory; `datetime` shows both;
+ * `relative` renders distance-from-now (e.g. "2 days ago").
+ */
+export declare const DATE_DISPLAYS: readonly ["date", "time", "datetime", "relative"];
+
+/**
+ * Preset within a Display. Locked vocabulary so the picker is a finite list
+ * rather than a free-form format string.
+ */
+export declare const DATE_FORMATS: {
+    date: readonly ["full", "day", "month", "year", "day-month", "month-year"];
+    time: readonly ["clock"];
+    datetime: readonly ["full", "compact"];
+    relative: readonly ["auto"];
+};
+
+/** Hour cycle preference — Auto defers to the active locale's convention. */
+export declare const DATE_HOUR12_VALUES: readonly ["auto", "12", "24"];
+
+/** Curated locale list — Auto means "host default". */
+export declare const DATE_LOCALES: {
+    value: string;
+    label: string;
+}[];
+
+/** Style — visual length of the rendering. S/M/L/XL map to Intl widths. */
+export declare const DATE_STYLES: readonly ["S", "M", "L", "XL"];
+
+/** Serialize a spec back to args; trims trailing defaults to keep tokens lean. */
+export declare const dateSpecToArgs: (spec: IDateFormatSpec) => TVariableLiteral[];
+
 declare type DeepConfig<T> = T extends Array<infer U> ? IFieldConfig & {
     [index: number]: DeepConfig<U>;
 } : T extends object ? IFieldConfig & {
@@ -561,6 +636,8 @@ declare type DeepStyles<T> = T extends Array<infer U> ? IStyles & {
     [K in keyof T]: DeepStyles<T[K]>;
 } : IStyles;
 
+export declare const DEFAULT_DATE_SPEC: IDateFormatSpec;
+
 /** Default "from" state for entry/scroll animations */
 export declare const DEFAULT_FROM_STATE: AnimationProperties;
 
@@ -597,6 +674,9 @@ export declare interface EntryAnimationConfig {
     viewport?: ViewportConfig;
 }
 
+/** Evaluate a parsed token against a flattened context dictionary. */
+export declare const evaluateVariableToken: (parsed: IParsedVariableToken, context: Record<string, unknown>) => IEvaluatedVariable;
+
 /**
  * Extended props interface for useCommonProps return type
  */
@@ -629,6 +709,13 @@ export declare const fetchSource: ({ levoClient, source, workspace_id, slugs, pa
  */
 export declare const findFieldSchema: (contentSchema: IStudioWidget[] | undefined, fieldKey: string | undefined) => IStudioWidget | undefined;
 
+/**
+ * Flattens a hierarchical variable tree to a list of matches filtered by
+ * `query`. Recursively walks `items[*].children` so leaves at any depth
+ * surface in picker results. Empty/whitespace queries return every leaf.
+ */
+export declare const flattenVariableMatches: (groups: IVariableGroup[], query: string) => IFlatVariableMatch[];
+
 export declare const Form: WithBlockPropsComponent<BaseElementProps & {
 className?: string;
 initialValues?: Record<string, any>;
@@ -807,6 +894,8 @@ export declare const getInitialPageContent: ({ levoClient, pageData, site, query
     headCode: string;
 }>;
 
+export declare function getKeysWithValue(obj: Record<string, any>, maxDepth?: number): Record<string, any>;
+
 /**
  * Utility function to safely access nested object properties
  *
@@ -1084,14 +1173,6 @@ export declare interface ICategoryFilterProps {
     className?: string;
 }
 
-declare interface ICollectionFormBuilderProps extends Omit<ILevoFormContext, "schema"> {
-    formVariant?: FormVariantType;
-    collection_id: string;
-    hiddenFields?: string[];
-    workspace_id?: string;
-    account?: ILevoMembership.Account;
-}
-
 declare interface ICollectionTheme {
     form: {
         maxWidth: string;
@@ -1160,6 +1241,15 @@ declare interface ICreateForumPostProps {
     onPostCreated?: (post: IForumPost) => void;
 }
 
+export declare interface IDateFormatSpec {
+    display: TDateDisplay;
+    format: string;
+    style: TDateStyle;
+    locale: string;
+    /** Only relevant for `time` / `datetime` displays — ignored elsewhere. */
+    hour12: TDateHour12;
+}
+
 declare interface IDevToolsPreviewProps {
     blockInstance: IBlockInstance;
     blocks: Record<string, BlockComponent>;
@@ -1175,6 +1265,13 @@ export declare interface IDevToolsProps {
 
 export declare type IElementStyle = Record<string, any>;
 
+export declare interface IEvaluatedVariable {
+    output: string;
+    rawValue: unknown;
+    pathExists: boolean;
+    conditionFailed: boolean;
+}
+
 export declare interface IFieldConfig {
     selectedVariants?: Record<string, string>;
     enabled?: boolean;
@@ -1267,6 +1364,14 @@ export declare interface IFieldConfig {
     theme?: DeepPartial<ITheme_2 & IRteTheme & ICollectionTheme>;
 }
 
+export declare interface IFlatVariableMatch {
+    group: string;
+    /** Parent trail for nested values (e.g. Collection field with nested keys),
+     *  joined with " › ". Undefined for top-level leaves. */
+    parent?: string;
+    item: IVariableItem;
+}
+
 /**
  * Forum context
  */
@@ -1400,7 +1505,15 @@ declare interface ILevoFormContext {
         cssReset?: boolean;
     };
     isLoggedIn?: boolean;
-    account?: ILevoMembership.Account;
+    /**
+     * Logged-in member's contact details, used only to prefill the schema's designated
+     * email_field/mobile_field. Strictly the fields consumed — pass anything else via
+     * externalInitialValues.
+     */
+    account?: {
+        email?: string | null;
+        mobile?: string | null;
+    };
     externalInitialValues?: Record<string, any>;
     onSuccess?: (v: {
         schemaId: string;
@@ -1429,7 +1542,7 @@ declare interface ILevoFormContext {
     preview?: boolean;
 }
 
-export declare type ILevoPageData = Pick<IPageExpanded, "id" | "workspace_id" | "blocks" | "source" | "title" | "description" | "access" | "style_config" | "settings">;
+export declare type ILevoPageData = Pick<IPageExpanded, "id" | "workspace_id" | "blocks" | "source" | "title" | "description" | "access" | "style_config" | "settings" | "language" | "localized_pages">;
 
 export declare interface ILevoPageProps {
     pageData: ILevoPageData;
@@ -1443,9 +1556,31 @@ export declare interface ILevoPageProps {
     disableBranding?: boolean;
 }
 
+/**
+ * A sibling language variant of a page.
+ *
+ * Two backends populate this shape:
+ * - The studio runtime (`get-page-from-path`) sets `language_label`, `live_url`,
+ *   and `is_current` — used by the published-site language switcher.
+ * - The dashboard editor's page-data response sets `title`, `status`, `countries`,
+ *   `url` — used by the locale/country pickers.
+ *
+ * Only `id` and `language` are guaranteed on both; the rest are source-specific.
+ */
 export declare interface ILocalizedPage {
     id: string;
     language: string;
+    /** Human-readable language label, e.g. "French (France)". Runtime response only. */
+    language_label?: string;
+    /**
+     * Fully-localized URL for this sibling. Default language is unprefixed, others
+     * are language-prefixed. Dynamic pages keep `{placeholder}` slugs to substitute
+     * client-side. Runtime response only.
+     */
+    live_url?: string;
+    /** True for the page currently being served; always the first entry. Runtime response only. */
+    is_current?: boolean;
+    /** Editor response only — guaranteed there; absent on runtime entries (not read by the runtime). */
     title: string;
     status?: "published" | "draft";
     countries?: string[];
@@ -1551,7 +1686,7 @@ export declare interface IPage {
     published_at: string | null;
 }
 
-export declare type IPageAccess = (IPageAccessGating | IPageAccessAuthentication) & {
+export declare type IPageAccess = (IPageAccessGating | IPageAccessAuthentication | IPageAccessProfile) & {
     enabled: boolean;
 };
 
@@ -1577,9 +1712,9 @@ export declare interface IPageAccessAuthenticationOptions {
 
 export declare interface IPageAccessCheck {
     has_access: boolean;
-    code?: IPageAccessAuthenticationCodes | IPageAccessGatingCodes;
+    code?: IPageAccessAuthenticationCodes | IPageAccessGatingCodes | IPageAccessProfileCodes;
     message: string;
-    options?: Pick<IPageAccessGatingOptions, "collection" | "field" | "content"> | IPageAccessAuthenticationOptions;
+    options?: Pick<IPageAccessGatingOptions, "collection" | "field" | "content"> | Pick<IPageAccessProfileOptions, "hidden" | "content"> | IPageAccessAuthenticationOptions;
 }
 
 export declare type IPageAccessGating = {
@@ -1617,6 +1752,41 @@ export declare interface IPageAccessGatingOptions {
     };
 }
 
+export declare type IPageAccessProfile = {
+    kind: "profile";
+    options: IPageAccessProfileOptions;
+};
+
+export declare type IPageAccessProfileCodes = 
+/**
+* if the visitor is not logged in
+*/
+"profile.NOT_LOGGED_IN"
+/**
+* logged in, but the account does not pass `options.condition` — render the
+* profile-completion form. An empty condition means "no rule" → always SUCCESS.
+* Named to mirror gating's ENTRY_CONDITION_NOT_FULFILLED — the criteria can fail on
+* a filled field that simply doesn't match, so "incomplete" would be misleading.
+*/
+| "profile.CONDITION_NOT_FULFILLED" | "profile.SUCCESS";
+
+/**
+ * Profile gating is *account access*: login + the logged-in account must satisfy
+ * `condition`. It is a sibling of `authentication`, not of `gating` — there is no
+ * collection in the contract. The BE owns the membership account internally; the
+ * runtime ProfileCard loads the account schema by its known key.
+ */
+export declare interface IPageAccessProfileOptions {
+    /** "Profile is completed when" — evaluated against the caller's own account. */
+    condition?: LevoQuery.Where;
+    /** Account fields to hide in the profile-completion form. */
+    hidden?: string[];
+    content?: {
+        /** Message shown above the profile-completion form. */
+        entryNotFound?: string;
+    };
+}
+
 export declare type IPageContext = Record<string, unknown>;
 
 export declare interface IPageDataContext {
@@ -1676,6 +1846,11 @@ export declare interface IPageStatMetric {
     change: number | null;
 }
 
+export declare interface IParsedVariableToken {
+    path: string;
+    transforms: IVariableTransform[];
+}
+
 declare interface IPendingRequestStateProps {
     communityName?: string;
     className?: string;
@@ -1717,6 +1892,15 @@ declare type IPreviewDevice = "desktop" | "tablet" | "mobile";
  */
 export declare type IRenderMode = "live" | "studio.page" | "studio.block";
 
+/**
+ * Per-content responsive override. Lives on the studio content value (not on
+ * the shared IMediaObject) so the core type stays untouched.
+ */
+declare interface IResponsiveImageContent {
+    mobile?: IMediaObject;
+    tablet?: IMediaObject;
+}
+
 declare interface IRteTheme {
     baseSpacing: string;
     /** Background color for text selection and highlighted nodes. */
@@ -1790,6 +1974,10 @@ export declare interface ISite {
             twitter?: string;
             linkedin?: string;
             instagram?: string;
+            youtube?: string;
+            tiktok?: string;
+            pinterest?: string;
+            threads?: string;
         };
         [key: string]: any;
     };
@@ -2092,6 +2280,11 @@ export declare type IThemeFonts = {
     customFonts?: Record<string, string>;
 };
 
+declare interface ITransformDef {
+    label: string;
+    apply: (value: unknown, args: TVariableLiteral[]) => unknown;
+}
+
 declare interface IUseDotButtonType {
     selectedIndex: number;
     scrollSnaps: number[];
@@ -2137,6 +2330,27 @@ export declare interface IUseStripePaymentReturn {
     onComplete: (() => void) | null;
 }
 
+export declare interface IVariableGroup {
+    name: string;
+    items: IVariableItem[];
+}
+
+export declare interface IVariableItem {
+    /** Display label */
+    label: string;
+    /** Token inserted into the editor (e.g. `context.collection.title`) */
+    value: string;
+    /** Optional muted preview shown under the label */
+    preview?: string;
+    /** Sub-fields for composite values — renders as a nested group */
+    children?: IVariableItem[];
+}
+
+export declare interface IVariableTransform {
+    name: string;
+    args: TVariableLiteral[];
+}
+
 /**
  * Configuration for a single variant group within a component theme
  *
@@ -2176,6 +2390,8 @@ export declare function KbdGroup({ className, ...props }: React.ComponentProps<"
 
 export declare const KindList: readonly ["element", "group"];
 
+export declare const LanguageSwitcher: WithBlockPropsComponent<BaseLanguageSwitcherProps>;
+
 /**
  * Provides LazyMotion context with domAnimation features for reduced bundle size.
  *
@@ -2184,7 +2400,7 @@ export declare const KindList: readonly ["element", "group"];
  */
 export declare const LazyMotionProvider: React.FC<ILazyMotionProviderProps>;
 
-export declare const LevoBlock: default_2.MemoExoticComponent<({ html_id, renderMode, blocks, parsedBlockData, blockData, pageContext, pageMeta, blockContext, workspace_id, pageSource, }: LevoBlockProps) => JSX.Element>;
+export declare const LevoBlock: default_2.MemoExoticComponent<({ html_id, renderMode, blocks, parsedBlockData, blockData, pageContext, pageMeta, blockContext, workspace_id, pageSource, localizedPages, language, }: LevoBlockProps) => JSX.Element>;
 
 declare interface LevoBlockProps {
     html_id?: string;
@@ -2197,6 +2413,8 @@ declare interface LevoBlockProps {
     pageMeta?: TPageMeta;
     blockContext?: IPageDataContext["blocks"][number];
     pageSource?: IPage["source"];
+    localizedPages?: IPage["localized_pages"];
+    language?: IPage["language"];
 }
 
 export declare const LevoPage: default_2.FC<ILevoPageProps>;
@@ -2221,7 +2439,10 @@ declare type MediaContent = {
     srcset?: {
         path: string;
     };
-} | IMedia;
+    responsive?: IResponsiveImageContent;
+} | (IMedia & {
+    responsive?: IResponsiveImageContent;
+});
 
 declare type MediaContent_2 = {
     location: string;
@@ -2229,7 +2450,10 @@ declare type MediaContent_2 = {
         path: string;
     };
     type?: string;
-} | IMedia;
+    responsive?: IResponsiveImageContent;
+} | (IMedia & {
+    responsive?: IResponsiveImageContent;
+});
 
 export declare type MediaHint = {
     orientation?: "landscape" | "portrait" | "square";
@@ -2244,6 +2468,10 @@ export declare const MESSAGE_TYPES: {
     readonly PREVIEW_MOUSE_LEAVE: "PREVIEW_MOUSE_LEAVE";
     readonly PREVIEW_UNDO: "PREVIEW_UNDO";
     readonly PREVIEW_REDO: "PREVIEW_REDO";
+    readonly PREVIEW_MOVE_BLOCK: "PREVIEW_MOVE_BLOCK";
+    readonly PREVIEW_DELETE_BLOCK: "PREVIEW_DELETE_BLOCK";
+    readonly PREVIEW_DUPLICATE_BLOCK: "PREVIEW_DUPLICATE_BLOCK";
+    readonly PREVIEW_OPEN_BLOCK_PANEL: "PREVIEW_OPEN_BLOCK_PANEL";
     readonly STUDIO_SELECT: "STUDIO_SELECT";
     readonly STUDIO_HOVER: "STUDIO_HOVER";
     readonly STUDIO_AUTH_OVERRIDE: "STUDIO_AUTH_OVERRIDE";
@@ -2307,6 +2535,9 @@ export declare const oklchToRGBA: (oklchColor: OKLCHColor) => string;
  */
 export declare const oklchToString: (oklchColor: OKLCHColor | string | undefined) => string;
 
+/** Read a structured spec out of pipe-syntax args, falling back to defaults. */
+export declare const parseDateSpec: (args: TVariableLiteral[]) => IDateFormatSpec | null;
+
 /**
  * Parse element key to detect repeatable group context
  *
@@ -2352,6 +2583,9 @@ export declare const parseVariablesFromResolvedSource: ({ levoClient, block, res
     draft?: boolean;
 }) => Promise<[IBlockInstance, Record<string, IResponseMultiple<Record<string, unknown>>>]>;
 
+/** Parse the inner expression of a `{...}` token into a path + transforms. */
+export declare const parseVariableToken: (raw: string) => IParsedVariableToken;
+
 /** Error code returned when account exists but is pending admin approval */
 export declare const PENDING_APPROVAL_ERROR_CODE = "membership.account.ACCOUNT_PENDING_APPROVAL";
 
@@ -2679,6 +2913,14 @@ export declare const SimpleTooltipWrapper: React_2.FC<{
 
 export declare function Skeleton({ className, ...props }: React.ComponentProps<"div">): JSX.Element;
 
+/**
+ * Snap a style to the nearest valid option for the current (display, format).
+ * Used when the user changes display/format and the previously-chosen style
+ * is no longer offered — picks the available style with the smallest index
+ * distance in the canonical S→M→L→XL order.
+ */
+export declare const snapDateStyle: (style: TDateStyle, available: readonly TDateStyle[]) => TDateStyle;
+
 export declare interface SourceFetchOptions {
     levoClient: ILevoClient;
     source: IStudioSource;
@@ -2739,6 +2981,15 @@ export declare const StudioWidgetList: readonly ["BoxWidget", "ButtonWidget", "L
 
 export declare const StudioWidgetMap: Record<"BoxWidget" | "ButtonWidget" | "LayoutWidget" | "HeadingWidget" | "IframeWidget" | "ImageWidget" | "IconWidget" | "MediaWidget" | "TypographyWidget" | "BlogContentWidget" | "CarouselWidget" | "FormWidget" | "ContainerWidget" | "UserMenuWidget" | "TabsListWidget" | "TabsTriggerWidget" | "TabsContentWidget" | "NavMenuWidget" | "CardWidget" | "TitleWidget" | "TextWidget" | "NumberWidget" | "URLWidget" | "ImageUploadWidget" | "MultiImageUploadWidget" | "TextareaWidget" | "RichTextWidget" | "DropdownWidget" | "SwitchWidget" | "DateWidget" | "ArrayWidget" | "RecordWidget", "BoxWidget" | "ButtonWidget" | "LayoutWidget" | "HeadingWidget" | "IframeWidget" | "ImageWidget" | "IconWidget" | "MediaWidget" | "TypographyWidget" | "BlogContentWidget" | "CarouselWidget" | "FormWidget" | "ContainerWidget" | "UserMenuWidget" | "TabsListWidget" | "TabsTriggerWidget" | "TabsContentWidget" | "NavMenuWidget" | "CardWidget" | "TitleWidget" | "TextWidget" | "NumberWidget" | "URLWidget" | "ImageUploadWidget" | "MultiImageUploadWidget" | "TextareaWidget" | "RichTextWidget" | "DropdownWidget" | "SwitchWidget" | "DateWidget" | "ArrayWidget" | "RecordWidget">;
 
+/**
+ * Distinct Style values for a given (display, format). The four-step S/M/L/XL
+ * vocabulary doesn't map cleanly to every Intl rendering — e.g. for `time`
+ * S and M both produce "1:30 PM", and for `date / year` everything past S
+ * just prints "2026". Exposing only the values that yield different output
+ * keeps the toggle honest.
+ */
+export declare const stylesFor: (display: TDateDisplay, format: string) => readonly TDateStyle[];
+
 export declare const TabsContent: WithBlockPropsComponent<BaseTabsContentProps>;
 
 export declare const TabsList: WithBlockPropsComponent<BaseTabsListProps>;
@@ -2747,6 +2998,14 @@ export declare const TabsRoot: React_2.ForwardRefExoticComponent<Tabs.TabsProps
 
 export declare const TabsTrigger: WithBlockPropsComponent<BaseTabsTriggerProps>;
 
+export declare type TDateDisplay = (typeof DATE_DISPLAYS)[number];
+
+export declare type TDateFormat<D extends TDateDisplay = TDateDisplay> = (typeof DATE_FORMATS)[D][number];
+
+export declare type TDateHour12 = (typeof DATE_HOUR12_VALUES)[number];
+
+export declare type TDateStyle = (typeof DATE_STYLES)[number];
+
 export declare const Tooltip: React_2.FC<Tooltip_2.TooltipProps>;
 
 export declare const TooltipContent: React_2.ForwardRefExoticComponent<Omit<Tooltip_2.TooltipContentProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
@@ -2771,6 +3030,23 @@ export declare interface TransitionConfig {
     bounce?: number;
 }
 
+/**
+ * Variable expression engine — parses and evaluates pipe-syntax tokens.
+ *
+ * Syntax:    {path | transform:arg1:arg2 | transform:arg | …}
+ * Examples:  {user.name}
+ *            {user.name | default:"Guest" | upper | prefix:"Hi "}
+ *            {order.total | currency:INR}
+ *            {event.starts_at | date:date:day-month:L:auto}
+ *            {order.status | if:eq:"paid" | text:"Paid ✓"}
+ *
+ * Source of truth for the parser, transforms and date formatting. The
+ * runtime renderer (`@levo-so/studio`) substitutes `{path}` tokens at page
+ * render time; the dashboard's editor wires the same engine into a TipTap
+ * NodeView so authoring and runtime stay in lockstep.
+ */
+export declare type TVariableLiteral = string | number | boolean | null;
+
 /** Available easing functions for tween transitions */
 export declare type TweenEase = "linear" | "easeIn" | "easeOut" | "easeInOut" | "circIn" | "circOut" | "circInOut" | "backIn" | "backOut" | "backInOut" | "anticipate";
 
@@ -2844,6 +3120,11 @@ export declare const useForumContext: () => IForumContext;
  */
 export declare const useGeneratedClassName: (elementKey: string, blockId: string, configValue: IFieldConfig | undefined) => string;
 
+export declare const useLocalizedPages: () => {
+    localizedPages: ILocalizedPage[];
+    currentLanguage: string | undefined;
+};
+
 /**
  * Pure API operations hook for authentication
  * All form state management moved to components with Formik
@@ -2863,6 +3144,19 @@ export declare const UserMenu: WithBlockPropsComponent<BaseUserMenuProps>;
  */
 export declare const useStripePayment: () => IUseStripePaymentReturn;
 
+/** Single-token regex — matches a string that is ONLY a `{...}` token. */
+export declare const VARIABLE_SINGLE_TOKEN_REGEX: RegExp;
+
+/** Token-matching regex — matches `{anything-not-a-brace}`. Nested braces
+ *  are not supported: avoiding them prevents adjacent-pill corruption when
+ *  the user types `{` next to a variable pill. */
+export declare const VARIABLE_TOKEN_REGEX: RegExp;
+
+export declare const VARIABLE_TRANSFORMS: Record<string, ITransformDef>;
+
+/** Serialize a parsed token back to pipe syntax (without the wrapping `{}`). */
+export declare const variableTokenToString: (t: IParsedVariableToken) => string;
+
 /** Viewport trigger configuration for entry animations */
 export declare interface ViewportConfig {
     once?: boolean;