@developer_tribe/react-builder 1.0.1 → 1.0.3

package/src/build-components/OnboardButtons/OnboardButtons.tsx

@@ -1,4 +1,4 @@
-import React, { useContext, useEffect, useState } from 'react';
+import React, { useContext, useEffect, useId, useMemo, useState } from 'react';
 import type { Node } from '../../types/Node';
 import type { OnboardButtonsComponentProps } from './OnboardButtonsProps.generated';
 import { onboardContext } from '../OnboardProvider/OnboardProvider';
@@ -6,12 +6,16 @@ import RenderNode from '../RenderNode.generated';
 import useNode from '../useNode';
 import { useRenderStore } from '../../store';
 import { useLogRender } from '../../utils/useLogRender';
+import { extractViewStyle } from '../../utils/extractViewStyle';
 
 function OnboardButtons({ node }: OnboardButtonsComponentProps) {
   useLogRender('OnboardButtons');
   node = useNode(node);
-  const { appConfig } = useRenderStore((s) => ({
+  const attributeName =
+    (node as any)?.sourceType ?? node.type ?? 'OnboardButtons';
+  const { appConfig, projectColors } = useRenderStore((s) => ({
     appConfig: s.appConfig,
+    projectColors: s.projectColors,
   }));
   const seperatorColorDefault =
     appConfig.theme === 'light'
@@ -26,13 +30,6 @@ function OnboardButtons({ node }: OnboardButtonsComponentProps) {
     }
   }, [ctx.selectedIndex]);
 
-  // New condition logic: hide when condition is carousel-index and does not match
-  const condition = (node.attributes as any)?.condition;
-  const conditionVariable = (node.attributes as any)?.conditionVariable;
-  if (condition === 'carousel-index' && typeof conditionVariable === 'number') {
-    if (conditionVariable !== selectedIndex) return null;
-  }
-
   const direction =
     node.attributes?.buttons_direction === 'column' ? 'column' : 'row';
   const seperatorColor =
@@ -47,8 +44,33 @@ function OnboardButtons({ node }: OnboardButtonsComponentProps) {
     return <RenderNode node={node.children as Node} />;
   };
 
+  const viewStyle = useMemo(
+    () => extractViewStyle(node, { appConfig, projectColors }),
+    [node, appConfig, projectColors],
+  );
+
+  // NOTE: Hooks must not be called conditionally.
+  // Generate the id before any early returns so the hook order stays stable.
+  const generatedId = useId();
+
+  // New condition logic: hide when condition is carousel-index and does not match
+  const condition = (node.attributes as any)?.condition;
+  const conditionVariable = (node.attributes as any)?.conditionVariable;
+  const shouldHide =
+    condition === 'carousel-index' &&
+    typeof conditionVariable === 'number' &&
+    conditionVariable !== selectedIndex;
+
+  if (shouldHide) {
+    return null;
+  }
+
   return (
-    <>
+    <div
+      attribute-name={attributeName}
+      attribute-key={node.key ?? generatedId}
+      style={viewStyle}
+    >
       <div
         className="onboard__separator"
         style={{
@@ -71,7 +93,7 @@ function OnboardButtons({ node }: OnboardButtonsComponentProps) {
       >
         {renderChildren()}
       </div>
-    </>
+    </div>
   );
 }
 

package/src/build-components/OnboardButtons/OnboardButtonsProps.generated.ts

@@ -2,6 +2,21 @@
 
 import type { NodeData } from '../../types/Node';
 
+export type FlexDirectionOptionType = 'row' | 'column';
+export type AlignItemsOptionType =
+  | 'flex-start'
+  | 'center'
+  | 'flex-end'
+  | 'stretch'
+  | 'baseline';
+export type JustifyContentOptionType =
+  | 'flex-start'
+  | 'center'
+  | 'flex-end'
+  | 'space-between'
+  | 'space-around'
+  | 'space-evenly';
+export type PositionOptionType = 'relative' | 'absolute';
 export type ButtonTypeOptionType =
   | 'previous_button'
   | 'next_button'
@@ -12,6 +27,34 @@ export type ConditionOptionType = 'carousel-index';
 export interface OnboardButtonsPropsGenerated {
   child: string;
   attributes: {
+    scrollable?: boolean;
+    flexDirection?: FlexDirectionOptionType;
+    alignItems?: AlignItemsOptionType;
+    justifyContent?: JustifyContentOptionType;
+    gap?: string;
+    padding?: string;
+    paddingHorizontal?: string;
+    paddingVertical?: string;
+    paddingTop?: string;
+    paddingBottom?: string;
+    paddingLeft?: string;
+    paddingRight?: string;
+    margin?: string;
+    marginVertical?: string;
+    marginTop?: string;
+    marginBottom?: string;
+    marginLeft?: string;
+    marginRight?: string;
+    backgroundColor?: string;
+    borderRadius?: string;
+    width?: string;
+    height?: string;
+    position?: PositionOptionType;
+    top?: string;
+    bottom?: string;
+    left?: string;
+    right?: string;
+    zIndex?: number;
     buttonType?: ButtonTypeOptionType;
     skipNumber?: number;
     buttons_direction?: ButtonsDirectionOptionType;

package/src/build-components/OnboardButtons/pattern.json

@@ -4,14 +4,80 @@
   "pattern": {
     "type": "OnboardButtons",
     "children": "node",
+    "extends": "View",
     "attributes": {
-      "buttonType": ["previous_button", "next_button", "skip_button"],
+      "buttonType": [
+        "previous_button",
+        "next_button",
+        "skip_button"
+      ],
       "skipNumber": "number",
-      "buttons_direction": ["row", "column"],
+      "buttons_direction": [
+        "row",
+        "column"
+      ],
       "forIndex": "number",
-      "seperatorColor": "string",
-      "condition": ["carousel-index"],
+      "seperatorColor": "color",
+      "condition": [
+        "carousel-index"
+      ],
       "conditionVariable": "number"
     }
+  },
+  "meta": {
+    "desiredParent": ["=OnboardItem"],
+    "label": "Onboard Buttons",
+    "description": "Wrapper for onboarding button set.",
+    "attributes": {
+      "buttonType": {
+        "label": "Button Type",
+        "description": "Which onboard button to show.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 1
+      },
+      "skipNumber": {
+        "label": "Skip Number",
+        "description": "Slide index to skip to.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 2
+      },
+      "buttons_direction": {
+        "label": "Buttons Direction",
+        "description": "Direction to lay out buttons.",
+        "category": "container",
+        "specialCategory": null,
+        "sort": 3
+      },
+      "forIndex": {
+        "label": "For Index",
+        "description": "Show only for this slide index.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 4
+      },
+      "seperatorColor": {
+        "label": "Seperator Color",
+        "description": "Color of the divider line.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 5
+      },
+      "condition": {
+        "label": "Condition",
+        "description": "Built-in condition to check.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 6
+      },
+      "conditionVariable": {
+        "label": "Condition Variable",
+        "description": "Value used when checking the condition.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 7
+      }
+    }
   }
 }

package/src/build-components/OnboardDot/OnboardDot.tsx

@@ -1,13 +1,122 @@
-import React from 'react';
-import type { OnboardDotComponentProps } from './OnboardExpandingDotProps.generated';
-import CarouselDots from '../CarouselDots/CarouselDots';
+import React, { useContext, useEffect, useId, useMemo, useState } from 'react';
+import type { OnboardDotComponentProps } from './OnboardDotProps.generated';
+import { onboardContext } from '../OnboardProvider/OnboardProvider';
 import useNode from '../useNode';
 import { useLogRender } from '../../utils/useLogRender';
+import { extractViewStyle } from '../../utils/extractViewStyle';
+import { useRenderStore } from '../../store';
 
 function OnboardDot({ node }: OnboardDotComponentProps) {
   useLogRender('OnboardDot');
+
   node = useNode(node);
-  return <CarouselDots node={{ ...node, type: 'carouselDots' } as any} />;
+
+  const generatedId = useId();
+  const attributeName = node.type ?? 'OnboardDot';
+  const attributeKey = node.key ?? generatedId;
+  const dotType = node.attributes?.dotType || 'normal_dot';
+  const GHOST_DOT_DARK_COLOR = '#E4E5E7';
+  const GHOST_DOT_LIGHT_COLOR = '#F7F7F9';
+  const { appConfig, projectColors } = useRenderStore((s) => ({
+    appConfig: s.appConfig,
+    projectColors: s.projectColors,
+  }));
+  const isDark = appConfig.theme === 'dark';
+
+  // OnboardDot specific attributes
+  const inactiveDotColor = isDark
+    ? GHOST_DOT_DARK_COLOR
+    : GHOST_DOT_LIGHT_COLOR;
+  const inactiveDotOpacity = node.attributes?.inactive_dot_opacity ?? 0.3;
+  const dotStyle = node.attributes?.dot_style;
+  const containerStyle = node.attributes?.container_style;
+  const activeDotColor = node.attributes?.active_dot_color;
+
+  const style = useMemo(() => {
+    const baseStyle = extractViewStyle(node, { appConfig, projectColors });
+    // Merge container_style if provided
+    if (containerStyle) {
+      try {
+        const parsedContainerStyle = JSON.parse(containerStyle);
+        Object.assign(baseStyle, parsedContainerStyle);
+      } catch (e) {
+        // Invalid JSON, ignore
+      }
+    }
+    return baseStyle;
+  }, [node, containerStyle, appConfig, projectColors]);
+
+  const onboardApi = useContext(onboardContext);
+  const emblaApi = onboardApi?.emblaApi;
+
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const [scrollSnaps, setScrollSnaps] = useState<number[]>([]);
+
+  useEffect(() => {
+    if (!emblaApi) return;
+    const snaps = emblaApi.scrollSnapList();
+    const selected = emblaApi.selectedScrollSnap();
+    setScrollSnaps(snaps);
+    setSelectedIndex(selected);
+
+    const onSelect = () => {
+      const sel = emblaApi.selectedScrollSnap();
+      setSelectedIndex(sel);
+    };
+    emblaApi.on('select', onSelect);
+
+    return () => {
+      if (emblaApi && emblaApi.off) {
+        emblaApi.off('select', onSelect);
+      }
+    };
+  }, [emblaApi]);
+
+  // Parse dot_style if provided
+  const parsedDotStyle = useMemo(() => {
+    if (!dotStyle) return {};
+    try {
+      return JSON.parse(dotStyle);
+    } catch (e) {
+      return {};
+    }
+  }, [dotStyle]);
+
+  return (
+    <div
+      attribute-name={attributeName}
+      attribute-key={attributeKey}
+      className={`embla__dots embla__dots--${dotType}`}
+      style={style}
+    >
+      {scrollSnaps.map((snap, index) => {
+        const isSelected = selectedIndex === index;
+        const dotStyles: React.CSSProperties = {
+          ...parsedDotStyle,
+          opacity: isSelected ? 1 : inactiveDotOpacity,
+        };
+
+        if (activeDotColor && isSelected) {
+          dotStyles.color = activeDotColor;
+        } else if (!isSelected) {
+          dotStyles.color = inactiveDotColor;
+        }
+
+        return (
+          <button
+            key={index}
+            onClick={() => {
+              emblaApi?.scrollTo(snap);
+            }}
+            className={`embla__dot ${isSelected ? 'embla__dot--selected' : ''}`}
+            style={dotStyles}
+          >
+            {isSelected ? '●' : '○'}
+          </button>
+        );
+      })}
+    </div>
+  );
 }
 
 export default React.memo(OnboardDot);

package/src/build-components/OnboardDot/OnboardDotProps.generated.ts

@@ -2,6 +2,7 @@
 
 import type { NodeData } from '../../types/Node';
 
+export type PositionOptionType = 'relative' | 'absolute';
 export type DotTypeOptionType =
   | 'expanding_dot'
   | 'normal_dot'
@@ -13,6 +14,34 @@ export type DotTypeOptionType =
 export interface OnboardDotPropsGenerated {
   child: string;
   attributes: {
+    scrollable?: boolean;
+    flexDirection?: never;
+    alignItems?: never;
+    justifyContent?: never;
+    gap?: string;
+    padding?: string;
+    paddingHorizontal?: string;
+    paddingVertical?: string;
+    paddingTop?: string;
+    paddingBottom?: string;
+    paddingLeft?: string;
+    paddingRight?: string;
+    margin?: string;
+    marginVertical?: string;
+    marginTop?: string;
+    marginBottom?: string;
+    marginLeft?: string;
+    marginRight?: string;
+    backgroundColor?: string;
+    borderRadius?: string;
+    width?: string;
+    height?: string;
+    position?: PositionOptionType;
+    top?: string;
+    bottom?: string;
+    left?: string;
+    right?: string;
+    zIndex?: number;
     dotType?: DotTypeOptionType;
     inactive_dot_opacity?: number;
     expanding_dot_width?: number;

package/src/build-components/OnboardDot/pattern.json

@@ -3,7 +3,8 @@
   "allowUnknownAttributes": false,
   "pattern": {
     "type": "OnboardDot",
-    "children": "node",
+    "children": "never",
+    "extends": "View",
     "attributes": {
       "dotType": [
         "expanding_dot",
@@ -17,7 +18,59 @@
       "expanding_dot_width": "number",
       "dot_style": "string",
       "container_style": "string",
-      "active_dot_color": "string"
+      "active_dot_color": "color",
+      "flexDirection": "never",
+      "alignItems": "never",
+      "justifyContent": "never"
+    }
+  },
+  "meta": {
+    "desiredParent": [">OnboardProvider"],
+    "label": "Onboard Dot",
+    "description": "Renders onboarding progress dots.",
+    "attributes": {
+      "dotType": {
+        "label": "Dot Type",
+        "description": "Dot animation style.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 1
+      },
+      "inactive_dot_opacity": {
+        "label": "Inactive Dot Opacity",
+        "description": "Opacity for inactive dots.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 2
+      },
+      "expanding_dot_width": {
+        "label": "Expanding Dot Width",
+        "description": "Width used while expanding.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 3
+      },
+      "dot_style": {
+        "label": "Dot Style",
+        "description": "Custom style for each dot.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 4
+      },
+      "container_style": {
+        "label": "Container Style",
+        "description": "Style for the dot wrapper.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 5
+      },
+      "active_dot_color": {
+        "label": "Active Dot Color",
+        "description": "Color of the active dot.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 6
+      }
     }
   }
 }

package/src/build-components/OnboardFooter/OnboardFooter.tsx

@@ -1,9 +1,10 @@
-import React from 'react';
+import React, { useId, useMemo } from 'react';
 import type { OnboardFooterComponentProps } from './OnboardFooterProps.generated';
 import useNode from '../useNode';
 import { useRenderStore } from '../../store';
 import { parseSize } from '../../size-matters';
 import { extractTextStyle } from '../../utils/extractTextStyle';
+import { extractViewStyle } from '../../utils/extractViewStyle';
 import { useLogRender } from '../../utils/useLogRender';
 
 type Segment =
@@ -89,15 +90,25 @@ function buildSegments(
 function OnboardFooter({ node }: OnboardFooterComponentProps) {
   useLogRender('OnboardFooter');
   node = useNode(node);
-  const { appConfig } = useRenderStore((s) => ({
+  const attributeName =
+    (node as any)?.sourceType ?? node.type ?? 'OnboardFooter';
+  const { appConfig, projectColors } = useRenderStore((s) => ({
     appConfig: s.appConfig,
+    projectColors: s.projectColors,
   }));
   const { localication, defaultLanguage } = appConfig;
   const t = (key?: string) =>
     key ? (localication?.[defaultLanguage ?? 'en']?.[key] ?? key) : '';
 
   const text = t(node?.attributes?.textLocalizationKey);
-  const style: React.CSSProperties = extractTextStyle(node);
+  const textStyle: React.CSSProperties = extractTextStyle(node, {
+    appConfig,
+    projectColors,
+  });
+  const viewStyle = useMemo(
+    () => extractViewStyle(node, { appConfig, projectColors }),
+    [node, appConfig, projectColors],
+  );
 
   const linkStyle = (color?: string): React.CSSProperties => ({
     color,
@@ -105,10 +116,15 @@ function OnboardFooter({ node }: OnboardFooterComponentProps) {
   });
 
   const paddingHorizontal = parseSize(node?.attributes?.paddingHorizontal);
+  const generatedId = useId();
+  const attributeKey = node.key ?? generatedId;
   return (
     <div
+      attribute-name={attributeName}
+      attribute-key={attributeKey}
       style={{
-        ...style,
+        ...viewStyle,
+        ...textStyle,
         paddingLeft: paddingHorizontal,
         paddingRight: paddingHorizontal,
         textAlign: 'center',

package/src/build-components/OnboardFooter/OnboardFooterProps.generated.ts

@@ -29,12 +29,13 @@ export type JustifyContentOptionType =
   | 'space-between'
   | 'space-around'
   | 'space-evenly';
+export type PositionOptionType = 'relative' | 'absolute';
 
 export interface OnboardFooterPropsGenerated {
   child: string;
   attributes: {
     color?: string;
-    fontSize?: number;
+    fontSize?: string;
     fontWeight?: FontWeightOptionType;
     textAlign?: TextAlignOptionType;
     scrollable?: boolean;
@@ -42,7 +43,7 @@ export interface OnboardFooterPropsGenerated {
     alignItems?: AlignItemsOptionType;
     justifyContent?: JustifyContentOptionType;
     gap?: string;
-    padding?: number;
+    padding?: string;
     paddingHorizontal?: string;
     paddingVertical?: string;
     paddingTop?: string;
@@ -50,7 +51,6 @@ export interface OnboardFooterPropsGenerated {
     paddingLeft?: string;
     paddingRight?: string;
     margin?: string;
-    marginHorizontal?: string;
     marginVertical?: string;
     marginTop?: string;
     marginBottom?: string;
@@ -58,8 +58,14 @@ export interface OnboardFooterPropsGenerated {
     marginRight?: string;
     backgroundColor?: string;
     borderRadius?: string;
-    width?: number;
-    height?: number;
+    width?: string;
+    height?: string;
+    position?: PositionOptionType;
+    top?: string;
+    bottom?: string;
+    left?: string;
+    right?: string;
+    zIndex?: number;
     textLocalizationKey?: string;
     linkedWordFirstLocalizationKey?: string;
     linkedWordFirstColor?: string;

package/src/build-components/OnboardFooter/pattern.json

@@ -8,14 +8,70 @@
     "attributes": {
       "textLocalizationKey": "string",
       "linkedWordFirstLocalizationKey": "string",
-      "linkedWordFirstColor": "string",
+      "linkedWordFirstColor": "color",
       "linkedWordFirstPage": "string",
       "linkedWordSecondLocalizationKey": "string",
-      "linkedWordSecondColor": "string",
+      "linkedWordSecondColor": "color",
       "linkedWordSecondPage": "string"
     }
   },
   "defaults": {
     "paddingHorizontal": "24@s"
+  },
+  "meta": {
+    "desiredParent": [">OnboardItem"],
+    "label": "Onboard Footer",
+    "description": "Footer text with optional links.",
+    "attributes": {
+      "textLocalizationKey": {
+        "label": "Text Localization Key",
+        "description": "Localization key for the footer text.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 1
+      },
+      "linkedWordFirstLocalizationKey": {
+        "label": "Linked Word First Localization Key",
+        "description": "Key for the first linked word.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 2
+      },
+      "linkedWordFirstColor": {
+        "label": "Linked Word First Color",
+        "description": "Color of the first linked word.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 3
+      },
+      "linkedWordFirstPage": {
+        "label": "Linked Word First Page",
+        "description": "Page opened by the first link.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 4
+      },
+      "linkedWordSecondLocalizationKey": {
+        "label": "Linked Word Second Localization Key",
+        "description": "Key for the second linked word.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 5
+      },
+      "linkedWordSecondColor": {
+        "label": "Linked Word Second Color",
+        "description": "Color of the second linked word.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 6
+      },
+      "linkedWordSecondPage": {
+        "label": "Linked Word Second Page",
+        "description": "Page opened by the second link.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 7
+      }
+    }
   }
 }