@designbasekorea/ui-wc 0.9.0 → 0.9.3

package/dist/index.d.ts

@@ -162,6 +162,56 @@ declare function activateOnKey(el: HTMLElement, options?: {
  */
 /** 컴포넌트가 쓰는 문자열 키 → 기본(한국어) 값 */
 declare const DEFAULT_STRINGS: {
+    readonly "upload.title": "파일을 드래그하여 업로드하거나 클릭하여 선택하세요";
+    readonly "upload.choose": "파일 선택";
+    readonly "upload.allFormats": "모든 파일 형식 지원";
+    readonly "upload.maximum": " (최대 {size})";
+    readonly "upload.files": "업로드된 파일들 ({count}개)";
+    readonly "upload.retry": "재시도";
+    readonly "upload.remove": "삭제";
+    readonly "upload.illustration": "업로드 일러스트";
+    readonly "creditCard.security": "보안 코드 {code}";
+    readonly "creditCard.label": "{issuer} 카드{lastFour}, 뒤집기";
+    readonly "creditCard.ending": ", 끝자리 {digits}";
+    readonly "creditCard.front": "앞면";
+    readonly "creditCard.back": "뒷면";
+    readonly "creditCard.showing": "{side} 표시 중";
+    readonly "creditCard.expiry": "유효기간 {expiry}";
+    readonly "creditCard.show": "누르면 {side}을 표시합니다";
+    readonly "flight.scheduled": "출발 예정";
+    readonly "flight.boarding": "탑승 중";
+    readonly "flight.in-flight": "운항 중";
+    readonly "flight.landed": "도착";
+    readonly "flight.delayed": "지연";
+    readonly "flight.cancelled": "취소";
+    readonly "flight.title": "운항 현황";
+    readonly "flight.progress": "여정 진행률";
+    readonly "boardingPass.origin": "출발";
+    readonly "boardingPass.destination": "도착";
+    readonly "boardingPass.passenger": "탑승객";
+    readonly "boardingPass.service": "편명";
+    readonly "boardingPass.date": "날짜";
+    readonly "boardingPass.boarding": "탑승 시각";
+    readonly "boardingPass.departure": "출발 시각";
+    readonly "boardingPass.arrival": "도착 시각";
+    readonly "boardingPass.terminal": "터미널";
+    readonly "boardingPass.gate": "게이트";
+    readonly "boardingPass.seat": "좌석";
+    readonly "boardingPass.travelClass": "등급";
+    readonly "boardingPass.title": "탑승권";
+    readonly "wallet.title": "나의 탑승권";
+    readonly "wallet.empty": "등록된 탑승권이 없습니다.";
+    readonly "wallet.journeys": "여정 선택";
+    readonly "receipt.quantity": "수량";
+    readonly "receipt.subtotal": "소계";
+    readonly "receipt.discount": "할인";
+    readonly "receipt.tax": "세금";
+    readonly "receipt.total": "합계";
+    readonly "receipt.payment": "결제수단";
+    readonly "receipt.empty": "표시할 품목이 없습니다.";
+    readonly "receipt.invalid": "품목과 금액 정보를 확인해주세요.";
+    readonly "receipt.title": "영수증";
+    readonly "paper.codeImage": "코드 이미지";
     readonly 'aiElement.emptyFolder': "빈 폴더";
     readonly 'aiElement.noFiles': "표시할 파일이 없습니다.";
     readonly 'attachment.title': "첨부 파일";
@@ -357,9 +407,23 @@ declare const DEFAULT_STRINGS: {
     readonly 'tweetCard.reply': "답글";
     readonly 'tweetCard.verified': "인증된 계정";
     readonly 'tweetCard.retry': "다시 시도";
+    readonly 'chatComposer.placeholder': "메시지를 입력하세요…";
+    readonly 'chatComposer.send': "전송";
+    readonly 'chatComposer.stop': "생성 중지";
+    readonly 'chatComposer.attach': "첨부";
+    readonly 'voice.start': "음성 입력";
+    readonly 'voice.stop': "받아쓰기 완료";
+    readonly 'voice.cancel': "음성 입력 취소";
+    readonly 'voice.starting': "마이크 연결 중";
+    readonly 'voice.listening': "음성 인식 중";
+    readonly 'voice.stopping': "마지막 문장 확인 중";
+    readonly 'voice.error': "음성 인식 실패";
+    readonly 'voice.unsupported': "음성 입력 미지원";
 };
 type DbStringKey = keyof typeof DEFAULT_STRINGS;
 type DbStrings = Partial<Record<DbStringKey, string>> & Record<string, string>;
+/** Select built-in defaults. Explicit dbSetLocale overrides remain authoritative. */
+declare function dbUseLocale(locale: 'en' | 'ko'): void;
 /**
  * 문자열을 전역으로 덮어쓴다. 앱 부트스트랩에서 한 번 호출한다.
  *
@@ -1507,8 +1571,20 @@ interface DbAlertAction {
 }
 declare class DbAlert extends HTMLElement {
     static get observedAttributes(): string[];
+    /** 소비자가 넣은 자식(링크·코드 등)을 담아 두는 내부 컨테이너. 렌더 사이에 유지된다. */
+    private slotEl?;
+    private observer?;
+    /** 슬롯 내부 변경(React 가 래퍼 안 자식을 바꿀 때)을 감지해 빈 슬롯 여부를 다시 계산한다 */
+    private slotObserver?;
+    private renderedSlotted;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(): void;
+    private getSlot;
+    /** 호스트에 직접 붙은 소비자 노드를 슬롯으로 옮긴다. 공백 텍스트는 버린다. */
+    private moveChildrenToSlot;
+    private adoptChildren;
+    private hasSlotted;
     private getIconName;
     private parseActionButtons;
     private render;
@@ -1690,6 +1766,7 @@ declare class DbDrawer extends HTMLElement {
     /** 잠근 적이 있을 때만 푼다 — 카운트가 음수로 새지 않도록 */
     private releaseScrollLock;
     attributeChangedCallback(name: string): void;
+    private syncInteraction;
     private isOpenRequested;
     private clearTimers;
     private attachEscape;
@@ -2151,8 +2228,10 @@ interface DbImageListItem {
 declare class DbImageList extends HTMLElement {
     private lightboxEl;
     private selectedIndex;
+    private carouselEngine?;
     static get observedAttributes(): string[];
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(): void;
     private parseImages;
     private mapRoundedAttr;
@@ -2181,6 +2260,9 @@ declare class DbLightbox extends HTMLElement {
     private scrollLocked;
     private readonly titleId;
     private imageEl;
+    private carouselEngine?;
+    private carouselViewport;
+    private slideSignature;
     private loadingEl;
     private errorEl;
     private counterBadge;
@@ -2203,6 +2285,7 @@ declare class DbLightbox extends HTMLElement {
     private resetImageState;
     private close;
     private goTo;
+    private ensureCarousel;
     private createIconButton;
     private buildPortal;
     private handleImageLoad;
@@ -2785,10 +2868,6 @@ declare global {
     }
 }
 
-/**
- * SegmentControl Web Component
- * packages/ui SegmentControl.tsx와 DOM·동작·스타일 1:1 동기화
- */
 interface DbSegmentOptionData {
     value: string;
     label: string;
@@ -2824,9 +2903,6 @@ declare global {
     }
 }
 
-/**
- * Stepper Web Component
- */
 declare class DbStepper extends HTMLElement {
     static get observedAttributes(): string[];
     private decrementBtn;
@@ -3066,6 +3142,12 @@ declare class DbPageHeader extends HTMLElement {
     private internalTabId;
     private childObserver?;
     private isRendering;
+    private stickyMarker?;
+    private stickyObserver?;
+    private compact;
+    private refreshSticky;
+    private observeSticky;
+    private setCompact;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
@@ -3786,7 +3868,8 @@ type DbCarouselItem = {
 };
 declare class DbCarousel extends HTMLElement {
     private currentIndex;
-    private timer;
+    private engine?;
+    private autoplay?;
     private isAutoPlaying;
     static get observedAttributes(): string[];
     get items(): DbCarouselItem[];
@@ -3796,8 +3879,7 @@ declare class DbCarousel extends HTMLElement {
     attributeChangedCallback(name: string): void;
     private getBool;
     private clampCurrentIndex;
-    private stopAutoPlay;
-    private startAutoPlay;
+    private destroyEngine;
     private getIndicatorType;
     private getIndicatorSize;
     private goTo;
@@ -4650,10 +4732,8 @@ declare class DbSectionTestimonials extends HTMLElement {
     private innerEl?;
     private headerEl?;
     private contentEl?;
-    private carouselViewport?;
-    private carouselTrack?;
+    private carouselEngine?;
     private carouselIndicator?;
-    private resizeObserver?;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
@@ -4664,7 +4744,6 @@ declare class DbSectionTestimonials extends HTMLElement {
     private createTestimonialEl;
     private updateHeader;
     private clampCarouselIndex;
-    private updateCarouselTransform;
     private goToCarouselSlide;
     private renderGrid;
     private renderCarousel;
@@ -4782,15 +4861,8 @@ declare class DbMarquee extends HTMLElement {
     private resizeObserver?;
     private containerWidth;
     private gap;
-    private scrollVelocityEnabled;
-    private rafId;
-    private lastFrameTime;
-    private lastScrollY;
-    private smoothedScrollV;
     private baseDurationSec;
-    private reduceMotion;
     private boundMeasure;
-    private boundFrame;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
@@ -4815,9 +4887,8 @@ declare class DbMarquee extends HTMLElement {
     /** 트랙을 채울 만큼의 복제 그룹 개수를 델타만 조정한다. */
     private reconcileDuplicates;
     private syncReadyState;
-    private startScrollEngine;
-    private stopScrollEngine;
-    private frame;
+    private stopEngines;
+    private syncEngines;
     private updateUI;
 }
 declare global {
@@ -5416,12 +5487,6 @@ declare global {
     }
 }
 
-/**
- * ui-wc — db-email-verify (수동 작성, 자동 동기화 대상 아님)
- *
- * 이메일 인증: code(OTP) 모드 / confirm(메일함 확인) 모드.
- */
-
 type Size$1 = (typeof EMAIL_VERIFY_SIZES)[number];
 declare class DbEmailVerify extends HTMLElement {
     static get observedAttributes(): string[];
@@ -5474,24 +5539,18 @@ declare global {
     }
 }
 
-/**
- * ui-wc — db-two-factor (수동 작성, 자동 동기화 대상 아님)
- *
- * 2단계 인증(2FA): 인증앱 / SMS / 이메일 방식 + OTP.
- */
-
 type Size = (typeof TWO_FACTOR_SIZES)[number];
-declare const METHODS: readonly [{
+declare const METHODS: () => readonly [{
     readonly value: "app";
-    readonly label: "인증 앱";
+    readonly label: string;
 }, {
     readonly value: "sms";
     readonly label: "SMS";
 }, {
     readonly value: "email";
-    readonly label: "이메일";
+    readonly label: string;
 }];
-type Method = (typeof METHODS)[number]['value'];
+type Method = ReturnType<typeof METHODS>[number]['value'];
 declare class DbTwoFactor extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
@@ -8351,5 +8410,5 @@ declare global {
     }
 }
 
-export { CleanupBag, DEVICE_MOCKUP_SCREENS, DbAccordion, DbAchievementList, DbAchievementModal, DbActivityHeatmap, DbAdBanner, DbAiChainOfThought, DbAiChat, DbAiChatList, DbAiCheckpoint, DbAiConfirmation, DbAiContext, DbAiConversation, DbAiExecutionQuote, DbAiFileTree, DbAiGlow, DbAiInlineCitation, DbAiMessage, DbAiModelSelect, DbAiPlan, DbAiQueue, DbAiReasoning, DbAiSources, DbAiStackTrace, DbAiSubagent, DbAiTask, DbAiTaskStatus, DbAiTerminal, DbAiTestResults, DbAiTool, DbAlert, DbAndroidMockup, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAppleWatchMockup, DbAttachmentList, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBentoCard, DbBentoGrid, DbBoardingPass, DbBoardingPassStack, DbBorderBeam, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbBrowserMockup, DbButton, DbCalendar, DbCard, DbCarousel, DbChatComposer, DbChatList, DbChatMessage, DbChatOrb, DbChatRoom, DbChatSuggestions, DbChatTyping, DbChatWelcome, DbChatWidget, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbColorSwatch, DbConfetti, DbConfirm, DbContainer, DbContextBar, DbContextMenu, DbCookieBanner, DbCountdown, DbCreditBalance, DbCreditCard, DbCreditDropdown, DbCreditHistory, DbCreditRecharge, DbCreditRechargeModal, DbCursorFollower, DbDatePicker, DbDesignCanvas, DbDesignToolbar, DbDivider, DbDownloadProgress, DbDrawer, DbDropdown, DbDropzone, DbDuoMockup, DbElement, DbEmailVerify, DbEmptyState, DbFileUploader, DbFilterBar, DbFlightStatus, DbFlipMockup, DbFloatingActionButton, DbFoldMockup, DbFooter, DbForm, DbGantt, DbGlyphMatrix, DbGradient, DbGrid, DbGridBackground, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbIosMockup, DbKanban, DbLabel, DbLightbox, DbList, DbLogo, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbMobileMockup, DbModal, DbNavbar, DbNavigationRail, DbNode, DbNotificationDropdown, DbNotificationInbox, DbOnboardingModal, DbOtpInput, DbPageHeader, DbPagination, DbPhoneVerify, DbPlanOverview, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbProgressiveBlur, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReceipt, 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, DbTabletMockup, DbTabs, DbTestimonial, DbTextarea, DbTicket, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolButton, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbTweetCard, DbTwoFactor, DbVideoPlayer, DbVoiceControl, DbWorkspaceInviteModal, DbWorkspaceMembers, DbYouTubePlayer, NODE_STATUSES, NODE_VARIANTS, PAYMENT_BRANDS, activateOnKey, announce, confetti, confirm, createFocusTrap, createSrOnly, confirm as dbConfirm, dbResetLocale, dbSetLocale, toast as dbToast, dbUid, ensureId, getPaymentBrand, getTabbables, labelFrom, lockScroll, politenessForTone, rafThrottle, sanitizeHref, sanitizeHtmlFragment, scrollLockDepth, setAccessibleName, showToast, t, toast, unlockScroll };
+export { CleanupBag, DEVICE_MOCKUP_SCREENS, DbAccordion, DbAchievementList, DbAchievementModal, DbActivityHeatmap, DbAdBanner, DbAiChainOfThought, DbAiChat, DbAiChatList, DbAiCheckpoint, DbAiConfirmation, DbAiContext, DbAiConversation, DbAiExecutionQuote, DbAiFileTree, DbAiGlow, DbAiInlineCitation, DbAiMessage, DbAiModelSelect, DbAiPlan, DbAiQueue, DbAiReasoning, DbAiSources, DbAiStackTrace, DbAiSubagent, DbAiTask, DbAiTaskStatus, DbAiTerminal, DbAiTestResults, DbAiTool, DbAlert, DbAndroidMockup, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAppleWatchMockup, DbAttachmentList, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBentoCard, DbBentoGrid, DbBoardingPass, DbBoardingPassStack, DbBorderBeam, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbBrowserMockup, DbButton, DbCalendar, DbCard, DbCarousel, DbChatComposer, DbChatList, DbChatMessage, DbChatOrb, DbChatRoom, DbChatSuggestions, DbChatTyping, DbChatWelcome, DbChatWidget, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbColorSwatch, DbConfetti, DbConfirm, DbContainer, DbContextBar, DbContextMenu, DbCookieBanner, DbCountdown, DbCreditBalance, DbCreditCard, DbCreditDropdown, DbCreditHistory, DbCreditRecharge, DbCreditRechargeModal, DbCursorFollower, DbDatePicker, DbDesignCanvas, DbDesignToolbar, DbDivider, DbDownloadProgress, DbDrawer, DbDropdown, DbDropzone, DbDuoMockup, DbElement, DbEmailVerify, DbEmptyState, DbFileUploader, DbFilterBar, DbFlightStatus, DbFlipMockup, DbFloatingActionButton, DbFoldMockup, DbFooter, DbForm, DbGantt, DbGlyphMatrix, DbGradient, DbGrid, DbGridBackground, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbIosMockup, DbKanban, DbLabel, DbLightbox, DbList, DbLogo, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbMobileMockup, DbModal, DbNavbar, DbNavigationRail, DbNode, DbNotificationDropdown, DbNotificationInbox, DbOnboardingModal, DbOtpInput, DbPageHeader, DbPagination, DbPhoneVerify, DbPlanOverview, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbProgressiveBlur, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReceipt, 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, DbTabletMockup, DbTabs, DbTestimonial, DbTextarea, DbTicket, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolButton, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbTweetCard, DbTwoFactor, DbVideoPlayer, DbVoiceControl, DbWorkspaceInviteModal, DbWorkspaceMembers, DbYouTubePlayer, NODE_STATUSES, NODE_VARIANTS, PAYMENT_BRANDS, activateOnKey, announce, confetti, confirm, createFocusTrap, createSrOnly, confirm as dbConfirm, dbResetLocale, dbSetLocale, toast as dbToast, dbUid, dbUseLocale, ensureId, getPaymentBrand, getTabbables, labelFrom, lockScroll, politenessForTone, rafThrottle, sanitizeHref, sanitizeHtmlFragment, scrollLockDepth, setAccessibleName, showToast, t, toast, unlockScroll };
 export type { CalendarEventData, CalendarEventType, Cleanup, ConfettiFireworkOptions, ConfettiFunction, ConfettiParticleOptions, DbAchievementItem, DbActivityHeatmapCellDetail, DbActivityHeatmapItem, DbAiAction, DbAiChatItem, DbAiItem, DbAiModelOption, DbAiModelSelection, DbAiQuoteExecution, DbAiQuoteView, DbAiStatus, DbAiTaskAction, DbAiTaskState, DbAlertAction, DbArtifactOptions, DbAttachment, DbAttachmentAction, DbAttachmentState, DbBannerAction, DbBoardingPassLabels, DbBottomNavigationItem, DbChatArtifactRef, DbChatAttachOption, DbChatListItem, DbChatMessageAttachment, DbChatMessageData, DbChatRoomMessage, DbChatSuggestion, DbChatTool, DbChatWidgetArticle, DbChatWidgetConversation, DbChatWidgetMenuAction, DbChatWidgetMenuItem, DbChatWidgetMessage, DbColorSwatchCustomType, DbColorSwatchItem, DbColorSwatchShape, DbColorSwatchSize, DbConfirmOptions, DbConfirmVariant, DbCreditCardFlip, DbCreditCardOrientation, DbCreditCardVariant, DbCreditEntry, DbCreditEntryKind, DbCreditPlan, DbCreditPlanSelection, DbFlightStatusValue, DbFooterCompanyInfo, DbFooterFamilySite, DbFooterLink, DbFooterLinkColumn, DbFooterSocialLink, DbFormFieldData, DbGanttAssignee, DbGanttGroup, DbGanttItem, DbGanttItemStatus, DbGanttRow, DbImageListItem, DbKanbanAssignee, DbKanbanCard, DbKanbanColumn, DbKanbanPriority, DbKanbanTag, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbNavigationRailItem, DbNodeMove, DbNodePort, DbNodePortDrag, DbNodePortSelect, DbNodePortType, DbNotificationAction, DbNotificationItem, DbNotificationReadAll, DbPageHeaderTabItem, DbPaperAction, DbPaperField, DbPlanFeature, DbReceiptItem, DbReceiptLabels, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarProject, DbSidebarPromoBanner, DbSidebarSection, DbSidebarUserProfile, DbSignaturePoint, DbSignatureVariant, DbStatChange, DbStringKey, DbStrings, DbTimelineItem, DbToastApi, DbToastHandle, DbToastOptions, ToastPosition as DbToastPosition, ToastVariant as DbToastVariant, DbTravelPass, DbTravelPassChange, DbTweetData, DbVoiceState, DbWorkspaceInviteDraft, DbWorkspaceInviteRole, DbWorkspaceMember, DbWorkspaceMemberAction, DbWorkspaceMemberState, DesignCanvasChange, DesignCanvasNode, DesignCanvasViewport, DesignToolAction, DesignToolOption, DesignToolbarItem, FileStatus, FilterBarAlign, FilterBarSize, FilterBarVariant, FocusTrap, FocusTrapOptions, GradientScheme, GradientTone, UploadFile };