@designbasekorea/ui-wc 0.2.2 → 0.4.0

package/dist/index.d.ts

@@ -479,6 +479,8 @@ declare class DbTooltip extends HTMLElement {
     private showTimer?;
     private hideTimer?;
     private repositionRaf?;
+    private enterRaf?;
+    private removalTimer?;
     get content(): string;
     set content(value: string);
     get position(): string;
@@ -510,6 +512,7 @@ declare class DbTooltip extends HTMLElement {
     private syncTooltipClasses;
     private calculatePosition;
     private setVisible;
+    private hideTooltip;
     private removeTooltip;
     private handleShow;
     private handleHide;
@@ -525,6 +528,8 @@ declare global {
 interface AccordionItemConfig {
     id?: string;
     title: string;
+    /** 슬롯(content-N)이 없을 때 본문으로 렌더되는 텍스트 */
+    content?: string;
     disabled?: boolean;
     itemType?: 'icon' | 'number' | 'question' | 'none';
     icon?: string;
@@ -592,11 +597,21 @@ declare global {
 
 declare class DbProgress extends HTMLElement {
     static get observedAttributes(): string[];
+    private structureSignature;
+    private barEl?;
+    private linearValueEl?;
+    private circularBarEl?;
+    private circularValueEl?;
+    private circumference;
     get value(): number;
     set value(value: number);
     connectedCallback(): void;
     attributeChangedCallback(): void;
     private render;
+    private buildLinear;
+    private updateLinear;
+    private buildCircular;
+    private updateCircular;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -756,6 +771,14 @@ declare global {
     }
 }
 
+interface BreadcrumbMenuItem {
+    id?: string;
+    label: string;
+    href?: string;
+    active?: boolean;
+    disabled?: boolean;
+    icon?: string;
+}
 interface BreadcrumbItem {
     id?: string;
     label: string;
@@ -763,14 +786,35 @@ interface BreadcrumbItem {
     active?: boolean;
     disabled?: boolean;
     icon?: string;
+    menu?: BreadcrumbMenuItem[];
 }
 declare class DbBreadcrumbs extends HTMLElement {
     static get observedAttributes(): string[];
+    private openMenuId;
+    private onDocumentMouseDown;
+    private onDocumentKeyDown;
     get items(): BreadcrumbItem[] | string;
     set items(value: BreadcrumbItem[] | string);
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(): void;
+    private get menuDropdown();
+    private get maxLabelLength();
+    private get resolvedVariant();
+    private itemId;
+    private menuItemId;
     private visibleItems;
+    private shouldUseDropdown;
+    private closeMenu;
+    private openMenu;
+    private toggleMenu;
+    private addGlobalListeners;
+    private removeGlobalListeners;
+    private updateDropdownStates;
+    private createLabel;
+    private createMenuItem;
+    private createDropdownItem;
+    private createStandardItem;
     private render;
 }
 declare global {
@@ -1079,6 +1123,10 @@ declare class DbIndicator extends HTMLElement {
     set size(value: string);
     get direction(): string;
     set direction(value: string);
+    get numberBackground(): boolean;
+    set numberBackground(value: boolean);
+    get playback(): boolean;
+    set playback(value: boolean);
     get clickable(): boolean;
     set clickable(value: boolean);
     get timer(): boolean;
@@ -1097,6 +1145,14 @@ declare class DbIndicator extends HTMLElement {
     private renderStep;
     private renderDots;
     private renderPlaybackButton;
+    private renderNumbers;
+    private renderSlide;
+    private renderScaleFill;
+    private renderLine;
+    private renderDotLine;
+    private fillRatio;
+    private renderFill;
+    private renderContent;
     private render;
 }
 declare global {
@@ -1417,6 +1473,7 @@ declare class DbLightbox extends HTMLElement {
     private imageError;
     private keydownHandler;
     private boundSrc;
+    private thumbnailSignature;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -1478,9 +1535,34 @@ interface DbNavbarItem {
     label: string;
     href?: string;
     icon?: string;
+    /** 메가 메뉴 링크에서 라벨 아래 표시되는 보조 설명 */
+    description?: string;
     active?: boolean;
     disabled?: boolean;
     children?: DbNavbarItem[];
+    /** children 대신 메가 메뉴(다단 패널) 스타일로 렌더링 */
+    megaMenu?: boolean;
+    /** 메가 메뉴 컬럼 목록 */
+    columns?: DbNavbarMegaColumn[];
+    /** 메가 메뉴 우측 강조(피처드) 영역 */
+    featured?: DbNavbarMegaFeatured;
+}
+interface DbNavbarMegaColumn {
+    id: string;
+    /** 컬럼 상단 제목 */
+    title?: string;
+    /** 컬럼 내 링크 목록 */
+    items: DbNavbarItem[];
+}
+interface DbNavbarMegaFeatured {
+    title?: string;
+    description?: string;
+    /** 배경 이미지 URL */
+    image?: string;
+    href?: string;
+    /** CTA 텍스트 (예: 자세히 보기) */
+    ctaLabel?: string;
+    icon?: string;
 }
 interface DbNavbarUserProfile {
     name: string;
@@ -1513,10 +1595,16 @@ declare class DbNavbar extends HTMLElement {
     private unbindOutsideClick;
     private dispatchItemClick;
     private syncHostClasses;
+    private isMegaMenu;
+    private createNavToggleButton;
+    private createMegaLink;
+    private createMegaMenu;
+    private createMegaFeatured;
     private createDesktopNavItem;
     private createUserMenuItemElement;
     private bindSearchEvents;
     private applyAvatarProfile;
+    private getMobileChildren;
     private createMobileMenuItem;
     private updateUserMenuVisibility;
     private renderMobileMenu;
@@ -1528,6 +1616,78 @@ declare global {
     }
 }
 
+type DbFooterSocialPlatform = 'youtube' | 'instagram' | 'x' | 'linkedin' | 'facebook' | 'email';
+interface DbFooterLink {
+    id: string;
+    label: string;
+    href?: string;
+    external?: boolean;
+    /** 개인정보처리방침 등 강조 링크 */
+    emphasize?: boolean;
+}
+interface DbFooterLinkColumn {
+    id: string;
+    title: string;
+    items: DbFooterLink[];
+}
+interface DbFooterSocialLink {
+    id: string;
+    platform: DbFooterSocialPlatform;
+    href: string;
+    label?: string;
+}
+interface DbFooterCompanyInfo {
+    companyName?: string;
+    representative?: string;
+    businessNumber?: string;
+    mailOrderNumber?: string;
+    address?: string;
+    phone?: string;
+    customerCenter?: string;
+    email?: string;
+    hostingProvider?: string;
+}
+interface DbFooterFamilySite {
+    id: string;
+    label: string;
+    href: string;
+}
+declare class DbFooter extends HTMLElement {
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    get columns(): DbFooterLinkColumn[];
+    set columns(value: DbFooterLinkColumn[] | string);
+    get legalLinks(): DbFooterLink[];
+    set legalLinks(value: DbFooterLink[] | string);
+    get socialLinks(): DbFooterSocialLink[];
+    set socialLinks(value: DbFooterSocialLink[] | string);
+    get companyInfo(): DbFooterCompanyInfo;
+    set companyInfo(value: DbFooterCompanyInfo | string);
+    get familySites(): DbFooterFamilySite[];
+    set familySites(value: DbFooterFamilySite[] | string);
+    private syncHostClasses;
+    private dispatchLinkClick;
+    private createLink;
+    private createSocialLink;
+    private createCompanyInfoRows;
+    private showLogo;
+    private createLogo;
+    private renderBrand;
+    private renderColumns;
+    private createLegalNav;
+    private renderLegalBar;
+    private renderCompanyInfo;
+    private createCopyright;
+    private renderMinimal;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-footer': DbFooter;
+    }
+}
+
 interface DbSidebarItem {
     id: string;
     label: string;
@@ -1674,6 +1834,8 @@ declare global {
 declare class DbRangeSlider extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
+    private headerEl;
+    private labelEl;
     private valuesEl;
     private containerEl;
     private trackEl;
@@ -1697,6 +1859,10 @@ declare class DbRangeSlider extends HTMLElement {
     get range(): [number, number] | undefined;
     set range(v: [number, number] | string | undefined);
     private build;
+    private getValuePosition;
+    private shouldShowLabel;
+    private formatValue;
+    private syncDomOrder;
     private bindEvents;
     private unbindEvents;
     private readAttributeValues;
@@ -1704,6 +1870,7 @@ declare class DbRangeSlider extends HTMLElement {
     private syncStructure;
     private isMarkActive;
     private syncVisuals;
+    private syncThumbTooltips;
     private syncA11y;
     private setThumbPosition;
     private valueToPercent;
@@ -2713,6 +2880,168 @@ declare global {
     }
 }
 
+type DbKanbanPriority = 'low' | 'medium' | 'high' | 'urgent';
+type DbKanbanTag = {
+    label: string;
+    variant?: 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
+};
+type DbKanbanAssignee = {
+    name: string;
+    initials?: string;
+    avatar?: string;
+};
+type DbKanbanCard = {
+    id: string;
+    title: string;
+    description?: string;
+    tags?: DbKanbanTag[];
+    assignee?: DbKanbanAssignee;
+    priority?: DbKanbanPriority;
+    dueDate?: string;
+    disabled?: boolean;
+};
+type DbKanbanColumn = {
+    id: string;
+    title: string;
+    cards: DbKanbanCard[];
+    limit?: number;
+    color?: string;
+};
+declare class DbKanban extends HTMLElement {
+    private dragState;
+    private dropTarget;
+    static get observedAttributes(): string[];
+    get columns(): DbKanbanColumn[];
+    set columns(value: DbKanbanColumn[] | string);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private getBool;
+    private getOption;
+    private emitChange;
+    private emitCardMove;
+    private findCardLocation;
+    private getAdjustedDropIndex;
+    private isValidDropTarget;
+    private moveCard;
+    private setDropTarget;
+    private resetDragState;
+    private updateDragClasses;
+    private getDropIndexFromPointer;
+    private getDropIndexFromColumnPointer;
+    private commitDrop;
+    private handleBoardDragOver;
+    private handleBoardDrop;
+    private formatDueDate;
+    private getInitials;
+    private createTag;
+    private createPriorityBadge;
+    private createAssignee;
+    private bindCardDrag;
+    private createCard;
+    private createColumn;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-kanban': DbKanban;
+    }
+}
+
+type DbGanttAssignee = {
+    name: string;
+    initials?: string;
+    avatar?: string;
+};
+type DbGanttItemStatus = 'on-track' | 'at-risk' | 'delayed' | 'completed';
+type DbGanttItem = {
+    id: string;
+    rowId: string;
+    title: string;
+    startDate: string;
+    endDate: string;
+    color?: string;
+    assignee?: DbGanttAssignee;
+    progress?: number;
+    status?: DbGanttItemStatus;
+    disabled?: boolean;
+};
+type DbGanttRow = {
+    id: string;
+    label: string;
+    groupId?: string;
+};
+type DbGanttGroup = {
+    id: string;
+    title: string;
+    color?: string;
+};
+declare class DbGantt extends HTMLElement {
+    private collapsedGroups;
+    private dragState;
+    private reorderState;
+    private reorderDropIndex;
+    private suppressRender;
+    private didDrag;
+    static get observedAttributes(): string[];
+    get groups(): DbGanttGroup[];
+    set groups(value: DbGanttGroup[] | string);
+    get rows(): DbGanttRow[];
+    set rows(value: DbGanttRow[] | string);
+    get items(): DbGanttItem[];
+    set items(value: DbGanttItem[] | string);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseJson;
+    private getBool;
+    private getNumber;
+    private getOption;
+    private getLocale;
+    private getWeekdays;
+    private getViewRange;
+    private getTodayDate;
+    private getDateColumns;
+    private getVisibleRows;
+    private getMonthSegments;
+    private getInitials;
+    private updateItem;
+    private emitItemsChange;
+    private applyBarGeometry;
+    private handlePointerMove;
+    private handlePointerUp;
+    private startBarDrag;
+    private canReorder;
+    private createDragHandle;
+    private getGroupIndex;
+    private getRowScope;
+    private getRowIndexInScope;
+    private getReorderTargets;
+    private startReorderDrag;
+    private updateReorderDropTarget;
+    private clearReorderIndicators;
+    private finishReorderDrag;
+    private emitStructureChange;
+    private reorderGroups;
+    private reorderRows;
+    private createGroupBadge;
+    private createGroupChevron;
+    private createAssignee;
+    private createStatusIcon;
+    private deriveSummaryColor;
+    private getGroupSummary;
+    private applyBarTone;
+    private createGroupSummaryBar;
+    private createBar;
+    private toggleGroup;
+    private render;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-gantt': DbGantt;
+    }
+}
+
 declare class DbResizablePanels extends HTMLElement {
     private container?;
     private contentEl?;
@@ -3069,8 +3398,8 @@ interface FeatureAction {
 declare class DbSectionFeature extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
-    private sectionEl?;
-    private featureWrapEl?;
+    private innerEl?;
+    private contentEl?;
     private badgeEl?;
     private headlineEl?;
     private subtitleEl?;
@@ -3115,9 +3444,7 @@ declare global {
 declare class DbSectionContact extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
-    private sectionEl?;
-    private wrapEl?;
-    private contactWrapEl?;
+    private innerEl?;
     private titleEl?;
     private descriptionEl?;
     private actionEl?;
@@ -3144,8 +3471,6 @@ interface DownloadStore {
 declare class DbSectionAppDownload extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
-    private sectionEl?;
-    private wrapEl?;
     private innerEl?;
     private titleEl?;
     private descriptionEl?;
@@ -3164,31 +3489,204 @@ declare global {
     }
 }
 
+declare class DbSectionCta extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private wrapEl?;
+    private headerEl?;
+    private badgeEl?;
+    private headlineEl?;
+    private subtitleEl?;
+    private descriptionEl?;
+    private actionsEl?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseBadge;
+    private parseButtons;
+    private build;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-cta': DbSectionCta;
+    }
+}
+
+declare class DbSectionTestimonials extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private carouselIndex;
+    private innerEl?;
+    private headerEl?;
+    private contentEl?;
+    private carouselViewport?;
+    private carouselTrack?;
+    private carouselIndicator?;
+    private resizeObserver?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseItems;
+    private parseBadge;
+    private buildHeader;
+    private build;
+    private createTestimonialEl;
+    private updateHeader;
+    private clampCarouselIndex;
+    private updateCarouselTransform;
+    private goToCarouselSlide;
+    private renderGrid;
+    private renderCarousel;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-testimonials': DbSectionTestimonials;
+    }
+}
+
+declare class DbSectionFeatureGrid extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private innerEl?;
+    private headerEl?;
+    private gridEl?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseItems;
+    private parseBadge;
+    private build;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-feature-grid': DbSectionFeatureGrid;
+    }
+}
+
+declare class DbSectionLogoCloud extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private innerEl?;
+    private headerEl?;
+    private contentEl?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseLogos;
+    private parseBadge;
+    private build;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-logo-cloud': DbSectionLogoCloud;
+    }
+}
+
+declare class DbSectionStats extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private innerEl?;
+    private headerEl?;
+    private gridEl?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseItems;
+    private parseBadge;
+    private build;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-stats': DbSectionStats;
+    }
+}
+
+declare class DbSectionFaq extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private innerEl?;
+    private headerEl?;
+    private accordionEl?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parseItems;
+    private parseBadge;
+    private build;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-faq': DbSectionFaq;
+    }
+}
+
+declare class DbSectionPricing extends HTMLElement {
+    static get observedAttributes(): string[];
+    private built;
+    private innerEl?;
+    private headerEl?;
+    private gridEl?;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private parsePlans;
+    private parseBadge;
+    private build;
+    private updateUI;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-section-pricing': DbSectionPricing;
+    }
+}
+
 declare class DbMarquee extends HTMLElement {
     static get observedAttributes(): string[];
     private built;
     private containerEl?;
-    private trackEl?;
-    private baseGroupEl?;
+    private rowsEl?;
     private srOnlyEl?;
+    private rows;
+    private rowCount;
     private resizeObserver?;
     private containerWidth;
-    private baseGroupWidth;
+    private gap;
+    private scrollVelocityEnabled;
+    private rafId;
+    private lastFrameTime;
+    private lastScrollY;
+    private smoothedScrollV;
+    private baseDurationSec;
+    private reduceMotion;
     private boundMeasure;
+    private boundFrame;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
     private getBool;
     private parseItems;
+    private itemToText;
     private build;
     private bindResize;
+    /** rows 개수에 맞춰 행 DOM을 만들거나 제거한다. */
+    private reconcileRows;
     private measure;
     private unbindImageListeners;
     private bindImageListeners;
     private renderItem;
     private renderGroup;
-    private renderDuplicates;
+    /**
+     * 각 행의 base 그룹을 items로 다시 만든다 — items/attributes 변경 시에만 실행.
+     * 이미지 노드 재생성으로 인한 재로딩을 막기 위해 measure() 중에는 건드리지 않는다.
+     */
+    private buildBase;
+    private baseImagesReady;
+    /** 트랙을 채울 만큼의 복제 그룹 개수를 델타만 조정한다. */
+    private reconcileDuplicates;
     private syncReadyState;
+    private startScrollEngine;
+    private stopScrollEngine;
+    private frame;
     private updateUI;
 }
 declare global {
@@ -3253,8 +3751,16 @@ declare class DbAdBanner extends HTMLElement {
     private autoCloseTimer?;
     private rootEl?;
     private gradientEl?;
+    private animBgEl?;
+    private animBgInner?;
+    private gridBgEl?;
+    private gridBgInner?;
     private contentEl?;
+    private mainEl?;
+    private textEl?;
     private closeBtn?;
+    private imageEl?;
+    private linkEl?;
     private iconEl?;
     private labelEl?;
     private badgeEl?;
@@ -3272,11 +3778,28 @@ declare class DbAdBanner extends HTMLElement {
     private getBool;
     private getType;
     private getVariant;
+    private getSize;
+    private ctaButtonSize;
     private build;
     private handleClose;
     private stopAutoClose;
     private startAutoClose;
-    private renderGradientWrapper;
+    private getBackground;
+    private ensureAnimBg;
+    private ensureGridBg;
+    /** 이전 배경 모드의 백드롭 엘리먼트를 정리한다. */
+    private clearBackdrop;
+    private renderBackground;
+    /** 장식 아이콘은 card 타입에서만 사용한다. */
+    private syncIcon;
+    /** floating 타입에서만 텍스트 상단에 배지 칩을 노출한다. */
+    private syncBadge;
+    /** floating 타입에서 배너 이미지를 콘텐츠 상단(패딩 밖)에 렌더한다. */
+    private syncImage;
+    /** topbar 타입에서 href 가 있으면 전체를 덮는 링크 오버레이를 렌더한다. */
+    private syncLink;
+    /** show-countdown + end-date 가 있을 때만 카운트다운을 마운트한다. */
+    private syncCountdown;
     private updateUI;
 }
 declare global {
@@ -3320,11 +3843,18 @@ declare class DbAnimationText extends HTMLElement {
     private displayText;
     private isVisible;
     private isAnimating;
+    private wordEls;
+    private scrollHandler?;
+    private rafId?;
+    private rotateToken;
+    private rotateObserver?;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
     private getText;
+    private getRotateTexts;
+    private getLongestText;
     private getType;
     private getTrigger;
     private ensureStructure;
@@ -3332,6 +3862,10 @@ declare class DbAnimationText extends HTMLElement {
     private syncFromAttributes;
     private syncClasses;
     private setupTrigger;
+    private setupTextRotate;
+    private setupScrollFill;
+    private teardownScrollFill;
+    private updateScrollFill;
     private startAnimation;
     private startTyping;
     private startDecoding;
@@ -3399,15 +3933,36 @@ declare global {
 declare class DbAnimationBackground extends HTMLElement {
     private layersEl?;
     private contentEl?;
+    private controlsRootEl?;
+    private panelEl?;
+    private panelOpen;
     private layerHandle?;
     private clickHandler?;
+    private mountedType?;
+    private controlInputs;
+    private syncingControls;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(): void;
-    private teardownLayers;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private getBool;
     private getSizeStyle;
+    private getConfig;
+    private teardownLayers;
+    private remountLayers;
+    private canLiveUpdate;
+    private applyConfig;
+    private syncClickable;
     private render;
+    private ensureControlsShell;
+    private syncControlsVisibility;
+    private syncPanelState;
+    private createIconButton;
+    private rebuildControlInputs;
+    private createControlField;
+    private commitControlValue;
+    private syncControlInputs;
+    private renderColorInputs;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -3415,8 +3970,99 @@ declare global {
     }
 }
 
+/**
+ * db-grid-background — 캔버스 기반 그리드 배경.
+ *
+ * 패턴은 항상 중앙을 기준으로 대칭 배치되며(가장자리 라인 없음),
+ * 단독 배경으로도, 다른 배경 위 데코 레이어(overlay)로도 쓸 수 있다.
+ * interactive/animate 로 마우스 인터랙션과 앰비언트 애니메이션을 켤 수 있다.
+ *
+ * @example
+ *   <db-grid-background type="lines" size="32" fade="all"
+ *     interactive animate height="240"></db-grid-background>
+ */
+declare class DbGridBackground extends HTMLElement {
+    private canvas?;
+    private ctx?;
+    private hlCanvas?;
+    private maskCanvas?;
+    private ro?;
+    private rafId?;
+    private lastTime;
+    private lastPointerMove;
+    private bandAngle;
+    private pointer;
+    private cssW;
+    private cssH;
+    private colorProbe?;
+    private themeObserver?;
+    private themeMedia?;
+    private tracePulses;
+    private traceSpawnAccumulator;
+    private onThemeMediaChange;
+    private onPointerMove;
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    private getBool;
+    private getNumber;
+    private getSizeStyle;
+    private getColorProbe;
+    private resolveCssColor;
+    private isDarkContext;
+    private resolveThemeColor;
+    private effectiveOpacity;
+    private effectiveColor;
+    private effectiveInterColor;
+    private traceDrawColor;
+    private traceDrawOpacity;
+    private parseColorRgb;
+    private crossArm;
+    private interactionMode;
+    private animationStyle;
+    private traceDirection;
+    private linesLayout;
+    private crossStyle;
+    private parseGuideEdges;
+    private guideFraction;
+    private isGridLines;
+    private isTraceableLines;
+    private get cfg();
+    private ensureCanvas;
+    private applyHostStyles;
+    private startObserving;
+    private observeDocumentTheme;
+    private bindPointer;
+    private handlePointerMove;
+    private measure;
+    /** 중앙을 기준으로 대칭 배치되며 (0, extent) 내부 좌표만 반환 → 가장자리 라인 없음 */
+    private axis;
+    private scheduleDraw;
+    private ensureLoop;
+    private drawFrame;
+    private easeInOutCubic;
+    private traceSegmentLength;
+    private pulseHead;
+    private updateTracePulses;
+    private traceLinePositions;
+    private spawnTracePulse;
+    private drawTracePulseSegment;
+    private drawTraceHighlight;
+    private drawPattern;
+    private drawGridLines;
+    private drawFrameGuides;
+    private drawCenterGuides;
+    private buildEnergyMask;
+    private applyFade;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'db-grid-background': DbGridBackground;
+    }
+}
+
 declare class DbCursorFollower extends HTMLElement {
-    private scopeEl?;
     private portalRoot?;
     private pillEl?;
     private labelEl?;
@@ -3434,7 +4080,7 @@ declare class DbCursorFollower extends HTMLElement {
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
     private setupDesktopGate;
-    private ensureScope;
+    private updateScope;
     private isInScope;
     private mountLayer;
     private teardownLayer;
@@ -3545,5 +4191,5 @@ interface DbConfirmOptions {
 /** 확인 대화상자를 띄우고, 확인 시 true / 취소(ESC·배경 포함) 시 false 로 resolve 합니다. */
 declare function confirm(options: DbConfirmOptions): Promise<boolean>;
 
-export { DbAccordion, DbAdBanner, DbAlert, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbButton, DbCalendar, DbCard, DbCarousel, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbConfirm, DbContainer, DbContextMenu, DbCountdown, DbCursorFollower, DbDatePicker, DbDivider, DbDrawer, DbDropdown, DbDropzone, DbEmptyState, DbFileUploader, DbFloatingActionButton, DbForm, DbGradient, DbGrid, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbLabel, DbLightbox, DbList, DbLogo, DbLottie, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbModal, DbNavbar, DbOnboardingModal, DbPageHeader, DbPagination, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReorder, DbResizablePanels, DbScrollArea, DbSearchBar, DbSection, DbSectionAppDownload, DbSectionContact, DbSectionFeature, DbSectionHero, DbSegmentControl, DbSelect, DbShare, DbSidebar, DbSkeleton, DbSpinner, DbSplitView, DbStack, DbStat, DbStepper, DbTable, DbTabs, DbTestimonial, DbTextarea, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbVideoPlayer, DbYouTubePlayer, confirm, confirm as dbConfirm, toast as dbToast, showToast, toast };
-export type { CalendarEventData, CalendarEventType, DbAlertAction, DbBannerAction, DbBottomNavigationItem, DbConfirmOptions, DbConfirmVariant, DbFormFieldData, DbImageListItem, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbPageHeaderTabItem, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarSection, DbSidebarUserProfile, DbStatChange, DbTimelineItem, DbToastApi, DbToastHandle, DbToastOptions, DbToastPosition, DbToastStatus };
+export { DbAccordion, DbAdBanner, DbAlert, DbAnimationBackground, DbAnimationText, DbAppBadge, DbAudioPlayer, DbAvatar, DbBackdrop, DbBadge, DbBanner, DbBottomNavigation, DbBottomSheet, DbBreadcrumbs, DbButton, DbCalendar, DbCard, DbCarousel, DbCheckbox, DbChip, DbCodeBlock, DbColorPicker, DbConfirm, DbContainer, DbContextMenu, DbCountdown, DbCursorFollower, DbDatePicker, DbDivider, DbDrawer, DbDropdown, DbDropzone, DbEmptyState, DbFileUploader, DbFloatingActionButton, DbFooter, DbForm, DbGantt, DbGradient, DbGrid, DbGridBackground, DbGridItem, DbImage, DbImageList, DbImagePlaceholder, DbIndicator, DbInput, DbKanban, DbLabel, DbLightbox, DbList, DbLogo, DbLottie, DbMarkdownEditor, DbMarquee, DbMasonry, DbMenuItem, DbModal, DbNavbar, DbOnboardingModal, DbPageHeader, DbPagination, DbPopover, DbProgress, DbProgressStep, DbProgressbar, DbRadio, DbRandomGradient, DbRangeSlider, DbRating, DbReorder, DbResizablePanels, DbScrollArea, DbSearchBar, DbSection, DbSectionAppDownload, DbSectionContact, DbSectionCta, DbSectionFaq, DbSectionFeature, DbSectionFeatureGrid, DbSectionHero, DbSectionLogoCloud, DbSectionPricing, DbSectionStats, DbSectionTestimonials, DbSegmentControl, DbSelect, DbShare, DbSidebar, DbSkeleton, DbSpinner, DbSplitView, DbStack, DbStat, DbStepper, DbTable, DbTabs, DbTestimonial, DbTextarea, DbTimePicker, DbTimeline, DbToast, DbToggle, DbToolbar, DbTooltip, DbTopBanner, DbTutorial, DbVideoPlayer, DbYouTubePlayer, confirm, confirm as dbConfirm, toast as dbToast, showToast, toast };
+export type { CalendarEventData, CalendarEventType, DbAlertAction, DbBannerAction, DbBottomNavigationItem, DbConfirmOptions, DbConfirmVariant, DbFooterCompanyInfo, DbFooterFamilySite, DbFooterLink, DbFooterLinkColumn, DbFooterSocialLink, DbFormFieldData, DbGanttAssignee, DbGanttGroup, DbGanttItem, DbGanttItemStatus, DbGanttRow, DbImageListItem, DbKanbanAssignee, DbKanbanCard, DbKanbanColumn, DbKanbanPriority, DbKanbanTag, DbLightboxImage, DbNavbarItem, DbNavbarUserProfile, DbPageHeaderTabItem, DbSharePlatform, DbShareVariant, DbSidebarItem, DbSidebarSection, DbSidebarUserProfile, DbStatChange, DbTimelineItem, DbToastApi, DbToastHandle, DbToastOptions, DbToastPosition, DbToastStatus };