@designbasekorea/figma-ui 0.6.9 → 0.7.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { PaymentStatus, UsageResetPeriod, LicenseManagerMessageTypes } from '@designbasekorea/figma-license-core';
+export { DEFAULT_LICENSE_MESSAGE_TYPES } from '@designbasekorea/figma-license-core';
 import { GradientScheme, GradientTone } from '@designbasekorea/ui-wc/react';
 export * from '@designbasekorea/ui-wc/react';
 export { Accordion, ActivityHeatmap, AdBanner, AiChat, AiChatList, Alert, AnimationBackground, AnimationText, AppBadge, AudioPlayer, Avatar, Backdrop, Badge, Banner, BottomNavigation, BottomSheet, Breadcrumbs, Button, Calendar, Card, Carousel, ChatComposer, ChatList, ChatMessage, ChatOrb, ChatRoom, ChatSuggestions, ChatTyping, ChatWelcome, ChatWidget, Checkbox, Chip, CodeBlock, ColorPicker, ColorSwatch, Confirm, Container, ContextMenu, CookieBanner, Countdown, CursorFollower, DatePicker, Divider, DownloadProgress, Drawer, Dropdown, Dropzone, EmailVerify, EmptyState, FileUploader, FloatingActionButton, Footer, Form, Gantt, Gradient, Grid, GridBackground, GridItem, Image, ImageList, ImagePlaceholder, Indicator, Input, Kanban, Label, Lightbox, List, Logo, MarkdownEditor, Marquee, Masonry, MenuItem, Modal, ModalBody, ModalFooter, ModalHeader, Navbar, OnboardingModal, OtpInput, PageHeader, Pagination, PhoneVerify, Popover, Progress, ProgressStep, Progressbar, Radio, RandomGradient, RangeSlider, Rating, Reorder, ResizablePanels, ScrollArea, SearchBar, Section, SectionAppDownload, SectionContact, SectionCta, SectionFaq, SectionFeature, SectionFeatureGrid, SectionHero, SectionLogoCloud, SectionPricing, SectionStats, SectionTestimonials, SegmentControl, Select, Share, Sidebar, Signature, Skeleton, Spinner, SplitView, Stack, Stat, Stepper, Table, Tabs, Testimonial, Textarea, TimePicker, Timeline, Toast, Toggle, Toolbar, Tooltip, TopBanner, Tutorial, TwoFactor, VideoPlayer, YouTubePlayer, useContextMenu } from '@designbasekorea/ui-wc/react';
@@ -9,6 +10,10 @@ type I18nText = string | {
     values?: Record<string, any>;
 };
 type TFunctionLite = (key: string, values?: Record<string, any>) => string;
+type FigmaUiLocale = 'ko' | 'en' | 'ja';
+declare const FIGMA_UI_TRANSLATIONS: Record<FigmaUiLocale, Readonly<Record<string, string>>>;
+declare function normalizeFigmaUiLocale(locale?: string): FigmaUiLocale;
+declare function createFigmaUiTranslator(locale?: string | undefined, parentT?: TFunctionLite): TFunctionLite;
 declare function interpolateText(template: string, values?: Record<string, unknown>): string;
 declare function resolveText(t: TFunctionLite | undefined, input: I18nText | undefined, fallback?: string): string | undefined;
 
@@ -26,6 +31,7 @@ interface DonationBadgeProps {
     className?: string;
     onClick?: () => void;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const DonationBadge: React.FC<DonationBadgeProps>;
 
@@ -75,6 +81,7 @@ interface FigmaPageHeadProps {
     moreActions?: FigmaPageHeadAction[];
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const FigmaPageHead: React.FC<FigmaPageHeadProps>;
 
@@ -91,6 +98,7 @@ interface FigmaSectionProps {
     headerHeight?: number;
     onActiveSectionChange?: (category: string) => void;
     t?: TFunctionLite;
+    locale?: string;
     collapsible?: boolean;
     defaultCollapsed?: boolean;
     onCollapseChange?: (collapsed: boolean, category: string) => void;
@@ -154,10 +162,20 @@ interface FigmaFooterProps {
     onLicensePageClick?: () => void;
     paymentStatus?: 'PAID' | 'FREE' | 'TRIAL' | 'BETA';
     usageCount?: number;
+    remainingUsage?: number;
+    listenForUsageMessages?: boolean;
     isLoading?: boolean;
     showPaymentStatus?: boolean;
     showUsageInfo?: boolean;
     maxDailyUsage?: number;
+    showLowUsageWarning?: boolean;
+    lowUsageThresholdPercent?: number;
+    lowUsageWarningText?: I18nText;
+    onLowUsageWarning?: (details: {
+        remaining: number;
+        percent: number;
+        limit: number;
+    }) => void;
     showPaymentBadge?: boolean;
     showDonation?: boolean;
     donationUrl?: string;
@@ -213,7 +231,7 @@ interface FigmaToastProps {
 }
 declare const FigmaToast: React.FC<FigmaToastProps>;
 declare const useFigmaToast: () => {
-    showToast: (message: string, _type?: ToastStatus) => void;
+    showToast: (message: string, type?: ToastStatus) => void;
     toastComponent: React.JSX.Element | null;
 };
 
@@ -230,6 +248,7 @@ interface FormWithSubmitProps {
     helperText?: I18nText;
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const FormWithSubmit: React.FC<FormWithSubmitProps>;
 
@@ -243,6 +262,7 @@ interface InteractionFeedbackProps {
     visible?: boolean;
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const InteractionFeedback: React.FC<InteractionFeedbackProps>;
 
@@ -264,6 +284,7 @@ interface LicenseOfferProps {
     guideUrl?: string;
     membershipUrl?: string;
     t?: TFunctionLite;
+    locale?: string;
     className?: string;
 }
 declare const LicenseOffer: React.FC<LicenseOfferProps>;
@@ -279,6 +300,7 @@ interface LicenseStatusCardProps {
     validationMessage?: string;
     allowRevealKey?: boolean;
     t?: TFunctionLite;
+    locale?: string;
     className?: string;
 }
 declare const LicenseStatusCard: React.FC<LicenseStatusCardProps>;
@@ -297,7 +319,8 @@ interface PricingComparisonProps {
     features?: PricingFeature[];
     pricing?: PlanPricing;
     paymentType?: 'subscription' | 'lifetime';
-    t?: (key: string) => string;
+    t?: TFunctionLite;
+    locale?: string;
     className?: string;
 }
 declare const PricingComparison: React.FC<PricingComparisonProps>;
@@ -334,7 +357,7 @@ interface LicensePageState {
     lastVerifiedAt?: string;
     validationMessage?: string;
 }
-declare const DEFAULT_LICENSE_MESSAGE_TYPES: LicenseManagerMessageTypes;
+
 declare const START_DESIGNBASE_AUTH_MESSAGE = "start-designbase-auth";
 
 interface UseFigmaLicenseBridgeOptions {
@@ -352,6 +375,8 @@ declare function useFigmaLicenseBridge(options?: UseFigmaLicenseBridgeOptions):
     verifyLicense: (licenseKey: string) => void;
     deactivateLicense: () => void;
     startDesignbaseAuth: () => void;
+    checkFeatureAccess: (featureKey?: string, amount?: number) => void;
+    consumeUsage: (amount?: number, featureKey?: string) => void;
     setLicenseKeyInput: (licenseKey: string) => void;
 };
 
@@ -376,6 +401,7 @@ interface PageLicenseProps {
     onLicenseSubmit?: (licenseKey: string) => Promise<void> | void;
     usageCount?: number;
     t?: TFunctionLite;
+    locale?: string;
     className?: string;
 }
 declare const PageLicense: React.FC<PageLicenseProps>;
@@ -385,7 +411,8 @@ interface PaymentBadgeProps {
     onClick?: () => void;
     isLoading?: boolean;
     text?: string;
-    t?: (key: string) => string;
+    t?: TFunctionLite;
+    locale?: string;
     className?: string;
 }
 declare const PaymentBadge: React.FC<PaymentBadgeProps>;
@@ -405,6 +432,7 @@ interface PaymentStatusSectionProps {
     errorCode?: string;
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare function resolvePaymentFeedbackVariant(errorCode?: string, explicitVariant?: PaymentActionFeedbackVariant): PaymentActionFeedbackVariant;
 declare const PaymentStatusSection: React.FC<PaymentStatusSectionProps>;
@@ -429,6 +457,7 @@ interface ProgressModalProps {
     completeIcon?: React.ReactNode;
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
     autoComplete?: boolean;
     autoCloseOnComplete?: boolean;
 }
@@ -469,6 +498,7 @@ interface SettingsModalProps {
     description?: I18nText;
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const SettingsModal: React.FC<SettingsModalProps>;
 
@@ -481,6 +511,7 @@ interface TitleDescriptionProps {
     features?: I18nText[];
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const TitleDescription: React.FC<TitleDescriptionProps>;
 
@@ -498,6 +529,7 @@ interface UpgradeBannerProps {
     gradientAnimated?: boolean;
     className?: string;
     t?: TFunctionLite;
+    locale?: string;
 }
 declare const UpgradeBanner: React.FC<UpgradeBannerProps>;
 
@@ -505,15 +537,30 @@ type UsagePaymentStatus = 'PAID' | 'FREE' | 'TRIAL' | 'BETA';
 interface UsageStatusPopoverProps {
     paymentStatus: UsagePaymentStatus;
     usageCount?: number;
+    remainingUsage?: number;
     maxDailyUsage?: number;
     showUsage?: boolean;
     showPlan?: boolean;
     isLoading?: boolean;
     onLicensePageClick?: () => void;
     t?: TFunctionLite;
+    locale?: string;
     className?: string;
 }
 declare const UsageStatusPopover: React.FC<UsageStatusPopoverProps>;
 
-export { DEFAULT_LICENSE_MESSAGE_TYPES, DonationBadge, FigmaContainer, FigmaFooter, FigmaHeader, FigmaPageHead, FigmaSection, FigmaSidebar, FigmaToast, FigmaToastProvider, FormWithSubmit, InteractionFeedback, LanguageSelector, LanguageSettingsModal, LicenseOffer, LicenseStatusCard, LogoDropdown, PageLicense, PaymentBadge, PaymentStatusSection, PricingComparison, ProgressModal, ResizablePlugin, START_DESIGNBASE_AUTH_MESSAGE, SettingsModal, TitleDescription, UpgradeBanner, UsageStatusPopover, getActiveSection, interpolateText, resolvePaymentFeedbackVariant, resolveText, scrollToSection, useFigmaLicenseBridge, useFigmaToast, useToast };
-export type { DonationBadgeProps, FeedbackStatus, FigmaContainerProps, FigmaContainerSize, FigmaFooterProps, FigmaHeaderAction, FigmaHeaderProps, FigmaPageHeadAction, FigmaPageHeadProps, FigmaSectionProps, FigmaSidebarProps, FormWithSubmitProps, I18nText, InteractionFeedbackProps, Language, LanguageSelectorProps, LanguageSettingsModalProps, LicenseOfferProps, LicensePageState, LicenseStatusCardProps, LogoDropdownLink, LogoDropdownProps, PageLicenseProps, PaymentActionFeedbackVariant, PaymentBadgeProps, PaymentStatusSectionProps, PlanPricing, PricingComparisonProps, PricingFeature, ProgressModalProgress, ProgressModalProps, ResizablePluginProps, SettingsCategory, SettingsCategoryGroup, SettingsModalProps, TFunctionLite, TitleDescriptionProps, UpgradeBannerProps, UsagePaymentStatus, UsageStatusPopoverProps, WordPressLinks };
+interface FigmaUiI18nContextValue {
+    locale: FigmaUiLocale;
+    t: TFunctionLite;
+    parentT?: TFunctionLite;
+}
+interface FigmaUiI18nProviderProps {
+    locale?: string;
+    t?: TFunctionLite;
+    children?: React.ReactNode;
+}
+declare const FigmaUiI18nProvider: React.FC<FigmaUiI18nProviderProps>;
+declare function useFigmaUiI18n(localeOverride?: string, tOverride?: TFunctionLite): FigmaUiI18nContextValue;
+
+export { DonationBadge, FIGMA_UI_TRANSLATIONS, FigmaContainer, FigmaFooter, FigmaHeader, FigmaPageHead, FigmaSection, FigmaSidebar, FigmaToast, FigmaToastProvider, FigmaUiI18nProvider, FormWithSubmit, InteractionFeedback, LanguageSelector, LanguageSettingsModal, LicenseOffer, LicenseStatusCard, LogoDropdown, PageLicense, PaymentBadge, PaymentStatusSection, PricingComparison, ProgressModal, ResizablePlugin, START_DESIGNBASE_AUTH_MESSAGE, SettingsModal, TitleDescription, UpgradeBanner, UsageStatusPopover, createFigmaUiTranslator, getActiveSection, interpolateText, normalizeFigmaUiLocale, resolvePaymentFeedbackVariant, resolveText, scrollToSection, useFigmaLicenseBridge, useFigmaToast, useFigmaUiI18n, useToast };
+export type { DonationBadgeProps, FeedbackStatus, FigmaContainerProps, FigmaContainerSize, FigmaFooterProps, FigmaHeaderAction, FigmaHeaderProps, FigmaPageHeadAction, FigmaPageHeadProps, FigmaSectionProps, FigmaSidebarProps, FigmaUiI18nContextValue, FigmaUiI18nProviderProps, FigmaUiLocale, FormWithSubmitProps, I18nText, InteractionFeedbackProps, Language, LanguageSelectorProps, LanguageSettingsModalProps, LicenseOfferProps, LicensePageState, LicenseStatusCardProps, LogoDropdownLink, LogoDropdownProps, PageLicenseProps, PaymentActionFeedbackVariant, PaymentBadgeProps, PaymentStatusSectionProps, PlanPricing, PricingComparisonProps, PricingFeature, ProgressModalProgress, ProgressModalProps, ResizablePluginProps, SettingsCategory, SettingsCategoryGroup, SettingsModalProps, TFunctionLite, TitleDescriptionProps, UpgradeBannerProps, UsagePaymentStatus, UsageStatusPopoverProps, WordPressLinks };