@designbasekorea/ui-wc 0.8.12 → 0.9.0

package/dist/index.d.ts

@@ -1,6 +1,3 @@
-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';
-
 /**
  * 엘리먼트 id 생성.
  *
@@ -165,6 +162,150 @@ declare function activateOnKey(el: HTMLElement, options?: {
  */
 /** 컴포넌트가 쓰는 문자열 키 → 기본(한국어) 값 */
 declare const DEFAULT_STRINGS: {
+    readonly 'aiElement.emptyFolder': "빈 폴더";
+    readonly 'aiElement.noFiles': "표시할 파일이 없습니다.";
+    readonly 'attachment.title': "첨부 파일";
+    readonly 'attachment.empty': "아직 첨부한 파일이 없습니다.";
+    readonly 'attachment.queued': "대기 중";
+    readonly 'attachment.uploading': "업로드 중";
+    readonly 'attachment.processing': "서버 처리 중";
+    readonly 'attachment.ready': "완료";
+    readonly 'attachment.error': "실패";
+    readonly 'attachment.cancelled': "취소됨";
+    readonly 'attachment.unknown': "진행률을 확인하고 있어요.";
+    readonly 'attachment.cancel': "취소";
+    readonly 'attachment.retry': "재시도";
+    readonly 'attachment.remove': "목록에서 제거";
+    readonly 'attachment.open': "상세 보기";
+    readonly 'attachment.reload': "다시 불러오기";
+    readonly 'workspace.members': "워크스페이스 멤버";
+    readonly 'workspace.invite': "멤버 초대";
+    readonly 'workspace.email': "이메일";
+    readonly 'workspace.role': "초대 역할";
+    readonly 'workspace.chooseRole': "역할을 선택하세요";
+    readonly 'workspace.description': "함께 작업할 사람의 이메일과 역할을 확인하세요.";
+    readonly 'workspace.submit': "초대 요청";
+    readonly 'workspace.emailError': "254자 이내의 올바른 이메일 주소를 입력해 주세요.";
+    readonly 'workspace.roleError': "초대할 역할을 선택해 주세요.";
+    readonly 'workspace.retry': "다시 불러오기";
+    readonly 'workspace.reinvite': "다시 초대";
+    readonly 'workspace.active': "이용 중";
+    readonly 'workspace.invited': "초대 대기";
+    readonly 'workspace.expired': "초대 만료";
+    readonly 'workspace.empty': "아직 표시할 멤버가 없습니다.";
+    readonly 'aiElement.pending': "대기 중";
+    readonly 'aiElement.running': "진행 중";
+    readonly 'aiElement.complete': "완료";
+    readonly 'aiElement.error': "실패";
+    readonly 'aiElement.cancelled': "취소됨";
+    readonly 'aiElement.approval': "승인 대기";
+    readonly 'aiElement.researching': "자료를 확인하고 있어요";
+    readonly 'aiElement.researched': "작업 과정 살펴보기";
+    readonly 'aiElement.thinking': "생각 정리 중";
+    readonly 'aiElement.reasoning': "응답 요약";
+    readonly 'aiElement.plan': "작업 계획";
+    readonly 'aiElement.queue': "대기 중인 요청";
+    readonly 'aiElement.remove': "제거";
+    readonly 'aiElement.queueEmpty': "대기 중인 요청이 없습니다.";
+    readonly 'aiElement.sources': "참고한 출처";
+    readonly 'aiElement.citation': "출처";
+    readonly 'aiElement.checkpoint': "체크포인트 저장됨";
+    readonly 'aiElement.restore': "여기부터 복원";
+    readonly 'aiElement.confirmation': "이 작업을 진행할까요?";
+    readonly 'aiElement.allow': "허용";
+    readonly 'aiElement.reject': "거절";
+    readonly 'aiElement.accepted': "작업을 허용했습니다.";
+    readonly 'aiElement.rejected': "작업을 거절했습니다.";
+    readonly 'aiElement.context': "컨텍스트";
+    readonly 'aiElement.tokens': "토큰";
+    readonly 'aiElement.unknown': "사용량을 아직 확인할 수 없습니다.";
+    readonly 'aiElement.files': "작업 파일";
+    readonly 'aiElement.task': "작업 진행";
+    readonly 'aiElement.subagent': "보조 에이전트";
+    readonly 'aiElement.tool': "도구 실행";
+    readonly 'aiElement.terminal': "터미널";
+    readonly 'aiElement.stackTrace': "오류 상세";
+    readonly 'aiElement.tests': "테스트 결과";
+    readonly 'aiElement.passed': "통과";
+    readonly 'aiElement.failed': "실패";
+    readonly 'aiElement.input': "입력";
+    readonly 'aiElement.output': "출력";
+    readonly 'aiElement.user': "사용자";
+    readonly 'aiElement.assistant': "AI 응답";
+    readonly 'aiElement.copy': "복사";
+    readonly 'aiElement.regenerate': "다시 생성";
+    readonly 'aiElement.like': "좋아요";
+    readonly 'aiElement.dislike': "싫어요";
+    readonly 'aiElement.latest': "최신 응답으로";
+    readonly 'aiElement.conversation': "AI와의 대화";
+    readonly 'notification.title': "알림";
+    readonly 'notification.filters': "알림 필터";
+    readonly 'notification.all': "전체";
+    readonly 'notification.unread': "안 읽음";
+    readonly 'notification.readAll': "표시된 알림 모두 읽음";
+    readonly 'notification.markRead': "읽음으로 표시";
+    readonly 'notification.retry': "다시 불러오기";
+    readonly 'notification.empty': "아직 도착한 알림이 없습니다.";
+    readonly 'notification.caughtUp': "모든 알림을 확인했어요.";
+    readonly 'notification.countUnknown': "확인 필요";
+    readonly 'aiModel.label': "사용 모델";
+    readonly 'aiModel.choose': "모델을 선택하세요";
+    readonly 'aiModel.empty': "현재 사용할 수 있는 모델이 없습니다.";
+    readonly 'aiModel.capabilities': "지원 작업";
+    readonly 'aiModel.usage': "사용량 단위";
+    readonly 'aiQuote.expires': "견적 유효 시간";
+    readonly 'aiQuote.title': "실행 전 견적";
+    readonly 'aiQuote.reserved': "예약할 최대 크레딧";
+    readonly 'aiQuote.providerCost': "예상 제공사 비용";
+    readonly 'aiQuote.pricingVersion': "가격표 버전";
+    readonly 'aiQuote.unknown': "미확정";
+    readonly 'aiQuote.idle': "모델과 요청 내용을 정한 뒤 견적을 확인하세요.";
+    readonly 'aiQuote.loading': "견적을 확인하고 있습니다.";
+    readonly 'aiQuote.executing': "요청을 처리하고 있습니다. 중복 실행하지 마세요.";
+    readonly 'aiQuote.stale': "모델 또는 입력이 변경됐습니다. 견적을 다시 확인하세요.";
+    readonly 'aiQuote.expired': "견적이 만료됐습니다. 견적을 다시 확인하세요.";
+    readonly 'aiQuote.balanceUnknown': "잔액을 확인할 수 없습니다. 새로 확인해 주세요.";
+    readonly 'aiQuote.insufficient': "추가로 필요한 크레딧:";
+    readonly 'aiQuote.ready': "실행 시 최대 크레딧을 예약하고, 결과 확인 후 실제 사용량으로 정산합니다.";
+    readonly 'aiQuote.refresh': "견적 다시 확인";
+    readonly 'aiQuote.request': "견적 확인";
+    readonly 'aiQuote.execute': "실행하기";
+    readonly 'plan.current': "현재 플랜";
+    readonly 'plan.usage': "이번 기간 사용";
+    readonly 'plan.allowed': "이용 가능";
+    readonly 'plan.locked': "미포함";
+    readonly 'plan.manage': "플랜 관리";
+    readonly 'plan.retry': "다시 불러오기";
+    readonly 'history.title': "크레딧 사용 내역";
+    readonly 'history.empty': "아직 표시할 내역이 없습니다.";
+    readonly 'history.unresolved': "확인 중";
+    readonly 'history.grant': "지급";
+    readonly 'history.charge': "사용";
+    readonly 'history.hold': "예약 · 정산 전";
+    readonly 'history.release': "예약 해제";
+    readonly 'credits.choosePlan': "충전할 크레딧";
+    readonly 'credits.rechargeDescription': "필요한 만큼 선택하고, 금액과 제공 조건을 확인하세요.";
+    readonly 'credits.paymentAmount': "결제 금액";
+    readonly 'credits.paymentPending': "결제 상태 확인 중";
+    readonly 'credits.remaining': "현재 남은 크레딧";
+    readonly 'credits.available': "사용 가능 크레딧";
+    readonly 'credits.unit': "크레딧";
+    readonly 'credits.held': "예약 중";
+    readonly 'credits.spent': "누적 사용";
+    readonly 'credits.charged': "차감";
+    readonly 'credits.low': "남은 크레딧이 적습니다.";
+    readonly 'credits.recharge': "크레딧 충전";
+    readonly 'credits.checkout': "결제 진행";
+    readonly 'credits.noPlans': "현재 충전 가능한 상품이 없습니다.";
+    readonly 'aiTask.title': "AI 작업";
+    readonly 'aiTask.idle': "작업 전";
+    readonly 'aiTask.queued': "실행 대기";
+    readonly 'aiTask.running': "실행 중";
+    readonly 'aiTask.succeeded': "완료";
+    readonly 'aiTask.failed': "실패";
+    readonly 'aiTask.cancelled': "취소됨";
+    readonly 'aiTask.needs_attention': "결과 확인 필요";
+    readonly 'aiTask.attentionDescription': "결과와 사용량을 확인하고 있습니다. 확인이 끝날 때까지 예약 크레딧이 유지됩니다.";
     readonly close: "닫기";
     readonly 'modal.close': "모달 닫기";
     readonly 'drawer.close': "드로어 닫기";
@@ -207,6 +348,15 @@ declare const DEFAULT_STRINGS: {
     readonly 'input.clearSearch': "검색어 지우기";
     readonly 'verify.done': "인증 완료";
     readonly 'verify.phoneDone': "휴대폰 번호 인증이 완료되었습니다.";
+    readonly 'bentoCard.cta': "자세히 보기";
+    readonly 'tweetCard.loading': "트윗을 불러오는 중입니다...";
+    readonly 'tweetCard.error': "트윗을 불러올 수 없습니다.";
+    readonly 'tweetCard.viewOnTwitter': "X에서 보기";
+    readonly 'tweetCard.like': "좋아요";
+    readonly 'tweetCard.retweet': "리포스트";
+    readonly 'tweetCard.reply': "답글";
+    readonly 'tweetCard.verified': "인증된 계정";
+    readonly 'tweetCard.retry': "다시 시도";
 };
 type DbStringKey = keyof typeof DEFAULT_STRINGS;
 type DbStrings = Partial<Record<DbStringKey, string>> & Record<string, string>;
@@ -335,6 +485,97 @@ declare global {
     }
 }
 
+/**
+ * 여러 컴포넌트가 공유하는 기본 스케일.
+ *
+ * 개별 컴포넌트가 자기만의 s/m/l 을 따로 선언하면 한쪽에서 값이 추가될 때
+ * 다른 쪽이 조용히 뒤처진다. 스케일은 여기서만 정의한다.
+ */
+/** 표준 3단계 스케일 — 대부분의 컨트롤(Button, Input, Checkbox 등)이 사용한다 */
+declare const SIZE_SML: readonly ["s", "m", "l"];
+type SizeSML = (typeof SIZE_SML)[number];
+/**
+ * 피드백 톤.
+ *
+ * ⚠️ `error` 가 아니라 `danger` 다. 디자인 토큰은 내부적으로 `feedback.error` 라는
+ * 키를 쓰지만, 컴포넌트 공개 API 는 danger 로 통일한다. 토큰 키와 API 이름이
+ * 다른 것은 의도된 것이며, 매핑은 각 구현체가 담당한다.
+ */
+declare const FEEDBACK_TONES: readonly ["info", "success", "warning", "danger"];
+type FeedbackTone = (typeof FEEDBACK_TONES)[number];
+
+/**
+ * 컴포넌트별 API 계약.
+ *
+ * 웹(@designbasekorea/ui-wc)과 React Native(@designbasekorea/ui-native)가
+ * 공유하는 컴포넌트의 variant/size/type 값은 전부 여기서 나온다.
+ * 한쪽에만 있는 컴포넌트(db-code-block, db-animation-background 등)는
+ * 여기에 넣지 않는다 — 공유하지 않는 것을 계약에 넣으면 계약이 죽는다.
+ *
+ * 값을 바꾸면 양쪽 구현이 동시에 타입 에러를 낸다. 그게 이 파일의 목적이다.
+ */
+
+declare const BADGE_VARIANTS: readonly ["primary", "secondary", "info", "success", "warning", "danger"];
+type BadgeVariant = (typeof BADGE_VARIANTS)[number];
+/**
+ * 표시 형태. 웹은 이 축을 `style` 이라고 불렀지만 `type` 으로 통일한다.
+ * (`style` 은 RN 에서 사실상 예약어이고, 나머지 컴포넌트도 `type` 을 쓴다)
+ */
+declare const BADGE_TYPES: readonly ["dot", "number", "text", "outlined"];
+type BadgeType = (typeof BADGE_TYPES)[number];
+type ToastVariant = 'default' | FeedbackTone;
+/**
+ * 웹 `toast()` 헬퍼가 이미 배포한 값 그대로다.
+ * RN 은 화면이 좁아 좌/중앙/우 차이가 작지만, 같은 이름을 받아야 코드가 옮겨진다.
+ */
+declare const TOAST_POSITIONS: readonly ["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right"];
+type ToastPosition = (typeof TOAST_POSITIONS)[number];
+declare const NAVIGATION_RAIL_LABEL_DISPLAYS: readonly ["tooltip", "always"];
+type NavigationRailLabelDisplay = (typeof NAVIGATION_RAIL_LABEL_DISPLAYS)[number];
+declare const CHAT_MESSAGE_ROLES: readonly ["user", "assistant", "system"];
+declare const AI_GLOW_VARIANTS: readonly ["aurora", "brand"];
+declare const AI_GLOW_STATES: readonly ["thinking", "working", "listening"];
+declare const AI_GLOW_SIZES: readonly ["s", "m", "l"];
+declare const CHAT_ORB_SIZES: readonly ["xs", "s", "m", "l", "xl"];
+declare const CHAT_ORB_VARIANTS: readonly ["aurora", "ocean", "emerald", "violet", "mono"];
+declare const CHAT_ORB_STATES: readonly ["idle", "thinking", "listening"];
+declare const CHAT_ORB_THEMES: readonly ["auto", "light", "dark"];
+declare const CHAT_WIDGET_VIEWS: readonly ["home", "messages", "conversation", "help", "article"];
+declare const CHAT_WIDGET_POSITIONS: readonly ["bottom-right", "bottom-left"];
+declare const DOWNLOAD_PROGRESS_STATUSES: readonly ["downloading", "paused", "error", "complete"];
+declare const DOWNLOAD_PROGRESS_POSITIONS: readonly ["bottom-right", "bottom-left", "bottom-center", "top-right", "top-left", "top-center"];
+declare const EMAIL_VERIFY_SIZES: readonly ["s", "m", "l"];
+declare const OTP_INPUT_SIZES: readonly ["s", "m", "l"];
+declare const PHONE_VERIFY_SIZES: readonly ["s", "m", "l"];
+declare const SIDEBAR_ACCORDION_MODES: readonly ["single", "multiple"];
+declare const TIME_PICKER_FORMATS: readonly ["12h", "24h", "12h-with-seconds", "24h-with-seconds"];
+declare const TWO_FACTOR_SIZES: readonly ["s", "m", "l"];
+type BentoGridSize = SizeSML;
+declare const BENTO_GRID_COLUMNS: readonly ["1", "2", "3", "4"];
+type BentoGridColumns = (typeof BENTO_GRID_COLUMNS)[number];
+declare const BENTO_CARD_VARIANTS: readonly ["default", "flat", "elevated"];
+type BentoCardVariant = (typeof BENTO_CARD_VARIANTS)[number];
+type BentoCardSize = SizeSML;
+declare const BENTO_CARD_IMAGE_POSITIONS: readonly ["top", "cover"];
+type BentoCardImagePosition = (typeof BENTO_CARD_IMAGE_POSITIONS)[number];
+declare const TWEET_CARD_VARIANTS: readonly ["default", "flat", "outlined"];
+type TweetCardVariant = (typeof TWEET_CARD_VARIANTS)[number];
+type TweetCardSize = SizeSML;
+declare const PROGRESSIVE_BLUR_POSITIONS: readonly ["top", "bottom", "both", "left", "right"];
+type ProgressiveBlurPosition = (typeof PROGRESSIVE_BLUR_POSITIONS)[number];
+type ProgressiveBlurSize = SizeSML;
+declare const BORDER_BEAM_VARIANTS: readonly ["default", "rainbow", "glow"];
+type BorderBeamVariant = (typeof BORDER_BEAM_VARIANTS)[number];
+declare const CONFETTI_MODES: readonly ["cannon", "fireworks", "stars", "pride", "snow"];
+type ConfettiMode = (typeof CONFETTI_MODES)[number];
+declare const CONFETTI_TRIGGERS: readonly ["manual", "auto", "click"];
+type ConfettiTrigger = (typeof CONFETTI_TRIGGERS)[number];
+declare const CONFETTI_SHAPES: readonly ["mix", "square", "circle", "star"];
+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;
+
 interface DbNavigationRailItem {
     id: string;
     label: string;
@@ -426,7 +667,7 @@ declare class DbButton extends HTMLElement {
     private syncRadius;
     private syncAccentStyle;
     /**
-     * outline 스타일의 회전하는 테두리 글로우.
+     * outline·prism 스타일의 회전하는 테두리 레이어.
      *
      * conic-gradient 의 각도를 직접 애니메이션하려면 `@property` 가 필요해 기준선이 올라간다.
      * 대신 넘치는 정사각형을 `overflow: hidden` 컨테이너 안에서 회전시키고,
@@ -785,7 +1026,7 @@ declare class DbModal extends HTMLElement {
     private childObserver?;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(name: string): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     private resolvedSize;
     get size(): string;
     set size(value: string);
@@ -855,6 +1096,8 @@ declare class DbDropdown extends HTMLElement {
     private focusedIndex;
     private onTriggerActivate;
     private lastTriggerSignature;
+    get showChevron(): boolean;
+    set showChevron(value: boolean);
     get parsedItems(): DbDropdownItem[];
     get options(): string[] | string;
     set options(value: string[] | string);
@@ -1632,6 +1875,8 @@ interface DbMenuItemChildData {
     variant?: string;
 }
 declare class DbMenuItem extends HTMLElement {
+    private static nextId;
+    private readonly childrenId;
     static get observedAttributes(): string[];
     get subItems(): DbMenuItemChildData[];
     set subItems(value: DbMenuItemChildData[] | string);
@@ -2047,6 +2292,8 @@ interface DbNavbarUserProfile {
     badgeText?: string;
 }
 declare class DbNavbar extends HTMLElement {
+    private static nextId;
+    private readonly mobileMenuId;
     private mobileOpen;
     private userMenuOpen;
     private expandedMobile;
@@ -2126,6 +2373,9 @@ interface DbFooterFamilySite {
     href: string;
 }
 declare class DbFooter extends HTMLElement {
+    /** Light-DOM slots retain framework state and listeners across attribute updates. */
+    private brandContent;
+    private bottomContent;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     attributeChangedCallback(): void;
@@ -2259,6 +2509,15 @@ declare class DbSidebar extends HTMLElement {
     private bindPanelMediaQuery;
     private unbindPanelMediaQuery;
     private seedExpanded;
+    /** Open navigation groups. Accepts an array or JSON, independently of active selection. */
+    get expandedIds(): string[];
+    set expandedIds(value: string[] | string);
+    get accordionMode(): (typeof SIDEBAR_ACCORDION_MODES)[number];
+    set accordionMode(value: (typeof SIDEBAR_ACCORDION_MODES)[number]);
+    get hideExpandIcon(): boolean;
+    set hideExpandIcon(value: boolean);
+    get showDepthGuide(): boolean;
+    set showDepthGuide(value: boolean);
     get items(): DbSidebarItem[];
     set items(value: DbSidebarItem[] | string);
     get sections(): DbSidebarSection[];
@@ -2327,7 +2586,7 @@ declare class DbSidebar extends HTMLElement {
     private getSelectedProject;
     private bindOutsideClick;
     private closeOverlayMenus;
-    private syncExclusiveAccordion;
+    private syncAccordionState;
     private unbindOutsideClick;
     private cancelFlyoutClose;
     private showFlyout;
@@ -2335,6 +2594,8 @@ declare class DbSidebar extends HTMLElement {
     private cancelUserFlyoutClose;
     private setUserFlyout;
     private scheduleUserFlyoutClose;
+    /** Content role; visual wrapper variants remain independent. */
+    private get sidebarType();
     private syncHostClasses;
     private navigateToPanel;
     private dispatchItemClick;
@@ -2654,6 +2915,38 @@ declare global {
     }
 }
 
+declare const FILTER_BAR_SIZES: readonly ["s", "m", "l"];
+declare const FILTER_BAR_VARIANTS: readonly ["plain", "outlined", "filled"];
+declare const FILTER_BAR_ALIGNS: readonly ["start", "end"];
+type FilterBarSize = (typeof FILTER_BAR_SIZES)[number];
+type FilterBarVariant = (typeof FILTER_BAR_VARIANTS)[number];
+type FilterBarAlign = (typeof FILTER_BAR_ALIGNS)[number];
+/**
+ * Search/filter composition. Direct children use search, filters, summary and
+ * actions slots. No rendering or reparenting: field values, focus, overlays and
+ * framework listeners remain owned by the controls supplied by the consumer.
+ *
+ * This is a labelled group, not an ARIA toolbar: fields keep normal Tab order.
+ */
+declare class DbFilterBar extends HTMLElement {
+    static get observedAttributes(): string[];
+    private decoration;
+    get padding(): boolean;
+    set padding(value: boolean);
+    get border(): boolean;
+    set border(value: boolean);
+    get background(): boolean;
+    set background(value: boolean);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private syncHostClasses;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-filter-bar': DbFilterBar;
+    }
+}
+
 interface DbToolbarItemData {
     id: string;
     type?: 'button' | 'separator';
@@ -2844,23 +3137,31 @@ declare global {
     }
 }
 
-declare class DbFloatingActionButton extends HTMLElement {
-    private detachKeyActivation?;
+/** Floating placement and collapsing label, with the canonical Button behavior and visuals. */
+declare class DbFloatingActionButton extends DbButton {
+    private scrollRoot;
+    private lastScroll;
+    private mappedIcon?;
+    private scrollCollapsed;
+    private labelObserver?;
     static get observedAttributes(): string[];
-    get size(): string;
-    set size(value: string);
-    get variant(): string;
-    set variant(value: string);
-    get loading(): boolean;
-    set loading(value: boolean);
-    get disabled(): boolean;
-    set disabled(value: boolean);
+    get label(): string;
+    set label(value: string);
+    get collapsed(): boolean;
+    set collapsed(value: boolean);
+    get collapseOnScroll(): boolean;
+    set collapseOnScroll(value: boolean);
+    get collapseThreshold(): number;
+    set collapseThreshold(value: number);
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(): void;
-    private handleClick;
-    private resolveIconName;
-    private sync;
+    attributeChangedCallback(name?: string): void;
+    private syncFab;
+    private measureLabel;
+    private unbindScroll;
+    private bindScroll;
+    private scrollPosition;
+    private onScroll;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -3051,7 +3352,9 @@ declare class DbSplitView extends HTMLElement {
     private getSplitterSize;
     private getGap;
     private handleMouseDown;
+    private resizeAt;
     private handleMouseMove;
+    private handleSplitterKey;
     private handleMouseUp;
     private applyPanelSizes;
     private sync;
@@ -3062,6 +3365,15 @@ declare global {
     }
 }
 
+type FileStatus = 'pending' | 'uploading' | 'success' | 'error';
+type UploadFile = {
+    file: File;
+    id: string;
+    status: FileStatus;
+    progress: number;
+    error?: string;
+    uploadedAt?: Date;
+};
 declare class DbFileUploader extends HTMLElement {
     static get observedAttributes(): string[];
     private dropzone?;
@@ -3088,6 +3400,9 @@ declare global {
     }
 }
 
+type GradientScheme = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'info' | 'purple' | 'ocean' | 'sunset';
+type GradientTone = 'light' | 'vivid' | 'dark';
+
 type DatePickerMode = 'single' | 'range' | 'multiple';
 declare class DbDatePicker extends HTMLElement {
     static get observedAttributes(): string[];
@@ -3561,6 +3876,7 @@ declare class DbColorPicker extends HTMLElement {
     private commitAlphaInput;
     private onCopy;
     private onEyedrop;
+    private handleEscape;
     private handleOutsideClick;
     private handleDocumentMouseMove;
     private handleDocumentMouseUp;
@@ -5421,7 +5737,28 @@ 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' | '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';
+type DbIconName = 'shape-line' | 'shape-triangle' | 'shape-ellipse' | 'shape-rectangle' | 'filp-vertical' | 'filp-horizontal' | 'filter' | 'sort-descending' | 'navigation' | 'move' | 'arrow-back-up' | 'zoom-in' | 'zoom-out' | 'layer' | 'unlock' | 'layout-align-left' | 'layout-align-center' | 'layout-align-right' | 'layout-align-top' | 'layout-align-middle' | 'layout-align-bottom' | 'text' | 'shapes' | 'text-align-left' | 'text-align-center' | 'text-align-right' | 'desktop' | 'tablet' | 'mobile' | 'plane' | 'arrow-bar-left' | 'arrow-bar-right' | 'award' | 'apple' | 'play-store' | 'arrow-right' | 'star' | 'star-filled' | 'star-half' | 'trending-up' | 'cart' | 'credit-card' | '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-outline' | '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' | 'twitter' | 'x-logo' | 'heart' | 'heart-filled' | 'verified-badge' | 'comment' | 'user' | 'warning-filled';
+
+type DbVoiceState = 'idle' | 'starting' | 'listening' | 'stopping' | 'completed' | 'cancelled' | 'error' | 'unsupported';
+/** Controlled voice UI only: emits intent, never opens the microphone or uploads audio. */
+declare class DbVoiceControl extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private action;
+    private cancel;
+    private label;
+    private status;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private get active();
+    private emit;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-voice-control': DbVoiceControl;
+    }
+}
 
 interface DbChatTool {
     /** 고유 id (이벤트 detail 로 전달) */
@@ -5520,6 +5857,7 @@ declare class DbChatComposer extends HTMLElement {
     private renderAttachMenu;
     private renderAttachments;
     private renderSendButton;
+    private get voiceActive();
     private syncSendState;
     private autoGrow;
     private handleAttachClick;
@@ -6225,5 +6563,1793 @@ interface DbConfirmOptions {
 /** 확인 대화상자를 띄우고, 확인 시 true / 취소(ESC·배경 포함) 시 false 로 resolve 합니다. */
 declare function confirm(options: DbConfirmOptions): Promise<boolean>;
 
-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 };
+/** Server-supplied available balance; held/spent are separate amounts, never subtracted here. */
+declare class DbCreditBalance extends DbElement {
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-credit-balance': DbCreditBalance;
+    }
+}
+
+interface DbCreditPlan {
+    id: string;
+    label: string;
+    credits: number;
+    /** Preformatted display price; the server must resolve the actual price by id. */
+    priceLabel: string;
+    description?: string;
+    badge?: string;
+    disabled?: boolean;
+}
+interface DbCreditPlanSelection {
+    planId: string;
+}
+/** Controlled selector. Emits intent only; never grants credits or marks payment successful. */
+declare class DbCreditRecharge extends DbElement {
+    private readonly groupName;
+    private planData;
+    static get observedAttributes(): string[];
+    get plans(): DbCreditPlan[];
+    set plans(value: DbCreditPlan[]);
+    connectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private readPlans;
+    private blocked;
+    private selected;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-credit-recharge': DbCreditRecharge;
+    }
+}
+
+type DbAiTaskState = 'idle' | 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'needs_attention';
+interface DbAiTaskAction {
+    taskId: string;
+}
+/** Display state comes from the app. No fake percentages, automatic retries or refunds. */
+declare class DbAiTaskStatus extends DbElement {
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private state;
+    private actions;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-task-status': DbAiTaskStatus;
+    }
+}
+
+/** Header balance disclosure. Native Popover keeps live nodes/listeners in the top layer. */
+declare class DbCreditDropdown extends DbElement {
+    private trigger?;
+    private popup?;
+    private balance?;
+    private recharge?;
+    private history?;
+    private description?;
+    private readonly popupId;
+    static get observedAttributes(): string[];
+    get open(): boolean;
+    set open(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private closeAndFocus;
+    private ensureView;
+    private sync;
+    private position;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-credit-dropdown': DbCreditDropdown;
+    }
+}
+
+/** Reuses the canonical modal (portal, focus trap, scroll lock) and controlled plan selector. */
+declare class DbCreditRechargeModal extends DbElement {
+    private modal?;
+    private selector?;
+    private balance?;
+    private intro?;
+    private confirm?;
+    private footnote?;
+    private planData;
+    static get observedAttributes(): string[];
+    get plans(): DbCreditPlan[];
+    set plans(value: DbCreditPlan[]);
+    get open(): boolean;
+    set open(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private readPlans;
+    private blocked;
+    private selected;
+    private ensureView;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-credit-recharge-modal': DbCreditRechargeModal;
+    }
+}
+
+interface DbPlanFeature {
+    id: string;
+    label: string;
+    allowed: boolean;
+}
+/** Presentation of server-supplied entitlements. Never grants access or changes subscriptions. */
+declare class DbPlanOverview extends DbElement {
+    private featureData;
+    static get observedAttributes(): string[];
+    get features(): DbPlanFeature[];
+    set features(value: DbPlanFeature[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-plan-overview': DbPlanOverview;
+    }
+}
+
+type DbCreditEntryKind = 'grant' | 'charge' | 'hold' | 'release';
+interface DbCreditEntry {
+    id: string;
+    label: string;
+    /** App formats the date in its explicit locale/timezone. */
+    dateLabel: string;
+    kind: DbCreditEntryKind;
+    /** Null means unresolved. Holds are separate from settled debits. */
+    amount: number | null;
+}
+/** Read-only history supplied by the app. Does not sum a balance from partial rows. */
+declare class DbCreditHistory extends DbElement {
+    private entryData;
+    static get observedAttributes(): string[];
+    get entries(): DbCreditEntry[];
+    set entries(value: DbCreditEntry[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-credit-history': DbCreditHistory;
+    }
+}
+
+interface DbAiModelOption {
+    id: string;
+    label: string;
+    description: string;
+    capabilities: string[];
+    usageLabel: string;
+    disabled?: boolean;
+    disabledReason?: string;
+}
+interface DbAiModelSelection {
+    modelId: string;
+}
+/** Product-supplied catalog, not an authorization or provider registry. */
+declare class DbAiModelSelect extends DbElement {
+    private modelData;
+    private select?;
+    private details?;
+    static get observedAttributes(): string[];
+    get models(): DbAiModelOption[];
+    set models(value: DbAiModelOption[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private blocked;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-model-select': DbAiModelSelect;
+    }
+}
+
+interface DbAiQuoteView {
+    id: string;
+    modelId: string;
+    reservedCredits: number;
+    pricingVersion: string;
+    expiresAt: string;
+    /** Product-formatted deadline; expiresAt remains authoritative for UI expiry. */
+    expiresLabel?: string;
+    /** Already formatted by the app. Omit when provider cost is unknown. */
+    providerCostLabel?: string;
+}
+interface DbAiQuoteExecution {
+    quoteId: string;
+    modelId: string;
+}
+/** Displays a server quote and emits intent. No reservations, API requests or price calculation. */
+declare class DbAiExecutionQuote extends DbElement {
+    private quoteData;
+    private expiryTimer?;
+    static get observedAttributes(): string[];
+    get quote(): DbAiQuoteView | null;
+    set quote(value: DbAiQuoteView | null);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private busy;
+    private expired;
+    private canExecute;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-execution-quote': DbAiExecutionQuote;
+    }
+}
+
+/** Product-supplied presentation data; no URLs, user ids or delivery policy. */
+interface DbNotificationItem {
+    id: string;
+    title: string;
+    description: string;
+    dateLabel: string;
+    unread: boolean;
+    categoryLabel?: string;
+}
+interface DbNotificationAction {
+    id: string;
+}
+interface DbNotificationReadAll {
+    ids: string[];
+}
+
+/** Controlled data, local filter. The app confirms read state; opening never marks an item read implicitly. */
+declare class DbNotificationInbox extends DbElement {
+    private itemData;
+    private filter;
+    private restoreFocus;
+    static get observedAttributes(): string[];
+    get notifications(): DbNotificationItem[];
+    set notifications(value: DbNotificationItem[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private blocked;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-notification-inbox': DbNotificationInbox;
+    }
+}
+
+/** Header wrapper around the same controlled inbox. Native Popover preserves listeners and focus. */
+declare class DbNotificationDropdown extends DbElement {
+    private trigger?;
+    private panel?;
+    private inbox?;
+    private itemData;
+    private readonly panelId;
+    static get observedAttributes(): string[];
+    get notifications(): DbNotificationItem[];
+    set notifications(value: DbNotificationItem[]);
+    get open(): boolean;
+    set open(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private sync;
+    private position;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-notification-dropdown': DbNotificationDropdown;
+    }
+}
+
+type DbAiStatus = 'pending' | 'running' | 'complete' | 'error' | 'cancelled' | 'approval';
+interface DbAiItem {
+    id: string;
+    label: string;
+    description?: string;
+    status?: DbAiStatus;
+    code?: string;
+    language?: string;
+    href?: string;
+    meta?: string;
+    children?: DbAiItem[];
+    open?: boolean;
+}
+interface DbAiAction {
+    id: string;
+    action: string;
+}
+/** Shared presentation only. The app supplies execution state and handles every action. */
+declare abstract class DbAiDataElement extends DbElement {
+    private data;
+    private disclosureState;
+    get items(): DbAiItem[];
+    set items(value: DbAiItem[]);
+    protected get rows(): readonly DbAiItem[];
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private readAttributeItems;
+    protected attr(name: string, key?: string): string;
+    protected get state(): DbAiStatus;
+    protected action(action: string, id: string): void;
+    protected button(action: string, label: string, icon?: DbIconName, id?: string): HTMLElement;
+    protected closeDisclosure(details: HTMLDetailsElement, restoreFocus?: boolean): void;
+    protected disclosure(id: string, label: string, status: DbAiStatus, body: Node[], defaultOpen?: boolean, icon?: DbIconName): HTMLDetailsElement;
+    protected itemLine(item: DbAiItem): HTMLElement;
+    protected update(resetRoot?: boolean): void;
+    protected abstract view(): Node[];
+}
+
+/** AI Elements: chain-of-thought. App-owned data and actions; no provider calls. */
+declare class DbAiChainOfThought extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-chain-of-thought': DbAiChainOfThought;
+    }
+}
+
+/** AI Elements: reasoning. App-owned data and actions; no provider calls. */
+declare class DbAiReasoning extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-reasoning': DbAiReasoning;
+    }
+}
+
+/** AI Elements: plan. App-owned data and actions; no provider calls. */
+declare class DbAiPlan extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-plan': DbAiPlan;
+    }
+}
+
+/** AI Elements: queue. App-owned data and actions; no provider calls. */
+declare class DbAiQueue extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-queue': DbAiQueue;
+    }
+}
+
+/** AI Elements: sources. App-owned data and actions; no provider calls. */
+declare class DbAiSources extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-sources': DbAiSources;
+    }
+}
+
+/** AI Elements: inline-citation. App-owned data and actions; no provider calls. */
+declare class DbAiInlineCitation extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    private place;
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-inline-citation': DbAiInlineCitation;
+    }
+}
+
+/** AI Elements: checkpoint. App-owned data and actions; no provider calls. */
+declare class DbAiCheckpoint extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-checkpoint': DbAiCheckpoint;
+    }
+}
+
+/** AI Elements: confirmation. App-owned data and actions; no provider calls. */
+declare class DbAiConfirmation extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-confirmation': DbAiConfirmation;
+    }
+}
+
+/** AI Elements: context. App-owned data and actions; no provider calls. */
+declare class DbAiContext extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-context': DbAiContext;
+    }
+}
+
+/** AI Elements: file-tree. App-owned data and actions; no provider calls. */
+declare class DbAiFileTree extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-file-tree': DbAiFileTree;
+    }
+}
+
+/** AI Elements: task. App-owned data and actions; no provider calls. */
+declare class DbAiTask extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-task': DbAiTask;
+    }
+}
+
+/** AI Elements: subagent. App-owned data and actions; no provider calls. */
+declare class DbAiSubagent extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-subagent': DbAiSubagent;
+    }
+}
+
+/** AI Elements: tool. App-owned data and actions; no provider calls. */
+declare class DbAiTool extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-tool': DbAiTool;
+    }
+}
+
+/** AI Elements: terminal. App-owned data and actions; no provider calls. */
+declare class DbAiTerminal extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-terminal': DbAiTerminal;
+    }
+}
+
+/** AI Elements: stack-trace. App-owned data and actions; no provider calls. */
+declare class DbAiStackTrace extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-stack-trace': DbAiStackTrace;
+    }
+}
+
+/** AI Elements: test-results. App-owned data and actions; no provider calls. */
+declare class DbAiTestResults extends DbAiDataElement {
+    static get observedAttributes(): string[];
+    protected view(): Node[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-test-results': DbAiTestResults;
+    }
+}
+
+/** Lightweight conversation turn. Native content/React children remain owned by the caller. */
+declare class DbAiMessage extends DbElement {
+    static get observedAttributes(): string[];
+    private content?;
+    private footer?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-message': DbAiMessage;
+    }
+}
+
+/** Follows updates only at the live edge. Reading older content never forces a jump. */
+declare class DbAiConversation extends DbElement {
+    static get observedAttributes(): string[];
+    private viewport?;
+    private jump?;
+    private atEnd;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private toEnd;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ai-conversation': DbAiConversation;
+    }
+}
+
+type DbWorkspaceMemberState = 'active' | 'invited' | 'expired';
+interface DbWorkspaceMember {
+    id: string;
+    name: string;
+    email: string;
+    roleLabel: string;
+    state: DbWorkspaceMemberState;
+    canReinvite?: boolean;
+}
+interface DbWorkspaceMemberAction {
+    id: string;
+}
+/** Display only. Roles and invitation status must come from the product's server. */
+declare class DbWorkspaceMembers extends DbElement {
+    private data;
+    static get observedAttributes(): string[];
+    get members(): DbWorkspaceMember[];
+    set members(value: DbWorkspaceMember[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private blocked;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-workspace-members': DbWorkspaceMembers;
+    }
+}
+
+interface DbWorkspaceInviteRole {
+    id: string;
+    label: string;
+}
+interface DbWorkspaceInviteDraft {
+    email: string;
+    roleId: string;
+}
+/** Owns an unsaved UI draft. Emits intent only; never sends mail or grants membership. */
+declare class DbWorkspaceInviteModal extends DbElement {
+    private roleData;
+    private emailDraft;
+    private roleDraft;
+    private fieldError;
+    private modal?;
+    private emailField?;
+    private roleField?;
+    private message?;
+    private intro?;
+    private readonly descriptionId;
+    private confirm?;
+    static get observedAttributes(): string[];
+    get roles(): DbWorkspaceInviteRole[];
+    set roles(value: DbWorkspaceInviteRole[]);
+    get open(): boolean;
+    set open(value: boolean);
+    get draft(): DbWorkspaceInviteDraft;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private blocked;
+    private validateEmail;
+    private submit;
+    private ensureView;
+    private syncErrors;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-workspace-invite-modal': DbWorkspaceInviteModal;
+    }
+}
+
+type DbAttachmentState = 'queued' | 'uploading' | 'processing' | 'ready' | 'error' | 'cancelled';
+interface DbAttachment {
+    id: string;
+    name: string;
+    bytes: number;
+    state: DbAttachmentState;
+    progress?: number | null;
+    error?: string;
+    canOpen?: boolean;
+    canRetry?: boolean;
+}
+interface DbAttachmentAction {
+    id: string;
+}
+/** Controlled presentation. No timer, upload request, public URL or storage credential. */
+declare class DbAttachmentList extends DbElement {
+    private data;
+    static get observedAttributes(): string[];
+    get attachments(): DbAttachment[];
+    set attachments(value: DbAttachment[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private blocked;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-attachment-list': DbAttachmentList;
+    }
+}
+
+declare class DbBentoGrid extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    get cols(): BentoGridColumns;
+    set cols(value: BentoGridColumns);
+    get size(): BentoGridSize;
+    set size(value: BentoGridSize);
+    get gap(): string;
+    set gap(value: string);
+    get autoRows(): string;
+    set autoRows(value: string);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-bento-grid': DbBentoGrid;
+    }
+}
+
+declare class DbBentoCard extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private bgWrapper?;
+    private imgEl?;
+    private contentWrapper?;
+    private iconEl?;
+    private titleEl?;
+    private descEl?;
+    private ctaWrapper?;
+    private ctaBtn?;
+    private ctaTextSpan?;
+    private overlayEl?;
+    get name(): string;
+    set name(value: string);
+    get description(): string;
+    set description(value: string);
+    get icon(): string;
+    set icon(value: string);
+    get href(): string;
+    set href(value: string);
+    get cta(): string;
+    set cta(value: string);
+    get colSpan(): string;
+    set colSpan(value: string);
+    get rowSpan(): string;
+    set rowSpan(value: string);
+    get variant(): BentoCardVariant;
+    set variant(value: BentoCardVariant);
+    get size(): BentoCardSize;
+    set size(value: BentoCardSize);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get image(): string;
+    set image(value: string);
+    get imageAlt(): string;
+    set imageAlt(value: string);
+    get imagePosition(): BentoCardImagePosition;
+    set imagePosition(value: BentoCardImagePosition);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private handleCtaClick;
+    private build;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-bento-card': DbBentoCard;
+    }
+}
+
+interface DbTweetData {
+    id?: string;
+    text?: string;
+    authorName?: string;
+    username?: string;
+    avatar?: string;
+    verified?: boolean;
+    createdAt?: string;
+    likes?: number;
+    retweets?: number;
+    replies?: number;
+    views?: number;
+    mediaUrl?: string;
+    tweetUrl?: string;
+}
+declare class DbTweetCard extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private abortController;
+    private isLiked;
+    private localLikes;
+    private headerEl?;
+    private avatarImg?;
+    private avatarFallback?;
+    private authorNameEl?;
+    private authorHandleEl?;
+    private verifiedBadgeEl?;
+    private xLogoLink?;
+    private bodyEl?;
+    private mediaContainer?;
+    private mediaImg?;
+    private dateEl?;
+    private actionsRow?;
+    private replyBtn?;
+    private replyCountSpan?;
+    private retweetBtn?;
+    private retweetCountSpan?;
+    private likeBtn?;
+    private likeCountSpan?;
+    private shareBtn?;
+    private skeletonEl?;
+    private errorEl?;
+    private errorTextEl?;
+    private retryBtn?;
+    get tweetId(): string;
+    set tweetId(value: string);
+    get authorName(): string;
+    set authorName(value: string);
+    get username(): string;
+    set username(value: string);
+    get avatar(): string;
+    set avatar(value: string);
+    get verified(): boolean;
+    set verified(value: boolean);
+    get content(): string;
+    set content(value: string);
+    get date(): string;
+    set date(value: string);
+    get likes(): number;
+    set likes(value: number);
+    get retweets(): number;
+    set retweets(value: number);
+    get replies(): number;
+    set replies(value: number);
+    get media(): string;
+    set media(value: string);
+    get href(): string;
+    set href(value: string);
+    get variant(): TweetCardVariant;
+    set variant(value: TweetCardVariant);
+    get size(): TweetCardSize;
+    set size(value: TweetCardSize);
+    get loading(): boolean;
+    set loading(value: boolean);
+    get error(): string;
+    set error(value: string);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private fetchTweetData;
+    private applyTweetPayload;
+    private handleReplyClick;
+    private handleRetweetClick;
+    private handleLikeClick;
+    private handleShareClick;
+    private handleRetryClick;
+    private getTweetUrl;
+    private build;
+    private updateLikeButton;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-tweet-card': DbTweetCard;
+    }
+}
+
+declare class DbProgressiveBlur extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private topPanel?;
+    private bottomPanel?;
+    private mainPanel?;
+    get position(): ProgressiveBlurPosition;
+    set position(value: ProgressiveBlurPosition);
+    get size(): ProgressiveBlurSize;
+    set size(value: ProgressiveBlurSize);
+    get height(): string;
+    set height(value: string);
+    get width(): string;
+    set width(value: string);
+    get tint(): string;
+    set tint(value: string);
+    get blurLevels(): number[];
+    set blurLevels(value: number[]);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private build;
+    private createEdgePanel;
+    private renderLayers;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-progressive-blur': DbProgressiveBlur;
+    }
+}
+
+declare class DbBorderBeam extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private beamEl?;
+    private currentPlaybackRate;
+    private targetPlaybackRate;
+    private speedAnimRafId;
+    private rampPlaybackRate;
+    private onParentEnter;
+    private onParentLeave;
+    get size(): string;
+    set size(value: string);
+    get duration(): number;
+    set duration(value: number);
+    get delay(): number;
+    set delay(value: number);
+    get colorFrom(): string;
+    set colorFrom(value: string);
+    get colorTo(): string;
+    set colorTo(value: string);
+    get borderWidth(): number;
+    set borderWidth(value: number);
+    get reverse(): boolean;
+    set reverse(value: boolean);
+    get initialOffset(): number;
+    set initialOffset(value: number);
+    get anchor(): number;
+    set anchor(value: number);
+    get variant(): BorderBeamVariant;
+    set variant(value: BorderBeamVariant);
+    get radius(): string;
+    set radius(value: string);
+    get hoverSpeed(): number;
+    set hoverSpeed(value: number);
+    get hoverScale(): number;
+    set hoverScale(value: number);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private build;
+    private updateRadius;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-border-beam': DbBorderBeam;
+    }
+}
+
+interface ConfettiParticleOptions {
+    particleCount?: number;
+    angle?: number;
+    spread?: number;
+    startVelocity?: number;
+    decay?: number;
+    gravity?: number;
+    drift?: number;
+    ticks?: number;
+    origin?: {
+        x: number;
+        y: number;
+    };
+    colors?: string[];
+    shapes?: ConfettiShape[];
+    scalar?: number;
+    zIndex?: number;
+    disableForReducedMotion?: boolean;
+}
+interface ConfettiFireworkOptions {
+    duration?: number;
+    interval?: number;
+    particleCount?: number;
+    colors?: string[];
+}
+declare class DbConfetti extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private canvas?;
+    private ctx?;
+    private particles;
+    private animationId;
+    private fireworkTimer;
+    private resizeObserver?;
+    private clickHandler;
+    get mode(): ConfettiMode;
+    set mode(value: ConfettiMode);
+    get trigger(): ConfettiTrigger;
+    set trigger(value: ConfettiTrigger);
+    get particleCount(): number;
+    set particleCount(value: number);
+    get spread(): number;
+    set spread(value: number);
+    get originX(): number;
+    set originX(value: number);
+    get originY(): number;
+    set originY(value: number);
+    get colors(): string[];
+    set colors(value: string[]);
+    get shapes(): ConfettiShape[];
+    set shapes(value: ConfettiShape[]);
+    get duration(): number;
+    set duration(value: number);
+    get fullscreen(): boolean;
+    set fullscreen(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _oldVal: string | null, _newVal: string | null): void;
+    private build;
+    private updateCanvasSize;
+    private sync;
+    fire(opts?: ConfettiParticleOptions): void;
+    fireworks(options?: ConfettiFireworkOptions): void;
+    cannon(): void;
+    stars(): void;
+    pride(): void;
+    snow(): void;
+    fireByMode(): void;
+    private drawStar;
+    private loop;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-confetti': DbConfetti;
+    }
+}
+interface ConfettiFunction {
+    (options?: ConfettiParticleOptions): void;
+    fireworks(options?: ConfettiFireworkOptions): void;
+    cannon(options?: ConfettiParticleOptions): void;
+    stars(): void;
+    pride(): void;
+    snow(): void;
+}
+declare const confetti: ConfettiFunction;
+
+declare class DbGlyphMatrix extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private canvas?;
+    private ctx?;
+    private ro?;
+    private rafId;
+    private lastTick;
+    private stopped;
+    private cols;
+    private rows;
+    private cells;
+    private alphas;
+    private rgba;
+    private mouseX;
+    private mouseY;
+    private mouseHandler;
+    private mouseLeaveHandler;
+    get preset(): GlyphMatrixPreset;
+    set preset(value: GlyphMatrixPreset);
+    get size(): GlyphMatrixSize;
+    set size(value: GlyphMatrixSize);
+    get glyphs(): string;
+    set glyphs(value: string);
+    get cellSize(): number;
+    set cellSize(value: number);
+    get mutationRate(): number;
+    set mutationRate(value: number);
+    get interval(): number;
+    set interval(value: number);
+    get fadeBottom(): number;
+    set fadeBottom(value: number);
+    get color(): string;
+    set color(value: string);
+    get interactive(): boolean;
+    set interactive(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _oldVal: string | null, _newVal: string | null): void;
+    private attachMouseEvents;
+    private detachMouseEvents;
+    private build;
+    private syncColor;
+    private sync;
+    private resize;
+    private draw;
+    private tick;
+    private start;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-glyph-matrix': DbGlyphMatrix;
+    }
+}
+
+interface DbPaperField {
+    label: string;
+    value: string;
+}
+interface DbPaperAction {
+    reference: string;
+}
+/** Own only the view; framework-owned children (including slot="actions") stay mounted. */
+declare abstract class DbPaperCard extends DbElement {
+    protected view: HTMLDivElement;
+    private ready;
+    connectedCallback(): void;
+    protected upgradeNames(): string[];
+    attributeChangedCallback(): void;
+    protected abstract render(): void;
+    protected attr(name: string): string;
+    protected action(reference: string): HTMLElement | null;
+    protected replace(...nodes: Node[]): void;
+    protected code(reference: string): HTMLElement;
+}
+
+/** Invitation, admission and coupon ticket. Values are text, never interpreted as HTML. */
+declare class DbTicket extends DbPaperCard {
+    static get observedAttributes(): string[];
+    private data;
+    protected upgradeNames(): string[];
+    get fields(): DbPaperField[];
+    set fields(value: DbPaperField[]);
+    protected render(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ticket': DbTicket;
+    }
+}
+
+interface DbBoardingPassLabels {
+    origin: string;
+    destination: string;
+    passenger: string;
+    service: string;
+    date: string;
+    boarding: string;
+    departure: string;
+    arrival: string;
+    terminal: string;
+    gate: string;
+    seat: string;
+    travelClass: string;
+}
+declare class DbBoardingPass extends DbPaperCard {
+    static get observedAttributes(): string[];
+    private customLabels;
+    protected upgradeNames(): string[];
+    get labels(): DbBoardingPassLabels;
+    set labels(value: Partial<DbBoardingPassLabels>);
+    protected render(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-boarding-pass': DbBoardingPass;
+    }
+}
+
+interface DbReceiptItem {
+    name: string;
+    quantity: number;
+    unitAmount: number;
+}
+interface DbReceiptLabels {
+    quantity: string;
+    subtotal: string;
+    discount: string;
+    tax: string;
+    total: string;
+    payment: string;
+    empty: string;
+    invalid: string;
+}
+/** Integer minor-unit amounts: KRW 3900 = ₩3,900; USD 3900 = $39.00. */
+declare class DbReceipt extends DbPaperCard {
+    static get observedAttributes(): string[];
+    private data;
+    private customLabels;
+    protected upgradeNames(): string[];
+    get items(): DbReceiptItem[];
+    set items(value: DbReceiptItem[]);
+    get labels(): DbReceiptLabels;
+    set labels(value: Partial<DbReceiptLabels>);
+    protected render(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-receipt': DbReceipt;
+    }
+}
+
+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];
+interface DbCreditCardFlip {
+    flipped: boolean;
+}
+/** Saved-card presentation, not a payment form. Front/back state reflects to `flipped`. */
+declare class DbCreditCard extends DbElement {
+    static get observedAttributes(): string[];
+    private button?;
+    private front;
+    private back;
+    private issuerFront;
+    private issuerBack;
+    private networkFront;
+    private networkBack;
+    private number;
+    private holderFront;
+    private holderBack;
+    private expiryFront;
+    private expiryBack;
+    private security;
+    private note;
+    get flipped(): boolean;
+    set flipped(value: boolean);
+    get orientation(): DbCreditCardOrientation;
+    set orientation(value: DbCreditCardOrientation);
+    get variant(): DbCreditCardVariant;
+    set variant(value: DbCreditCardVariant);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private releaseSurface;
+    private resetSurface;
+    private syncNetwork;
+    attributeChangedCallback(): void;
+    private build;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-credit-card': DbCreditCard;
+    }
+}
+
+interface DbAchievementItem {
+    id: string;
+    title: string;
+    description: string;
+    state: 'locked' | 'earned' | 'needs_review';
+    current?: number;
+    target?: number;
+    earnedLabel?: string;
+    motif?: 'star' | 'award' | 'bulb' | 'heart';
+}
+/** Presentation only. The owner supplies server-validated awards/progress; selection grants nothing. */
+declare class DbAchievementList extends DbElement {
+    private data;
+    static get observedAttributes(): string[];
+    get items(): DbAchievementItem[];
+    set items(value: DbAchievementItem[]);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-achievement-list': DbAchievementList;
+    }
+}
+
+/** Controlled presentation; no award or receipt writes. Effects stay inside this modal. */
+declare class DbAchievementModal extends DbElement {
+    private data;
+    private modal?;
+    private body?;
+    private confetti?;
+    private frame;
+    private viewKey;
+    private presentationKey;
+    private readonly descriptionId;
+    private readonly headingId;
+    static get observedAttributes(): string[];
+    get items(): DbAchievementItem[];
+    set items(value: DbAchievementItem[]);
+    get open(): boolean;
+    set open(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private dismiss;
+    private stopEffects;
+    private ensureView;
+    private stage;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-achievement-modal': DbAchievementModal;
+    }
+}
+
+declare const PAYMENT_BRANDS: readonly [{
+    readonly id: "visa";
+    readonly label: "Visa";
+    readonly src: string;
+    readonly cardSrc: string;
+}, {
+    readonly id: "mastercard";
+    readonly label: "Mastercard";
+    readonly src: string;
+    readonly cardSrc: string;
+}, {
+    readonly id: "american-express";
+    readonly label: "American Express";
+    readonly src: string;
+}, {
+    readonly id: "discover";
+    readonly label: "Discover";
+    readonly src: string;
+}, {
+    readonly id: "jcb";
+    readonly label: "JCB";
+    readonly src: string;
+}, {
+    readonly id: "unionpay";
+    readonly label: "UnionPay";
+    readonly src: string;
+}];
+declare function getPaymentBrand(network: string): {
+    readonly id: "visa";
+    readonly label: "Visa";
+    readonly src: string;
+    readonly cardSrc: string;
+} | {
+    readonly id: "mastercard";
+    readonly label: "Mastercard";
+    readonly src: string;
+    readonly cardSrc: string;
+} | {
+    readonly id: "american-express";
+    readonly label: "American Express";
+    readonly src: string;
+} | {
+    readonly id: "discover";
+    readonly label: "Discover";
+    readonly src: string;
+} | {
+    readonly id: "jcb";
+    readonly label: "JCB";
+    readonly src: string;
+} | {
+    readonly id: "unionpay";
+    readonly label: "UnionPay";
+    readonly src: string;
+} | undefined;
+
+declare const STATUSES: readonly ["scheduled", "boarding", "in-flight", "landed", "delayed", "cancelled"];
+type DbFlightStatusValue = typeof STATUSES[number];
+/** Display data supplied by the application; does not fetch or simulate live flights. */
+declare class DbFlightStatus extends DbElement {
+    static get observedAttributes(): string[];
+    private view;
+    private displayedProgress;
+    private animation;
+    private resizeObserver;
+    private motion;
+    private redraw;
+    private get targetProgress();
+    private stopAnimation;
+    private onMotionChange;
+    disconnectedCallback(): void;
+    get progress(): number;
+    set progress(value: number);
+    get status(): DbFlightStatusValue;
+    set status(value: DbFlightStatusValue);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-flight-status': DbFlightStatus;
+    }
+}
+
+interface DbTravelPass {
+    id: string;
+    issuer: string;
+    origin: string;
+    destination: string;
+    originName?: string;
+    destinationName?: string;
+    passenger?: string;
+    serviceNumber?: string;
+    date?: string;
+    boardingTime?: string;
+    departureTime?: string;
+    arrivalTime?: string;
+    terminal?: string;
+    gate?: string;
+    seat?: string;
+    travelClass?: string;
+    codeImageSrc?: string;
+}
+interface DbTravelPassChange {
+    index: number;
+    pass: DbTravelPass;
+}
+/** Selectable journey wallet composed with the real db-boarding-pass element. */
+declare class DbBoardingPassStack extends DbElement {
+    static get observedAttributes(): string[];
+    private data?;
+    private instanceId;
+    private view;
+    get passes(): DbTravelPass[];
+    set passes(value: DbTravelPass[]);
+    get selectedIndex(): number;
+    set selectedIndex(value: number);
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private select;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-boarding-pass-stack': DbBoardingPassStack;
+    }
+}
+
+/** Native display pixels (width × height). Geometry references are documented in db-device-mockup.md. */
+declare const DEVICE_MOCKUP_SCREENS: {
+    readonly default: readonly [1600, 1000];
+    readonly tablet: readonly [3, 4];
+    readonly ios: readonly [1206, 2622];
+    readonly android: readonly [1080, 2340];
+    readonly watch: readonly [416, 496];
+    readonly flip: readonly [1080, 2520];
+    readonly 'flip-cover': readonly [948, 1048];
+    readonly fold: readonly [1968, 2184];
+    readonly 'fold-cover': readonly [1080, 2520];
+    readonly duo: readonly [14, 10];
+    readonly 'duo-cover': readonly [7, 10];
+};
+type DeviceModel = 'default' | 'ios' | 'android' | 'watch' | 'flip' | 'fold' | 'duo';
+/** Physical frames preserve live child content through a slot; src displays a screenshot. */
+declare abstract class DbDeviceMockup extends DbElement {
+    protected abstract readonly device: 'browser' | 'tablet' | 'mobile' | 'watch';
+    protected readonly model: DeviceModel;
+    static get observedAttributes(): string[];
+    private readonly root;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private node;
+    private decorative;
+    private tools;
+    private watchBand;
+    private browserChrome;
+    private render;
+}
+declare class DbBrowserMockup extends DbDeviceMockup {
+    protected readonly device: "browser";
+}
+declare class DbTabletMockup extends DbDeviceMockup {
+    protected readonly device: "tablet";
+}
+/** Compatibility alias for the iOS frame. */
+declare class DbMobileMockup extends DbDeviceMockup {
+    protected readonly device: "mobile";
+    protected readonly model: DeviceModel;
+}
+declare class DbIosMockup extends DbMobileMockup {
+}
+declare class DbAndroidMockup extends DbMobileMockup {
+    protected readonly model: DeviceModel;
+}
+declare class DbAppleWatchMockup extends DbDeviceMockup {
+    protected readonly device: "watch";
+    protected readonly model: DeviceModel;
+}
+declare class DbFlipMockup extends DbMobileMockup {
+    protected readonly model: DeviceModel;
+}
+declare class DbFoldMockup extends DbMobileMockup {
+    protected readonly model: DeviceModel;
+}
+declare class DbDuoMockup extends DbMobileMockup {
+    protected readonly model: DeviceModel;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-browser-mockup': DbBrowserMockup;
+        'db-tablet-mockup': DbTabletMockup;
+        'db-mobile-mockup': DbMobileMockup;
+    }
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-ios-mockup': DbIosMockup;
+    }
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-android-mockup': DbAndroidMockup;
+    }
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-apple-watch-mockup': DbAppleWatchMockup;
+    }
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-flip-mockup': DbFlipMockup;
+    }
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-fold-mockup': DbFoldMockup;
+    }
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-duo-mockup': DbDuoMockup;
+    }
+}
+
+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;
+    label: string;
+    type?: DbNodePortType;
+    connected?: boolean;
+    disabled?: boolean;
+};
+type DbNodePortSelect = {
+    nodeId: string;
+    portId: string;
+    direction: 'input' | 'output';
+    type: DbNodePortType;
+};
+type DbNodePortDrag = DbNodePortSelect & {
+    clientX: number;
+    clientY: number;
+    phase: 'start' | 'move' | 'end' | 'cancel';
+};
+type DbNodeMove = {
+    nodeId: string;
+    deltaX: number;
+    deltaY: number;
+    phase: 'start' | 'move' | 'end' | 'cancel' | 'keyboard';
+};
+/** A composable workflow node. The consumer owns graph coordinates and connections. */
+declare class DbNode extends DbElement {
+    static get observedAttributes(): string[];
+    private readonly root;
+    private inputPorts;
+    private outputPorts;
+    private portsDirty;
+    private drag;
+    private portDrag;
+    private suppressPortClick;
+    private deleteButton;
+    private headingButton;
+    private titleEl;
+    private iconBox;
+    private descriptionEl;
+    private statusEl;
+    private statusBadge;
+    private collapseButton;
+    private runButton;
+    private body;
+    private footer;
+    private inputList;
+    private outputList;
+    get inputs(): DbNodePort[];
+    set inputs(value: DbNodePort[]);
+    get outputs(): DbNodePort[];
+    set outputs(value: DbNodePort[]);
+    /** Anchor element for a graph renderer; use its bounding rect to position edges. */
+    getPortElement(id: string, direction: 'input' | 'output'): HTMLButtonElement | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private normalizePorts;
+    private readPorts;
+    private nodeId;
+    private el;
+    private action;
+    private build;
+    private emitMove;
+    private finishDrag;
+    private renderPorts;
+    private emitPortDrag;
+    private cancelPortDrag;
+    private sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-node': DbNode;
+    }
+}
+
+interface DesignCanvasNode {
+    id: string;
+    type: 'frame' | 'image' | 'text' | 'shape' | 'component';
+    name: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+    src?: string;
+    slot?: string;
+    fill?: string;
+    opacity?: number;
+    radius?: number;
+    locked?: boolean;
+    text?: string;
+    fontSize?: number;
+    fontWeight?: number;
+    textColor?: string;
+    textAlign?: 'left' | 'center' | 'right';
+    shape?: 'rectangle' | 'ellipse' | 'triangle' | 'line';
+    component?: 'button' | 'input' | 'card' | 'badge';
+    stroke?: string;
+    strokeWidth?: number;
+}
+interface DesignCanvasViewport {
+    x: number;
+    y: number;
+    zoom: number;
+}
+interface DesignCanvasChange {
+    nodes: DesignCanvasNode[];
+    selectedId: string | null;
+    reason: string;
+}
+type Point = {
+    x: number;
+    y: number;
+};
+/** DOM canvas with serializable nodes. Slot a React/Vue-owned frame using node.slot. */
+declare class DbDesignCanvas extends HTMLElement {
+    static get observedAttributes(): string[];
+    private data;
+    private selected;
+    private view;
+    private surface?;
+    private world?;
+    private toolbar?;
+    private contextBar?;
+    private status?;
+    private selection?;
+    private input?;
+    private objectElements;
+    private slots;
+    private observer?;
+    private resizeObserver?;
+    private gesture?;
+    private pointers;
+    private pinch?;
+    private space;
+    private hand;
+    private creationTool;
+    private shapeTool;
+    private componentTool;
+    private editing?;
+    private past;
+    private future;
+    private reading;
+    private generation;
+    get nodes(): DesignCanvasNode[];
+    set nodes(value: DesignCanvasNode[] | string);
+    get selectedId(): string | null;
+    set selectedId(value: string | null);
+    get viewport(): DesignCanvasViewport;
+    set viewport(value: DesignCanvasViewport);
+    get minZoom(): number;
+    get maxZoom(): number;
+    get readOnly(): boolean;
+    set readOnly(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private normalizeNode;
+    private ensureStructure;
+    private collectSlots;
+    private draw;
+    private drawText;
+    private drawShape;
+    private drawComponent;
+    private beginTextEdit;
+    private drawViewport;
+    private drawSelection;
+    private syncToolbar;
+    private syncContext;
+    private insertNode;
+    private positionContext;
+    private toolAction;
+    private select;
+    private emit;
+    private emitViewport;
+    private remember;
+    undo(): void;
+    redo(): void;
+    private point;
+    zoomTo(zoom: number, anchor?: Point): void;
+    fitToContent(): void;
+    private editable;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
+    private cancelGesture;
+    private onPointerCancel;
+    private onLostCapture;
+    private onWheel;
+    private onKeyUp;
+    private onBlur;
+    private onKeyDown;
+    private onDragOver;
+    private onDragLeave;
+    private onDrop;
+    importImages(files: File[], point?: Point): Promise<void>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-design-canvas': DbDesignCanvas;
+    }
+}
+
+interface DesignToolOption {
+    id: string;
+    label: string;
+    icon?: string;
+    shortcut?: string;
+    disabled?: boolean;
+}
+interface DesignToolAction {
+    id: string;
+    optionId?: string;
+    option?: DesignToolOption;
+}
+/** Icon action with a portalled tooltip and optional click/long-press menu. */
+declare class DbToolButton extends HTMLElement {
+    static get observedAttributes(): string[];
+    private static openMenus;
+    private button?;
+    private tooltip?;
+    private menuPopover?;
+    private menu?;
+    private timer?;
+    private held;
+    private pointer?;
+    private menuSignature;
+    private focusFrame?;
+    get options(): DesignToolOption[];
+    set options(value: DesignToolOption[] | string);
+    get value(): string;
+    set value(v: string);
+    get disabled(): boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private ensure;
+    private sync;
+    private activate;
+    openMenu(): void;
+    private outsidePress;
+    private releaseMenuOwner;
+    closeMenu(restoreFocus?: boolean): void;
+    private menuKey;
+    private pressStart;
+    private pressEnd;
+    private clearPress;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-tool-button': DbToolButton;
+    }
+}
+
+interface DesignToolbarItem {
+    id: string;
+    type?: 'button' | 'separator';
+    label?: string;
+    icon?: string;
+    text?: string;
+    shortcut?: string;
+    active?: boolean;
+    disabled?: boolean;
+    options?: DesignToolOption[];
+    value?: string;
+    menuTrigger?: 'click' | 'long-press';
+}
+/** Icon toolbar. Arrow keys navigate actions; dropdowns and tooltips are portalled. */
+declare class DbDesignToolbar extends HTMLElement {
+    static get observedAttributes(): string[];
+    private tools;
+    private focusId;
+    private connected;
+    private grip?;
+    private boundaryObserver?;
+    private dragState?;
+    private location;
+    get toolbarPosition(): {
+        x: number;
+        y: number;
+    } | string;
+    set toolbarPosition(value: {
+        x: number;
+        y: number;
+    } | string);
+    get items(): DesignToolbarItem[];
+    set items(value: DesignToolbarItem[] | string);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private sync;
+    private buttons;
+    private rove;
+    private focusIn;
+    private keyDown;
+    private constrainPosition;
+    resetPosition(): void;
+    private dragStart;
+    private dragMove;
+    private dragEnd;
+    private dragCancel;
+    private gripKey;
+    closeMenus(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-design-toolbar': DbDesignToolbar;
+    }
+}
+
+/** Compact contextual actions. The consumer owns selection, visibility and positioning. */
+declare class DbContextBar extends DbDesignToolbar {
+    connectedCallback(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-context-bar': DbContextBar;
+    }
+}
+
+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 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 };