@levo-so/studio 0.1.107 → 0.1.109

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

@@ -402,8 +402,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 +541,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 +592,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 +630,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 +665,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 +850,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 +1129,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 +1197,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 +1221,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 +1320,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 +1461,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;
@@ -1551,7 +1620,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 +1646,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 +1686,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 +1780,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 +1826,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 +1908,10 @@ export declare interface ISite {
             twitter?: string;
             linkedin?: string;
             instagram?: string;
+            youtube?: string;
+            tiktok?: string;
+            pinterest?: string;
+            threads?: string;
         };
         [key: string]: any;
     };
@@ -2092,6 +2214,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 +2264,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
  *
@@ -2221,7 +2369,10 @@ declare type MediaContent = {
     srcset?: {
         path: string;
     };
-} | IMedia;
+    responsive?: IResponsiveImageContent;
+} | (IMedia & {
+    responsive?: IResponsiveImageContent;
+});
 
 declare type MediaContent_2 = {
     location: string;
@@ -2229,7 +2380,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 +2398,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 +2465,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 +2513,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 +2843,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 +2911,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 +2928,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 +2960,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";
 
@@ -2863,6 +3069,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;