@uniai-fe/uds-primitives 0.12.14 → 0.13.0

package/src/components/tooltip/markup/Text.tsx

@@ -3,15 +3,22 @@ import type { TooltipTextProps } from "../types";
 import { Slot } from "../../slot";
 
 /**
- * Tooltip Text; Tooltip 텍스트 className 계약을 고정하는 전용 마크업.
+ * Tooltip Text; Tooltip 문구의 고정 스타일
  * @component
- * @param {TooltipTextProps} props Text props
+ * @property {ReactNode} [props.children] 문자열·숫자는 span으로 감싸고 다른 ReactNode는 그대로 반환한다.
+ * @property {"span"} [props.as="span"] 문자열·숫자 문구의 렌더 요소. 현재 공개 타입은 span 입력을 받는다.
+ * @property {string} [props.className] 문자열·숫자 문구에 slot-text·tooltip-message-text와 병합할 추가 클래스.
+ * @property {string} [props.title] 문구의 native title. 생략하면 문자열·숫자 children의 문자열 값을 사용한다.
+ * @property {string} [props.id] 문자열·숫자 문구를 감싼 span의 DOM ID.
+ * @property {CSSProperties} [props.style] 문자열·숫자 문구를 감싼 span의 inline style.
+ * @see TooltipTextProps
+ * @desc Tooltip.Text와 Fab.Menu.Label이 같은 구현을 사용한다. TooltipTextProps가 상속한 SlotTextProps는 ComponentPropsWithoutRef<"span"> 계약으로 ref를 받지 않는다. Tooltip의 스타일 문맥에서 문구를 표현하며 나머지 native span 속성은 래핑한 텍스트에 전달한다. 복합 JSX는 wrapper·클래스·속성 주입 없이 반환한다. Tooltip 표시 상태와 접근 가능한 버튼 이름을 설정하는 부품은 아니다.
  */
 export default function TooltipText({
   className,
   ...restProps
 }: TooltipTextProps) {
-  // 변경: Tooltip 텍스트 className 누락을 방지하기 위해 전용 Text 컴포넌트로 고정한다.
+  // 문구의 전용 클래스를 유지해 Tooltip의 색상과 타이포그래피를 적용한다.
   return (
     <Slot.Text
       className={clsx("tooltip-message-text", className)}

package/src/components/tooltip/types/text.ts

@@ -2,8 +2,13 @@ import type { SlotTextProps } from "../../slot";
 
 /**
  * Tooltip Types; Text 마크업 props
- * @property {React.ElementType} [as] 렌더링할 요소. 기본값은 span.
- * @property {React.ReactNode} [children] 텍스트 콘텐츠
- * @property {string} [className] tooltip-text와 병합할 className
+ * @property {"span"} [as="span"] 문자열·숫자 문구의 렌더 요소. SlotTextProps의 기본 generic span을 사용한다.
+ * @property {React.ReactNode} [children] 문자열·숫자는 span으로 감싸고 복합 JSX는 속성 주입 없이 반환한다.
+ * @property {string} [className] 문자열·숫자 문구에 slot-text·tooltip-message-text와 병합할 추가 클래스.
+ * @property {string} [title] 문자열·숫자 문구의 native title. 생략하면 children의 문자열 값을 사용한다.
+ * @property {string} [id] 문자열·숫자 문구를 감싼 span의 DOM ID.
+ * @property {React.CSSProperties} [style] 문자열·숫자 문구를 감싼 span의 inline style.
+ * @see SlotTextProps
+ * @desc Tooltip.Text와 Fab.Menu.Label이 공유하는 문구 입력이다. native span 속성을 상속하며 복합 JSX에는 wrapper·클래스·속성을 주입하지 않는다. 표시 상태와 접근 가능한 버튼 이름은 상위 조합에서 설정한다.
  */
 export type TooltipTextProps = SlotTextProps;

package/src/index.scss

@@ -8,6 +8,7 @@
 @use "./components/divider";
 @use "./components/drawer";
 @use "./components/dropdown";
+@use "./components/fab";
 @use "./components/form";
 @use "./components/info-box";
 @use "./components/input";

package/src/index.tsx

@@ -13,6 +13,7 @@ export * from "./components/chip";
 export * from "./components/divider";
 export * from "./components/drawer";
 export * from "./components/dropdown";
+export * from "./components/fab";
 export * from "./components/form";
 export * from "./components/info-box";
 export * from "./components/input";