@seed-design/figma 1.1.0 → 1.1.3

package/src/codegen/targets/react/component/handlers/bottom-sheet.ts

@@ -28,9 +28,8 @@ export const createBottomSheetHandler = (_ctx: ComponentHandlerDeps) =>
       ...(props["Show Description#25192:0"].value === true && {
         description: props["Description#19787:7"].value,
       }),
-      ...(props["Show Close Button#19787:11"].value === false && {
-        hideCloseButton: true,
-      }),
+      showHandle: props["Show Handle#49774:6"].value,
+      showCloseButton: props["Show Close Button#19787:11"].value,
     };
 
     const bodyNodes = findAllInstances({

package/src/codegen/targets/react/component/handlers/error-state.ts

@@ -1,39 +1,51 @@
-import type { ActionButtonProperties, ErrorStateProperties } from "@/codegen/component-properties";
+import type {
+  ActionButtonGhostProperties,
+  ActionButtonProperties,
+  ErrorStateProperties,
+} from "@/codegen/component-properties";
 import { defineComponentHandler } from "@/codegen/core";
 import * as metadata from "@/entities/data/__generated__/component-sets";
 import { findAllInstances } from "@/utils/figma-node";
 import { camelCase } from "change-case";
 import { createLocalSnippetHelper } from "../../element-factories";
 import type { ComponentHandlerDeps } from "../deps.interface";
-import { createActionButtonHandler } from "./action-button";
+import { createActionButtonGhostHandler, createActionButtonHandler } from "./action-button";
 
 const { createLocalSnippetElement } = createLocalSnippetHelper("error-state");
 
 export const createErrorStateHandler = (ctx: ComponentHandlerDeps) => {
   const actionButtonHandler = createActionButtonHandler(ctx);
+  const ghostButtonHandler = createActionButtonGhostHandler(ctx);
 
   return defineComponentHandler<ErrorStateProperties>(
     metadata.templateErrorState.key,
     (node, traverse) => {
       const props = node.componentProperties;
 
-      const [actionButtonNode] = findAllInstances<ActionButtonProperties>({
+      const [actionButton] = findAllInstances<ActionButtonProperties>({
         node,
         key: actionButtonHandler.key,
       });
 
+      const [ghostButton] = findAllInstances<ActionButtonGhostProperties>({
+        node,
+        key: ghostButtonHandler.key,
+      });
+
       const commonProps = {
         variant: camelCase(props.Variant.value),
         ...(props.Layout.value === "With Title" && {
           title: props["Title#16237:0"].value,
         }),
         description: props["Description#16237:5"].value,
-        ...(actionButtonNode && {
+        ...(actionButton && {
           primaryActionProps: {
-            children: actionButtonHandler.transform(actionButtonNode, traverse).children[0],
+            children: actionButtonHandler.transform(actionButton, traverse).children[0],
           },
+        }),
+        ...(ghostButton && {
           secondaryActionProps: {
-            children: props["Secondary Action Label#17042:0"].value,
+            children: ghostButtonHandler.transform(ghostButton, traverse).children[0],
           },
         }),
       };

package/src/codegen/targets/react/component/handlers/field-button.ts

@@ -0,0 +1,197 @@
+import { defineComponentHandler } from "@/codegen/core";
+import * as sets from "@/entities/data/__generated__/component-sets";
+import * as components from "@/entities/data/__generated__/components";
+import { createLocalSnippetHelper } from "../../element-factories";
+import type { ComponentHandlerDeps } from "../deps.interface";
+import {
+  createFieldFooterHandler,
+  createFieldHeaderHandler,
+  FIELD_KEYS,
+  type FieldFooterProps,
+  type FieldHeaderProps,
+} from "@/codegen/targets/react/component/handlers/field";
+import type {
+  FieldHeaderProperties,
+  FieldFooterProperties,
+  FieldButtonProperties,
+  InputButtonProperties,
+  InputButtonPrefixProperties,
+  InputButtonSuffixProperties,
+  ActionButtonGhostProperties,
+  GenericFieldButtonProps,
+} from "@/codegen/component-properties";
+import { findAllInstances, findOne } from "@/utils/figma-node";
+import type { NormalizedTextNode } from "@/normalizer";
+
+const { createLocalSnippetElement } = createLocalSnippetHelper("field-button");
+
+const INPUT_BUTTON_KEY = "965bdecb58755af9a08d60cc3c8d2d33b42e15f0";
+const INPUT_BUTTON_PREFIX_KEY = "12b40c736a098298c64ba16de85702b4b460d1f1";
+const INPUT_BUTTON_SUFFIX_KEY = "5dda27af9f4afafa471925c17acf97d81912877a";
+
+export const createFieldButtonHandler = (ctx: ComponentHandlerDeps) => {
+  const fieldHeaderHandler = createFieldHeaderHandler(ctx);
+  const fieldFooterHandler = createFieldFooterHandler(ctx);
+
+  return defineComponentHandler<FieldButtonProperties>(
+    sets.templateCustomPickerField.key,
+    (node, traverse) => {
+      const props = node.componentProperties;
+
+      const [inputButton] = findAllInstances<InputButtonProperties>({
+        node,
+        key: INPUT_BUTTON_KEY,
+      });
+
+      const [clearButton] = findAllInstances<ActionButtonGhostProperties>({
+        node,
+        key: sets.actionButtonGhostButton.key,
+      });
+
+      const [fieldHeader] = findAllInstances<FieldHeaderProperties>({
+        node,
+        key: FIELD_KEYS.HEADER,
+      });
+      const [fieldFooter] = findAllInstances<FieldFooterProperties>({
+        node,
+        key: FIELD_KEYS.FOOTER,
+      });
+
+      // maxGraphemeCount and required can't be props of FieldButton
+      const { required: __required, ...headerProps } =
+        props["Show Header#40606:8"].value && fieldHeader
+          ? (fieldHeaderHandler.transform(fieldHeader, traverse).props as FieldHeaderProps)
+          : {};
+      const { maxGraphemeCount: __maxGraphemeCount, ...footerProps } =
+        props["Show Footer#40606:9"].value && fieldFooter
+          ? (fieldFooterHandler.transform(fieldFooter, traverse).props as FieldFooterProps)
+          : {};
+
+      const [prefix] = findAllInstances<InputButtonPrefixProperties>({
+        node: inputButton,
+        key: INPUT_BUTTON_PREFIX_KEY,
+      });
+
+      const [suffix] = findAllInstances<InputButtonSuffixProperties>({
+        node: inputButton,
+        key: INPUT_BUTTON_SUFFIX_KEY,
+      });
+
+      const commonProps = {
+        ...(inputButton.componentProperties.State.value === "Disabled" && {
+          disabled: true,
+        }),
+        ...((inputButton.componentProperties.State.value === "Error" ||
+          inputButton.componentProperties.State.value === "Error Pressed") && {
+          invalid: true,
+        }),
+        ...(clearButton && {
+          showClearButton: true,
+        }),
+        ...(inputButton.componentProperties["Has Prefix#32514:10"].value === true &&
+          prefix &&
+          prefix.componentProperties.Type.value === "Icon" && {
+            prefixIcon: ctx.iconHandler.transform(prefix.componentProperties["Icon#34021:2"]),
+          }),
+        ...(inputButton.componentProperties["Has Suffix#32865:68"].value === true &&
+          suffix &&
+          suffix.componentProperties["Type (Figma Only)"].value === "Icon" && {
+            suffixIcon: ctx.iconHandler.transform(suffix.componentProperties["Icon#37963:0"]),
+          }),
+        ...(inputButton.componentProperties["Has Suffix#32865:68"].value === true &&
+          suffix &&
+          suffix.componentProperties["Type (Figma Only)"].value === "Text" && {
+            suffix: suffix.componentProperties["Suffix Text#34021:4"].value,
+          }),
+      };
+
+      // these can be fragile but better than having 9 different handlers
+      const placeholder = findOne(
+        node,
+        (node) => node.type === "TEXT" && node.name.toLowerCase().includes("placeholder"),
+      ) as NormalizedTextNode;
+
+      const value = findOne(
+        node,
+        (node) => node.type === "TEXT" && node.name.toLowerCase().includes("value"),
+      ) as NormalizedTextNode;
+
+      return createLocalSnippetElement(
+        "FieldButton",
+        { ...headerProps, ...footerProps, ...commonProps },
+        props["Has Value"].value === "True" && value
+          ? createLocalSnippetElement("FieldButtonValue", undefined, value.characters)
+          : placeholder
+            ? createLocalSnippetElement("FieldButtonPlaceholder", undefined, placeholder.characters)
+            : undefined,
+        { comment: "buttonProps를 통해 aria-label을 제공하세요." },
+      );
+    },
+  );
+};
+
+// TODO: those 4 are basically the same
+
+export const createSelectFieldHandler = (ctx: ComponentHandlerDeps) => {
+  const fieldButtonHandler = createFieldButtonHandler(ctx);
+
+  return defineComponentHandler<GenericFieldButtonProps>(
+    components.templateSelectField.key,
+    (node, traverse) => {
+      const [fieldButton] = findAllInstances<FieldButtonProperties>({
+        node,
+        key: fieldButtonHandler.key,
+      });
+
+      return fieldButtonHandler.transform(fieldButton, traverse);
+    },
+  );
+};
+
+export const createDatePickerFieldHandler = (ctx: ComponentHandlerDeps) => {
+  const fieldButtonHandler = createFieldButtonHandler(ctx);
+
+  return defineComponentHandler<GenericFieldButtonProps>(
+    components.templateDatePickerField.key,
+    (node, traverse) => {
+      const [fieldButton] = findAllInstances<FieldButtonProperties>({
+        node,
+        key: fieldButtonHandler.key,
+      });
+
+      return fieldButtonHandler.transform(fieldButton, traverse);
+    },
+  );
+};
+
+export const createTimePickerFieldHandler = (ctx: ComponentHandlerDeps) => {
+  const fieldButtonHandler = createFieldButtonHandler(ctx);
+
+  return defineComponentHandler<GenericFieldButtonProps>(
+    components.templateTimePickerField.key,
+    (node, traverse) => {
+      const [fieldButton] = findAllInstances<FieldButtonProperties>({
+        node,
+        key: fieldButtonHandler.key,
+      });
+
+      return fieldButtonHandler.transform(fieldButton, traverse);
+    },
+  );
+};
+
+export const createAddressFieldHandler = (ctx: ComponentHandlerDeps) => {
+  const fieldButtonHandler = createFieldButtonHandler(ctx);
+
+  return defineComponentHandler<GenericFieldButtonProps>(
+    components.templateAddressPickerField.key,
+    (node, traverse) => {
+      const [fieldButton] = findAllInstances<FieldButtonProperties>({
+        node,
+        key: fieldButtonHandler.key,
+      });
+
+      return fieldButtonHandler.transform(fieldButton, traverse);
+    },
+  );
+};

package/src/codegen/targets/react/component/handlers/field.ts

@@ -0,0 +1,167 @@
+import type {
+  FieldCharacterCountProperties,
+  FieldFooterProperties,
+  FieldHeaderProperties,
+  FieldIndicatorProperties,
+} from "@/codegen/component-properties";
+import { defineComponentHandler } from "@/codegen/core";
+import { createSeedReactElement } from "../../element-factories";
+import type { ComponentHandlerDeps } from "../deps.interface";
+import { match } from "ts-pattern";
+import { findAllInstances } from "@/utils/figma-node";
+import { camelCase } from "change-case";
+
+const FIELD_HEADER_KEY = "84fe2e479c3291177662e41c71af29716e48789b";
+const FIELD_INDICATOR_KEY = "a0a170973212ea0cd952b45a8acb11a92561f402";
+const FIELD_FOOTER_KEY = "ab528f3b51a6dc529bb144de1495b07deef77ffa";
+const FIELD_CHARACTER_COUNT_KEY = "25dd9a96f4bf3b866b8713f6d8deec370eebfa72";
+
+export const FIELD_KEYS = {
+  HEADER: FIELD_HEADER_KEY,
+  FOOTER: FIELD_FOOTER_KEY,
+};
+
+export type FieldHeaderProps = FieldIndicatorProps & {
+  label?: string;
+  labelWeight?: string;
+};
+
+/**
+ * NOTE: only gives useful 'props' for field-related components but doesn't give fully functional code.
+ */
+export const createFieldHeaderHandler = (ctx: ComponentHandlerDeps) => {
+  const indicatorHandler = createFieldIndicatorHandler(ctx);
+
+  return defineComponentHandler<FieldHeaderProperties>(FIELD_HEADER_KEY, (node, traverse) => {
+    const { componentProperties: props } = node;
+
+    const [indicator] = findAllInstances<FieldIndicatorProperties>({
+      node,
+      key: FIELD_INDICATOR_KEY,
+    });
+
+    // only returns some nice common props for Slider, TextField and more
+    return createSeedReactElement("__FieldHeader__", {
+      label: props["Label#34796:0"].value,
+      labelWeight: camelCase(props.Weight.value),
+      ...(indicator &&
+        (indicatorHandler.transform(indicator, traverse).props as FieldIndicatorProps)),
+    } satisfies FieldHeaderProps);
+  });
+};
+
+type FieldIndicatorProps = {
+  required?: boolean;
+  showRequiredIndicator?: boolean;
+  indicator?: string;
+};
+
+/**
+ * NOTE: only gives useful 'props' for field-related components but doesn't give fully functional code.
+ */
+const createFieldIndicatorHandler = (_ctx: ComponentHandlerDeps) => {
+  return defineComponentHandler<FieldIndicatorProperties>(
+    FIELD_INDICATOR_KEY,
+    ({ componentProperties: props }) => {
+      const { required, showRequiredIndicator, indicator } = match(props.Type.value)
+        .with("Required Mark", () => ({
+          required: true,
+          showRequiredIndicator: true,
+          indicator: undefined,
+        }))
+        .with("Text", () => ({
+          required: undefined,
+          showRequiredIndicator: undefined,
+          indicator: props["Required Label#40606:3"].value,
+        }))
+        .exhaustive();
+
+      // only returns some nice common props for Slider, TextField and more
+      return createSeedReactElement("__FieldIndicator__", {
+        required,
+        showRequiredIndicator,
+        indicator,
+      } satisfies FieldIndicatorProps);
+    },
+  );
+};
+
+export type FieldFooterProps = FieldCharacterCountProps & {
+  description?: string;
+  maxGraphemeCount?: number;
+  invalid?: boolean;
+  errorMessage?: string;
+};
+
+/**
+ * NOTE: only gives useful 'props' for field-related components but doesn't give fully functional code.
+ */
+export const createFieldFooterHandler = (ctx: ComponentHandlerDeps) => {
+  const characterCountHandler = createFieldCharacterCountHandler(ctx);
+
+  return defineComponentHandler<FieldFooterProperties>(FIELD_FOOTER_KEY, (node, traverse) => {
+    const { componentProperties: props } = node;
+
+    const { description, maxGraphemeCount } = match(props.Type.value)
+      .with("Description", () => ({
+        description: props["Text#2770:0"].value,
+        maxGraphemeCount: undefined,
+      }))
+      .with("Description With Character Count", () => ({
+        description: props["Text#2770:0"].value,
+        maxGraphemeCount: undefined,
+      }))
+      .with("Character Count", () => {
+        const [characterCount] = findAllInstances<FieldCharacterCountProperties>({
+          node,
+          key: FIELD_CHARACTER_COUNT_KEY,
+        });
+
+        return {
+          description: undefined,
+          ...(characterCount &&
+            (characterCountHandler.transform(characterCount, traverse)
+              .props as FieldCharacterCountProps)),
+        };
+      })
+      .exhaustive();
+
+    const { errorMessage, invalid } = match(props.Error.value === "true")
+      .with(true, () => ({
+        invalid: true,
+        errorMessage: props["Error Text#32821:0"].value,
+      }))
+      .with(false, () => ({
+        invalid: undefined,
+        errorMessage: undefined,
+      }))
+      .exhaustive();
+
+    // only returns some nice common props for Slider, TextField and more
+    return createSeedReactElement("__FieldFooter__", {
+      description,
+      maxGraphemeCount,
+      invalid,
+      errorMessage,
+    } satisfies FieldFooterProps);
+  });
+};
+
+type FieldCharacterCountProps = {
+  maxGraphemeCount?: number;
+};
+
+/**
+ * NOTE: only gives useful 'props' for field-related components but doesn't give fully functional code.
+ */
+const createFieldCharacterCountHandler = (_ctx: ComponentHandlerDeps) => {
+  return defineComponentHandler<FieldCharacterCountProperties>(
+    FIELD_CHARACTER_COUNT_KEY,
+    ({ componentProperties: props }) => {
+      // only returns some nice common props for Slider, TextField and more
+      return createSeedReactElement("__FieldCharacterCount__", {
+        maxGraphemeCount: Number(props["Max Count#40960:4"].value),
+      } satisfies FieldCharacterCountProps);
+    },
+  );
+};

package/src/codegen/targets/react/component/handlers/legacy-text-field.ts

@@ -0,0 +1,196 @@
+import type {
+  LegacyMultilineTextFieldProperties,
+  LegacyTextFieldProperties,
+} from "@/codegen/component-properties";
+import { defineComponentHandler } from "@/codegen/core";
+import { createLocalSnippetHelper } from "../../element-factories";
+import type { ComponentHandlerDeps } from "../deps.interface";
+import { handleSizeProp } from "../size";
+
+const { createLocalSnippetElement } = createLocalSnippetHelper("text-field");
+
+const LEGACY_TEXT_FIELD_KEY = "c49873c37a639f0dffdea4efd0eb43760d66c141";
+const LEGACY_MULTILINE_TEXT_FIELD_KEY = "88b2399c930c85f9ce2972163a078bc684b84bbe";
+
+export const createLegacyTextFieldHandler = (ctx: ComponentHandlerDeps) =>
+  defineComponentHandler<LegacyTextFieldProperties>(
+    LEGACY_TEXT_FIELD_KEY,
+    ({ componentProperties: props }) => {
+      const {
+        Size: { value: size },
+        State: { value: state },
+        Filled: { value: filled },
+        "Show Header#870:0": { value: showHeader },
+        "Label#14964:0": { value: label },
+        "Show Indicator#1259:0": { value: showIndicator },
+        "Indicator#15327:249": { value: indicator },
+        "Show Prefix#958:125": { value: showPrefix },
+        "Show Prefix Icon#1267:50": { value: showPrefixIcon },
+        "Prefix Icon#1267:25": prefixIcon,
+        "Show Prefix Text#1267:0": { value: showPrefixText },
+        "Prefix Text#15327:101": { value: prefix },
+        "Placeholder#958:0": { value: placeholder },
+        "Filled Text#1304:0": { value: defaultValue },
+        "Show Suffix#958:100": { value: showSuffix },
+        "Show Suffix Icon#1267:75": { value: showSuffixIcon },
+        "Suffix Icon #1267:100": suffixIcon,
+        "Show Suffix Text#1267:125": { value: showSuffixText },
+        "Suffix Text#15327:138": { value: suffix },
+        "Show Footer#958:25": { value: showFooter },
+        "Show Description#958:50": { value: showDescription },
+        "Description#12626:5": { value: description },
+        "Show Character Count#958:75": { value: showCharacterCount },
+        "Character Count#15327:64": { value: _characterCount },
+        "Max Character Count#15327:27": { value: maxCharacterCount },
+      } = props;
+
+      const states = state.split("-");
+
+      const commonProps = {
+        size: handleSizeProp(size),
+        // header
+        ...(showHeader && {
+          label,
+        }),
+        ...(showHeader &&
+          showIndicator && {
+            indicator,
+          }),
+        // input affixes
+        ...(showPrefix &&
+          showPrefixIcon && {
+            prefixIcon: ctx.iconHandler.transform(prefixIcon),
+          }),
+        ...(showPrefix &&
+          showPrefixText && {
+            prefix,
+          }),
+        ...(showSuffix &&
+          showSuffixIcon && {
+            suffixIcon: ctx.iconHandler.transform(suffixIcon),
+          }),
+        ...(showSuffix &&
+          showSuffixText && {
+            suffix,
+          }),
+        // input
+        ...(filled === "True" && {
+          defaultValue,
+        }),
+        ...(states.includes("Invalid") && {
+          invalid: true,
+        }),
+        ...(states.includes("Disabled") && {
+          disabled: true,
+        }),
+        ...(states.includes("Read Only") && {
+          readOnly: true,
+        }),
+        // footer
+        ...(showFooter &&
+          showDescription &&
+          states.includes("Invalid") && {
+            // invalid인 경우 description을 error로 사용
+            errorMessage: description,
+          }),
+        ...(showFooter &&
+          showDescription &&
+          !states.includes("Invalid") && {
+            // invalid가 아닌 경우 description을 description으로 사용
+            description,
+          }),
+        ...(showFooter &&
+          showCharacterCount && {
+            maxGraphemeCount: Number(maxCharacterCount),
+          }),
+      };
+
+      const inputProps = {
+        placeholder,
+      };
+
+      const TextFieldChildren = createLocalSnippetElement("TextFieldInput", inputProps);
+
+      return createLocalSnippetElement("TextField", commonProps, TextFieldChildren, {
+        comment: "이 Figma 컴포넌트는 @seed-design/react@1.1보다 낮은 버전의 TextField입니다.",
+      });
+    },
+  );
+
+export const createLegacyMultilineTextFieldHandler = (_ctx: ComponentHandlerDeps) =>
+  defineComponentHandler<LegacyMultilineTextFieldProperties>(
+    LEGACY_MULTILINE_TEXT_FIELD_KEY,
+    ({ componentProperties: props }) => {
+      const {
+        Size: { value: size },
+        State: { value: state },
+        Filled: { value: filled },
+        "Show Header#870:0": { value: showHeader },
+        "Label#15327:323": { value: label },
+        "Show Indicator#1259:0": { value: showIndicator },
+        "Indicator#15327:286": { value: indicator },
+        "Placeholder#958:0": { value: placeholder },
+        "Filled Text#1304:0": { value: defaultValue },
+        "Show Footer#958:25": { value: showFooter },
+        "Show Description#958:50": { value: showDescription },
+        "Description#15327:212": { value: description },
+        "Show Character count#958:75": { value: showCharacterCount },
+        "Character Count#15327:360": { value: _characterCount },
+        "Max Character Count#15327:175": { value: maxCharacterCount },
+      } = props;
+
+      const states = state.split("-");
+
+      const commonProps = {
+        size: handleSizeProp(size),
+        // header
+        ...(showHeader && {
+          label,
+        }),
+        ...(showHeader &&
+          showIndicator && {
+            indicator,
+          }),
+        // input
+        ...(filled === "True" && {
+          defaultValue,
+        }),
+        ...(states.includes("Invalid") && {
+          invalid: true,
+        }),
+        ...(states.includes("Disabled") && {
+          disabled: true,
+        }),
+        ...(states.includes("Read Only") && {
+          readOnly: true,
+        }),
+        // footer
+        ...(showFooter &&
+          showDescription &&
+          states.includes("Invalid") && {
+            // invalid인 경우 description을 error로 사용
+            errorMessage: description,
+          }),
+        ...(showFooter &&
+          showDescription &&
+          !states.includes("Invalid") && {
+            // invalid가 아닌 경우 description을 description으로 사용
+            description,
+          }),
+        ...(showFooter &&
+          showCharacterCount && {
+            maxGraphemeCount: Number(maxCharacterCount),
+          }),
+      };
+
+      const inputProps = {
+        placeholder,
+      };
+
+      const TextFieldChildren = createLocalSnippetElement("TextFieldTextarea", inputProps);
+
+      return createLocalSnippetElement("TextField", commonProps, TextFieldChildren, {
+        comment: "이 Figma 컴포넌트는 @seed-design/react@1.1보다 낮은 버전의 TextField입니다.",
+      });
+    },
+  );