@developer_tribe/react-builder 1.0.1 → 1.0.3

package/src/attributes-editor/LayoutPreviewPicker.tsx

@@ -0,0 +1,199 @@
+import React from 'react';
+import type { ViewPropsGenerated } from '../build-components/View/ViewProps.generated';
+import { LayoutContext, LayoutFieldName } from './types';
+
+type LayoutPreviewPickerProps = {
+  mode: LayoutFieldName;
+  options: string[];
+  value?: string;
+  onChange: (val?: string) => void;
+  layoutContext?: LayoutContext;
+  viewAttributes?: Partial<ViewPropsGenerated['attributes']>;
+};
+
+export function LayoutPreviewPicker({
+  mode,
+  options,
+  value,
+  onChange,
+  layoutContext,
+  viewAttributes,
+}: LayoutPreviewPickerProps) {
+  if (!options.length) {
+    return null;
+  }
+
+  const selectedValue =
+    typeof value === 'string'
+      ? value
+      : (layoutContext?.[mode as keyof LayoutContext] as string | undefined);
+
+  return (
+    <div
+      style={{
+        display: 'flex',
+        flexWrap: 'wrap',
+        gap: 6,
+        paddingBottom: 2,
+      }}
+    >
+      {options.map((option) => {
+        const isActive = selectedValue === option;
+        return (
+          <button
+            key={option}
+            type="button"
+            onClick={() => onChange(option)}
+            style={{
+              borderRadius: 8,
+              padding: 5,
+              width: 110,
+              flex: '0 0 auto',
+              border: isActive ? '2px solid #222' : '1px solid #d5d5d5',
+              background: '#fff',
+              textAlign: 'left',
+              display: 'flex',
+              flexDirection: 'column',
+              gap: 3,
+              cursor: 'pointer',
+              boxShadow: isActive ? '0 2px 4px rgba(0,0,0,0.08)' : 'none',
+            }}
+          >
+            <LayoutPreview
+              mode={mode}
+              option={option}
+              isActive={isActive}
+              layoutContext={layoutContext}
+              viewAttributes={viewAttributes}
+            />
+            <span style={{ fontWeight: 600, fontSize: 11 }}>
+              {formatLayoutLabel(option)}
+            </span>
+          </button>
+        );
+      })}
+    </div>
+  );
+}
+
+type LayoutPreviewProps = {
+  mode: LayoutFieldName;
+  option: string;
+  isActive: boolean;
+  layoutContext?: LayoutContext;
+  viewAttributes?: Partial<ViewPropsGenerated['attributes']>;
+};
+
+function LayoutPreview({
+  mode,
+  option,
+  isActive,
+  layoutContext,
+  viewAttributes,
+}: LayoutPreviewProps) {
+  const resolved = resolvePreviewContext(mode, option, layoutContext);
+  const isColumn = resolved.flexDirection?.startsWith('column');
+  const resolvedBackground =
+    viewAttributes?.backgroundColor ?? (isActive ? '#fffdf5' : '#fafafa');
+  const resolvedGap = parseNumeric(viewAttributes?.gap) ?? 3;
+  const resolvedBorderRadius = parseNumeric(viewAttributes?.borderRadius) ?? 4;
+
+  const stretchOverrides =
+    resolved.alignItems === 'stretch'
+      ? isColumn
+        ? { width: '100%' }
+        : { height: '100%' }
+      : undefined;
+
+  return (
+    <div
+      style={{
+        borderRadius: resolvedBorderRadius,
+        border: '1px dashed rgba(0,0,0,0.2)',
+        padding: 5,
+        background: resolvedBackground,
+      }}
+    >
+      <div
+        style={{
+          display: 'flex',
+          flexDirection: resolved.flexDirection ?? 'row',
+          justifyContent: resolved.justifyContent ?? 'flex-start',
+          alignItems: resolved.alignItems ?? 'stretch',
+          gap: resolvedGap,
+          width: '100%',
+          minHeight: isColumn ? 52 : 40,
+          transition: 'all 0.2s ease',
+        }}
+      >
+        {Array.from({ length: 3 }).map((_, idx) => (
+          <span
+            key={idx}
+            style={{
+              width: isColumn ? 22 : 10,
+              height: isColumn ? 10 : 10,
+              borderRadius: 2.5,
+              background: '#f7a500',
+              border: '1px solid rgba(0,0,0,0.1)',
+              flex: mode === 'justifyContent' ? '0 0 auto' : undefined,
+              ...(stretchOverrides ?? {}),
+            }}
+          />
+        ))}
+      </div>
+    </div>
+  );
+}
+
+function resolvePreviewContext(
+  mode: LayoutFieldName,
+  option: string,
+  layoutContext?: LayoutContext,
+): LayoutContext {
+  const fallback: LayoutContext = {
+    flexDirection: layoutContext?.flexDirection ?? 'row',
+    alignItems: layoutContext?.alignItems ?? 'center',
+    justifyContent: layoutContext?.justifyContent ?? 'flex-start',
+  };
+
+  switch (mode) {
+    case 'flexDirection':
+      return {
+        flexDirection: option as LayoutContext['flexDirection'],
+        alignItems: fallback.alignItems,
+        justifyContent: fallback.justifyContent,
+      };
+    case 'alignItems':
+      return {
+        flexDirection: fallback.flexDirection,
+        alignItems: option as LayoutContext['alignItems'],
+        justifyContent: fallback.justifyContent,
+      };
+    case 'justifyContent':
+      return {
+        flexDirection: fallback.flexDirection,
+        alignItems: fallback.alignItems,
+        justifyContent: option as LayoutContext['justifyContent'],
+      };
+    default:
+      return fallback;
+  }
+}
+
+function parseNumeric(value?: string | number | null) {
+  if (value === null || value === undefined) {
+    return undefined;
+  }
+  if (typeof value === 'number') {
+    return value;
+  }
+  const parsed = Number.parseFloat(value);
+  return Number.isNaN(parsed) ? undefined : parsed;
+}
+
+function formatLayoutLabel(option: string) {
+  return option
+    .replace(/[-_]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .replace(/^\w|\s\w/g, (char) => char.toUpperCase());
+}

package/src/attributes-editor/SpecialCategorySection.tsx

@@ -0,0 +1,285 @@
+import React, { useState } from 'react';
+import { NodeDefaultAttribute } from '../types/Node';
+import type { ProjectColors } from '../types/Project';
+import { Field } from './Field';
+import { FieldInfoTooltip } from './FieldInfoTooltip';
+import {
+  AttributeMetaMap,
+  LayoutContext,
+  SchemaEntry,
+  isBooleanFieldType,
+} from './types';
+
+type SpecialCategorySectionProps = {
+  category: string;
+  entries: SchemaEntry[];
+  attributeMeta?: AttributeMetaMap;
+  attributes: NodeDefaultAttribute;
+  onAttributeChange: (name: string, value: unknown) => void;
+  componentType?: string;
+  projectColors?: ProjectColors;
+  layoutContext?: LayoutContext;
+  viewAttributes?: NodeDefaultAttribute;
+  meta?: {
+    label?: string;
+    description?: string;
+  };
+};
+
+type BoxFieldSlot = 'top' | 'bottom' | 'left' | 'right';
+
+const FIELD_SLOT_MATCHERS: Record<BoxFieldSlot, RegExp> = {
+  top: /(^|[-_])(top)$/i,
+  bottom: /(^|[-_])(bottom)$/i,
+  left: /(^|[-_])(left)$/i,
+  right: /(^|[-_])(right)$/i,
+};
+
+export function SpecialCategorySection({
+  category,
+  entries,
+  attributeMeta,
+  attributes,
+  onAttributeChange,
+  componentType,
+  projectColors,
+  layoutContext,
+  viewAttributes,
+  meta,
+}: SpecialCategorySectionProps) {
+  const [showAdvanced, setShowAdvanced] = useState(false);
+  const normalizedTitle =
+    meta?.label && meta.label.trim().length > 0
+      ? meta.label
+      : category && category.length > 0
+        ? category.charAt(0).toUpperCase() + category.slice(1)
+        : 'Special';
+  const normalizedDescription = meta?.description;
+  const requiresAdvancedToggle =
+    category === 'padding' || category === 'margin' || category === 'offset';
+
+  const shouldUseBoxLayout = requiresAdvancedToggle;
+
+  const detectFieldSlot = (fieldName: string): BoxFieldSlot | undefined => {
+    if (!shouldUseBoxLayout) {
+      return undefined;
+    }
+    const normalized = fieldName
+      .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+      .replace(/\s+/g, '-')
+      .toLowerCase();
+    return (Object.keys(FIELD_SLOT_MATCHERS) as BoxFieldSlot[]).find((slot) =>
+      FIELD_SLOT_MATCHERS[slot].test(normalized),
+    );
+  };
+
+  const renderFields = () => {
+    if (!entries.length) {
+      return (
+        <p className="special-category-section__placeholder">
+          -- not defined --
+        </p>
+      );
+    }
+    const fieldsClassNames = [
+      'special-category-section__fields',
+      shouldUseBoxLayout ? 'special-category-section__fields--box' : '',
+    ]
+      .filter(Boolean)
+      .join(' ');
+    return (
+      <div className={fieldsClassNames}>
+        {entries.map(({ name, type }) => {
+          const label = attributeMeta?.[name]?.label ?? name;
+          const description = attributeMeta?.[name]?.description;
+          const preferredScale = attributeMeta?.[name]?.preferedScale;
+          const currentValue = (attributes as Record<string, unknown>)[name];
+          const isBoolean = isBooleanFieldType(type);
+          const fieldSlot = detectFieldSlot(name);
+          const wrapperClassNames = [
+            'attributes-editor__field-wrapper',
+            'special-category-section__field',
+            isBoolean ? 'attributes-editor__field-wrapper--boolean' : '',
+          ]
+            .filter(Boolean)
+            .join(' ');
+          return (
+            <FieldInfoTooltip key={name} description={description}>
+              <div className={wrapperClassNames} data-field-slot={fieldSlot}>
+                {!isBoolean ? (
+                  <p className="attributes-editor__field-label">{label}</p>
+                ) : null}
+                <Field
+                  name={name}
+                  type={type}
+                  value={currentValue}
+                  onChange={(val) => onAttributeChange(name, val)}
+                  componentType={componentType}
+                  projectColors={projectColors}
+                  layoutContext={layoutContext}
+                  viewAttributes={viewAttributes}
+                  label={isBoolean ? label : undefined}
+                  preferredScale={preferredScale}
+                />
+              </div>
+            </FieldInfoTooltip>
+          );
+        })}
+      </div>
+    );
+  };
+
+  const renderContent = () => {
+    if (!entries.length) {
+      return (
+        <p className="special-category-section__placeholder">
+          -- not defined --
+        </p>
+      );
+    }
+
+    if (!requiresAdvancedToggle) {
+      return renderFields();
+    }
+
+    // Separate directional fields (paddingTop, etc.) from shorthand fields (padding, paddingHorizontal, etc.)
+    const boxEntries = entries
+      .filter((entry) => detectFieldSlot(entry.name))
+      .sort((a, b) => {
+        const slotOrder: BoxFieldSlot[] = ['top', 'left', 'right', 'bottom'];
+        const slotA = detectFieldSlot(a.name);
+        const slotB = detectFieldSlot(b.name);
+        const indexA = slotA ? slotOrder.indexOf(slotA) : 999;
+        const indexB = slotB ? slotOrder.indexOf(slotB) : 999;
+        return indexA - indexB;
+      });
+    const baseEntries = entries.filter((entry) => !detectFieldSlot(entry.name));
+
+    if (boxEntries.length === 0) {
+      return (
+        <p className="special-category-section__placeholder">
+          -- not defined --
+        </p>
+      );
+    }
+
+    // Always show directional fields in box layout
+    const boxFieldsJSX = (
+      <div className="special-category-section__fields special-category-section__fields--box">
+        {boxEntries.map(({ name, type }) => {
+          const label = attributeMeta?.[name]?.label ?? name;
+          const description = attributeMeta?.[name]?.description;
+          const preferredScale = attributeMeta?.[name]?.preferedScale;
+          const currentValue = (attributes as Record<string, unknown>)[name];
+          const isBoolean = isBooleanFieldType(type);
+          const fieldSlot = detectFieldSlot(name);
+          const wrapperClassNames = [
+            'attributes-editor__field-wrapper',
+            'special-category-section__field',
+            isBoolean ? 'attributes-editor__field-wrapper--boolean' : '',
+          ]
+            .filter(Boolean)
+            .join(' ');
+          return (
+            <FieldInfoTooltip key={name} description={description}>
+              <div className={wrapperClassNames} data-field-slot={fieldSlot}>
+                {!isBoolean ? (
+                  <p className="attributes-editor__field-label">{label}</p>
+                ) : null}
+                <Field
+                  name={name}
+                  type={type}
+                  value={currentValue}
+                  onChange={(val) => onAttributeChange(name, val)}
+                  componentType={componentType}
+                  projectColors={projectColors}
+                  layoutContext={layoutContext}
+                  viewAttributes={viewAttributes}
+                  label={isBoolean ? label : undefined}
+                  preferredScale={preferredScale}
+                />
+              </div>
+            </FieldInfoTooltip>
+          );
+        })}
+      </div>
+    );
+
+    // Show shorthand fields only when advanced is toggled
+    const baseFieldsJSX =
+      showAdvanced && baseEntries.length > 0 ? (
+        <div className="special-category-section__fields">
+          {baseEntries.map(({ name, type }) => {
+            const label = attributeMeta?.[name]?.label ?? name;
+            const description = attributeMeta?.[name]?.description;
+            const preferredScale = attributeMeta?.[name]?.preferedScale;
+            const currentValue = (attributes as Record<string, unknown>)[name];
+            const isBoolean = isBooleanFieldType(type);
+            const wrapperClassNames = [
+              'attributes-editor__field-wrapper',
+              'special-category-section__field',
+              isBoolean ? 'attributes-editor__field-wrapper--boolean' : '',
+            ]
+              .filter(Boolean)
+              .join(' ');
+            return (
+              <FieldInfoTooltip key={name} description={description}>
+                <div className={wrapperClassNames}>
+                  {!isBoolean ? (
+                    <p className="attributes-editor__field-label">{label}</p>
+                  ) : null}
+                  <Field
+                    name={name}
+                    type={type}
+                    value={currentValue}
+                    onChange={(val) => onAttributeChange(name, val)}
+                    componentType={componentType}
+                    projectColors={projectColors}
+                    layoutContext={layoutContext}
+                    viewAttributes={viewAttributes}
+                    label={isBoolean ? label : undefined}
+                    preferredScale={preferredScale}
+                  />
+                </div>
+              </FieldInfoTooltip>
+            );
+          })}
+        </div>
+      ) : null;
+
+    return (
+      <>
+        {boxFieldsJSX}
+        {baseFieldsJSX}
+      </>
+    );
+  };
+
+  // Check if we have shorthand fields to show the toggle
+  const baseEntries = entries.filter((entry) => !detectFieldSlot(entry.name));
+  const shouldShowToggle = requiresAdvancedToggle && baseEntries.length > 0;
+
+  return (
+    <section className="special-category-section">
+      <div className="special-category-section__header">
+        <p className="special-category-section__title">{normalizedTitle}</p>
+        {shouldShowToggle ? (
+          <button
+            type="button"
+            onClick={() => setShowAdvanced((prev) => !prev)}
+            className="special-category-section__toggle"
+            data-active={showAdvanced}
+          >
+            {showAdvanced ? 'Hide advanced' : 'Show advanced'}
+          </button>
+        ) : null}
+      </div>
+      {normalizedDescription ? (
+        <p className="special-category-section__description">
+          {normalizedDescription}
+        </p>
+      ) : null}
+      {renderContent()}
+    </section>
+  );
+}

package/src/attributes-editor/types.ts

@@ -0,0 +1,30 @@
+import type {
+  AlignItemsOptionType,
+  FlexDirectionOptionType,
+  JustifyContentOptionType,
+} from '../build-components/View/ViewProps.generated';
+import { getAttributeMeta } from '../utils/patterns';
+
+export type SchemaEntry = {
+  name: string;
+  type: string | string[];
+};
+
+export type AttributeMetaMap = ReturnType<typeof getAttributeMeta>;
+
+export type LayoutFieldName = 'flexDirection' | 'alignItems' | 'justifyContent';
+
+export type LayoutContext = {
+  flexDirection?: FlexDirectionOptionType;
+  alignItems?: AlignItemsOptionType;
+  justifyContent?: JustifyContentOptionType;
+};
+
+const BOOLEAN_ALIASES = new Set(['bool', 'boolean']);
+
+export function isBooleanFieldType(type: string | string[]): boolean {
+  if (Array.isArray(type)) return false;
+  if (typeof type !== 'string') return false;
+  const normalized = type.trim().toLowerCase();
+  return BOOLEAN_ALIASES.has(normalized);
+}

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

@@ -0,0 +1,87 @@
+import React, { useId, useMemo } from 'react';
+import type { BackgroundImageComponentProps } from './BackgroundImageProps.generated';
+import useNode from '../useNode';
+import { useRenderStore } from '../../store';
+import { extractViewStyle } from '../../utils/extractViewStyle';
+import { useLogRender } from '../../utils/useLogRender';
+
+function BackgroundImage({ node }: BackgroundImageComponentProps) {
+  useLogRender('BackgroundImage');
+  node = useNode(node);
+  const generatedId = useId();
+  const attributeName =
+    (node as any)?.sourceType ?? node.type ?? 'background-image';
+  const attributeKey = node.key ?? generatedId;
+
+  const { previewMode, current, appConfig, projectColors } = useRenderStore(
+    (s) => ({
+      previewMode: s.previewMode,
+      current: s.current,
+      appConfig: s.appConfig,
+      projectColors: s.projectColors,
+    }),
+  );
+
+  const baseStyle = useMemo(
+    () => extractViewStyle(node, { appConfig, projectColors }),
+    [node, appConfig, projectColors],
+  );
+  const backgroundStyle = useMemo(() => {
+    const attrs = node.attributes;
+    const style: React.CSSProperties = {
+      backgroundRepeat: 'no-repeat',
+      backgroundPosition: 'center',
+    };
+
+    if (attrs?.src) {
+      style.backgroundImage = `url(${attrs.src})`;
+    }
+
+    switch (attrs?.resizeMode) {
+      case 'cover':
+        style.backgroundSize = 'cover';
+        break;
+      case 'contain':
+        style.backgroundSize = 'contain';
+        break;
+      case 'stretch':
+        style.backgroundSize = '100% 100%';
+        break;
+      case 'center':
+        style.backgroundSize = 'auto';
+        break;
+      default:
+        style.backgroundSize = 'cover';
+    }
+
+    return style;
+  }, [node]);
+  const isSelected =
+    previewMode &&
+    !!current &&
+    (current as any)?.key &&
+    (node as any)?.key &&
+    (current as any).key === (node as any).key;
+
+  const mergedStyle = useMemo(
+    () => ({
+      ...baseStyle,
+      ...backgroundStyle,
+    }),
+    [baseStyle, backgroundStyle],
+  );
+
+  const style = isSelected
+    ? { ...mergedStyle, outline: '2px solid #2684FF' }
+    : mergedStyle;
+
+  return (
+    <div
+      attribute-name={attributeName}
+      attribute-key={attributeKey}
+      style={style}
+    />
+  );
+}
+
+export default React.memo(BackgroundImage);

package/src/build-components/BackgroundImage/BackgroundImageProps.generated.ts

@@ -0,0 +1,60 @@
+/* AUTO-GENERATED FILE - DO NOT EDIT */
+
+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 ResizeModeOptionType = 'cover' | 'contain' | 'stretch' | 'center';
+
+export interface BackgroundImagePropsGenerated {
+  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;
+    src?: string;
+    resizeMode?: ResizeModeOptionType;
+  };
+}
+
+export interface BackgroundImageComponentProps {
+  node: NodeData<BackgroundImagePropsGenerated['attributes']>;
+}

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

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": 1,
+  "allowUnknownAttributes": false,
+  "pattern": {
+    "type": "background-image",
+    "children": "never",
+    "extends": "View",
+    "attributes": {
+      "src": "string",
+      "resizeMode": ["cover", "contain", "stretch", "center"]
+    },
+    "defaults": {
+      "resizeMode": "cover",
+      "width": "100%",
+      "height": "100%",
+      "position": "fixed",
+      "top": 0,
+      "left": 0,
+      "right": 0,
+      "bottom": 0,
+      "zIndex": 0
+    }
+  },
+  "meta": {
+    "desiredParent": ["all", "background"],
+    "label": "Background Image",
+    "description": "Background image.",
+    "attributes": {
+      "src": {
+        "label": "Src",
+        "description": "Image source URL.",
+        "category": "other",
+        "specialCategory": null,
+        "sort": 1
+      },
+      "resizeMode": {
+        "label": "Resize Mode",
+        "description": "How the image fits its container.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 4
+      }
+    }
+  }
+}