@m1kapp/kit 0.0.44 → 0.0.45

package/dist/index.d.mts

@@ -774,13 +774,20 @@ type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
 type AvatarShape = "circle" | "rounded";
 interface AvatarProps {
     src?: string;
+    /**
+     * 순서대로 시도할 후보 URL 목록. 첫 장이 죽으면 다음 장으로 넘어가고,
+     * 전부 실패해야 이니셜 폴백이 뜬다. src 보다 우선한다.
+     */
+    candidates?: string[];
     fallback: string;
     size?: AvatarSize;
     shape?: AvatarShape;
     color?: string;
+    /** 그라데이션 링. 프로필·계정 아바타를 눈에 띄게 세울 때. */
+    ring?: boolean;
     className?: string;
 }
-declare function Avatar({ src, fallback, size, shape, color, className, }: AvatarProps): react_jsx_runtime.JSX.Element;
+declare function Avatar({ src, candidates, fallback, size, shape, color, ring, className, }: AvatarProps): react_jsx_runtime.JSX.Element;
 
 type BadgeVariant = "default" | "green" | "red" | "yellow" | "blue" | "purple" | "orange";
 type BadgeSize = "sm" | "md";
@@ -1588,6 +1595,103 @@ interface CarouselProps {
  */
 declare function Carousel({ count, index, onChange, children, loop, showArrows, showDots, accent, className, }: CarouselProps): react_jsx_runtime.JSX.Element;
 
+interface EvidenceDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /** 어느 항목의 근거인지 — 다이얼로그 제목. 예: "카카오 → SM" */
+    heading?: string;
+    /** 그 값 자체. 예: "인수금액 1.25조 원 · 지분 39.9%" */
+    title: ReactNode;
+    /** 원문에서 그 값이 나온 대목(인용). */
+    quote?: ReactNode;
+    /** 그 값을 그대로 믿기 전에 알아야 할 것. */
+    note?: ReactNode;
+    /** 원문 주소. */
+    source?: string;
+    /** 원문 링크 라벨. 기본: 그림이 있으면 "원문 ↗", 없으면 "그 값이 적힌 원문 ↗" */
+    sourceLabel?: string;
+    /** 그 값이 적힌 자리를 찍은 그림. */
+    imageSrc?: string;
+    imageAlt?: string;
+    /** 그림도 주소도 없을 때 대신 보일 말. 기본: "원문 그림이 아직 없다" */
+    emptyLabel?: string;
+}
+/**
+ * 숫자 하나의 근거. 값을 눌렀을 때 인용문·캡처 그림·원문 링크가 뜬다.
+ *
+ * "이 숫자 어디서 왔나"를 화면에서 바로 보여 주는 증거 기반 앱들의 공통 골격 —
+ * nlnn 의 값 다이얼로그, median-income-calc 의 정확도 안내가 전부 이 모양이었다.
+ * 링크만 걸어 두면 원문이 바뀌거나 사라졌을 때 무엇을 보고 적었는지 알 길이
+ * 없으므로, 그림(캡처)을 함께 두는 것을 권한다.
+ */
+declare function EvidenceDialog({ open, onClose, heading, title, quote, note, source, sourceLabel, imageSrc, imageAlt, emptyLabel, }: EvidenceDialogProps): react_jsx_runtime.JSX.Element;
+
+interface ColumnDatum {
+    /** 축 라벨. weekday 를 켜면 ISO 날짜("2026-09-03")로 요일을 그린다. */
+    label: string;
+    value: number;
+    /** 이 막대만 다른 색. */
+    color?: string;
+    /** 아직 오지 않은 구간(예측). 반투명하게 그리고 경계에 점선을 세운다. */
+    projected?: boolean;
+}
+interface ColumnChartProps {
+    data: ColumnDatum[];
+    /** 막대 색. 기본: var(--kit-accent) */
+    color?: string;
+    /** 실측 구간 평균에 점선을 긋는다. */
+    showAverage?: boolean;
+    averageLabel?: string;
+    /** 평균·타이틀 표기용 포맷터. */
+    format?: (n: number) => string;
+    /** 축 라벨을 "일 + 요일 첫 글자"로 그린다(label 이 ISO 날짜일 때). */
+    weekday?: boolean;
+    /** 예측 경계 라벨. 기본: "예상 →" */
+    projectedLabel?: string;
+    height?: number;
+    className?: string;
+}
+/** 세로 막대 + 평균선 + 예측 구간. 일별·주별 사용량류에 맞다. */
+declare function ColumnChart({ data, color, showAverage, averageLabel, format, weekday, projectedLabel, height, className, }: ColumnChartProps): react_jsx_runtime.JSX.Element | null;
+interface DuoBarSide {
+    value: number;
+    label: string;
+    color: string;
+}
+interface DuoBarProps {
+    /** 위에 서는 제목. 오른쪽에 합계가 붙는다. */
+    title?: string;
+    a: DuoBarSide;
+    b: DuoBarSide;
+    format?: (n: number) => string;
+    className?: string;
+}
+/** 두 값의 비율 스택 바 + 하단 범례. 입력/출력·모바일/데스크톱 같은 2분할에. */
+declare function DuoBar({ title, a, b, format, className }: DuoBarProps): react_jsx_runtime.JSX.Element;
+interface CumulativeCurveProps {
+    /** 일별 증가량(누적이 아니라 그날 값). */
+    daily: {
+        date: string;
+        count: number;
+    }[];
+    /** 지금까지의 총합 — 마일스톤 달성 판정에 쓴다. */
+    total: number;
+    /** 오늘 값이 있으면 끝점에 라이브 점을 찍는다. */
+    todayCount?: number;
+    /** 곡선·면적 색. */
+    accent?: string;
+    /** 교차점 배지를 세울 마일스톤. */
+    milestones?: {
+        value: number;
+        label: string;
+    }[];
+    /** 데이터가 없을 때 보일 말. */
+    empty?: React.ReactNode;
+    className?: string;
+}
+/** 누적 성장 곡선 + 마일스톤 배지 + 다음 목표선. 방문자·판매·적립 총량류에. */
+declare function CumulativeCurve({ daily, total, todayCount, accent, milestones, empty, className, }: CumulativeCurveProps): react_jsx_runtime.JSX.Element | null;
+
 type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
     state: PWAInstallState;
@@ -1632,6 +1736,28 @@ interface PWAInstallButtonProps {
  */
 declare function PWAInstallButton({ appName, iconSrc, label, installedLabel, className, }: PWAInstallButtonProps): react_jsx_runtime.JSX.Element | null;
 
+declare function markTabNavigation(): void;
+/**
+ * 뒤로가기 스크롤 복원 (Next 전용 — usePathname/useSearchParams 를 쓴다).
+ *
+ * AppShell 앱의 스크롤은 window 가 아니라 AppShellContent 의 내부 컨테이너
+ * (`.tab-scroll`)에서 일어나서 브라우저 기본 복원이 안 먹는다 — URL 별 스크롤
+ * 위치를 sessionStorage 에 저장해 두고 다시 그 URL 로 돌아오면 되돌린다.
+ * 레이아웃에 한 번 두면 된다: `<Suspense><ScrollRestorer /></Suspense>`
+ * (useSearchParams 때문에 Suspense 경계가 필요하다).
+ *
+ * 까다로운 점: 목록에서 상세(다른 레이아웃)로 갔다 돌아오면 컨테이너가 통째로
+ * 새로 생기는데, 그 순간엔 목록이 아직 덜 그려져 높이가 부족하다. 그냥 scrollTop 을
+ * 한 번 넣으면 잘려서(클램프) 맨 위로 튄다. 그래서 콘텐츠가 목표 높이에 도달할
+ * 때까지 짧게 재시도하고(ResizeObserver + rAF), 복원 중엔 저장을 멈춘다(잘린
+ * 위치가 좋은 값을 덮어쓰지 않도록). 사용자가 실제로 스크롤하면 즉시 포기한다.
+ *
+ * ytcc 에서 실전 검증된 코드를 그대로 올렸다.
+ */
+declare function ScrollRestorer({ selector }: {
+    selector?: string;
+}): null;
+
 /**
  * Drop into <head> in your root layout to pre-load kit styles and
  * prevent the JS injection from re-running (eliminates FOUC).
@@ -1778,6 +1904,48 @@ interface UsePollingResult<T> {
 }
 declare function usePolling<T>(fetcher: () => Promise<T>, options?: UsePollingOptions<T>): UsePollingResult<T>;
 
+/** epoch → 한국 시각의 달력 부분을 UTC 게터(getUTCFullYear 등)로 읽을 수 있는 Date */
+declare function toKst(ms?: number): Date;
+/** 그 시각이 속한 한국 날짜의 00:00 epoch */
+declare function kstMidnight(ms?: number): number;
+/** 한국 기준 오늘 날짜 "2026-09-03" */
+declare function kstToday(ms?: number): string;
+/** 한국 시각 파츠 — { date: "2026-09-03", weekday: "수", hhmm: "14:05" } */
+declare function kstNowParts(ms?: number): {
+    date: string;
+    weekday: string;
+    hhmm: string;
+};
+/** epoch → 한국 기준 '일' 숫자 (날짜 스트립용) */
+declare function kstDayOfMonth(ms: number): number;
+/** 그 시각이 한국 기준 오늘인가 */
+declare function isKstToday(ms: number, now?: number): boolean;
+/** 이번주(월~일, 한국 달력) 시작 epoch — 이번주 월요일 00:00. weeksAgo=1 이면 지난주 */
+declare function startOfKstWeek(weeksAgo?: number, now?: number): number;
+/** weeksAgo → "7.6(월) ~ 7.12(일)" 주차 라벨 — 클라이언트·서버 공용 */
+declare function kstWeekLabel(weeksAgo?: number, now?: number): string;
+/** 그 주 월요일 시작 epoch → ISO 8601 { year, week }. 목요일이 속한 해가 ISO 연도 */
+declare function isoWeekOfStart(start: number): {
+    year: number;
+    week: number;
+};
+/** weeksAgo → "2026년 28주차" (ISO 8601 주번호) */
+declare function kstWeekTitle(weeksAgo?: number, now?: number): string;
+/** weeksAgo → URL 용 주차 키 "2026-28" */
+declare function kstWeekParam(weeksAgo?: number, now?: number): string;
+/** "2026-28" 주차 키 → weeksAgo. 형식이 안 맞으면 null */
+declare function weeksAgoFromKstWeekParam(param: string | null | undefined, now?: number): number | null;
+
+/** 한글 음절을 초성으로 — "셀토스" → "ㅅㅌㅅ". 한글이 아니면 그대로 둔다. */
+declare function toChoseong(text: string): string;
+/**
+ * 이름·브랜드를 부분일치로 찾는다. 질의가 초성만이면 초성끼리 비교한다.
+ * 공백·점·하이픈은 무시한다. 빈 질의는 전부 통과.
+ *
+ *   items.filter((c) => matchesQuery(q, c.name, c.brand, c.english))
+ */
+declare function matchesQuery(query: string, ...fields: (string | undefined)[]): boolean;
+
 declare function relativeTime(date: Date | string | number): string;
 declare function formatNumber(n: number): string;
 declare function formatPrice(amount: number, currency?: string, locale?: string): string;
@@ -1853,4 +2021,4 @@ declare function watermarkTint(accentHex: string, { saturation, lightness }?: {
     lightness?: number | undefined;
 }): string;
 
-export { APP_SHELL_HEADER_HEIGHT, ActionCard, type ActionCardLabels, type ActionCardProps, type ActionCardState, type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, AsyncList, type AsyncListProps, type AsyncListStatus, Avatar, type AvatarProps, Badge, type BadgeProps, BarList, type BarListItem, type BarListProps, Button, type ButtonProps, Carousel, type CarouselProps, ChatBubble, type ChatBubbleProps, type ChatMessage, type ChatRole, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, type ColorName, ColorPicker, type ColorPickerProps, CopyButton, type CopyButtonProps, Countdown, type CountdownLabels, type CountdownProps, type DateCount, type DayGroup, Dialog, type DialogProps, Divider, type DividerProps, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, Fab, type FabProps, FetchProgress, type FetchProgressProps, Field, type FieldProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, IconButton, type IconButtonProps, Img, type ImgProps, InAppSheet, type InAppSheetProps, InlineEdit, type InlineEditProps, Input, type InputProps, type IsoDuration, KitStyles, LinkifiedText, type LinkifiedTextProps, ListRow, type ListRowProps, MediaCard, type MediaCardProps, MessageList, type MessageListProps, PWAInstallButton, type PWAInstallState, PoweredByKit, type PoweredByKitProps, ProgressRing, type ProgressRingProps, Section, SectionHeader, type SectionHeaderProps, type SectionProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, type SelectOption, type SelectProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, type Step, Stepper, type StepperProps, Switch, type SwitchProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, type TabRootProps, Textarea, type TextareaProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, TypingIndicator, type TypingIndicatorProps, type UnderlineTab, UnderlineTabs, type UnderlineTabsProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fillDateSeries, fontFamily, fonts, formatDayLabel, formatDollarEok, formatDuration, formatKoreanNumber, formatNumber, formatPrice, formatWon, formatWonTight, getFetchActiveCount, groupByDay, invalidateFetch, isoDurationToSec, mobileViewport, parseIsoDuration, particle, postJson, relativeTime, subscribeFetchActivity, svgIcon, useCopy, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useImageLoader, useInView, useLocalStorage, usePWAInstall, usePolling, usePortalTarget, useScrollLock, useShare, useToast, watermarkTint, withParticle };
+export { APP_SHELL_HEADER_HEIGHT, ActionCard, type ActionCardLabels, type ActionCardProps, type ActionCardState, type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, AsyncList, type AsyncListProps, type AsyncListStatus, Avatar, type AvatarProps, Badge, type BadgeProps, BarList, type BarListItem, type BarListProps, Button, type ButtonProps, Carousel, type CarouselProps, ChatBubble, type ChatBubbleProps, type ChatMessage, type ChatRole, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, type ColorName, ColorPicker, type ColorPickerProps, ColumnChart, type ColumnChartProps, type ColumnDatum, CopyButton, type CopyButtonProps, Countdown, type CountdownLabels, type CountdownProps, CumulativeCurve, type CumulativeCurveProps, type DateCount, type DayGroup, Dialog, type DialogProps, Divider, type DividerProps, DuoBar, type DuoBarProps, type DuoBarSide, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, EvidenceDialog, type EvidenceDialogProps, Fab, type FabProps, FetchProgress, type FetchProgressProps, Field, type FieldProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, IconButton, type IconButtonProps, Img, type ImgProps, InAppSheet, type InAppSheetProps, InlineEdit, type InlineEditProps, Input, type InputProps, type IsoDuration, KitStyles, LinkifiedText, type LinkifiedTextProps, ListRow, type ListRowProps, MediaCard, type MediaCardProps, MessageList, type MessageListProps, PWAInstallButton, type PWAInstallState, PoweredByKit, type PoweredByKitProps, ProgressRing, type ProgressRingProps, ScrollRestorer, Section, SectionHeader, type SectionHeaderProps, type SectionProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, type SelectOption, type SelectProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, type Step, Stepper, type StepperProps, Switch, type SwitchProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, type TabRootProps, Textarea, type TextareaProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, TypingIndicator, type TypingIndicatorProps, type UnderlineTab, UnderlineTabs, type UnderlineTabsProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fillDateSeries, fontFamily, fonts, formatDayLabel, formatDollarEok, formatDuration, formatKoreanNumber, formatNumber, formatPrice, formatWon, formatWonTight, getFetchActiveCount, groupByDay, invalidateFetch, isKstToday, isoDurationToSec, isoWeekOfStart, kstDayOfMonth, kstMidnight, kstNowParts, kstToday, kstWeekLabel, kstWeekParam, kstWeekTitle, markTabNavigation, matchesQuery, mobileViewport, parseIsoDuration, particle, postJson, relativeTime, startOfKstWeek, subscribeFetchActivity, svgIcon, toChoseong, toKst, useCopy, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useImageLoader, useInView, useLocalStorage, usePWAInstall, usePolling, usePortalTarget, useScrollLock, useShare, useToast, watermarkTint, weeksAgoFromKstWeekParam, withParticle };

package/dist/index.d.ts

@@ -774,13 +774,20 @@ type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
 type AvatarShape = "circle" | "rounded";
 interface AvatarProps {
     src?: string;
+    /**
+     * 순서대로 시도할 후보 URL 목록. 첫 장이 죽으면 다음 장으로 넘어가고,
+     * 전부 실패해야 이니셜 폴백이 뜬다. src 보다 우선한다.
+     */
+    candidates?: string[];
     fallback: string;
     size?: AvatarSize;
     shape?: AvatarShape;
     color?: string;
+    /** 그라데이션 링. 프로필·계정 아바타를 눈에 띄게 세울 때. */
+    ring?: boolean;
     className?: string;
 }
-declare function Avatar({ src, fallback, size, shape, color, className, }: AvatarProps): react_jsx_runtime.JSX.Element;
+declare function Avatar({ src, candidates, fallback, size, shape, color, ring, className, }: AvatarProps): react_jsx_runtime.JSX.Element;
 
 type BadgeVariant = "default" | "green" | "red" | "yellow" | "blue" | "purple" | "orange";
 type BadgeSize = "sm" | "md";
@@ -1588,6 +1595,103 @@ interface CarouselProps {
  */
 declare function Carousel({ count, index, onChange, children, loop, showArrows, showDots, accent, className, }: CarouselProps): react_jsx_runtime.JSX.Element;
 
+interface EvidenceDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /** 어느 항목의 근거인지 — 다이얼로그 제목. 예: "카카오 → SM" */
+    heading?: string;
+    /** 그 값 자체. 예: "인수금액 1.25조 원 · 지분 39.9%" */
+    title: ReactNode;
+    /** 원문에서 그 값이 나온 대목(인용). */
+    quote?: ReactNode;
+    /** 그 값을 그대로 믿기 전에 알아야 할 것. */
+    note?: ReactNode;
+    /** 원문 주소. */
+    source?: string;
+    /** 원문 링크 라벨. 기본: 그림이 있으면 "원문 ↗", 없으면 "그 값이 적힌 원문 ↗" */
+    sourceLabel?: string;
+    /** 그 값이 적힌 자리를 찍은 그림. */
+    imageSrc?: string;
+    imageAlt?: string;
+    /** 그림도 주소도 없을 때 대신 보일 말. 기본: "원문 그림이 아직 없다" */
+    emptyLabel?: string;
+}
+/**
+ * 숫자 하나의 근거. 값을 눌렀을 때 인용문·캡처 그림·원문 링크가 뜬다.
+ *
+ * "이 숫자 어디서 왔나"를 화면에서 바로 보여 주는 증거 기반 앱들의 공통 골격 —
+ * nlnn 의 값 다이얼로그, median-income-calc 의 정확도 안내가 전부 이 모양이었다.
+ * 링크만 걸어 두면 원문이 바뀌거나 사라졌을 때 무엇을 보고 적었는지 알 길이
+ * 없으므로, 그림(캡처)을 함께 두는 것을 권한다.
+ */
+declare function EvidenceDialog({ open, onClose, heading, title, quote, note, source, sourceLabel, imageSrc, imageAlt, emptyLabel, }: EvidenceDialogProps): react_jsx_runtime.JSX.Element;
+
+interface ColumnDatum {
+    /** 축 라벨. weekday 를 켜면 ISO 날짜("2026-09-03")로 요일을 그린다. */
+    label: string;
+    value: number;
+    /** 이 막대만 다른 색. */
+    color?: string;
+    /** 아직 오지 않은 구간(예측). 반투명하게 그리고 경계에 점선을 세운다. */
+    projected?: boolean;
+}
+interface ColumnChartProps {
+    data: ColumnDatum[];
+    /** 막대 색. 기본: var(--kit-accent) */
+    color?: string;
+    /** 실측 구간 평균에 점선을 긋는다. */
+    showAverage?: boolean;
+    averageLabel?: string;
+    /** 평균·타이틀 표기용 포맷터. */
+    format?: (n: number) => string;
+    /** 축 라벨을 "일 + 요일 첫 글자"로 그린다(label 이 ISO 날짜일 때). */
+    weekday?: boolean;
+    /** 예측 경계 라벨. 기본: "예상 →" */
+    projectedLabel?: string;
+    height?: number;
+    className?: string;
+}
+/** 세로 막대 + 평균선 + 예측 구간. 일별·주별 사용량류에 맞다. */
+declare function ColumnChart({ data, color, showAverage, averageLabel, format, weekday, projectedLabel, height, className, }: ColumnChartProps): react_jsx_runtime.JSX.Element | null;
+interface DuoBarSide {
+    value: number;
+    label: string;
+    color: string;
+}
+interface DuoBarProps {
+    /** 위에 서는 제목. 오른쪽에 합계가 붙는다. */
+    title?: string;
+    a: DuoBarSide;
+    b: DuoBarSide;
+    format?: (n: number) => string;
+    className?: string;
+}
+/** 두 값의 비율 스택 바 + 하단 범례. 입력/출력·모바일/데스크톱 같은 2분할에. */
+declare function DuoBar({ title, a, b, format, className }: DuoBarProps): react_jsx_runtime.JSX.Element;
+interface CumulativeCurveProps {
+    /** 일별 증가량(누적이 아니라 그날 값). */
+    daily: {
+        date: string;
+        count: number;
+    }[];
+    /** 지금까지의 총합 — 마일스톤 달성 판정에 쓴다. */
+    total: number;
+    /** 오늘 값이 있으면 끝점에 라이브 점을 찍는다. */
+    todayCount?: number;
+    /** 곡선·면적 색. */
+    accent?: string;
+    /** 교차점 배지를 세울 마일스톤. */
+    milestones?: {
+        value: number;
+        label: string;
+    }[];
+    /** 데이터가 없을 때 보일 말. */
+    empty?: React.ReactNode;
+    className?: string;
+}
+/** 누적 성장 곡선 + 마일스톤 배지 + 다음 목표선. 방문자·판매·적립 총량류에. */
+declare function CumulativeCurve({ daily, total, todayCount, accent, milestones, empty, className, }: CumulativeCurveProps): react_jsx_runtime.JSX.Element | null;
+
 type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
     state: PWAInstallState;
@@ -1632,6 +1736,28 @@ interface PWAInstallButtonProps {
  */
 declare function PWAInstallButton({ appName, iconSrc, label, installedLabel, className, }: PWAInstallButtonProps): react_jsx_runtime.JSX.Element | null;
 
+declare function markTabNavigation(): void;
+/**
+ * 뒤로가기 스크롤 복원 (Next 전용 — usePathname/useSearchParams 를 쓴다).
+ *
+ * AppShell 앱의 스크롤은 window 가 아니라 AppShellContent 의 내부 컨테이너
+ * (`.tab-scroll`)에서 일어나서 브라우저 기본 복원이 안 먹는다 — URL 별 스크롤
+ * 위치를 sessionStorage 에 저장해 두고 다시 그 URL 로 돌아오면 되돌린다.
+ * 레이아웃에 한 번 두면 된다: `<Suspense><ScrollRestorer /></Suspense>`
+ * (useSearchParams 때문에 Suspense 경계가 필요하다).
+ *
+ * 까다로운 점: 목록에서 상세(다른 레이아웃)로 갔다 돌아오면 컨테이너가 통째로
+ * 새로 생기는데, 그 순간엔 목록이 아직 덜 그려져 높이가 부족하다. 그냥 scrollTop 을
+ * 한 번 넣으면 잘려서(클램프) 맨 위로 튄다. 그래서 콘텐츠가 목표 높이에 도달할
+ * 때까지 짧게 재시도하고(ResizeObserver + rAF), 복원 중엔 저장을 멈춘다(잘린
+ * 위치가 좋은 값을 덮어쓰지 않도록). 사용자가 실제로 스크롤하면 즉시 포기한다.
+ *
+ * ytcc 에서 실전 검증된 코드를 그대로 올렸다.
+ */
+declare function ScrollRestorer({ selector }: {
+    selector?: string;
+}): null;
+
 /**
  * Drop into <head> in your root layout to pre-load kit styles and
  * prevent the JS injection from re-running (eliminates FOUC).
@@ -1778,6 +1904,48 @@ interface UsePollingResult<T> {
 }
 declare function usePolling<T>(fetcher: () => Promise<T>, options?: UsePollingOptions<T>): UsePollingResult<T>;
 
+/** epoch → 한국 시각의 달력 부분을 UTC 게터(getUTCFullYear 등)로 읽을 수 있는 Date */
+declare function toKst(ms?: number): Date;
+/** 그 시각이 속한 한국 날짜의 00:00 epoch */
+declare function kstMidnight(ms?: number): number;
+/** 한국 기준 오늘 날짜 "2026-09-03" */
+declare function kstToday(ms?: number): string;
+/** 한국 시각 파츠 — { date: "2026-09-03", weekday: "수", hhmm: "14:05" } */
+declare function kstNowParts(ms?: number): {
+    date: string;
+    weekday: string;
+    hhmm: string;
+};
+/** epoch → 한국 기준 '일' 숫자 (날짜 스트립용) */
+declare function kstDayOfMonth(ms: number): number;
+/** 그 시각이 한국 기준 오늘인가 */
+declare function isKstToday(ms: number, now?: number): boolean;
+/** 이번주(월~일, 한국 달력) 시작 epoch — 이번주 월요일 00:00. weeksAgo=1 이면 지난주 */
+declare function startOfKstWeek(weeksAgo?: number, now?: number): number;
+/** weeksAgo → "7.6(월) ~ 7.12(일)" 주차 라벨 — 클라이언트·서버 공용 */
+declare function kstWeekLabel(weeksAgo?: number, now?: number): string;
+/** 그 주 월요일 시작 epoch → ISO 8601 { year, week }. 목요일이 속한 해가 ISO 연도 */
+declare function isoWeekOfStart(start: number): {
+    year: number;
+    week: number;
+};
+/** weeksAgo → "2026년 28주차" (ISO 8601 주번호) */
+declare function kstWeekTitle(weeksAgo?: number, now?: number): string;
+/** weeksAgo → URL 용 주차 키 "2026-28" */
+declare function kstWeekParam(weeksAgo?: number, now?: number): string;
+/** "2026-28" 주차 키 → weeksAgo. 형식이 안 맞으면 null */
+declare function weeksAgoFromKstWeekParam(param: string | null | undefined, now?: number): number | null;
+
+/** 한글 음절을 초성으로 — "셀토스" → "ㅅㅌㅅ". 한글이 아니면 그대로 둔다. */
+declare function toChoseong(text: string): string;
+/**
+ * 이름·브랜드를 부분일치로 찾는다. 질의가 초성만이면 초성끼리 비교한다.
+ * 공백·점·하이픈은 무시한다. 빈 질의는 전부 통과.
+ *
+ *   items.filter((c) => matchesQuery(q, c.name, c.brand, c.english))
+ */
+declare function matchesQuery(query: string, ...fields: (string | undefined)[]): boolean;
+
 declare function relativeTime(date: Date | string | number): string;
 declare function formatNumber(n: number): string;
 declare function formatPrice(amount: number, currency?: string, locale?: string): string;
@@ -1853,4 +2021,4 @@ declare function watermarkTint(accentHex: string, { saturation, lightness }?: {
     lightness?: number | undefined;
 }): string;
 
-export { APP_SHELL_HEADER_HEIGHT, ActionCard, type ActionCardLabels, type ActionCardProps, type ActionCardState, type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, AsyncList, type AsyncListProps, type AsyncListStatus, Avatar, type AvatarProps, Badge, type BadgeProps, BarList, type BarListItem, type BarListProps, Button, type ButtonProps, Carousel, type CarouselProps, ChatBubble, type ChatBubbleProps, type ChatMessage, type ChatRole, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, type ColorName, ColorPicker, type ColorPickerProps, CopyButton, type CopyButtonProps, Countdown, type CountdownLabels, type CountdownProps, type DateCount, type DayGroup, Dialog, type DialogProps, Divider, type DividerProps, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, Fab, type FabProps, FetchProgress, type FetchProgressProps, Field, type FieldProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, IconButton, type IconButtonProps, Img, type ImgProps, InAppSheet, type InAppSheetProps, InlineEdit, type InlineEditProps, Input, type InputProps, type IsoDuration, KitStyles, LinkifiedText, type LinkifiedTextProps, ListRow, type ListRowProps, MediaCard, type MediaCardProps, MessageList, type MessageListProps, PWAInstallButton, type PWAInstallState, PoweredByKit, type PoweredByKitProps, ProgressRing, type ProgressRingProps, Section, SectionHeader, type SectionHeaderProps, type SectionProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, type SelectOption, type SelectProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, type Step, Stepper, type StepperProps, Switch, type SwitchProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, type TabRootProps, Textarea, type TextareaProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, TypingIndicator, type TypingIndicatorProps, type UnderlineTab, UnderlineTabs, type UnderlineTabsProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fillDateSeries, fontFamily, fonts, formatDayLabel, formatDollarEok, formatDuration, formatKoreanNumber, formatNumber, formatPrice, formatWon, formatWonTight, getFetchActiveCount, groupByDay, invalidateFetch, isoDurationToSec, mobileViewport, parseIsoDuration, particle, postJson, relativeTime, subscribeFetchActivity, svgIcon, useCopy, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useImageLoader, useInView, useLocalStorage, usePWAInstall, usePolling, usePortalTarget, useScrollLock, useShare, useToast, watermarkTint, withParticle };
+export { APP_SHELL_HEADER_HEIGHT, ActionCard, type ActionCardLabels, type ActionCardProps, type ActionCardState, type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, AsyncList, type AsyncListProps, type AsyncListStatus, Avatar, type AvatarProps, Badge, type BadgeProps, BarList, type BarListItem, type BarListProps, Button, type ButtonProps, Carousel, type CarouselProps, ChatBubble, type ChatBubbleProps, type ChatMessage, type ChatRole, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, type ColorName, ColorPicker, type ColorPickerProps, ColumnChart, type ColumnChartProps, type ColumnDatum, CopyButton, type CopyButtonProps, Countdown, type CountdownLabels, type CountdownProps, CumulativeCurve, type CumulativeCurveProps, type DateCount, type DayGroup, Dialog, type DialogProps, Divider, type DividerProps, DuoBar, type DuoBarProps, type DuoBarSide, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, EvidenceDialog, type EvidenceDialogProps, Fab, type FabProps, FetchProgress, type FetchProgressProps, Field, type FieldProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, IconButton, type IconButtonProps, Img, type ImgProps, InAppSheet, type InAppSheetProps, InlineEdit, type InlineEditProps, Input, type InputProps, type IsoDuration, KitStyles, LinkifiedText, type LinkifiedTextProps, ListRow, type ListRowProps, MediaCard, type MediaCardProps, MessageList, type MessageListProps, PWAInstallButton, type PWAInstallState, PoweredByKit, type PoweredByKitProps, ProgressRing, type ProgressRingProps, ScrollRestorer, Section, SectionHeader, type SectionHeaderProps, type SectionProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, type SelectOption, type SelectProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, type Step, Stepper, type StepperProps, Switch, type SwitchProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, type TabRootProps, Textarea, type TextareaProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, TypingIndicator, type TypingIndicatorProps, type UnderlineTab, UnderlineTabs, type UnderlineTabsProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fillDateSeries, fontFamily, fonts, formatDayLabel, formatDollarEok, formatDuration, formatKoreanNumber, formatNumber, formatPrice, formatWon, formatWonTight, getFetchActiveCount, groupByDay, invalidateFetch, isKstToday, isoDurationToSec, isoWeekOfStart, kstDayOfMonth, kstMidnight, kstNowParts, kstToday, kstWeekLabel, kstWeekParam, kstWeekTitle, markTabNavigation, matchesQuery, mobileViewport, parseIsoDuration, particle, postJson, relativeTime, startOfKstWeek, subscribeFetchActivity, svgIcon, toChoseong, toKst, useCopy, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useImageLoader, useInView, useLocalStorage, usePWAInstall, usePolling, usePortalTarget, useScrollLock, useShare, useToast, watermarkTint, weeksAgoFromKstWeekParam, withParticle };