@seed-design/react 0.0.0-alpha-20260324091316

package/src/components/ImageFrame/ImageFrame.test.tsx

@@ -0,0 +1,57 @@
+import { imageFrameReactionButton } from "@seed-design/css/recipes/image-frame-reaction-button";
+import { render } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { describe, expect, it } from "bun:test";
+import type { ReactElement } from "react";
+import { ImageFrameReactionButton } from "./ImageFrame";
+
+function setUp(jsx: ReactElement) {
+  return {
+    user: userEvent.setup(),
+    ...render(jsx),
+  };
+}
+
+describe("ImageFrame", () => {
+  describe("ImageFrameReactionButton", () => {
+    it("renders the unselected icon by default", () => {
+      const classNames = imageFrameReactionButton();
+      const { getByRole, container } = setUp(
+        <ImageFrameReactionButton aria-label="Like image" />,
+      );
+
+      const button = getByRole("button", { name: "Like image" });
+      const lineIcon = container.querySelector(`.${classNames.lineIcon}`);
+      const fillIcon = container.querySelector(`.${classNames.fillIcon}`);
+      const gradient = container.querySelector("linearGradient");
+
+      expect(button).toHaveAttribute("aria-pressed", "false");
+      expect(lineIcon).not.toBeNull();
+      expect(lineIcon).toHaveClass(classNames.lineIcon);
+      expect(fillIcon).toBeNull();
+      expect(gradient).toBeNull();
+      expect(lineIcon).not.toHaveAttribute("data-pressed");
+    });
+
+    it("switches to the selected icon on press", async () => {
+      const classNames = imageFrameReactionButton();
+      const { getByRole, container, user } = setUp(
+        <ImageFrameReactionButton aria-label="Like image" />,
+      );
+
+      const button = getByRole("button", { name: "Like image" });
+
+      await user.click(button);
+
+      const fillIcon = container.querySelector(`.${classNames.fillIcon}`);
+      const lineIcon = container.querySelector(`.${classNames.lineIcon}`);
+      const gradient = container.querySelector("linearGradient");
+
+      expect(button).toHaveAttribute("aria-pressed", "true");
+      expect(fillIcon).not.toBeNull();
+      expect(lineIcon).toBeNull();
+      expect(gradient).not.toBeNull();
+      expect(fillIcon).toHaveAttribute("data-pressed", "");
+    });
+  });
+});

package/src/components/ImageFrame/ImageFrame.tsx

@@ -0,0 +1,268 @@
+import {
+  imageFrame as imageFrameRecipe,
+  type ImageFrameVariantProps,
+} from "@seed-design/css/recipes/image-frame";
+import {
+  imageFrameIcon,
+  type ImageFrameIconVariantProps,
+} from "@seed-design/css/recipes/image-frame-icon";
+import {
+  imageFrameIndicator,
+  type ImageFrameIndicatorVariantProps,
+} from "@seed-design/css/recipes/image-frame-indicator";
+import { imageFrameReactionButton } from "@seed-design/css/recipes/image-frame-reaction-button";
+import { imageFrameFloater as floaterVars } from "@seed-design/css/vars/component";
+import { mergeProps } from "@seed-design/dom-utils";
+import { Image } from "@seed-design/react-image";
+import { Toggle as TogglePrimitive, useToggleContext } from "@seed-design/react-toggle";
+import clsx from "clsx";
+import * as React from "react";
+import { createSlotRecipeContext } from "../../utils/createSlotRecipeContext";
+import { AspectRatio, type AspectRatioProps } from "../AspectRatio/AspectRatio";
+import { Badge, type BadgeProps } from "../Badge/Badge";
+import { Float, type FloatProps } from "../Float/Float";
+import { Icon } from "../Icon/Icon";
+import { InternalIcon } from "../private/Icon";
+
+////////////////////////////////////////////////////////////////////////////////////
+
+export interface ImageFrameProps
+  extends Omit<AspectRatioProps, "children">,
+    ImageFrameVariantProps {
+  /**
+   * @deprecated Deprecated in `@seed-design/react@1.2.x`; will be removed in 1.3.0.
+   * Use borderRadius="r2" instead.
+   * Reason: 모서리 스타일은 borderRadius prop으로 통일합니다.
+   */
+  rounded?: ImageFrameVariantProps["rounded"];
+  src: string;
+  alt: string;
+  fallback?: React.ReactNode;
+  loading?: "eager" | "lazy";
+  decoding?: "async" | "auto" | "sync";
+  crossOrigin?: "anonymous" | "use-credentials" | "";
+  referrerPolicy?: React.HTMLAttributeReferrerPolicy;
+  sizes?: string;
+  srcSet?: string;
+  onLoad?: React.ReactEventHandler<HTMLImageElement>;
+  onError?: React.ReactEventHandler<HTMLImageElement>;
+  children?: React.ReactNode;
+}
+
+export const ImageFrame = React.forwardRef<HTMLDivElement, ImageFrameProps>(
+  (
+    {
+      ratio = 4 / 3,
+      src,
+      alt,
+      fallback,
+      className,
+      loading,
+      decoding,
+      crossOrigin,
+      referrerPolicy,
+      sizes,
+      srcSet,
+      onLoad,
+      onError,
+      children,
+      ...rest
+    },
+    ref,
+  ) => {
+    const [variantProps, restProps] = imageFrameRecipe.splitVariantProps(rest);
+    const classNames = imageFrameRecipe(variantProps);
+
+    return (
+      <AspectRatio ref={ref} ratio={ratio} className={className} {...restProps}>
+        <Image.Root className={classNames.root}>
+          <Image.Content
+            className={classNames.content}
+            src={src}
+            alt={alt}
+            loading={loading}
+            decoding={decoding}
+            crossOrigin={crossOrigin}
+            referrerPolicy={referrerPolicy}
+            sizes={sizes}
+            srcSet={srcSet}
+            onLoad={onLoad}
+            onError={onError}
+          />
+          {fallback && <Image.Fallback className={classNames.fallback}>{fallback}</Image.Fallback>}
+          {children}
+        </Image.Root>
+      </AspectRatio>
+    );
+  },
+);
+
+ImageFrame.displayName = "ImageFrame";
+
+////////////////////////////////////////////////////////////////////////////////////
+
+export interface ImageFrameFloaterProps extends FloatProps {}
+
+/**
+ * ImageFrame 내에서 오버레이 요소를 배치하기 위한 컴포넌트
+ *
+ * @remarks
+ * offsetX, offsetY 기본값은 rootage 스펙(image-frame-floater)에서 가져옵니다.
+ */
+export const ImageFrameFloater = React.forwardRef<HTMLDivElement, ImageFrameFloaterProps>(
+  (
+    {
+      offsetX = floaterVars.base.enabled.root.offset,
+      offsetY = floaterVars.base.enabled.root.offset,
+      ...rest
+    },
+    ref,
+  ) => {
+    return <Float ref={ref} offsetX={offsetX} offsetY={offsetY} {...rest} />;
+  },
+);
+
+ImageFrameFloater.displayName = "ImageFrameFloater";
+
+////////////////////////////////////////////////////////////////////////////////////
+
+export interface ImageFrameBadgeProps extends BadgeProps {}
+
+export const ImageFrameBadge = React.forwardRef<HTMLSpanElement, ImageFrameBadgeProps>(
+  (props, ref) => {
+    return <Badge ref={ref} {...props} />;
+  },
+);
+
+ImageFrameBadge.displayName = "ImageFrameBadge";
+
+////////////////////////////////////////////////////////////////////////////////////
+
+export interface ImageFrameIconProps
+  extends ImageFrameIconVariantProps,
+    Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+  svg: React.ReactNode;
+}
+
+export const ImageFrameIcon = React.forwardRef<HTMLSpanElement, ImageFrameIconProps>(
+  ({ svg, className, ...rest }, ref) => {
+    return (
+      <span ref={ref} className={clsx(imageFrameIcon(), className)} {...rest}>
+        <Icon svg={svg} />
+      </span>
+    );
+  },
+);
+
+ImageFrameIcon.displayName = "ImageFrameIcon";
+
+////////////////////////////////////////////////////////////////////////////////////
+
+export interface ImageFrameIndicatorProps
+  extends ImageFrameIndicatorVariantProps,
+    React.HTMLAttributes<HTMLSpanElement> {
+  children: React.ReactNode;
+}
+
+export const ImageFrameIndicator = React.forwardRef<HTMLSpanElement, ImageFrameIndicatorProps>(
+  ({ children, className, ...rest }, ref) => {
+    return (
+      <span ref={ref} className={clsx(imageFrameIndicator(), className)} {...rest}>
+        {children}
+      </span>
+    );
+  },
+);
+
+ImageFrameIndicator.displayName = "ImageFrameIndicator";
+
+////////////////////////////////////////////////////////////////////////////////////
+
+const {
+  ClassNamesProvider: ImageFrameReactionButtonClassNamesProvider,
+  useClassNames: useImageFrameReactionButtonClassNames,
+} = createSlotRecipeContext(imageFrameReactionButton);
+
+////////////////////////////////////////////////////////////////////////////////////
+
+const HeartFillPath =
+  "M15.5452 10C11.7873 10 9.25 12.9484 9.25 16.6267C9.25 19.8754 11.1219 22.0952 13.1877 23.969C13.7807 24.5069 14.4438 25.0617 15.095 25.6066C15.5434 25.9817 15.9862 26.3522 16.3967 26.7093C17.4501 27.6257 18.4191 28.557 19.1995 29.5994C19.3886 29.8518 19.6856 30.0003 20.001 30C20.3163 29.9997 20.6131 29.8507 20.8016 29.5979C21.5785 28.5562 22.5453 27.6253 23.598 26.7091C24.0105 26.35 24.4568 25.9766 24.9089 25.5984C25.5573 25.0559 26.2176 24.5035 26.807 23.9693C28.8739 22.096 30.75 19.8761 30.75 16.6267C30.75 12.9484 28.2127 10 24.4548 10C22.6365 10 21.1002 11.0545 20 12.4906C18.8998 11.0545 17.3635 10 15.5452 10Z";
+
+const HeartOutlineStrokePath =
+  "M15.5452 12C13.0342 12 11.25 13.905 11.25 16.6267C11.25 18.9912 12.5659 20.7048 14.5314 22.4876C15.1157 23.0176 15.7038 23.5087 16.3148 24.019C16.7646 24.3946 17.2269 24.7807 17.7093 25.2003C18.4947 25.8835 19.2814 26.6141 19.9988 27.4215C20.7144 26.614 21.5001 25.8836 22.2849 25.2005C22.7714 24.7771 23.2368 24.3885 23.6895 24.0105C24.2967 23.5035 24.8813 23.0154 25.4639 22.4874C27.4317 20.704 28.75 18.9906 28.75 16.6267C28.75 13.905 26.9658 12 24.4548 12C23.069 12 21.747 12.8325 20.8919 14.5189C20.7215 14.8549 20.3768 15.0667 20 15.0667C19.6233 15.0667 19.2785 14.8549 19.1081 14.5189C18.2531 12.8325 16.931 12 15.5452 12ZM9.25 16.6267C9.25 12.9484 11.7873 10 15.5452 10C17.3146 10 18.8683 10.8364 20 12.2306C21.1317 10.8364 22.6854 10 24.4548 10C28.2127 10 30.75 12.9484 30.75 16.6267C30.75 19.8761 28.8739 22.096 26.807 23.9693C26.2176 24.5035 25.5573 25.0559 24.9089 25.5984C24.4568 25.9766 24.0105 26.35 23.598 26.7091C22.5453 27.6253 21.5785 28.5562 20.8016 29.5979C20.6131 29.8507 20.3163 29.9997 20.001 30C19.6856 30.0003 19.3886 29.8518 19.1995 29.5994C18.4191 28.557 17.4501 27.6257 16.3967 26.7093C15.9862 26.3522 15.5434 25.9817 15.095 25.6066C14.4438 25.0617 13.7807 24.5069 13.1877 23.969C11.1219 22.0952 9.25 19.8754 9.25 16.6267Z";
+
+const HeartFillSvg = (props: React.SVGAttributes<SVGSVGElement>) => {
+  const id = React.useId();
+  const gradientId = `seed-heart-gradient${id.replace(/:/g, "")}`;
+
+  return (
+    <svg
+      width="100%"
+      height="100%"
+      viewBox="8 9 24 24"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      aria-hidden="true"
+      {...props}
+    >
+      <path d={HeartFillPath} fill={`url(#${gradientId})`} />
+      <defs>
+        <linearGradient
+          id={gradientId}
+          x1="7"
+          y1="8.5"
+          x2="26.0974"
+          y2="10.5391"
+          gradientUnits="userSpaceOnUse"
+        >
+          <stop stopColor="#FF9A56" />
+          <stop offset="1" stopColor="#FF6600" />
+        </linearGradient>
+      </defs>
+    </svg>
+  );
+};
+
+const HeartLineSvg = (props: React.SVGAttributes<SVGSVGElement>) => (
+  <svg
+    width="100%"
+    height="100%"
+    viewBox="8 9 24 24"
+    fill="none"
+    xmlns="http://www.w3.org/2000/svg"
+    aria-hidden="true"
+    {...props}
+  >
+    <path fillRule="evenodd" clipRule="evenodd" d={HeartOutlineStrokePath} fill="currentColor" />
+  </svg>
+);
+
+export interface ImageFrameReactionButtonProps
+  extends Omit<TogglePrimitive.RootProps, "children"> {}
+
+const ReactionButtonIcon = () => {
+  const { pressed, stateProps } = useToggleContext();
+  const classNames = useImageFrameReactionButtonClassNames();
+  const iconProps = mergeProps(stateProps, {
+    className: pressed ? classNames.fillIcon : classNames.lineIcon,
+  } as React.HTMLAttributes<HTMLElement>);
+
+  return <InternalIcon svg={pressed ? <HeartFillSvg /> : <HeartLineSvg />} {...iconProps} />;
+};
+
+export const ImageFrameReactionButton = React.forwardRef<
+  HTMLButtonElement,
+  ImageFrameReactionButtonProps
+>(({ className, ...rest }, ref) => {
+  const classNames = imageFrameReactionButton();
+
+  return (
+    <ImageFrameReactionButtonClassNamesProvider value={classNames}>
+      <TogglePrimitive.Root ref={ref} className={clsx(classNames.root, className)} {...rest}>
+        <ReactionButtonIcon />
+      </TogglePrimitive.Root>
+    </ImageFrameReactionButtonClassNamesProvider>
+  );
+});
+
+ImageFrameReactionButton.displayName = "ImageFrameReactionButton";

package/src/components/ImageFrame/index.ts

@@ -0,0 +1,14 @@
+export {
+  ImageFrame,
+  ImageFrameFloater,
+  ImageFrameBadge,
+  ImageFrameIcon,
+  ImageFrameIndicator,
+  ImageFrameReactionButton,
+  type ImageFrameProps,
+  type ImageFrameFloaterProps,
+  type ImageFrameBadgeProps,
+  type ImageFrameIconProps,
+  type ImageFrameIndicatorProps,
+  type ImageFrameReactionButtonProps,
+} from "./ImageFrame";

package/src/components/Inline/Inline.tsx

@@ -0,0 +1,24 @@
+import * as React from "react";
+import { Box, type BoxProps } from "../Box/Box";
+
+/**
+ * @deprecated Use `HStack` instead.
+ */
+export interface InlineProps extends Omit<BoxProps, "display" | "direction" | "flexWrap"> {}
+
+/**
+ * @deprecated Use `HStack` instead.
+ */
+export const Inline = React.forwardRef<HTMLDivElement, InlineProps>((props, ref) => {
+  return (
+    <Box
+      ref={ref}
+      display="flex"
+      flexDirection="row"
+      flexWrap="wrap"
+      alignItems="flex-start"
+      justifyContent="flex-start"
+      {...props}
+    />
+  );
+});

package/src/components/Inline/index.ts

@@ -0,0 +1 @@
+export { Inline, type InlineProps } from "./Inline";

package/src/components/InlineBanner/InlineBanner.namespace.ts

@@ -0,0 +1,14 @@
+export {
+  InlineBannerCloseButton as CloseButton,
+  InlineBannerContent as Content,
+  InlineBannerDescription as Description,
+  InlineBannerLink as Link,
+  InlineBannerRoot as Root,
+  InlineBannerTitle as Title,
+  type InlineBannerCloseButtonProps as CloseButtonProps,
+  type InlineBannerContentProps as ContentProps,
+  type InlineBannerDescriptionProps as DescriptionProps,
+  type InlineBannerLinkProps as LinkProps,
+  type InlineBannerRootProps as RootProps,
+  type InlineBannerTitleProps as TitleProps,
+} from "./InlineBanner";

package/src/components/InlineBanner/InlineBanner.tsx

@@ -0,0 +1,103 @@
+import type * as React from "react";
+
+import {
+  inlineBanner,
+  type InlineBannerVariantProps,
+} from "@seed-design/css/recipes/inline-banner";
+import { Primitive, type PrimitiveProps } from "@seed-design/react-primitive";
+import { createSlotRecipeContext } from "../../utils/createSlotRecipeContext";
+import {
+  DismissibleCloseButton,
+  DismissibleRoot,
+  type DismissibleRootProps,
+} from "../private/useDismissible";
+
+const { withContext, withProvider } = createSlotRecipeContext(inlineBanner);
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export interface InlineBannerRootProps extends InlineBannerVariantProps, DismissibleRootProps {}
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export const InlineBannerRoot = withProvider<HTMLDivElement, InlineBannerRootProps>(
+  DismissibleRoot,
+  "root",
+);
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export interface InlineBannerContentProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLDivElement> {}
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export const InlineBannerContent = withContext<HTMLDivElement, InlineBannerContentProps>(
+  Primitive.div,
+  "content",
+);
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export interface InlineBannerTitleProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLSpanElement> {}
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export const InlineBannerTitle = withContext<HTMLSpanElement, InlineBannerTitleProps>(
+  Primitive.span,
+  "title",
+);
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export interface InlineBannerDescriptionProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLSpanElement> {}
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export const InlineBannerDescription = withContext<HTMLSpanElement, InlineBannerDescriptionProps>(
+  Primitive.span,
+  "description",
+);
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export interface InlineBannerLinkProps
+  extends PrimitiveProps,
+    React.ButtonHTMLAttributes<HTMLButtonElement> {}
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export const InlineBannerLink = withContext<HTMLButtonElement, InlineBannerLinkProps>(
+  Primitive.button,
+  "link",
+);
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export interface InlineBannerCloseButtonProps
+  extends PrimitiveProps,
+    React.ButtonHTMLAttributes<HTMLButtonElement> {}
+
+/**
+ * @deprecated Use `PageBanner` instead.
+ */
+export const InlineBannerCloseButton = withContext<HTMLButtonElement, InlineBannerCloseButtonProps>(
+  DismissibleCloseButton,
+  "closeButton",
+);

package/src/components/InlineBanner/index.ts

@@ -0,0 +1,16 @@
+export {
+  InlineBannerCloseButton,
+  InlineBannerContent,
+  InlineBannerDescription,
+  InlineBannerLink,
+  InlineBannerRoot,
+  InlineBannerTitle,
+  type InlineBannerCloseButtonProps,
+  type InlineBannerContentProps,
+  type InlineBannerDescriptionProps,
+  type InlineBannerLinkProps,
+  type InlineBannerRootProps,
+  type InlineBannerTitleProps,
+} from "./InlineBanner";
+
+export * as InlineBanner from "./InlineBanner.namespace";

package/src/components/LinkContent/LinkContent.tsx

@@ -0,0 +1,23 @@
+import { linkContent, type LinkContentVariantProps } from "@seed-design/css/recipes/link-content";
+import { Primitive, type PrimitiveProps } from "@seed-design/react-primitive";
+import { createRecipeContext } from "../../utils/createRecipeContext";
+import type * as React from "react";
+import { withStyleProps, type StyleProps } from "../../utils/styled";
+
+const { withContext } = createRecipeContext(linkContent);
+
+/**
+ * @deprecated Use `ActionButton` with variant="ghost" instead.
+ */
+export interface LinkContentProps
+  extends LinkContentVariantProps,
+    PrimitiveProps,
+    Pick<StyleProps, "color">,
+    Omit<React.HTMLAttributes<HTMLSpanElement>, "color"> {}
+
+/**
+ * @deprecated Use `ActionButton` with variant="ghost" instead.
+ */
+export const LinkContent = withContext<HTMLButtonElement, LinkContentProps>(
+  withStyleProps(Primitive.span),
+);

package/src/components/LinkContent/index.ts

@@ -0,0 +1,4 @@
+export {
+  LinkContent,
+  type LinkContentProps,
+} from "./LinkContent";

package/src/components/List/List.namespace.ts

@@ -0,0 +1,16 @@
+export {
+  ListContent as Content,
+  ListDetail as Detail,
+  ListItem as Item,
+  ListPrefix as Prefix,
+  ListRoot as Root,
+  ListSuffix as Suffix,
+  ListTitle as Title,
+  type ListContentProps as ContentProps,
+  type ListDetailProps as DetailProps,
+  type ListItemProps as ItemProps,
+  type ListPrefixProps as PrefixProps,
+  type ListRootProps as RootProps,
+  type ListSuffixProps as SuffixProps,
+  type ListTitleProps as TitleProps,
+} from "./List";

package/src/components/List/List.tsx

@@ -0,0 +1,96 @@
+import type * as React from "react";
+
+import { listItem, type ListItemVariantProps } from "@seed-design/css/recipes/list-item";
+import { Primitive, type PrimitiveProps } from "@seed-design/react-primitive";
+import { forwardRef } from "react";
+import { createSlotRecipeContext } from "../../utils/createSlotRecipeContext";
+import { handleRadius, withStyleProps, type StyleProps } from "../../utils/styled";
+import { VStack, type VStackProps } from "../Stack";
+import { useCheckboxContext } from "@seed-design/react-checkbox";
+import { createWithStateProps } from "../../utils/createWithStateProps";
+import { useRadioGroupItemContext } from "@seed-design/react-radio-group";
+import { useSwitchContext } from "@seed-design/react-switch";
+
+const { withContext, withProvider } = createSlotRecipeContext(listItem);
+const withStateProps = createWithStateProps([
+  { useContext: useCheckboxContext, strict: false },
+  { useContext: useRadioGroupItemContext, strict: false },
+  { useContext: useSwitchContext, strict: false },
+]);
+
+export interface ListRootProps extends VStackProps {
+  itemBorderRadius?: StyleProps["borderRadius"];
+}
+
+export const ListRoot = forwardRef<HTMLUListElement, ListRootProps>(
+  ({ as = "ul", style, itemBorderRadius, ...props }, ref) => {
+    return (
+      <VStack
+        as={as}
+        ref={ref as React.ForwardedRef<HTMLDivElement>}
+        style={
+          {
+            ...style,
+            "--list-item-border-radius": handleRadius(itemBorderRadius),
+          } as React.CSSProperties
+        }
+        {...props}
+      />
+    );
+  },
+);
+
+export interface ListItemProps
+  extends PrimitiveProps,
+    Pick<StyleProps, "alignItems">,
+    React.HTMLAttributes<HTMLLIElement>,
+    ListItemVariantProps {}
+
+export const ListItem = withProvider<HTMLLIElement, ListItemProps>(
+  withStateProps(withStyleProps(Primitive.li)),
+  "root",
+);
+
+export interface ListContentProps
+  extends PrimitiveProps,
+    Pick<StyleProps, "gap" | "pr" | "paddingRight">,
+    React.HTMLAttributes<HTMLDivElement> {}
+
+export const ListContent = withContext<HTMLDivElement, ListContentProps>(
+  withStateProps(withStyleProps(Primitive.div)),
+  "content",
+);
+
+export interface ListPrefixProps
+  extends PrimitiveProps,
+    Pick<StyleProps, "pr" | "paddingRight">,
+    React.HTMLAttributes<HTMLDivElement> {}
+
+export const ListPrefix = withContext<HTMLDivElement, ListPrefixProps>(
+  withStateProps(withStyleProps(Primitive.div)),
+  "prefix",
+);
+
+export interface ListSuffixProps
+  extends PrimitiveProps,
+    Pick<StyleProps, "gap" | "position">,
+    React.HTMLAttributes<HTMLDivElement> {}
+
+export const ListSuffix = withContext<HTMLDivElement, ListSuffixProps>(
+  withStateProps(withStyleProps(Primitive.div)),
+  "suffix",
+);
+
+export interface ListTitleProps extends PrimitiveProps, React.HTMLAttributes<HTMLDivElement> {}
+
+export const ListTitle = withContext<HTMLDivElement, ListTitleProps>(
+  withStateProps(Primitive.div),
+  "title",
+);
+
+export interface ListDetailProps extends PrimitiveProps, React.HTMLAttributes<HTMLDivElement> {}
+
+export const ListDetail = withContext<HTMLDivElement, ListDetailProps>(
+  withStateProps(Primitive.div),
+  "detail",
+);

package/src/components/List/ListHeader.tsx

@@ -0,0 +1,24 @@
+import { listHeader, type ListHeaderVariantProps } from "@seed-design/css/recipes/list-header";
+import { forwardRef } from "react";
+import clsx from "clsx";
+import type { PrimitiveProps } from "@seed-design/react-primitive";
+
+export interface ListHeaderProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLDivElement>,
+    ListHeaderVariantProps {
+  /**
+   * @default "div"
+   */
+  as?: "div" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+}
+
+export const ListHeader = forwardRef<HTMLDivElement, ListHeaderProps>(
+  ({ as: Comp = "div", ...props }, ref) => {
+    const [variantProps, otherProps] = listHeader.splitVariantProps(props);
+    const className = listHeader(variantProps);
+
+    return <Comp ref={ref} {...otherProps} className={clsx(className, props.className)} />;
+  },
+);
+ListHeader.displayName = "ListHeader";