@designbasekorea/ui-wc 0.9.3 → 0.10.0

package/dist/index.d.ts

@@ -390,6 +390,10 @@ declare const DEFAULT_STRINGS: {
     readonly 'media.previous': "이전 트랙";
     readonly 'media.next': "다음 트랙";
     readonly 'media.fullscreen': "전체화면";
+    readonly 'confirm.ok': "확인";
+    readonly 'confirm.cancel': "취소";
+    readonly 'carousel.slide': "슬라이드";
+    readonly 'carousel.role': "캐러셀";
     readonly 'carousel.previous': "이전 슬라이드";
     readonly 'carousel.next': "다음 슬라이드";
     readonly 'breadcrumbs.expand': "생략된 경로 펼치기";
@@ -639,6 +643,13 @@ type ConfettiShape = (typeof CONFETTI_SHAPES)[number];
 declare const GLYPH_MATRIX_PRESETS: readonly ["code", "matrix", "binary", "dots", "alphanumeric"];
 type GlyphMatrixPreset = (typeof GLYPH_MATRIX_PRESETS)[number];
 type GlyphMatrixSize = SizeSML;
+declare const AI_ELEMENT_STATUSES: readonly ["pending", "running", "complete", "error", "cancelled", "approval"];
+type AiElementStatus = (typeof AI_ELEMENT_STATUSES)[number];
+declare const CREDIT_CARD_VARIANTS: readonly ["default", "contrast", "metal", "blue", "sage", "rose", "cobalt", "coral", "lime"];
+declare const CREDIT_CARD_ORIENTATIONS: readonly ["horizontal", "vertical"];
+declare const FLIGHT_STATUSES: readonly ["scheduled", "boarding", "in-flight", "landed", "delayed", "cancelled"];
+declare const NODE_VARIANTS: readonly ["default", "compact"];
+declare const NODE_STATUSES: readonly ["idle", "running", "success", "error"];
 
 interface DbNavigationRailItem {
     id: string;
@@ -686,6 +697,17 @@ declare global {
  * their renderer. This keeps React/Vue slots stable while sharing one element.
  */
 declare class DbButton extends HTMLElement {
+    static readonly formAssociated = true;
+    private readonly internals;
+    private formDisabled;
+    private spacePressed;
+    private syncing;
+    private pendingSync;
+    private managedLoadingLabel;
+    private actionEpoch;
+    private implicitSubmitter?;
+    private childObserver?;
+    private desiredTabIndex;
     static get observedAttributes(): string[];
     /**
      * 계약에 없는 값이 attribute 로 들어오면 기본값으로 되돌린다 — throw 하지 않는다.
@@ -702,6 +724,24 @@ declare class DbButton extends HTMLElement {
     set accentStyle(value: string);
     get type(): string;
     set type(value: string);
+    get form(): HTMLFormElement | null;
+    get name(): string;
+    set name(value: string);
+    get value(): string;
+    set value(value: string);
+    get formNoValidate(): boolean;
+    set formNoValidate(value: boolean);
+    get formAction(): string;
+    set formAction(value: string);
+    get formMethod(): string;
+    set formMethod(value: string);
+    get formEnctype(): string;
+    set formEnctype(value: string);
+    get formTarget(): string;
+    set formTarget(value: string);
+    private get blocked();
+    formDisabledCallback(disabled: boolean): void;
+    click(): void;
     get href(): string;
     set href(value: string);
     get loadingText(): string;
@@ -716,14 +756,17 @@ declare class DbButton extends HTMLElement {
     set fullWidth(value: boolean);
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(): void;
+    attributeChangedCallback(name?: string, oldValue?: string | null, value?: string | null): void;
     private handleClick;
+    private followLink;
     private handleKeyDown;
     private handleKeyUp;
+    private handleBlur;
     private handlePointerDown;
     private handlePointerUp;
     private syncAttributes;
     private getIconSize;
+    private syncImplicitSubmitter;
     private resolveIconName;
     private isManagedIconNode;
     private syncIcons;
@@ -755,6 +798,7 @@ declare class DbInput extends HTMLElement {
     private shapeKey;
     static get observedAttributes(): string[];
     private input?;
+    private formState;
     private passwordVisible;
     private isFocused;
     private touched;
@@ -762,6 +806,12 @@ declare class DbInput extends HTMLElement {
     private detachScrub?;
     get value(): string;
     set value(value: string);
+    get defaultValue(): string;
+    set defaultValue(value: string);
+    get name(): string;
+    set name(value: string);
+    get required(): boolean;
+    set required(value: boolean);
     get type(): string;
     set type(value: string);
     get size(): string;
@@ -773,7 +823,7 @@ declare class DbInput extends HTMLElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
-    focus(): void;
+    focus(options?: FocusOptions): void;
     private get passwordMinLength();
     private get validationVisibility();
     private get validateOnBlur();
@@ -813,11 +863,27 @@ declare class DbCheckbox extends HTMLElement {
     private input?;
     private visual?;
     private labelEl?;
+    private readonly labelContent;
     private built;
     private userInteracted;
+    private resetChecked?;
     private readonly cleanups;
+    focus(options?: FocusOptions): void;
+    get label(): string;
+    set label(value: string);
+    get name(): string;
+    set name(value: string);
+    get value(): string;
+    set value(value: string);
+    get defaultChecked(): boolean;
+    set defaultChecked(value: boolean);
+    get defaultSelected(): boolean;
+    set defaultSelected(value: boolean);
+    private upgradeProperties;
     get checked(): boolean;
     set checked(value: boolean);
+    get selected(): boolean;
+    set selected(value: boolean);
     get indeterminate(): boolean;
     set indeterminate(value: boolean);
     get disabled(): boolean;
@@ -834,7 +900,8 @@ declare class DbCheckbox extends HTMLElement {
     /** form.reset() 이후 네이티브 input 의 실제 상태를 호스트 attribute 로 되돌린다 */
     private syncAfterReset;
     attributeChangedCallback(name: string): void;
-    private get hasLabel();
+    get hasLabel(): boolean;
+    set hasLabel(value: boolean);
     private build;
     private handleChange;
     /**
@@ -858,26 +925,55 @@ declare class DbToggle extends HTMLElement {
     private readonly internals;
     private root?;
     private labelEl?;
+    private readonly labelContent;
     private built;
-    /** default-checked 는 초기값일 뿐 — 한 번 조작하면 checked/selected 만 본다 */
-    private userInteracted;
+    private dirty;
+    private resetChecked?;
+    private awaitingInitial;
+    private formDisabled;
     get checked(): boolean;
     set checked(value: boolean);
+    get selected(): boolean;
+    set selected(value: boolean);
+    get defaultChecked(): boolean;
+    set defaultChecked(value: boolean);
+    get defaultSelected(): boolean;
+    set defaultSelected(value: boolean);
     get name(): string;
     set name(value: string);
+    get label(): string;
+    set label(value: string);
+    get value(): string;
+    set value(value: string);
     get disabled(): boolean;
     set disabled(value: boolean);
     get readOnly(): boolean;
     set readOnly(value: boolean);
+    get required(): boolean;
+    set required(value: boolean);
+    get hasLabel(): boolean;
+    set hasLabel(value: boolean);
     get size(): string;
     set size(value: string);
     get variant(): string;
     set variant(value: string);
+    get form(): HTMLFormElement | null;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    focus(options?: FocusOptions): void;
+    private get unavailable();
+    private captureFirstChecked;
+    private setPristineChecked;
     connectedCallback(): void;
-    attributeChangedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    formAssociatedCallback(): void;
     formResetCallback(): void;
+    formStateRestoreCallback(state: string | File | FormData | null): void;
     formDisabledCallback(disabled: boolean): void;
-    private get hasLabel();
     private syncFormValue;
     private build;
     private handleClick;
@@ -1026,23 +1122,32 @@ interface TabItemConfig {
 }
 declare class DbTabs extends HTMLElement {
     static get observedAttributes(): string[];
+    private readonly uid;
+    private readonly records;
+    private readonly slotNodes;
     private list?;
     private indicator?;
-    private panel?;
-    private tabButtons;
-    private inactivePanels;
-    private isRendering;
+    private stash?;
+    private rendering;
+    private reflecting;
+    private focusedKey?;
     private childObserver?;
     private resizeObserver?;
     private resizeRaf?;
-    get labels(): string[];
-    set labels(value: string[] | string);
+    private drag?;
+    private suppressClick;
+    private clickTimer?;
     get tabItems(): TabItemConfig[];
-    get items(): TabItemConfig[];
-    set items(value: TabItemConfig[] | string);
     set tabItems(value: TabItemConfig[] | string);
+    get items(): TabItemConfig[] | string;
+    set items(value: TabItemConfig[] | string);
+    get labels(): string[];
+    set labels(value: string[] | string);
+    private entries;
     get activeIndex(): number;
     set activeIndex(value: number);
+    get selectedId(): string;
+    set selectedId(value: string);
     get orientation(): string;
     set orientation(value: string);
     get size(): string;
@@ -1053,13 +1158,26 @@ declare class DbTabs extends HTMLElement {
     set fullWidth(value: boolean);
     connectedCallback(): void;
     disconnectedCallback(): void;
-    private handleResize;
-    attributeChangedCallback(): void;
-    private handleListScroll;
-    private collectPanelContent;
+    attributeChangedCallback(name: string, oldValue: string | null, value: string | null): void;
+    refresh(): void;
+    focus(options?: FocusOptions): void;
+    private slotIndex;
+    private collectSlots;
+    private createRecord;
+    private hideUnassigned;
     private render;
+    private syncRoving;
     private select;
-    private handleKeyDown;
+    private navigate;
+    private ensureVisible;
+    private beginDrag;
+    private moveDrag;
+    private finishDrag;
+    private cancelDrag;
+    private endDrag;
+    private captureClick;
+    private handleResize;
+    private handleListScroll;
     private updateIndicator;
 }
 declare global {
@@ -1215,10 +1333,10 @@ declare global {
     }
 }
 
+type ExpandMode = 'multiple' | 'single' | 'all';
 interface AccordionItemConfig {
     id?: string;
     title: string;
-    /** 슬롯(content-N)이 없을 때 본문으로 렌더되는 텍스트 */
     content?: string;
     disabled?: boolean;
     itemType?: 'icon' | 'number' | 'question' | 'none';
@@ -1226,28 +1344,39 @@ interface AccordionItemConfig {
 }
 declare class DbAccordion extends HTMLElement {
     static get observedAttributes(): string[];
+    private readonly uid;
+    private readonly panels;
+    private readonly slotNodes;
     private expanded;
-    private isRendering;
-    private suppressExpandedAttrCallback;
+    private rendering;
+    private reflecting;
     private childObserver?;
+    private stash?;
     get items(): AccordionItemConfig[];
     set items(value: AccordionItemConfig[] | string);
+    get size(): string;
+    set size(value: string);
+    get variant(): string;
+    set variant(value: string);
     get allowMultiple(): boolean;
     set allowMultiple(value: boolean);
+    get expandMode(): ExpandMode;
+    set expandMode(value: ExpandMode);
     get expandedItems(): string[];
     set expandedItems(value: string[] | string);
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(name: string): void;
-    /** id와 index 문자열 충돌 방지 — 항목당 단일 키만 사용 */
-    private resolveItemKey;
-    private getExpandMode;
+    attributeChangedCallback(name: string, oldValue: string | null, value: string | null): void;
+    /** Refresh externally supplied slot structure without changing expansion or emitting events. */
+    refresh(): void;
+    focus(options?: FocusOptions): void;
+    private entries;
     private syncExpandedFromAttributes;
-    private iconSize;
-    private collectPanelContent;
-    private isItemExpanded;
+    private collectSlots;
+    private createPanel;
     private syncExpandedState;
     private render;
+    private navigate;
     private toggle;
 }
 declare global {
@@ -1328,18 +1457,45 @@ declare class DbSelect extends HTMLElement {
     private built;
     private searchTerm;
     private focusedIndex;
+    private initialValue?;
+    private awaitingValue;
+    private userInteracted;
+    private formDisabled;
+    private wasOpen;
+    private searchFocusFrame?;
+    private typeahead;
+    private typeaheadAt;
+    get defaultValue(): string;
+    set defaultValue(value: string | string[]);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get readOnly(): boolean;
+    set readOnly(value: boolean);
+    get required(): boolean;
+    set required(value: boolean);
+    get form(): HTMLFormElement | null;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    focus(options?: FocusOptions): void;
+    private get unavailable();
+    private get locked();
+    private captureDefault;
     get name(): string;
     set name(value: string);
     get open(): boolean;
     set open(value: boolean);
     get value(): string;
-    set value(value: string);
+    set value(value: string | string[]);
     connectedCallback(): void;
     formAssociatedCallback(): void;
     disconnectedCallback(): void;
     formResetCallback(): void;
+    formStateRestoreCallback(state: string | File | FormData | null): void;
     formDisabledCallback(disabled: boolean): void;
-    attributeChangedCallback(name: string): void;
+    attributeChangedCallback(name: string, oldValue: string | null): void;
     get multiple(): boolean;
     set multiple(value: boolean);
     get searchable(): boolean;
@@ -1359,6 +1515,8 @@ declare class DbSelect extends HTMLElement {
     private handleClear;
     private handleSearchInput;
     private handleDocumentMouseDown;
+    private handleFocusOut;
+    private moveFocus;
     private handleDocumentKeyDown;
     private getFilteredOptions;
     private selectOption;
@@ -1367,12 +1525,14 @@ declare class DbSelect extends HTMLElement {
      * combobox 트리거에 접근 가능한 이름을 붙인다.
      *
      * 트리거는 `<div role="combobox">` 라서 `<label for>` 로는 연결되지 않는다.
-     * 라벨이 있으면 `aria-labelledby`, 없으면 소비자가 준 `aria-label`,
-     * 그것도 없으면 placeholder 를 이름으로 쓴다. (A11Y-NAME)
+     * 명시적 aria-labelledby/aria-label, 보이는 label, placeholder 순으로
+     * 실제 trigger와 검색 입력 및 목록의 이름을 동기화한다. (A11Y-NAME)
      */
     private syncAccessibleName;
     private syncState;
     private syncOpenState;
+    private cancelSearchFocus;
+    private scheduleSearchFocus;
     private syncTrigger;
     private syncOptions;
     private escape;
@@ -1393,13 +1553,25 @@ declare class DbTextarea extends HTMLElement {
     private errorEl?;
     private footerEl?;
     private built;
+    private formState;
     get value(): string;
     set value(value: string);
+    get defaultValue(): string;
+    set defaultValue(value: string);
+    get name(): string;
+    set name(value: string);
+    get required(): boolean;
+    set required(value: boolean);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get readOnly(): boolean;
+    set readOnly(value: boolean);
     get size(): string;
     set size(value: string);
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
-    focus(): void;
+    focus(options?: FocusOptions): void;
     private get showCharacterCount();
     private get characterCountPosition();
     private build;
@@ -1422,10 +1594,27 @@ declare class DbRadio extends HTMLElement {
     private visual?;
     private dot?;
     private labelEl?;
+    private readonly labelContent;
     private built;
     private userInteracted;
+    private resetChecked?;
+    private readonly cleanups;
+    focus(options?: FocusOptions): void;
+    get label(): string;
+    set label(value: string);
+    get name(): string;
+    set name(value: string);
+    get value(): string;
+    set value(value: string);
+    get defaultChecked(): boolean;
+    set defaultChecked(value: boolean);
+    get defaultSelected(): boolean;
+    set defaultSelected(value: boolean);
+    private upgradeProperties;
     get checked(): boolean;
     set checked(value: boolean);
+    get selected(): boolean;
+    set selected(value: boolean);
     get disabled(): boolean;
     set disabled(value: boolean);
     get readOnly(): boolean;
@@ -1435,10 +1624,14 @@ declare class DbRadio extends HTMLElement {
     get size(): string;
     set size(value: string);
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
-    private get hasLabel();
+    get hasLabel(): boolean;
+    set hasLabel(value: boolean);
     private build;
     private handleChange;
+    private groupPeers;
+    private syncGroup;
     private syncState;
     private syncVisual;
     private syncClasses;
@@ -1819,6 +2012,8 @@ declare class DbConfirm extends HTMLElement {
     private focusTrap?;
     /** 참조 카운트 스크롤락을 이 인스턴스가 잡고 있는지 (PERF-GLOBAL-STATE) */
     private scrollLocked;
+    private unsubscribeLocale?;
+    private syncLocale;
     connectedCallback(): void;
     disconnectedCallback(): void;
     /** 트랩 해제(=포커스 복원)와 스크롤락 반환을 한 곳에서 처리한다 */
@@ -1866,6 +2061,7 @@ declare class DbIndicator extends HTMLElement {
     set clickable(value: boolean);
     get timer(): boolean;
     set timer(value: boolean);
+    private unsubscribeLocale?;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
@@ -2378,6 +2574,9 @@ declare class DbNavbar extends HTMLElement {
     private static nextId;
     private readonly mobileMenuId;
     private mobileOpen;
+    private slotObserver?;
+    private containerObserver?;
+    private escapeMenu;
     private userMenuOpen;
     private expandedMobile;
     private outsideHandler;
@@ -2804,6 +3003,11 @@ declare class DbRangeSlider extends HTMLElement {
     private trackEl;
     private fillEl;
     private thumbEls;
+    private initialized;
+    private reflecting;
+    private pointerId;
+    private pointerThumb;
+    private tooltipResize?;
     private currentValue;
     private currentRange;
     private isDragging;
@@ -2811,15 +3015,35 @@ declare class DbRangeSlider extends HTMLElement {
     private boundTrackClick;
     private boundPointerMove;
     private boundPointerUp;
+    private boundPointerCancel;
     private eventsBound;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(name: string): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     private isStructuralAttribute;
     get value(): number;
     set value(v: number);
     get range(): [number, number] | undefined;
     set range(v: [number, number] | string | undefined);
+    get min(): number;
+    set min(value: number);
+    get max(): number;
+    set max(value: number);
+    get step(): number;
+    set step(value: number);
+    get size(): string;
+    set size(value: string);
+    get variant(): string;
+    set variant(value: string);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get readOnly(): boolean;
+    set readOnly(value: boolean);
+    get vertical(): boolean;
+    set vertical(value: boolean);
+    focus(options?: FocusOptions): void;
+    private get bounds();
+    private normalizeValues;
     private build;
     private getValuePosition;
     private shouldShowLabel;
@@ -2833,32 +3057,35 @@ declare class DbRangeSlider extends HTMLElement {
     private isMarkActive;
     private syncVisuals;
     private syncThumbTooltips;
+    private fitFloatingText;
+    private syncMarkLabelBounds;
     private syncA11y;
     private setThumbPosition;
     private valueToPercent;
     private percentToValue;
-    private snapToStep;
     private clamp;
+    /** snap-marks: the marks are the only selectable values. */
+    private snapStops;
+    private adjacentStop;
     private getNumberAttr;
     private normalizeRangeInput;
     private parseRangeAttr;
     private parseMarks;
+    private readMarks;
     private parseMarkLabels;
     private isInteractive;
     private getTrackPercent;
     private handleThumbPointerDown;
     private handleTrackClick;
-    /**
-     * 포인터 이동을 프레임당 1회로 병합한다. preventDefault 를 쓰지 않으므로 안전하다. (PERF-RAF)
-     * 메서드가 아니라 필드로 선언해야 rafThrottle 로 감쌀 수 있다.
-     */
     private handlePointerMove;
     private handlePointerUp;
+    private cancelDrag;
     private setThumbActive;
+    private reflectCurrent;
     private applyDragValue;
+    private applyValue;
     private commitValueAtPosition;
     private handleKeyDown;
-    private afterKeyboard;
     private dispatchValueChange;
     private dispatchRangeChange;
 }
@@ -3145,7 +3372,18 @@ declare class DbPageHeader extends HTMLElement {
     private stickyMarker?;
     private stickyObserver?;
     private compact;
+    private motionArmed;
+    private stickySpacer?;
+    private sizeObserver?;
+    private expandedHeight;
+    private motionFrame?;
+    private settling;
+    private updateStickySpace;
+    private stickyOffset;
+    private scrollRoot?;
+    private releaseAnchor?;
     private refreshSticky;
+    private refreshOffset;
     private observeSticky;
     private setCompact;
     connectedCallback(): void;
@@ -3237,7 +3475,7 @@ declare class DbFloatingActionButton extends DbButton {
     set collapseThreshold(value: number);
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(name?: string): void;
+    attributeChangedCallback(name?: string, oldValue?: string | null, value?: string | null): void;
     private syncFab;
     private measureLabel;
     private unbindScroll;
@@ -3519,7 +3757,8 @@ declare class DbDatePicker extends HTMLElement {
     get inline(): boolean;
     set inline(value: boolean);
     private get type();
-    private get locale();
+    get locale(): string;
+    set locale(value: string);
     private get startOfWeek();
     private get showOutsideDays();
     private get usesPendingValue();
@@ -3669,7 +3908,8 @@ declare class DbCalendar extends HTMLElement {
     private eventForm;
     connectedCallback(): void;
     attributeChangedCallback(): void;
-    private get locale();
+    get locale(): string;
+    set locale(value: string);
     private get showWeekends();
     private get highlightToday();
     private get showOutsideDays();
@@ -3874,6 +4114,8 @@ declare class DbCarousel extends HTMLElement {
     static get observedAttributes(): string[];
     get items(): DbCarouselItem[];
     set items(value: DbCarouselItem[] | string);
+    private unsubscribeLocale?;
+    private syncLocale;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
@@ -5431,31 +5673,44 @@ declare global {
     }
 }
 
-/**
- * ui-wc — db-phone-verify (수동 작성, 자동 동기화 대상 아님)
- *
- * 한국형 휴대폰 본인인증: 통신사 → 번호 → 인증번호 발송 → OTP + 타이머/재전송.
- */
-
 type Size$2 = (typeof PHONE_VERIFY_SIZES)[number];
+type Step$1 = 'phone' | 'code' | 'verified';
 declare class DbPhoneVerify extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
     private timerId;
+    /** 인증번호 유효 시간(초) */
     private remaining;
+    /** 재전송 버튼이 다시 열리기까지 남은 시간(초) */
+    private cooldownLeft;
+    private expired;
+    private closeBtn;
+    private headerEl;
+    private eyebrowEl;
+    private titleEl;
+    private descEl;
+    private formEl;
     private carrierSelect;
     private phoneInput;
     private sendBtn;
+    private codeBlock;
+    private codeLabelEl;
     private otpInput;
     private timerEl;
-    private resendBtn;
+    private expiredEl;
     private verifyBtn;
-    private codeBlock;
+    private resendHintEl;
+    private resendBtn;
+    private changeBtn;
+    private verifiedBlock;
+    private verifiedTitleEl;
+    private verifiedDescEl;
+    private doneBtn;
     private errorEl;
     get size(): Size$2;
     set size(v: Size$2);
-    get step(): 'phone' | 'code' | 'verified';
-    set step(v: 'phone' | 'code' | 'verified');
+    get step(): Step$1;
+    set step(v: Step$1);
     get phone(): string;
     set phone(v: string);
     get carrier(): string;
@@ -5464,6 +5719,9 @@ declare class DbPhoneVerify extends HTMLElement {
     set code(v: string);
     get countdown(): number;
     set countdown(v: number);
+    /** 재전송을 다시 누를 수 있기까지 기다리는 시간(초). 기본 30초. 0이면 바로 누를 수 있다. */
+    get resendCooldown(): number;
+    set resendCooldown(v: number);
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
@@ -5473,13 +5731,19 @@ declare class DbPhoneVerify extends HTMLElement {
     restartCountdown(): void;
     /** 인증 완료 상태로 전환합니다. */
     markVerified(): void;
+    /** 번호 입력 단계로 돌아갑니다 (입력한 코드는 지웁니다). */
+    editPhone(): void;
     private clearTimer;
-    private startTimer;
+    private startTimers;
     private renderTimer;
+    private emit;
     private build;
     private sync;
     private isPhoneValid;
+    private requestSend;
     private requestVerify;
+    /** 번역 문장 안의 {0} 자리에 값을 굵게 넣는다 — 언어마다 어순이 달라 조각내 번역하지 않는다. */
+    private setTextWithValue;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -5488,34 +5752,53 @@ declare global {
 }
 
 type Size$1 = (typeof EMAIL_VERIFY_SIZES)[number];
+type Step = 'email' | 'code' | 'sent' | 'verified';
 declare class DbEmailVerify extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
     private timerId;
+    /** 인증번호 유효 시간(초) — code 모드에서만 쓴다 */
     private remaining;
+    /** 재전송 버튼이 다시 열리기까지 남은 시간(초) */
+    private cooldownLeft;
+    private expired;
+    private eyebrowEl;
+    private headerEl;
+    private titleEl;
+    private descEl;
     private emailInput;
     private sendBtn;
     private otpInput;
     private timerEl;
-    private resendBtn;
+    private expiredEl;
+    private codeResendBtn;
+    private codeChangeBtn;
     private verifyBtn;
     private confirmBtn;
+    private doneBtn;
+    private sentResendBtn;
+    private sentChangeBtn;
+    private sentDescEl;
+    private verifiedDescEl;
     private codeBlock;
-    private confirmBlock;
+    private sentBlock;
     private verifiedBlock;
     private emailRow;
     private errorEl;
-    private closeBtn?;
+    private closeBtn;
     get mode(): 'code' | 'confirm';
     set mode(v: 'code' | 'confirm');
     get size(): Size$1;
     set size(v: Size$1);
-    get step(): 'email' | 'code' | 'sent' | 'verified';
-    set step(v: 'email' | 'code' | 'sent' | 'verified');
+    get step(): Step;
+    set step(v: Step);
     get email(): string;
     set email(v: string);
     get countdown(): number;
     set countdown(v: number);
+    /** 재전송을 다시 누를 수 있기까지 기다리는 시간(초). 기본 30초. 0이면 바로 누를 수 있다. */
+    get resendCooldown(): number;
+    set resendCooldown(v: number);
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
@@ -5524,14 +5807,24 @@ declare class DbEmailVerify extends HTMLElement {
     restartCountdown(): void;
     markSent(): void;
     markVerified(): void;
+    /** 이메일 입력 단계로 돌아갑니다 (입력한 코드는 지웁니다). */
+    editEmail(): void;
+    private startTimersForStep;
     private clearTimer;
-    private startTimer;
+    private startTimers;
     private renderTimer;
+    private syncVerifyDisabled;
+    private emit;
+    private handleResend;
+    private handleChangeEmail;
     private build;
+    private buildFooter;
     private sync;
     private isEmailValid;
+    private requestSend;
     private requestVerify;
-    private setEmphasizedText;
+    /** 번역 문장 안의 {0} 자리에 이메일을 굵게 넣는다 — 언어마다 어순이 달라 조각내 번역하지 않는다. */
+    private setTextWithEmail;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -5555,41 +5848,64 @@ declare class DbTwoFactor extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
     private timerId;
+    /** 코드 유효 시간(초) — SMS·이메일에서만 쓴다 */
     private remaining;
+    /** 재전송 버튼이 다시 열리기까지 남은 시간(초) */
+    private cooldownLeft;
+    private expired;
+    private backupMode;
+    private resendCount;
+    private closeBtn;
+    private headerEl;
+    private eyebrowEl;
+    private titleEl;
+    private descEl;
     private segment;
-    private otpInput;
-    private hintEl;
+    private codeBlock;
+    private codeLabelEl;
     private timerEl;
-    private codeHead;
-    private resendBtn;
+    private otpInput;
+    private expiredEl;
+    private backupInput;
     private verifyBtn;
+    private resendGroup;
+    private resendHintEl;
+    private resendBtn;
     private backupBtn;
-    private errorEl;
-    private channelActions;
-    private resendStatus;
-    private backupBlock;
-    private backupInput;
     private backupCancelBtn;
-    private backupMode;
-    private resendCount;
+    private verifiedBlock;
+    private verifiedTitleEl;
+    private verifiedDescEl;
+    private doneBtn;
+    private errorEl;
     get method(): Method;
     set method(v: Method);
     get size(): Size;
     set size(v: Size);
     get countdown(): number;
     set countdown(v: number);
+    /** 재전송을 다시 누를 수 있기까지 기다리는 시간(초). 기본 30초. 0이면 바로 누를 수 있다. */
+    get resendCooldown(): number;
+    set resendCooldown(v: number);
     get maxResends(): number;
+    private get usesTimer();
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     /** 수동 제어 모드에서 코드 발송 성공 후 카운트다운을 시작합니다. */
     restartCountdown(): void;
+    /** 인증 완료 화면으로 전환합니다. */
+    markVerified(): void;
     private clearTimer;
-    private startTimer;
+    private startTimers;
     private renderTimer;
+    private syncVerifyDisabled;
+    private emit;
     private build;
     private sync;
     private requestVerify;
+    /** 번역 문장 안의 {0} 자리에 값을 굵게 넣는다 — 언어마다 어순이 달라 조각내 번역하지 않는다. */
+    private setTextWithValue;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -5713,6 +6029,10 @@ declare class DbChatOrb extends HTMLElement {
     private lastVoiceRipple;
     private previousVoiceLevel;
     private displayedVoiceLevel;
+    private dotsMix;
+    private layer;
+    private customShapes;
+    private shapeBuffer;
     private inputStream;
     private audioContext;
     private audioSource;
@@ -5726,6 +6046,15 @@ declare class DbChatOrb extends HTMLElement {
     set state(v: OrbState);
     get theme(): OrbTheme;
     set theme(v: OrbTheme);
+    /** thinking 상태의 표현. `dots` 는 구체가 작아지며 점 3개가 순서대로 튀는 로딩 모션으로 바뀝니다. */
+    get thinkingStyle(): 'orb' | 'dots';
+    set thinkingStyle(v: 'orb' | 'dots');
+    /**
+     * morph 로 순환할 모양 목록. 프리셋 이름(circle · squircle · flower · star · triangle · blob)
+     * 또는 SVG path 의 d 값을 섞어서 넣을 수 있습니다. 속성 `shape="circle,flower,star"` 로도 지정합니다.
+     */
+    get shapes(): string[];
+    set shapes(v: string[] | null);
     /** 외부 오디오 분석기가 전달하는 정규화 음성 레벨(0–1). */
     get voiceLevel(): number;
     set voiceLevel(v: number);
@@ -6915,7 +7244,7 @@ declare global {
     }
 }
 
-type DbAiStatus = 'pending' | 'running' | 'complete' | 'error' | 'cancelled' | 'approval';
+type DbAiStatus = AiElementStatus;
 interface DbAiItem {
     id: string;
     label: string;
@@ -7532,6 +7861,8 @@ interface ConfettiParticleOptions {
         y: number;
     };
     colors?: string[];
+    /** 색상 프리셋 이름(CONFETTI_PALETTES). colors 가 있으면 colors 가 우선합니다. */
+    palette?: string;
     shapes?: ConfettiShape[];
     scalar?: number;
     zIndex?: number;
@@ -7542,6 +7873,7 @@ interface ConfettiFireworkOptions {
     interval?: number;
     particleCount?: number;
     colors?: string[];
+    palette?: string;
 }
 declare class DbConfetti extends HTMLElement {
     static get observedAttributes(): string[];
@@ -7567,6 +7899,9 @@ declare class DbConfetti extends HTMLElement {
     set originY(value: number);
     get colors(): string[];
     set colors(value: string[]);
+    /** 색상 프리셋 이름. `colors` 속성이 있으면 colors 가 우선합니다. */
+    get palette(): string;
+    set palette(value: string);
     get shapes(): ConfettiShape[];
     set shapes(value: ConfettiShape[]);
     get duration(): number;
@@ -7581,9 +7916,9 @@ declare class DbConfetti extends HTMLElement {
     private sync;
     fire(opts?: ConfettiParticleOptions): void;
     fireworks(options?: ConfettiFireworkOptions): void;
-    cannon(): void;
-    stars(): void;
-    pride(): void;
+    cannon(options?: ConfettiParticleOptions): void;
+    stars(options?: ConfettiParticleOptions): void;
+    pride(options?: ConfettiParticleOptions): void;
     snow(): void;
     fireByMode(): void;
     private drawStar;
@@ -7598,8 +7933,8 @@ interface ConfettiFunction {
     (options?: ConfettiParticleOptions): void;
     fireworks(options?: ConfettiFireworkOptions): void;
     cannon(options?: ConfettiParticleOptions): void;
-    stars(): void;
-    pride(): void;
+    stars(options?: ConfettiParticleOptions): void;
+    pride(options?: ConfettiParticleOptions): void;
     snow(): void;
 }
 declare const confetti: ConfettiFunction;
@@ -7756,10 +8091,8 @@ declare global {
     }
 }
 
-declare const ORIENTATIONS: readonly ["horizontal", "vertical"];
-declare const VARIANTS: readonly ["default", "contrast", "metal", "blue", "sage", "rose", "cobalt", "coral", "lime"];
-type DbCreditCardOrientation = typeof ORIENTATIONS[number];
-type DbCreditCardVariant = typeof VARIANTS[number];
+type DbCreditCardOrientation = typeof CREDIT_CARD_ORIENTATIONS[number];
+type DbCreditCardVariant = typeof CREDIT_CARD_VARIANTS[number];
 interface DbCreditCardFlip {
     flipped: boolean;
 }
@@ -7915,8 +8248,7 @@ declare function getPaymentBrand(network: string): {
     readonly src: string;
 } | undefined;
 
-declare const STATUSES: readonly ["scheduled", "boarding", "in-flight", "landed", "delayed", "cancelled"];
-type DbFlightStatusValue = typeof STATUSES[number];
+type DbFlightStatusValue = typeof FLIGHT_STATUSES[number];
 /** Display data supplied by the application; does not fetch or simulate live flights. */
 declare class DbFlightStatus extends DbElement {
     static get observedAttributes(): string[];
@@ -8085,8 +8417,6 @@ declare global {
     }
 }
 
-declare const NODE_VARIANTS: readonly ["default", "compact"];
-declare const NODE_STATUSES: readonly ["idle", "running", "success", "error"];
 type DbNodePortType = 'any' | 'text' | 'image' | 'number' | 'boolean';
 type DbNodePort = {
     id: string;