@levo-so/studio 0.1.109 → 0.1.111

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
  */
@@ -1498,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;
@@ -1512,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[];
@@ -2324,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.
  *
@@ -2332,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;
@@ -2345,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>;
@@ -3050,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