@designbasekorea/ui-wc 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -139,12 +139,16 @@ declare global {
 }
 
 declare class DbToggle extends HTMLElement {
+    static readonly formAssociated = true;
     static get observedAttributes(): string[];
+    private readonly internals;
     private root?;
     private labelEl?;
     private built;
     get checked(): boolean;
     set checked(value: boolean);
+    get name(): string;
+    set name(value: string);
     get disabled(): boolean;
     set disabled(value: boolean);
     get readOnly(): boolean;
@@ -153,7 +157,10 @@ declare class DbToggle extends HTMLElement {
     set size(value: string);
     connectedCallback(): void;
     attributeChangedCallback(): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
     private get hasLabel();
+    private syncFormValue;
     private build;
     private handleClick;
     private syncState;
@@ -302,6 +309,9 @@ declare class DbTabs extends HTMLElement {
     get labels(): string[] | string;
     set labels(value: string[] | string);
     get tabItems(): TabItemConfig[];
+    get items(): TabItemConfig[];
+    set items(value: TabItemConfig[] | string);
+    set tabItems(value: TabItemConfig[] | string);
     get activeIndex(): number;
     set activeIndex(value: number);
     get orientation(): string;
@@ -469,6 +479,8 @@ declare class DbTooltip extends HTMLElement {
     private showTimer?;
     private hideTimer?;
     private repositionRaf?;
+    private enterRaf?;
+    private removalTimer?;
     get content(): string;
     set content(value: string);
     get position(): string;
@@ -500,6 +512,7 @@ declare class DbTooltip extends HTMLElement {
     private syncTooltipClasses;
     private calculatePosition;
     private setVisible;
+    private hideTooltip;
     private removeTooltip;
     private handleShow;
     private handleHide;
@@ -582,11 +595,21 @@ declare global {
 
 declare class DbProgress extends HTMLElement {
     static get observedAttributes(): string[];
+    private structureSignature;
+    private barEl?;
+    private linearValueEl?;
+    private circularBarEl?;
+    private circularValueEl?;
+    private circumference;
     get value(): number;
     set value(value: number);
     connectedCallback(): void;
     attributeChangedCallback(): void;
     private render;
+    private buildLinear;
+    private updateLinear;
+    private buildCircular;
+    private updateCircular;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -595,7 +618,9 @@ declare global {
 }
 
 declare class DbSelect extends HTMLElement {
+    static readonly formAssociated = true;
     static get observedAttributes(): string[];
+    private readonly internals;
     private labelEl?;
     private trigger?;
     private valueEl?;
@@ -611,12 +636,16 @@ declare class DbSelect extends HTMLElement {
     private built;
     private searchTerm;
     private focusedIndex;
+    get name(): string;
+    set name(value: string);
     get open(): boolean;
     set open(value: boolean);
     get value(): string;
     set value(value: string);
     connectedCallback(): void;
     disconnectedCallback(): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
     attributeChangedCallback(name: string): void;
     get multiple(): boolean;
     set multiple(value: boolean);
@@ -1011,7 +1040,8 @@ declare class DbToast extends HTMLElement {
     attributeChangedCallback(name: string): void;
     private clearTimers;
     private startTimers;
-    private close;
+    /** 토스트를 닫고(애니메이션 포함) auto-remove 설정 시 DOM에서 제거합니다. */
+    close(): void;
     private iconForStatus;
     private render;
 }
@@ -1062,6 +1092,10 @@ declare class DbIndicator extends HTMLElement {
     set size(value: string);
     get direction(): string;
     set direction(value: string);
+    get numberBackground(): boolean;
+    set numberBackground(value: boolean);
+    get playback(): boolean;
+    set playback(value: boolean);
     get clickable(): boolean;
     set clickable(value: boolean);
     get timer(): boolean;
@@ -1080,6 +1114,14 @@ declare class DbIndicator extends HTMLElement {
     private renderStep;
     private renderDots;
     private renderPlaybackButton;
+    private renderNumbers;
+    private renderSlide;
+    private renderScaleFill;
+    private renderLine;
+    private renderDotLine;
+    private fillRatio;
+    private renderFill;
+    private renderContent;
     private render;
 }
 declare global {
@@ -1400,6 +1442,7 @@ declare class DbLightbox extends HTMLElement {
     private imageError;
     private keydownHandler;
     private boundSrc;
+    private thumbnailSignature;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -1443,6 +1486,8 @@ declare class DbBottomNavigation extends HTMLElement {
     static get observedAttributes(): string[];
     connectedCallback(): void;
     attributeChangedCallback(): void;
+    get items(): DbBottomNavigationItem[];
+    set items(value: DbBottomNavigationItem[] | string);
     private parseItems;
     private iconSize;
     private syncHostClasses;
@@ -1459,9 +1504,34 @@ interface DbNavbarItem {
     label: string;
     href?: string;
     icon?: string;
+    /** 메가 메뉴 링크에서 라벨 아래 표시되는 보조 설명 */
+    description?: string;
     active?: boolean;
     disabled?: boolean;
     children?: DbNavbarItem[];
+    /** children 대신 메가 메뉴(다단 패널) 스타일로 렌더링 */
+    megaMenu?: boolean;
+    /** 메가 메뉴 컬럼 목록 */
+    columns?: DbNavbarMegaColumn[];
+    /** 메가 메뉴 우측 강조(피처드) 영역 */
+    featured?: DbNavbarMegaFeatured;
+}
+interface DbNavbarMegaColumn {
+    id: string;
+    /** 컬럼 상단 제목 */
+    title?: string;
+    /** 컬럼 내 링크 목록 */
+    items: DbNavbarItem[];
+}
+interface DbNavbarMegaFeatured {
+    title?: string;
+    description?: string;
+    /** 배경 이미지 URL */
+    image?: string;
+    href?: string;
+    /** CTA 텍스트 (예: 자세히 보기) */
+    ctaLabel?: string;
+    icon?: string;
 }
 interface DbNavbarUserProfile {
     name: string;
@@ -1481,6 +1551,12 @@ declare class DbNavbar extends HTMLElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
+    get items(): DbNavbarItem[];
+    set items(value: DbNavbarItem[] | string);
+    get userMenuItems(): DbNavbarItem[];
+    set userMenuItems(value: DbNavbarItem[] | string);
+    get userProfile(): DbNavbarUserProfile | null;
+    set userProfile(value: DbNavbarUserProfile | string | null);
     private parseItems;
     private parseUserProfile;
     private iconSize;
@@ -1488,10 +1564,16 @@ declare class DbNavbar extends HTMLElement {
     private unbindOutsideClick;
     private dispatchItemClick;
     private syncHostClasses;
+    private isMegaMenu;
+    private createNavToggleButton;
+    private createMegaLink;
+    private createMegaMenu;
+    private createMegaFeatured;
     private createDesktopNavItem;
     private createUserMenuItemElement;
     private bindSearchEvents;
     private applyAvatarProfile;
+    private getMobileChildren;
     private createMobileMenuItem;
     private updateUserMenuVisibility;
     private renderMobileMenu;
@@ -1503,6 +1585,78 @@ declare global {
     }
 }
 
+type DbFooterSocialPlatform = 'youtube' | 'instagram' | 'x' | 'linkedin' | 'facebook' | 'email';
+interface DbFooterLink {
+    id: string;
+    label: string;
+    href?: string;
+    external?: boolean;
+    /** 개인정보처리방침 등 강조 링크 */
+    emphasize?: boolean;
+}
+interface DbFooterLinkColumn {
+    id: string;
+    title: string;
+    items: DbFooterLink[];
+}
+interface DbFooterSocialLink {
+    id: string;
+    platform: DbFooterSocialPlatform;
+    href: string;
+    label?: string;
+}
+interface DbFooterCompanyInfo {
+    companyName?: string;
+    representative?: string;
+    businessNumber?: string;
+    mailOrderNumber?: string;
+    address?: string;
+    phone?: string;
+    customerCenter?: string;
+    email?: string;
+    hostingProvider?: string;
+}
+interface DbFooterFamilySite {
+    id: string;
+    label: string;
+    href: string;
+}
+declare class DbFooter extends HTMLElement {
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    get columns(): DbFooterLinkColumn[];
+    set columns(value: DbFooterLinkColumn[] | string);
+    get legalLinks(): DbFooterLink[];
+    set legalLinks(value: DbFooterLink[] | string);
+    get socialLinks(): DbFooterSocialLink[];
+    set socialLinks(value: DbFooterSocialLink[] | string);
+    get companyInfo(): DbFooterCompanyInfo;
+    set companyInfo(value: DbFooterCompanyInfo | string);
+    get familySites(): DbFooterFamilySite[];
+    set familySites(value: DbFooterFamilySite[] | string);
+    private syncHostClasses;
+    private dispatchLinkClick;
+    private createLink;
+    private createSocialLink;
+    private createCompanyInfoRows;
+    private showLogo;
+    private createLogo;
+    private renderBrand;
+    private renderColumns;
+    private createLegalNav;
+    private renderLegalBar;
+    private renderCompanyInfo;
+    private createCopyright;
+    private renderMinimal;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-footer': DbFooter;
+    }
+}
+
 interface DbSidebarItem {
     id: string;
     label: string;
@@ -1533,6 +1687,14 @@ declare class DbSidebar extends HTMLElement {
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
     private seedExpanded;
+    get items(): DbSidebarItem[];
+    set items(value: DbSidebarItem[] | string);
+    get sections(): DbSidebarSection[];
+    set sections(value: DbSidebarSection[] | string);
+    get userMenuItems(): DbSidebarItem[];
+    set userMenuItems(value: DbSidebarItem[] | string);
+    get userProfile(): DbSidebarUserProfile | null;
+    set userProfile(value: DbSidebarUserProfile | string | null);
     private parseSections;
     private parseUserMenuItems;
     private parseUserProfile;
@@ -1641,6 +1803,8 @@ declare global {
 declare class DbRangeSlider extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
+    private headerEl;
+    private labelEl;
     private valuesEl;
     private containerEl;
     private trackEl;
@@ -1664,6 +1828,10 @@ declare class DbRangeSlider extends HTMLElement {
     get range(): [number, number] | undefined;
     set range(v: [number, number] | string | undefined);
     private build;
+    private getValuePosition;
+    private shouldShowLabel;
+    private formatValue;
+    private syncDomOrder;
     private bindEvents;
     private unbindEvents;
     private readAttributeValues;
@@ -1671,6 +1839,7 @@ declare class DbRangeSlider extends HTMLElement {
     private syncStructure;
     private isMarkActive;
     private syncVisuals;
+    private syncThumbTooltips;
     private syncA11y;
     private setThumbPosition;
     private valueToPercent;
@@ -2994,6 +3163,15 @@ declare global {
     }
 }
 
+interface HeroButton {
+    text: string;
+    href?: string;
+    variant?: 'primary' | 'secondary' | 'tertiary' | 'outline' | 'ghost';
+    size?: 's' | 'm' | 'l';
+    external?: boolean;
+    startIcon?: string;
+    icon?: string;
+}
 declare class DbSectionHero extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
@@ -3006,6 +3184,8 @@ declare class DbSectionHero extends HTMLElement {
     private buttonsEl?;
     connectedCallback(): void;
     attributeChangedCallback(): void;
+    get buttons(): HeroButton[];
+    set buttons(value: HeroButton[] | string);
     private parseButtons;
     private build;
     private updateUI;
@@ -3016,6 +3196,12 @@ declare global {
     }
 }
 
+interface FeatureAction {
+    label: string;
+    variant?: string;
+    size?: string;
+    href?: string;
+}
 declare class DbSectionFeature extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
@@ -3031,6 +3217,8 @@ declare class DbSectionFeature extends HTMLElement {
     connectedCallback(): void;
     attributeChangedCallback(): void;
     private parseBadge;
+    get actions(): FeatureAction[];
+    set actions(value: FeatureAction[] | string);
     private parseActions;
     private build;
     private updateUI;
@@ -3081,6 +3269,14 @@ declare global {
     }
 }
 
+interface DownloadStore {
+    store: 'app-store' | 'google-play';
+    href?: string;
+    label?: string;
+    storeName?: string;
+    size?: string;
+    theme?: string;
+}
 declare class DbSectionAppDownload extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
@@ -3092,6 +3288,8 @@ declare class DbSectionAppDownload extends HTMLElement {
     private badgesEl?;
     connectedCallback(): void;
     attributeChangedCallback(): void;
+    get stores(): DownloadStore[];
+    set stores(value: DownloadStore[] | string);
     private parseStores;
     private build;
     private updateUI;
@@ -3106,27 +3304,49 @@ declare class DbMarquee extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
     private containerEl?;
-    private trackEl?;
-    private baseGroupEl?;
+    private rowsEl?;
     private srOnlyEl?;
+    private rows;
+    private rowCount;
     private resizeObserver?;
     private containerWidth;
-    private baseGroupWidth;
+    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;
     private getBool;
     private parseItems;
+    private itemToText;
     private build;
     private bindResize;
+    /** rows 개수에 맞춰 행 DOM을 만들거나 제거한다. */
+    private reconcileRows;
     private measure;
     private unbindImageListeners;
     private bindImageListeners;
     private renderItem;
     private renderGroup;
-    private renderDuplicates;
+    /**
+     * 각 행의 base 그룹을 items로 다시 만든다 — items/attributes 변경 시에만 실행.
+     * 이미지 노드 재생성으로 인한 재로딩을 막기 위해 measure() 중에는 건드리지 않는다.
+     */
+    private buildBase;
+    private baseImagesReady;
+    /** 트랙을 채울 만큼의 복제 그룹 개수를 델타만 조정한다. */
+    private reconcileDuplicates;
     private syncReadyState;
+    private startScrollEngine;
+    private stopScrollEngine;
+    private frame;
     private updateUI;
 }
 declare global {
@@ -3135,11 +3355,17 @@ declare global {
     }
 }
 
+interface GradientColor {
+    color: string;
+    position?: number;
+}
 declare class DbGradient extends HTMLElement {
     static get observedAttributes(): string[];
     connectedCallback(): void;
     attributeChangedCallback(): void;
     private getBool;
+    get colors(): GradientColor[];
+    set colors(value: GradientColor[] | string);
     private parseColors;
     private directionMap;
     private colorStops;
@@ -3185,8 +3411,16 @@ declare class DbAdBanner extends HTMLElement {
     private autoCloseTimer?;
     private rootEl?;
     private gradientEl?;
+    private animBgEl?;
+    private animBgInner?;
+    private gridBgEl?;
+    private gridBgInner?;
     private contentEl?;
+    private mainEl?;
+    private textEl?;
     private closeBtn?;
+    private imageEl?;
+    private linkEl?;
     private iconEl?;
     private labelEl?;
     private badgeEl?;
@@ -3204,11 +3438,28 @@ declare class DbAdBanner extends HTMLElement {
     private getBool;
     private getType;
     private getVariant;
+    private getSize;
+    private ctaButtonSize;
     private build;
     private handleClose;
     private stopAutoClose;
     private startAutoClose;
-    private renderGradientWrapper;
+    private getBackground;
+    private ensureAnimBg;
+    private ensureGridBg;
+    /** 이전 배경 모드의 백드롭 엘리먼트를 정리한다. */
+    private clearBackdrop;
+    private renderBackground;
+    /** 장식 아이콘은 card 타입에서만 사용한다. */
+    private syncIcon;
+    /** floating 타입에서만 텍스트 상단에 배지 칩을 노출한다. */
+    private syncBadge;
+    /** floating 타입에서 배너 이미지를 콘텐츠 상단(패딩 밖)에 렌더한다. */
+    private syncImage;
+    /** topbar 타입에서 href 가 있으면 전체를 덮는 링크 오버레이를 렌더한다. */
+    private syncLink;
+    /** show-countdown + end-date 가 있을 때만 카운트다운을 마운트한다. */
+    private syncCountdown;
     private updateUI;
 }
 declare global {
@@ -3252,11 +3503,18 @@ declare class DbAnimationText extends HTMLElement {
     private displayText;
     private isVisible;
     private isAnimating;
+    private wordEls;
+    private scrollHandler?;
+    private rafId?;
+    private rotateToken;
+    private rotateObserver?;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
     private getText;
+    private getRotateTexts;
+    private getLongestText;
     private getType;
     private getTrigger;
     private ensureStructure;
@@ -3264,6 +3522,10 @@ declare class DbAnimationText extends HTMLElement {
     private syncFromAttributes;
     private syncClasses;
     private setupTrigger;
+    private setupTextRotate;
+    private setupScrollFill;
+    private teardownScrollFill;
+    private updateScrollFill;
     private startAnimation;
     private startTyping;
     private startDecoding;
@@ -3275,6 +3537,13 @@ declare global {
     }
 }
 
+type TutorialStep = {
+    id: string;
+    target: string;
+    title?: string;
+    content?: string;
+    placement?: 'top' | 'bottom' | 'left' | 'right' | 'auto';
+};
 declare class DbTutorial extends HTMLElement {
     static get observedAttributes(): string[];
     private root?;
@@ -3294,6 +3563,8 @@ declare class DbTutorial extends HTMLElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
+    get steps(): TutorialStep[];
+    set steps(value: TutorialStep[] | string);
     private parseSteps;
     private syncStepFromAttribute;
     private isOpenRequested;
@@ -3322,15 +3593,36 @@ declare global {
 declare class DbAnimationBackground extends HTMLElement {
     private layersEl?;
     private contentEl?;
+    private controlsRootEl?;
+    private panelEl?;
+    private panelOpen;
     private layerHandle?;
     private clickHandler?;
+    private mountedType?;
+    private controlInputs;
+    private syncingControls;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(): void;
-    private teardownLayers;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private getBool;
     private getSizeStyle;
+    private getConfig;
+    private teardownLayers;
+    private remountLayers;
+    private canLiveUpdate;
+    private applyConfig;
+    private syncClickable;
     private render;
+    private ensureControlsShell;
+    private syncControlsVisibility;
+    private syncPanelState;
+    private createIconButton;
+    private rebuildControlInputs;
+    private createControlField;
+    private commitControlValue;
+    private syncControlInputs;
+    private renderColorInputs;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -3338,8 +3630,99 @@ declare global {
     }
 }
 
+/**
+ * db-grid-background — 캔버스 기반 그리드 배경.
+ *
+ * 패턴은 항상 중앙을 기준으로 대칭 배치되며(가장자리 라인 없음),
+ * 단독 배경으로도, 다른 배경 위 데코 레이어(overlay)로도 쓸 수 있다.
+ * interactive/animate 로 마우스 인터랙션과 앰비언트 애니메이션을 켤 수 있다.
+ *
+ * @example
+ *   <db-grid-background type="lines" size="32" fade="all"
+ *     interactive animate height="240"></db-grid-background>
+ */
+declare class DbGridBackground extends HTMLElement {
+    private canvas?;
+    private ctx?;
+    private hlCanvas?;
+    private maskCanvas?;
+    private ro?;
+    private rafId?;
+    private lastTime;
+    private lastPointerMove;
+    private bandAngle;
+    private pointer;
+    private cssW;
+    private cssH;
+    private colorProbe?;
+    private themeObserver?;
+    private themeMedia?;
+    private tracePulses;
+    private traceSpawnAccumulator;
+    private onThemeMediaChange;
+    private onPointerMove;
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private getBool;
+    private getNumber;
+    private getSizeStyle;
+    private getColorProbe;
+    private resolveCssColor;
+    private isDarkContext;
+    private resolveThemeColor;
+    private effectiveOpacity;
+    private effectiveColor;
+    private effectiveInterColor;
+    private traceDrawColor;
+    private traceDrawOpacity;
+    private parseColorRgb;
+    private crossArm;
+    private interactionMode;
+    private animationStyle;
+    private traceDirection;
+    private linesLayout;
+    private crossStyle;
+    private parseGuideEdges;
+    private guideFraction;
+    private isGridLines;
+    private isTraceableLines;
+    private get cfg();
+    private ensureCanvas;
+    private applyHostStyles;
+    private startObserving;
+    private observeDocumentTheme;
+    private bindPointer;
+    private handlePointerMove;
+    private measure;
+    /** 중앙을 기준으로 대칭 배치되며 (0, extent) 내부 좌표만 반환 → 가장자리 라인 없음 */
+    private axis;
+    private scheduleDraw;
+    private ensureLoop;
+    private drawFrame;
+    private easeInOutCubic;
+    private traceSegmentLength;
+    private pulseHead;
+    private updateTracePulses;
+    private traceLinePositions;
+    private spawnTracePulse;
+    private drawTracePulseSegment;
+    private drawTraceHighlight;
+    private drawPattern;
+    private drawGridLines;
+    private drawFrameGuides;
+    private drawCenterGuides;
+    private buildEnergyMask;
+    private applyFade;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-grid-background': DbGridBackground;
+    }
+}
+
 declare class DbCursorFollower extends HTMLElement {
-    private scopeEl?;
     private portalRoot?;
     private pillEl?;
     private labelEl?;
@@ -3357,7 +3740,7 @@ declare class DbCursorFollower extends HTMLElement {
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
     private setupDesktopGate;
-    private ensureScope;
+    private updateScope;
     private isInScope;
     private mountLayer;
     private teardownLayer;
@@ -3388,5 +3771,85 @@ declare global {
     }
 }
 
-export { DbAccordion, DbAdBanner, DbAlert, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbButton, DbCalendar, DbCard, DbCarousel, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbConfirm, DbContainer, DbContextMenu, DbCountdown, DbCursorFollower, DbDatePicker, DbDivider, DbDrawer, DbDropdown, DbDropzone, DbEmptyState, DbFileUploader, DbFloatingActionButton, DbForm, DbGradient, DbGrid, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbLabel, DbLightbox, DbList, DbLogo, DbLottie, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbModal, DbNavbar, DbOnboardingModal, DbPageHeader, DbPagination, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReorder, DbResizablePanels, DbScrollArea, DbSearchBar, DbSection, DbSectionAppDownload, DbSectionContact, DbSectionFeature, DbSectionHero, DbSegmentControl, DbSelect, DbShare, DbSidebar, DbSkeleton, DbSpinner, DbSplitView, DbStack, DbStat, DbStepper, DbTable, DbTabs, DbTestimonial, DbTextarea, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbVideoPlayer, DbYouTubePlayer };
-export type { CalendarEventData, CalendarEventType, DbAlertAction, DbBannerAction, DbBottomNavigationItem, DbFormFieldData, DbImageListItem, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbPageHeaderTabItem, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarSection, DbSidebarUserProfile, DbStatChange, DbTimelineItem };
+/**
+ * 명령형 toast() 헬퍼 — 컨테이너/스택/제거를 자동 관리합니다.
+ *
+ * @example
+ *   import { toast } from '@designbasekorea/ui-wc';
+ *   toast.success('저장되었습니다');
+ *   toast.error('오류가 발생했어요', { description: '잠시 후 다시 시도해 주세요' });
+ *   const t = toast({ title: '업로드 중…', status: 'info', duration: 0 });
+ *   t.close();
+ */
+
+type DbToastStatus = 'info' | 'success' | 'warning' | 'error';
+type DbToastPosition = 'top-right' | 'top-center' | 'top-left' | 'bottom-right' | 'bottom-center' | 'bottom-left';
+interface DbToastOptions {
+    /** 제목 (필수) */
+    title: string;
+    /** 보조 설명 */
+    description?: string;
+    /** 상태 색상/아이콘. 기본 'info' */
+    status?: DbToastStatus;
+    /** 자동 닫힘 시간(ms). 0 이하이면 자동으로 닫히지 않음. 기본 5000 */
+    duration?: number;
+    /** 표시 위치. 기본 'top-right' */
+    position?: DbToastPosition;
+    /** 닫기 버튼 표시. 기본 true */
+    showClose?: boolean;
+    /** 진행 바 표시. 기본 false */
+    showProgress?: boolean;
+}
+interface DbToastHandle {
+    /** 토스트 고유 id */
+    id: string;
+    /** 토스트 엘리먼트 */
+    element: DbToast;
+    /** 토스트를 수동으로 닫습니다(애니메이션 포함). */
+    close: () => void;
+}
+type DbToastShortcut = (title: string, options?: Omit<DbToastOptions, 'title' | 'status'>) => DbToastHandle;
+interface DbToastApi {
+    (options: DbToastOptions): DbToastHandle;
+    show: (options: DbToastOptions) => DbToastHandle;
+    success: DbToastShortcut;
+    error: DbToastShortcut;
+    warning: DbToastShortcut;
+    info: DbToastShortcut;
+    /** 열려 있는 토스트를 모두 닫습니다. position 지정 시 해당 위치만. */
+    dismissAll: (position?: DbToastPosition) => void;
+}
+/** 토스트를 띄웁니다. `toast(options)` 와 동일합니다. */
+declare function showToast(options: DbToastOptions): DbToastHandle;
+declare const toast: DbToastApi;
+
+type DbConfirmVariant = 'info' | 'success' | 'warning' | 'danger';
+interface DbConfirmOptions {
+    /** 본문 메시지 (필수) */
+    message: string;
+    /** 제목 */
+    title?: string;
+    /** 확인 버튼 텍스트. 기본 '확인' */
+    confirmText?: string;
+    /** 취소 버튼 텍스트. 기본 '취소' */
+    cancelText?: string;
+    /** 확인 버튼 variant (db-button variant). 기본 'primary' */
+    confirmVariant?: string;
+    /** 아이콘/색상 톤. 기본 'info' */
+    variant?: DbConfirmVariant;
+    /** 크기. 기본 's' */
+    size?: 's' | 'm' | 'l';
+    /** 아이콘 표시. 기본 true */
+    showIcon?: boolean;
+    /** 처음 포커스 대상. 기본 'confirm' */
+    initialFocus?: 'confirm' | 'cancel';
+    /** ESC 로 취소 허용. 기본 true */
+    closeOnEscape?: boolean;
+    /** 배경 클릭으로 취소 허용. 기본 true */
+    closeOnBackdrop?: boolean;
+}
+/** 확인 대화상자를 띄우고, 확인 시 true / 취소(ESC·배경 포함) 시 false 로 resolve 합니다. */
+declare function confirm(options: DbConfirmOptions): Promise<boolean>;
+
+export { DbAccordion, DbAdBanner, DbAlert, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbButton, DbCalendar, DbCard, DbCarousel, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbConfirm, DbContainer, DbContextMenu, DbCountdown, DbCursorFollower, DbDatePicker, DbDivider, DbDrawer, DbDropdown, DbDropzone, DbEmptyState, DbFileUploader, DbFloatingActionButton, DbFooter, DbForm, DbGradient, DbGrid, DbGridBackground, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbLabel, DbLightbox, DbList, DbLogo, DbLottie, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbModal, DbNavbar, DbOnboardingModal, DbPageHeader, DbPagination, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReorder, DbResizablePanels, DbScrollArea, DbSearchBar, DbSection, DbSectionAppDownload, DbSectionContact, DbSectionFeature, DbSectionHero, DbSegmentControl, DbSelect, DbShare, DbSidebar, DbSkeleton, DbSpinner, DbSplitView, DbStack, DbStat, DbStepper, DbTable, DbTabs, DbTestimonial, DbTextarea, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbVideoPlayer, DbYouTubePlayer, confirm, confirm as dbConfirm, toast as dbToast, showToast, toast };
+export type { CalendarEventData, CalendarEventType, DbAlertAction, DbBannerAction, DbBottomNavigationItem, DbConfirmOptions, DbConfirmVariant, DbFooterCompanyInfo, DbFooterFamilySite, DbFooterLink, DbFooterLinkColumn, DbFooterSocialLink, DbFormFieldData, DbImageListItem, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbPageHeaderTabItem, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarSection, DbSidebarUserProfile, DbStatChange, DbTimelineItem, DbToastApi, DbToastHandle, DbToastOptions, DbToastPosition, DbToastStatus };