@seed-design/react 1.1.16 → 1.2.0

package/src/components/GridItem/GridItem.tsx

@@ -0,0 +1,70 @@
+import * as React from "react";
+import { Box, type BoxProps } from "../Box/Box";
+
+export interface GridItemProps extends Omit<BoxProps, "gridColumn" | "gridRow" | "gridArea"> {
+  /**
+   * If true, the component will render its children directly without a wrapper element.
+   * @default false
+   */
+  asChild?: boolean;
+
+  /**
+   * Number of columns to span, or "full" for full width (1 / -1).
+   */
+  colSpan?: number | "full";
+
+  /**
+   * Number of rows to span, or "full" for full height (1 / -1).
+   */
+  rowSpan?: number | "full";
+
+  /**
+   * Starting column
+   */
+  colStart?: number;
+
+  /**
+   * Ending column.
+   */
+  colEnd?: number;
+
+  /**
+   * Starting row
+   */
+  rowStart?: number;
+
+  /**
+   * Ending row.
+   */
+  rowEnd?: number;
+
+  // NOTE: grid-area is not currently supported here: see Grid.tsx
+}
+
+export const GridItem = React.forwardRef<HTMLDivElement, GridItemProps>((props, ref) => {
+  const { asChild = false, colSpan, colStart, colEnd, rowSpan, rowStart, rowEnd, ...rest } = props;
+
+  const gridColumn = getGridLine(colSpan, colStart, colEnd);
+  const gridRow = getGridLine(rowSpan, rowStart, rowEnd);
+
+  return <Box ref={ref} asChild={asChild} gridColumn={gridColumn} gridRow={gridRow} {...rest} />;
+});
+GridItem.displayName = "GridItem";
+
+function getGridLine(
+  span: GridItemProps["colSpan"] & GridItemProps["rowSpan"],
+  start: GridItemProps["colStart"] & GridItemProps["rowStart"],
+  end: GridItemProps["colEnd"] & GridItemProps["rowEnd"],
+): (BoxProps["gridRow"] & BoxProps["gridColumn"]) | undefined {
+  if (span === "full") return "1 / -1";
+
+  if (start !== undefined && end !== undefined) return `${start} / ${end}`;
+
+  if (start !== undefined) return `${start}`;
+
+  if (end !== undefined) return `auto / ${end}`;
+
+  if (span !== undefined) return `span ${span}`;
+
+  return undefined;
+}

package/src/components/GridItem/index.ts

@@ -0,0 +1 @@
+export { GridItem, type GridItemProps } from "./GridItem";

package/src/components/HelpBubble/HelpBubble.namespace.ts

@@ -2,6 +2,7 @@ export {
   HelpBubbleAnchor as Anchor,
   HelpBubbleArrow as Arrow,
   HelpBubbleArrowTip as ArrowTip,
+  HelpBubbleBody as Body,
   HelpBubbleCloseButton as CloseButton,
   HelpBubbleContent as Content,
   HelpBubbleDescription as Description,
@@ -10,8 +11,10 @@ export {
   HelpBubbleRoot as Root,
   HelpBubbleTitle as Title,
   HelpBubbleTrigger as Trigger,
+  type HelpBubbleAnchorProps as AnchorProps,
   type HelpBubbleArrowProps as ArrowProps,
   type HelpBubbleArrowTipProps as ArrowTipProps,
+  type HelpBubbleBodyProps as BodyProps,
   type HelpBubbleCloseButtonProps as CloseButtonProps,
   type HelpBubbleContentProps as ContentProps,
   type HelpBubbleDescriptionProps as DescriptionProps,

package/src/components/HelpBubble/HelpBubble.tsx

@@ -147,6 +147,13 @@ export const HelpBubbleCloseButton = withContext<HTMLButtonElement, HelpBubbleCl
 
 ////////////////////////////////////////////////////////////////////////////////////
 
+export interface HelpBubbleBodyProps extends PrimitiveProps, React.HTMLAttributes<HTMLDivElement> {}
+
+export const HelpBubbleBody = withContext<HTMLDivElement, HelpBubbleBodyProps>(
+  withStateProps(Primitive.div),
+  "body",
+);
+
 export interface HelpBubbleTitleProps
   extends PrimitiveProps,
     React.HTMLAttributes<HTMLSpanElement> {}
@@ -156,8 +163,6 @@ export const HelpBubbleTitle = withContext<HTMLSpanElement, HelpBubbleTitleProps
   "title",
 );
 
-////////////////////////////////////////////////////////////////////////////////////
-
 export interface HelpBubbleDescriptionProps
   extends PrimitiveProps,
     React.HTMLAttributes<HTMLDivElement> {}

package/src/components/HelpBubble/index.ts

@@ -2,6 +2,7 @@ export {
   HelpBubbleAnchor,
   HelpBubbleArrow,
   HelpBubbleArrowTip,
+  HelpBubbleBody,
   HelpBubbleCloseButton,
   HelpBubbleContent,
   HelpBubbleDescription,
@@ -13,6 +14,7 @@ export {
   type HelpBubbleAnchorProps,
   type HelpBubbleArrowProps,
   type HelpBubbleArrowTipProps,
+  type HelpBubbleBodyProps,
   type HelpBubbleCloseButtonProps,
   type HelpBubbleContentProps,
   type HelpBubbleDescriptionProps,

package/src/components/ImageFrame/ImageFrame.tsx

@@ -0,0 +1,227 @@
+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 { Image } from "@seed-design/react-image";
+import { Toggle as TogglePrimitive } from "@seed-design/react-toggle";
+import clsx from "clsx";
+import * as React from "react";
+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";
+
+export interface ImageFrameProps
+  extends Omit<AspectRatioProps, "children">,
+    ImageFrameVariantProps {
+  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>;
+  /**
+   * Overlay elements to be rendered on top of the image.
+   * Use ImageFrameFloater to position them.
+   */
+  children?: React.ReactNode;
+}
+
+export const ImageFrame = React.forwardRef<HTMLDivElement, ImageFrameProps>(
+  (
+    {
+      ratio = 4 / 3,
+      rounded,
+      stroke,
+      src,
+      alt,
+      fallback,
+      className,
+      loading,
+      decoding,
+      crossOrigin,
+      referrerPolicy,
+      sizes,
+      srcSet,
+      onLoad,
+      onError,
+      children,
+      ...rest
+    },
+    ref,
+  ) => {
+    return (
+      <AspectRatio ref={ref} ratio={ratio} className={className} {...rest}>
+        <Image.Root className={imageFrameRecipe({ rounded, stroke })}>
+          <Image.Content
+            src={src}
+            alt={alt}
+            loading={loading}
+            decoding={decoding}
+            crossOrigin={crossOrigin}
+            referrerPolicy={referrerPolicy}
+            sizes={sizes}
+            srcSet={srcSet}
+            onLoad={onLoad}
+            onError={onError}
+          />
+          {fallback && <Image.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 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 UnselectedHeartIcon = () => (
+  <svg viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+    <path d={HeartFillPath} fill="black" fillOpacity="0.063" />
+    <path fillRule="evenodd" clipRule="evenodd" d={HeartOutlineStrokePath} fill="white" />
+  </svg>
+);
+
+const SelectedHeartIcon = () => {
+  const id = React.useId();
+  const gradientId = `seed-heart-gradient${id.replace(/:/g, "")}`;
+  return (
+    <svg viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+      <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>
+  );
+};
+
+export interface ImageFrameReactionButtonProps
+  extends Omit<TogglePrimitive.RootProps, "children"> {}
+
+export const ImageFrameReactionButton = React.forwardRef<
+  HTMLButtonElement,
+  ImageFrameReactionButtonProps
+>(({ className, pressed, ...rest }, ref) => {
+  return (
+    <TogglePrimitive.Root
+      ref={ref}
+      className={clsx(imageFrameReactionButton(), className)}
+      pressed={pressed}
+      {...rest}
+    >
+      <Icon svg={pressed ? <SelectedHeartIcon /> : <UnselectedHeartIcon />} />
+    </TogglePrimitive.Root>
+  );
+});
+
+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/MenuSheet/MenuSheet.namespace.ts

@@ -6,10 +6,14 @@ export {
   MenuSheetHeader as Header,
   MenuSheetRoot as Root,
   MenuSheetTitle as Title,
+  MenuSheetDescription as Description,
   MenuSheetTrigger as Trigger,
   MenuSheetList as List,
   MenuSheetGroup as Group,
   MenuSheetItem as Item,
+  MenuSheetItemContent as ItemContent,
+  MenuSheetItemLabel as ItemLabel,
+  MenuSheetItemDescription as ItemDescription,
   MenuSheetCloseButton as CloseButton,
   type MenuSheetBackdropProps as BackdropProps,
   type MenuSheetPositionerProps as PositionerProps,
@@ -18,9 +22,13 @@ export {
   type MenuSheetHeaderProps as HeaderProps,
   type MenuSheetRootProps as RootProps,
   type MenuSheetTitleProps as TitleProps,
+  type MenuSheetDescriptionProps as DescriptionProps,
   type MenuSheetTriggerProps as TriggerProps,
   type MenuSheetListProps as ListProps,
   type MenuSheetGroupProps as GroupProps,
   type MenuSheetItemProps as ItemProps,
+  type MenuSheetItemContentProps as ItemContentProps,
+  type MenuSheetItemLabelProps as ItemLabelProps,
+  type MenuSheetItemDescriptionProps as ItemDescriptionProps,
   type MenuSheetCloseButtonProps as CloseButtonProps,
 } from "./MenuSheet";

package/src/components/MenuSheet/MenuSheet.tsx

@@ -6,16 +6,17 @@ import {
   type MenuSheetItemVariantProps,
 } from "@seed-design/css/recipes/menu-sheet-item";
 import * as React from "react";
-import { createRecipeContext } from "../../utils/createRecipeContext";
 import { createSlotRecipeContext } from "../../utils/createSlotRecipeContext";
 import { createWithStateProps } from "../../utils/createWithStateProps";
+import clsx from "clsx";
 
-const { withRootProvider, withContext } = createSlotRecipeContext(menuSheet);
+const { withRootProvider, withContext, useClassNames } = createSlotRecipeContext(menuSheet);
 const {
-  withContext: withItemContext,
   PropsProvider: ItemPropsProvider,
   useProps: useItemProps,
-} = createRecipeContext(menuSheetItem);
+  withContext: withItemContext,
+  ClassNamesProvider: ItemClassNamesProvider,
+} = createSlotRecipeContext(menuSheetItem);
 const withStateProps = createWithStateProps([useDialogContext]);
 
 ////////////////////////////////////////////////////////////////////////////////////
@@ -68,18 +69,18 @@ export interface MenuSheetContentProps
   extends DialogPrimitive.ContentProps,
     Pick<MenuSheetItemVariantProps, "labelAlign"> {}
 
-const MenuSheetContentBase = withContext<HTMLDivElement, DialogPrimitive.ContentProps>(
-  DialogPrimitive.Content,
-  "content",
-);
-
 export const MenuSheetContent = React.forwardRef<HTMLDivElement, MenuSheetContentProps>(
-  ({ labelAlign, children, ...props }, ref) => {
+  ({ className, ...props }, ref) => {
+    const [variantProps, otherProps] = menuSheetItem.splitVariantProps(props);
+    const classNames = useClassNames();
+
     return (
-      <ItemPropsProvider value={React.useMemo(() => ({ labelAlign }), [labelAlign])}>
-        <MenuSheetContentBase ref={ref} {...props}>
-          {children}
-        </MenuSheetContentBase>
+      <ItemPropsProvider value={variantProps}>
+        <DialogPrimitive.Content
+          className={clsx(classNames.content, className)}
+          ref={ref}
+          {...otherProps}
+        />
       </ItemPropsProvider>
     );
   },
@@ -96,8 +97,9 @@ export const MenuSheetHeader = withContext<HTMLDivElement, MenuSheetHeaderProps>
   "header",
 );
 
-////////////////////////////////////////////////////////////////////////////////////
-
+// NOTE: uses DialogPrimitive.TitleProps,
+// but actual rendered component is a Primitive.h2 rather than a DialogPrimitive.Title
+// find out why later; h2 is same but missing and some a11y features
 export interface MenuSheetTitleProps extends DialogPrimitive.TitleProps {}
 
 export const MenuSheetTitle = withContext<HTMLHeadingElement, MenuSheetTitleProps>(
@@ -105,6 +107,16 @@ export const MenuSheetTitle = withContext<HTMLHeadingElement, MenuSheetTitleProp
   "title",
 );
 
+// NOTE: uses DialogPrimitive.DescriptionProps,
+// but actual rendered component is a Primitive.p rather than a DialogPrimitive.Description
+// find out why later; p is same but missing and some a11y features
+export interface MenuSheetDescriptionProps extends DialogPrimitive.DescriptionProps {}
+
+export const MenuSheetDescription = withContext<HTMLParagraphElement, MenuSheetDescriptionProps>(
+  withStateProps(Primitive.p),
+  "description",
+);
+
 ////////////////////////////////////////////////////////////////////////////////////
 
 export interface MenuSheetListProps extends PrimitiveProps, React.HTMLAttributes<HTMLDivElement> {}
@@ -120,21 +132,22 @@ export interface MenuSheetGroupProps
   extends React.HTMLAttributes<HTMLDivElement>,
     Pick<MenuSheetItemVariantProps, "labelAlign"> {}
 
-const MenuSheetGroupBase = withContext<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  withStateProps(Primitive.div),
-  "group",
-);
-
 export const MenuSheetGroup = React.forwardRef<HTMLDivElement, MenuSheetGroupProps>(
-  ({ labelAlign: overriddenLabelAlign, children, ...props }, ref) => {
+  ({ className, ...props }, ref) => {
+    const [variantProps, otherProps] = menuSheetItem.splitVariantProps(props);
     const parentProps = useItemProps();
-    const labelAlign = overriddenLabelAlign ?? parentProps?.labelAlign;
+
+    const classNames = useClassNames();
+    const { stateProps } = useDialogContext();
 
     return (
-      <ItemPropsProvider value={React.useMemo(() => ({ labelAlign }), [labelAlign])}>
-        <MenuSheetGroupBase ref={ref} {...props}>
-          {children}
-        </MenuSheetGroupBase>
+      <ItemPropsProvider value={{ ...parentProps, ...variantProps }}>
+        <Primitive.div
+          className={clsx(classNames.group, className)}
+          ref={ref}
+          {...stateProps}
+          {...otherProps}
+        />
       </ItemPropsProvider>
     );
   },
@@ -147,19 +160,54 @@ export interface MenuSheetItemProps
     MenuSheetItemVariantProps,
     React.HTMLAttributes<HTMLButtonElement> {}
 
-const MenuSheetItemBase = withItemContext<HTMLButtonElement, MenuSheetItemProps>(
-  withStateProps(Primitive.button),
-);
-
 export const MenuSheetItem = React.forwardRef<HTMLButtonElement, MenuSheetItemProps>(
-  ({ labelAlign: overriddenLabelAlign, ...props }, ref) => {
+  ({ className: propClassName, ...props }, ref) => {
+    const [variantProps, otherProps] = menuSheetItem.splitVariantProps(props);
     const parentProps = useItemProps();
-    const labelAlign = overriddenLabelAlign ?? parentProps?.labelAlign;
 
-    return <MenuSheetItemBase ref={ref} labelAlign={labelAlign} {...props} />;
+    const classNames = menuSheetItem({ ...parentProps, ...variantProps });
+    const { stateProps } = useDialogContext();
+
+    return (
+      <ItemClassNamesProvider value={classNames}>
+        <Primitive.button
+          ref={ref}
+          className={clsx(classNames.root, propClassName)}
+          {...stateProps}
+          {...otherProps}
+        />
+      </ItemClassNamesProvider>
+    );
   },
 );
 
+export interface MenuSheetItemContentProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLDivElement> {}
+
+export const MenuSheetItemContent = withItemContext<HTMLDivElement, MenuSheetItemContentProps>(
+  withStateProps(Primitive.div),
+  "content",
+);
+
+export interface MenuSheetItemLabelProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLSpanElement> {}
+
+export const MenuSheetItemLabel = withItemContext<HTMLSpanElement, MenuSheetItemLabelProps>(
+  withStateProps(Primitive.span),
+  "label",
+);
+
+export interface MenuSheetItemDescriptionProps
+  extends PrimitiveProps,
+    React.HTMLAttributes<HTMLSpanElement> {}
+
+export const MenuSheetItemDescription = withItemContext<
+  HTMLSpanElement,
+  MenuSheetItemDescriptionProps
+>(withStateProps(Primitive.span), "description");
+
 ////////////////////////////////////////////////////////////////////////////////////
 
 export interface MenuSheetFooterProps

package/src/components/MenuSheet/index.ts

@@ -6,10 +6,14 @@ export {
   MenuSheetHeader,
   MenuSheetRoot,
   MenuSheetTitle,
+  MenuSheetDescription,
   MenuSheetTrigger,
   MenuSheetList,
   MenuSheetGroup,
   MenuSheetItem,
+  MenuSheetItemContent,
+  MenuSheetItemLabel,
+  MenuSheetItemDescription,
   MenuSheetCloseButton,
   type MenuSheetBackdropProps,
   type MenuSheetPositionerProps,
@@ -18,10 +22,14 @@ export {
   type MenuSheetHeaderProps,
   type MenuSheetRootProps,
   type MenuSheetTitleProps,
+  type MenuSheetDescriptionProps,
   type MenuSheetTriggerProps,
   type MenuSheetListProps,
   type MenuSheetGroupProps,
   type MenuSheetItemProps,
+  type MenuSheetItemContentProps,
+  type MenuSheetItemLabelProps,
+  type MenuSheetItemDescriptionProps,
   type MenuSheetCloseButtonProps,
 } from "./MenuSheet";
 

package/src/components/RadioGroup/RadioGroup.tsx

@@ -1,4 +1,5 @@
 import { radio, type RadioVariantProps } from "@seed-design/css/recipes/radio";
+import { radioGroup, type RadioGroupVariantProps } from "@seed-design/css/recipes/radio-group";
 import { radiomark, type RadiomarkVariantProps } from "@seed-design/css/recipes/radiomark";
 import { mergeProps } from "@seed-design/dom-utils";
 import {
@@ -12,7 +13,9 @@ import { createSlotRecipeContext } from "../../utils/createSlotRecipeContext";
 import { createWithStateProps } from "../../utils/createWithStateProps";
 import { InternalIcon } from "../private/Icon";
 import { splitMultipleVariantsProps } from "../../utils/splitMultipleVariantsProps";
+import { createRecipeContext } from "../../utils/createRecipeContext";
 
+const { withContext: withGroupContext } = createRecipeContext(radioGroup);
 const { ClassNamesProvider, withContext } = createSlotRecipeContext(radio);
 const {
   withProvider: withRadiomarkProvider,
@@ -23,9 +26,12 @@ const withStateProps = createWithStateProps([useRadioGroupItemContext]);
 
 ////////////////////////////////////////////////////////////////////////////////////
 
-export interface RadioGroupRootProps extends RadioGroupPrimitive.RootProps {}
+export interface RadioGroupRootProps
+  extends RadioGroupVariantProps,
+    PrimitiveProps,
+    React.HTMLAttributes<HTMLDivElement> {}
 
-export const RadioGroupRoot = RadioGroupPrimitive.Root;
+export const RadioGroupRoot = withGroupContext<HTMLDivElement, RadioGroupRootProps>(Primitive.div);
 
 ////////////////////////////////////////////////////////////////////////////////////
 

package/src/components/RadioGroupField/RadioGroupField.namespace.ts

@@ -0,0 +1,18 @@
+export {
+  RadioGroupFieldRoot as Root,
+  RadioGroupFieldHeader as Header,
+  RadioGroupFieldLabel as Label,
+  RadioGroupFieldIndicatorText as IndicatorText,
+  RadioGroupFieldRequiredIndicator as RequiredIndicator,
+  RadioGroupFieldFooter as Footer,
+  RadioGroupFieldDescription as Description,
+  RadioGroupFieldErrorMessage as ErrorMessage,
+  type RadioGroupFieldRootProps as RootProps,
+  type RadioGroupFieldHeaderProps as HeaderProps,
+  type RadioGroupFieldLabelProps as LabelProps,
+  type RadioGroupFieldIndicatorTextProps as IndicatorTextProps,
+  type RadioGroupFieldRequiredIndicatorProps as RequiredIndicatorProps,
+  type RadioGroupFieldFooterProps as FooterProps,
+  type RadioGroupFieldDescriptionProps as DescriptionProps,
+  type RadioGroupFieldErrorMessageProps as ErrorMessageProps,
+} from "./RadioGroupField";