@ncds/ui-admin 1.8.0 → 1.8.2

package/dist/temp/src/types/side-slot.d.ts

@@ -1,12 +1,20 @@
 import type { ComponentType, ReactNode } from 'react';
 import type { COLOR } from '../../constant/color';
 import type { DotProps } from '../components';
+/**
+ * 아이콘 컴포넌트 자리에 쓰이는 타입. MCP가 props 추출 시 이 타입의 정체성을 감지하여
+ * 문자열 이름을 실제 아이콘 컴포넌트로 치환할 수 있도록 nominal brand를 부착한다.
+ *
+ * 런타임 영향 없음 (브랜드 필드는 optional never, 실제로 할당할 수 없음).
+ */
 export type SlotIconComponent = ComponentType<{
     height?: number;
     width?: number;
     color?: string;
     className?: string;
-}>;
+}> & {
+    readonly __ncuaSlotIconBrand?: never;
+};
 export type IconSlotType = {
     type: 'icon';
     icon: SlotIconComponent;

package/dist/temp/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/temp/vitest.config.js

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config';
+export default defineConfig({
+    test: {
+        include: ['scripts/**/__tests__/**/*.test.ts'],
+        environment: 'node',
+    },
+});

package/dist/types/src/components/badge/index.d.ts

@@ -1 +1,2 @@
 export * from './Badge';
+export * from './utils';

package/dist/types/src/components/date-picker/index.d.ts

@@ -1,2 +1,3 @@
 export * from './DatePicker';
+export * from './CustomInput';
 export * from './utils';

package/dist/types/src/components/empty-state/EmptyState.d.ts

@@ -1,14 +1,12 @@
 import { type ButtonProps } from '../button/Button';
-interface ButtonOptions extends Pick<ButtonProps, 'hierarchy' | 'size' | 'leadingIcon' | 'trailingIcon'> {
+export interface ButtonOptions extends Pick<ButtonProps, 'hierarchy' | 'size' | 'leadingIcon' | 'trailingIcon'> {
     label: string;
     onClick?: () => void;
     disabled?: boolean;
 }
-interface EmptyStateProps {
+export interface EmptyStateProps {
     title: string;
     description: string;
     buttons?: ButtonOptions | ButtonOptions[];
 }
-declare const EmptyState: ({ title, description, buttons }: EmptyStateProps) => import("react/jsx-runtime").JSX.Element;
-export type { ButtonOptions };
-export { EmptyState };
+export declare const EmptyState: ({ title, description, buttons }: EmptyStateProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/src/components/image-file-input/components/index.d.ts

@@ -0,0 +1 @@
+export * from './ImagePreview';

package/dist/types/src/components/image-file-input/index.d.ts

@@ -1 +1,2 @@
 export * from './ImageFileInput';
+export * from './components';

package/dist/types/src/components/progress-bar/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from './SegmentBar';
+export * from './SegmentLabels';

package/dist/types/src/components/progress-bar/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './useProgressBar';

package/dist/types/src/components/progress-bar/index.d.ts

@@ -1,2 +1,5 @@
 export * from './ProgressBar';
+export * from './components';
+export * from './hooks';
 export * from './types';
+export * from './utils';

package/dist/types/src/components/select-dropdown/index.d.ts

@@ -1 +1 @@
-export { type DropdownDirection, SelectDropdown, type SelectDropdownProps } from './SelectDropdown';
+export * from './SelectDropdown';

package/dist/types/src/components/spinner/Spinner.d.ts

@@ -1,9 +1,8 @@
 import type { ElementType, ReactNode } from 'react';
-interface SpinnerProps {
+export interface SpinnerProps {
     as?: ElementType;
     size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
     children?: ReactNode;
     backdrop?: boolean;
 }
 export declare const Spinner: ({ as, size, children, backdrop }: SpinnerProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/types/src/components/switch/index.d.ts

@@ -1,2 +1 @@
-export type { SwitchProps } from './Switch';
-export { Switch } from './Switch';
+export * from './Switch';

package/dist/types/src/components/table/Table.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import type { SortDirection, TableBodyProps, TableCellProps, TableColGroupProps, TableEmptyProps, TableFooterProps, TableHeaderProps, TablePaginationProps } from './types';
+import type { SortDirection, TableBodyProps, TableColGroupProps, TableEmptyProps, TableFooterProps, TableHeaderProps, TablePaginationProps } from './types';
 export declare const Table: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     type?: import("./types").TableType | undefined;
     fixedHeader?: boolean | undefined;
@@ -25,7 +25,9 @@ export declare const Table: import("react").ForwardRefExoticComponent<Omit<impor
         onSort?: (() => void) | undefined;
         width?: string | number | undefined;
     } & import("react").RefAttributes<HTMLTableCellElement>>;
-    Cell: import("react").ForwardRefExoticComponent<TableCellProps & import("react").RefAttributes<HTMLTableCellElement>>;
+    Cell: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement>, "ref"> & {
+        isHeader?: boolean | undefined;
+    } & import("react").RefAttributes<HTMLTableCellElement>>;
     Footer: {
         ({ children, className }: TableFooterProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;

package/dist/types/src/components/table/types.d.ts

@@ -27,7 +27,9 @@ export type TableHeaderCellProps = Omit<ComponentProps<'th'>, 'ref'> & {
     onSort?: () => void;
     width?: string | number;
 };
-export type TableCellProps = Omit<ComponentProps<'td'>, 'ref'>;
+export type TableCellProps = Omit<ComponentProps<'td'>, 'ref'> & {
+    isHeader?: boolean;
+};
 export type TableFooterProps = {
     children: ReactNode;
     className?: string;

package/dist/types/src/components/tag/Tag.d.ts

@@ -1,7 +1,7 @@
 import { type MouseEventHandler } from 'react';
 import type { Size } from '../../../constant/size';
 import type { SideSlotType } from '../../types/side-slot';
-interface TagProps {
+export interface TagProps {
     size?: Extract<Size, 'sm' | 'md'>;
     icon?: SideSlotType;
     text: string;
@@ -11,7 +11,5 @@ interface TagProps {
     onButtonClick?: MouseEventHandler<HTMLButtonElement>;
     maxLength?: number;
 }
-type CalculatedPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-declare const Tag: ({ size, icon, text, count, close, onButtonClick, maxLength }: TagProps) => import("react/jsx-runtime").JSX.Element;
-export type { CalculatedPosition };
-export { Tag };
+export type CalculatedPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export declare const Tag: ({ size, icon, text, count, close, onButtonClick, maxLength }: TagProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/src/components/tooltip/Tooltip.d.ts

@@ -1,7 +1,8 @@
+type CalculatedPosition = 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 interface TooltipProps {
     tooltipType?: 'white' | 'black';
     iconType?: 'stroke' | 'fill';
-    position?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'auto';
+    position?: CalculatedPosition | 'auto';
     size?: 'sm' | 'md';
     hideArrow?: boolean;
     title?: string;
@@ -10,6 +11,7 @@ interface TooltipProps {
     className?: string;
     iconColor?: string;
     iconStyle?: 'help-circle' | 'alert-circle';
+    zIndex?: number;
 }
-export declare const Tooltip: ({ tooltipType, iconType, position, size, title, content, hideArrow, type, iconColor, iconStyle, className, }: TooltipProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Tooltip: ({ tooltipType, iconType, position, size, title, content, hideArrow, type, iconColor, iconStyle, className, zIndex, }: TooltipProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/src/hooks/dropdown/index.d.ts

@@ -1,6 +1,6 @@
-export { useDropdown } from './useDropdown';
-export { useDropdownKeyboard } from './useDropdownKeyboard';
-export { useDropdownPosition } from './useDropdownPosition';
-export { useOutsideClick } from './useOutsideClick';
-export { useScrollLock } from './useScrollLock';
-export { useWindowResize } from './useWindowResize';
+export * from './useDropdown';
+export * from './useDropdownKeyboard';
+export * from './useDropdownPosition';
+export * from './useOutsideClick';
+export * from './useScrollLock';
+export * from './useWindowResize';

package/dist/types/src/hooks/index.d.ts

@@ -1,4 +1,4 @@
 export * from './dropdown';
-export { useCallbackRef } from './useCallbackRef';
-export { useMediaQuery } from './useMediaQuery';
-export { useMergeRefs } from './useMergeRefs';
+export * from './useCallbackRef';
+export * from './useMediaQuery';
+export * from './useMergeRefs';

package/dist/types/src/types/component-meta.d.ts

@@ -0,0 +1,26 @@
+/** AI 에이전트용 컴포넌트 메타데이터 타입 */
+/** DES INDEX §3-1~§3-8 기준 카테고리 (commerce-rag design 네임스페이스) */
+export type ComponentCategory = 'action' | 'input' | 'icon' | 'overlay' | 'navigation' | 'feedback' | 'layout' | 'data-display';
+export interface ComponentMeta {
+    category: ComponentCategory;
+    aliases: string[];
+    hasChildren: boolean;
+    description: string;
+    whenToUse: string[];
+    forbiddenRules: string[];
+    seeAlso: string[];
+    jsRequired: boolean;
+    /** Props가 확장하는 HTML 요소 — 에이전트가 표준 HTML 속성 사용 가능 여부를 판단 */
+    htmlElement?: string;
+    /**
+     * render_to_html에 전달할 실제 사용 예시 props.
+     *
+     * 작성 규칙 (props-type-guide.md § usageExamples 참조):
+     * - key: 시나리오 이름 (예: "default", "withIcon", "rangePicker")
+     * - value: render_to_html의 props 파라미터에 그대로 전달 가능한 객체
+     * - 모든 required prop 포함 필수. optional은 시나리오에 필요한 것만.
+     * - 에이전트가 복사해서 바로 사용할 수 있는 수준의 실제 데이터.
+     * - 빈 문자열(""), 빈 객체({}) 금지. 의미 있는 값을 넣을 것.
+     */
+    usageExamples?: Record<string, Record<string, unknown>>;
+}

package/dist/types/src/types/dropdown/option.d.ts

@@ -1,13 +1,11 @@
+import type { SlotIconComponent } from '../side-slot';
 /**
  * 기본 옵션 타입
  */
 export type OptionType = {
     id: string | number;
     label: string;
-    icon?: React.ComponentType<{
-        width?: number;
-        height?: number;
-    }>;
+    icon?: SlotIconComponent;
 };
 /**
  * 옵션 값 타입 (단일 또는 다중 선택)

package/dist/types/src/types/side-slot.d.ts

@@ -1,12 +1,20 @@
 import type { ComponentType, ReactNode } from 'react';
 import type { COLOR } from '../../constant/color';
 import type { DotProps } from '../components';
+/**
+ * 아이콘 컴포넌트 자리에 쓰이는 타입. MCP가 props 추출 시 이 타입의 정체성을 감지하여
+ * 문자열 이름을 실제 아이콘 컴포넌트로 치환할 수 있도록 nominal brand를 부착한다.
+ *
+ * 런타임 영향 없음 (브랜드 필드는 optional never, 실제로 할당할 수 없음).
+ */
 export type SlotIconComponent = ComponentType<{
     height?: number;
     width?: number;
     color?: string;
     className?: string;
-}>;
+}> & {
+    readonly __ncuaSlotIconBrand?: never;
+};
 export type IconSlotType = {
     type: 'icon';
     icon: SlotIconComponent;

package/dist/types/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;