@seed-design/figma 1.2.0 → 1.3.2

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

@@ -0,0 +1,197 @@
+import { defineComponentHandler } from "@/codegen/core";
+import * as sets from "@/entities/data/__generated__/archive/component-sets";
+import * as components from "@/entities/data/__generated__/archive/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/archive/field";
+import type {
+  FieldHeaderProperties,
+  FieldFooterProperties,
+  FieldButtonProperties,
+  InputButtonProperties,
+  InputButtonPrefixProperties,
+  InputButtonSuffixProperties,
+  ActionButtonGhostProperties,
+  GenericFieldButtonProps,
+} from "@/codegen/component-properties.archive";
+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/archive/field.ts

@@ -0,0 +1,167 @@
+import type {
+  FieldCharacterCountProperties,
+  FieldFooterProperties,
+  FieldHeaderProperties,
+  FieldIndicatorProperties,
+} from "@/codegen/component-properties.archive";
+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/archive/floating-action-button.ts

@@ -0,0 +1,48 @@
+import type {
+  FloatingActionButtonButtonItemProperties,
+  FloatingActionButtonMenuItemProperties,
+  FloatingActionButtonProperties,
+} from "@/codegen/component-properties.archive";
+import { defineComponentHandler } from "@/codegen/core";
+import * as metadata from "@/entities/data/__generated__/archive/component-sets";
+import { createLocalSnippetHelper } from "../../../element-factories";
+import type { ComponentHandlerDeps } from "../../deps.interface";
+import { findAllInstances } from "@/utils/figma-node";
+
+const { createLocalSnippetElement } = createLocalSnippetHelper("floating-action-button");
+
+const BUTTON_TYPE_KEY = "8cecc85275115d653579d4c3156567ebf19f7b27";
+const MENU_TYPE_KEY = "400124347392c15473f9cd2d8a6aedb64f3baf36";
+
+export const createFloatingActionButtonHandler = (ctx: ComponentHandlerDeps) =>
+  defineComponentHandler<FloatingActionButtonProperties>(
+    metadata.floatingActionButton.key,
+    (node) => {
+      const [button] = findAllInstances<FloatingActionButtonButtonItemProperties>({
+        node,
+        key: BUTTON_TYPE_KEY,
+      });
+      const [menu] = findAllInstances<FloatingActionButtonMenuItemProperties>({
+        node,
+        key: MENU_TYPE_KEY,
+      });
+
+      const commonProps = (() => {
+        if (button)
+          return {
+            icon: ctx.iconHandler.transform(button.componentProperties["Icon#29766:18"]),
+            extended: button.componentProperties.Extended.value === "True",
+            label: button.componentProperties["Label#29808:0"].value,
+          };
+
+        if (menu)
+          return {
+            icon: ctx.iconHandler.transform(menu.componentProperties["Icon#29766:0"]),
+            extended: menu.componentProperties.Extended.value === "True",
+            label: menu.componentProperties["Label#29766:9"].value,
+          };
+      })();
+
+      return createLocalSnippetElement("FloatingActionButton", commonProps);
+    },
+  );

package/src/codegen/targets/react/component/handlers/archive/help-bubble.ts

@@ -0,0 +1,73 @@
+import type { HelpBubbleProperties } from "@/codegen/component-properties.archive";
+import { defineComponentHandler } from "@/codegen/core";
+import * as metadata from "@/entities/data/__generated__/archive/component-sets";
+import { createLocalSnippetHelper } from "../../../element-factories";
+import type { ComponentHandlerDeps } from "../../deps.interface";
+
+const { createLocalSnippetElement } = createLocalSnippetHelper("help-bubble");
+const { createLocalSnippetElement: createLocalSnippetElementTrigger } =
+  createLocalSnippetHelper("action-button");
+
+export const createHelpBubbleHandler = (_ctx: ComponentHandlerDeps) =>
+  defineComponentHandler<HelpBubbleProperties>(
+    metadata.helpBubble.key,
+    ({ componentProperties: props }) => {
+      const placement:
+        | "top"
+        | "right"
+        | "bottom"
+        | "left"
+        | "top-end"
+        | "top-start"
+        | "right-end"
+        | "right-start"
+        | "bottom-end"
+        | "bottom-start"
+        | "left-end"
+        | "left-start" = (() => {
+        switch (props.Placement.value) {
+          case "Bottom-Left":
+            return "top-start";
+          case "Bottom-Center":
+            return "top";
+          case "Bottom-Right":
+            return "top-end";
+          case "Left-Top":
+            return "right-start";
+          case "Left-Center":
+            return "right";
+          case "Left-Bottom":
+            return "right-end";
+          case "Top-Left":
+            return "bottom-start";
+          case "Top-Center":
+            return "bottom";
+          case "Top-Right":
+            return "bottom-end";
+          case "Right-Top":
+            return "left-start";
+          case "Right-Center":
+            return "left";
+          case "Right-Bottom":
+            return "left-end";
+        }
+      })();
+
+      const commonProps = {
+        title: props["Title#62535:0"].value,
+        ...(props["Show Description#62499:0"].value && {
+          description: props["Description#62535:98"].value,
+        }),
+        defaultOpen: true,
+        showCloseButton: props["Show Close Button#40538:0"].value,
+        placement,
+      };
+
+      return createLocalSnippetElement(
+        "HelpBubbleTrigger",
+        commonProps,
+        createLocalSnippetElementTrigger("ActionButton", {}, "HelpBubble 열기"),
+        { comment: "필요에 따라 HelpBubbleAnchor로 변경하여 사용하세요." },
+      );
+    },
+  );

package/src/codegen/targets/react/component/handlers/archive/identity-placeholder.ts

@@ -0,0 +1,21 @@
+import type { IdentityPlaceholderProperties } from "@/codegen/component-properties.archive";
+import { defineComponentHandler } from "@/codegen/core";
+import { camelCase } from "change-case";
+import { createLocalSnippetHelper } from "../../../element-factories";
+import type { ComponentHandlerDeps } from "../../deps.interface";
+
+const IDENTITY_PLACEHOLDER_KEY = "b3563b6f16ba4cfe4240c9b33eef7edad4c304eb";
+
+const { createLocalSnippetElement } = createLocalSnippetHelper("identity-placeholder");
+
+export const createIdentityPlaceholderHandler = (_ctx: ComponentHandlerDeps) =>
+  defineComponentHandler<IdentityPlaceholderProperties>(
+    IDENTITY_PLACEHOLDER_KEY,
+    ({ componentProperties: props }) => {
+      const commonProps = {
+        identity: camelCase(props.Identity.value),
+      };
+
+      return createLocalSnippetElement("IdentityPlaceholder", commonProps);
+    },
+  );

package/src/codegen/targets/react/component/handlers/archive/index.ts

@@ -0,0 +1,40 @@
+export * from "./action-button";
+export * from "./alert-dialog";
+export * from "./app-bar";
+export * from "./avatar";
+export * from "./avatar-stack";
+export * from "./badge";
+export * from "./bottom-sheet";
+export * from "./callout";
+export * from "./checkbox";
+export * from "./checkmark";
+export * from "./chip";
+export * from "./contextual-floating-button";
+export * from "./divider";
+export * from "./field-button";
+export * from "./floating-action-button";
+export * from "./help-bubble";
+export * from "./identity-placeholder";
+export * from "./legacy-select-box";
+export * from "./legacy-text-field";
+export * from "./list-header";
+export * from "./list-item";
+export * from "./manner-temp";
+export * from "./manner-temp-badge";
+export * from "./menu-sheet";
+export * from "./page-banner";
+export * from "./progress-circle";
+export * from "./radio-group";
+export * from "./radiomark";
+export * from "./reaction-button";
+export * from "./result-section";
+export * from "./segmented-control";
+export * from "./skeleton";
+export * from "./slider";
+export * from "./snackbar";
+export * from "./switch";
+export * from "./switchmark";
+export * from "./tabs";
+export * from "./tag-group";
+export * from "./text-field";
+export * from "./toggle-button";

package/src/codegen/targets/react/component/handlers/archive/legacy-select-box.ts

@@ -0,0 +1,89 @@
+import type {
+  LegacySelectBoxGroupProperties,
+  LegacySelectBoxProperties,
+} from "@/codegen/component-properties.archive";
+import { defineComponentHandler } from "@/codegen/core";
+import { findAllInstances } from "@/utils/figma-node";
+import { match } from "ts-pattern";
+import { createLocalSnippetHelper, createSeedReactElement } from "../../../element-factories";
+import type { ComponentHandlerDeps } from "../../deps.interface";
+
+const { createLocalSnippetElement } = createLocalSnippetHelper("select-box");
+
+const LEGACY_SELECT_BOX_KEY = "38722ffeb4c966256a709155e8ddac50c93d7c60";
+const LEGACY_SELECT_BOX_GROUP_KEY = "a3d58bb8540600878742cdcf2608a4b3851667ec";
+
+export const createLegacySelectBoxHandler = (_ctx: ComponentHandlerDeps) =>
+  defineComponentHandler<LegacySelectBoxProperties>(
+    LEGACY_SELECT_BOX_KEY,
+    ({ componentProperties: props }) => {
+      const tag = match(props.Control.value)
+        .with("Checkbox", () => "CheckSelectBox")
+        .with("Radio", () => "RadioSelectBoxItem")
+        .exhaustive();
+
+      const commonProps = {
+        label: props["Label#3635:0"].value,
+        ...(props["Show Description#3033:0"].value && {
+          description: props["Description #3033:5"].value,
+        }),
+        ...(tag === "RadioSelectBoxItem" && {
+          value: props["Label#3635:0"].value,
+        }),
+        ...(tag === "CheckSelectBox" &&
+          props.Selected.value === "True" && {
+            defaultChecked: true,
+          }),
+      };
+
+      return createLocalSnippetElement(tag, commonProps, undefined, {
+        comment:
+          "이 Figma 컴포넌트는 @seed-design/react@1.2보다 낮은 버전의 SelectBox입니다. 신규 컴포넌트로 교체할 수 있습니다.",
+      });
+    },
+  );
+
+export const createLegacySelectBoxGroupHandler = (ctx: ComponentHandlerDeps) => {
+  const selectBoxHandler = createLegacySelectBoxHandler(ctx);
+
+  return defineComponentHandler<LegacySelectBoxGroupProperties>(
+    LEGACY_SELECT_BOX_GROUP_KEY,
+    (node, traverse) => {
+      const props = node.componentProperties;
+
+      const tag = match(props.Control.value)
+        .with("Checkbox", () => "CheckSelectBoxGroup")
+        .with("Radio", () => "RadioSelectBoxRoot")
+        .exhaustive();
+
+      const selectBoxes = findAllInstances<LegacySelectBoxProperties>({
+        node,
+        key: selectBoxHandler.key,
+      });
+
+      const selectedSelectBox = selectBoxes.find(
+        (selectBox) => selectBox.componentProperties.Selected.value === "True",
+      );
+
+      // traverse the container like it's a frame
+      const vStackProps = traverse({ ...node, type: "FRAME" })?.props;
+
+      const stack = createSeedReactElement(
+        "VStack",
+        vStackProps,
+        selectBoxes.map((box) => selectBoxHandler.transform(box, traverse)),
+      );
+
+      const commonProps = {
+        ...(tag === "RadioSelectBoxRoot" && {
+          defaultValue: selectedSelectBox?.componentProperties["Label#3635:0"].value,
+        }),
+      };
+
+      return createLocalSnippetElement(tag, commonProps, stack, {
+        comment:
+          "이 Figma 컴포넌트는 @seed-design/react@1.2보다 낮은 버전의 SelectBox입니다. 신규 컴포넌트로 교체할 수 있습니다.",
+      });
+    },
+  );
+};