@designbasekorea/ui-wc 0.8.9 → 0.8.12

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BadgeVariant, BadgeType, TIME_PICKER_FORMATS, DOWNLOAD_PROGRESS_STATUSES, DOWNLOAD_PROGRESS_POSITIONS, OTP_INPUT_SIZES, PHONE_VERIFY_SIZES, EMAIL_VERIFY_SIZES, TWO_FACTOR_SIZES, CHAT_ORB_SIZES, CHAT_ORB_VARIANTS, CHAT_ORB_STATES, CHAT_ORB_THEMES, CHAT_MESSAGE_ROLES, CHAT_WIDGET_VIEWS, CHAT_WIDGET_POSITIONS, ToastVariant, ToastPosition } from '@designbasekorea/ui-contracts';
+import { NavigationRailLabelDisplay, BadgeVariant, BadgeType, TIME_PICKER_FORMATS, DOWNLOAD_PROGRESS_STATUSES, DOWNLOAD_PROGRESS_POSITIONS, OTP_INPUT_SIZES, PHONE_VERIFY_SIZES, EMAIL_VERIFY_SIZES, TWO_FACTOR_SIZES, AI_GLOW_STATES, AI_GLOW_VARIANTS, AI_GLOW_SIZES, CHAT_ORB_SIZES, CHAT_ORB_VARIANTS, CHAT_ORB_STATES, CHAT_ORB_THEMES, CHAT_MESSAGE_ROLES, CHAT_WIDGET_VIEWS, CHAT_WIDGET_POSITIONS, ToastVariant, ToastPosition } from '@designbasekorea/ui-contracts';
 export { ToastPosition as DbToastPosition, ToastVariant as DbToastVariant } from '@designbasekorea/ui-contracts';
 
 /**
@@ -183,6 +183,9 @@ declare const DEFAULT_STRINGS: {
     readonly next: "다음";
     readonly 'select.placeholder': "선택하세요";
     readonly 'select.noResults': "결과 없음";
+    readonly 'navigationRail.label': "주요 내비게이션";
+    readonly 'navigationRail.newNotification': "새 알림";
+    readonly 'navigationRail.notifications': "알림";
     readonly 'tabs.label': "탭 목록";
     readonly 'pagination.label': "페이지 번호";
     readonly 'search.label': "검색";
@@ -275,6 +278,102 @@ declare abstract class DbElement extends HTMLElement {
     protected upgradeProperties(names: string[]): void;
 }
 
+declare class DbTooltip extends HTMLElement {
+    static get observedAttributes(): string[];
+    private tooltipId;
+    private trigger?;
+    private tooltip?;
+    private contentEl?;
+    private arrow?;
+    private visible;
+    private showTimer?;
+    private hideTimer?;
+    private repositionRaf?;
+    private enterRaf?;
+    private removalTimer?;
+    get content(): string;
+    set content(value: string);
+    get position(): string;
+    set position(value: string);
+    get size(): string;
+    set size(value: string);
+    get variant(): string;
+    set variant(value: string);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get alwaysShow(): boolean;
+    set alwaysShow(value: boolean);
+    get delay(): number;
+    get hideDelay(): number;
+    get maxWidth(): number;
+    get showArrow(): boolean;
+    private childObserver?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private clearTimers;
+    private groupOf;
+    private resolvedPosition;
+    private collectTriggerChildren;
+    private ensureTrigger;
+    private mountTriggerChildren;
+    private render;
+    private ensureTooltip;
+    private syncTooltipClasses;
+    private calculatePosition;
+    private setVisible;
+    private hideTooltip;
+    private removeTooltip;
+    private handleShow;
+    private handleHide;
+    private handleKeyDown;
+    private handleReposition;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-tooltip': DbTooltip;
+    }
+}
+
+interface DbNavigationRailItem {
+    id: string;
+    label: string;
+    icon: string;
+    activeIcon?: string;
+    href?: string;
+    disabled?: boolean;
+    /** true = 알림 점, 문자열/숫자 = 배지 */
+    badge?: boolean | string | number;
+    badgeColor?: 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
+    dividerBefore?: boolean;
+}
+/** Selection is controlled by active-item-id; clicks emit db-item-click. */
+declare class DbNavigationRail extends HTMLElement {
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(_name: string, oldValue: string | null, newValue: string | null): void;
+    private parseItems;
+    get items(): DbNavigationRailItem[];
+    set items(value: DbNavigationRailItem[] | string);
+    get bottomItems(): DbNavigationRailItem[];
+    set bottomItems(value: DbNavigationRailItem[] | string);
+    get activeItemId(): string;
+    set activeItemId(value: string);
+    get labelDisplay(): NavigationRailLabelDisplay;
+    set labelDisplay(value: NavigationRailLabelDisplay);
+    get size(): 's' | 'm' | 'l';
+    set size(value: 's' | 'm' | 'l');
+    get fullHeight(): boolean;
+    set fullHeight(value: boolean);
+    private renderItems;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-navigation-rail': DbNavigationRail;
+    }
+}
+
 /**
  * Light DOM custom element for the canonical web Button.
  *
@@ -467,6 +566,8 @@ declare class DbToggle extends HTMLElement {
     set readOnly(value: boolean);
     get size(): string;
     set size(value: string);
+    get variant(): string;
+    set variant(value: string);
     connectedCallback(): void;
     attributeChangedCallback(): void;
     formResetCallback(): void;
@@ -807,63 +908,6 @@ declare global {
     }
 }
 
-declare class DbTooltip extends HTMLElement {
-    static get observedAttributes(): string[];
-    private tooltipId;
-    private trigger?;
-    private tooltip?;
-    private contentEl?;
-    private arrow?;
-    private visible;
-    private showTimer?;
-    private hideTimer?;
-    private repositionRaf?;
-    private enterRaf?;
-    private removalTimer?;
-    get content(): string;
-    set content(value: string);
-    get position(): string;
-    set position(value: string);
-    get size(): string;
-    set size(value: string);
-    get variant(): string;
-    set variant(value: string);
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    get alwaysShow(): boolean;
-    set alwaysShow(value: boolean);
-    get delay(): number;
-    get hideDelay(): number;
-    get maxWidth(): number;
-    get showArrow(): boolean;
-    private childObserver?;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    attributeChangedCallback(): void;
-    private clearTimers;
-    private groupOf;
-    private resolvedPosition;
-    private collectTriggerChildren;
-    private ensureTrigger;
-    private mountTriggerChildren;
-    private render;
-    private ensureTooltip;
-    private syncTooltipClasses;
-    private calculatePosition;
-    private setVisible;
-    private hideTooltip;
-    private removeTooltip;
-    private handleShow;
-    private handleHide;
-    private handleKeyDown;
-    private handleReposition;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'db-tooltip': DbTooltip;
-    }
-}
-
 interface AccordionItemConfig {
     id?: string;
     title: string;
@@ -3146,6 +3190,8 @@ declare class DbTimePicker extends HTMLElement {
     private tempSeconds;
     private tempPeriod;
     private boundDocumentMouseDown;
+    private boundViewportChange;
+    private viewportChangeFrame;
     connectedCallback(): void;
     disconnectedCallback(): void;
     /** 열린 드롭다운은 Escape 로 닫히고 포커스는 트리거로 돌아간다 (A11Y-ESCAPE) */
@@ -3160,6 +3206,10 @@ declare class DbTimePicker extends HTMLElement {
     private get is12h();
     private get showSeconds();
     private get minuteStep();
+    private get normalizedSize();
+    private get dropdownPosition();
+    /** CSS wheel item 높이와 스크롤 계산을 같은 값으로 유지한다. */
+    private get itemHeight();
     get disabled(): boolean;
     set disabled(value: boolean);
     get readonly(): boolean;
@@ -3178,6 +3228,9 @@ declare class DbTimePicker extends HTMLElement {
     private closePicker;
     private toggleOpen;
     private handleDocumentMouseDown;
+    private handleViewportChange;
+    /** 드롭다운을 body에 고정해 overflow-hidden 컬럼에서도 잘리지 않게 한다. */
+    private positionDropdown;
     private createWheel;
     private renderSelector;
     private render;
@@ -5169,6 +5222,82 @@ declare global {
     }
 }
 
+type GlowSize = (typeof AI_GLOW_SIZES)[number];
+type GlowState = (typeof AI_GLOW_STATES)[number];
+type GlowVariant = (typeof AI_GLOW_VARIANTS)[number];
+/**
+ * AI 가 생각·작업·청취 중임을 알리는 테두리 글로우.
+ * iOS Siri·브라우저 에이전트처럼 가장자리 안쪽으로 여러 색 그라데이션이 번지며 흐른다.
+ * 콘텐츠 위에 떠 있지만 `pointer-events: none` 이라 조작을 막지 않는다.
+ *
+ * 기본은 뷰포트 전체(`position: fixed`). `contained` 를 주면 가장 가까운 positioned 조상 안에만
+ * 깔리고 모서리 둥글기도 부모를 따른다 — 부모에 `position: relative` 가 필요하다.
+ *
+ * `state="listening"` 은 음성 반응 모드다. `audioStream`(마이크 MediaStream) 또는
+ * `voice-level`(0–1) 을 넣으면 소리 크기에 맞춰 빛의 두께·밝기가 출렁인다.
+ * 둘 다 없으면 청취 중임을 알 수 있도록 말하는 듯한 잔잔한 움직임으로 대신한다.
+ *
+ * @example
+ *   <db-ai-glow active></db-ai-glow>
+ *
+ * @example
+ *   const glow = document.querySelector('db-ai-glow');
+ *   glow.state = 'listening';
+ *   glow.audioStream = await navigator.mediaDevices.getUserMedia({ audio: true });
+ *   glow.active = true;
+ */
+declare class DbAiGlow extends DbElement {
+    static get observedAttributes(): string[];
+    private status;
+    private readonly meter;
+    private inputStream;
+    private rafId;
+    private lastFrame;
+    private startedAt;
+    private level;
+    get active(): boolean;
+    set active(value: boolean);
+    get state(): GlowState;
+    set state(value: GlowState);
+    get variant(): GlowVariant;
+    set variant(value: GlowVariant);
+    get size(): GlowSize;
+    set size(value: GlowSize);
+    get contained(): boolean;
+    set contained(value: boolean);
+    /** 외부 분석기가 전달하는 정규화 음성 레벨(0–1). `listening` 상태에서만 쓰인다. */
+    get voiceLevel(): number;
+    set voiceLevel(value: number);
+    /** 켜질 때 스크린 리더에 알릴 문구(예: "AI가 화면을 제어하는 중"). 없으면 순수 장식이다. */
+    get label(): string;
+    set label(value: string);
+    /**
+     * 실제 마이크/통화 MediaStream. 음량만 분석하며 트랙을 stop() 하지 않는다.
+     * null 을 넣으면 분석만 해제한다.
+     */
+    get audioStream(): MediaStream | null;
+    set audioStream(stream: MediaStream | null);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private onMotionChange;
+    /** 구조는 한 번만 만든다 (PERF-RECONCILE) */
+    private ensureStructure;
+    /** 소비자가 붙인 className 은 건드리지 않고 수식어만 교체한다 */
+    private syncClasses;
+    private syncStatus;
+    /** 음성 반응 루프는 청취 중 + 켜짐 + 모션 허용일 때만 돈다. 나머지 애니메이션은 전부 CSS 다. */
+    private syncLoop;
+    private stopLoop;
+    private frame;
+    private sampleLevel;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-glow': DbAiGlow;
+    }
+}
+
 type OrbSize = (typeof CHAT_ORB_SIZES)[number];
 type OrbVariant = (typeof CHAT_ORB_VARIANTS)[number];
 type OrbState = (typeof CHAT_ORB_STATES)[number];
@@ -5292,7 +5421,7 @@ declare global {
     }
 }
 
-type DbIconName = 'arrow-bar-left' | 'arrow-bar-right' | 'award' | 'apple' | 'play-store' | 'arrow-right' | 'star' | 'star-filled' | 'star-half' | 'trending-up' | 'cart' | 'bell-active' | 'caret-down-filled' | 'caret-updown-filled' | 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'calendar' | 'camera' | 'clock' | 'bulb' | 'circle-checked' | 'cloud-close' | 'close' | 'done' | 'documentation' | 'doughnut-chart' | 'download' | 'error-filled' | 'edit' | 'eyedropper' | 'file-new' | 'folder-open' | 'gallery' | 'globe' | 'hide' | 'info-filled' | 'lock' | 'mail' | 'menu' | 'microphone' | 'minus' | 'moon' | 'more-vertical' | 'paperclip' | 'pause' | 'play' | 'plus' | 'copy' | 'code' | 'write' | 'upload' | 'video' | 'volume-up' | 'mute-filled' | 'package' | 'delivery-filled' | 'repeat' | 'settings' | 'refresh' | 'expand' | 'shrink' | 'grip-vertical' | 'grip-horizontal' | 'search' | 'send' | 'share-alt' | 'show' | 'sparkle' | 'stop' | 'sun' | 'thumb-down' | 'thumb-up' | 'trash' | 'user' | 'warning-filled';
+type DbIconName = 'arrow-bar-left' | 'arrow-bar-right' | 'award' | 'apple' | 'play-store' | 'arrow-right' | 'star' | 'star-filled' | 'star-half' | 'trending-up' | 'cart' | 'bell-active' | 'caret-down-filled' | 'caret-updown-filled' | 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'calendar' | 'camera' | 'clock' | 'bulb' | 'circle-checked' | 'cloud-close' | 'close' | 'done' | 'documentation' | 'doughnut-chart' | 'download' | 'error-filled' | 'edit' | 'eyedropper' | 'file-new' | 'home-outline' | 'home-filled' | 'folder' | 'more-horizontal' | 'folder-open' | 'gallery' | 'globe' | 'hide' | 'info-filled' | 'lock' | 'mail' | 'menu' | 'microphone' | 'minus' | 'moon' | 'more-vertical' | 'paperclip' | 'pause' | 'play' | 'plus' | 'copy' | 'code' | 'write' | 'upload' | 'video' | 'volume-up' | 'mute-filled' | 'package' | 'delivery-filled' | 'repeat' | 'settings' | 'refresh' | 'expand' | 'shrink' | 'grip-vertical' | 'grip-horizontal' | 'search' | 'send' | 'share-alt' | 'show' | 'sparkle' | 'stop' | 'sun' | 'thumb-down' | 'thumb-up' | 'trash' | 'user' | 'warning-filled';
 
 interface DbChatTool {
     /** 고유 id (이벤트 detail 로 전달) */
@@ -6096,5 +6225,5 @@ interface DbConfirmOptions {
 /** 확인 대화상자를 띄우고, 확인 시 true / 취소(ESC·배경 포함) 시 false 로 resolve 합니다. */
 declare function confirm(options: DbConfirmOptions): Promise<boolean>;
 
-export { CleanupBag, DbAccordion, DbActivityHeatmap, DbAdBanner, DbAiChat, DbAiChatList, DbAlert, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbButton, DbCalendar, DbCard, DbCarousel, DbChatComposer, DbChatList, DbChatMessage, DbChatOrb, DbChatRoom, DbChatSuggestions, DbChatTyping, DbChatWelcome, DbChatWidget, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbColorSwatch, DbConfirm, DbContainer, DbContextMenu, DbCookieBanner, DbCountdown, DbCursorFollower, DbDatePicker, DbDivider, DbDownloadProgress, DbDrawer, DbDropdown, DbDropzone, DbElement, DbEmailVerify, DbEmptyState, DbFileUploader, DbFloatingActionButton, DbFooter, DbForm, DbGantt, DbGradient, DbGrid, DbGridBackground, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbKanban, DbLabel, DbLightbox, DbList, DbLogo, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbModal, DbNavbar, DbOnboardingModal, DbOtpInput, DbPageHeader, DbPagination, DbPhoneVerify, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReorder, DbResizablePanels, DbScrollArea, DbSearchBar, DbSection, DbSectionAppDownload, DbSectionContact, DbSectionCta, DbSectionFaq, DbSectionFeature, DbSectionFeatureGrid, DbSectionHero, DbSectionLogoCloud, DbSectionPricing, DbSectionStats, DbSectionTestimonials, DbSegmentControl, DbSelect, DbShare, DbSidebar, DbSignature, DbSkeleton, DbSpinner, DbSplitView, DbStack, DbStat, DbStepper, DbTable, DbTabs, DbTestimonial, DbTextarea, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbTwoFactor, DbVideoPlayer, DbYouTubePlayer, activateOnKey, announce, confirm, createFocusTrap, createSrOnly, confirm as dbConfirm, dbResetLocale, dbSetLocale, toast as dbToast, dbUid, ensureId, getTabbables, labelFrom, lockScroll, politenessForTone, rafThrottle, sanitizeHref, sanitizeHtmlFragment, scrollLockDepth, setAccessibleName, showToast, t, toast, unlockScroll };
-export type { CalendarEventData, CalendarEventType, Cleanup, DbActivityHeatmapCellDetail, DbActivityHeatmapItem, DbAiChatItem, DbAlertAction, DbArtifactOptions, DbBannerAction, DbBottomNavigationItem, DbChatArtifactRef, DbChatAttachOption, DbChatListItem, DbChatMessageAttachment, DbChatMessageData, DbChatRoomMessage, DbChatSuggestion, DbChatTool, DbChatWidgetArticle, DbChatWidgetConversation, DbChatWidgetMenuAction, DbChatWidgetMenuItem, DbChatWidgetMessage, DbColorSwatchCustomType, DbColorSwatchItem, DbColorSwatchShape, DbColorSwatchSize, DbConfirmOptions, DbConfirmVariant, DbFooterCompanyInfo, DbFooterFamilySite, DbFooterLink, DbFooterLinkColumn, DbFooterSocialLink, DbFormFieldData, DbGanttAssignee, DbGanttGroup, DbGanttItem, DbGanttItemStatus, DbGanttRow, DbImageListItem, DbKanbanAssignee, DbKanbanCard, DbKanbanColumn, DbKanbanPriority, DbKanbanTag, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbPageHeaderTabItem, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarProject, DbSidebarPromoBanner, DbSidebarSection, DbSidebarUserProfile, DbSignaturePoint, DbSignatureVariant, DbStatChange, DbStringKey, DbStrings, DbTimelineItem, DbToastApi, DbToastHandle, DbToastOptions, FocusTrap, FocusTrapOptions };
+export { CleanupBag, DbAccordion, DbActivityHeatmap, DbAdBanner, DbAiChat, DbAiChatList, DbAiGlow, DbAlert, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbButton, DbCalendar, DbCard, DbCarousel, DbChatComposer, DbChatList, DbChatMessage, DbChatOrb, DbChatRoom, DbChatSuggestions, DbChatTyping, DbChatWelcome, DbChatWidget, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbColorSwatch, DbConfirm, DbContainer, DbContextMenu, DbCookieBanner, DbCountdown, DbCursorFollower, DbDatePicker, DbDivider, DbDownloadProgress, DbDrawer, DbDropdown, DbDropzone, DbElement, DbEmailVerify, DbEmptyState, DbFileUploader, DbFloatingActionButton, DbFooter, DbForm, DbGantt, DbGradient, DbGrid, DbGridBackground, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbKanban, DbLabel, DbLightbox, DbList, DbLogo, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbModal, DbNavbar, DbNavigationRail, DbOnboardingModal, DbOtpInput, DbPageHeader, DbPagination, DbPhoneVerify, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReorder, DbResizablePanels, DbScrollArea, DbSearchBar, DbSection, DbSectionAppDownload, DbSectionContact, DbSectionCta, DbSectionFaq, DbSectionFeature, DbSectionFeatureGrid, DbSectionHero, DbSectionLogoCloud, DbSectionPricing, DbSectionStats, DbSectionTestimonials, DbSegmentControl, DbSelect, DbShare, DbSidebar, DbSignature, DbSkeleton, DbSpinner, DbSplitView, DbStack, DbStat, DbStepper, DbTable, DbTabs, DbTestimonial, DbTextarea, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbTwoFactor, DbVideoPlayer, DbYouTubePlayer, activateOnKey, announce, confirm, createFocusTrap, createSrOnly, confirm as dbConfirm, dbResetLocale, dbSetLocale, toast as dbToast, dbUid, ensureId, getTabbables, labelFrom, lockScroll, politenessForTone, rafThrottle, sanitizeHref, sanitizeHtmlFragment, scrollLockDepth, setAccessibleName, showToast, t, toast, unlockScroll };
+export type { CalendarEventData, CalendarEventType, Cleanup, DbActivityHeatmapCellDetail, DbActivityHeatmapItem, DbAiChatItem, DbAlertAction, DbArtifactOptions, DbBannerAction, DbBottomNavigationItem, DbChatArtifactRef, DbChatAttachOption, DbChatListItem, DbChatMessageAttachment, DbChatMessageData, DbChatRoomMessage, DbChatSuggestion, DbChatTool, DbChatWidgetArticle, DbChatWidgetConversation, DbChatWidgetMenuAction, DbChatWidgetMenuItem, DbChatWidgetMessage, DbColorSwatchCustomType, DbColorSwatchItem, DbColorSwatchShape, DbColorSwatchSize, DbConfirmOptions, DbConfirmVariant, DbFooterCompanyInfo, DbFooterFamilySite, DbFooterLink, DbFooterLinkColumn, DbFooterSocialLink, DbFormFieldData, DbGanttAssignee, DbGanttGroup, DbGanttItem, DbGanttItemStatus, DbGanttRow, DbImageListItem, DbKanbanAssignee, DbKanbanCard, DbKanbanColumn, DbKanbanPriority, DbKanbanTag, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbNavigationRailItem, DbPageHeaderTabItem, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarProject, DbSidebarPromoBanner, DbSidebarSection, DbSidebarUserProfile, DbSignaturePoint, DbSignatureVariant, DbStatChange, DbStringKey, DbStrings, DbTimelineItem, DbToastApi, DbToastHandle, DbToastOptions, FocusTrap, FocusTrapOptions };