@ceed/ads 1.25.1-next.3 → 1.27.0

package/dist/chunks/rehype-accent-FZRUD7VI.js

@@ -0,0 +1,39 @@
+// src/libs/rehype-accent/index.ts
+import { visit } from "unist-util-visit";
+function rehypeAccent(options) {
+  const { accentColor } = options;
+  return (tree) => {
+    visit(tree, "text", (node, index, parent) => {
+      const value = node.value;
+      const regex = /\|\|.*?\|\|/g;
+      let match;
+      let lastIndex = 0;
+      const newNodes = [];
+      while ((match = regex.exec(value)) !== null) {
+        if (match.index > lastIndex) {
+          newNodes.push({
+            type: "text",
+            value: value.slice(lastIndex, match.index)
+          });
+        }
+        const innerText = match[0].split("||")[1];
+        newNodes.push({
+          type: "element",
+          tagName: "span",
+          properties: { textColor: accentColor },
+          children: [{ type: "text", value: innerText }]
+        });
+        lastIndex = match.index + match[0].length;
+      }
+      if (lastIndex < value.length) {
+        newNodes.push({ type: "text", value: value.slice(lastIndex) });
+      }
+      if (newNodes.length) {
+        parent.children.splice(index, 1, ...newNodes);
+      }
+    });
+  };
+}
+export {
+  rehypeAccent
+};

package/dist/components/CurrencyInput/CurrencyInput.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import { InputProps } from '@mui/joy';
 import { MotionProps } from 'framer-motion';
 export interface CurrencyInputProps {
-    currency?: 'USD' | 'KRW';
+    currency?: 'USD' | 'KRW' | 'CAD';
     max?: number;
     value?: number;
     defaultValue?: number;

package/dist/components/CurrencyInput/hooks/use-currency-setting.d.ts

@@ -1,10 +1,10 @@
 export declare const useCurrencySetting: (props: {
-    currency?: "USD" | "KRW" | "BHD" | undefined;
+    currency?: "USD" | "KRW" | "BHD" | "CAD" | undefined;
     placeholder?: string | undefined;
 }) => {
     symbol: string;
     thousandSeparator: string;
-    decimalSeparator: string;
+    decimalSeparator: string | undefined;
     placeholder: string;
     fixedDecimalScale: boolean;
     decimalScale: number;

package/dist/components/DataTable/components.d.ts

@@ -1,7 +1,8 @@
 import React, { ReactNode } from 'react';
 import type { ObjectLike, ColumnDef, Sort } from './types';
-export declare const TextEllipsis: ({ children }: {
+export declare const TextEllipsis: ({ children, lineClamp }: {
     children: ReactNode;
+    lineClamp?: number | undefined;
 }) => React.JSX.Element;
 export declare const CellTextEllipsis: ({ children }: {
     children: ReactNode;

package/dist/components/DataTable/hooks.d.ts

@@ -5,7 +5,7 @@ export declare function useColumnWidths<T>(columnsByField: {
         headerRef: React.RefObject<HTMLTableCellElement>;
     };
 }): Record<string, number>;
-export declare function useDataTableRenderer<T extends Record<PropertyKey, unknown>, GetId extends ((row: T) => any) | undefined = undefined>({ rows: _rows, columns: columnsProp, pinnedColumns, rowCount: totalRowsProp, initialState, pagination, paginationMode, paginationModel, onPaginationModelChange, sortModel: controlledSortModel, sortOrder: _sortOrder, selectionModel, onSortModelChange, onSelectionModelChange, editMode, getId: _getId, isTotalSelected: _isTotalSelected, isRowSelectable, columnGroupingModel, }: DataTableProps<T, GetId>): {
+export declare function useDataTableRenderer<T extends Record<PropertyKey, unknown>, GetId extends ((row: T) => any) | undefined = undefined>({ rows: _rows, columns: columnsProp, pinnedColumns, rowCount: totalRowsProp, initialState, pagination, paginationMode, paginationModel, onPaginationModelChange, sortModel: controlledSortModel, sortOrder: _sortOrder, selectionModel, onSortModelChange, onSelectionModelChange, editMode, getId: _getId, isTotalSelected: _isTotalSelected, isRowSelectable, columnGroupingModel, columnVisibilityModel, onColumnVisibilityModelChange, }: DataTableProps<T, GetId>): {
     rowCount: number;
     selectableRowCount: number;
     page: number;

package/dist/components/DataTable/styled.d.ts

@@ -1,5 +1,7 @@
 import React, { RefObject } from 'react';
-export declare const EllipsisDiv: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/joy").Theme>, Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof React.ClassAttributes<HTMLDivElement> | keyof React.HTMLAttributes<HTMLDivElement>>, {}>;
+export declare const EllipsisDiv: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/joy").Theme> & {
+    lineClamp?: number | undefined;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const OverlayWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/joy").Theme>, Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement>, keyof React.ClassAttributes<HTMLTableRowElement> | keyof React.HTMLAttributes<HTMLTableRowElement>>, {}>;
 export declare const VirtualizedTableBody: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/joy").Theme>, Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement>, keyof React.ClassAttributes<HTMLTableSectionElement> | keyof React.HTMLAttributes<HTMLTableSectionElement>>, {}>;
 export declare const StyledTableRow: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/joy").Theme> & {

package/dist/components/DataTable/types.d.ts

@@ -103,6 +103,7 @@ export type BaseColumnDef<T extends Record<PropertyKey, V>, V, ID> = {
         description?: string;
         cellClassName?: TableCellClassNamePropType<T, T[K]>;
         headerClassName?: TableColumnHeaderClassNamePropType<T, T[K]>;
+        headerLineClamp?: 1 | 2;
     };
 }[keyof T];
 export type AutocompleteColumnDef<T extends Record<PropertyKey, string>, ID> = BaseColumnDef<T, string, ID> & {
@@ -147,6 +148,7 @@ export type ActionsColumnDef<T extends Record<PropertyKey, string>, ID> = BaseCo
     }) => ReactNode[];
 };
 export type ColumnDef<T extends Record<PropertyKey, any>, ID = unknown> = AutocompleteColumnDef<T, ID> | CurrencyColumnDef<T, ID> | DateColumnDef<T, ID> | NumberColumnDef<T, ID> | TextColumnDef<T, ID> | LongTextColumnDef<T, ID> | LinkColumnDef<T, ID> | SelectColumnDef<T, ID> | ActionsColumnDef<T, ID>;
+export type ColumnVisibilityModel = Record<string, boolean>;
 export type Sort = 'asc' | 'desc' | null;
 export type SortModel<T extends Record<PropertyKey, any>> = {
     [K in keyof T]: {
@@ -164,6 +166,12 @@ export type DataTableProps<T extends Record<PropertyKey, any>, GetId extends ((r
     columns: ColumnDef<T, InferredIdType<T, GetId>>[];
     pinnedColumns?: PinnedColumns;
     columnGroupingModel?: ColumnGroupingModel<T, InferredIdType<T, GetId>>;
+    /**
+     * 컬럼의 표시/숨김 상태를 제어한다. field를 key로, boolean을 value로 사용한다.
+     * false로 설정된 컬럼만 숨겨지며, 모델에 포함되지 않은 컬럼은 기본적으로 표시된다.
+     */
+    columnVisibilityModel?: ColumnVisibilityModel;
+    onColumnVisibilityModelChange?: (model: ColumnVisibilityModel) => void;
     editMode?: boolean;
     /**
      * 체크박스가 있는 경우, 체크박스를 클릭했을 때 선택된 row의 index를 지정한다.
@@ -187,6 +195,9 @@ export type DataTableProps<T extends Record<PropertyKey, any>, GetId extends ((r
         sorting: Partial<{
             sortModel: SortModel<T>[];
         }>;
+        columns: Partial<{
+            columnVisibilityModel: ColumnVisibilityModel;
+        }>;
     }>;
     pagination?: boolean;
     paginationMode?: 'client' | 'server';

package/dist/components/DataTable/utils.d.ts

@@ -3,8 +3,8 @@ export declare function extractFieldsFromGroupingModel<T extends Record<Property
 export declare function reorderColumnsByGroupingModel<T extends Record<PropertyKey, any>, ID>(columns: ColumnDef<T, ID>[], columnGroupingModel: ColumnGroupingModel<T, ID>): ColumnDef<T, ID>[];
 export declare function flattenColumnGroups<T extends Record<PropertyKey, any>, ID>(items: ColumnGroupingModel<T, ID> | ColumnDef<T, ID>[], groupPath?: string[], columnIndex?: {
     current: number;
-}): FlattenedColumn<T, ID>[];
-export declare function calculateColumnGroups<T extends Record<PropertyKey, any>, ID>(columnGroupingModel: ColumnGroupingModel<T, ID>, columns: ColumnDef<T, ID>[]): {
+}, visibleFields?: Set<string>): FlattenedColumn<T, ID>[];
+export declare function calculateColumnGroups<T extends Record<PropertyKey, any>, ID>(columnGroupingModel: ColumnGroupingModel<T, ID>, columns: ColumnDef<T, ID>[], visibleFields?: Set<string>): {
     groups: ProcessedColumnGroup[][];
     maxLevel: number;
     fieldsInGroupingModel: Set<keyof T>;

package/dist/components/ProfileMenu/ProfileMenu.d.ts

@@ -26,7 +26,7 @@ interface BaseProfileMenuProps {
             src: string;
             alt: string;
         };
-        caption?: React.ReactNode;
+        caption?: string;
         chip?: string;
     };
     menuItems: ({

package/dist/components/data-display/Badge.md

@@ -2,7 +2,9 @@
 
 ## Introduction
 
-Badge 컴포넌트는 다른 UI 요소 위에 작은 카운트, 상태, 또는 레이블을 표시하는 데 사용됩니다. 주로 알림 수, 상태 표시기, 또는 새로운 콘텐츠를 나타내는 데 활용됩니다.
+Badge is a small visual indicator that overlays another UI element to display a count, status, or label. It is commonly used to show unread notification counts, online/offline status indicators, and "NEW" labels on menu items or navigation elements. The Badge wraps a child component (such as an icon button or avatar) and positions itself in the top-right corner by default.
+
+Badge supports multiple colors, variants, and sizes for flexible visual customization. It also provides utility features like a `max` prop for truncating large numbers (e.g., "99+"), a `showZero` prop for controlling zero-count visibility, and a dot-only mode when no `badgeContent` is provided.
 
 ```tsx
 <Badge {...args}>
@@ -26,7 +28,7 @@ Badge 컴포넌트는 다른 UI 요소 위에 작은 카운트, 상태, 또는
 
 ```tsx
 import { Badge, IconButton } from '@ceed/ads';
-import { NotificationsIcon } from '@mui/icons-material';
+import NotificationsIcon from '@mui/icons-material/Notifications';
 
 function MyComponent() {
   return (
@@ -39,11 +41,9 @@ function MyComponent() {
 }
 ```
 
-## Examples
-
-### Basic Usage
+## Basic
 
-기본적인 Badge 사용법입니다.
+Basic Badge usage showing numeric counts, max overflow, and text content.
 
 ```tsx
 <div style={{
@@ -70,9 +70,9 @@ function MyComponent() {
 </div>
 ```
 
-### Colors
+## Colors
 
-다양한 색상을 적용할 수 있습니다.
+Apply semantic colors to convey the badge's meaning: `primary` for general counts, `danger` for urgent notifications, `success` for online status, and `warning` for attention items.
 
 ```tsx
 <div style={{
@@ -111,9 +111,9 @@ function MyComponent() {
 </div>
 ```
 
-### Variants
+## Variants
 
-다양한 스타일 변형을 제공합니다.
+Four style variants are available: `solid` (filled), `soft` (subtle background), `outlined` (border only), and `plain` (minimal).
 
 ```tsx
 <div style={{
@@ -146,9 +146,9 @@ function MyComponent() {
 </div>
 ```
 
-### Sizes
+## Sizes
 
-크기를 조절할 수 있습니다.
+Three sizes -- `sm`, `md`, and `lg` -- allow the badge to scale proportionally with its wrapped element.
 
 ```tsx
 <div style={{
@@ -176,9 +176,9 @@ function MyComponent() {
 </div>
 ```
 
-### With Avatar
+## With Avatar
 
-아바타와 함께 사용할 수 있습니다.
+Badge pairs naturally with Avatar to indicate user status (e.g., notification count or online indicator).
 
 ```tsx
 <div style={{
@@ -195,9 +195,9 @@ function MyComponent() {
 </div>
 ```
 
-### Dot Badge
+## Dot Badge
 
-내용 없이 점으로만 표시할 수 있습니다.
+When no `badgeContent` is provided, Badge renders as a small dot. This is useful for simple presence or status indicators without a specific count.
 
 ```tsx
 <div style={{
@@ -216,9 +216,9 @@ function MyComponent() {
 </div>
 ```
 
-### Max Count
+## Max Count
 
-최대 카운트를 설정하여 숫자가 넘을 때 '+' 표시를 할 수 있습니다.
+Use the `max` prop to cap the displayed number. When `badgeContent` exceeds `max`, it renders as "max+" (e.g., "99+").
 
 ```tsx
 <div style={{
@@ -245,9 +245,9 @@ function MyComponent() {
 </div>
 ```
 
-### Show Zero
+## Show Zero
 
-기본적으로 0일 때는 숨겨지지만, showZero 옵션으로 표시할 수 있습니다.
+By default, Badge hides when `badgeContent` is `0`. Use the `showZero` prop to force it to remain visible.
 
 ```tsx
 <div style={{
@@ -276,40 +276,72 @@ function MyComponent() {
 
 ## Common Use Cases
 
-### Notification Count
+### Notification Bell
 
 ```tsx
-<Badge badgeContent={unreadCount} color="danger">
-  <IconButton>
-    <NotificationsIcon />
-  </IconButton>
-</Badge>
+import { Badge, IconButton } from '@ceed/ads';
+import NotificationsIcon from '@mui/icons-material/Notifications';
+
+function NotificationBell({ unreadCount }) {
+  return (
+    <Badge badgeContent={unreadCount} max={99} color="danger">
+      <IconButton aria-label={`${unreadCount} unread notifications`}>
+        <NotificationsIcon />
+      </IconButton>
+    </Badge>
+  );
+}
 ```
 
-### Status Indicator
+### Online Status on Avatar
 
 ```tsx
-<Badge color="success" variant="solid">
-  <Avatar src="/user-avatar.jpg" />
-</Badge>
+import { Badge, Avatar } from '@ceed/ads';
+
+function UserAvatar({ name, avatarUrl, isOnline }) {
+  return (
+    <Badge
+      color={isOnline ? 'success' : 'neutral'}
+      variant="solid"
+      anchorOrigin={{ vertical: 'bottom', horizontal: 'right' }}
+    >
+      <Avatar src={avatarUrl} alt={name} />
+    </Badge>
+  );
+}
 ```
 
-### New Items
+### New Feature Label
 
 ```tsx
-<Badge badgeContent="NEW" color="warning">
-  <Button>메뉴</Button>
-</Badge>
+import { Badge, Button } from '@ceed/ads';
+
+function FeatureButton() {
+  return (
+    <Badge badgeContent="NEW" color="warning" size="sm">
+      <Button variant="outlined">Analytics</Button>
+    </Badge>
+  );
+}
 ```
 
 ## Best Practices
 
-1. **의미 있는 색상**: 색상은 의미를 가지도록 사용하세요 (빨간색은 중요한 알림, 초록색은 성공 상태 등).
+- **Use semantic colors consistently.** Reserve `danger` for urgent notifications, `success` for positive status (e.g., online), `warning` for attention-needed items, and `primary` for neutral counts.
+  - ✔ `color="danger"` for unread message count
+  - ✘ `color="primary"` for critical alert count
+
+- **Set a `max` value for numeric badges.** Avoid displaying very large numbers like "1,247" in a tiny badge. Use `max={99}` or `max={999}` to keep the badge compact and readable.
+
+- **Keep badge content short.** Badges work best with numbers (1-3 digits) or very short text ("NEW", "HOT"). Long text will overflow and look broken.
 
-2. **적절한 콘텐츠**: 너무 긴 텍스트는 피하고, 숫자나 짧은 텍스트를 사용하세요.
+- **Use dot badges for binary states.** When the specific count does not matter (e.g., "has unread items" vs. "12 unread items"), use a dot badge by omitting `badgeContent`.
 
-3. **대비**: Badge의 색상이 배경과 충분한 대비를 가지도록 하세요.
+- **Do not badge everything.** Only add badges to elements where the count or status information is genuinely useful. Overuse diminishes their attention-grabbing effect.
 
-4. **접근성**: 시각적 정보만으로 의존하지 않고, 스크린 리더를 위한 적절한 레이블을 제공하세요.
+## Accessibility
 
-5. **일관성**: 애플리케이션 전체에서 Badge 사용 패턴을 일관되게 유지하세요.
+- Badge automatically applies `aria-label` or equivalent attributes so screen readers can announce the badge content alongside the wrapped element.
+- When using Badge on an IconButton, always provide an `aria-label` on the IconButton that includes the badge context (e.g., `aria-label="5 unread notifications"`).
+- Avoid relying solely on color to convey badge meaning. Pair colored badges with icons, text, or positional context so color-blind users can also interpret the status.
+- Dot badges (without `badgeContent`) should have an accessible label on the parent element that describes the status (e.g., "User is online").

package/dist/components/data-display/DataTable.md

@@ -865,6 +865,106 @@ const columnGroupingModel = [
 <DataTable rows={rows} columns={columns} columnGroupingModel={columnGroupingModel} />;
 ```
 
+### Column Visibility
+
+You can control which columns are visible using `columnVisibilityModel`.
+Columns set to `false` are hidden. Columns not in the model are visible by default.
+Hidden columns are completely removed from the DOM for optimal rendering performance.
+
+```tsx
+<Stack spacing={2}>
+  <Stack direction="row" spacing={1} sx={{
+    flexWrap: 'wrap'
+  }}>
+  {allColumns.map(col => <label key={col.field as string} style={{
+    display: 'flex',
+    alignItems: 'center',
+    gap: 4
+  }}>
+  <input type="checkbox" checked={visibilityModel[col.field as string] !== false} onChange={e => setVisibilityModel(prev => ({
+    ...prev,
+    [col.field as string]: e.target.checked
+  }))} />
+  {col.headerName}
+</label>)}
+</Stack>
+<DataTable rows={rows2} columns={allColumns} columnVisibilityModel={visibilityModel} onColumnVisibilityModelChange={setVisibilityModel} noWrap />
+</Stack>
+```
+
+#### Controlled Mode
+
+```tsx
+const [visibilityModel, setVisibilityModel] = useState({ fat: false });
+
+<DataTable
+  rows={rows}
+  columns={columns}
+  columnVisibilityModel={visibilityModel}
+  onColumnVisibilityModelChange={setVisibilityModel}
+/>
+```
+
+#### Uncontrolled Mode (initialState)
+
+```tsx
+<DataTable
+  rows={rows}
+  columns={columns}
+  initialState={{
+    columns: { columnVisibilityModel: { fat: false, carbs: false } },
+  }}
+/>
+```
+
+#### Column Visibility with Column Groups
+
+```tsx
+<Stack spacing={2}>
+  <Stack direction="row" spacing={1} sx={{
+    flexWrap: 'wrap'
+  }}>
+  {columns.map(col => <label key={col.field as string} style={{
+    display: 'flex',
+    alignItems: 'center',
+    gap: 4
+  }}>
+  <input type="checkbox" checked={visibilityModel[col.field as string] !== false} onChange={e => setVisibilityModel(prev => ({
+    ...prev,
+    [col.field as string]: e.target.checked
+  }))} />
+  {col.headerName}
+</label>)}
+</Stack>
+<DataTable rows={rows4} columns={columns} columnGroupingModel={[{
+  groupId: 'group1',
+  headerName: 'Group 1',
+  children: [{
+    field: 'id'
+  }, {
+    field: 'number'
+  }, {
+    field: 'string'
+  }]
+}, {
+  groupId: 'group2',
+  headerName: 'Group 2',
+  children: [{
+    field: 'date'
+  }, {
+    field: 'object'
+  }]
+}]} columnVisibilityModel={visibilityModel} onColumnVisibilityModelChange={setVisibilityModel} noWrap />
+</Stack>
+```
+
+#### Notes
+
+- Hidden columns are completely removed from the DOM for optimal performance.
+- Sorting on hidden columns is preserved — row order is maintained even if the sort column is hidden.
+- Works with column grouping: hidden columns reduce group colspan, and fully hidden groups disappear.
+- Works with pinned columns: hidden pinned columns are excluded from sticky position calculations.
+
 ### Column Resizing
 
 Setting `resizable: true` on a column allows you to adjust the column width by dragging.
@@ -895,6 +995,82 @@ const columns = [
 ];
 ```
 
+### Two-Line Headers (headerLineClamp)
+
+Setting `headerLineClamp: 2` on a column allows the header text to wrap up to 2 lines. Text exceeding 2 lines is truncated with an ellipsis, and a tooltip is displayed on hover when truncation occurs.
+
+```tsx
+<Box sx={{
+  width: 500
+}}>
+<DataTable rows={manyRows} columns={[{
+  field: 'dessert',
+  headerName: 'Dessert Name (100g serving)',
+  headerLineClamp: 2,
+  width: '120px'
+}, {
+  field: 'calories',
+  headerName: 'Calories (kcal)',
+  headerLineClamp: 2,
+  type: 'number',
+  width: '80px'
+}, {
+  field: 'fat',
+  headerName: 'Fat Content (grams)',
+  headerLineClamp: 2,
+  type: 'number',
+  width: '80px'
+}, {
+  field: 'carbs',
+  headerName: 'Total Carbohydrates (g)',
+  headerLineClamp: 2,
+  type: 'number',
+  width: '90px'
+}, {
+  field: 'protein',
+  headerName: 'Protein Amount (g)',
+  type: 'number',
+  width: '120px'
+}]} stickyHeader slotProps={{
+  background: {
+    style: {
+      height: '400px'
+    }
+  }
+}} />
+</Box>
+```
+
+```tsx
+const columns = [
+  {
+    field: 'calories',
+    headerName: 'Calories (kcal)',
+    headerLineClamp: 2,
+    type: 'number',
+    width: '80px',
+  },
+  {
+    field: 'fat',
+    headerName: 'Fat Content (grams)',
+    headerLineClamp: 2,
+    type: 'number',
+    width: '80px',
+  },
+  {
+    field: 'protein',
+    headerName: 'Protein (g)',  // no headerLineClamp — single line (default)
+    type: 'number',
+  },
+];
+```
+
+#### Notes
+
+- `headerLineClamp` is opt-in per column. Columns without it remain single-line.
+- Supported values: `1 | 2`.
+- Works with all existing features: sorting, pinning, resizing, and column grouping.
+
 ## Editing Features
 
 ### Inline Editing
@@ -1038,7 +1214,7 @@ You can use `onCellEditStart` and `onCellEditStop` to detect when editing starts
 </Typography>
 {editLog.length === 0 ? <Typography level="body-xs" textColor="text.secondary">
 No edits yet. Click on a cell to edit.
-</Typography> : editLog.map((log, i) => <Typography key={i} level="body-xs">
+</Typography> : editLog.map(log => <Typography key={log} level="body-xs">
 {log}
 </Typography>)}
 </Box>