uitheme-web 1.2.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +56 -314
- package/dist/chunk-4UXANDJ5.cjs +26 -0
- package/dist/chunk-C4YNAGUP.js +26 -0
- package/dist/chunk-CTNYTI5Q.js +1 -0
- package/dist/{chunk-WFG34KG5.js → chunk-CY5E6WU4.js} +3 -3
- package/dist/chunk-CYGYUQUK.cjs +1 -0
- package/dist/chunk-EKVKQZNN.js +12 -0
- package/dist/chunk-EQPK72XK.js +14 -0
- package/dist/{chunk-W4YFUPGE.cjs → chunk-I5GA5T23.cjs} +3 -3
- package/dist/chunk-KQSBORXP.cjs +12 -0
- package/dist/chunk-NDNCNR4X.js +1 -0
- package/dist/chunk-SO3CO44A.js +1 -0
- package/dist/{constants-DmZ7yAIL.d.cts → constants-9M8X-rnX.d.cts} +2 -68
- package/dist/{constants-DmZ7yAIL.d.ts → constants-PAa1nGZ0.d.ts} +2 -68
- package/dist/controller-83zmHd-p.d.cts +76 -0
- package/dist/controller-DnMwV2nl.d.ts +76 -0
- package/dist/core/index.cjs +1 -1
- package/dist/core/index.d.cts +7 -5
- package/dist/core/index.d.ts +7 -5
- package/dist/core/index.js +1 -1
- package/dist/index-Dn3XRBX1.d.ts +106 -0
- package/dist/index-DqlTGyMr.d.cts +106 -0
- package/dist/next/index.cjs +2 -0
- package/dist/next/index.d.cts +4 -0
- package/dist/next/index.d.ts +4 -0
- package/dist/next/index.js +2 -0
- package/dist/nuxt.d.ts +10 -0
- package/dist/nuxt.js +34 -0
- package/dist/react/index.cjs +11 -89
- package/dist/react/index.d.cts +23 -279
- package/dist/react/index.d.ts +23 -279
- package/dist/react/index.js +11 -89
- package/dist/server/index.cjs +14 -0
- package/dist/server/index.d.cts +11 -0
- package/dist/server/index.d.ts +11 -0
- package/dist/server/index.js +14 -0
- package/dist/tanstack/index.cjs +1 -1
- package/dist/tanstack/index.d.cts +5 -3
- package/dist/tanstack/index.d.ts +5 -3
- package/dist/tanstack/index.js +1 -1
- package/dist/types-CrR56NLm.d.cts +79 -0
- package/dist/types-CrR56NLm.d.ts +79 -0
- package/dist/types-Dd4EU8V9.d.ts +96 -0
- package/dist/vue/bootstrap.d.ts +13 -0
- package/dist/vue/bootstrap.js +1 -0
- package/dist/vue/index.d.ts +39 -0
- package/dist/vue/index.js +1 -0
- package/package.json +68 -17
- package/dist/chunk-DFJEYTIW.js +0 -12
- package/dist/chunk-V3LMT5IJ.cjs +0 -12
- package/dist/cli/index.js +0 -39
package/README.md
CHANGED
|
@@ -1,357 +1,99 @@
|
|
|
1
1
|
# uitheme-web
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
https://github.com/user-attachments/assets/2819cf70-c474-478e-b821-6b26457c8d4a
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Animated light and dark mode for your web app, with support for color themes
|
|
6
|
+
when one look isn't enough, so one app can carry several design systems. The
|
|
7
|
+
controls come ready-made from the registry, installed via its CLI (or the shadcn
|
|
8
|
+
CLI).
|
|
6
9
|
|
|
7
|
-
|
|
10
|
+
- Light, dark and system modes
|
|
11
|
+
- Color palettes that work on top of either mode
|
|
12
|
+
- Seven built-in transitions, powered by the View Transitions API
|
|
13
|
+
- Respects reduced motion, and falls back gracefully in older browsers
|
|
14
|
+
- No flash on load with Next.js, TanStack Start and Nuxt
|
|
15
|
+
- Remembers the choice and syncs it across tabs
|
|
16
|
+
- React, Next.js, TanStack Start, Vue and Nuxt from one package
|
|
17
|
+
- No Tailwind or design system required
|
|
8
18
|
|
|
9
|
-
|
|
19
|
+
Try it on [ui-theme.dev](https://www.ui-theme.dev).
|
|
10
20
|
|
|
11
|
-
|
|
12
|
-
npm install uitheme-web
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
pnpm add uitheme-web
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
yarn add uitheme-web
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## Migrating from `@ui-theme/web`
|
|
24
|
-
|
|
25
|
-
This package was published under the name `@ui-theme/web` before the rename. That name is deprecated. Run the migration command to move a project across:
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
npx uitheme-web migrate
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
The command lists the files it will change and asks for confirmation. It then rewrites the import specifiers, the Tailwind `@source` path, and the dependency in `package.json`. The entry point names stay the same, so `/core`, `/react` and `/tanstack` are unchanged.
|
|
32
|
-
|
|
33
|
-
| Option | Effect |
|
|
34
|
-
| ------------- | --------------------------------------- |
|
|
35
|
-
| `--yes` | Rewrite without asking for confirmation |
|
|
36
|
-
| `--cwd <dir>` | Work on a project in another directory |
|
|
37
|
-
| `--help` | Show the help |
|
|
21
|
+
## Install
|
|
38
22
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
## Tailwind Setup For Prebuilt Components
|
|
42
|
-
|
|
43
|
-
`UIThemeSwitcher`, `UIThemeSelector`, and the bundled select primitives use Tailwind utility classes. `uitheme-web` does not ship a compiled CSS file for those components, so the consuming app must include the package in Tailwind's source scan.
|
|
44
|
-
|
|
45
|
-
For Tailwind v4, add an `@source` directive next to your Tailwind import:
|
|
46
|
-
|
|
47
|
-
```css
|
|
48
|
-
@import 'tailwindcss';
|
|
49
|
-
@source '../node_modules/uitheme-web/dist';
|
|
23
|
+
```sh
|
|
24
|
+
npm install uitheme-web
|
|
50
25
|
```
|
|
51
26
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
If you are using the prebuilt components without this setup, the controls will mount but the expected borders, spacing, typography, hover states, and dropdown styling will be missing because Tailwind never sees the classes inside the installed package.
|
|
55
|
-
|
|
56
|
-
## Provider Selection
|
|
57
|
-
|
|
58
|
-
Choose the right provider for your framework:
|
|
59
|
-
|
|
60
|
-
| Provider | Best For | Key Features |
|
|
61
|
-
| ----------------------- | ------------------------------ | ------------------------------------------------ |
|
|
62
|
-
| UIThemeProvider | All React apps | Universal provider with full feature set |
|
|
63
|
-
| NextUIThemeProvider | Next.js, Remix, SSR frameworks | Pre-hydration script, CSP support, animations |
|
|
64
|
-
| TanStackUIThemeProvider | TanStack Start apps | Isomorphic rendering, useHydrated() integration |
|
|
65
|
-
| ViteUIThemeProvider | Vite React SPAs | Lightweight, transition control, no SSR overhead |
|
|
66
|
-
|
|
67
|
-
## Quick Start
|
|
68
|
-
|
|
69
|
-
### React
|
|
27
|
+
## Use
|
|
70
28
|
|
|
71
|
-
|
|
29
|
+
Wrap your app in the provider, and choose a transition:
|
|
72
30
|
|
|
73
31
|
```tsx
|
|
74
|
-
import { UIThemeProvider
|
|
32
|
+
import { UIThemeProvider } from 'uitheme-web/react';
|
|
75
33
|
|
|
76
|
-
function App() {
|
|
34
|
+
export function App() {
|
|
77
35
|
return (
|
|
78
|
-
<UIThemeProvider
|
|
36
|
+
<UIThemeProvider animationType="slide">
|
|
79
37
|
<YourApp />
|
|
80
38
|
</UIThemeProvider>
|
|
81
39
|
);
|
|
82
40
|
}
|
|
83
|
-
|
|
84
|
-
function ThemeToggle() {
|
|
85
|
-
const { theme, toggleTheme, ref } = useUITheme();
|
|
86
|
-
|
|
87
|
-
return (
|
|
88
|
-
<button ref={ref} onClick={() => toggleTheme()}>
|
|
89
|
-
{theme === 'light' ? 'Dark' : 'Light'}
|
|
90
|
-
</button>
|
|
91
|
-
);
|
|
92
|
-
}
|
|
93
41
|
```
|
|
94
42
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
- [Next.js / SSR Setup Guide](../../docs/nextjs-setup.md) - Complete guide with App Router, Pages Router, CSP support
|
|
98
|
-
- [TanStack Start Setup Guide](../../docs/tanstack-start-setup.md) - Isomorphic rendering, hydration-safe patterns
|
|
99
|
-
- [Vite React SPA Setup Guide](../../docs/vite-setup.md) - Client-side setup, flash prevention, routing
|
|
100
|
-
|
|
101
|
-
## Animated mode and palette changes
|
|
102
|
-
|
|
103
|
-
Use `switchColorTheme`, `toggleColorTheme`, or `createColorThemeToggle` for animated palettes. `setTheme` and `setColorTheme` remain immediate setters. Every provider and the standalone hook accepts the same transition options:
|
|
43
|
+
Then switch themes from anywhere:
|
|
104
44
|
|
|
105
45
|
```tsx
|
|
106
|
-
|
|
107
|
-
colorThemes: ['default', 'ocean', 'rose'],
|
|
108
|
-
});
|
|
109
|
-
|
|
110
|
-
<button onClick={(event) => void toggleTheme({
|
|
111
|
-
element: event.currentTarget,
|
|
112
|
-
animationOff: event.detail === 0,
|
|
113
|
-
})}>Toggle mode</button>
|
|
114
|
-
|
|
115
|
-
<button onClick={(event) => void switchColorTheme('ocean', {
|
|
116
|
-
element: event.currentTarget,
|
|
117
|
-
animationOff: event.detail === 0,
|
|
118
|
-
})}>Ocean palette</button>
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
`element` uses the trigger's center. `origin: { x, y }` overrides it with viewport-relative **CSS pixels**, without multiplying by `devicePixelRatio`. Without either option, the hook uses its existing button `ref`; attach a shared ref to only one trigger. Slide transitions need no trigger. Boolean calls such as `toggleTheme(true)` still disable animation.
|
|
122
|
-
|
|
123
|
-
`ThemeTransitionInput` is `boolean | { element?: Element | null; origin?: { x: number; y: number }; animationOff?: boolean }`. Color helpers now return `Promise<void>`; existing fire-and-forget calls still work. `toggleColorTheme` and `createColorThemeToggle('ocean')` can be used directly as `onClick`, reading the clicked element and skipping keyboard motion.
|
|
124
|
-
|
|
125
|
-
The default is 400 ms with `cubic-bezier(0.32, 0.72, 0, 1)`: a steep curve for a full-viewport reveal. Explicit durations are respected at every display size. `blurAmount` is now a feather width in CSS pixels, capped at 20 px; the gradient softens the edge without blurring the page content. Unsupported browsers, failed/skipped captures, missing circle origins, and reduced motion apply the theme without a reveal. New requests interrupt older transitions; CSS transitions are suppressed only during library-owned captures and playback.
|
|
126
|
-
|
|
127
|
-
Core consumers can call `runThemeTransition(update, config)` to handle capture, scoped styles, interruption, and cleanup. The React hook uses this runner internally. Low-level animation helpers should be called **after** `transition.ready` with caller-managed pseudo-element styles. They return native `Animation` handles; cancel them when done. `styleId` remains accepted for compatibility; the native animation path no longer creates a timer-owned stylesheet with that ID.
|
|
128
|
-
|
|
129
|
-
[Research, browser verification, and performance evidence](../../docs/theme-transition-verification.md).
|
|
130
|
-
|
|
131
|
-
## API Reference
|
|
132
|
-
|
|
133
|
-
### Shared Hook Return (All Providers)
|
|
134
|
-
|
|
135
|
-
All providers expose the same hook interface:
|
|
136
|
-
|
|
137
|
-
| Property | Type | Description |
|
|
138
|
-
| ---------------------- | --------------------------------------------------------------------- | ---------------------------------- |
|
|
139
|
-
| theme | Theme | Current theme |
|
|
140
|
-
| colorTheme | ColorTheme | Current color theme |
|
|
141
|
-
| resolvedTheme | 'light' \| 'dark' | Resolved theme (system → actual) |
|
|
142
|
-
| systemTheme | 'light' \| 'dark' | OS theme preference |
|
|
143
|
-
| ref | RefObject<HTMLElement> | Ref for animation origin |
|
|
144
|
-
| setTheme | (theme: Theme) => void | Set theme instantly |
|
|
145
|
-
| setColorTheme | (colorTheme: ColorTheme) => void | Set color theme |
|
|
146
|
-
| switchTheme | (theme: Theme, options?: ThemeTransitionInput) => Promise<void> | Switch with animation |
|
|
147
|
-
| switchColorTheme | (colorTheme: string, options?: ThemeTransitionInput) => Promise<void> | Switch color theme with animation |
|
|
148
|
-
| toggleTheme | (options?: ThemeTransitionInput) => Promise<void> | Toggle light/dark |
|
|
149
|
-
| toggleLightTheme | (options?: ThemeTransitionInput) => Promise<void> | Toggle to light |
|
|
150
|
-
| toggleDarkTheme | (options?: ThemeTransitionInput) => Promise<void> | Toggle to dark |
|
|
151
|
-
| toggleColorTheme | ColorThemeToggle | Toggle between color themes |
|
|
152
|
-
| createColorThemeToggle | (colorTheme: string) => ColorThemeToggle | Create color theme toggle |
|
|
153
|
-
| isColorThemeActive | (colorTheme: string) => boolean | Check if color theme active |
|
|
154
|
-
| switchThemeFromElement | (theme: Theme, element: HTMLElement) => Promise<void> | Switch with animation from element |
|
|
155
|
-
|
|
156
|
-
### Provider Props
|
|
46
|
+
import { useUITheme } from 'uitheme-web/react';
|
|
157
47
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
| defaultTheme | ✓ | ✓ | ✓ | ✓ | Theme | 'system' |
|
|
161
|
-
| defaultColorTheme | ✓ | ✓ | ✓ | ✓ | ColorTheme | 'default' |
|
|
162
|
-
| themes | ✓ | ✓ | ✓ | ✓ | Theme[] | ['light', 'dark', 'system'] |
|
|
163
|
-
| colorThemes | ✓ | ✓ | ✓ | ✓ | ColorTheme[] | ['default'] |
|
|
164
|
-
| animationType | ✓ | ✓ | ✓ | ✓ | ThemeAnimationType | CIRCLE |
|
|
165
|
-
| clipPathDirection | ✓ | ✓ | ✓ | ✓ | TransitionDirection | 'top-left' |
|
|
166
|
-
| animationPosition | ✓ | ✓ | ✓ | ✓ | AnimationPosition | trigger / center fallback |
|
|
167
|
-
| logo | ✓ | ✓ | ✓ | ✓ | string (SVG URL) | - |
|
|
168
|
-
| logoWidth | ✓ | ✓ | ✓ | ✓ | number or "auto" | 96 / aspect ratio |
|
|
169
|
-
| logoHeight | ✓ | ✓ | ✓ | ✓ | number or "auto" | aspect ratio |
|
|
170
|
-
| gradientWidth | ✓ | ✓ | ✓ | ✓ | number (CSS px) | 80 |
|
|
171
|
-
| duration | ✓ | ✓ | ✓ | ✓ | number | 400 |
|
|
172
|
-
| storageKey | ✓ | ✓ | ✓ | ✓ | string | varies |
|
|
173
|
-
| colorStorageKey | ✓ | ✓ | ✓ | ✓ | string | varies |
|
|
174
|
-
| nonce | ✗ | ✓ | ✗ | ✗ | string | - |
|
|
175
|
-
| disablePreHydrationScript | ✗ | ✓ | ✗ | ✗ | boolean | false |
|
|
176
|
-
| disableTransitionOnChange | ✗ | ✗ | ✗ | ✓ | boolean | false |
|
|
177
|
-
| onThemeChange | ✓ | ✓ | ✓ | ✓ | function | - |
|
|
178
|
-
| onColorThemeChange | ✓ | ✓ | ✓ | ✓ | function | - |
|
|
179
|
-
|
|
180
|
-
### Components
|
|
181
|
-
|
|
182
|
-
**UIThemeSwitcher**: Pre-built theme toggle buttons with animations
|
|
183
|
-
**UIThemeSelector**: Dropdown selector for color themes
|
|
184
|
-
|
|
185
|
-
See framework-specific guides for component usage examples.
|
|
186
|
-
|
|
187
|
-
---
|
|
188
|
-
|
|
189
|
-
<details>
|
|
190
|
-
<summary>CSS Variables Setup</summary>
|
|
191
|
-
|
|
192
|
-
Define theme variables in your global CSS file:
|
|
193
|
-
|
|
194
|
-
```css
|
|
195
|
-
:root {
|
|
196
|
-
--background: 0 0% 100%;
|
|
197
|
-
--foreground: 222.2 84% 4.9%;
|
|
198
|
-
--primary: 221.2 83.2% 53.3%;
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
.dark {
|
|
202
|
-
--background: 222.2 84% 4.9%;
|
|
203
|
-
--foreground: 210 40% 98%;
|
|
204
|
-
--primary: 217.2 91.2% 59.8%;
|
|
205
|
-
}
|
|
206
|
-
|
|
207
|
-
/* Color theme variants */
|
|
208
|
-
.theme-blue {
|
|
209
|
-
--primary: 221.2 83.2% 53.3%;
|
|
210
|
-
}
|
|
211
|
-
|
|
212
|
-
.theme-blue.dark {
|
|
213
|
-
--primary: 217.2 91.2% 59.8%;
|
|
214
|
-
}
|
|
215
|
-
|
|
216
|
-
.theme-green {
|
|
217
|
-
--primary: 142.1 76.2% 36.3%;
|
|
218
|
-
}
|
|
48
|
+
function ThemeToggle() {
|
|
49
|
+
const { resolvedTheme, switchTheme } = useUITheme();
|
|
219
50
|
|
|
220
|
-
|
|
221
|
-
|
|
51
|
+
return (
|
|
52
|
+
<button
|
|
53
|
+
onClick={() => switchTheme(resolvedTheme === 'dark' ? 'light' : 'dark')}
|
|
54
|
+
>
|
|
55
|
+
Toggle theme
|
|
56
|
+
</button>
|
|
57
|
+
);
|
|
222
58
|
}
|
|
223
59
|
```
|
|
224
60
|
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
<details>
|
|
228
|
-
<summary>Browser Support</summary>
|
|
229
|
-
|
|
230
|
-
- Animated reveals require View Transitions and animation of transition pseudo-elements.
|
|
231
|
-
- Fallback: unsupported browsers apply the theme immediately.
|
|
232
|
-
- Reduced Motion: Respects prefers-reduced-motion
|
|
233
|
-
- Framework Support: React 18+
|
|
234
|
-
|
|
235
|
-
</details>
|
|
236
|
-
|
|
237
|
-
<details>
|
|
238
|
-
<summary>Advanced Configuration</summary>
|
|
239
|
-
|
|
240
|
-
### Animation Control
|
|
241
|
-
|
|
242
|
-
Choose `CIRCLE`, `BLUR_CIRCLE`, `SLIDE`, `CLIP_PATH`, `POLYGON_GRADIENT`,
|
|
243
|
-
`TRIANGLE`, or `SVG_LOGO` from `ThemeAnimationType`. All effects also apply to
|
|
244
|
-
animated color-palette changes. GIF effects are not included.
|
|
245
|
-
|
|
246
|
-
```tsx
|
|
247
|
-
import { ThemeAnimationType, UIThemeProvider } from 'uitheme-web/react';
|
|
248
|
-
|
|
249
|
-
<UIThemeProvider
|
|
250
|
-
animationType={ThemeAnimationType.CLIP_PATH}
|
|
251
|
-
clipPathDirection="top-right"
|
|
252
|
-
duration={400}
|
|
253
|
-
>
|
|
254
|
-
<App />
|
|
255
|
-
</UIThemeProvider>;
|
|
256
|
-
```
|
|
257
|
-
|
|
258
|
-
`CLIP_PATH` is a sharp polygon wipe; `POLYGON_GRADIENT` feathers its leading edge.
|
|
259
|
-
Both accept `clipPathDirection` in clockwise order: `top-left`, `top`,
|
|
260
|
-
`top-right`, `right`, `bottom-right`, `bottom`, `bottom-left`, `left`.
|
|
261
|
-
`POLYGON_GRADIENT` also accepts `gradientWidth` (default: 80 CSS pixels, capped
|
|
262
|
-
relative to the mask size).
|
|
263
|
-
|
|
264
|
-
For circle, blurred circle, or triangle effects, `animationPosition` can be
|
|
265
|
-
any of those eight positions, `center`, or `trigger`. The trigger uses the clicked
|
|
266
|
-
element or attached ref. Triangle effects fall back to the viewport
|
|
267
|
-
center when no trigger is available. An explicit per-call `origin` takes precedence.
|
|
61
|
+
That's it. Style dark mode with the `dark` class, like you already do.
|
|
268
62
|
|
|
269
|
-
|
|
63
|
+
## Don't want to build the toggle?
|
|
270
64
|
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
the viewport center while a circular theme reveal expands underneath it. The
|
|
274
|
-
logo stays still and fades out over the final 15% of the transition.
|
|
65
|
+
Grab a ready-made one. The CLI sets up the provider and drops the control
|
|
66
|
+
straight into your codebase, so it's yours to tweak:
|
|
275
67
|
|
|
276
|
-
```
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
logo="/brand.svg"
|
|
280
|
-
logoWidth={120}
|
|
281
|
-
duration={600}
|
|
282
|
-
>
|
|
283
|
-
<App />
|
|
284
|
-
</UIThemeProvider>
|
|
68
|
+
```sh
|
|
69
|
+
npx uitheme-cli init
|
|
70
|
+
npx uitheme-cli add theme-toggle
|
|
285
71
|
```
|
|
286
72
|
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
`object-fit: contain`. Without either, width defaults to 96 px. The SVG effect
|
|
290
|
-
always uses the viewport center, including when a trigger or another animation
|
|
291
|
-
position is provided. The logo retains its artwork colors.
|
|
73
|
+
Already on shadcn? [Add the registry](https://www.ui-theme.dev/docs/installation#install-with-shadcn)
|
|
74
|
+
and use `npx shadcn@latest add @uitheme/theme-toggle`.
|
|
292
75
|
|
|
293
|
-
|
|
294
|
-
invalid, unavailable, or not an SVG, that toggle uses the circle effect instead
|
|
295
|
-
of waiting. Core consumers can `await preloadThemeLogo(url)` before starting a
|
|
296
|
-
transition. Use transparent backgrounds and a suitable `viewBox`; preserve the
|
|
297
|
-
logo's intrinsic aspect ratio. SVG markup is loaded as an image, never inserted
|
|
298
|
-
into the page.
|
|
76
|
+
[Browse all the controls →](https://www.ui-theme.dev/docs/components)
|
|
299
77
|
|
|
300
|
-
|
|
301
|
-
`UIThemeSelector`. Reduced motion applies the theme immediately.
|
|
78
|
+
## Using another framework?
|
|
302
79
|
|
|
303
|
-
|
|
304
|
-
|
|
80
|
+
Each one has a short guide:
|
|
81
|
+
[Next.js](https://www.ui-theme.dev/docs/guides/nextjs) ·
|
|
82
|
+
[TanStack Start](https://www.ui-theme.dev/docs/guides/tanstack-start) ·
|
|
83
|
+
[Vue](https://www.ui-theme.dev/docs/guides/vue) ·
|
|
84
|
+
[Nuxt](https://www.ui-theme.dev/docs/guides/nuxt)
|
|
305
85
|
|
|
306
|
-
|
|
307
|
-
|
|
86
|
+
Building for mobile? Check out
|
|
87
|
+
[`uitheme-rn`](https://www.npmjs.com/package/uitheme-rn) for React Native.
|
|
308
88
|
|
|
309
|
-
|
|
310
|
-
|
|
89
|
+
Coming from v1? The [migration guide](https://www.ui-theme.dev/docs/migration)
|
|
90
|
+
walks you through it.
|
|
311
91
|
|
|
312
|
-
|
|
313
|
-
await switchTheme('dark', true);
|
|
314
|
-
await toggleTheme(true);
|
|
315
|
-
```
|
|
92
|
+
## Documentation
|
|
316
93
|
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
```tsx
|
|
320
|
-
import { useTheme } from 'uitheme-web/react';
|
|
321
|
-
|
|
322
|
-
const { theme, toggleTheme, ref } = useTheme({
|
|
323
|
-
animationType: ThemeAnimationType.BLUR_CIRCLE,
|
|
324
|
-
duration: 750,
|
|
325
|
-
colorThemes: ['default', 'blue', 'green'],
|
|
326
|
-
onThemeChange: (theme) => console.log('Theme:', theme),
|
|
327
|
-
});
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
</details>
|
|
331
|
-
|
|
332
|
-
## Features
|
|
333
|
-
|
|
334
|
-
- Multiple theme support (light, dark, system)
|
|
335
|
-
- Framework-agnostic core
|
|
336
|
-
- Persistent theme storage
|
|
337
|
-
- SSR/SSG compatible
|
|
338
|
-
- Tree-shakeable
|
|
339
|
-
- TypeScript support
|
|
340
|
-
- Zero dependencies (per framework)
|
|
94
|
+
Palettes, transition options, the full API and more live at
|
|
95
|
+
[ui-theme.dev/docs](https://www.ui-theme.dev/docs).
|
|
341
96
|
|
|
342
97
|
## License
|
|
343
98
|
|
|
344
99
|
MIT
|
|
345
|
-
|
|
346
|
-
Use `logoLight` and `logoDark` together instead of `logo` to select the current theme’s asset: `logoDark` for dark-to-light, `logoLight` for light-to-dark. Use a light or white `logoDark` on the dark interface and a dark or black `logoLight` on the light interface. Both are required; combining the pair with `logo` is rejected.
|
|
347
|
-
|
|
348
|
-
When one dimension is set and the other omitted, the omitted dimension defaults to `"auto"` and preserves the SVG aspect ratio. Explicit `"auto"` for both uses the SVG’s intrinsic size. With both omitted, the existing 96 px default width is preserved.
|
|
349
|
-
|
|
350
|
-
All built-in controls share the active state from any of the four providers.
|
|
351
|
-
Outside a provider, they own their standalone state. Keyboard selection inside
|
|
352
|
-
the dropdown portal skips moving reveals.
|
|
353
|
-
|
|
354
|
-
`useHydrated()` is exported from `uitheme-web/react`. For TanStack server/cookie
|
|
355
|
-
callbacks, use `onServerError={(error) => ...}` to observe failed notifications;
|
|
356
|
-
otherwise failures are reported through `console.error` without unhandled promise
|
|
357
|
-
rejections.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
'use strict';var chunkKQSBORXP_cjs=require('./chunk-KQSBORXP.cjs'),chunkCYGYUQUK_cjs=require('./chunk-CYGYUQUK.cjs'),ne=require('react'),reactDom=require('react-dom'),jsxRuntime=require('react/jsx-runtime');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var ne__default=/*#__PURE__*/_interopDefault(ne);var Q=t=>{let o;return {controller:chunkKQSBORXP_cjs.j(t,{commit:e=>reactDom.flushSync(e),getElement:()=>o?.current??null}),connectTrigger:e=>{o=e;}}},$=(t={})=>{let o=ne.useRef(null),[r]=ne.useState(()=>Q(t)),{controller:e}=r,n=ne.useRef(t),s=ne.useSyncExternalStore(e.subscribe,e.getSnapshot,e.getServerSnapshot);return ne.useLayoutEffect(()=>{let i=Object.fromEntries(Object.keys(n.current).filter(l=>!(l in t)).map(l=>[l,void 0]));e.updateOptions({...i,...t}),n.current=t;}),ne.useLayoutEffect(()=>(r.connectTrigger(o),e.mount()),[e,r]),{...s,ref:o,setTheme:e.setTheme,setColorTheme:e.setColorTheme,switchTheme:e.switchTheme,switchColorTheme:e.switchColorTheme,toggleTheme:e.toggleTheme,toggleLightTheme:e.toggleLightTheme,toggleDarkTheme:e.toggleDarkTheme,toggleColorTheme:e.toggleColorTheme,createColorThemeToggle:e.createColorThemeToggle,isColorThemeActive:e.isColorThemeActive}};var ee=()=>()=>{},te=()=>true,oe=()=>false,M=()=>ne.useSyncExternalStore(ee,te,oe);function m(t){return JSON.stringify(t).replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/&/g,"\\u0026").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}var S=ne.createContext(null);var v=ne.createContext(void 0),ie=(t,o,r,e,n,s,i)=>`
|
|
2
|
+
(function() {
|
|
3
|
+
try {
|
|
4
|
+
var theme = localStorage.getItem(${m(t)}) || ${m(r)};
|
|
5
|
+
var colorTheme = localStorage.getItem(${m(o)}) || ${m(e)};
|
|
6
|
+
var resolved = theme === 'system'
|
|
7
|
+
? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light')
|
|
8
|
+
: theme;
|
|
9
|
+
|
|
10
|
+
if (${m(n)} === 'class') {
|
|
11
|
+
if (resolved === 'dark') {
|
|
12
|
+
document.documentElement.classList.add(${m(s)});
|
|
13
|
+
} else {
|
|
14
|
+
document.documentElement.classList.remove(${m(s)});
|
|
15
|
+
}
|
|
16
|
+
} else {
|
|
17
|
+
document.documentElement.setAttribute('data-theme', resolved);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
document.documentElement.style.colorScheme = resolved;
|
|
21
|
+
document.documentElement.classList.add(${m(i)} + colorTheme);
|
|
22
|
+
} catch (e) {
|
|
23
|
+
console.warn('Theme pre-hydration script failed:', e);
|
|
24
|
+
}
|
|
25
|
+
})();
|
|
26
|
+
`,E=ne__default.default.memo(({storageKey:t,colorStorageKey:o,defaultTheme:r,defaultColorTheme:e,attribute:n,globalClassName:s,colorThemePrefix:i,nonce:l})=>{let T=ie(t,o,r,e,n,s,i);return jsxRuntime.jsx("script",{nonce:l,suppressHydrationWarning:true,dangerouslySetInnerHTML:{__html:T}})});E.displayName="ThemePreHydrationScript";var we=({children:t,themes:o=["light","dark","system"],colorThemes:r=["default"],defaultTheme:e="system",defaultColorTheme:n=r[0]??"default",animationType:s="circle",clipPathDirection:i,animationPosition:l,logo:T,logoLight:D,logoDark:j,logoWidth:B,logoHeight:V,gradientWidth:G,duration:z=400,storageKey:u=chunkCYGYUQUK_cjs.a,colorStorageKey:d=chunkCYGYUQUK_cjs.b,attribute:g="class",globalClassName:p=chunkCYGYUQUK_cjs.c,colorThemePrefix:y=chunkCYGYUQUK_cjs.d,nonce:P,disableAnimationOnInit:U=true,disablePreHydrationScript:w=false})=>{let f=M(),c=$({themes:o,colorThemes:r,defaultTheme:e,defaultColorTheme:n,animationType:s,clipPathDirection:i,animationPosition:l,...chunkKQSBORXP_cjs.c({logo:T,logoLight:D,logoDark:j}),logoWidth:B,logoHeight:V,gradientWidth:G,duration:z,storageKey:u,colorStorageKey:d,globalClassName:g==="class"?p:void 0,colorThemePrefix:y}),C=ne.useCallback(async(a,x=false)=>{!f&&U?c.setTheme(a):await c.switchTheme(a,x);},[f,U,c]),W=ne.useCallback((a,x)=>C(a,{element:x}),[C]),Y=typeof window<"u"&&window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light";if(!f){let a={themes:o,colorThemes:r,mounted:false,ref:{current:null},theme:e,colorTheme:n,resolvedTheme:e==="dark"?"dark":"light",systemTheme:"light",setTheme:()=>{},setColorTheme:()=>{},switchTheme:async()=>{},switchThemeFromElement:async()=>{},switchColorTheme:async()=>{},toggleTheme:async()=>{},toggleLightTheme:async()=>{},toggleDarkTheme:async()=>{},toggleColorTheme:async()=>{},createColorThemeToggle:()=>async()=>{},isColorThemeActive:()=>false};return jsxRuntime.jsx(v.Provider,{value:a,children:jsxRuntime.jsxs(S.Provider,{value:a,children:[!w&&jsxRuntime.jsx(E,{storageKey:u,colorStorageKey:d,defaultTheme:e,defaultColorTheme:n,attribute:g,globalClassName:p,colorThemePrefix:y,nonce:P}),t]})})}let I={...c,systemTheme:Y,switchTheme:C,switchThemeFromElement:W};return jsxRuntime.jsx(v.Provider,{value:I,children:jsxRuntime.jsxs(S.Provider,{value:I,children:[!w&&jsxRuntime.jsx(E,{storageKey:u,colorStorageKey:d,defaultTheme:e,defaultColorTheme:n,attribute:g,globalClassName:p,colorThemePrefix:y,nonce:P}),t]})})},Ie=()=>{let t=ne.useContext(v);if(t===void 0)throw new Error("useNextUITheme must be used within a NextUIThemeProvider");return t};exports.a=$;exports.b=m;exports.c=S;exports.d=M;exports.e=we;exports.f=Ie;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import {c as c$1,j}from'./chunk-EKVKQZNN.js';import {d,c,b,a}from'./chunk-NDNCNR4X.js';import ne,{createContext,useRef,useState,useSyncExternalStore,useLayoutEffect,useCallback,useContext}from'react';import {flushSync}from'react-dom';import {jsx,jsxs}from'react/jsx-runtime';var Q=t=>{let o;return {controller:j(t,{commit:e=>flushSync(e),getElement:()=>o?.current??null}),connectTrigger:e=>{o=e;}}},$=(t={})=>{let o=useRef(null),[r]=useState(()=>Q(t)),{controller:e}=r,n=useRef(t),s=useSyncExternalStore(e.subscribe,e.getSnapshot,e.getServerSnapshot);return useLayoutEffect(()=>{let i=Object.fromEntries(Object.keys(n.current).filter(l=>!(l in t)).map(l=>[l,void 0]));e.updateOptions({...i,...t}),n.current=t;}),useLayoutEffect(()=>(r.connectTrigger(o),e.mount()),[e,r]),{...s,ref:o,setTheme:e.setTheme,setColorTheme:e.setColorTheme,switchTheme:e.switchTheme,switchColorTheme:e.switchColorTheme,toggleTheme:e.toggleTheme,toggleLightTheme:e.toggleLightTheme,toggleDarkTheme:e.toggleDarkTheme,toggleColorTheme:e.toggleColorTheme,createColorThemeToggle:e.createColorThemeToggle,isColorThemeActive:e.isColorThemeActive}};var ee=()=>()=>{},te=()=>true,oe=()=>false,M=()=>useSyncExternalStore(ee,te,oe);function m(t){return JSON.stringify(t).replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/&/g,"\\u0026").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}var S=createContext(null);var v=createContext(void 0),ie=(t,o,r,e,n,s,i)=>`
|
|
2
|
+
(function() {
|
|
3
|
+
try {
|
|
4
|
+
var theme = localStorage.getItem(${m(t)}) || ${m(r)};
|
|
5
|
+
var colorTheme = localStorage.getItem(${m(o)}) || ${m(e)};
|
|
6
|
+
var resolved = theme === 'system'
|
|
7
|
+
? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light')
|
|
8
|
+
: theme;
|
|
9
|
+
|
|
10
|
+
if (${m(n)} === 'class') {
|
|
11
|
+
if (resolved === 'dark') {
|
|
12
|
+
document.documentElement.classList.add(${m(s)});
|
|
13
|
+
} else {
|
|
14
|
+
document.documentElement.classList.remove(${m(s)});
|
|
15
|
+
}
|
|
16
|
+
} else {
|
|
17
|
+
document.documentElement.setAttribute('data-theme', resolved);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
document.documentElement.style.colorScheme = resolved;
|
|
21
|
+
document.documentElement.classList.add(${m(i)} + colorTheme);
|
|
22
|
+
} catch (e) {
|
|
23
|
+
console.warn('Theme pre-hydration script failed:', e);
|
|
24
|
+
}
|
|
25
|
+
})();
|
|
26
|
+
`,E=ne.memo(({storageKey:t,colorStorageKey:o,defaultTheme:r,defaultColorTheme:e,attribute:n,globalClassName:s,colorThemePrefix:i,nonce:l})=>{let T=ie(t,o,r,e,n,s,i);return jsx("script",{nonce:l,suppressHydrationWarning:true,dangerouslySetInnerHTML:{__html:T}})});E.displayName="ThemePreHydrationScript";var we=({children:t,themes:o=["light","dark","system"],colorThemes:r=["default"],defaultTheme:e="system",defaultColorTheme:n=r[0]??"default",animationType:s="circle",clipPathDirection:i,animationPosition:l,logo:T,logoLight:D,logoDark:j,logoWidth:B,logoHeight:V,gradientWidth:G,duration:z=400,storageKey:u=a,colorStorageKey:d$1=b,attribute:g="class",globalClassName:p=c,colorThemePrefix:y=d,nonce:P,disableAnimationOnInit:U=true,disablePreHydrationScript:w=false})=>{let f=M(),c=$({themes:o,colorThemes:r,defaultTheme:e,defaultColorTheme:n,animationType:s,clipPathDirection:i,animationPosition:l,...c$1({logo:T,logoLight:D,logoDark:j}),logoWidth:B,logoHeight:V,gradientWidth:G,duration:z,storageKey:u,colorStorageKey:d$1,globalClassName:g==="class"?p:void 0,colorThemePrefix:y}),C=useCallback(async(a,x=false)=>{!f&&U?c.setTheme(a):await c.switchTheme(a,x);},[f,U,c]),W=useCallback((a,x)=>C(a,{element:x}),[C]),Y=typeof window<"u"&&window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light";if(!f){let a={themes:o,colorThemes:r,mounted:false,ref:{current:null},theme:e,colorTheme:n,resolvedTheme:e==="dark"?"dark":"light",systemTheme:"light",setTheme:()=>{},setColorTheme:()=>{},switchTheme:async()=>{},switchThemeFromElement:async()=>{},switchColorTheme:async()=>{},toggleTheme:async()=>{},toggleLightTheme:async()=>{},toggleDarkTheme:async()=>{},toggleColorTheme:async()=>{},createColorThemeToggle:()=>async()=>{},isColorThemeActive:()=>false};return jsx(v.Provider,{value:a,children:jsxs(S.Provider,{value:a,children:[!w&&jsx(E,{storageKey:u,colorStorageKey:d$1,defaultTheme:e,defaultColorTheme:n,attribute:g,globalClassName:p,colorThemePrefix:y,nonce:P}),t]})})}let I={...c,systemTheme:Y,switchTheme:C,switchThemeFromElement:W};return jsx(v.Provider,{value:I,children:jsxs(S.Provider,{value:I,children:[!w&&jsx(E,{storageKey:u,colorStorageKey:d$1,defaultTheme:e,defaultColorTheme:n,attribute:g,globalClassName:p,colorThemePrefix:y,nonce:P}),t]})})},Ie=()=>{let t=useContext(v);if(t===void 0)throw new Error("useNextUITheme must be used within a NextUIThemeProvider");return t};export{$ as a,m as b,S as c,M as d,we as e,Ie as f};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
var t="theme",e="color-theme",o="dark",E="theme-";export{t as a,e as b,o as c,E as d};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
var x=typeof window<"u",
|
|
1
|
+
var x=typeof window<"u",S=()=>{if(!x||document.getElementById("ui-theme-base-style"))return;let t=document.createElement("style");t.id="ui-theme-base-style",t.textContent=`
|
|
2
2
|
html[data-ui-theme-transition]::view-transition-group(root),
|
|
3
3
|
html[data-ui-theme-transition]::view-transition-old(root),
|
|
4
4
|
html[data-ui-theme-transition]::view-transition-new(root) {
|
|
@@ -14,5 +14,5 @@ var x=typeof window<"u",k=()=>{if(!x||document.getElementById("ui-theme-base-sty
|
|
|
14
14
|
html[data-ui-theme-transition] *::after {
|
|
15
15
|
transition: none !important;
|
|
16
16
|
}
|
|
17
|
-
`,document.head.appendChild(t);},
|
|
18
|
-
export{
|
|
17
|
+
`,document.head.appendChild(t);},M=t=>`url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="-50 -50 100 100"><defs>${`<filter id="blur"><feGaussianBlur stdDeviation="${t}" /></filter>`}</defs><circle cx="0" cy="0" r="25" fill="white" filter="url(%23blur)"/></svg>')`,k=()=>x&&window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light",P=t=>t==="system"?k():t==="dark"?"dark":"light",R=t=>t==="system"?"system":t==="dark"?"dark":"light",E=()=>x&&document.startViewTransition instanceof Function,T=()=>x&&window.matchMedia("(prefers-reduced-motion: reduce)").matches,B=t=>{switch(t){case "left":return {a:-100,b:0};case "right":return {a:100,b:0};case "top":return {a:0,b:-100};case "bottom":return {a:0,b:100};case "top-left":return {a:-100,b:-100};case "top-right":return {a:100,b:-100};case "bottom-left":return {a:-100,b:100};case "bottom-right":return {a:100,b:100};default:return {a:-100,b:0}}},w=()=>{let t=getComputedStyle(document.documentElement,"::view-transition-new(root)"),n=Math.max(window.innerWidth,parseFloat(t.width)||0),e=Math.max(window.innerHeight,parseFloat(t.height)||0);return {width:n,height:e}},y=(t,n)=>{let{width:e,height:o}=w();return Math.hypot(Math.max(Math.abs(t),Math.abs(e-t)),Math.max(Math.abs(n),Math.abs(o-n)))+1},I=t=>{let n=t.includes("left")?0:t.includes("right")?window.innerWidth:window.innerWidth/2,e=t.includes("top")?0:t.includes("bottom")?window.innerHeight:window.innerHeight/2;return {x:n,y:e}},C=0,h=(t,n)=>{let e=document.documentElement.animate(n,{duration:t.duration,easing:t.easing,fill:"both",pseudoElement:"::view-transition-new(root)"}),o=e.effect;if(!(o instanceof KeyframeEffect))return e;let i=o.getKeyframes(),d=i.some(l=>"clipPath"in l)?"clipPath":i.some(l=>"maskImage"in l)?"maskImage":"transform";if(getComputedStyle(document.documentElement,"::view-transition-new(root)")[d]!=="none")return e;let c=e.playState==="paused",s=e.currentTime;e.cancel(),e.finished.catch(()=>{});let r=`ui-theme-reveal-${++C}`,a=document.createElement("style"),m=i.map(l=>{let $=Object.entries(l).filter(([u])=>!["offset","computedOffset","easing","composite"].includes(u)).map(([u,v])=>`${u.replace(/[A-Z]/g,A=>`-${A.toLowerCase()}`)}:${v};`).join("");return `${l.computedOffset*100}%{${$}}`}).join("");a.textContent=`@keyframes ${r}{${m}}html[data-ui-theme-transition]::view-transition-new(root){animation:${r} ${t.duration}ms ${t.easing} both;}`,document.head.appendChild(a);let f=getComputedStyle(document.documentElement,"::view-transition-new(root)").animationName,p=document.getAnimations().find(l=>l instanceof CSSAnimation&&l.animationName===f);if(!p)throw a.remove(),new Error("Transition pseudo animations are unavailable");return c&&(p.pause(),p.currentTime=s),p.finished.then(()=>a.remove(),()=>a.remove()),p},D=t=>{let n=t.clipPathDirection??"top-left",e={"top-left":"polygon(-1% -1%, 101% -101%, -101% 101%, -1% -1%)",top:"polygon(-1% -1%, 101% -1%, 101% -1%, -1% -1%)","top-right":"polygon(101% -1%, 201% 101%, -1% -101%, 101% -1%)",right:"polygon(101% -1%, 101% 101%, 101% 101%, 101% -1%)","bottom-right":"polygon(101% 101%, -1% 201%, 201% -1%, 101% 101%)",bottom:"polygon(101% 101%, -1% 101%, -1% 101%, 101% 101%)","bottom-left":"polygon(-1% 101%, -101% -1%, 101% 201%, -1% 101%)",left:"polygon(-1% 101%, -1% -1%, -1% -1%, -1% 101%)"},o={"top-left":"polygon(-1% -1%, 201% -1%, -1% 201%, -1% -1%)",top:"polygon(-1% -1%, 101% -1%, 101% 101%, -1% 101%)","top-right":"polygon(101% -1%, 101% 201%, -101% -1%, 101% -1%)",right:"polygon(101% -1%, 101% 101%, -1% 101%, -1% -1%)","bottom-right":"polygon(101% 101%, -101% 101%, 101% -101%, 101% 101%)",bottom:"polygon(101% 101%, -1% 101%, -1% -1%, 101% -1%)","bottom-left":"polygon(-1% 101%, -1% -101%, 201% 101%, -1% 101%)",left:"polygon(-1% 101%, -1% -1%, 101% -1%, 101% 101%)"};return h(t,{clipPath:[e[n],o[n]]})},F=t=>{let n=t.clipPathDirection??"top-left",{width:e,height:o}=w(),i=n.includes("-"),d=n.includes("left"),g=n.includes("top"),c=n==="left"||n==="right",s=d?0:n.includes("right")?1:.5,r=g?0:n.includes("bottom")?1:.5,a=i||c?e*3:e,m=i||!c?o*3:o,f=i?`${s*100},${r*100} ${(1-s)*100},${r*100} ${s*100},${(1-r)*100}`:"0,0 100,0 100,100 0,100",p=i?a*m/Math.hypot(a,m):c?a:m,$=1-Math.max(0,Math.min(t.gradientWidth??80,p*.2))/p,u=`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" preserveAspectRatio="none"><defs><linearGradient id="edge" x1="${s*100}" y1="${r*100}" x2="${100*(i?.5:c?1-s:s)}" y2="${100*(i?.5:c?r:1-r)}" gradientUnits="userSpaceOnUse"><stop offset="${$}" stop-color="black"/><stop offset="1" stop-color="black" stop-opacity="0"/></linearGradient></defs><polygon points="${f}" fill="url(#edge)"/></svg>`;return h(t,{maskImage:[`url("data:image/svg+xml,${encodeURIComponent(u)}")`,`url("data:image/svg+xml,${encodeURIComponent(u)}")`],maskMode:["alpha","alpha"],maskRepeat:["no-repeat","no-repeat"],maskSize:[i?"0px 0px":c?`0px ${m}px`:`${a}px 0px`,`${a}px ${m}px`],maskPosition:[`${s*e}px ${r*o}px`,`${s*(e-a)}px ${r*(o-m)}px`]})},j=t=>{let{x:n,y:e}=t,o=y(n,e),i=Math.sqrt(3)*o;return h(t,{clipPath:[`polygon(${n}px ${e}px, ${n}px ${e}px, ${n}px ${e}px)`,`polygon(${n}px ${e-2*o}px, ${n+i}px ${e+o}px, ${n-i}px ${e+o}px)`]})},z=t=>{let{width:n,height:e}=w();return b({...t,x:n/2,y:e/2})},b=t=>{let{x:n,y:e}=t;return h(t,{clipPath:[`circle(0px at ${n}px ${e}px)`,`circle(${y(n,e)}px at ${n}px ${e}px)`]})},G=t=>{let{a:n=-100,b:e=0,x:o=0,y:i=0}=t;return h(t,{transform:[`translate(${n}%, ${e}%)`,`translate(${o}%, ${i}%)`]})},K=t=>{let{x:n,y:e,blurAmount:o}=t;if(o<=0)return b(t);let i=Math.min(o,20),d=y(n,e)+i,g=d*2;return h(t,{maskImage:[`radial-gradient(closest-side, #000 calc(100% - ${i}px), transparent 100%)`,`radial-gradient(closest-side, #000 calc(100% - ${i}px), transparent 100%)`],maskRepeat:["no-repeat","no-repeat"],maskSize:["0px 0px",`${g}px ${g}px`],maskPosition:[`${n}px ${e}px`,`${n-d}px ${e-d}px`]})};
|
|
18
|
+
export{S as a,M as b,k as c,P as d,R as e,E as f,T as g,B as h,I as i,D as j,F as k,j as l,z as m,b as n,G as o,K as p};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
'use strict';var t="theme",e="color-theme",o="dark",E="theme-",_=400,A="cubic-bezier(0.32, 0.72, 0, 1)",c=2,r="ui-theme-style";exports.a=t;exports.b=e;exports.c=o;exports.d=E;exports.e=_;exports.f=A;exports.g=c;exports.h=r;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import {f,g,a as a$1,o,p,j,k,l,m,n,c,d,h as h$1,i}from'./chunk-CY5E6WU4.js';import {a,b,c as c$1,d as d$1,h,f as f$1}from'./chunk-NDNCNR4X.js';var J=(a=>(a.CIRCLE="circle",a.BLUR_CIRCLE="blur-circle",a.SLIDE="slide",a.CLIP_PATH="clip-path",a.POLYGON_GRADIENT="polygon-gradient",a.TRIANGLE="triangle",a.SVG_LOGO="svg-logo",a))(J||{}),$e=["top-left","top","top-right","right","bottom-right","bottom","bottom-left","left"];var _=n=>{if(n.logoLight!==void 0||n.logoDark!==void 0){if(!n.logoLight||!n.logoDark)throw new Error("logoLight and logoDark must both be provided.");if(n.logo!==void 0)throw new Error("Use logo or the logoLight/logoDark pair, not both.");return {logoLight:n.logoLight,logoDark:n.logoDark}}return {logo:n.logo}},Ge=0,Ee=n=>{let i=Ne(n.logo);if(!i)return;let t=n.logoWidth!=="auto"&&n.logoWidth&&Number.isFinite(n.logoWidth)&&n.logoWidth>0?n.logoWidth:void 0,o=n.logoHeight!=="auto"&&n.logoHeight&&Number.isFinite(n.logoHeight)&&n.logoHeight>0?n.logoHeight:void 0,h=t??(o?o*i.aspectRatio:n.logoWidth==="auto"||n.logoHeight==="auto"?i.naturalWidth:96),m=o??h/i.aspectRatio,c=`ui-theme-logo-${++Ge}`,a=document.createElement("img");a.src=i.image,a.alt="",a.setAttribute("aria-hidden","true"),a.setAttribute("data-ui-theme-logo",""),a.style.cssText=`position:fixed;left:calc(50% - ${h/2}px);top:calc(50% - ${m/2}px);width:${h}px;height:${m}px;max-width:none;max-height:none;object-fit:contain;display:block;margin:0;padding:0;border:0;transform:none;pointer-events:none;z-index:2147483647;view-transition-name:${c};`;let T=document.createElement("style");return T.setAttribute("data-ui-theme-logo-style",""),T.textContent=`
|
|
2
|
+
@keyframes ${c}-fade { 0%, 85% { opacity:1; } 100% { opacity:0; } }
|
|
3
|
+
html[data-ui-theme-transition]::view-transition-group(${c}) {
|
|
4
|
+
z-index:2;
|
|
5
|
+
animation:${c}-fade ${n.duration}ms linear both;
|
|
6
|
+
}
|
|
7
|
+
html[data-ui-theme-transition]::view-transition-old(${c}) { display:none; }
|
|
8
|
+
html[data-ui-theme-transition]::view-transition-new(${c}) {
|
|
9
|
+
animation:none; mix-blend-mode:normal;
|
|
10
|
+
}
|
|
11
|
+
`,document.head.appendChild(T),document.documentElement.appendChild(a),{element:a,style:T}},Q=new Map,xe=n=>{if(typeof window>"u")return Promise.resolve();let i=Q.get(n);if(i)return i.loading;let t={loading:Promise.resolve()};return Q.set(n,t),t.loading=(async()=>{let o=new AbortController,h=setTimeout(()=>o.abort(),2e3);try{let m=await fetch(n,{signal:o.signal});if(!m.ok)return;let c=await m.text(),a=new DOMParser().parseFromString(c,"image/svg+xml");if(a.querySelector("parsererror")||a.documentElement.localName!=="svg"||a.documentElement.namespaceURI!=="http://www.w3.org/2000/svg")return;let T=`data:image/svg+xml,${encodeURIComponent(c)}`,u=new Image;u.src=T,await u.decode(),u.naturalWidth>0&&u.naturalHeight>0&&(t.ready={image:T,naturalWidth:u.naturalWidth,aspectRatio:u.naturalWidth/u.naturalHeight});}catch{}finally{clearTimeout(h);}})(),t.loading},Ne=n=>n?Q.get(n)?.ready:void 0;var D=new WeakMap,Oe=async(n$1,i)=>{if(typeof document>"u"){await n$1();return}let t=D.get(document);t?.transition?.skipTransition(),t?.animation?.cancel(),t?.logo?.element.remove(),t?.logo?.style.remove();let o$1={updateDone:Promise.resolve()};D.set(document,o$1);let h=()=>{o$1.animation?.cancel(),o$1.logo?.element.remove(),o$1.logo?.style.remove(),D.get(document)===o$1&&(D.delete(document),document.documentElement.removeAttribute("data-ui-theme-transition"));};o$1.updateDone=(async()=>{if(t&&await t.updateDone.catch(()=>{}),D.get(document)!==o$1||!i||!f()||g()||document.visibilityState==="hidden"){await n$1();return}a$1(),document.documentElement.setAttribute("data-ui-theme-transition",""),i.animationType==="svg-logo"&&(o$1.logo=Ee(i));let m;try{m=document.startViewTransition(n$1);}catch{await n$1();return}o$1.transition=m,m.ready.catch(()=>{}),m.finished.then(h,h),await m.updateCallbackDone;})();try{await o$1.updateDone;let m$1=o$1.transition;if(!m$1){h();return}try{await m$1.ready;}catch{h();return}if(D.get(document)!==o$1){m$1.skipTransition();return}if(!i)return;try{o$1.animation=i.animationType==="slide"?o(i):i.animationType==="blur-circle"?p(i):i.animationType==="clip-path"?j(i):i.animationType==="polygon-gradient"?k(i):i.animationType==="triangle"?l(i):i.animationType==="svg-logo"?m(i):n(i),o$1.animation.finished.catch(()=>{});let c=o$1.animation.effect;!(o$1.animation instanceof CSSAnimation)&&(!(c instanceof KeyframeEffect)||c.pseudoElement!=="::view-transition-new(root)")&&(m$1.skipTransition(),h());}catch{m$1.skipTransition(),h();}}catch(m){throw h(),m}};var M=typeof window<"u",Ae=(n=a,i=["light","dark","system"],t="system")=>{if(!M)return t;let o;try{o=localStorage.getItem(n);}catch{return t}return i.find(h=>h===o)??t},Ie=(n,i=a)=>{M&&localStorage.setItem(i,n);},De=(n=b,i=["default"],t="default")=>{if(!M)return t;let o;try{o=localStorage.getItem(n);}catch{return t}return o&&i.includes(o)?o:t},ke=(n,i=b)=>{M&&localStorage.setItem(i,n);};function G(n){if(!["light","dark","system"].includes(n))throw new Error("Theme must be light, dark, or system.")}function U(n,i){let t=`${i}${n}`;if(!t.length||/\s/.test(t))throw new Error("Theme classes must be nonempty CSS class tokens.")}function Z(n={}){let i=n.themes??["light","dark","system"],t=n.colorThemes??["default"],o=n.defaultTheme??"system",h=n.defaultColorTheme??t[0],m=n.globalClassName??c$1,c=n.colorThemePrefix??d$1;if(!i.length||!i.every(a=>["light","dark","system"].includes(a))||!i.includes(o))throw new Error("themes must include the defaultTheme and contain light, dark, or system.");if(h===void 0||!t.includes(h))throw new Error("colorThemes must include the defaultColorTheme.");if(![m,...t.map(a=>`${c}${a}`)].every(a=>a.length>0&&!/\s/.test(a)))throw new Error("Theme classes must be nonempty CSS class tokens.");return {themes:Object.freeze([...i]),colorThemes:Object.freeze([...t]),defaultTheme:o,defaultColorTheme:h,globalClassName:m,colorThemePrefix:c,storageKey:n.storageKey??a,colorStorageKey:n.colorStorageKey??b}}var Y=(n,i)=>n.length===i.length&&n.every((t,o)=>t===i[o]),Pe=n=>n&&n!==true&&"currentTarget"in n?{element:n.currentTarget,animationOff:n.detail===0}:n,et=(n={},i$1={})=>{let t=n,o=Z(t);_(t);let h$2=(e,s)=>{e.theme!==void 0&&G(e.theme),e.initialTheme!==void 0&&G(e.initialTheme),e.colorTheme!==void 0&&U(e.colorTheme,s),e.initialColorTheme!==void 0&&U(e.initialColorTheme,s);};h$2(t,o.colorThemePrefix);let m=e=>{try{return t.storage?t.storage.getItem(e):null}catch{return null}},c$1=()=>{if(t.storage===void 0)return Ae(t.storageKey,o.themes,o.defaultTheme);let e=m(t.storageKey??a);return o.themes.find(s=>s===e)??o.defaultTheme},a$2=()=>{if(t.storage===void 0)return De(t.colorStorageKey,o.colorThemes,o.defaultColorTheme);let e=m(t.colorStorageKey??b);return o.colorThemes.find(s=>s===e)??o.defaultColorTheme},T=t.initialTheme??c$1(),u=t.initialColorTheme??a$2(),ee=false,te=false,k=c(),x=false,N=0,w=0,j,$,K,W,q=new Set,oe=t.theme??t.initialTheme??o.defaultTheme,ne={theme:oe,colorTheme:t.colorTheme??t.initialColorTheme??o.defaultColorTheme,resolvedTheme:oe==="dark"?"dark":"light",systemTheme:"light",themes:o.themes,colorThemes:o.colorThemes,mounted:false},l={...ne,theme:t.theme??T,colorTheme:t.colorTheme??u,resolvedTheme:d(t.theme??T),systemTheme:k},O=l.theme,P=l.colorTheme,p=l.theme,b$1=l.colorTheme,Re=()=>{if(!x||typeof document>"u")return;let e=document.documentElement,s=o.globalClassName,d=o.colorThemePrefix;W&&W!==s&&e.classList.remove(W),e.classList.remove("auto","system"),t.systemThemeMode==="css"&&l.theme==="system"?(e.classList.remove(s),e.classList.add("system"),e.style.colorScheme=""):(e.classList.toggle(s,l.resolvedTheme==="dark"),e.style.colorScheme=l.resolvedTheme),W=s,K&&e.classList.remove(K),l.colorThemes.forEach(r=>e.classList.remove(`${d}${r}`)),K=`${d}${l.colorTheme}`,e.classList.add(K);},E=()=>{let e=t.theme??T,s=t.colorTheme??u,d=o.themes,r=o.colorThemes,g={theme:e,colorTheme:s,resolvedTheme:e==="system"?k:e,systemTheme:k,themes:Y(l.themes,d)?l.themes:d,colorThemes:Y(l.colorThemes,r)?l.colorThemes:r,mounted:x},y=g.theme!==l.theme||g.colorTheme!==l.colorTheme||g.resolvedTheme!==l.resolvedTheme||g.systemTheme!==l.systemTheme||g.themes!==l.themes||g.colorThemes!==l.colorThemes||g.mounted!==l.mounted;y&&(l=g),Re(),y&&q.forEach(C=>C());},ie=()=>{if(t.animationType==="svg-logo")for(let e of [t.logo,t.logoLight,t.logoDark])e&&xe(e);},re=e=>{try{e();}catch(s){if(!i$1.onBrowserStorageError)throw s;i$1.onBrowserStorageError(s instanceof Error?s:new Error(String(s)));}},se=e=>{G(e),t.storage===void 0?re(()=>Ie(e,t.storageKey??a)):t.storage&&t.storage.setItem(t.storageKey??a,e),ee=true,O=e,t.theme===void 0&&(T=e),E(),t.onThemeChange?.(e);},ae=e=>{U(e,o.colorThemePrefix),t.storage===void 0?re(()=>ke(e,t.colorStorageKey??b)):t.storage&&t.storage.setItem(t.colorStorageKey??b,e),te=true,P=e,t.colorTheme===void 0&&(u=e),E(),t.onColorThemeChange?.(e);},_e=(e=false)=>{let s=e===true||e===false?{animationOff:e}:e,d$1=s.logo!==void 0||s.logoLight!==void 0||s.logoDark!==void 0,r={...t,...Object.fromEntries(Object.entries(s).filter(([,R])=>R!==void 0))};d$1&&Object.assign(r,{logo:void 0,logoLight:void 0,logoDark:void 0,..._(s)}),_(r);let g=r.duration??400;if(s.animationOff||g<=0||typeof window>"u")return null;let y=Object.values(J).find(R=>R===r.animationType)??"circle",C={duration:g,easing:r.easing??f$1,animationType:y,blurAmount:r.blurAmount??2,styleId:r.styleId??h};if(y==="slide"){let R=r.slideFromX!==void 0&&r.slideFromY!==void 0?{a:r.slideFromX,b:r.slideFromY}:h$1(r.slideDirection??"left");return {...C,...R,x:r.slideToX??0,y:r.slideToY??0}}let A=s.element??i$1.getElement?.(),v=s.origin?null:A?.getBoundingClientRect(),f=(y==="svg-logo"?i("center"):null)??s.origin??(r.animationPosition&&r.animationPosition!=="trigger"?i(r.animationPosition):null)??(v?{x:v.left+v.width/2,y:v.top+v.height/2}:y==="circle"||y==="blur-circle"?null:i("center"));return !f||!Number.isFinite(f.x)||!Number.isFinite(f.y)?null:{...C,...f,clipPathDirection:r.clipPathDirection??"top-left",animationPosition:r.animationPosition,logo:r.logoLight!==void 0?d(O)==="light"?r.logoLight:r.logoDark:r.logo,logoWidth:r.logoWidth,logoHeight:r.logoHeight,gradientWidth:r.gradientWidth}},le=async(e,s)=>{let d=_e(s),r=w,g=()=>{r===w&&e();};N++;try{await Oe(()=>{if(r===w)return i$1.commit?i$1.commit(g):g()},d);}finally{r===w&&N--;}},F=async(e,s)=>{if(G(e),!o.themes.includes(e)){console.warn(`Theme "${e}" not found in available themes`);return}if(e===p)return;p=e;let d=w;try{await le(()=>se(e),s);}catch(r){throw d===w&&p===e&&(p=O),r}},X=async(e,s)=>{if(!o.colorThemes.includes(e)){console.warn(`Color theme "${e}" not found in available themes`);return}if(e===b$1)return;b$1=e;let d=w;try{await le(()=>ae(e),s);}catch(r){throw d===w&&b$1===e&&(b$1=P),r}},z=()=>{w++,N=0,j?.(),j=void 0,$=void 0,x=false,E();};return {getSnapshot:()=>l,getServerSnapshot:()=>ne,subscribe:e=>(q.add(e),()=>{q.delete(e);}),mount:()=>{if(x||typeof window>"u"||typeof document>"u")return z;x=true,!ee&&t.initialTheme===void 0&&(T=c$1()),!te&&t.initialColorTheme===void 0&&(u=a$2()),O=p=t.theme??T,P=b$1=t.colorTheme??u,k=c();let e=window.matchMedia("(prefers-color-scheme: dark)"),s=()=>{k=c(),E();},d=r=>{if(r.storageArea&&r.storageArea!==window.localStorage)return;let g=o.themes,y=o.colorThemes;if((r.key===null||r.key===(t.storageKey??a))&&t.theme===void 0){let C=r.newValue??o.defaultTheme,A=g.find(v=>v===C);A!==void 0&&(T=O=p=A);}if((r.key===null||r.key===(t.colorStorageKey??b))&&t.colorTheme===void 0){let C=r.newValue??o.defaultColorTheme;y.includes(C)&&(u=P=b$1=C);}E();};return e.addEventListener("change",s),$=()=>{window.removeEventListener("storage",d),t.storage===void 0&&window.addEventListener("storage",d);},$(),j=()=>{e.removeEventListener("change",s),window.removeEventListener("storage",d);},a$1(),ie(),E(),z},dispose:z,updateOptions:e=>{let s=l.theme,d=l.colorTheme,r={...t,...e},{logo:g,logoLight:y,logoDark:C,...A}=r,v={...A,..._({logo:g,logoLight:y,logoDark:C})},f=Z(v);h$2(v,f.colorThemePrefix),!Y(o.themes,f.themes)&&!f.themes.includes(T)&&(T=f.defaultTheme),!Y(o.colorThemes,f.colorThemes)&&!f.colorThemes.includes(u)&&(u=f.defaultColorTheme),t=v,o=f,E(),N===0&&(s!==l.theme&&(O=p=l.theme),d!==l.colorTheme&&(P=b$1=l.colorTheme)),x&&(ie(),$?.());},setTheme:e=>{se(e),p=e;},setColorTheme:e=>{ae(e),b$1=e;},switchTheme:F,switchColorTheme:X,toggleTheme:e=>{let s=d(p)==="dark"?"light":"dark",d$1=o.themes.includes(s)?s:o.themes[(o.themes.indexOf(p)+1)%o.themes.length];return F(d$1,e)},toggleLightTheme:async e=>{d(p)!=="light"&&await F("light",e);},toggleDarkTheme:async e=>{d(p)!=="dark"&&await F("dark",e);},toggleColorTheme:async e=>{let s=o.colorThemes;s.length!==0&&await X(s[(s.indexOf(b$1)+1)%s.length],Pe(e));},createColorThemeToggle:e=>s=>X(e,Pe(s)),isColorThemeActive:e=>l.colorTheme===e}};
|
|
12
|
+
export{J as a,$e as b,_ as c,xe as d,Oe as e,Ae as f,Ie as g,De as h,ke as i,et as j};
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import {c,d,b,a}from'./chunk-CTNYTI5Q.js';function i(e={}){let o=e.themes??["light","dark","system"],r=e.colorThemes??["default"],s=e.defaultTheme??"system",l=e.defaultColorTheme??r[0],a$1=e.globalClassName??c,c$1=e.colorThemePrefix??d;if(!o.length||!o.every(t=>["light","dark","system"].includes(t))||!o.includes(s))throw new Error("themes must include defaultTheme and contain light, dark, or system.");if(!l||!r.includes(l)||![a$1,...r.map(t=>`${c$1}${t}`)].every(t=>t.length>0&&!/\s/.test(t)))throw new Error("Color themes and class names must be valid CSS class tokens.");return `(() => {
|
|
2
|
+
const config = ${JSON.stringify({themes:o,colorThemes:r,defaultTheme:s,defaultColorTheme:l,globalClassName:a$1,colorThemePrefix:c$1,storageKey:e.storageKey??a,colorStorageKey:e.colorStorageKey??b,browserStorage:e.storage===void 0}).replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/&/g,"\\u0026").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")};
|
|
3
|
+
const root = document.documentElement;
|
|
4
|
+
let theme = config.defaultTheme;
|
|
5
|
+
let palette = config.defaultColorTheme;
|
|
6
|
+
if (config.browserStorage) {
|
|
7
|
+
try { const value = localStorage.getItem(config.storageKey); if (config.themes.includes(value)) theme = value; } catch {}
|
|
8
|
+
try { const value = localStorage.getItem(config.colorStorageKey); if (config.colorThemes.includes(value)) palette = value; } catch {}
|
|
9
|
+
}
|
|
10
|
+
const dark = theme === 'dark' || (theme === 'system' && matchMedia('(prefers-color-scheme: dark)').matches);
|
|
11
|
+
root.classList.toggle(config.globalClassName, dark);
|
|
12
|
+
root.style.colorScheme = dark ? 'dark' : 'light';
|
|
13
|
+
for (const value of config.colorThemes) root.classList.toggle(config.colorThemePrefix + value, value === palette);
|
|
14
|
+
})();`}export{i as a};
|