@badnpm/ui 0.0.0-stage → 0.0.1

package/dist/esm/providers/theme-provider.js

@@ -0,0 +1,178 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useState, useCallback, useLayoutEffect, useEffect, useMemo, useContext } from 'react';
+import { useHydrated } from '../hooks/use-hydrated.js';
+
+const COLOR_SCHEME_QUERY = '(prefers-color-scheme: dark)';
+const ThemeProviderContext = createContext(undefined);
+// 校验存储值，同时将类型收窄为合法的主题选项。
+function isTheme(value) {
+    return value === 'dark' || value === 'light' || value === 'system';
+}
+// 优先读取已保存的主题；值无效或存储不可用时使用默认主题。
+function readTheme(storageKey, fallback) {
+    try {
+        const value = localStorage.getItem(storageKey);
+        return isTheme(value) ? value : fallback;
+    }
+    catch {
+        // 存储不可用时回退到默认主题，不影响组件初始化。
+        return fallback;
+    }
+}
+// 持久化用户选择，存储失败时仍允许更新页面主题。
+function persistTheme(storageKey, theme) {
+    try {
+        localStorage.setItem(storageKey, theme);
+    }
+    catch {
+        // 忽略存储异常，主题仍可在当前页面内切换。
+    }
+}
+// 将用户选择解析为实际配色；system 每次读取当前系统偏好。
+function resolveTheme(theme) {
+    if (theme !== 'system') {
+        return theme;
+    }
+    return window.matchMedia(COLOR_SCHEME_QUERY).matches ? 'dark' : 'light';
+}
+// 更新根元素的主题类名，并返回清理临时样式及动画帧的函数。
+function applyTheme(theme, disableTransitionOnChange) {
+    const root = document.documentElement;
+    const resolvedTheme = resolveTheme(theme);
+    // 主题已生效且没有冲突类名时，跳过重复的 DOM 操作。
+    if (root.classList.contains(resolvedTheme) && !root.classList.contains(resolvedTheme === 'dark' ? 'light' : 'dark')) {
+        return () => { };
+    }
+    const style = disableTransitionOnChange ? document.createElement('style') : null;
+    if (style) {
+        style.textContent = '*,*::before,*::after{transition:none!important}';
+        document.head.appendChild(style);
+        // 强制浏览器计算样式，确保禁用过渡的规则先于主题切换生效。
+        window.getComputedStyle(root).getPropertyValue('transition-property');
+    }
+    root.classList.remove('light', 'dark');
+    root.classList.add(resolvedTheme);
+    if (!style) {
+        return () => { };
+    }
+    // 在禁用过渡期间计算新主题样式，再通过两次动画帧延迟移除规则。
+    window.getComputedStyle(root).getPropertyValue('color');
+    let frame = requestAnimationFrame(() => {
+        frame = requestAnimationFrame(() => style.remove());
+    });
+    // 重新应用主题或卸载时，取消待执行的帧并移除临时样式。
+    return () => {
+        cancelAnimationFrame(frame);
+        style.remove();
+    };
+}
+// 判断事件是否来自可编辑区域，避免主题快捷键干扰输入。
+function isEditableTarget(target) {
+    if (!(target instanceof HTMLElement)) {
+        return false;
+    }
+    if (target.isContentEditable) {
+        return true;
+    }
+    return target.closest('input, textarea, select') !== null;
+}
+// 统一管理主题状态、页面样式及系统和跨标签页同步。
+function ThemeProvider({ children, defaultTheme = 'system', storageKey = 'bad-ui:theme', disableTransitionOnChange = true, keyboardShortcut, }) {
+    const hydrated = useHydrated();
+    const [storedTheme, setThemeState] = useState(() => readTheme(storageKey, defaultTheme));
+    // 水合首帧与服务端一致，完成后才使用浏览器保存的主题。
+    const theme = hydrated ? storedTheme : defaultTheme;
+    // 所有主动切换共用此入口，统一更新存储和 React 状态。
+    const setTheme = useCallback((nextTheme) => {
+        persistTheme(storageKey, nextTheme);
+        setThemeState(nextTheme);
+    }, [storageKey]);
+    // 按需解析系统配色，按钮和快捷键共用同一切换逻辑。
+    const toggleTheme = useCallback(() => {
+        setTheme(resolveTheme(theme) === 'dark' ? 'light' : 'dark');
+    }, [theme, setTheme]);
+    // 水合完成后应用主题；服务端与水合首帧不访问系统配色或修改根元素。
+    useLayoutEffect(() => {
+        if (!hydrated)
+            return;
+        let cleanup = applyTheme(theme, disableTransitionOnChange);
+        const mediaQuery = window.matchMedia(COLOR_SCHEME_QUERY);
+        const handleChange = () => {
+            cleanup();
+            cleanup = applyTheme(theme, disableTransitionOnChange);
+        };
+        // 仅跟随系统时订阅配色变化；显式选择深浅色后不再跟随。
+        if (theme === 'system') {
+            mediaQuery.addEventListener('change', handleChange);
+        }
+        return () => {
+            mediaQuery.removeEventListener('change', handleChange);
+            cleanup();
+        };
+    }, [theme, disableTransitionOnChange, hydrated]);
+    useEffect(() => {
+        if (!hydrated || !keyboardShortcut)
+            return;
+        const shortcutKey = keyboardShortcut.toLowerCase();
+        // 忽略已处理事件、输入法组合和长按重复。
+        const handleKeyDown = (event) => {
+            if (event.defaultPrevented || event.isComposing || event.repeat) {
+                return;
+            }
+            if (event.metaKey || event.ctrlKey || event.altKey) {
+                return;
+            }
+            if (isEditableTarget(event.target)) {
+                return;
+            }
+            if (event.key.toLowerCase() !== shortcutKey) {
+                return;
+            }
+            toggleTheme();
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => {
+            window.removeEventListener('keydown', handleKeyDown);
+        };
+    }, [toggleTheme, hydrated, keyboardShortcut]);
+    useEffect(() => {
+        // storage 事件用于接收同源其他标签页的主题变更。
+        const handleStorageChange = (event) => {
+            if (event.storageArea !== localStorage) {
+                return;
+            }
+            // clear() 触发的事件 key 为 null，也需要回退到默认主题。
+            if (event.key !== null && event.key !== storageKey) {
+                return;
+            }
+            if (isTheme(event.newValue)) {
+                setThemeState(event.newValue);
+                return;
+            }
+            // 存储项被移除、清空或写入无效值时，恢复默认主题。
+            setThemeState(defaultTheme);
+        };
+        window.addEventListener('storage', handleStorageChange);
+        return () => {
+            window.removeEventListener('storage', handleStorageChange);
+        };
+    }, [defaultTheme, storageKey]);
+    // 保持上下文值的引用稳定，避免父组件重渲染引起无关更新。
+    const value = useMemo(() => ({
+        theme,
+        setTheme,
+        toggleTheme,
+    }), [theme, setTheme, toggleTheme]);
+    return jsx(ThemeProviderContext.Provider, { value: value, children: children });
+}
+// 获取主题上下文，并在缺少 Provider 时给出明确错误。
+const useTheme = () => {
+    const context = useContext(ThemeProviderContext);
+    if (context === undefined) {
+        throw new Error('useTheme must be used within a ThemeProvider');
+    }
+    return context;
+};
+
+export { ThemeProvider, useTheme };

package/dist/styles/custom.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */
+@layer base{::-webkit-scrollbar{width:8px;height:8px}::-webkit-scrollbar-track{background:0 0}::-webkit-scrollbar-thumb{background-color:var(--muted-foreground);background-clip:content-box;border:1px solid #0000;border-radius:9999px}::-webkit-scrollbar-thumb:hover{background-color:var(--accent-foreground)}::-webkit-scrollbar-corner{background-color:#0000}.hidden-scrollbar::-webkit-scrollbar{width:16px;height:16px}.hidden-scrollbar::-webkit-scrollbar-track{background:var(--primary)}body{background-color:var(--background);color:var(--foreground)}}

package/dist/styles/font/LICENSE

@@ -0,0 +1,93 @@
+Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font) Geist-Italic[wght].ttf: Copyright 2024 The Geist Project Authors (https://github.com/vercel/geist-font)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/styles/font/geist.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */
+@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(files/ba1a9b92.woff2)format("woff2-variations");unicode-range:U+460-52F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(files/aa4aa22f.woff2)format("woff2-variations");unicode-range:U+301,U+400-45F,U+490-491,U+4B0-4B1,U+2116}@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(files/11944884.woff2)format("woff2-variations");unicode-range:U+102-103,U+110-111,U+128-129,U+168-169,U+1A0-1A1,U+1AF-1B0,U+300-301,U+303-304,U+308-309,U+323,U+329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(files/eadd8e6c.woff2)format("woff2-variations");unicode-range:U+100-2BA,U+2BD-2C5,U+2C7-2CC,U+2CE-2D7,U+2DD-2FF,U+304,U+308,U+329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(files/3f081d19.woff2)format("woff2-variations");unicode-range:U+??,U+131,U+152-153,U+2BB-2BC,U+2C6,U+2DA,U+2DC,U+304,U+308,U+329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@layer theme{:root{--font-sans:"Geist Variable", sans-serif;--default-font-family:var(--font-sans)}}