@bazza-ui/react 0.0.0 → 0.1.0-canary.10

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.
Files changed (113) hide show
  1. package/dist/ListboxStore-BYBpGrOz.d.ts +453 -0
  2. package/dist/ListboxStore-nmorsoqX.d.cts +453 -0
  3. package/dist/chunk-4C666HHU.js +2 -0
  4. package/dist/chunk-4C666HHU.js.map +1 -0
  5. package/dist/chunk-5T5B5SPR.cjs +2 -0
  6. package/dist/chunk-5T5B5SPR.cjs.map +1 -0
  7. package/dist/chunk-A4Z5BY7H.js +2 -0
  8. package/dist/chunk-A4Z5BY7H.js.map +1 -0
  9. package/dist/chunk-BFOY762U.js +2 -0
  10. package/dist/chunk-BFOY762U.js.map +1 -0
  11. package/dist/chunk-IT372NHF.js +2 -0
  12. package/dist/chunk-IT372NHF.js.map +1 -0
  13. package/dist/chunk-JFEVUUPC.cjs +2 -0
  14. package/dist/chunk-JFEVUUPC.cjs.map +1 -0
  15. package/dist/chunk-KO3DXT3Y.js +2 -0
  16. package/dist/chunk-KO3DXT3Y.js.map +1 -0
  17. package/dist/chunk-LXXK4S4Q.js +2 -0
  18. package/dist/chunk-LXXK4S4Q.js.map +1 -0
  19. package/dist/chunk-M4G6J7DP.cjs +2 -0
  20. package/dist/chunk-M4G6J7DP.cjs.map +1 -0
  21. package/dist/chunk-SCDHQZFI.cjs +2 -0
  22. package/dist/chunk-SCDHQZFI.cjs.map +1 -0
  23. package/dist/chunk-W4ACKMIZ.cjs +2 -0
  24. package/dist/chunk-W4ACKMIZ.cjs.map +1 -0
  25. package/dist/chunk-XMZZ62VJ.cjs +2 -0
  26. package/dist/chunk-XMZZ62VJ.cjs.map +1 -0
  27. package/dist/combobox/index.cjs +2 -0
  28. package/dist/combobox/index.cjs.map +1 -0
  29. package/dist/combobox/index.d.cts +1066 -0
  30. package/dist/combobox/index.d.ts +1066 -0
  31. package/dist/combobox/index.js +2 -0
  32. package/dist/combobox/index.js.map +1 -0
  33. package/dist/command-menu/index.cjs +2 -0
  34. package/dist/command-menu/index.cjs.map +1 -0
  35. package/dist/command-menu/index.d.cts +154 -0
  36. package/dist/command-menu/index.d.ts +154 -0
  37. package/dist/command-menu/index.js +2 -0
  38. package/dist/command-menu/index.js.map +1 -0
  39. package/dist/command-score-CTJ9NV6n.d.cts +23 -0
  40. package/dist/command-score-CTJ9NV6n.d.ts +23 -0
  41. package/dist/context-menu/index.cjs +2 -0
  42. package/dist/context-menu/index.cjs.map +1 -0
  43. package/dist/context-menu/index.d.cts +672 -0
  44. package/dist/context-menu/index.d.ts +672 -0
  45. package/dist/context-menu/index.js +2 -0
  46. package/dist/context-menu/index.js.map +1 -0
  47. package/dist/dropdown-menu/index.cjs +2 -0
  48. package/dist/dropdown-menu/index.cjs.map +1 -0
  49. package/dist/dropdown-menu/index.d.cts +699 -0
  50. package/dist/dropdown-menu/index.d.ts +699 -0
  51. package/dist/dropdown-menu/index.js +2 -0
  52. package/dist/dropdown-menu/index.js.map +1 -0
  53. package/dist/events-DOGItflK.d.ts +1776 -0
  54. package/dist/events-DPsuhBln.d.cts +1776 -0
  55. package/dist/input-C95v6jB0.d.cts +46 -0
  56. package/dist/input-CYweYB_i.d.ts +46 -0
  57. package/dist/internal/listbox/index.cjs +2 -0
  58. package/dist/internal/listbox/index.cjs.map +1 -0
  59. package/dist/internal/listbox/index.d.cts +272 -0
  60. package/dist/internal/listbox/index.d.ts +272 -0
  61. package/dist/internal/listbox/index.js +2 -0
  62. package/dist/internal/listbox/index.js.map +1 -0
  63. package/dist/internal/popup-menu/index.cjs +2 -0
  64. package/dist/internal/popup-menu/index.cjs.map +1 -0
  65. package/dist/internal/popup-menu/index.d.cts +238 -0
  66. package/dist/internal/popup-menu/index.d.ts +238 -0
  67. package/dist/internal/popup-menu/index.js +2 -0
  68. package/dist/internal/popup-menu/index.js.map +1 -0
  69. package/dist/items-B6HeFO_8.d.cts +37 -0
  70. package/dist/items-B6HeFO_8.d.ts +37 -0
  71. package/dist/kbd/index.cjs +2 -0
  72. package/dist/kbd/index.cjs.map +1 -0
  73. package/dist/kbd/index.d.cts +61 -0
  74. package/dist/kbd/index.d.ts +61 -0
  75. package/dist/kbd/index.js +2 -0
  76. package/dist/kbd/index.js.map +1 -0
  77. package/dist/loaders/index.cjs +2 -0
  78. package/dist/loaders/index.cjs.map +1 -0
  79. package/dist/loaders/index.d.cts +363 -0
  80. package/dist/loaders/index.d.ts +363 -0
  81. package/dist/loaders/index.js +2 -0
  82. package/dist/loaders/index.js.map +1 -0
  83. package/dist/loading-C6WZGUc3.d.cts +29 -0
  84. package/dist/loading-CC4n55sR.d.ts +29 -0
  85. package/dist/resolve-BYm41YfG.d.ts +406 -0
  86. package/dist/resolve-Dk_fAKb2.d.cts +406 -0
  87. package/dist/scroll-arrow-B81wZTZ2.d.cts +544 -0
  88. package/dist/scroll-arrow-CNd0tgME.d.ts +544 -0
  89. package/dist/select/index.cjs +2 -0
  90. package/dist/select/index.cjs.map +1 -0
  91. package/dist/select/index.d.cts +985 -0
  92. package/dist/select/index.d.ts +985 -0
  93. package/dist/select/index.js +2 -0
  94. package/dist/select/index.js.map +1 -0
  95. package/dist/separator-BiySI623.d.cts +275 -0
  96. package/dist/separator-De8l8DKO.d.ts +275 -0
  97. package/dist/surface-context-ClmxshBW.d.ts +14 -0
  98. package/dist/surface-context-DF-L-30G.d.cts +14 -0
  99. package/dist/type-guards-BC2B6bVi.d.cts +350 -0
  100. package/dist/type-guards-ybcHBB3C.d.ts +350 -0
  101. package/dist/types-DT4FOOa2.d.cts +51 -0
  102. package/dist/types-DT4FOOa2.d.ts +51 -0
  103. package/dist/use-listbox-item-NzZuY34-.d.cts +212 -0
  104. package/dist/use-listbox-item-NzZuY34-.d.ts +212 -0
  105. package/dist/video-player/index.cjs +3 -0
  106. package/dist/video-player/index.cjs.map +1 -0
  107. package/dist/video-player/index.d.cts +1391 -0
  108. package/dist/video-player/index.d.ts +1391 -0
  109. package/dist/video-player/index.js +3 -0
  110. package/dist/video-player/index.js.map +1 -0
  111. package/package.json +66 -12
  112. package/dist/index.d.ts +0 -2
  113. package/dist/index.js +0 -2
@@ -0,0 +1,363 @@
1
+ import * as React from 'react';
2
+ import { N as NodeDef, ae as InitialQueryBehavior, ai as LoaderComponentProps, ak as QueryLoaderConfig, ay as StaticLoaderConfig, R as AsyncLoaderResult } from '../events-DOGItflK.js';
3
+ import '../types-DT4FOOa2.js';
4
+
5
+ /**
6
+ * SWR result shape (subset of SWRResponse).
7
+ * This allows the adapter to work without requiring `swr` as a dependency.
8
+ */
9
+ interface SWRResult<TData, TError = Error> {
10
+ data: TData | undefined;
11
+ error: TError | undefined;
12
+ isLoading?: boolean;
13
+ isValidating: boolean;
14
+ isPaused?: boolean;
15
+ mutate: (...args: unknown[]) => unknown;
16
+ }
17
+ /**
18
+ * Converts an SWR result to an AsyncLoaderResult.
19
+ */
20
+ declare function toAsyncLoaderResultFromSWR<TData, TError = Error>(result: SWRResult<TData, TError>): AsyncLoaderResult<TData, SWRResult<TData, TError>>;
21
+ /**
22
+ * Props for creating a static SWR loader component.
23
+ */
24
+ interface CreateSWRStaticLoaderProps {
25
+ /** Hook that returns an SWR result. */
26
+ useSWR: () => SWRResult<NodeDef[]>;
27
+ /**
28
+ * When to trigger the loader:
29
+ * - 'eager': Load when root menu opens
30
+ * - 'lazy': Load when submenu opens (default)
31
+ */
32
+ loadStrategy?: 'eager' | 'lazy';
33
+ }
34
+ /**
35
+ * Creates a static loader configuration backed by SWR.
36
+ */
37
+ declare function createSWRStaticLoader(props: CreateSWRStaticLoaderProps): StaticLoaderConfig;
38
+ /**
39
+ * Props for creating a query SWR loader component.
40
+ */
41
+ interface CreateSWRQueryLoaderProps {
42
+ /**
43
+ * Hook that returns an SWR result based on the search query.
44
+ * `options.enabled` can be used to derive a `null` key and disable fetching.
45
+ */
46
+ useSWR: (query: string, options?: {
47
+ enabled: boolean;
48
+ }) => SWRResult<NodeDef[]>;
49
+ /**
50
+ * Minimum query length before fetching.
51
+ * @default 1
52
+ */
53
+ minQueryLength?: number;
54
+ /**
55
+ * Initial query behavior before user input reaches minQueryLength.
56
+ * Defaults to fetching with an empty query.
57
+ */
58
+ initialQueryBehavior?: InitialQueryBehavior | false;
59
+ /**
60
+ * @deprecated Use `initialQueryBehavior` instead.
61
+ */
62
+ initialQuery?: string;
63
+ /**
64
+ * When to trigger the loader:
65
+ * - 'eager': Load when root menu opens (good for deep search)
66
+ * - 'lazy': Load when submenu opens (default)
67
+ * @default 'lazy'
68
+ */
69
+ loadStrategy?: 'eager' | 'lazy';
70
+ /**
71
+ * What to show when query is below minQueryLength.
72
+ * @default 'empty'
73
+ */
74
+ belowMinBehavior?: 'empty' | 'placeholder';
75
+ /**
76
+ * Placeholder nodes shown when query is below minQueryLength.
77
+ */
78
+ placeholderNodes?: NodeDef[];
79
+ }
80
+ /**
81
+ * Creates a query loader configuration backed by SWR.
82
+ */
83
+ declare function createSWRQueryLoader(props: CreateSWRQueryLoaderProps): QueryLoaderConfig;
84
+ /**
85
+ * Creates a loader component that wraps an SWR hook.
86
+ */
87
+ declare function createSWRLoaderComponent(useSWRFn: (query: string) => SWRResult<NodeDef[]>): React.FC<LoaderComponentProps>;
88
+
89
+ /**
90
+ * TanStack Query result shape (subset of UseQueryResult).
91
+ * This allows the adapter to work without requiring @tanstack/react-query as a dependency.
92
+ */
93
+ interface TanStackQueryResult<TData, TError = Error> {
94
+ /** TanStack status (`pending` | `error` | `success`) */
95
+ status?: 'pending' | 'error' | 'success';
96
+ /** TanStack fetch status (`fetching` | `paused` | `idle`) */
97
+ fetchStatus?: 'fetching' | 'paused' | 'idle';
98
+ data: TData | undefined;
99
+ error: TError | null | undefined;
100
+ /** v5: true when first fetch is in-flight */
101
+ isLoading?: boolean;
102
+ /** v5: true when status is pending */
103
+ isPending?: boolean;
104
+ /** true when status is success */
105
+ isSuccess?: boolean;
106
+ /** true when status is error */
107
+ isError?: boolean;
108
+ /** true while any fetch is in-flight */
109
+ isFetching?: boolean;
110
+ /** true while background refetch is in-flight */
111
+ isRefetching?: boolean;
112
+ /** true when fetch is paused */
113
+ isPaused?: boolean;
114
+ /** true once query has fetched at least once */
115
+ isFetched?: boolean;
116
+ refetch: () => unknown;
117
+ }
118
+ /**
119
+ * Converts a TanStack Query result to an AsyncLoaderResult.
120
+ * Use this to wrap your useQuery hook result.
121
+ *
122
+ * @example
123
+ * ```tsx
124
+ * function MyLoader({ query, children }) {
125
+ * const result = useQuery({
126
+ * queryKey: ['items', query],
127
+ * queryFn: () => fetchItems(query),
128
+ * })
129
+ * return children(toAsyncLoaderResult(result))
130
+ * }
131
+ * ```
132
+ */
133
+ declare function toAsyncLoaderResult<TData, TError = Error>(result: TanStackQueryResult<TData, TError>): AsyncLoaderResult<TData, TanStackQueryResult<TData, TError>>;
134
+ /**
135
+ * Props for creating a static loader component.
136
+ */
137
+ interface CreateStaticLoaderProps {
138
+ /**
139
+ * Hook that returns a TanStack Query result.
140
+ * This hook will be called inside the loader component.
141
+ */
142
+ useQuery: () => TanStackQueryResult<NodeDef[]>;
143
+ /**
144
+ * When to trigger the loader:
145
+ * - 'eager': Load when root menu opens
146
+ * - 'lazy': Load when submenu opens (default)
147
+ */
148
+ loadStrategy?: 'eager' | 'lazy';
149
+ }
150
+ /**
151
+ * Creates a static loader configuration for use with async menus.
152
+ * The hook is called inside a component, so it follows React's rules of hooks.
153
+ *
154
+ * @example
155
+ * ```tsx
156
+ * const recentFilesLoader = createStaticLoader({
157
+ * useQuery: () => useQuery({
158
+ * queryKey: ['recent-files'],
159
+ * queryFn: fetchRecentFiles,
160
+ * staleTime: 5 * 60 * 1000,
161
+ * }),
162
+ * })
163
+ *
164
+ * // Use in submenu
165
+ * {
166
+ * kind: 'submenu',
167
+ * value: 'Recent Files',
168
+ * asyncNodes: {
169
+ * ...recentFilesLoader,
170
+ * loadStrategy: 'eager',
171
+ * },
172
+ * render: ...
173
+ * }
174
+ * ```
175
+ */
176
+ declare function createStaticLoader(props: CreateStaticLoaderProps): StaticLoaderConfig;
177
+ /**
178
+ * Props for creating a query loader component.
179
+ */
180
+ interface CreateQueryLoaderProps {
181
+ /**
182
+ * Hook that returns a TanStack Query result based on the search query.
183
+ * This hook will be called inside the loader component with the current query.
184
+ */
185
+ useQuery: (query: string, options?: {
186
+ enabled: boolean;
187
+ }) => TanStackQueryResult<NodeDef[]>;
188
+ /**
189
+ * Minimum query length before fetching.
190
+ * @default 1
191
+ */
192
+ minQueryLength?: number;
193
+ /**
194
+ * Initial query behavior before user input reaches minQueryLength.
195
+ * Defaults to fetching with an empty query.
196
+ */
197
+ initialQueryBehavior?: InitialQueryBehavior | false;
198
+ /**
199
+ * @deprecated Use `initialQueryBehavior` instead.
200
+ */
201
+ initialQuery?: string;
202
+ /**
203
+ * When to trigger the loader:
204
+ * - 'eager': Load when root menu opens (good for deep search)
205
+ * - 'lazy': Load when submenu opens (default)
206
+ * @default 'lazy'
207
+ */
208
+ loadStrategy?: 'eager' | 'lazy';
209
+ /**
210
+ * What to show when query is below minQueryLength.
211
+ * @default 'empty'
212
+ */
213
+ belowMinBehavior?: 'empty' | 'placeholder';
214
+ /**
215
+ * Placeholder nodes shown when query is below minQueryLength.
216
+ */
217
+ placeholderNodes?: NodeDef[];
218
+ }
219
+ /**
220
+ * Creates a query loader configuration for use with async menus.
221
+ * The loader will re-fetch when the search query changes.
222
+ *
223
+ * @example
224
+ * ```tsx
225
+ * const searchLoader = createQueryLoader({
226
+ * useQuery: (query, options) => useQuery({
227
+ * queryKey: ['search', query],
228
+ * queryFn: () => searchItems(query),
229
+ * enabled: options?.enabled,
230
+ * }),
231
+ * minQueryLength: 2,
232
+ * })
233
+ *
234
+ * // Use in submenu
235
+ * {
236
+ * kind: 'submenu',
237
+ * value: 'Search',
238
+ * includeInDeepSearch: true,
239
+ * asyncNodes: searchLoader,
240
+ * render: ...
241
+ * }
242
+ * ```
243
+ */
244
+ declare function createQueryLoader(props: CreateQueryLoaderProps): QueryLoaderConfig;
245
+ /**
246
+ * Creates a loader component that wraps a TanStack Query hook.
247
+ * This is a lower-level utility for custom loader implementations.
248
+ *
249
+ * @example
250
+ * ```tsx
251
+ * const MyLoader = createLoaderComponent((query) =>
252
+ * useQuery({
253
+ * queryKey: ['items', query],
254
+ * queryFn: () => fetchItems(query),
255
+ * })
256
+ * )
257
+ * ```
258
+ */
259
+ declare function createLoaderComponent(useQueryFn: (query: string) => TanStackQueryResult<NodeDef[]>): React.FC<LoaderComponentProps>;
260
+
261
+ /**
262
+ * Props for creating a static loader with vanilla fetch.
263
+ */
264
+ interface CreateVanillaStaticLoaderProps {
265
+ /**
266
+ * Async function that fetches the menu items.
267
+ */
268
+ fetcher: () => Promise<NodeDef[]>;
269
+ /**
270
+ * When to trigger the loader:
271
+ * - 'eager': Load when root menu opens
272
+ * - 'lazy': Load when submenu opens (default)
273
+ */
274
+ loadStrategy?: 'eager' | 'lazy';
275
+ }
276
+ /**
277
+ * Creates a static loader configuration using plain fetch/promises.
278
+ * No external data library required.
279
+ *
280
+ * @example
281
+ * ```tsx
282
+ * const recentFilesLoader = createVanillaStaticLoader({
283
+ * fetcher: async () => {
284
+ * const res = await fetch('/api/recent-files')
285
+ * const data = await res.json()
286
+ * return data.map(file => ({
287
+ * kind: 'item',
288
+ * value: file.name,
289
+ * render: ...
290
+ * }))
291
+ * },
292
+ * })
293
+ * ```
294
+ */
295
+ declare function createVanillaStaticLoader(props: CreateVanillaStaticLoaderProps): StaticLoaderConfig;
296
+ /**
297
+ * Props for creating a query loader with vanilla fetch.
298
+ */
299
+ interface CreateVanillaQueryLoaderProps {
300
+ /**
301
+ * Async function that fetches menu items based on the search query.
302
+ * Receives an optional `signal` that is aborted when a newer query is issued,
303
+ * allowing you to cancel in-flight requests (e.g. pass it to `fetch()`).
304
+ */
305
+ fetcher: (query: string, options?: {
306
+ signal?: AbortSignal;
307
+ }) => Promise<NodeDef[]>;
308
+ /**
309
+ * Minimum query length before fetching.
310
+ * @default 1
311
+ */
312
+ minQueryLength?: number;
313
+ /**
314
+ * Initial query behavior before user input reaches minQueryLength.
315
+ * Defaults to fetching with an empty query.
316
+ */
317
+ initialQueryBehavior?: InitialQueryBehavior | false;
318
+ /**
319
+ * @deprecated Use `initialQueryBehavior` instead.
320
+ */
321
+ initialQuery?: string;
322
+ /**
323
+ * When to trigger the loader:
324
+ * - 'eager': Load when root menu opens (good for deep search)
325
+ * - 'lazy': Load when submenu opens (default)
326
+ * @default 'lazy'
327
+ */
328
+ loadStrategy?: 'eager' | 'lazy';
329
+ /**
330
+ * What to show when query is below minQueryLength.
331
+ * @default 'empty'
332
+ */
333
+ belowMinBehavior?: 'empty' | 'placeholder';
334
+ /**
335
+ * Placeholder nodes shown when query is below minQueryLength.
336
+ */
337
+ placeholderNodes?: NodeDef[];
338
+ }
339
+ /**
340
+ * Creates a query loader configuration using plain fetch/promises.
341
+ * No external data library required.
342
+ *
343
+ * @example
344
+ * ```tsx
345
+ * const searchLoader = createVanillaQueryLoader({
346
+ * fetcher: async (query, options) => {
347
+ * const res = await fetch(`/api/search?q=${encodeURIComponent(query)}`, {
348
+ * signal: options?.signal, // aborts when a newer query is issued
349
+ * })
350
+ * const data = await res.json()
351
+ * return data.map(item => ({
352
+ * kind: 'item',
353
+ * value: item.name,
354
+ * render: ...
355
+ * }))
356
+ * },
357
+ * minQueryLength: 2,
358
+ * })
359
+ * ```
360
+ */
361
+ declare function createVanillaQueryLoader(props: CreateVanillaQueryLoaderProps): QueryLoaderConfig;
362
+
363
+ export { type CreateQueryLoaderProps, type CreateSWRQueryLoaderProps, type CreateSWRStaticLoaderProps, type CreateStaticLoaderProps, type CreateVanillaQueryLoaderProps, type CreateVanillaStaticLoaderProps, type SWRResult, type TanStackQueryResult, createLoaderComponent, createQueryLoader, createSWRLoaderComponent, createSWRQueryLoader, createSWRStaticLoader, createStaticLoader, createVanillaQueryLoader, createVanillaStaticLoader, toAsyncLoaderResult, toAsyncLoaderResultFromSWR };
@@ -0,0 +1,2 @@
1
+ import"../chunk-4C666HHU.js";import{Fragment as S,jsx as R}from"react/jsx-runtime";function A(e){return e==null?null:e instanceof Error?e:new Error(String(e))}function p(e){let o=A(e.error),a=e.data!==void 0,n=e.isPaused?"paused":e.isValidating?"fetching":"idle",r=n==="fetching",t=e.isLoading??(r&&!a&&o==null),c=r&&!t,s=o?"error":a?"success":t||r?"pending":"idle",i=t?"initial":c?"background":"none";return{data:e.data,raw:e,source:"swr",error:o,status:s,fetchStatus:n,loadingPhase:i,isLoading:t,isFetching:r,isInitialLoading:t,isRefetching:c,isPending:s==="pending",isSuccess:s==="success",isError:s==="error",isPaused:n==="paused",hasData:a,hasFetched:a||o!=null||t||c,refetch:()=>e.mutate()}}function T(e){let{useSWR:o,loadStrategy:a}=e;return{type:"static",Loader:({children:r})=>{let t=o();return R(S,{children:r(p(t))})},loadStrategy:a}}function D(e){let{useSWR:o,minQueryLength:a=1,initialQueryBehavior:n,initialQuery:r,loadStrategy:t,belowMinBehavior:c="empty",placeholderNodes:s}=e,i=n!==void 0?n:r!==void 0?{value:r,loadWhen:"needed"}:{value:"",loadWhen:"needed"};return{type:"query",Loader:({query:l,enabled:f,children:h})=>{let y=f??(l.length>=a||i!==!1),g=o(l,{enabled:y});return R(S,{children:h(p(g))})},minQueryLength:a,initialQueryBehavior:i,initialQuery:r,loadStrategy:t,belowMinBehavior:c,placeholderNodes:s}}function E(e){return function({query:a,children:n}){let r=e(a);return R(S,{children:n(p(r))})}}import{Fragment as Q,jsx as F}from"react/jsx-runtime";function v(e){return e==null?null:e instanceof Error?e:new Error(String(e))}function L(e){let o=e.data!==void 0,a=e.fetchStatus?e.fetchStatus:e.isPaused?"paused":e.isFetching||e.isLoading?"fetching":"idle",n=a==="fetching",r=e.status?e.status:e.isError?"error":e.isSuccess||o?"success":e.isPending||e.isLoading||n?"pending":"idle",t=e.isPending??r==="pending",c=e.isSuccess??r==="success",s=e.isError??r==="error",i=e.isLoading??(t&&n),u=e.isRefetching??(n&&!i),l=e.isPaused??a==="paused",f=e.isFetched??(c||s||i||u),h=i?"initial":u?"background":"none";return{data:e.data,raw:e,source:"tanstack-query",error:v(e.error),status:r,fetchStatus:a,loadingPhase:h,isLoading:i,isFetching:n,isInitialLoading:i,isRefetching:u,isPending:t,isSuccess:c,isError:s,isPaused:l,hasData:o,hasFetched:f,refetch:e.refetch}}function W(e){let{useQuery:o,loadStrategy:a}=e;return{type:"static",Loader:({children:r})=>{let t=o();return F(Q,{children:r(L(t))})},loadStrategy:a}}function B(e){let{useQuery:o,minQueryLength:a=1,initialQueryBehavior:n,initialQuery:r,loadStrategy:t,belowMinBehavior:c="empty",placeholderNodes:s}=e,i=n!==void 0?n:r!==void 0?{value:r,loadWhen:"needed"}:{value:"",loadWhen:"needed"};return{type:"query",Loader:({query:l,enabled:f,children:h})=>{let y=f??(l.length>=a||i!==!1),g=o(l,{enabled:y});return F(Q,{children:h(L(g))})},minQueryLength:a,initialQueryBehavior:i,initialQuery:r,loadStrategy:t,belowMinBehavior:c,placeholderNodes:s}}function N(e){return function({query:a,children:n}){let r=e(a);return F(Q,{children:n(L(r))})}}import*as d from"react";import{Fragment as P,jsx as b}from"react/jsx-runtime";function m(e){return e==null?null:e instanceof Error?e:new Error(String(e))}function k(e){return e.error?"error":e.data!==void 0?"success":e.isFetching?"pending":"idle"}function C(e,o){let a=k(e),n=e.isFetching?"fetching":"idle",r=e.isFetching&&!e.hasFetched,t=e.isFetching&&e.hasFetched,c=r?"initial":t?"background":"none";return{data:e.data,source:"vanilla",error:e.error,status:a,fetchStatus:n,loadingPhase:c,isLoading:r,isFetching:e.isFetching,isInitialLoading:r,isRefetching:t,isPending:a==="pending",isSuccess:a==="success",isError:a==="error",isPaused:!1,hasData:e.data!==void 0,hasFetched:e.hasFetched,refetch:o}}function w(e,o){let{enabled:a=!0}=o??{},[n,r]=d.useState(()=>({data:void 0,error:null,isFetching:a,hasFetched:!1})),t=d.useRef(e);t.current=e;let c=d.useCallback(()=>{r(s=>({...s,isFetching:!0,error:null})),t.current().then(s=>{r({data:s,error:null,isFetching:!1,hasFetched:!0})}).catch(s=>{r(i=>({...i,error:m(s),isFetching:!1,hasFetched:!0}))})},[]);return d.useEffect(()=>{if(a){c();return}r(s=>({...s,isFetching:!1}))},[a,c]),d.useMemo(()=>C(n,c),[n,c])}function I(e,o,a){let{enabled:n=!0}=a??{},[r,t]=d.useState(()=>({data:void 0,error:null,isFetching:n,hasFetched:!1})),c=d.useRef(e);c.current=e,d.useEffect(()=>{if(!n){t({data:void 0,error:null,isFetching:!1,hasFetched:!1});return}let i=new AbortController;return t({data:void 0,error:null,isFetching:!0,hasFetched:!1}),c.current(o,{signal:i.signal}).then(u=>{i.signal.aborted||t({data:u,error:null,isFetching:!1,hasFetched:!0})}).catch(u=>{i.signal.aborted||t({data:void 0,error:m(u),isFetching:!1,hasFetched:!0})}),()=>{i.abort()}},[n,o]);let s=d.useCallback(()=>{t(i=>({...i,isFetching:!0,error:null})),c.current(o).then(i=>{t({data:i,error:null,isFetching:!1,hasFetched:!0})}).catch(i=>{t(u=>({...u,error:m(i),isFetching:!1,hasFetched:!0}))})},[o]);return d.useMemo(()=>C(r,s),[r,s])}function V(e){let{fetcher:o,loadStrategy:a}=e;return{type:"static",Loader:({children:r})=>{let t=w(o);return b(P,{children:r(t)})},loadStrategy:a}}function x(e){let{fetcher:o,minQueryLength:a=1,initialQueryBehavior:n,initialQuery:r,loadStrategy:t,belowMinBehavior:c="empty",placeholderNodes:s}=e,i=n!==void 0?n:r!==void 0?{value:r,loadWhen:"needed"}:{value:"",loadWhen:"needed"};return{type:"query",Loader:({query:l,enabled:f,children:h})=>{let y=f??(l.length>=a||i!==!1),g=I(o,l,{enabled:y});return b(P,{children:h(g)})},minQueryLength:a,initialQueryBehavior:i,initialQuery:r,loadStrategy:t,belowMinBehavior:c,placeholderNodes:s}}export{N as createLoaderComponent,B as createQueryLoader,E as createSWRLoaderComponent,D as createSWRQueryLoader,T as createSWRStaticLoader,W as createStaticLoader,x as createVanillaQueryLoader,V as createVanillaStaticLoader,L as toAsyncLoaderResult,p as toAsyncLoaderResultFromSWR};
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/loaders/swr.tsx","../../src/loaders/tanstack-query.tsx","../../src/loaders/vanilla.tsx"],"sourcesContent":["'use client'\n\nimport type * as React from 'react'\nimport type {\n AsyncLoaderFetchStatus,\n AsyncLoaderLoadingPhase,\n AsyncLoaderResult,\n AsyncLoaderStatus,\n InitialQueryBehavior,\n LoaderComponentProps,\n NodeDef,\n QueryLoaderConfig,\n StaticLoaderConfig,\n} from '../internal/popup-menu/data-first/types.js'\n\n// ============================================================================\n// SWR Adapter\n// ============================================================================\n\n/**\n * SWR result shape (subset of SWRResponse).\n * This allows the adapter to work without requiring `swr` as a dependency.\n */\nexport interface SWRResult<TData, TError = Error> {\n data: TData | undefined\n error: TError | undefined\n isLoading?: boolean\n isValidating: boolean\n isPaused?: boolean\n mutate: (...args: unknown[]) => unknown\n}\n\nfunction toError(error: unknown): Error | null {\n if (error == null) {\n return null\n }\n\n if (error instanceof Error) {\n return error\n }\n\n return new Error(String(error))\n}\n\n/**\n * Converts an SWR result to an AsyncLoaderResult.\n */\nexport function toAsyncLoaderResultFromSWR<TData, TError = Error>(\n result: SWRResult<TData, TError>,\n): AsyncLoaderResult<TData, SWRResult<TData, TError>> {\n const normalizedError = toError(result.error)\n const hasData = result.data !== undefined\n\n const fetchStatus: AsyncLoaderFetchStatus = result.isPaused\n ? 'paused'\n : result.isValidating\n ? 'fetching'\n : 'idle'\n\n const isFetching = fetchStatus === 'fetching'\n const isInitialLoading =\n result.isLoading ?? (isFetching && !hasData && normalizedError == null)\n const isRefetching = isFetching && !isInitialLoading\n\n const status: AsyncLoaderStatus = normalizedError\n ? 'error'\n : hasData\n ? 'success'\n : isInitialLoading || isFetching\n ? 'pending'\n : 'idle'\n\n const loadingPhase: AsyncLoaderLoadingPhase = isInitialLoading\n ? 'initial'\n : isRefetching\n ? 'background'\n : 'none'\n\n return {\n data: result.data,\n raw: result,\n source: 'swr',\n error: normalizedError,\n status,\n fetchStatus,\n loadingPhase,\n isLoading: isInitialLoading,\n isFetching,\n isInitialLoading,\n isRefetching,\n isPending: status === 'pending',\n isSuccess: status === 'success',\n isError: status === 'error',\n isPaused: fetchStatus === 'paused',\n hasData,\n hasFetched:\n hasData || normalizedError != null || isInitialLoading || isRefetching,\n refetch: () => result.mutate(),\n }\n}\n\n/**\n * Props for creating a static SWR loader component.\n */\nexport interface CreateSWRStaticLoaderProps {\n /** Hook that returns an SWR result. */\n useSWR: () => SWRResult<NodeDef[]>\n\n /**\n * When to trigger the loader:\n * - 'eager': Load when root menu opens\n * - 'lazy': Load when submenu opens (default)\n */\n loadStrategy?: 'eager' | 'lazy'\n}\n\n/**\n * Creates a static loader configuration backed by SWR.\n */\nexport function createSWRStaticLoader(\n props: CreateSWRStaticLoaderProps,\n): StaticLoaderConfig {\n const { useSWR, loadStrategy } = props\n\n const Loader: React.FC<LoaderComponentProps> = ({ children }) => {\n const result = useSWR()\n return <>{children(toAsyncLoaderResultFromSWR(result))}</>\n }\n\n return {\n type: 'static',\n Loader,\n loadStrategy,\n }\n}\n\n/**\n * Props for creating a query SWR loader component.\n */\nexport interface CreateSWRQueryLoaderProps {\n /**\n * Hook that returns an SWR result based on the search query.\n * `options.enabled` can be used to derive a `null` key and disable fetching.\n */\n useSWR: (\n query: string,\n options?: { enabled: boolean },\n ) => SWRResult<NodeDef[]>\n /**\n * Minimum query length before fetching.\n * @default 1\n */\n minQueryLength?: number\n /**\n * Initial query behavior before user input reaches minQueryLength.\n * Defaults to fetching with an empty query.\n */\n initialQueryBehavior?: InitialQueryBehavior | false\n /**\n * @deprecated Use `initialQueryBehavior` instead.\n */\n initialQuery?: string\n /**\n * When to trigger the loader:\n * - 'eager': Load when root menu opens (good for deep search)\n * - 'lazy': Load when submenu opens (default)\n * @default 'lazy'\n */\n loadStrategy?: 'eager' | 'lazy'\n /**\n * What to show when query is below minQueryLength.\n * @default 'empty'\n */\n belowMinBehavior?: 'empty' | 'placeholder'\n /**\n * Placeholder nodes shown when query is below minQueryLength.\n */\n placeholderNodes?: NodeDef[]\n}\n\n/**\n * Creates a query loader configuration backed by SWR.\n */\nexport function createSWRQueryLoader(\n props: CreateSWRQueryLoaderProps,\n): QueryLoaderConfig {\n const {\n useSWR,\n minQueryLength = 1,\n initialQueryBehavior,\n initialQuery,\n loadStrategy,\n belowMinBehavior = 'empty',\n placeholderNodes,\n } = props\n\n const resolvedInitialQueryBehavior: InitialQueryBehavior | false =\n initialQueryBehavior !== undefined\n ? initialQueryBehavior\n : initialQuery !== undefined\n ? { value: initialQuery, loadWhen: 'needed' }\n : { value: '', loadWhen: 'needed' }\n\n const Loader: React.FC<LoaderComponentProps> = ({\n query,\n enabled,\n children,\n }) => {\n const isEnabled =\n enabled ??\n (query.length >= minQueryLength || resolvedInitialQueryBehavior !== false)\n const result = useSWR(query, { enabled: isEnabled })\n return <>{children(toAsyncLoaderResultFromSWR(result))}</>\n }\n\n return {\n type: 'query',\n Loader,\n minQueryLength,\n initialQueryBehavior: resolvedInitialQueryBehavior,\n initialQuery,\n loadStrategy,\n belowMinBehavior,\n placeholderNodes,\n }\n}\n\n/**\n * Creates a loader component that wraps an SWR hook.\n */\nexport function createSWRLoaderComponent(\n useSWRFn: (query: string) => SWRResult<NodeDef[]>,\n): React.FC<LoaderComponentProps> {\n return function SWRLoader({ query, children }) {\n const result = useSWRFn(query)\n return <>{children(toAsyncLoaderResultFromSWR(result))}</>\n }\n}\n","'use client'\n\nimport type * as React from 'react'\nimport type {\n AsyncLoaderFetchStatus,\n AsyncLoaderLoadingPhase,\n AsyncLoaderResult,\n AsyncLoaderStatus,\n InitialQueryBehavior,\n LoaderComponentProps,\n NodeDef,\n QueryLoaderConfig,\n StaticLoaderConfig,\n} from '../internal/popup-menu/data-first/types.js'\n\n// ============================================================================\n// TanStack Query Adapter\n// ============================================================================\n\n/**\n * TanStack Query result shape (subset of UseQueryResult).\n * This allows the adapter to work without requiring @tanstack/react-query as a dependency.\n */\nexport interface TanStackQueryResult<TData, TError = Error> {\n /** TanStack status (`pending` | `error` | `success`) */\n status?: 'pending' | 'error' | 'success'\n\n /** TanStack fetch status (`fetching` | `paused` | `idle`) */\n fetchStatus?: 'fetching' | 'paused' | 'idle'\n\n data: TData | undefined\n error: TError | null | undefined\n\n /** v5: true when first fetch is in-flight */\n isLoading?: boolean\n\n /** v5: true when status is pending */\n isPending?: boolean\n\n /** true when status is success */\n isSuccess?: boolean\n\n /** true when status is error */\n isError?: boolean\n\n /** true while any fetch is in-flight */\n isFetching?: boolean\n\n /** true while background refetch is in-flight */\n isRefetching?: boolean\n\n /** true when fetch is paused */\n isPaused?: boolean\n\n /** true once query has fetched at least once */\n isFetched?: boolean\n\n refetch: () => unknown\n}\n\nfunction toError(error: unknown): Error | null {\n if (error == null) {\n return null\n }\n\n if (error instanceof Error) {\n return error\n }\n\n return new Error(String(error))\n}\n\n/**\n * Converts a TanStack Query result to an AsyncLoaderResult.\n * Use this to wrap your useQuery hook result.\n *\n * @example\n * ```tsx\n * function MyLoader({ query, children }) {\n * const result = useQuery({\n * queryKey: ['items', query],\n * queryFn: () => fetchItems(query),\n * })\n * return children(toAsyncLoaderResult(result))\n * }\n * ```\n */\nexport function toAsyncLoaderResult<TData, TError = Error>(\n result: TanStackQueryResult<TData, TError>,\n): AsyncLoaderResult<TData, TanStackQueryResult<TData, TError>> {\n const hasData = result.data !== undefined\n\n const fetchStatus: AsyncLoaderFetchStatus = result.fetchStatus\n ? result.fetchStatus\n : result.isPaused\n ? 'paused'\n : result.isFetching || result.isLoading\n ? 'fetching'\n : 'idle'\n\n const isFetching = fetchStatus === 'fetching'\n\n const status: AsyncLoaderStatus = result.status\n ? result.status\n : result.isError\n ? 'error'\n : result.isSuccess || hasData\n ? 'success'\n : result.isPending || result.isLoading || isFetching\n ? 'pending'\n : 'idle'\n\n const isPending = result.isPending ?? status === 'pending'\n const isSuccess = result.isSuccess ?? status === 'success'\n const isError = result.isError ?? status === 'error'\n const isInitialLoading = result.isLoading ?? (isPending && isFetching)\n const isRefetching = result.isRefetching ?? (isFetching && !isInitialLoading)\n const isPaused = result.isPaused ?? fetchStatus === 'paused'\n const hasFetched =\n result.isFetched ??\n (isSuccess || isError || isInitialLoading || isRefetching)\n\n const loadingPhase: AsyncLoaderLoadingPhase = isInitialLoading\n ? 'initial'\n : isRefetching\n ? 'background'\n : 'none'\n\n return {\n data: result.data,\n raw: result,\n source: 'tanstack-query',\n error: toError(result.error),\n status,\n fetchStatus,\n loadingPhase,\n isLoading: isInitialLoading,\n isFetching,\n isInitialLoading,\n isRefetching,\n isPending,\n isSuccess,\n isError,\n isPaused,\n hasData,\n hasFetched,\n refetch: result.refetch,\n }\n}\n\n/**\n * Props for creating a static loader component.\n */\nexport interface CreateStaticLoaderProps {\n /**\n * Hook that returns a TanStack Query result.\n * This hook will be called inside the loader component.\n */\n useQuery: () => TanStackQueryResult<NodeDef[]>\n\n /**\n * When to trigger the loader:\n * - 'eager': Load when root menu opens\n * - 'lazy': Load when submenu opens (default)\n */\n loadStrategy?: 'eager' | 'lazy'\n}\n\n/**\n * Creates a static loader configuration for use with async menus.\n * The hook is called inside a component, so it follows React's rules of hooks.\n *\n * @example\n * ```tsx\n * const recentFilesLoader = createStaticLoader({\n * useQuery: () => useQuery({\n * queryKey: ['recent-files'],\n * queryFn: fetchRecentFiles,\n * staleTime: 5 * 60 * 1000,\n * }),\n * })\n *\n * // Use in submenu\n * {\n * kind: 'submenu',\n * value: 'Recent Files',\n * asyncNodes: {\n * ...recentFilesLoader,\n * loadStrategy: 'eager',\n * },\n * render: ...\n * }\n * ```\n */\nexport function createStaticLoader(\n props: CreateStaticLoaderProps,\n): StaticLoaderConfig {\n const { useQuery, loadStrategy } = props\n\n const Loader: React.FC<LoaderComponentProps> = ({ children }) => {\n const result = useQuery()\n return <>{children(toAsyncLoaderResult(result))}</>\n }\n\n return {\n type: 'static',\n Loader,\n loadStrategy,\n }\n}\n\n/**\n * Props for creating a query loader component.\n */\nexport interface CreateQueryLoaderProps {\n /**\n * Hook that returns a TanStack Query result based on the search query.\n * This hook will be called inside the loader component with the current query.\n */\n useQuery: (\n query: string,\n options?: { enabled: boolean },\n ) => TanStackQueryResult<NodeDef[]>\n /**\n * Minimum query length before fetching.\n * @default 1\n */\n minQueryLength?: number\n /**\n * Initial query behavior before user input reaches minQueryLength.\n * Defaults to fetching with an empty query.\n */\n initialQueryBehavior?: InitialQueryBehavior | false\n /**\n * @deprecated Use `initialQueryBehavior` instead.\n */\n initialQuery?: string\n /**\n * When to trigger the loader:\n * - 'eager': Load when root menu opens (good for deep search)\n * - 'lazy': Load when submenu opens (default)\n * @default 'lazy'\n */\n loadStrategy?: 'eager' | 'lazy'\n /**\n * What to show when query is below minQueryLength.\n * @default 'empty'\n */\n belowMinBehavior?: 'empty' | 'placeholder'\n /**\n * Placeholder nodes shown when query is below minQueryLength.\n */\n placeholderNodes?: NodeDef[]\n}\n\n/**\n * Creates a query loader configuration for use with async menus.\n * The loader will re-fetch when the search query changes.\n *\n * @example\n * ```tsx\n * const searchLoader = createQueryLoader({\n * useQuery: (query, options) => useQuery({\n * queryKey: ['search', query],\n * queryFn: () => searchItems(query),\n * enabled: options?.enabled,\n * }),\n * minQueryLength: 2,\n * })\n *\n * // Use in submenu\n * {\n * kind: 'submenu',\n * value: 'Search',\n * includeInDeepSearch: true,\n * asyncNodes: searchLoader,\n * render: ...\n * }\n * ```\n */\nexport function createQueryLoader(\n props: CreateQueryLoaderProps,\n): QueryLoaderConfig {\n const {\n useQuery,\n minQueryLength = 1,\n initialQueryBehavior,\n initialQuery,\n loadStrategy,\n belowMinBehavior = 'empty',\n placeholderNodes,\n } = props\n\n const resolvedInitialQueryBehavior: InitialQueryBehavior | false =\n initialQueryBehavior !== undefined\n ? initialQueryBehavior\n : initialQuery !== undefined\n ? { value: initialQuery, loadWhen: 'needed' }\n : { value: '', loadWhen: 'needed' }\n\n const Loader: React.FC<LoaderComponentProps> = ({\n query,\n enabled,\n children,\n }) => {\n const isEnabled =\n enabled ??\n (query.length >= minQueryLength || resolvedInitialQueryBehavior !== false)\n const result = useQuery(query, { enabled: isEnabled })\n return <>{children(toAsyncLoaderResult(result))}</>\n }\n\n return {\n type: 'query',\n Loader,\n minQueryLength,\n initialQueryBehavior: resolvedInitialQueryBehavior,\n initialQuery,\n loadStrategy,\n belowMinBehavior,\n placeholderNodes,\n }\n}\n\n/**\n * Creates a loader component that wraps a TanStack Query hook.\n * This is a lower-level utility for custom loader implementations.\n *\n * @example\n * ```tsx\n * const MyLoader = createLoaderComponent((query) =>\n * useQuery({\n * queryKey: ['items', query],\n * queryFn: () => fetchItems(query),\n * })\n * )\n * ```\n */\nexport function createLoaderComponent(\n useQueryFn: (query: string) => TanStackQueryResult<NodeDef[]>,\n): React.FC<LoaderComponentProps> {\n return function TanStackLoader({ query, children }) {\n const result = useQueryFn(query)\n return <>{children(toAsyncLoaderResult(result))}</>\n }\n}\n","'use client'\n\nimport * as React from 'react'\nimport type {\n AsyncLoaderFetchStatus,\n AsyncLoaderLoadingPhase,\n AsyncLoaderResult,\n AsyncLoaderStatus,\n InitialQueryBehavior,\n LoaderComponentProps,\n NodeDef,\n QueryLoaderConfig,\n StaticLoaderConfig,\n} from '../internal/popup-menu/data-first/types.js'\n\n// ============================================================================\n// Vanilla Async Adapter (no external dependencies)\n// ============================================================================\n\ninterface VanillaAsyncInternalState<TData> {\n data: TData | undefined\n error: Error | null\n isFetching: boolean\n hasFetched: boolean\n}\n\nfunction normalizeError(error: unknown): Error | null {\n if (error == null) {\n return null\n }\n\n if (error instanceof Error) {\n return error\n }\n\n return new Error(String(error))\n}\n\nfunction getVanillaStatus<TData>(\n state: VanillaAsyncInternalState<TData>,\n): AsyncLoaderStatus {\n if (state.error) {\n return 'error'\n }\n\n if (state.data !== undefined) {\n return 'success'\n }\n\n if (state.isFetching) {\n return 'pending'\n }\n\n return 'idle'\n}\n\nfunction toVanillaAsyncLoaderResult<TData>(\n state: VanillaAsyncInternalState<TData>,\n refetch: () => unknown,\n): AsyncLoaderResult<TData> {\n const status = getVanillaStatus(state)\n const fetchStatus: AsyncLoaderFetchStatus = state.isFetching\n ? 'fetching'\n : 'idle'\n\n const isInitialLoading = state.isFetching && !state.hasFetched\n const isRefetching = state.isFetching && state.hasFetched\n\n const loadingPhase: AsyncLoaderLoadingPhase = isInitialLoading\n ? 'initial'\n : isRefetching\n ? 'background'\n : 'none'\n\n return {\n data: state.data,\n source: 'vanilla',\n error: state.error,\n status,\n fetchStatus,\n loadingPhase,\n isLoading: isInitialLoading,\n isFetching: state.isFetching,\n isInitialLoading,\n isRefetching,\n isPending: status === 'pending',\n isSuccess: status === 'success',\n isError: status === 'error',\n isPaused: false,\n hasData: state.data !== undefined,\n hasFetched: state.hasFetched,\n refetch,\n }\n}\n\n/**\n * Internal hook for managing async state with plain promises.\n * Use this when you don't have TanStack Query or SWR.\n */\nfunction useAsyncState<T>(\n fetcher: () => Promise<T>,\n options?: { enabled?: boolean },\n): AsyncLoaderResult<T> {\n const { enabled = true } = options ?? {}\n const [state, setState] = React.useState<VanillaAsyncInternalState<T>>(\n () => ({\n data: undefined,\n error: null,\n isFetching: enabled,\n hasFetched: false,\n }),\n )\n\n const fetcherRef = React.useRef(fetcher)\n fetcherRef.current = fetcher\n\n const refetch = React.useCallback(() => {\n setState((s) => ({ ...s, isFetching: true, error: null }))\n fetcherRef\n .current()\n .then((data) => {\n setState({\n data,\n error: null,\n isFetching: false,\n hasFetched: true,\n })\n })\n .catch((error) => {\n setState((s) => ({\n ...s,\n error: normalizeError(error),\n isFetching: false,\n hasFetched: true,\n }))\n })\n }, [])\n\n React.useEffect(() => {\n if (enabled) {\n refetch()\n return\n }\n\n setState((s) => ({\n ...s,\n isFetching: false,\n }))\n }, [enabled, refetch])\n\n return React.useMemo(\n () => toVanillaAsyncLoaderResult(state, refetch),\n [state, refetch],\n )\n}\n\n/**\n * Internal hook for managing query-dependent async state with plain promises.\n * Unlike `useAsyncState`, this hook re-fetches whenever the query changes.\n * Aborts in-flight requests when a new query is issued or the component unmounts.\n */\nfunction useAsyncQueryState(\n fetcher: (\n query: string,\n options?: { signal?: AbortSignal },\n ) => Promise<NodeDef[]>,\n query: string,\n options?: { enabled?: boolean },\n): AsyncLoaderResult<NodeDef[]> {\n const { enabled = true } = options ?? {}\n const [state, setState] = React.useState<\n VanillaAsyncInternalState<NodeDef[]>\n >(() => ({\n data: undefined,\n error: null,\n isFetching: enabled,\n hasFetched: false,\n }))\n\n const fetcherRef = React.useRef(fetcher)\n fetcherRef.current = fetcher\n\n React.useEffect(() => {\n if (!enabled) {\n setState({\n data: undefined,\n error: null,\n isFetching: false,\n hasFetched: false,\n })\n return\n }\n\n const controller = new AbortController()\n\n setState({\n data: undefined,\n error: null,\n isFetching: true,\n hasFetched: false,\n })\n\n fetcherRef\n .current(query, { signal: controller.signal })\n .then((data) => {\n if (!controller.signal.aborted) {\n setState({\n data,\n error: null,\n isFetching: false,\n hasFetched: true,\n })\n }\n })\n .catch((error) => {\n if (!controller.signal.aborted) {\n setState({\n data: undefined,\n error: normalizeError(error),\n isFetching: false,\n hasFetched: true,\n })\n }\n })\n\n return () => {\n controller.abort()\n }\n }, [enabled, query])\n\n const refetch = React.useCallback(() => {\n // Trigger re-run by toggling a state-based effect isn't ideal here,\n // so we do a manual fetch that respects the current query/enabled state.\n setState((s) => ({\n ...s,\n isFetching: true,\n error: null,\n }))\n fetcherRef\n .current(query)\n .then((data) => {\n setState({\n data,\n error: null,\n isFetching: false,\n hasFetched: true,\n })\n })\n .catch((error) => {\n setState((s) => ({\n ...s,\n error: normalizeError(error),\n isFetching: false,\n hasFetched: true,\n }))\n })\n }, [query])\n\n return React.useMemo(\n () => toVanillaAsyncLoaderResult(state, refetch),\n [state, refetch],\n )\n}\n\n/**\n * Props for creating a static loader with vanilla fetch.\n */\nexport interface CreateVanillaStaticLoaderProps {\n /**\n * Async function that fetches the menu items.\n */\n fetcher: () => Promise<NodeDef[]>\n\n /**\n * When to trigger the loader:\n * - 'eager': Load when root menu opens\n * - 'lazy': Load when submenu opens (default)\n */\n loadStrategy?: 'eager' | 'lazy'\n}\n\n/**\n * Creates a static loader configuration using plain fetch/promises.\n * No external data library required.\n *\n * @example\n * ```tsx\n * const recentFilesLoader = createVanillaStaticLoader({\n * fetcher: async () => {\n * const res = await fetch('/api/recent-files')\n * const data = await res.json()\n * return data.map(file => ({\n * kind: 'item',\n * value: file.name,\n * render: ...\n * }))\n * },\n * })\n * ```\n */\nexport function createVanillaStaticLoader(\n props: CreateVanillaStaticLoaderProps,\n): StaticLoaderConfig {\n const { fetcher, loadStrategy } = props\n\n const Loader: React.FC<LoaderComponentProps> = ({ children }) => {\n const result = useAsyncState(fetcher)\n return <>{children(result)}</>\n }\n\n return {\n type: 'static',\n Loader,\n loadStrategy,\n }\n}\n\n/**\n * Props for creating a query loader with vanilla fetch.\n */\nexport interface CreateVanillaQueryLoaderProps {\n /**\n * Async function that fetches menu items based on the search query.\n * Receives an optional `signal` that is aborted when a newer query is issued,\n * allowing you to cancel in-flight requests (e.g. pass it to `fetch()`).\n */\n fetcher: (\n query: string,\n options?: { signal?: AbortSignal },\n ) => Promise<NodeDef[]>\n /**\n * Minimum query length before fetching.\n * @default 1\n */\n minQueryLength?: number\n /**\n * Initial query behavior before user input reaches minQueryLength.\n * Defaults to fetching with an empty query.\n */\n initialQueryBehavior?: InitialQueryBehavior | false\n /**\n * @deprecated Use `initialQueryBehavior` instead.\n */\n initialQuery?: string\n /**\n * When to trigger the loader:\n * - 'eager': Load when root menu opens (good for deep search)\n * - 'lazy': Load when submenu opens (default)\n * @default 'lazy'\n */\n loadStrategy?: 'eager' | 'lazy'\n /**\n * What to show when query is below minQueryLength.\n * @default 'empty'\n */\n belowMinBehavior?: 'empty' | 'placeholder'\n /**\n * Placeholder nodes shown when query is below minQueryLength.\n */\n placeholderNodes?: NodeDef[]\n}\n\n/**\n * Creates a query loader configuration using plain fetch/promises.\n * No external data library required.\n *\n * @example\n * ```tsx\n * const searchLoader = createVanillaQueryLoader({\n * fetcher: async (query, options) => {\n * const res = await fetch(`/api/search?q=${encodeURIComponent(query)}`, {\n * signal: options?.signal, // aborts when a newer query is issued\n * })\n * const data = await res.json()\n * return data.map(item => ({\n * kind: 'item',\n * value: item.name,\n * render: ...\n * }))\n * },\n * minQueryLength: 2,\n * })\n * ```\n */\nexport function createVanillaQueryLoader(\n props: CreateVanillaQueryLoaderProps,\n): QueryLoaderConfig {\n const {\n fetcher,\n minQueryLength = 1,\n initialQueryBehavior,\n initialQuery,\n loadStrategy,\n belowMinBehavior = 'empty',\n placeholderNodes,\n } = props\n\n const resolvedInitialQueryBehavior: InitialQueryBehavior | false =\n initialQueryBehavior !== undefined\n ? initialQueryBehavior\n : initialQuery !== undefined\n ? { value: initialQuery, loadWhen: 'needed' }\n : { value: '', loadWhen: 'needed' }\n\n const Loader: React.FC<LoaderComponentProps> = ({\n query,\n enabled,\n children,\n }) => {\n const isEnabled =\n enabled ??\n (query.length >= minQueryLength || resolvedInitialQueryBehavior !== false)\n const result = useAsyncQueryState(fetcher, query, { enabled: isEnabled })\n return <>{children(result)}</>\n }\n\n return {\n type: 'query',\n Loader,\n minQueryLength,\n initialQueryBehavior: resolvedInitialQueryBehavior,\n initialQuery,\n loadStrategy,\n belowMinBehavior,\n placeholderNodes,\n }\n}\n"],"mappings":"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","names":["Fragment","jsx","toError","error","toAsyncLoaderResultFromSWR","result","normalizedError","hasData","fetchStatus","isFetching","isInitialLoading","isRefetching","status","loadingPhase","createSWRStaticLoader","props","useSWR","loadStrategy","children","createSWRQueryLoader","minQueryLength","initialQueryBehavior","initialQuery","belowMinBehavior","placeholderNodes","resolvedInitialQueryBehavior","query","enabled","isEnabled","createSWRLoaderComponent","useSWRFn","Fragment","jsx","toError","error","toAsyncLoaderResult","result","hasData","fetchStatus","isFetching","status","isPending","isSuccess","isError","isInitialLoading","isRefetching","isPaused","hasFetched","loadingPhase","createStaticLoader","props","useQuery","loadStrategy","children","createQueryLoader","minQueryLength","initialQueryBehavior","initialQuery","belowMinBehavior","placeholderNodes","resolvedInitialQueryBehavior","query","enabled","isEnabled","createLoaderComponent","useQueryFn","React","Fragment","jsx","normalizeError","error","getVanillaStatus","state","toVanillaAsyncLoaderResult","refetch","status","fetchStatus","isInitialLoading","isRefetching","loadingPhase","useAsyncState","fetcher","options","enabled","setState","fetcherRef","data","s","useAsyncQueryState","query","controller","createVanillaStaticLoader","props","loadStrategy","children","result","createVanillaQueryLoader","minQueryLength","initialQueryBehavior","initialQuery","belowMinBehavior","placeholderNodes","resolvedInitialQueryBehavior","isEnabled"]}
@@ -0,0 +1,29 @@
1
+ import * as React from 'react';
2
+ import { C as ComponentProps } from './types-DT4FOOa2.cjs';
3
+
4
+ interface PopupMenuLoadingState extends Record<string, unknown> {
5
+ first: boolean;
6
+ last: boolean;
7
+ }
8
+ interface PopupMenuLoadingProps extends ComponentProps<'div', PopupMenuLoading.State> {
9
+ children: React.ReactNode;
10
+ /**
11
+ * Whether to force render the loading indicator regardless of async loading state.
12
+ * When true, the component always renders, allowing you to control visibility externally.
13
+ * @default false
14
+ */
15
+ forceMount?: boolean;
16
+ }
17
+ /**
18
+ * Renders when async content is in initial loading.
19
+ * Only visible during first-load phases (unless `forceMount` is true).
20
+ * Renders a `<div>` element.
21
+ */
22
+ declare const PopupMenuLoading: React.ForwardRefExoticComponent<Omit<PopupMenuLoading.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
23
+ declare namespace PopupMenuLoading {
24
+ type State = PopupMenuLoadingState;
25
+ interface Props extends PopupMenuLoadingProps {
26
+ }
27
+ }
28
+
29
+ export { PopupMenuLoading as P, type PopupMenuLoadingProps as a, type PopupMenuLoadingState as b };
@@ -0,0 +1,29 @@
1
+ import * as React from 'react';
2
+ import { C as ComponentProps } from './types-DT4FOOa2.js';
3
+
4
+ interface PopupMenuLoadingState extends Record<string, unknown> {
5
+ first: boolean;
6
+ last: boolean;
7
+ }
8
+ interface PopupMenuLoadingProps extends ComponentProps<'div', PopupMenuLoading.State> {
9
+ children: React.ReactNode;
10
+ /**
11
+ * Whether to force render the loading indicator regardless of async loading state.
12
+ * When true, the component always renders, allowing you to control visibility externally.
13
+ * @default false
14
+ */
15
+ forceMount?: boolean;
16
+ }
17
+ /**
18
+ * Renders when async content is in initial loading.
19
+ * Only visible during first-load phases (unless `forceMount` is true).
20
+ * Renders a `<div>` element.
21
+ */
22
+ declare const PopupMenuLoading: React.ForwardRefExoticComponent<Omit<PopupMenuLoading.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
23
+ declare namespace PopupMenuLoading {
24
+ type State = PopupMenuLoadingState;
25
+ interface Props extends PopupMenuLoadingProps {
26
+ }
27
+ }
28
+
29
+ export { PopupMenuLoading as P, type PopupMenuLoadingProps as a, type PopupMenuLoadingState as b };