@developer_tribe/react-builder 1.0.1 → 1.0.2

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,284 @@
+import React, { useState } from 'react';
+import { NodeDefaultAttribute } from '../types/Node';
+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?: string[];
+  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/Button/Button.tsx

@@ -1,12 +1,20 @@
-import React from 'react';
+import React, { useMemo } from 'react';
 import type { ButtonComponentProps } from './ButtonProps.generated';
 import useNode from '../useNode';
 import { useLogRender } from '../../utils/useLogRender';
+import { extractViewStyle } from '../../utils/extractViewStyle';
 
 function Button({ node }: ButtonComponentProps) {
   useLogRender('Button');
   node = useNode(node);
-  return String(node?.type ?? 'button');
+  const attributeKey = (node as any)?.sourceType ?? node.type ?? 'button';
+  const style = useMemo(() => extractViewStyle(node), [node]);
+
+  return (
+    <div attribute-key={attributeKey} style={style}>
+      {String(node?.type ?? 'button')}
+    </div>
+  );
 }
 
 export default React.memo(Button);

package/src/build-components/Button/ButtonProps.generated.ts

@@ -2,6 +2,20 @@
 
 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 FontWeightOptionType =
   | 'normal'
   | 'bold'
@@ -18,8 +32,30 @@ export type FontWeightOptionType =
 export interface ButtonPropsGenerated {
   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;
     color?: string;
-    fontSize?: number;
+    fontSize?: string;
     fontWeight?: FontWeightOptionType;
   };
 }

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

@@ -4,9 +4,10 @@
   "pattern": {
     "type": "button",
     "children": "string",
+    "extends": "View",
     "attributes": {
-      "color": "string",
-      "fontSize": "number",
+      "color": "color",
+      "fontSize": "size",
       "fontWeight": [
         "normal",
         "bold",
@@ -21,5 +22,33 @@
         "900"
       ]
     }
+  },
+  "meta": {
+    "desiredParent": ["all"],
+    "label": "Button",
+    "description": "Simple action button.",
+    "attributes": {
+      "color": {
+        "label": "Color",
+        "description": "Text color of the button.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 1
+      },
+      "fontSize": {
+        "label": "Font Size",
+        "description": "Text size of the button.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 2
+      },
+      "fontWeight": {
+        "label": "Font Weight",
+        "description": "Text weight of the button.",
+        "category": "style",
+        "specialCategory": null,
+        "sort": 3
+      }
+    }
   }
 }

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

@@ -1,13 +1,16 @@
-import React from 'react';
+import React, { useMemo } from 'react';
 import type { CarouselComponentProps } from './CarouselProps.generated';
 import RenderNode from '../RenderNode.generated';
 import { isCarouselItem } from '../../utils/isCarousel';
 import useNode from '../useNode';
 import { useLogRender } from '../../utils/useLogRender';
+import { extractViewStyle } from '../../utils/extractViewStyle';
 
 function Carousel({ node }: CarouselComponentProps) {
   useLogRender('Carousel');
   node = useNode(node);
+  const attributeKey = (node as any)?.sourceType ?? node.type ?? 'carousel';
+  const style = useMemo(() => extractViewStyle(node), [node]);
   // Ensure children are carouselItems
   const renderChildren = () => {
     if (Array.isArray(node.children)) {
@@ -20,7 +23,17 @@ function Carousel({ node }: CarouselComponentProps) {
     ) : null;
   };
 
-  return <div className="embla__container">{renderChildren()}</div>;
+  //NOTE: I don't know how to force declare attribute-key. It must be added/checked manually.
+  //TODO: add to md file for agents
+  return (
+    <div
+      attribute-key={attributeKey}
+      className="embla__container"
+      style={style}
+    >
+      {renderChildren()}
+    </div>
+  );
 }
 
 export default React.memo(Carousel);