@rocapine/react-native-onboarding-ui 1.7.0 → 1.8.1

package/src/UI/Pages/ComposableScreen/elements/TextElement.tsx

@@ -0,0 +1,95 @@
+import React from "react";
+import { z } from "zod";
+import { Text } from "react-native";
+import { UIElement } from "../types";
+import { RenderContext, interpolate } from "./shared";
+
+export type TextElementProps = {
+  content: string;
+  mode?: "plain" | "expression";
+  fontSize?: number;
+  fontWeight?: string;
+  fontFamily?: string;
+  color?: string;
+  textAlign?: "left" | "center" | "right";
+  letterSpacing?: number;
+  lineHeight?: number;
+  backgroundColor?: string;
+  padding?: number;
+  paddingHorizontal?: number;
+  paddingVertical?: number;
+  margin?: number;
+  marginHorizontal?: number;
+  marginVertical?: number;
+  borderWidth?: number;
+  borderRadius?: number;
+  borderColor?: string;
+  opacity?: number;
+};
+
+export const TextElementPropsSchema = z.object({
+  content: z.string(),
+  mode: z.enum(["plain", "expression"]).optional(),
+  fontSize: z.number().optional(),
+  fontWeight: z.string().optional(),
+  fontFamily: z.string().optional(),
+  color: z.string().optional(),
+  textAlign: z.enum(["left", "center", "right"]).optional(),
+  letterSpacing: z.number().optional(),
+  lineHeight: z.number().optional(),
+  backgroundColor: z.string().optional(),
+  padding: z.number().optional(),
+  paddingHorizontal: z.number().optional(),
+  paddingVertical: z.number().optional(),
+  margin: z.number().optional(),
+  marginHorizontal: z.number().optional(),
+  marginVertical: z.number().optional(),
+  borderWidth: z.number().optional(),
+  borderRadius: z.number().optional(),
+  borderColor: z.string().optional(),
+  opacity: z.number().min(0).max(1).optional(),
+});
+
+type TextUIElement = Extract<UIElement, { type: "Text" }>;
+
+type Props = {
+  element: TextUIElement;
+  ctx: RenderContext;
+  parentType?: "XStack" | "YStack";
+};
+
+export const TextElementComponent = ({ element, ctx, parentType }: Props): React.ReactElement => {
+  const { theme, variables } = ctx;
+  const content =
+    element.props.mode === "expression"
+      ? interpolate(element.props.content, variables)
+      : element.props.content;
+
+  return (
+    <Text
+      style={{
+        fontSize: element.props.fontSize,
+        fontWeight: element.props.fontWeight as any,
+        fontFamily: element.props.fontFamily,
+        color: element.props.color ?? theme.colors.text.primary,
+        textAlign: element.props.textAlign,
+        letterSpacing: element.props.letterSpacing,
+        lineHeight: element.props.lineHeight,
+        backgroundColor: element.props.backgroundColor,
+        padding: element.props.padding,
+        paddingHorizontal: element.props.paddingHorizontal,
+        paddingVertical: element.props.paddingVertical,
+        margin: element.props.margin,
+        marginHorizontal: element.props.marginHorizontal,
+        marginVertical: element.props.marginVertical,
+        borderWidth: element.props.borderWidth,
+        borderRadius: element.props.borderRadius,
+        borderColor: element.props.borderColor,
+        opacity: element.props.opacity,
+        flexShrink: parentType === "XStack" ? 1 : undefined,
+      }}
+    >
+      {content}
+    </Text>
+  );
+};

package/src/UI/Pages/ComposableScreen/elements/VideoElement.tsx

@@ -0,0 +1,113 @@
+import React, { useEffect } from "react";
+import { z } from "zod";
+import { View, Text, StyleSheet } from "react-native";
+import { BaseBoxProps, BaseBoxPropsSchema } from "./BaseBoxProps";
+import { UIElement } from "../types";
+import { RenderContext } from "./shared";
+import { getTextStyle } from "../../../Theme/helpers";
+
+export type VideoElementProps = BaseBoxProps & {
+  url: string;
+  autoPlay?: boolean;
+  loop?: boolean;
+  muted?: boolean;
+  controls?: boolean;
+};
+
+export const VideoElementPropsSchema = BaseBoxPropsSchema.extend({
+  url: z.string().min(1, "url must not be empty"),
+  autoPlay: z.boolean().optional(),
+  loop: z.boolean().optional(),
+  muted: z.boolean().optional(),
+  controls: z.boolean().optional(),
+});
+
+type VideoUIElement = Extract<UIElement, { type: "Video" }>;
+
+let VideoElementComponent: React.ComponentType<{ element: VideoUIElement; style: object }> | null = null;
+try {
+  const { VideoView, useVideoPlayer } = require("expo-video");
+  VideoElementComponent = ({ element, style }: { element: VideoUIElement; style: object }) => {
+    const player = useVideoPlayer(element.props.url, (p: any) => {
+      p.loop = element.props.loop ?? false;
+      p.muted = element.props.muted ?? true;
+      if (element.props.autoPlay) p.play();
+    });
+
+    useEffect(() => {
+      player.loop = element.props.loop ?? false;
+      player.muted = element.props.muted ?? true;
+      if (element.props.autoPlay) {
+        player.play();
+      } else {
+        player.pause();
+      }
+    }, [element.props.loop, element.props.muted, element.props.autoPlay]);
+
+    return (
+      <VideoView
+        player={player}
+        style={style}
+        allowsFullscreen={false}
+        nativeControls={element.props.controls ?? false}
+      />
+    );
+  };
+} catch {
+  // expo-video not installed
+}
+
+type Props = {
+  element: VideoUIElement;
+  ctx: RenderContext;
+};
+
+export const VideoElementRenderer = ({ element, ctx }: Props): React.ReactElement => {
+  const { theme } = ctx;
+  const wrapperStyle = {
+    width: element.props.width ?? ("100%" as `${number}%`),
+    height: element.props.height ?? 200,
+    opacity: element.props.opacity,
+    margin: element.props.margin,
+    marginHorizontal: element.props.marginHorizontal,
+    marginVertical: element.props.marginVertical,
+    padding: element.props.padding,
+    paddingHorizontal: element.props.paddingHorizontal,
+    paddingVertical: element.props.paddingVertical,
+    borderWidth: element.props.borderWidth,
+    borderRadius: element.props.borderRadius,
+    borderColor: element.props.borderColor,
+    overflow: "hidden" as const,
+  };
+
+  if (!VideoElementComponent) {
+    return (
+      <View style={[wrapperStyle, styles.mediaFallback, { backgroundColor: theme.colors.neutral.lowest }]}>
+        <Text style={[styles.mediaFallbackText, getTextStyle(theme, "caption"), { color: theme.colors.text.tertiary }]}>
+          Install expo-video to render videos.
+        </Text>
+      </View>
+    );
+  }
+
+  return (
+    <View style={wrapperStyle}>
+      <VideoElementComponent element={element} style={styles.fill} />
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  fill: {
+    width: "100%",
+    height: "100%",
+  },
+  mediaFallback: {
+    alignItems: "center",
+    justifyContent: "center",
+  },
+  mediaFallbackText: {
+    textAlign: "center",
+    paddingHorizontal: 16,
+  },
+});

package/src/UI/Pages/ComposableScreen/elements/renderElement.tsx

@@ -0,0 +1,61 @@
+import React from "react";
+import { UIElement } from "../types";
+import { RenderContext } from "./shared";
+import { StackElementComponent } from "./StackElement";
+import { TextElementComponent } from "./TextElement";
+import { ImageElementComponent } from "./ImageElement";
+import { LottieElementComponent } from "./LottieElement";
+import { RiveElementRenderer } from "./RiveElement";
+import { IconElementComponent } from "./IconElement";
+import { VideoElementRenderer } from "./VideoElement";
+import { InputElementComponent } from "./InputElement";
+import { RadioGroupComponent } from "./RadioGroupElement";
+import { ButtonElementComponent } from "./ButtonElement";
+
+export const renderElement = (
+  element: UIElement,
+  ctx: RenderContext,
+  parentType?: "XStack" | "YStack"
+): React.ReactNode => {
+  if (element.type === "YStack" || element.type === "XStack") {
+    return <StackElementComponent key={element.id} element={element} ctx={ctx} parentType={parentType} />;
+  }
+
+  if (element.type === "Text") {
+    return <TextElementComponent key={element.id} element={element} ctx={ctx} parentType={parentType} />;
+  }
+
+  if (element.type === "Image") {
+    return <ImageElementComponent key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "Lottie") {
+    return <LottieElementComponent key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "Rive") {
+    return <RiveElementRenderer key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "Icon") {
+    return <IconElementComponent key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "Video") {
+    return <VideoElementRenderer key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "Input") {
+    return <InputElementComponent key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "RadioGroup") {
+    return <RadioGroupComponent key={element.id} element={element} ctx={ctx} />;
+  }
+
+  if (element.type === "Button") {
+    return <ButtonElementComponent key={element.id} element={element} ctx={ctx} />;
+  }
+
+  return null;
+};

package/src/UI/Pages/ComposableScreen/elements/shared.ts

@@ -0,0 +1,15 @@
+import React from "react";
+import { UIElement } from "../types";
+import { Theme } from "../../../Theme/types";
+import { ComposableVariableEntry } from "../../../Provider/OnboardingProgressProvider";
+
+export type RenderContext = {
+  theme: Theme;
+  variables: Record<string, ComposableVariableEntry>;
+  setVariable: (key: string, entry: ComposableVariableEntry) => void;
+  onContinue: () => void;
+  renderChildren: (elements: UIElement[], parentType: "XStack" | "YStack") => React.ReactNode;
+};
+
+export const interpolate = (template: string, variables: Record<string, ComposableVariableEntry>): string =>
+  template.replace(/\{\{([^}]+?)\}\}/g, (_, key) => variables[key]?.label ?? variables[key]?.value ?? "");

package/src/UI/Pages/ComposableScreen/types.ts

@@ -1,285 +1,94 @@
 import { z } from "zod";
 import { CustomPayloadSchema } from "../types";
+import { type StackElementProps, StackElementPropsSchema } from "./elements/StackElement";
+import { type TextElementProps, TextElementPropsSchema } from "./elements/TextElement";
+import { type ImageElementProps, ImageElementPropsSchema } from "./elements/ImageElement";
+import { type LottieElementProps, LottieElementPropsSchema } from "./elements/LottieElement";
+import { type RiveElementProps, RiveElementPropsSchema } from "./elements/RiveElement";
+import { type IconElementProps, IconElementPropsSchema } from "./elements/IconElement";
+import { type VideoElementProps, VideoElementPropsSchema } from "./elements/VideoElement";
+import { type InputElementProps, InputElementPropsSchema } from "./elements/InputElement";
+import { type ButtonElementProps, ButtonElementPropsSchema } from "./elements/ButtonElement";
+import { type RadioGroupElementProps, RadioGroupElementPropsSchema } from "./elements/RadioGroupElement";
 
-type BaseBoxProps = {
-  width?: number;
-  height?: number;
-  opacity?: number;
-  margin?: number;
-  marginHorizontal?: number;
-  marginVertical?: number;
-  padding?: number;
-  paddingHorizontal?: number;
-  paddingVertical?: number;
-  borderWidth?: number;
-  borderRadius?: number;
-  borderColor?: string;
-};
+export type { BaseBoxProps } from "./elements/BaseBoxProps";
+export { BaseBoxPropsSchema } from "./elements/BaseBoxProps";
+export type { StackElementProps } from "./elements/StackElement";
+export type { TextElementProps } from "./elements/TextElement";
+export type { ImageElementProps } from "./elements/ImageElement";
+export type { LottieElementProps } from "./elements/LottieElement";
+export type { RiveElementProps } from "./elements/RiveElement";
+export type { IconElementProps } from "./elements/IconElement";
+export type { VideoElementProps } from "./elements/VideoElement";
+export type { InputElementProps } from "./elements/InputElement";
+export type { ButtonElementProps } from "./elements/ButtonElement";
+export type { RadioGroupElementProps } from "./elements/RadioGroupElement";
 
+// UIElement union — must live here (not in elements/) to avoid circular deps
+// because the Stack variant's children: UIElement[] references itself.
 export type UIElement =
   | {
       id: string;
       name?: string;
       type: "YStack" | "XStack";
-      props: {
-        gap?: number;
-        padding?: number;
-        paddingHorizontal?: number;
-        paddingVertical?: number;
-        margin?: number;
-        marginHorizontal?: number;
-        marginVertical?: number;
-        flex?: number;
-        width?: number;
-        height?: number;
-        minWidth?: number;
-        maxWidth?: number;
-        minHeight?: number;
-        maxHeight?: number;
-        alignItems?: "flex-start" | "center" | "flex-end" | "stretch";
-        justifyContent?: "flex-start" | "center" | "flex-end" | "space-between" | "space-around";
-        backgroundColor?: string;
-        flexWrap?: "wrap" | "nowrap";
-        flexShrink?: number;
-        borderWidth?: number;
-        borderRadius?: number;
-        borderColor?: string;
-        overflow?: "hidden" | "visible" | "scroll";
-        opacity?: number;
-      };
+      props: StackElementProps;
       children: UIElement[];
     }
   | {
       id: string;
       name?: string;
       type: "Text";
-      props: {
-        content: string;
-        mode?: "plain" | "expression";
-        fontSize?: number;
-        fontWeight?: string;
-        fontFamily?: string;
-        color?: string;
-        textAlign?: "left" | "center" | "right";
-        letterSpacing?: number;
-        lineHeight?: number;
-        backgroundColor?: string;
-        padding?: number;
-        paddingHorizontal?: number;
-        paddingVertical?: number;
-        margin?: number;
-        marginHorizontal?: number;
-        marginVertical?: number;
-        borderWidth?: number;
-        borderRadius?: number;
-        borderColor?: string;
-        opacity?: number;
-      };
+      props: TextElementProps;
     }
   | {
       id: string;
       name?: string;
       type: "Image";
-      props: BaseBoxProps & {
-        url: string;
-        aspectRatio?: number;
-        resizeMode?: "cover" | "contain" | "stretch" | "center";
-      };
+      props: ImageElementProps;
     }
   | {
       id: string;
       name?: string;
       type: "Lottie";
-      props: BaseBoxProps & {
-        source: string;
-        autoPlay?: boolean;
-        loop?: boolean;
-        speed?: number;
-      };
+      props: LottieElementProps;
     }
   | {
       id: string;
       name?: string;
       type: "Rive";
-      props: BaseBoxProps & {
-        url: string;
-        autoplay?: boolean;
-        fit?: "Contain" | "Cover" | "Fill" | "FitWidth" | "FitHeight" | "None" | "ScaleDown" | "Layout";
-        alignment?: "TopLeft" | "TopCenter" | "TopRight" | "CenterLeft" | "Center" | "CenterRight" | "BottomLeft" | "BottomCenter" | "BottomRight";
-        artboardName?: string;
-        stateMachineName?: string;
-      };
+      props: RiveElementProps;
     }
   | {
       id: string;
       name?: string;
       type: "Icon";
-      props: BaseBoxProps & {
-        name: string;
-        size?: number;
-        color?: string;
-        strokeWidth?: number;
-      };
+      props: IconElementProps;
     }
   | {
       id: string;
       name?: string;
       type: "Video";
-      props: BaseBoxProps & {
-        url: string;
-        autoPlay?: boolean;
-        loop?: boolean;
-        muted?: boolean;
-        controls?: boolean;
-      };
+      props: VideoElementProps;
     }
   | {
       id: string;
       name?: string;
       type: "Input";
-      props: BaseBoxProps & {
-        variableName?: string;
-        placeholder?: string;
-        defaultValue?: string;
-        keyboardType?: "default" | "email-address" | "numeric" | "phone-pad" | "decimal-pad" | "url" | "number-pad" | "ascii-capable" | "numbers-and-punctuation" | "name-phone-pad" | "twitter" | "web-search" | "visible-password";
-        returnKeyType?: "done" | "next" | "go" | "search" | "send" | "default" | "emergency-call" | "google" | "join" | "route" | "yahoo" | "none" | "previous";
-        autoCapitalize?: "none" | "sentences" | "words" | "characters";
-        secureTextEntry?: boolean;
-        maxLength?: number;
-        multiline?: boolean;
-        numberOfLines?: number;
-        editable?: boolean;
-        color?: string;
-        backgroundColor?: string;
-        fontSize?: number;
-        fontWeight?: string;
-        textAlign?: "left" | "center" | "right";
-        placeholderColor?: string;
-      };
+      props: InputElementProps;
+    }
+  | {
+      id: string;
+      name?: string;
+      type: "Button";
+      props: ButtonElementProps;
+    }
+  | {
+      id: string;
+      name?: string;
+      type: "RadioGroup";
+      props: RadioGroupElementProps;
     };
 
-const BaseBoxPropsSchema = z.object({
-  width: z.number().optional(),
-  height: z.number().optional(),
-  opacity: z.number().min(0).max(1).optional(),
-  margin: z.number().optional(),
-  marginHorizontal: z.number().optional(),
-  marginVertical: z.number().optional(),
-  padding: z.number().optional(),
-  paddingHorizontal: z.number().optional(),
-  paddingVertical: z.number().optional(),
-  borderWidth: z.number().optional(),
-  borderRadius: z.number().optional(),
-  borderColor: z.string().optional(),
-});
-
-const StackElementPropsSchema = z.object({
-  gap: z.number().optional(),
-  padding: z.number().optional(),
-  paddingHorizontal: z.number().optional(),
-  paddingVertical: z.number().optional(),
-  margin: z.number().optional(),
-  marginHorizontal: z.number().optional(),
-  marginVertical: z.number().optional(),
-  flex: z.number().optional(),
-  width: z.number().optional(),
-  height: z.number().optional(),
-  minWidth: z.number().optional(),
-  maxWidth: z.number().optional(),
-  minHeight: z.number().optional(),
-  maxHeight: z.number().optional(),
-  alignItems: z.enum(["flex-start", "center", "flex-end", "stretch"]).optional(),
-  justifyContent: z.enum(["flex-start", "center", "flex-end", "space-between", "space-around"]).optional(),
-  backgroundColor: z.string().optional(),
-  flexWrap: z.enum(["wrap", "nowrap"]).optional(),
-  flexShrink: z.number().optional(),
-  borderWidth: z.number().optional(),
-  borderRadius: z.number().optional(),
-  borderColor: z.string().optional(),
-  overflow: z.enum(["hidden", "visible", "scroll"]).optional(),
-  opacity: z.number().min(0).max(1).optional(),
-});
-
-const TextElementPropsSchema = z.object({
-  content: z.string(),
-  mode: z.enum(["plain", "expression"]).optional(),
-  fontSize: z.number().optional(),
-  fontWeight: z.string().optional(),
-  fontFamily: z.string().optional(),
-  color: z.string().optional(),
-  textAlign: z.enum(["left", "center", "right"]).optional(),
-  letterSpacing: z.number().optional(),
-  lineHeight: z.number().optional(),
-  backgroundColor: z.string().optional(),
-  padding: z.number().optional(),
-  paddingHorizontal: z.number().optional(),
-  paddingVertical: z.number().optional(),
-  margin: z.number().optional(),
-  marginHorizontal: z.number().optional(),
-  marginVertical: z.number().optional(),
-  borderWidth: z.number().optional(),
-  borderRadius: z.number().optional(),
-  borderColor: z.string().optional(),
-  opacity: z.number().min(0).max(1).optional(),
-});
-
-const ImageElementPropsSchema = BaseBoxPropsSchema.extend({
-  url: z.string(),
-  aspectRatio: z.number().optional(),
-  resizeMode: z.enum(["cover", "contain", "stretch", "center"]).optional(),
-});
-
-const LottieElementPropsSchema = BaseBoxPropsSchema.extend({
-  source: z.string(),
-  autoPlay: z.boolean().optional(),
-  loop: z.boolean().optional(),
-  speed: z.number().optional(),
-});
-
-const RiveElementPropsSchema = BaseBoxPropsSchema.extend({
-  url: z.string(),
-  autoplay: z.boolean().optional(),
-  fit: z.enum(["Contain", "Cover", "Fill", "FitWidth", "FitHeight", "None", "ScaleDown", "Layout"]).optional(),
-  alignment: z.enum(["TopLeft", "TopCenter", "TopRight", "CenterLeft", "Center", "CenterRight", "BottomLeft", "BottomCenter", "BottomRight"]).optional(),
-  artboardName: z.string().optional(),
-  stateMachineName: z.string().optional(),
-});
-
-const IconElementPropsSchema = BaseBoxPropsSchema.extend({
-  name: z.string(),
-  size: z.number().optional(),
-  color: z.string().optional(),
-  strokeWidth: z.number().optional(),
-});
-
-const VideoElementPropsSchema = BaseBoxPropsSchema.extend({
-  url: z.string(),
-  autoPlay: z.boolean().optional(),
-  loop: z.boolean().optional(),
-  muted: z.boolean().optional(),
-  controls: z.boolean().optional(),
-});
-
-const InputElementPropsSchema = BaseBoxPropsSchema.extend({
-  variableName: z.string().optional(),
-  placeholder: z.string().optional(),
-  defaultValue: z.string().optional(),
-  keyboardType: z.enum(["default", "email-address", "numeric", "phone-pad", "decimal-pad", "url", "number-pad", "ascii-capable", "numbers-and-punctuation", "name-phone-pad", "twitter", "web-search", "visible-password"]).optional(),
-  returnKeyType: z.enum(["done", "next", "go", "search", "send", "default", "emergency-call", "google", "join", "route", "yahoo", "none", "previous"]).optional(),
-  autoCapitalize: z.enum(["none", "sentences", "words", "characters"]).optional(),
-  secureTextEntry: z.boolean().optional(),
-  maxLength: z.number().int().nonnegative().optional(),
-  multiline: z.boolean().optional(),
-  numberOfLines: z.number().int().nonnegative().optional(),
-  editable: z.boolean().optional(),
-  color: z.string().optional(),
-  backgroundColor: z.string().optional(),
-  fontSize: z.number().optional(),
-  fontWeight: z.string().optional(),
-  textAlign: z.enum(["left", "center", "right"]).optional(),
-  placeholderColor: z.string().optional(),
-});
-
 export const UIElementSchema: z.ZodType<UIElement> = z.lazy(() =>
   z.union([
     z.object({
@@ -331,6 +140,18 @@ export const UIElementSchema: z.ZodType<UIElement> = z.lazy(() =>
       type: z.literal("Input"),
       props: InputElementPropsSchema,
     }),
+    z.object({
+      id: z.string(),
+      name: z.string().optional(),
+      type: z.literal("Button"),
+      props: ButtonElementPropsSchema,
+    }),
+    z.object({
+      id: z.string(),
+      name: z.string().optional(),
+      type: z.literal("RadioGroup"),
+      props: RadioGroupElementPropsSchema,
+    }),
   ])
 );
 

package/src/UI/Provider/OnboardingProgressProvider.tsx

@@ -15,10 +15,11 @@ export const OnboardingProgressProvider = ({
     displayProgressHeader: false,
   });
   const [totalSteps, setTotalSteps] = useState(0);
-  const [composableVariables, setComposableVariables] = useState<Record<string, string>>({});
+  const [composableVariables, setComposableVariables] = useState<Record<string, ComposableVariableEntry>>({});
 
-  const setComposableVariable = useCallback((key: string, value: string) => {
-    setComposableVariables((prev) => ({ ...prev, [key]: value }));
+  const setComposableVariable = useCallback((key: string, entry: ComposableVariableEntry | string) => {
+    const normalizedEntry: ComposableVariableEntry = typeof entry === "string" ? { value: entry } : entry;
+    setComposableVariables((prev) => ({ ...prev, [key]: normalizedEntry }));
   }, []);
 
   return (
@@ -34,6 +35,8 @@ export const OnboardingProgressProvider = ({
   );
 };
 
+export type ComposableVariableEntry = { value: string; label?: string };
+
 export const OnboardingProgressContext = createContext({
   activeStep: { number: 0, displayProgressHeader: false },
   setActiveStep: (_step: {
@@ -42,6 +45,6 @@ export const OnboardingProgressContext = createContext({
   }) => { },
   totalSteps: 0,
   setTotalSteps: (_steps: number) => { },
-  composableVariables: {} as Record<string, string>,
-  setComposableVariable: (_key: string, _value: string) => { },
+  composableVariables: {} as Record<string, ComposableVariableEntry>,
+  setComposableVariable: (_key: string, _entry: ComposableVariableEntry | string) => { },
 });