@levo-so/studio 0.1.101 → 0.1.103

package/generateRadiusScale-BpcgkGtN.js

@@ -0,0 +1,71 @@
+//#region ../../libraries/levocn/dist/styles/theme/themeVars.cssm.js
+var e = {
+	colors: {
+		background: "var(--_1i5egzy0)",
+		foreground: "var(--_1i5egzy1)",
+		text: "var(--_1i5egzy2)",
+		heading: "var(--_1i5egzy3)",
+		card: "var(--_1i5egzy4)",
+		cardForeground: "var(--_1i5egzy5)",
+		popover: "var(--_1i5egzy6)",
+		popoverForeground: "var(--_1i5egzy7)",
+		primary: "var(--_1i5egzy8)",
+		primaryForeground: "var(--_1i5egzy9)",
+		secondary: "var(--_1i5egzya)",
+		secondaryForeground: "var(--_1i5egzyb)",
+		muted: "var(--_1i5egzyc)",
+		mutedForeground: "var(--_1i5egzyd)",
+		accent: "var(--_1i5egzye)",
+		accentForeground: "var(--_1i5egzyf)",
+		destructive: "var(--_1i5egzyg)",
+		border: "var(--_1i5egzyh)",
+		input: "var(--_1i5egzyi)",
+		inputForeground: "var(--_1i5egzyj)",
+		ring: "var(--_1i5egzyk)"
+	},
+	radius: "var(--_1i5egzyl)",
+	radiusScale: {
+		sm: "var(--_1i5egzym)",
+		base: "var(--_1i5egzyn)",
+		md: "var(--_1i5egzyo)",
+		lg: "var(--_1i5egzyp)",
+		xl: "var(--_1i5egzyq)",
+		"2xl": "var(--_1i5egzyr)",
+		"3xl": "var(--_1i5egzys)",
+		"4xl": "var(--_1i5egzyt)",
+		"5xl": "var(--_1i5egzyu)",
+		"6xl": "var(--_1i5egzyv)",
+		"7xl": "var(--_1i5egzyw)",
+		"8xl": "var(--_1i5egzyx)",
+		full: "var(--_1i5egzyy)"
+	},
+	baseFontSize: "var(--_1i5egzyz)",
+	fonts: {
+		body: "var(--_1i5egzy10)",
+		heading: "var(--_1i5egzy11)"
+	},
+	shadow: {
+		xs: "var(--_1i5egzy12)",
+		sm: "var(--_1i5egzy13)",
+		md: "var(--_1i5egzy14)",
+		lg: "var(--_1i5egzy15)",
+		xl: "var(--_1i5egzy16)",
+		inner: "var(--_1i5egzy17)"
+	}
+}, t = (e) => ({
+	sm: `calc(${e} * 0.5)`,
+	base: e,
+	md: `calc(${e} * 1.5)`,
+	lg: `calc(${e} * 2)`,
+	xl: `calc(${e} * 3)`,
+	"2xl": `calc(${e} * 4)`,
+	"3xl": `calc(${e} * 6)`,
+	"4xl": `calc(${e} * 8)`,
+	"5xl": `calc(${e} * 12)`,
+	"6xl": `calc(${e} * 16)`,
+	"7xl": `calc(${e} * 20)`,
+	"8xl": `calc(${e} * 24)`,
+	full: "100%"
+});
+//#endregion
+export { e as n, t };

package/getFieldValidations-CSkSV2hW.js

@@ -0,0 +1,90 @@
+import { FieldInterfaces as e } from "@levo-so/core";
+import { isValidPhoneNumber as t } from "react-phone-number-input";
+import * as n from "yup";
+//#region ../../libraries/react-collection/dist/utils/getFieldValidations.js
+var r = (r, i) => {
+	let a = (r?.label || r?.key || "")?.replace(/_/g, " ");
+	if (a?.endsWith("Id") && (a = a?.replace("Id", "")), a.includes(".")) {
+		let [e] = a.split(".");
+		e && (a = e);
+	}
+	let o = (e) => {
+		let t = e;
+		return r.max !== void 0 && r.max !== null && r.max !== "" && (t = t.max(Number(r.max), `The ${a} value is too large (max ${r.max})`)), r.min !== void 0 && r.min !== null && r.min !== "" && (t = t.min(Number(r.min), `The ${a} value is too small (min ${r.min})`)), t;
+	}, s;
+	switch (r.field_interface) {
+		case e.NumberWidget:
+			s = o(n.number());
+			break;
+		case e.ArrayWidget:
+			s = o(n.array().typeError("The field must be an array"));
+			break;
+		case e.RecordWidget:
+			s = n.object();
+			break;
+		case e.EmailWidget:
+			s = o(n.string().email("The email address is not valid"));
+			break;
+		case e.PhoneWidget:
+			s = o(n.string().test("phone", "The phone number has incorrect format", (e) => {
+				if (e) try {
+					return t(e);
+				} catch {
+					return !1;
+				}
+				return !0;
+			}));
+			break;
+		case e.URLWidget:
+			s = o(n.string().matches(/^(?:https?:\/\/)?(?:[a-zA-Z0-9-]+\.)*[a-zA-Z0-9-]+(?:\.[a-zA-Z]{2,})+(?:\/[^\s?#]*)?(?:\?[^\s]*)?$/, "The URL is not valid"));
+			break;
+		case e.ImageUploadWidget:
+		case e.FileUploadWidget:
+		case e.GeocoderWidget:
+			s = n.object();
+			break;
+		case e.MultiImageUploadWidget:
+		case e.MultiFileUploadWidget:
+		case e.MultiGeocoderWidget:
+			s = n.array().of(n.object());
+			break;
+		case e.JSONWidget:
+		case e.DropdownWidget:
+			s = n.string();
+			break;
+		case e.MultiTextWidget:
+		case e.MultiDropdownWidget:
+		case e.CheckboxWidget:
+			s = n.array().of(n.string());
+			break;
+		case e.ToggleCheckboxWidget:
+			s = n.boolean();
+			break;
+		case e.CollectionWidget:
+			s = r.options.current_have_many_connected ? n.array() : n.object();
+			break;
+		default:
+			s = o(n.string());
+			break;
+	}
+	if (r.options?.validationsPresets && Array.isArray(r.options.validationsPresets)) {
+		let t = r.options.validationsPresets;
+		(r.field_interface === e.TextWidget || r.field_interface === e.TextareaWidget) && (t.includes("exclude_special_chars") && (s = s.matches(/^[a-zA-Z0-9\s]*$/, "Special characters are not allowed")), t.includes("exclude_numbers") && (s = s.matches(/^[^0-9]*$/, "Numbers are not allowed")));
+	}
+	return {
+		required: {
+			value: !!r?.required,
+			message: `The ${a} field is required`
+		},
+		validate: (e) => {
+			if (r?.options?.disableValidation || e === "" || e == null) return !0;
+			try {
+				return s.validateSync(e), i ? i(e) : !0;
+			} catch (e) {
+				return e instanceof n.ValidationError ? e.message : !0;
+			}
+		}
+	};
+};
+//#endregion
+export { r as t };

package/index.d.ts

@@ -23,6 +23,7 @@ import { IMeta } from '@levo-so/core';
 import { IResponseMultiple } from '@levo-so/core';
 import { IResponseSingle } from '@levo-so/core';
 import { IWorkspace } from '@levo-so/core';
+import { JSONContent } from '@tiptap/core';
 import { JSX } from 'react/jsx-runtime';
 import { LazyExoticComponent } from 'react';
 import { LevoError } from '@levo-so/core';
@@ -96,12 +97,18 @@ export declare const AuthProvider: React.FC<{
 
 export declare function Avatar({ className, ...props }: React_2.ComponentProps<typeof Avatar_2.Root>): JSX.Element;
 
+export declare function AvatarBadge({ className, ...props }: React_2.ComponentProps<"span">): JSX.Element;
+
 export declare function AvatarFallback({ className, isActive, ...props }: React_2.ComponentProps<typeof Avatar_2.Fallback> & {
     isActive?: boolean;
 }): JSX.Element;
 
 export declare function AvatarFallbackV2({ className, ...props }: React_2.ComponentProps<typeof Avatar_2.Fallback>): JSX.Element;
 
+export declare function AvatarGroup({ className, ...props }: React_2.ComponentProps<"div">): JSX.Element;
+
+export declare function AvatarGroupCount({ className, ...props }: React_2.ComponentProps<"div">): JSX.Element;
+
 export declare function AvatarImage({ className, isActive, ...props }: React_2.ComponentProps<typeof Avatar_2.Image> & {
     isActive?: boolean;
 }): JSX.Element;
@@ -124,8 +131,6 @@ export declare interface BackgroundEffectConfig {
         frequency?: number;
         speed?: number;
         isInteractive?: boolean;
-        rows?: number;
-        cols?: number;
         gridSize?: number;
         hoverColor?: string;
         lineWidth?: number;
@@ -273,13 +278,15 @@ declare type BlockProviderInput = {
     parsedBlockData?: IBlockInstance;
     blockData?: IBlockInstance;
     pageContext?: IPageContext;
+    /** Per-source API response meta keyed by source identifier, parallel to pageContext */
+    pageMeta?: TPageMeta;
     blockContext?: IBlockContext;
     renderMode: IRenderMode;
     workspace_id: string;
     pageSource: IPage["source"];
 };
 
-export declare const BlockSourceModuleList: readonly ["collection", "event", "blog", "community", "context", "form"];
+export declare const BlockSourceModuleList: readonly ["collection", "event", "blog", "community", "context", "form", "blog_author", "blog_category", "blog_tag"];
 
 export declare class BlocksRegistry {
     private static instance;
@@ -506,6 +513,8 @@ export declare type ContentHint = {
 
 export declare type ContentUsecase = "main_title" | "sub_title" | "description" | "label" | "button" | "person_name" | "designation" | "testimonial" | "cta_button" | "price" | "currency" | "interval" | "feature" | "title" | "stat_number" | "stat_label" | "question" | "answer" | "category" | "date" | "reading_time" | "author" | "address" | "phone" | "email" | "link_url" | "link_text";
 
+export declare const convertHtmlToJSON: (html: string) => JSONContent;
+
 export declare const convertKeysToPascalCase: (key: string) => string;
 
 export declare const CreateForumPost: default_2.FC<ICreateForumPostProps>;
@@ -568,6 +577,8 @@ export declare const DEMO_SCHEMA: ILemaCollection;
 
 export declare const DevTools: React.FC<IDevToolsProps>;
 
+export declare const DevToolsPreview: React.FC<IDevToolsPreviewProps>;
+
 export declare const EditForm: WithBlockPropsComponent<BaseElementProps & {
 className?: string;
 initialValues?: Record<string, any>;
@@ -679,6 +690,17 @@ export declare const generateAccentColor: (oklch: OKLCHColor) => {
     hex: string;
 };
 
+/**
+ * Concatenates site-level and page-level `body_code` settings.
+ * Rendered at the end of the page body — typically used for tracking pixels,
+ * chat widgets, or any third-party script that must load after content.
+ */
+export declare const generateBodyContent: (pageData: {
+    settings?: {
+        body_code?: string;
+    };
+} | null | undefined, site: ISite | null | undefined) => string;
+
 export declare const generateDefaultContent: (contentSchema: any[]) => any;
 
 export declare const generateSchemaFromJSX: (jsx: string) => IBlock["content_schema"];
@@ -816,6 +838,7 @@ export declare const getPageSource: ({ levoClient, pageData, slugs, cookies, dra
     draft?: boolean;
 }) => Promise<{
     pageContext: IPageContext;
+    pageMeta: TPageMeta;
     pageNotFound: boolean;
 }>;
 
@@ -1127,6 +1150,12 @@ declare interface ICreateForumPostProps {
     onPostCreated?: (post: IForumPost) => void;
 }
 
+declare interface IDevToolsPreviewProps {
+    blockInstance: IBlockInstance;
+    blocks: Record<string, BlockComponent>;
+    theme?: ITheme;
+}
+
 export declare interface IDevToolsProps {
     schema: IBlock;
     component: React.ComponentType<any>;
@@ -1164,8 +1193,10 @@ export declare interface IFieldConfig {
         selected_fields?: string[];
     };
     action?: {
-        type: "page" | "external_link" | "email" | "phone" | "login" | "none";
+        type: "page" | "external_link" | "email" | "phone" | "login" | "popup" | "none";
+        /** For type "popup", holds the popup id to open. */
         value: string;
+        alt?: string;
         options: {
             openInNewTab?: boolean;
         };
@@ -1287,6 +1318,8 @@ export declare interface IInputProps extends IBaseInputProps {
     leftIconBoxStyles?: string;
     rightIconBoxStyles?: string;
     inputContainerStyles?: string;
+    leftIconBoxProps?: Omit<React_2.ComponentProps<"div">, "children" | "className">;
+    rightIconBoxProps?: Omit<React_2.ComponentProps<"div">, "children" | "className">;
 }
 
 declare interface IJoinRequestFormProps {
@@ -1297,6 +1330,12 @@ declare interface IJoinRequestFormProps {
     className?: string;
 }
 
+declare interface IJsonEditorProps {
+    label: string;
+    value: Record<string, any>;
+    onChange: (value: Record<string, any>) => void;
+}
+
 declare interface ILazyMotionProviderProps {
     children: ReactNode;
     /** Enforce m component usage - throws if motion component is used */
@@ -1380,7 +1419,7 @@ declare interface ILevoFormContext {
     preview?: boolean;
 }
 
-export declare type ILevoPageData = Pick<IPageExpanded, "id" | "workspace_id" | "blocks" | "source" | "title" | "description" | "access" | "style_config">;
+export declare type ILevoPageData = Pick<IPageExpanded, "id" | "workspace_id" | "blocks" | "source" | "title" | "description" | "access" | "style_config" | "settings">;
 
 export declare interface ILevoPageProps {
     pageData: ILevoPageData;
@@ -1391,6 +1430,7 @@ export declare interface ILevoPageProps {
     workspace: IWorkspace;
     site: ISite;
     authOverride?: IAuthOverride | null;
+    disableBranding?: boolean;
 }
 
 export declare interface ILocalizedPage {
@@ -1402,6 +1442,10 @@ export declare interface ILocalizedPage {
     url?: string;
 }
 
+declare interface IMadeWithLevoProps {
+    site: ISite;
+}
+
 declare const Image_2: WithBlockPropsComponent<Omit<BaseImageProps, "ref"> & RefAttributes<HTMLImageElement>>;
 export { Image_2 as Image }
 
@@ -1567,6 +1611,7 @@ export declare type IPageContext = Record<string, unknown>;
 
 export declare interface IPageDataContext {
     page?: IPageContext;
+    meta?: TPageMeta;
     blocks: Record<string, IBlockContext>;
 }
 
@@ -1587,7 +1632,7 @@ export declare interface IPageFromPath {
     access: IPageAccessCheck | null;
 }
 
-export declare type IPageKind = "blog.page" | "collection.page" | "community.page" | "event.page" | "static";
+export declare type IPageKind = "blog.page" | "blog.author.page" | "blog.category.page" | "blog.tag.page" | "collection.page" | "community.page" | "event.page" | "static";
 
 export declare interface IPageMeta {
     meta_title: string;
@@ -1603,6 +1648,8 @@ export declare interface IPageMeta {
 
 export declare interface IPageSettings {
     structured_data_json?: string;
+    head_code?: string;
+    body_code?: string;
     [key: string]: any;
 }
 
@@ -1624,6 +1671,17 @@ declare interface IPendingRequestStateProps {
     className?: string;
 }
 
+declare interface IPopupLoaderProps {
+    siteId?: string;
+    /**
+     * Id of the page definition currently being rendered. Levo-hosted sites
+     * know this at render time and should pass it through so page-bound
+     * targeting rules (e.g. "show on all blog posts") can match.
+     * External-site SDK consumers leave this undefined.
+     */
+    pageId?: string;
+}
+
 export declare interface IPostActionsLoadingState {
     engagements?: boolean;
     comments?: boolean;
@@ -1713,6 +1771,7 @@ export declare interface ISite {
     theme: ITheme;
     settings: {
         head_code?: string;
+        body_code?: string;
         studio_preview_url?: string;
         staging_preview_url?: string;
         contact_info?: IContactInfo;
@@ -1812,8 +1871,10 @@ export declare type IStudioSource = {
     field_key: string;
     params?: Record<string, any>;
     options?: {
-        sub_module?: "popular_posts" | "related_posts";
-        blog_id?: string;
+        sub_module?: "latest_posts" | "popular_posts" | "related_posts" | "author_posts" | "category_posts" | "tag_posts";
+        post_id?: string;
+        /** Blog slug for the blog_author module */
+        blog_identifier?: string;
         context_key?: string;
         filters?: {
             enabled?: boolean;
@@ -2097,6 +2158,8 @@ declare type IWidgetRegistry = Record<(typeof CommonFieldInterfacesList)[number]
  */
 export declare const JoinRequestForm: default_2.FC<IJoinRequestFormProps>;
 
+export declare const JsonEditor: React.FC<IJsonEditorProps>;
+
 export declare function Kbd({ className, ...props }: React.ComponentProps<"kbd">): JSX.Element;
 
 export declare function KbdGroup({ className, ...props }: React.ComponentProps<"div">): JSX.Element;
@@ -2111,7 +2174,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, 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, }: LevoBlockProps) => JSX.Element>;
 
 declare interface LevoBlockProps {
     html_id?: string;
@@ -2121,6 +2184,7 @@ declare interface LevoBlockProps {
     workspace_id: string;
     blockData?: IBlockInstance;
     pageContext?: IPageContext;
+    pageMeta?: TPageMeta;
     blockContext?: IPageDataContext["blocks"][number];
     pageSource?: IPage["source"];
 }
@@ -2129,6 +2193,13 @@ export declare const LevoPage: default_2.FC<ILevoPageProps>;
 
 export declare const Link: WithBlockPropsComponent<BaseLinkProps & RefAttributes<HTMLAnchorElement>>;
 
+/**
+ * "Made with Levo" badge fixed to the bottom-right of a rendered page,
+ * with a click-through promotional popup. Gated by `workspace.feature_flag.branding`
+ * at the call site (LevoPage).
+ */
+export declare const MadeWithLevo: React.FC<IMadeWithLevoProps>;
+
 export declare const Media: WithBlockPropsComponent<(Omit<BaseMediaProps & HTMLImageProps_2 & {
 isVideo?: false;
 }, "ref"> | Omit<BaseMediaProps & HTMLVideoProps & {
@@ -2288,6 +2359,15 @@ export declare const PopoverRoot: React_2.FC<Popover.PopoverProps>;
 
 export declare const PopoverTrigger: WithBlockPropsComponent<BasePopoverTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * Plug-and-play popup integration for React apps.
+ * Waits for identity context (session hydrated + identity resolved), then
+ * fetches active popups and lazy-loads the renderer only when popups exist.
+ * Works without insights network — gates on local readiness, not /welcome.
+ * Must be placed inside a `<LevoProvider>`.
+ */
+export declare const PopupLoader: React.FC<IPopupLoaderProps>;
+
 export declare const PostActions: default_2.FC<{
     post: IForumPost;
     postDetailPageURLPattern?: string | null;
@@ -2388,6 +2468,7 @@ declare interface PreviewHighlighterProps {
     isGenerationCancelled?: boolean;
     totalBlocksCount?: number;
     blocksGenerationInfo?: IBlockGenerationInfo[];
+    contrastColor?: "black" | "white";
 }
 
 /**
@@ -2666,6 +2747,9 @@ export declare const TooltipProvider: React_2.FC<Tooltip_2.TooltipProviderProps>
 
 export declare const TooltipTrigger: React_2.ForwardRefExoticComponent<Tooltip_2.TooltipTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
 
+/** Per-source API response meta (pagination counts, etc.) keyed by source identifier */
+export declare type TPageMeta = Record<string, unknown>;
+
 /** Transition configuration for animations */
 export declare interface TransitionConfig {
     type?: "spring" | "tween" | "keyframes";
@@ -2758,6 +2842,9 @@ export declare const useLogin: () => IUseLoginReturn;
 
 export declare const usePageContext: (module: IStudioSource["module"]) => any;
 
+/** Returns the API response meta (pagination counts, etc.) for the page-level source matching the given module */
+export declare const usePageMeta: (module: IStudioSource["module"]) => unknown;
+
 export declare const UserMenu: WithBlockPropsComponent<BaseUserMenuProps>;
 
 /**