preact-missing-hooks 1.0.1 → 1.1.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/.github/workflows/sync-npm.yml +38 -0
- package/.github/workflows/test-hooks.yml +30 -0
- package/LICENSE +21 -0
- package/Readme.md +208 -39
- package/dist/index.d.ts +6 -0
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/index.module.js +1 -1
- package/dist/index.module.js.map +1 -1
- package/dist/index.umd.js +1 -1
- package/dist/index.umd.js.map +1 -1
- package/dist/useClipboard.d.ts +36 -0
- package/dist/useEventBus.d.ts +10 -0
- package/dist/useMutationObserver.d.ts +9 -0
- package/dist/useNetworkState.d.ts +40 -0
- package/dist/usePreferredTheme.d.ts +21 -0
- package/dist/useWrappedChildren.d.ts +10 -0
- package/package.json +64 -48
- package/src/index.ts +7 -1
- package/src/useClipboard.ts +97 -0
- package/src/useEventBus.ts +36 -0
- package/src/useMutationObserver.ts +26 -0
- package/src/useNetworkState.ts +122 -0
- package/src/usePreferredTheme.ts +68 -0
- package/src/useWrappedChildren.ts +58 -0
- package/tests/useClipboard.test.tsx +159 -0
- package/tests/useEventBus.test.tsx +41 -0
- package/tests/useMutationObserver.test.tsx +35 -0
- package/tests/useNetworkState.test.tsx +140 -0
- package/tests/usePreferredTheme.test.tsx +119 -0
- package/tests/useTransition.test.tsx +25 -0
- package/tests/useWrappedChildren.test.tsx +156 -0
- package/vite.config.ts +9 -0
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
name: Sync NPM Metadata
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
release:
|
|
5
|
+
types: [published]
|
|
6
|
+
|
|
7
|
+
jobs:
|
|
8
|
+
sync-npm-metadata:
|
|
9
|
+
runs-on: ubuntu-latest
|
|
10
|
+
steps:
|
|
11
|
+
- name: Checkout Repository
|
|
12
|
+
uses: actions/checkout@v3
|
|
13
|
+
|
|
14
|
+
- name: Setup Node.js
|
|
15
|
+
uses: actions/setup-node@v3
|
|
16
|
+
with:
|
|
17
|
+
node-version: '18'
|
|
18
|
+
|
|
19
|
+
- name: Fetch NPM Package Metadata
|
|
20
|
+
id: fetch_metadata
|
|
21
|
+
run: |
|
|
22
|
+
PACKAGE_NAME=$(jq -r .name package.json)
|
|
23
|
+
curl -s https://registry.npmjs.org/$PACKAGE_NAME > npm-metadata.json
|
|
24
|
+
echo "Fetched metadata for $PACKAGE_NAME"
|
|
25
|
+
|
|
26
|
+
- name: Update README with NPM Version
|
|
27
|
+
run: |
|
|
28
|
+
NPM_VERSION=$(jq -r .version npm-metadata.json)
|
|
29
|
+
sed -i "s/^Version: .*/Version: $NPM_VERSION/" README.md
|
|
30
|
+
echo "Updated README with version $NPM_VERSION"
|
|
31
|
+
|
|
32
|
+
- name: Commit and Push Changes
|
|
33
|
+
run: |
|
|
34
|
+
git config user.name "github-actions[bot]"
|
|
35
|
+
git config user.email "github-actions[bot]@users.noreply.github.com"
|
|
36
|
+
git add README.md
|
|
37
|
+
git commit -m "chore: sync README with npm version $NPM_VERSION"
|
|
38
|
+
git push
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
name: Test Hooks
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
branches: [main]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
test:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
|
|
13
|
+
steps:
|
|
14
|
+
- name: Checkout
|
|
15
|
+
uses: actions/checkout@v3
|
|
16
|
+
|
|
17
|
+
- name: Setup Node.js
|
|
18
|
+
uses: actions/setup-node@v3
|
|
19
|
+
with:
|
|
20
|
+
node-version: 20
|
|
21
|
+
cache: 'npm'
|
|
22
|
+
|
|
23
|
+
- name: Install deps
|
|
24
|
+
run: npm i
|
|
25
|
+
|
|
26
|
+
- name: Type Check
|
|
27
|
+
run: npm run type-check
|
|
28
|
+
|
|
29
|
+
- name: Run Tests
|
|
30
|
+
run: npm run test
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Prakhar Dubey
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the “Software”), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/Readme.md
CHANGED
|
@@ -1,16 +1,37 @@
|
|
|
1
1
|
# Preact Missing Hooks
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<p align="left">
|
|
4
|
+
<a href="https://www.npmjs.com/package/preact-missing-hooks">
|
|
5
|
+
<img src="https://img.shields.io/npm/v/preact-missing-hooks?color=crimson&label=npm%20version" alt="npm version" />
|
|
6
|
+
</a>
|
|
7
|
+
<a href="https://www.npmjs.com/package/preact-missing-hooks">
|
|
8
|
+
<img src="https://img.shields.io/npm/dm/preact-missing-hooks?label=monthly%20downloads" alt="monthly downloads" />
|
|
9
|
+
</a>
|
|
10
|
+
<a href="https://www.npmjs.com/package/preact-missing-hooks">
|
|
11
|
+
<img src="https://img.shields.io/npm/dt/preact-missing-hooks?label=total%20downloads" alt="total downloads" />
|
|
12
|
+
</a>
|
|
13
|
+
|
|
14
|
+
<a href="https://github.com/prakhardubey2002/preact-missing-hooks/actions/workflows/test-hooks.yml">
|
|
15
|
+
<img src="https://img.shields.io/github/actions/workflow/status/prakhardubey2002/preact-missing-hooks/test-hooks.yml?branch=main&label=build%20status" alt="Build Status" />
|
|
16
|
+
</a>
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
A lightweight, extendable collection of React-like hooks for Preact, including utilities for transitions, DOM mutation observation, global event buses, theme detection, network status, and clipboard access.
|
|
4
20
|
|
|
5
21
|
---
|
|
6
22
|
|
|
7
23
|
## ✨ Features
|
|
8
24
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
25
|
+
- **🔄 `useTransition`** — Defers state updates to yield a smoother UI experience.
|
|
26
|
+
- **🔍 `useMutationObserver`** — Reactively observes DOM changes with a familiar hook API.
|
|
27
|
+
- **📡 `useEventBus`** — A simple publish/subscribe system, eliminating props drilling or overuse of context.
|
|
28
|
+
- **🎁 `useWrappedChildren`** — Injects props into child components with flexible merging strategies.
|
|
29
|
+
- **🌓 `usePreferredTheme`** — Detects the user's preferred color scheme (light/dark) from system preferences.
|
|
30
|
+
- **📶 `useNetworkState`** — Tracks online/offline status and connection details (type, downlink, RTT, save-data).
|
|
31
|
+
- **📋 `useClipboard`** — Copy and paste text with the Clipboard API, with copied/error state.
|
|
32
|
+
- ✅ Fully TypeScript compatible
|
|
33
|
+
- 📦 Bundled with Microbundle
|
|
34
|
+
- ⚡ Zero dependencies (except `preact`)
|
|
14
35
|
|
|
15
36
|
---
|
|
16
37
|
|
|
@@ -20,74 +41,222 @@ A lightweight, extendable collection of missing React-like hooks for Preact —
|
|
|
20
41
|
npm install preact-missing-hooks
|
|
21
42
|
```
|
|
22
43
|
|
|
23
|
-
Ensure `preact` is installed in your project:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm install preact
|
|
27
|
-
```
|
|
28
|
-
|
|
29
44
|
---
|
|
30
45
|
|
|
31
|
-
## 🔧 Usage
|
|
46
|
+
## 🔧 Usage Examples
|
|
47
|
+
|
|
48
|
+
### `useTransition`
|
|
32
49
|
|
|
33
50
|
```tsx
|
|
34
|
-
import { useTransition } from 'preact-missing-hooks'
|
|
51
|
+
import { useTransition } from 'preact-missing-hooks'
|
|
35
52
|
|
|
36
|
-
|
|
37
|
-
const [
|
|
53
|
+
function ExampleTransition() {
|
|
54
|
+
const [startTransition, isPending] = useTransition()
|
|
38
55
|
|
|
39
56
|
const handleClick = () => {
|
|
40
57
|
startTransition(() => {
|
|
41
|
-
//
|
|
42
|
-
})
|
|
43
|
-
}
|
|
58
|
+
// perform an expensive update here
|
|
59
|
+
})
|
|
60
|
+
}
|
|
44
61
|
|
|
45
62
|
return (
|
|
46
63
|
<button onClick={handleClick} disabled={isPending}>
|
|
47
|
-
{isPending ? 'Loading...' : 'Click
|
|
64
|
+
{isPending ? 'Loading...' : 'Click Me'}
|
|
48
65
|
</button>
|
|
49
|
-
)
|
|
50
|
-
}
|
|
66
|
+
)
|
|
67
|
+
}
|
|
51
68
|
```
|
|
52
69
|
|
|
53
70
|
---
|
|
54
71
|
|
|
55
|
-
|
|
72
|
+
### `useMutationObserver`
|
|
56
73
|
|
|
57
|
-
|
|
74
|
+
```tsx
|
|
75
|
+
import { useRef } from 'preact/hooks'
|
|
76
|
+
import { useMutationObserver } from 'preact-missing-hooks'
|
|
77
|
+
|
|
78
|
+
function ExampleMutation() {
|
|
79
|
+
const ref = useRef<HTMLDivElement>(null)
|
|
80
|
+
|
|
81
|
+
useMutationObserver(
|
|
82
|
+
ref,
|
|
83
|
+
(mutations) => {
|
|
84
|
+
console.log('Detected mutations:', mutations)
|
|
85
|
+
},
|
|
86
|
+
{ childList: true, subtree: true },
|
|
87
|
+
)
|
|
88
|
+
|
|
89
|
+
return <div ref={ref}>Observe this content</div>
|
|
90
|
+
}
|
|
91
|
+
```
|
|
58
92
|
|
|
59
|
-
|
|
60
|
-
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
### `useEventBus`
|
|
96
|
+
|
|
97
|
+
```tsx
|
|
98
|
+
// types.ts
|
|
99
|
+
export type Events = {
|
|
100
|
+
notify: (message: string) => void
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
// Sender.tsx
|
|
104
|
+
import { useEventBus } from 'preact-missing-hooks'
|
|
105
|
+
import type { Events } from './types'
|
|
106
|
+
|
|
107
|
+
function Sender() {
|
|
108
|
+
const { emit } = useEventBus<Events>()
|
|
109
|
+
return <button onClick={() => emit('notify', 'Hello World!')}>Send</button>
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
// Receiver.tsx
|
|
113
|
+
import { useEventBus } from 'preact-missing-hooks'
|
|
114
|
+
import { useState, useEffect } from 'preact/hooks'
|
|
115
|
+
import type { Events } from './types'
|
|
116
|
+
|
|
117
|
+
function Receiver() {
|
|
118
|
+
const [msg, setMsg] = useState<string>('')
|
|
119
|
+
const { on } = useEventBus<Events>()
|
|
120
|
+
|
|
121
|
+
useEffect(() => {
|
|
122
|
+
const unsubscribe = on('notify', setMsg)
|
|
123
|
+
return unsubscribe
|
|
124
|
+
}, [])
|
|
125
|
+
|
|
126
|
+
return <div>Message: {msg}</div>
|
|
127
|
+
}
|
|
128
|
+
```
|
|
61
129
|
|
|
62
130
|
---
|
|
63
131
|
|
|
64
|
-
|
|
132
|
+
### `useWrappedChildren`
|
|
65
133
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
134
|
+
```tsx
|
|
135
|
+
import { useWrappedChildren } from 'preact-missing-hooks'
|
|
136
|
+
|
|
137
|
+
function ParentComponent({ children }) {
|
|
138
|
+
// Inject common props into all children
|
|
139
|
+
const injectProps = {
|
|
140
|
+
className: 'enhanced-child',
|
|
141
|
+
onClick: () => console.log('Child clicked!'),
|
|
142
|
+
style: { border: '1px solid #ccc' },
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
const wrappedChildren = useWrappedChildren(children, injectProps)
|
|
146
|
+
|
|
147
|
+
return <div className="parent">{wrappedChildren}</div>
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
// Usage with preserve strategy (default - existing props are preserved)
|
|
151
|
+
function PreserveExample() {
|
|
152
|
+
return (
|
|
153
|
+
<ParentComponent>
|
|
154
|
+
<button className="btn">Existing class preserved</button>
|
|
155
|
+
<span style={{ color: 'red' }}>Both styles applied</span>
|
|
156
|
+
</ParentComponent>
|
|
157
|
+
)
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
// Usage with override strategy (injected props override existing ones)
|
|
161
|
+
function OverrideExample() {
|
|
162
|
+
const injectProps = { className: 'new-class' }
|
|
163
|
+
const children = (
|
|
164
|
+
<button className="old-class">Class will be overridden</button>
|
|
165
|
+
)
|
|
166
|
+
|
|
167
|
+
const wrappedChildren = useWrappedChildren(children, injectProps, 'override')
|
|
168
|
+
|
|
169
|
+
return <div>{wrappedChildren}</div>
|
|
170
|
+
}
|
|
171
|
+
```
|
|
69
172
|
|
|
70
173
|
---
|
|
71
174
|
|
|
72
|
-
|
|
175
|
+
### `usePreferredTheme`
|
|
176
|
+
|
|
177
|
+
```tsx
|
|
178
|
+
import { usePreferredTheme } from 'preact-missing-hooks'
|
|
179
|
+
|
|
180
|
+
function ThemeAwareComponent() {
|
|
181
|
+
const theme = usePreferredTheme() // 'light' | 'dark' | 'no-preference'
|
|
182
|
+
|
|
183
|
+
return <div data-theme={theme}>Your system prefers: {theme}</div>
|
|
184
|
+
}
|
|
185
|
+
```
|
|
73
186
|
|
|
74
|
-
* `useMutationObserver`: For observing changes in DOM mutations.
|
|
75
187
|
---
|
|
76
188
|
|
|
189
|
+
### `useNetworkState`
|
|
77
190
|
|
|
78
|
-
|
|
191
|
+
```tsx
|
|
192
|
+
import { useNetworkState } from 'preact-missing-hooks'
|
|
193
|
+
|
|
194
|
+
function NetworkStatus() {
|
|
195
|
+
const { online, effectiveType, saveData } = useNetworkState()
|
|
79
196
|
|
|
80
|
-
|
|
197
|
+
return (
|
|
198
|
+
<div>
|
|
199
|
+
Status: {online ? 'Online' : 'Offline'}
|
|
200
|
+
{effectiveType && ` (${effectiveType})`}
|
|
201
|
+
{saveData && ' — Reduced data mode enabled'}
|
|
202
|
+
</div>
|
|
203
|
+
)
|
|
204
|
+
}
|
|
205
|
+
```
|
|
81
206
|
|
|
82
207
|
---
|
|
83
208
|
|
|
84
|
-
|
|
209
|
+
### `useClipboard`
|
|
210
|
+
|
|
211
|
+
```tsx
|
|
212
|
+
import { useState } from 'preact/hooks'
|
|
213
|
+
import { useClipboard } from 'preact-missing-hooks'
|
|
214
|
+
|
|
215
|
+
function CopyButton() {
|
|
216
|
+
const { copy, copied, error } = useClipboard({ resetDelay: 2000 })
|
|
217
|
+
|
|
218
|
+
return (
|
|
219
|
+
<button onClick={() => copy('Hello, World!')}>
|
|
220
|
+
{copied ? 'Copied!' : 'Copy'}
|
|
221
|
+
</button>
|
|
222
|
+
)
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
function PasteInput() {
|
|
226
|
+
const [text, setText] = useState('')
|
|
227
|
+
const { paste } = useClipboard()
|
|
228
|
+
|
|
229
|
+
const handlePaste = async () => {
|
|
230
|
+
const content = await paste()
|
|
231
|
+
setText(content)
|
|
232
|
+
}
|
|
85
233
|
|
|
86
|
-
|
|
234
|
+
return (
|
|
235
|
+
<div>
|
|
236
|
+
<input value={text} onChange={(e) => setText(e.target.value)} />
|
|
237
|
+
<button onClick={handlePaste}>Paste</button>
|
|
238
|
+
</div>
|
|
239
|
+
)
|
|
240
|
+
}
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
---
|
|
244
|
+
|
|
245
|
+
## 🛠 Built With
|
|
246
|
+
|
|
247
|
+
- [Preact](https://preactjs.com)
|
|
248
|
+
- [Microbundle](https://github.com/developit/microbundle)
|
|
249
|
+
- [TypeScript](https://www.typescriptlang.org)
|
|
250
|
+
- [Vitest](https://vitest.dev) for testing
|
|
87
251
|
|
|
88
252
|
---
|
|
89
253
|
|
|
90
|
-
##
|
|
254
|
+
## 📝 License
|
|
255
|
+
|
|
256
|
+
MIT © [Prakhar Dubey](https://github.com/prakhardubey2002)
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## 📬 Contributing
|
|
91
261
|
|
|
92
|
-
|
|
93
|
-
* [Preact Documentation](https://preactjs.com/guide/v10/getting-started/)
|
|
262
|
+
Contributions are welcome! Please open issues or submit PRs with new hooks or improvements.
|
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var e=require("preact/hooks");exports.useTransition=function(){var r=e.useState(!1),n=r[0],t=r[1];return[e.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),n]};
|
|
1
|
+
var e=require("preact/hooks"),r=require("preact"),n=new Map;function t(){return t=Object.assign?Object.assign.bind():function(e){for(var r=1;r<arguments.length;r++){var n=arguments[r];for(var t in n)({}).hasOwnProperty.call(n,t)&&(e[t]=n[t])}return e},t.apply(null,arguments)}function o(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},r=navigator.connection;return r&&(void 0!==r.effectiveType&&(e.effectiveType=r.effectiveType),void 0!==r.downlink&&(e.downlink=r.downlink),void 0!==r.rtt&&(e.rtt=r.rtt),void 0!==r.saveData&&(e.saveData=r.saveData),void 0!==r.type&&(e.connectionType=r.type)),e}function i(e,r){try{var n=e()}catch(e){return r(e)}return n&&n.then?n.then(void 0,r):n}exports.useClipboard=function(r){void 0===r&&(r={});var n=r.resetDelay,t=void 0===n?2e3:n,o=e.useState(!1),a=o[0],u=o[1],c=e.useState(null),s=c[0],f=c[1],v=e.useCallback(function(){u(!1),f(null)},[]);return{copy:e.useCallback(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var r=new Error("Clipboard API is not available");return f(r),Promise.resolve(!1)}return Promise.resolve(i(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return u(!0),t>0&&setTimeout(function(){return u(!1)},t),!0})},function(e){var r=e instanceof Error?e:new Error(String(e));return f(r),!1}))}catch(e){return Promise.reject(e)}},[t]),paste:e.useCallback(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(i(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var r=e instanceof Error?e:new Error(String(e));return f(r),""}))}catch(e){return Promise.reject(e)}},[]),copied:a,error:s,reset:v}},exports.useEventBus=function(){return{emit:e.useCallback(function(e){var r=arguments,t=n.get(e);t&&t.forEach(function(e){return e.apply(void 0,[].slice.call(r,1))})},[]),on:e.useCallback(function(e,r){var t=n.get(e);return t||(t=new Set,n.set(e,t)),t.add(r),function(){t.delete(r),0===t.size&&n.delete(e)}},[])}},exports.useMutationObserver=function(r,n,t){e.useEffect(function(){var e=r.current;if(e){var o=new MutationObserver(n);return o.observe(e,t),function(){return o.disconnect()}}},[r,n,t])},exports.useNetworkState=function(){var r=e.useState(o),n=r[0],t=r[1];return e.useEffect(function(){if("undefined"!=typeof window){var e=function(){return t(o())};window.addEventListener("online",e),window.addEventListener("offline",e);var r=navigator.connection;return null!=r&&r.addEventListener&&r.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=r&&r.removeEventListener&&r.removeEventListener("change",e)}}},[]),n},exports.usePreferredTheme=function(){var r=e.useState(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),r=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":r.matches?"light":"no-preference"}),n=r[0],t=r[1];return e.useEffect(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),r=function(e){t(e.matches?"dark":"light")},n=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),r=window.matchMedia("(prefers-color-scheme: light)");t(e.matches?"dark":r.matches?"light":"no-preference")};e.addEventListener("change",r);var o=window.matchMedia("(prefers-color-scheme: light)");return o.addEventListener("change",n),function(){e.removeEventListener("change",r),o.removeEventListener("change",n)}}},[]),n},exports.useTransition=function(){var r=e.useState(!1),n=r[0],t=r[1];return[e.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),n]},exports.useWrappedChildren=function(n,o,i){return void 0===i&&(i="preserve"),e.useMemo(function(){if(!n)return n;var e=function(e){if(!r.isValidElement(e))return e;var n,a=e.props||{};n="override"===i?t({},a,o):t({},o,a);var u=null==a?void 0:a.style,c=null==o?void 0:o.style;return u&&c&&"object"==typeof u&&"object"==typeof c&&(n.style="override"===i?t({},u,c):t({},c,u)),r.cloneElement(e,n)};return Array.isArray(n)?n.map(e):e(n)},[n,o,i])};
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sources":["../src/useTransition.ts"],"sourcesContent":["import { useState, useCallback } from 'preact/hooks';\r\n\r\n/**\r\n * Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n */\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n"],"names":["_useState","useState","isPending","setIsPending","useCallback","callback","Promise","resolve","then"],"mappings":"oDAMgB,WACd,IAAAA,EAAkCC,EAAQA,UAAC,GAApCC,EAASF,KAAEG,EAAYH,EAAA,GAU9B,MAAO,CARiBI,EAAWA,YAAC,SAACC,GACnCF,GAAa,GACbG,QAAQC,UAAUC,KAAK,WACrBH,IACAF,GAAa,EACf,EACF,EAAG,IAEsBD,EAC3B"}
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../src/useEventBus.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useMutationObserver.ts","../src/usePreferredTheme.ts","../src/useTransition.ts","../src/useWrappedChildren.ts"],"sourcesContent":["import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/**\r\n * A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n */\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/** Network Information API (not in all browsers) */\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/** Effective connection type from Network Information API */\r\nexport type EffectiveConnectionType = 'slow-2g' | '2g' | '3g' | '4g';\r\n\r\n/** Network connection type (e.g., wifi, cellular) */\r\nexport type ConnectionType =\r\n | 'bluetooth'\r\n | 'cellular'\r\n | 'ethernet'\r\n | 'mixed'\r\n | 'none'\r\n | 'other'\r\n | 'unknown'\r\n | 'wifi';\r\n\r\nexport interface NetworkState {\r\n /** Whether the browser is online */\r\n online: boolean;\r\n /** Effective connection type (when supported) */\r\n effectiveType?: EffectiveConnectionType;\r\n /** Estimated downlink speed in Mbps (when supported) */\r\n downlink?: number;\r\n /** Estimated round-trip time in ms (when supported) */\r\n rtt?: number;\r\n /** Whether the user has requested reduced data usage (when supported) */\r\n saveData?: boolean;\r\n /** Connection type (when supported) */\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/**\r\n * A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n *\r\n * @returns The current network state object\r\n *\r\n * @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /** Duration in ms to keep `copied` true before resetting. Default: 2000 */\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /** Copy text to the clipboard. Returns true on success. */\r\n copy: (text: string) => Promise<boolean>;\r\n /** Read text from the clipboard. Returns empty string if denied or unavailable. */\r\n paste: () => Promise<string>;\r\n /** Whether the last copy operation succeeded (resets after resetDelay) */\r\n copied: boolean;\r\n /** Error from the last failed operation, or null */\r\n error: Error | null;\r\n /** Manually reset copied and error state */\r\n reset: () => void;\r\n}\r\n\r\n/**\r\n * A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n *\r\n * @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n *\r\n * @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error | null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/**\r\n * A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n */\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement | null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' | 'dark' | 'no-preference';\r\n\r\n/**\r\n * A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n *\r\n * @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n *\r\n * @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useState, useCallback } from 'preact/hooks';\r\n\r\n/**\r\n * Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n */\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/**\r\n * A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' | 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' | 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props || {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}"],"names":["listeners","Map","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","options","_options$resetDelay","resetDelay","_useState","useState","copied","setCopied","_useState2","error","setError","reset","useCallback","copy","text","clipboard","err","Error","Promise","resolve","_catch","writeText","then","setTimeout","e","String","reject","paste","readText","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","targetRef","callback","useEffect","node","current","observer","MutationObserver","observe","disconnect","setState","window","updateState","addEventListener","removeEventListener","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","updateTheme","isPending","setIsPending","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map"],"mappings":"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"}
|
package/dist/index.module.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{useState as
|
|
1
|
+
import{useState as e,useCallback as n,useEffect as r,useMemo as t}from"preact/hooks";import{isValidElement as o,cloneElement as i}from"preact";function a(){var r=e(!1),t=r[0],o=r[1];return[n(function(e){o(!0),Promise.resolve().then(function(){e(),o(!1)})},[]),t]}function c(e,n,t){r(function(){var r=e.current;if(r){var o=new MutationObserver(n);return o.observe(r,t),function(){return o.disconnect()}}},[e,n,t])}var u=new Map;function v(){var e=n(function(e){var n=arguments,r=u.get(e);r&&r.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]);return{emit:e,on:n(function(e,n){var r=u.get(e);return r||(r=new Set,u.set(e,r)),r.add(n),function(){r.delete(n),0===r.size&&u.delete(e)}},[])}}function f(){return f=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},f.apply(null,arguments)}function d(e,n,r){return void 0===r&&(r="preserve"),t(function(){if(!e)return e;var t=function(e){if(!o(e))return e;var t,a=e.props||{};t="override"===r?f({},a,n):f({},n,a);var c=null==a?void 0:a.style,u=null==n?void 0:n.style;return c&&u&&"object"==typeof c&&"object"==typeof u&&(t.style="override"===r?f({},c,u):f({},u,c)),i(e,t)};return Array.isArray(e)?e.map(t):t(e)},[e,n,r])}function s(){var n=e(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),t=n[0],o=n[1];return r(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){o(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");o(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var t=window.matchMedia("(prefers-color-scheme: light)");return t.addEventListener("change",r),function(){e.removeEventListener("change",n),t.removeEventListener("change",r)}}},[]),t}function l(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function p(){var n=e(l),t=n[0],o=n[1];return r(function(){if("undefined"!=typeof window){var e=function(){return o(l())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),t}function h(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}function m(r){void 0===r&&(r={});var t=r.resetDelay,o=void 0===t?2e3:t,i=e(!1),a=i[0],c=i[1],u=e(null),v=u[0],f=u[1],d=n(function(){c(!1),f(null)},[]);return{copy:n(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(h(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return c(!0),o>0&&setTimeout(function(){return c(!1)},o),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[o]),paste:n(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(h(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:a,error:v,reset:d}}export{m as useClipboard,v as useEventBus,c as useMutationObserver,p as useNetworkState,s as usePreferredTheme,a as useTransition,d as useWrappedChildren};
|
|
2
2
|
//# sourceMappingURL=index.module.js.map
|
package/dist/index.module.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.module.js","sources":["../src/useTransition.ts"],"sourcesContent":["import { useState, useCallback } from 'preact/hooks';\r\n\r\n/**\r\n * Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n */\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n"],"names":["useTransition","_useState","useState","isPending","setIsPending","useCallback","callback","Promise","resolve","then"],"mappings":"yDAMgB,SAAAA,IACd,IAAAC,EAAkCC,GAAS,GAApCC,EAASF,KAAEG,EAAYH,EAAA,GAU9B,MAAO,CARiBI,EAAY,SAACC,GACnCF,GAAa,GACbG,QAAQC,UAAUC,KAAK,WACrBH,IACAF,GAAa,EACf,EACF,EAAG,IAEsBD,EAC3B"}
|
|
1
|
+
{"version":3,"file":"index.module.js","sources":["../src/useTransition.ts","../src/useMutationObserver.ts","../src/useEventBus.ts","../src/useWrappedChildren.ts","../src/usePreferredTheme.ts","../src/useNetworkState.ts","../src/useClipboard.ts"],"sourcesContent":["import { useState, useCallback } from 'preact/hooks';\r\n\r\n/**\r\n * Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n */\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/**\r\n * A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n */\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement | null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/**\r\n * A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n */\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/**\r\n * A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' | 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' | 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props || {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' | 'dark' | 'no-preference';\r\n\r\n/**\r\n * A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n *\r\n * @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n *\r\n * @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/** Network Information API (not in all browsers) */\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/** Effective connection type from Network Information API */\r\nexport type EffectiveConnectionType = 'slow-2g' | '2g' | '3g' | '4g';\r\n\r\n/** Network connection type (e.g., wifi, cellular) */\r\nexport type ConnectionType =\r\n | 'bluetooth'\r\n | 'cellular'\r\n | 'ethernet'\r\n | 'mixed'\r\n | 'none'\r\n | 'other'\r\n | 'unknown'\r\n | 'wifi';\r\n\r\nexport interface NetworkState {\r\n /** Whether the browser is online */\r\n online: boolean;\r\n /** Effective connection type (when supported) */\r\n effectiveType?: EffectiveConnectionType;\r\n /** Estimated downlink speed in Mbps (when supported) */\r\n downlink?: number;\r\n /** Estimated round-trip time in ms (when supported) */\r\n rtt?: number;\r\n /** Whether the user has requested reduced data usage (when supported) */\r\n saveData?: boolean;\r\n /** Connection type (when supported) */\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/**\r\n * A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n *\r\n * @returns The current network state object\r\n *\r\n * @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /** Duration in ms to keep `copied` true before resetting. Default: 2000 */\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /** Copy text to the clipboard. Returns true on success. */\r\n copy: (text: string) => Promise<boolean>;\r\n /** Read text from the clipboard. Returns empty string if denied or unavailable. */\r\n paste: () => Promise<string>;\r\n /** Whether the last copy operation succeeded (resets after resetDelay) */\r\n copied: boolean;\r\n /** Error from the last failed operation, or null */\r\n error: Error | null;\r\n /** Manually reset copied and error state */\r\n reset: () => void;\r\n}\r\n\r\n/**\r\n * A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n *\r\n * @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n *\r\n * @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error | null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n"],"names":["useTransition","_useState","useState","isPending","setIsPending","useCallback","callback","Promise","resolve","then","useMutationObserver","targetRef","options","useEffect","node","current","observer","MutationObserver","observe","disconnect","listeners","Map","useEventBus","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","useWrappedChildren","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map","usePreferredTheme","window","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","e","updateTheme","addEventListener","removeEventListener","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","useNetworkState","setState","updateState","useClipboard","_options$resetDelay","resetDelay","copied","setCopied","_useState2","error","setError","reset","copy","text","clipboard","err","Error","_catch","writeText","setTimeout","String","reject","paste","readText"],"mappings":"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"}
|
package/dist/index.umd.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
!function(e,
|
|
1
|
+
!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports,require("preact/hooks"),require("preact")):"function"==typeof define&&define.amd?define(["exports","preact/hooks","preact"],n):n((e||self).preactMissingHooks={},e.hooks,e.preact)}(this,function(e,n,r){var t=new Map;function o(){return o=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},o.apply(null,arguments)}function i(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function a(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}e.useClipboard=function(e){void 0===e&&(e={});var r=e.resetDelay,t=void 0===r?2e3:r,o=n.useState(!1),i=o[0],c=o[1],u=n.useState(null),s=u[0],f=u[1],d=n.useCallback(function(){c(!1),f(null)},[]);return{copy:n.useCallback(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(a(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return c(!0),t>0&&setTimeout(function(){return c(!1)},t),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[t]),paste:n.useCallback(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(a(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:i,error:s,reset:d}},e.useEventBus=function(){var e=n.useCallback(function(e){var n=arguments,r=t.get(e);r&&r.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]);return{emit:e,on:n.useCallback(function(e,n){var r=t.get(e);return r||(r=new Set,t.set(e,r)),r.add(n),function(){r.delete(n),0===r.size&&t.delete(e)}},[])}},e.useMutationObserver=function(e,r,t){n.useEffect(function(){var n=e.current;if(n){var o=new MutationObserver(r);return o.observe(n,t),function(){return o.disconnect()}}},[e,r,t])},e.useNetworkState=function(){var e=n.useState(i),r=e[0],t=e[1];return n.useEffect(function(){if("undefined"!=typeof window){var e=function(){return t(i())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),r},e.usePreferredTheme=function(){var e=n.useState(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),r=e[0],t=e[1];return n.useEffect(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){t(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");t(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var o=window.matchMedia("(prefers-color-scheme: light)");return o.addEventListener("change",r),function(){e.removeEventListener("change",n),o.removeEventListener("change",r)}}},[]),r},e.useTransition=function(){var e=n.useState(!1),r=e[0],t=e[1];return[n.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),r]},e.useWrappedChildren=function(e,t,i){return void 0===i&&(i="preserve"),n.useMemo(function(){if(!e)return e;var n=function(e){if(!r.isValidElement(e))return e;var n,a=e.props||{};n="override"===i?o({},a,t):o({},t,a);var c=null==a?void 0:a.style,u=null==t?void 0:t.style;return c&&u&&"object"==typeof c&&"object"==typeof u&&(n.style="override"===i?o({},c,u):o({},u,c)),r.cloneElement(e,n)};return Array.isArray(e)?e.map(n):n(e)},[e,t,i])}});
|
|
2
2
|
//# sourceMappingURL=index.umd.js.map
|
package/dist/index.umd.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.umd.js","sources":["../src/useTransition.ts"],"sourcesContent":["import { useState, useCallback } from 'preact/hooks';\r\n\r\n/**\r\n * Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n */\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n"],"names":["_useState","useState","isPending","setIsPending","useCallback","callback","Promise","resolve","then"],"mappings":"6SAMgB,WACd,IAAAA,EAAkCC,EAAQA,UAAC,GAApCC,EAASF,KAAEG,EAAYH,EAAA,GAU9B,MAAO,CARiBI,EAAWA,YAAC,SAACC,GACnCF,GAAa,GACbG,QAAQC,UAAUC,KAAK,WACrBH,IACAF,GAAa,EACf,EACF,EAAG,IAEsBD,EAC3B"}
|
|
1
|
+
{"version":3,"file":"index.umd.js","sources":["../src/useEventBus.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useMutationObserver.ts","../src/usePreferredTheme.ts","../src/useTransition.ts","../src/useWrappedChildren.ts"],"sourcesContent":["import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/**\r\n * A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n */\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/** Network Information API (not in all browsers) */\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/** Effective connection type from Network Information API */\r\nexport type EffectiveConnectionType = 'slow-2g' | '2g' | '3g' | '4g';\r\n\r\n/** Network connection type (e.g., wifi, cellular) */\r\nexport type ConnectionType =\r\n | 'bluetooth'\r\n | 'cellular'\r\n | 'ethernet'\r\n | 'mixed'\r\n | 'none'\r\n | 'other'\r\n | 'unknown'\r\n | 'wifi';\r\n\r\nexport interface NetworkState {\r\n /** Whether the browser is online */\r\n online: boolean;\r\n /** Effective connection type (when supported) */\r\n effectiveType?: EffectiveConnectionType;\r\n /** Estimated downlink speed in Mbps (when supported) */\r\n downlink?: number;\r\n /** Estimated round-trip time in ms (when supported) */\r\n rtt?: number;\r\n /** Whether the user has requested reduced data usage (when supported) */\r\n saveData?: boolean;\r\n /** Connection type (when supported) */\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/**\r\n * A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n *\r\n * @returns The current network state object\r\n *\r\n * @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /** Duration in ms to keep `copied` true before resetting. Default: 2000 */\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /** Copy text to the clipboard. Returns true on success. */\r\n copy: (text: string) => Promise<boolean>;\r\n /** Read text from the clipboard. Returns empty string if denied or unavailable. */\r\n paste: () => Promise<string>;\r\n /** Whether the last copy operation succeeded (resets after resetDelay) */\r\n copied: boolean;\r\n /** Error from the last failed operation, or null */\r\n error: Error | null;\r\n /** Manually reset copied and error state */\r\n reset: () => void;\r\n}\r\n\r\n/**\r\n * A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n *\r\n * @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n *\r\n * @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error | null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/**\r\n * A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n */\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement | null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' | 'dark' | 'no-preference';\r\n\r\n/**\r\n * A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n *\r\n * @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n *\r\n * @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useState, useCallback } from 'preact/hooks';\r\n\r\n/**\r\n * Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n */\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/**\r\n * A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' | 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' | 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props || {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}"],"names":["listeners","Map","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","options","_options$resetDelay","resetDelay","_useState","useState","copied","setCopied","_useState2","error","setError","reset","useCallback","copy","text","clipboard","err","Error","Promise","resolve","_catch","writeText","then","setTimeout","e","String","reject","paste","readText","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","targetRef","callback","useEffect","node","current","observer","MutationObserver","observe","disconnect","setState","window","updateState","addEventListener","removeEventListener","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","updateTheme","isPending","setIsPending","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map"],"mappings":"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"}
|