tango-ui-cw 1.0.10 → 1.2.0

package/dist/providers/NoticeProvider/NoticeProvider.d.ts

@@ -1,19 +1,43 @@
-import type { PropsWithChildren, ReactNode } from "react";
-
-export type NoticeType = "success" | "fail" | "caution";
-export type NoticeVariant = "default" | "md";
-
-export interface NoticeApi {
-  success: (message: ReactNode) => void;
-  fail: (message: ReactNode) => void;
-  caution: (message: ReactNode) => void;
-  md: {
-    success: (message: ReactNode) => void;
-    fail: (message: ReactNode) => void;
-    caution: (message: ReactNode) => void;
-  };
-}
-
-export declare function NoticeProvider(props: PropsWithChildren): JSX.Element;
-
-export declare function useNotice(): NoticeApi;
+import type { PropsWithChildren, ReactNode } from "react";
+
+export type NoticeType = "success" | "fail" | "caution";
+export type NoticeVariant = "default" | "md";
+// added by clayw on 20260624: placement 四角位置类型（大小写均可）
+export type NoticePlacement = "TL" | "TR" | "BL" | "BR" | "tl" | "tr" | "bl" | "br";
+
+// added by clayw on 20260624: useNotice 调用 options 参数
+export interface NoticeCallOptions {
+  variant?: NoticeVariant;
+  duration?: number;
+  placement?: NoticePlacement;
+  key?: string;
+}
+
+// added by clayw on 20260624: useNotice 支持 per-call duration/placement/key
+export interface NoticeApi {
+  success: (message: ReactNode, optionsOrDuration?: NoticeCallOptions | number) => void;
+  fail: (message: ReactNode, optionsOrDuration?: NoticeCallOptions | number) => void;
+  caution: (message: ReactNode, optionsOrDuration?: NoticeCallOptions | number) => void;
+  md: {
+    success: (message: ReactNode, options?: NoticeCallOptions) => void;
+    fail: (message: ReactNode, options?: NoticeCallOptions) => void;
+    caution: (message: ReactNode, options?: NoticeCallOptions) => void;
+  };
+}
+
+// added by clayw on 20260624: NoticeProvider 支持 maxCount
+export interface NoticeProviderProps {
+  children?: ReactNode;
+  maxCount?: number;
+}
+
+export declare function NoticeProvider(props: PropsWithChildren<NoticeProviderProps>): JSX.Element;
+
+export declare function useNotice(): NoticeApi;
+
+export interface NoticeContextApi {
+  add: (type: NoticeType, message: ReactNode, optionsOrVariant?: NoticeCallOptions | NoticeVariant | number) => void;
+  remove: (id: number) => void;
+}
+
+export declare function useNoticeContext(): NoticeContextApi;

package/dist/providers/TangoI18nProvider/TangoI18nProvider.d.ts

@@ -1,28 +1,28 @@
-import type { PropsWithChildren } from "react";
-
-export type TangoLocale = "zh-CN" | "en-US" | (string & {});
-
-export type TangoMessages = Record<string, Record<string, unknown>>;
-
-export interface TangoI18nContextValue {
-  locale: TangoLocale;
-  setLocale: (nextLocale: TangoLocale) => void;
-  toggleLocale: () => void;
-  messages: TangoMessages;
-  t: (key: string, fallback?: string) => string;
-}
-
-export interface TangoI18nProviderProps extends PropsWithChildren {
-  locale?: TangoLocale;
-  defaultLocale?: TangoLocale;
-  onLocaleChange?: (nextLocale: TangoLocale) => void;
-  messages?: TangoMessages;
-}
-
-export declare function TangoI18nProvider(
-  props: TangoI18nProviderProps
-): JSX.Element;
-
-export declare function useTangoI18n(): TangoI18nContextValue;
-
+import type { PropsWithChildren } from "react";
+
+export type TangoLocale = "zh-CN" | "en-US" | (string & {});
+
+export type TangoMessages = Record<string, Record<string, unknown>>;
+
+export interface TangoI18nContextValue {
+  locale: TangoLocale;
+  setLocale: (nextLocale: TangoLocale) => void;
+  toggleLocale: () => void;
+  messages: TangoMessages;
+  t: (key: string, fallback?: string) => string;
+}
+
+export interface TangoI18nProviderProps extends PropsWithChildren {
+  locale?: TangoLocale;
+  defaultLocale?: TangoLocale;
+  onLocaleChange?: (nextLocale: TangoLocale) => void;
+  messages?: TangoMessages;
+}
+
+export declare function TangoI18nProvider(
+  props: TangoI18nProviderProps
+): JSX.Element;
+
+export declare function useTangoI18n(): TangoI18nContextValue;
+
 export declare function normalizeTangoLocale(locale: TangoLocale): TangoLocale;

package/dist/providers/ThemeProvider/ThemeProvider.d.ts

@@ -1,22 +1,22 @@
-import type { PropsWithChildren } from "react";
-
-export type ThemeMode = "light" | "dark";
-export type ThemeTokens = Record<string, string>;
-
-export interface ThemeContextValue {
-  theme: ThemeMode;
-  setTheme: (nextTheme: ThemeMode) => void;
-  toggleTheme: () => void;
-  themeTokens: ThemeTokens;
-  setThemeTokens: (
-    nextTokensOrUpdater:
-      | ThemeTokens
-      | ((previousTokens: ThemeTokens) => ThemeTokens)
-  ) => void;
-  setThemeColor: (color: string, tokenList?: string[]) => void;
-  resetThemeTokens: () => void;
-}
-
-export declare function ThemeProvider(props: PropsWithChildren): JSX.Element;
-
+import type { PropsWithChildren } from "react";
+
+export type ThemeMode = "light" | "dark";
+export type ThemeTokens = Record<string, string>;
+
+export interface ThemeContextValue {
+  theme: ThemeMode;
+  setTheme: (nextTheme: ThemeMode) => void;
+  toggleTheme: () => void;
+  themeTokens: ThemeTokens;
+  setThemeTokens: (
+    nextTokensOrUpdater:
+      | ThemeTokens
+      | ((previousTokens: ThemeTokens) => ThemeTokens)
+  ) => void;
+  setThemeColor: (color: string, tokenList?: string[]) => void;
+  resetThemeTokens: () => void;
+}
+
+export declare function ThemeProvider(props: PropsWithChildren): JSX.Element;
+
 export declare function useTheme(): ThemeContextValue;

package/dist/scripts/check-peers.js

@@ -1,82 +1,82 @@
-#!/usr/bin/env node
-
-/**
- * tango-ui-cw postinstall peer-dependency checker
- * Per NPM-Summary.md §10.3, warns if required peers are missing.
- *
- * Gracefully skips if the dist/ build output doesn't exist yet
- * (e.g. during `npm install` in the library's own repo before first build).
- */
-
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { createRequire } from "module";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// If dist/index.js doesn't exist, we're in a pre-build state — skip silently.
-const distEntry = path.resolve(__dirname, "..", "index.js");
-if (!fs.existsSync(distEntry)) {
-  process.exit(0);
-}
-
-const require = createRequire(import.meta.url);
-
-const REQUIRED_PEERS = [
-  { name: "react", range: ">=18", hint: "React 18+ is required." },
-  { name: "react-dom", range: ">=18", hint: "ReactDOM 18+ is required." },
-  { name: "next", range: ">=14", hint: "Next.js 14+ is required for SSR/SSG components." },
-  { name: "tailwind-merge", range: "^3.6.0", hint: "tailwind-merge ^3.6.0 is required for class merging." },
-  { name: "tailwindcss", range: "^4", hint: "Tailwind CSS v4 is required for utility classes." },
-];
-
-function getVersion(name) {
-  try {
-    const resolved = require.resolve(`${name}/package.json`, { paths: [process.cwd()] });
-    const pkg = require(resolved);
-    return pkg.version;
-  } catch {
-    return null;
-  }
-}
-
-function satisfies(version, range) {
-  if (!version) return false;
-  const major = parseInt(version.split(".")[0], 10);
-  if (range.startsWith(">=")) {
-    const min = parseInt(range.replace(">=", ""), 10);
-    return major >= min;
-  }
-  if (range.startsWith("^")) {
-    const min = parseInt(range.replace("^", "").split(".")[0], 10);
-    return major >= min;
-  }
-  return true;
-}
-
-let hasMissing = false;
-
-for (const peer of REQUIRED_PEERS) {
-  const version = getVersion(peer.name);
-  if (!version) {
-    console.warn(
-      `[tango-ui-cw] ⚠️  Peer dependency "${peer.name}" (${peer.range}) is not installed. ${peer.hint}`
-    );
-    hasMissing = true;
-  } else if (!satisfies(version, peer.range)) {
-    console.warn(
-      `[tango-ui-cw] ⚠️  Peer dependency "${peer.name}@${version}" does not satisfy "${peer.range}". ${peer.hint}`
-    );
-    hasMissing = true;
-  }
-}
-
-if (hasMissing) {
-  console.warn(
-    `[tango-ui-cw] Some peer dependencies are missing or incompatible. The library may not work correctly.`
-  );
-} else {
-  console.log(`[tango-ui-cw] ✅ All peer dependencies are satisfied.`);
-}
+#!/usr/bin/env node
+
+/**
+ * tango-ui-cw postinstall peer-dependency checker
+ * Per NPM-Summary.md §10.3, warns if required peers are missing.
+ *
+ * Gracefully skips if the dist/ build output doesn't exist yet
+ * (e.g. during `npm install` in the library's own repo before first build).
+ */
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// If dist/index.js doesn't exist, we're in a pre-build state — skip silently.
+const distEntry = path.resolve(__dirname, "..", "index.js");
+if (!fs.existsSync(distEntry)) {
+  process.exit(0);
+}
+
+const require = createRequire(import.meta.url);
+
+const REQUIRED_PEERS = [
+  { name: "react", range: ">=18", hint: "React 18+ is required." },
+  { name: "react-dom", range: ">=18", hint: "ReactDOM 18+ is required." },
+  { name: "next", range: ">=14", hint: "Next.js 14+ is required for SSR/SSG components." },
+  { name: "tailwind-merge", range: "^3.6.0", hint: "tailwind-merge ^3.6.0 is required for class merging." },
+  { name: "tailwindcss", range: "^4", hint: "Tailwind CSS v4 is required for utility classes." },
+];
+
+function getVersion(name) {
+  try {
+    const resolved = require.resolve(`${name}/package.json`, { paths: [process.cwd()] });
+    const pkg = require(resolved);
+    return pkg.version;
+  } catch {
+    return null;
+  }
+}
+
+function satisfies(version, range) {
+  if (!version) return false;
+  const major = parseInt(version.split(".")[0], 10);
+  if (range.startsWith(">=")) {
+    const min = parseInt(range.replace(">=", ""), 10);
+    return major >= min;
+  }
+  if (range.startsWith("^")) {
+    const min = parseInt(range.replace("^", "").split(".")[0], 10);
+    return major >= min;
+  }
+  return true;
+}
+
+let hasMissing = false;
+
+for (const peer of REQUIRED_PEERS) {
+  const version = getVersion(peer.name);
+  if (!version) {
+    console.warn(
+      `[tango-ui-cw] ⚠️  Peer dependency "${peer.name}" (${peer.range}) is not installed. ${peer.hint}`
+    );
+    hasMissing = true;
+  } else if (!satisfies(version, peer.range)) {
+    console.warn(
+      `[tango-ui-cw] ⚠️  Peer dependency "${peer.name}@${version}" does not satisfy "${peer.range}". ${peer.hint}`
+    );
+    hasMissing = true;
+  }
+}
+
+if (hasMissing) {
+  console.warn(
+    `[tango-ui-cw] Some peer dependencies are missing or incompatible. The library may not work correctly.`
+  );
+} else {
+  console.log(`[tango-ui-cw] ✅ All peer dependencies are satisfied.`);
+}