@svp-chain-sdk/ui 0.1.6 → 0.1.10

package/README.md

@@ -183,32 +183,34 @@ const config = createSvpWalletConfig({
 
 ### FeedbackWidget
 
-页面右侧垂直居中的悬浮入口，点击后在新标签页打开内置 Google Form。
+页面右侧垂直居中的悬浮入口。点击后在按钮左侧打开说明 Popover，再前往 Google Form。按钮、标题、说明和操作文案支持 `en`、`ja`、`ko`、`zh-CN`、`zh-TW`，可由外部 `locale` 即时切换；未传时读取浏览器语言，未知语言回退到 `en`。
 
 ```tsx
-<FeedbackWidget />
-<FeedbackWidget className="my-feedback" />
+<FeedbackWidget locale="zh-CN" />
+<FeedbackWidget locale={currentLocale} className="my-feedback" />
 ```
 
 #### FeedbackWidgetProps
 
 | 参数 | 类型 | 默认值 | 说明 |
 | --- | --- | --- | --- |
+| `locale` | `Locale` | 浏览器语言，未知时 `en` | 外部语言选择：`en`、`ja`、`ko`、`zh-CN`、`zh-TW` |
 | `className` | `string` | 无 | 附加 class |
 
 内置地址：`https://forms.gle/6semmo55DSLtcbnw7`。链接使用 `target="_blank"` 和 `rel="noopener noreferrer"`。
 
 ### NoticeMarquee
 
-顶部居中的高层级通知浮层，默认距顶部 `100px`。默认读取 SDK 内置 IPFS JSON，根据浏览器语言选择文案，并每 5 分钟静默刷新。用户可以点击“已知晓”或关闭按钮。
+顶部居中的高层级通知浮层，默认距顶部 `100px`。默认读取 SDK 内置 IPFS JSON，支持 `en`、`ja`、`ko`、`zh-CN`、`zh-TW`，可由外部 `locale` 即时切换；未传时读取浏览器语言，未知语言回退到 `en`。组件每 5 分钟静默刷新，并仅依据服务端 `endtime`（Unix epoch 毫秒）决定通知是否有效。
 
 - **已知晓**：记录当前完整公告快照，本轮公告不再显示；远程公告内容发生变化后会再次显示。
 - **关闭**：只关闭当前页面实例，不写入 localStorage；刷新页面后仍会再次显示。
 
 ```tsx
-<NoticeMarquee />
+<NoticeMarquee locale="zh-CN" />
 
 <NoticeMarquee
+  locale={currentLocale}
   url="https://example.com/notice.json"
   storageKey="my-app:notice"
   refreshIntervalMs={5 * 60 * 1000}
@@ -223,17 +225,21 @@ const config = createSvpWalletConfig({
 ```json
 {
   "en": "English notice",
-  "zh": "中文通知",
-  "fr": "Notification française"
+  "ja": "日本語のお知らせ",
+  "ko": "한국어 알림",
+  "zh-CN": "简体中文通知",
+  "zh-TW": "繁體中文通知",
+  "endtime": "1789646400000"
 }
 ```
 
-中文读取 `zh`，法语读取 `fr`，其他语言读取 `en`；缺失时回退到 `en`，再回退到第一个非空字符串。内容按纯文本渲染。组件通过 localStorage 记录完整公告快照，相同公告不重复播放。
+组件读取与 `locale` 同名的字段；该字段为空或缺失时回退到 `en`，`en` 也不可用时不显示。为兼容当前已发布的公告，`zh-CN` 与 `zh-TW` 在对应字段缺失时会先尝试旧的 `zh` 字段。`endtime` 必须是未来的 Unix epoch 毫秒，可使用数字或十进制字符串；缺失、非法或已过期时不显示。页面保持打开期间到达 `endtime` 会自动隐藏，过期判断不使用 localStorage 中的时间。内容按纯文本渲染。localStorage 仅在用户点击“已知晓”时保存包含 `endtime` 的完整公告快照，切换语言只替换当前译文，不会把同一公告误判为新公告。
 
 #### NoticeMarqueeProps
 
 | 参数 | 类型 | 默认值 | 说明 |
 | --- | --- | --- | --- |
+| `locale` | `Locale` | 浏览器语言，未知时 `en` | 外部语言选择：`en`、`ja`、`ko`、`zh-CN`、`zh-TW` |
 | `url` | `string` | `DEFAULT_NOTICE_URL` | 远程 JSON 地址，需要允许 CORS |
 | `storageKey` | `string` | `DEFAULT_NOTICE_STORAGE_KEY` | localStorage key |
 | `refreshIntervalMs` | `number` | `DEFAULT_NOTICE_REFRESH_INTERVAL_MS` | 静默刷新间隔；小于等于 0 时关闭轮询 |

package/dist/components/feedback-widget/feedback-widget.d.ts

@@ -1,4 +1,7 @@
+import * as React from 'react';
+import { type Locale } from '../../lib/locale';
 export interface FeedbackWidgetProps {
+    locale?: Locale;
     className?: string;
 }
-export declare function FeedbackWidget({ className }?: FeedbackWidgetProps): import("react").JSX.Element;
+export declare function FeedbackWidget({ locale, className }?: FeedbackWidgetProps): React.JSX.Element;

package/dist/components/notice-marquee/notice-marquee.d.ts

@@ -1,8 +1,11 @@
 import * as React from 'react';
-export declare const DEFAULT_NOTICE_URL = "https://moccasin-glad-tyrannosaurus-244.mypinata.cloud/ipfs/bafkreiavwd7xwacprggfzpdcicluvv4tzdxdfzj6brlzayxsk64upezdwa";
+import { type Locale } from '../../lib/locale';
+export declare const DEFAULT_NOTICE_URL = "https://apricot-delicate-cat-926.mypinata.cloud/ipfs/bafkreifbmbatyxthnx4k5uukq2tuirp6gwadiaicjb5zcmt4gbvmw5z624";
 export declare const DEFAULT_NOTICE_STORAGE_KEY = "@svp-chain-sdk/ui:notice-marquee";
 export declare const DEFAULT_NOTICE_REFRESH_INTERVAL_MS: number;
 export type NoticeMarqueeProps = {
+    /** External locale override. Defaults to the browser language, then English. */
+    locale?: Locale;
     /** Optional override for the SDK default multilingual JSON URL. */
     url?: string;
     /** Optional override for the localStorage key used to remember acknowledged content. */
@@ -13,8 +16,4 @@ export type NoticeMarqueeProps = {
     closeLabel?: string;
     className?: string;
 };
-/**
- * Fixed remote notice. Acknowledging persists the current payload; closing only
- * dismisses it for the current mounted page, so a browser refresh shows it again.
- */
-export declare function NoticeMarquee({ url, storageKey, refreshIntervalMs, acknowledgeLabel, closeLabel, className, }?: NoticeMarqueeProps): React.JSX.Element | null;
+export declare function NoticeMarquee({ locale, url, storageKey, refreshIntervalMs, acknowledgeLabel, closeLabel, className, }?: NoticeMarqueeProps): React.JSX.Element | null;

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { Button, buttonVariants, DEFAULT_NOTICE_REFRESH_INTERVAL_MS, DEFAULT_NOTICE_STORAGE_KEY, DEFAULT_NOTICE_URL, FeedbackWidget, NoticeMarquee, } from './components';
 export type { ButtonProps, FeedbackWidgetProps, NoticeMarqueeProps, } from './components';
+export { SUPPORTED_LOCALES, resolveLocale } from './lib/locale';
+export type { Locale } from './lib/locale';
 export { cn } from './lib/utils';
 export { ConnectWalletButton, createSvpWalletConfig, resolveSvpProvider, resolveSvpProviderForConnection, SVP_WALLET_DOWNLOAD_URL, svpTestnet, svpWallet, SvpWalletProvider, walletDefaults, walletTheme, } from './wallet';
 export type { ConnectWalletButtonProps, ConnectWalletLabels, CreateSvpWalletConfigOptions, SvpWalletProviderProps, SvpWalletDefaults, } from './wallet';