@warp-drive/react 5.9.0-alpha.20 → 5.9.0-alpha.22

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 (45) hide show
  1. package/dist/index.d.ts +180 -0
  2. package/dist/index.d.ts.map +1 -0
  3. package/dist/index.js +215 -256
  4. package/dist/index.js.map +1 -0
  5. package/dist/install.d.ts +21 -0
  6. package/dist/install.d.ts.map +1 -0
  7. package/dist/install.js +88 -107
  8. package/dist/install.js.map +1 -0
  9. package/dist/reactive-context-DNq02nr1.js +122 -0
  10. package/dist/reactive-context-DNq02nr1.js.map +1 -0
  11. package/dist/unpkg/dev/index.js +259 -304
  12. package/dist/unpkg/dev/index.js.map +1 -0
  13. package/dist/unpkg/dev/install.js +80 -105
  14. package/dist/unpkg/dev/install.js.map +1 -0
  15. package/dist/unpkg/dev/reactive-context-ir4_7OCl.js +218 -0
  16. package/dist/unpkg/dev/reactive-context-ir4_7OCl.js.map +1 -0
  17. package/dist/unpkg/dev-deprecated/index.js +259 -304
  18. package/dist/unpkg/dev-deprecated/index.js.map +1 -0
  19. package/dist/unpkg/dev-deprecated/install.js +80 -105
  20. package/dist/unpkg/dev-deprecated/install.js.map +1 -0
  21. package/dist/unpkg/dev-deprecated/reactive-context-CBrZV0cR.js +218 -0
  22. package/dist/unpkg/dev-deprecated/reactive-context-CBrZV0cR.js.map +1 -0
  23. package/dist/unpkg/prod/index.js +198 -231
  24. package/dist/unpkg/prod/index.js.map +1 -0
  25. package/dist/unpkg/prod/install.js +54 -61
  26. package/dist/unpkg/prod/install.js.map +1 -0
  27. package/dist/unpkg/prod/reactive-context-CvfXAZqb.js +92 -0
  28. package/dist/unpkg/prod/reactive-context-CvfXAZqb.js.map +1 -0
  29. package/dist/unpkg/prod-deprecated/index.js +198 -231
  30. package/dist/unpkg/prod-deprecated/index.js.map +1 -0
  31. package/dist/unpkg/prod-deprecated/install.js +54 -61
  32. package/dist/unpkg/prod-deprecated/install.js.map +1 -0
  33. package/dist/unpkg/prod-deprecated/reactive-context-CvfXAZqb.js +92 -0
  34. package/dist/unpkg/prod-deprecated/reactive-context-CvfXAZqb.js.map +1 -0
  35. package/package.json +15 -17
  36. package/declarations/-private/reactive-context.d.ts +0 -21
  37. package/declarations/-private/request.d.ts +0 -148
  38. package/declarations/-private/store-provider.d.ts +0 -19
  39. package/declarations/index.d.ts +0 -7
  40. package/declarations/install.d.ts +0 -17
  41. package/dist/reactive-context-ClTRYXie.js +0 -154
  42. package/dist/unpkg/dev/reactive-context-4Y50NyRg.js +0 -306
  43. package/dist/unpkg/dev-deprecated/reactive-context-D54NwOLZ.js +0 -306
  44. package/dist/unpkg/prod/reactive-context-DKimDkR3.js +0 -110
  45. package/dist/unpkg/prod-deprecated/reactive-context-DKimDkR3.js +0 -110
@@ -1,256 +1,223 @@
1
- import { R as ReactiveContext } from "./reactive-context-DKimDkR3.js";
2
- export { W as WatcherContext } from "./reactive-context-DKimDkR3.js";
3
- import '@warp-drive/core';
4
- import { useMemo, createContext, use, useRef, useEffect } from 'react';
5
- import { jsx, Fragment } from 'react/jsx-runtime';
6
- import { createRequestSubscription } from '@warp-drive/core/reactive';
7
- import { DISPOSE, signal } from '@warp-drive/core/signals/-leaked';
8
- import '@warp-drive/core/request';
9
- const StoreContext = /*#__PURE__*/createContext(null);
1
+ import { n as WatcherContext, t as ReactiveContext } from "./reactive-context-CvfXAZqb.js";
2
+ import { createContext, use, useEffect, useMemo, useRef } from "react";
3
+ import { Fragment, jsx } from "react/jsx-runtime";
4
+ import { createRequestSubscription } from "@warp-drive/core/reactive";
5
+ import { DISPOSE, signal } from "@warp-drive/core/signals/-leaked";
10
6
 
7
+ //#region src/-private/store-provider.tsx
11
8
  /**
12
- * @category Hooks
13
- */
9
+ * @category Contexts
10
+ */
11
+ const StoreContext = /*#__PURE__*/ createContext(null);
12
+ /**
13
+ * @category Hooks
14
+ */
14
15
  function useStore() {
15
- const store = use(StoreContext);
16
- return store;
16
+ return use(StoreContext);
17
17
  }
18
18
  /**
19
- * @category Components
20
- */
19
+ * @category Components
20
+ */
21
21
  function StoreProvider($props) {
22
- const store = useMemo(() => "store" in $props ? $props.store : new $props.Store(), ["store" in $props ? $props.store : $props.Store]);
23
- return /*#__PURE__*/jsx(StoreContext, {
24
- value: store,
25
- children: $props.children
26
- });
22
+ const store = useMemo(() => "store" in $props ? $props.store : new $props.Store(), ["store" in $props ? $props.store : $props.Store]);
23
+ return /*#__PURE__*/ jsx(StoreContext, {
24
+ value: store,
25
+ children: $props.children
26
+ });
27
27
  }
28
- const deferred = /* @__PURE__ */new WeakMap();
28
+
29
+ //#endregion
30
+ //#region ../../node_modules/.pnpm/decorat_5005bbc272376d25df08203abab44e2f/node_modules/decorator-transforms/dist/runtime-BPCpkOf1.js
31
+ const deferred = /* @__PURE__ */ new WeakMap();
29
32
  function deferDecorator(proto, prop, desc) {
30
- let map = deferred.get(proto);
31
- if (!map) {
32
- map = /* @__PURE__ */new Map();
33
- deferred.set(proto, map);
34
- }
35
- map.set(prop, desc);
33
+ let map = deferred.get(proto);
34
+ if (!map) {
35
+ map = /* @__PURE__ */ new Map();
36
+ deferred.set(proto, map);
37
+ }
38
+ map.set(prop, desc);
36
39
  }
37
40
  function findDeferredDecorator(target, prop) {
38
- var _a;
39
- let cursor = target.prototype;
40
- while (cursor) {
41
- let desc = (_a = deferred.get(cursor)) == null ? void 0 : _a.get(prop);
42
- if (desc) {
43
- return desc;
44
- }
45
- cursor = cursor.prototype;
46
- }
41
+ var _a;
42
+ let cursor = target.prototype;
43
+ while (cursor) {
44
+ let desc = (_a = deferred.get(cursor)) == null ? void 0 : _a.get(prop);
45
+ if (desc) return desc;
46
+ cursor = cursor.prototype;
47
+ }
47
48
  }
48
49
  function decorateFieldV2(prototype, prop, decorators, initializer) {
49
- let desc = {
50
- configurable: true,
51
- enumerable: true,
52
- writable: true,
53
- initializer: null
54
- };
55
- if (initializer) {
56
- desc.initializer = initializer;
57
- }
58
- for (let decorator of decorators) {
59
- desc = decorator(prototype, prop, desc) || desc;
60
- }
61
- if (desc.initializer === void 0) {
62
- Object.defineProperty(prototype, prop, desc);
63
- } else {
64
- deferDecorator(prototype, prop, desc);
65
- }
50
+ let desc = {
51
+ configurable: true,
52
+ enumerable: true,
53
+ writable: true,
54
+ initializer: null
55
+ };
56
+ if (initializer) desc.initializer = initializer;
57
+ for (let decorator of decorators) desc = decorator(prototype, prop, desc) || desc;
58
+ if (desc.initializer === void 0) Object.defineProperty(prototype, prop, desc);
59
+ else deferDecorator(prototype, prop, desc);
66
60
  }
67
61
  function initializeDeferredDecorator(target, prop) {
68
- let desc = findDeferredDecorator(target.constructor, prop);
69
- if (desc) {
70
- Object.defineProperty(target, prop, {
71
- enumerable: desc.enumerable,
72
- configurable: desc.configurable,
73
- writable: desc.writable,
74
- value: desc.initializer ? desc.initializer.call(target) : void 0
75
- });
76
- }
77
- }
78
- const IdleBlockMissingError = new Error("No idle block provided for <Request> component, and no query or request was provided.");
79
- class ReactiveArgs {
80
- static {
81
- decorateFieldV2(this.prototype, "request", [signal]);
82
- }
83
- #request = (initializeDeferredDecorator(this, "request"), void 0);
84
- static {
85
- decorateFieldV2(this.prototype, "query", [signal]);
86
- }
87
- #query = (initializeDeferredDecorator(this, "query"), void 0);
88
- static {
89
- decorateFieldV2(this.prototype, "autorefresh", [signal]);
90
- }
91
- #autorefresh = (initializeDeferredDecorator(this, "autorefresh"), void 0);
92
- static {
93
- decorateFieldV2(this.prototype, "autorefreshThreshold", [signal]);
94
- }
95
- #autorefreshThreshold = (initializeDeferredDecorator(this, "autorefreshThreshold"), void 0);
96
- static {
97
- decorateFieldV2(this.prototype, "autorefreshBehavior", [signal]);
98
- }
99
- #autorefreshBehavior = (initializeDeferredDecorator(this, "autorefreshBehavior"), void 0);
62
+ let desc = findDeferredDecorator(target.constructor, prop);
63
+ if (desc) Object.defineProperty(target, prop, {
64
+ enumerable: desc.enumerable,
65
+ configurable: desc.configurable,
66
+ writable: desc.writable,
67
+ value: desc.initializer ? desc.initializer.call(target) : void 0
68
+ });
100
69
  }
101
- const DefaultChrome = ({
102
- children
103
- }) => {
104
- return /*#__PURE__*/jsx(Fragment, {
105
- children: children
106
- });
70
+
71
+ //#endregion
72
+ //#region src/-private/request.tsx
73
+ const IdleBlockMissingError = /* @__PURE__ */ new Error("No idle block provided for <Request> component, and no query or request was provided.");
74
+ var ReactiveArgs = class {
75
+ static {
76
+ decorateFieldV2(this.prototype, "request", [signal]);
77
+ }
78
+ #request = (initializeDeferredDecorator(this, "request"), void 0);
79
+ static {
80
+ decorateFieldV2(this.prototype, "query", [signal]);
81
+ }
82
+ #query = (initializeDeferredDecorator(this, "query"), void 0);
83
+ static {
84
+ decorateFieldV2(this.prototype, "autorefresh", [signal]);
85
+ }
86
+ #autorefresh = (initializeDeferredDecorator(this, "autorefresh"), void 0);
87
+ static {
88
+ decorateFieldV2(this.prototype, "autorefreshThreshold", [signal]);
89
+ }
90
+ #autorefreshThreshold = (initializeDeferredDecorator(this, "autorefreshThreshold"), void 0);
91
+ static {
92
+ decorateFieldV2(this.prototype, "autorefreshBehavior", [signal]);
93
+ }
94
+ #autorefreshBehavior = (initializeDeferredDecorator(this, "autorefreshBehavior"), void 0);
95
+ };
96
+ const DefaultChrome = ({ children }) => {
97
+ return /*#__PURE__*/ jsx(Fragment, { children });
107
98
  };
108
99
  /**
109
- * Throws the given error. Used internally to rethrow request errors that
110
- * are not otherwise handled by a provided error/cancelled block.
111
- *
112
- * @private
113
- */
114
- function Throw({
115
- error
116
- }) {
117
- throw error;
100
+ * Throws the given error. Used internally to rethrow request errors that
101
+ * are not otherwise handled by a provided error/cancelled block.
102
+ *
103
+ * @private
104
+ */
105
+ function Throw({ error }) {
106
+ throw error;
118
107
  }
119
-
120
108
  /**
121
- * The `<Request />` component is a powerful tool for managing data fetching and
122
- * state in your React application. It provides a declarative approach to reactive
123
- * control-flow for managing requests and state in your application.
124
- *
125
- * The `<Request />` component is ideal for handling "boundaries", outside which some
126
- * state is still allowed to be unresolved and within which it MUST be resolved.
127
- *
128
- * ## Request States
129
- *
130
- * `<Request />` has five states, only one of which will be active and rendered at a time.
131
- *
132
- * - `idle`: The component is waiting to be given a request to monitor
133
- * - `loading`: The request is in progress
134
- * - `error`: The request failed
135
- * - `content`: The request succeeded
136
- * - `cancelled`: The request was cancelled
137
- *
138
- * Additionally, the `content` state has a `refresh` method that can be used to
139
- * refresh the request in the background, which is available as a sub-state of
140
- * the `content` state.
141
- *
142
- * ### Example Usage
143
- *
144
- * ```tsx
145
- * import { Request } from "@warp-drive/react";
146
- *
147
- * export function UserPreview($props: { id: string | null }) {
148
- * return (
149
- * <Request
150
- * query={findRecord('user', $props.id)}
151
- * states={{
152
- * idle: () => <div>Waiting for User Selection</div>,
153
- * loading: ({ state }) => <div>Loading user data...</div>,
154
- * cancelled: ({ error, features }) => (
155
- * <div>
156
- * <p>Request Cancelled</p>
157
- * <p><button onClick={features.retry}>Start Again?</button></p>
158
- * </div>
159
- * ),
160
- * error: ({ error, features }) => (
161
- * <div>
162
- * <p>Error: {error.message}</p>
163
- * <p><button onClick={features.retry}>Try Again?</button></p>
164
- * </div>
165
- * ),
166
- * content: ({ result, features }) => (
167
- * <div>
168
- * <h2>User Details</h2>
169
- * <p>ID: {result.id}</p>
170
- * <p>Name: {result.name}</p>
171
- * </div>
172
- * ),
173
- * }}
174
- * />
175
- * );
176
- * }
177
- *
178
- * ```
179
- *
180
- * @category Components
181
- */
109
+ * The `<Request />` component is a powerful tool for managing data fetching and
110
+ * state in your React application. It provides a declarative approach to reactive
111
+ * control-flow for managing requests and state in your application.
112
+ *
113
+ * The `<Request />` component is ideal for handling "boundaries", outside which some
114
+ * state is still allowed to be unresolved and within which it MUST be resolved.
115
+ *
116
+ * ## Request States
117
+ *
118
+ * `<Request />` has five states, only one of which will be active and rendered at a time.
119
+ *
120
+ * - `idle`: The component is waiting to be given a request to monitor
121
+ * - `loading`: The request is in progress
122
+ * - `error`: The request failed
123
+ * - `content`: The request succeeded
124
+ * - `cancelled`: The request was cancelled
125
+ *
126
+ * Additionally, the `content` state has a `refresh` method that can be used to
127
+ * refresh the request in the background, which is available as a sub-state of
128
+ * the `content` state.
129
+ *
130
+ * ### Example Usage
131
+ *
132
+ * ```tsx
133
+ * import { Request } from "@warp-drive/react";
134
+ *
135
+ * export function UserPreview($props: { id: string | null }) {
136
+ * return (
137
+ * <Request
138
+ * query={findRecord('user', $props.id)}
139
+ * states={{
140
+ * idle: () => <div>Waiting for User Selection</div>,
141
+ * loading: ({ state }) => <div>Loading user data...</div>,
142
+ * cancelled: ({ error, features }) => (
143
+ * <div>
144
+ * <p>Request Cancelled</p>
145
+ * <p><button onClick={features.retry}>Start Again?</button></p>
146
+ * </div>
147
+ * ),
148
+ * error: ({ error, features }) => (
149
+ * <div>
150
+ * <p>Error: {error.message}</p>
151
+ * <p><button onClick={features.retry}>Try Again?</button></p>
152
+ * </div>
153
+ * ),
154
+ * content: ({ result, features }) => (
155
+ * <div>
156
+ * <h2>User Details</h2>
157
+ * <p>ID: {result.id}</p>
158
+ * <p>Name: {result.name}</p>
159
+ * </div>
160
+ * ),
161
+ * }}
162
+ * />
163
+ * );
164
+ * }
165
+ *
166
+ * ```
167
+ *
168
+ * @category Components
169
+ */
182
170
  function Request($props) {
183
- return /*#__PURE__*/jsx(ReactiveContext, {
184
- children: /*#__PURE__*/jsx(InternalRequest, {
185
- ...$props
186
- })
187
- });
171
+ return /*#__PURE__*/ jsx(ReactiveContext, { children: /*#__PURE__*/ jsx(InternalRequest, { ...$props }) });
188
172
  }
189
173
  function isStrictModeRender() {
190
- useRef(0);
191
-
192
- // in debug we need to skip every second invocation
193
-
194
- return false;
174
+ useRef(0);
175
+ return false;
195
176
  }
196
177
  function InternalRequest($props) {
197
- isStrictModeRender();
198
- const store = $props.store ?? useStore();
199
- const Chrome = $props.chrome ?? DefaultChrome;
200
- const sink = useRef(null);
201
- const args = useRef(null);
202
- if (!args.current) {
203
- args.current = new ReactiveArgs();
204
- }
205
- Object.assign(args.current, $props);
206
- if (sink.current && (sink.current.store !== store || $props.subscription)) {
207
- sink.current[DISPOSE]();
208
- sink.current = null;
209
- }
210
- if (!sink.current && !$props.subscription) {
211
- sink.current = createRequestSubscription(store, args.current);
212
- }
213
- const initialized = useRef(null);
214
- const effect = () => {
215
- if (sink.current && (!initialized.current || initialized.current.disposable !== sink.current)) {
216
- initialized.current = {
217
- disposable: sink.current,
218
- dispose: () => {
219
- sink.current?.[DISPOSE]();
220
- initialized.current = null;
221
- sink.current = null;
222
- }
223
- };
224
- }
225
- return sink.current ? initialized.current.dispose : undefined;
226
- };
227
- let maybeEffect = effect;
228
- useEffect(maybeEffect, [sink.current]);
229
- const state = $props.subscription ?? sink.current;
230
- const slots = $props.states;
231
- return /*#__PURE__*/jsx(Chrome, {
232
- state: state.isIdle ? null : state.reqState,
233
- features: state.contentFeatures,
234
- children:
235
- // prettier-ignore
236
- state.isIdle && slots.idle ? /*#__PURE__*/jsx(slots.idle, {}) : state.isIdle ? /*#__PURE__*/jsx(Throw, {
237
- error: IdleBlockMissingError
238
- }) : state.reqState.isLoading ? slots.loading ? /*#__PURE__*/jsx(slots.loading, {
239
- state: state.reqState.loadingState
240
- }) : '' : state.reqState.isCancelled && slots.cancelled ? /*#__PURE__*/jsx(slots.cancelled, {
241
- error: state.reqState.reason,
242
- features: state.errorFeatures
243
- }) : state.reqState.isError && slots.error ? /*#__PURE__*/jsx(slots.error, {
244
- error: state.reqState.reason,
245
- features: state.errorFeatures
246
- }) : state.reqState.isSuccess ? slots.content ? /*#__PURE__*/jsx(slots.content, {
247
- result: state.reqState.value,
248
- features: state.contentFeatures
249
- }) : /*#__PURE__*/jsx(Throw, {
250
- error: new Error('No content block provided for <Request> component.')
251
- }) : !state.reqState.isCancelled ? /*#__PURE__*/jsx(Throw, {
252
- error: state.reqState.reason
253
- }) : '' // never
254
- });
178
+ isStrictModeRender();
179
+ const store = $props.store ?? useStore();
180
+ const Chrome = $props.chrome ?? DefaultChrome;
181
+ const sink = useRef(null);
182
+ const args = useRef(null);
183
+ if (!args.current) args.current = new ReactiveArgs();
184
+ Object.assign(args.current, $props);
185
+ if (sink.current && (sink.current.store !== store || $props.subscription)) {
186
+ sink.current[DISPOSE]();
187
+ sink.current = null;
188
+ }
189
+ if (!sink.current && !$props.subscription) sink.current = createRequestSubscription(store, args.current);
190
+ const initialized = useRef(null);
191
+ const effect = () => {
192
+ if (sink.current && (!initialized.current || initialized.current.disposable !== sink.current)) initialized.current = {
193
+ disposable: sink.current,
194
+ dispose: () => {
195
+ sink.current?.[DISPOSE]();
196
+ initialized.current = null;
197
+ sink.current = null;
198
+ }
199
+ };
200
+ return sink.current ? initialized.current.dispose : void 0;
201
+ };
202
+ useEffect(effect, [sink.current]);
203
+ const state = $props.subscription ?? sink.current;
204
+ const slots = $props.states;
205
+ return /*#__PURE__*/ jsx(Chrome, {
206
+ state: state.isIdle ? null : state.reqState,
207
+ features: state.contentFeatures,
208
+ children: state.isIdle && slots.idle ? /*#__PURE__*/ jsx(slots.idle, {}) : state.isIdle ? /*#__PURE__*/ jsx(Throw, { error: IdleBlockMissingError }) : state.reqState.isLoading ? slots.loading ? /*#__PURE__*/ jsx(slots.loading, { state: state.reqState.loadingState }) : "" : state.reqState.isCancelled && slots.cancelled ? /*#__PURE__*/ jsx(slots.cancelled, {
209
+ error: state.reqState.reason,
210
+ features: state.errorFeatures
211
+ }) : state.reqState.isError && slots.error ? /*#__PURE__*/ jsx(slots.error, {
212
+ error: state.reqState.reason,
213
+ features: state.errorFeatures
214
+ }) : state.reqState.isSuccess ? slots.content ? /*#__PURE__*/ jsx(slots.content, {
215
+ result: state.reqState.value,
216
+ features: state.contentFeatures
217
+ }) : /*#__PURE__*/ jsx(Throw, { error: /* @__PURE__ */ new Error("No content block provided for <Request> component.") }) : !state.reqState.isCancelled ? /*#__PURE__*/ jsx(Throw, { error: state.reqState.reason }) : ""
218
+ });
255
219
  }
256
- export { ReactiveContext, Request, StoreProvider, Throw, useStore };
220
+
221
+ //#endregion
222
+ export { ReactiveContext, Request, StoreProvider, Throw, WatcherContext, useStore };
223
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":["Store","createContext","JSX","ReactNode","use","useMemo","jsx","_jsx","StoreContext","useStore","store","StoreProvider","$props","value","children","createRequestSubscription","AutorefreshBehaviorCombos","DISPOSE","RequestArgs","signal","JSX","ReactNode","useEffect","useMemo","useRef","useStore","ReactiveContext","Future","StoreRequestInput","g","i","Fragment","_Fragment","jsx","_jsx","IdleBlockMissingError","Error","ReactiveArgs","prototype","request","void 0","query","autorefresh","autorefreshThreshold","autorefreshBehavior","DefaultChrome","children","Throw","error","Request","$props","InternalRequest","isStrictModeRender","count","isStrict","store","Chrome","chrome","sink","args","current","Object","assign","subscription","initialized","effect","disposable","dispose","undefined","maybeEffect","state","slots","states","isIdle","reqState","features","contentFeatures","idle","isLoading","loading","loadingState","isCancelled","cancelled","reason","errorFeatures","isError","isSuccess","content","result","value"],"sources":["../../../src/-private/store-provider.tsx","../../../../../node_modules/.pnpm/decorat_5005bbc272376d25df08203abab44e2f/node_modules/decorator-transforms/dist/runtime-BPCpkOf1.js","../../../src/-private/request.tsx"],"sourcesContent":["import { Store } from \"@warp-drive/core\";\nimport { assert } from \"@warp-drive/core/build-config/macros\";\nimport { createContext, JSX, ReactNode, use, useMemo } from \"react\";\n\n/**\n * @category Contexts\n */\nconst StoreContext = createContext<Store | null>(null);\n\n/**\n * @category Hooks\n */\nexport function useStore(): Store {\n const store = use(StoreContext);\n assert(\n \"No Store provided via context. Please ensure you are using <StoreProvider> to provide a Store instance.\",\n store\n );\n return store;\n}\n\ntype WithExistingStore = { store: Store; children: ReactNode };\ntype WithNewStore = { Store: typeof Store; children: ReactNode };\n\n/**\n * @category Components\n */\nexport function StoreProvider($props: WithExistingStore | WithNewStore): JSX.Element {\n const store = useMemo(\n () => (\"store\" in $props ? $props.store : new $props.Store()),\n [\"store\" in $props ? $props.store : $props.Store]\n );\n\n return <StoreContext value={store}>{$props.children}</StoreContext>;\n}\n","const deferred = /* @__PURE__ */ new WeakMap();\nfunction deferDecorator(proto, prop, desc) {\n let map = deferred.get(proto);\n if (!map) {\n map = /* @__PURE__ */ new Map();\n deferred.set(proto, map);\n }\n map.set(prop, desc);\n}\nfunction findDeferredDecorator(target, prop) {\n var _a;\n let cursor = target.prototype;\n while (cursor) {\n let desc = (_a = deferred.get(cursor)) == null ? void 0 : _a.get(prop);\n if (desc) {\n return desc;\n }\n cursor = cursor.prototype;\n }\n}\nfunction decorateFieldV1(target, prop, decorators, initializer) {\n return decorateFieldV2(target.prototype, prop, decorators, initializer);\n}\nfunction decorateFieldV2(prototype, prop, decorators, initializer) {\n let desc = {\n configurable: true,\n enumerable: true,\n writable: true,\n initializer: null\n };\n if (initializer) {\n desc.initializer = initializer;\n }\n for (let decorator of decorators) {\n desc = decorator(prototype, prop, desc) || desc;\n }\n if (desc.initializer === void 0) {\n Object.defineProperty(prototype, prop, desc);\n } else {\n deferDecorator(prototype, prop, desc);\n }\n}\nfunction decorateMethodV1({ prototype }, prop, decorators) {\n return decorateMethodV2(prototype, prop, decorators);\n}\nfunction decorateMethodV2(prototype, prop, decorators) {\n const origDesc = Object.getOwnPropertyDescriptor(prototype, prop);\n let desc = { ...origDesc };\n for (let decorator of decorators) {\n desc = decorator(prototype, prop, desc) || desc;\n }\n if (desc.initializer !== void 0) {\n desc.value = desc.initializer ? desc.initializer.call(prototype) : void 0;\n desc.initializer = void 0;\n }\n Object.defineProperty(prototype, prop, desc);\n}\nfunction initializeDeferredDecorator(target, prop) {\n let desc = findDeferredDecorator(target.constructor, prop);\n if (desc) {\n Object.defineProperty(target, prop, {\n enumerable: desc.enumerable,\n configurable: desc.configurable,\n writable: desc.writable,\n value: desc.initializer ? desc.initializer.call(target) : void 0\n });\n }\n}\nfunction decorateClass(target, decorators) {\n return decorators.reduce(\n (accum, decorator) => decorator(accum) || accum,\n target\n );\n}\nfunction decoratePOJO(pojo, decorated) {\n for (let [type, prop, decorators] of decorated) {\n if (type === \"field\") {\n decoratePojoField(pojo, prop, decorators);\n } else {\n decorateMethodV2(pojo, prop, decorators);\n }\n }\n return pojo;\n}\nfunction decoratePojoField(pojo, prop, decorators) {\n let desc = {\n configurable: true,\n enumerable: true,\n writable: true,\n initializer: () => {\n var _a;\n return (_a = Object.getOwnPropertyDescriptor(pojo, prop)) == null ? void 0 : _a.value;\n }\n };\n for (let decorator of decorators) {\n desc = decorator(pojo, prop, desc) || desc;\n }\n if (desc.initializer) {\n desc.value = desc.initializer.call(pojo);\n delete desc.initializer;\n }\n Object.defineProperty(pojo, prop, desc);\n}\nconst runtime = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({\n __proto__: null,\n c: decorateClass,\n f: decorateFieldV1,\n g: decorateFieldV2,\n i: initializeDeferredDecorator,\n m: decorateMethodV1,\n n: decorateMethodV2,\n p: decoratePOJO\n}, Symbol.toStringTag, { value: \"Module\" }));\nexport {\n decorateFieldV2 as a,\n decorateMethodV1 as b,\n decorateMethodV2 as c,\n decorateFieldV1 as d,\n decorateClass as e,\n decoratePOJO as f,\n initializeDeferredDecorator as i,\n runtime as r\n};\n//# sourceMappingURL=runtime-BPCpkOf1.js.map\n","import {\n createRequestSubscription,\n type RequestLoadingState,\n type RequestState,\n type RequestSubscription,\n} from \"@warp-drive/core/reactive\";\nimport {\n AutorefreshBehaviorCombos,\n DISPOSE,\n RequestArgs,\n signal,\n type ContentFeatures,\n type RecoveryFeatures,\n type SubscriptionArgs,\n} from \"@warp-drive/core/signals/-leaked\";\nimport type { StructuredErrorDocument } from \"@warp-drive/core/types/request\";\nimport { JSX, ReactNode, useEffect, useMemo, useRef } from \"react\";\nimport { useStore } from \"./store-provider\";\nimport { ReactiveContext } from \"./reactive-context\";\nimport { Future } from \"@warp-drive/core/request\";\nimport { StoreRequestInput } from \"@warp-drive/core\";\nimport { DEBUG } from \"@warp-drive/core/build-config/env\";\n\nconst IdleBlockMissingError = new Error(\n \"No idle block provided for <Request> component, and no query or request was provided.\"\n);\n\nclass ReactiveArgs<RT, E> implements SubscriptionArgs<RT, E> {\n @signal request?: Future<RT> | undefined | null;\n @signal query?: StoreRequestInput<RT> | undefined | null;\n @signal autorefresh?: AutorefreshBehaviorCombos | undefined;\n @signal autorefreshThreshold?: number | undefined;\n @signal autorefreshBehavior?: \"refresh\" | \"reload\" | \"policy\";\n}\n\ninterface ChromeComponentProps<RT> {\n children: ReactNode;\n state: RequestState | null;\n features: ContentFeatures<RT>;\n}\n\nconst DefaultChrome = <RT,>({ children }: ChromeComponentProps<RT>) => {\n return <>{children}</>;\n};\n\nexport interface RequestProps<RT, E> extends RequestArgs<RT, E> {\n chrome?: React.FC<ChromeComponentProps<RT>>;\n\n states: RequestStates<RT, E>;\n}\n\ninterface RequestStates<RT, E> {\n /**\n * The block to render when the component is idle and waiting to be given a request.\n *\n */\n idle?: React.FC<{}>;\n\n /**\n * The block to render when the request is loading.\n *\n */\n loading?: React.FC<{ state: RequestLoadingState }>;\n\n /**\n * The block to render when the request was cancelled.\n *\n */\n cancelled?: React.FC<{\n /**\n * The Error the request rejected with.\n */\n error: StructuredErrorDocument<E>;\n /**\n * Utilities to assist in recovering from the error.\n */\n features: RecoveryFeatures;\n }>;\n\n /**\n * The block to render when the request failed. If this block is not provided,\n * the error will be rethrown.\n *\n * Thus it is required to provide an error block and proper error handling if\n * you do not want the error to crash the application.\n */\n error: React.FC<{\n /**\n * The Error the request rejected with.\n */\n error: StructuredErrorDocument<E>;\n /**\n * Utilities to assist in recovering from the error.\n */\n features: RecoveryFeatures;\n }>;\n\n /**\n * The block to render when the request succeeded.\n *\n */\n content: React.FC<{ result: RT; features: ContentFeatures<RT> }>;\n}\n\n/**\n * Throws the given error. Used internally to rethrow request errors that\n * are not otherwise handled by a provided error/cancelled block.\n *\n * @private\n */\nexport function Throw({ error }: { error: Error }): never {\n throw error;\n}\n\n/**\n * The `<Request />` component is a powerful tool for managing data fetching and\n * state in your React application. It provides a declarative approach to reactive\n * control-flow for managing requests and state in your application.\n *\n * The `<Request />` component is ideal for handling \"boundaries\", outside which some\n * state is still allowed to be unresolved and within which it MUST be resolved.\n *\n * ## Request States\n *\n * `<Request />` has five states, only one of which will be active and rendered at a time.\n *\n * - `idle`: The component is waiting to be given a request to monitor\n * - `loading`: The request is in progress\n * - `error`: The request failed\n * - `content`: The request succeeded\n * - `cancelled`: The request was cancelled\n *\n * Additionally, the `content` state has a `refresh` method that can be used to\n * refresh the request in the background, which is available as a sub-state of\n * the `content` state.\n *\n * ### Example Usage\n *\n * ```tsx\n * import { Request } from \"@warp-drive/react\";\n *\n * export function UserPreview($props: { id: string | null }) {\n * return (\n * <Request\n * query={findRecord('user', $props.id)}\n * states={{\n * idle: () => <div>Waiting for User Selection</div>,\n * loading: ({ state }) => <div>Loading user data...</div>,\n * cancelled: ({ error, features }) => (\n * <div>\n * <p>Request Cancelled</p>\n * <p><button onClick={features.retry}>Start Again?</button></p>\n * </div>\n * ),\n * error: ({ error, features }) => (\n * <div>\n * <p>Error: {error.message}</p>\n * <p><button onClick={features.retry}>Try Again?</button></p>\n * </div>\n * ),\n * content: ({ result, features }) => (\n * <div>\n * <h2>User Details</h2>\n * <p>ID: {result.id}</p>\n * <p>Name: {result.name}</p>\n * </div>\n * ),\n * }}\n * />\n * );\n * }\n *\n * ```\n *\n * @category Components\n */\nexport function Request<RT, E>($props: RequestProps<RT, E>): JSX.Element {\n return (\n <ReactiveContext>\n <InternalRequest {...$props} />\n </ReactiveContext>\n );\n}\n\nfunction isStrictModeRender(): boolean {\n const count = useRef<number>(0);\n\n // in debug we need to skip every second invocation\n if (DEBUG) {\n if (count.current++ % 2 === 1) {\n return true;\n }\n }\n\n return false;\n}\n\nfunction InternalRequest<RT, E>($props: RequestProps<RT, E>): JSX.Element {\n const isStrict = isStrictModeRender();\n const store = $props.store ?? useStore();\n const Chrome = $props.chrome ?? DefaultChrome;\n const sink = useRef<RequestSubscription<RT, E> | null>(null);\n const args = useRef<SubscriptionArgs<RT, E> | null>(null);\n\n if (!args.current) {\n args.current = new ReactiveArgs<RT, E>();\n }\n Object.assign(args.current, $props);\n\n if (sink.current && (sink.current.store !== store || $props.subscription)) {\n sink.current[DISPOSE]();\n sink.current = null;\n }\n\n if (!sink.current && !$props.subscription) {\n sink.current = createRequestSubscription(store, args.current!);\n }\n\n const initialized = useRef<null | {\n disposable: { [DISPOSE]: () => void } | null;\n dispose: () => void;\n }>(null);\n const effect = () => {\n if (sink.current && (!initialized.current || initialized.current.disposable !== sink.current)) {\n initialized.current = {\n disposable: sink.current,\n dispose: () => {\n sink.current?.[DISPOSE]();\n initialized.current = null;\n sink.current = null;\n },\n };\n }\n\n return sink.current ? initialized.current!.dispose : undefined;\n };\n let maybeEffect = effect;\n\n if (DEBUG) {\n if (isStrict) {\n maybeEffect = () => {\n if (initialized.current) {\n return effect();\n }\n return () => {\n // initialize our actual effect\n effect();\n // in strict mode we don't want to run the teardown\n // for the second invocation\n };\n };\n }\n }\n\n useEffect(maybeEffect, [sink.current]);\n\n const state = $props.subscription ?? sink.current!;\n const slots = $props.states;\n\n return (\n <Chrome state={state.isIdle ? null : state.reqState} features={state.contentFeatures}>\n {\n // prettier-ignore\n state.isIdle && slots.idle ? <slots.idle />\n : state.isIdle ? <Throw error={IdleBlockMissingError} />\n : state.reqState.isLoading ? slots.loading ? <slots.loading state={state.reqState.loadingState} /> : ''\n : state.reqState.isCancelled && slots.cancelled ? <slots.cancelled error={state.reqState.reason} features={state.errorFeatures} />\n : state.reqState.isError && slots.error ? <slots.error error={state.reqState.reason} features={state.errorFeatures} />\n : state.reqState.isSuccess ? slots.content ? <slots.content result={state.reqState.value} features={state.contentFeatures} /> : <Throw error={new Error('No content block provided for <Request> component.')} />\n : !state.reqState.isCancelled ? <Throw error={state.reqState.reason} />\n : '' // never\n }\n </Chrome>\n );\n}\n"],"x_google_ignoreList":[1],"mappings":"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"}
@@ -1,71 +1,64 @@
1
- import { use } from 'react';
2
- import { Signal } from 'signal-polyfill';
3
- import { setupSignals } from '@warp-drive/core/configure';
4
- import { W as WatcherContext } from "./reactive-context-DKimDkR3.js";
1
+ import { n as WatcherContext } from "./reactive-context-CvfXAZqb.js";
2
+ import { Signal } from "signal-polyfill";
3
+ import { use } from "react";
4
+ import { setupSignals } from "@warp-drive/core/configure";
5
5
 
6
+ //#region src/install.ts
6
7
  /**
7
- * {@include ./install.md}
8
- * @module
9
- */
10
-
8
+ * {@include ./install.md}
9
+ * @module
10
+ */
11
11
  function tryConsumeContext(signal) {
12
- // eslint-disable-next-line no-console
13
- const logError = console.error;
14
- try {
15
- // eslint-disable-next-line no-console
16
- console.error = () => {};
17
- // ensure signals are watched by our closest watcher
18
- const watcher = use(WatcherContext);
19
- // eslint-disable-next-line no-console
20
- console.error = logError;
21
- watcher?.watcher.watch(signal);
22
- } catch {
23
- // eslint-disable-next-line no-console
24
- console.error = logError;
25
- // if we are not in a React context, we will Error
26
- // so we just ignore it.
27
- }
12
+ const logError = console.error;
13
+ try {
14
+ console.error = () => {};
15
+ const watcher = use(WatcherContext);
16
+ console.error = logError;
17
+ watcher?.watcher.watch(signal);
18
+ } catch {
19
+ console.error = logError;
20
+ }
28
21
  }
29
22
  /**
30
- * Resolves once all pending requests started via WarpDrive's React signal
31
- * integration have settled. Only tracks requests while `TESTING` is enabled;
32
- * a no-op otherwise.
33
- *
34
- * @public
35
- */
23
+ * Resolves once all pending requests started via WarpDrive's React signal
24
+ * integration have settled. Only tracks requests while `TESTING` is enabled;
25
+ * a no-op otherwise.
26
+ *
27
+ * @public
28
+ */
36
29
  async function settled() {}
37
-
38
30
  /**
39
- * Builds the {@link SignalHooks} implementation backed by the
40
- * [Signal Polyfill](https://github.com/proposal-signals/signal-polyfill),
41
- * used to wire WarpDrive's reactivity primitives into React.
42
- *
43
- * @public
44
- */
31
+ * Builds the {@link SignalHooks} implementation backed by the
32
+ * [Signal Polyfill](https://github.com/proposal-signals/signal-polyfill),
33
+ * used to wire WarpDrive's reactivity primitives into React.
34
+ *
35
+ * @public
36
+ */
45
37
  function buildSignalConfig(options) {
46
- return {
47
- createSignal: (obj, key) => new Signal.State(null, {
48
- equals: () => false
49
- }),
50
- notifySignal: signal => {
51
- signal.set(signal.get());
52
- },
53
- consumeSignal: signal => {
54
- tryConsumeContext(signal);
55
- void signal.get();
56
- },
57
- createMemo: (object, key, fn) => {
58
- const memo = new Signal.Computed(fn);
59
- return () => {
60
- tryConsumeContext(memo);
61
- return memo.get();
62
- };
63
- },
64
- waitFor: promise => {
65
- return promise;
66
- },
67
- willSyncFlushWatchers: () => false
68
- };
38
+ return {
39
+ createSignal: (obj, key) => new Signal.State(null, { equals: () => false }),
40
+ notifySignal: (signal) => {
41
+ signal.set(signal.get());
42
+ },
43
+ consumeSignal: (signal) => {
44
+ tryConsumeContext(signal);
45
+ signal.get();
46
+ },
47
+ createMemo: (object, key, fn) => {
48
+ const memo = new Signal.Computed(fn);
49
+ return () => {
50
+ tryConsumeContext(memo);
51
+ return memo.get();
52
+ };
53
+ },
54
+ waitFor: (promise) => {
55
+ return promise;
56
+ },
57
+ willSyncFlushWatchers: () => false
58
+ };
69
59
  }
70
60
  setupSignals(buildSignalConfig);
71
- export { buildSignalConfig, settled };
61
+
62
+ //#endregion
63
+ export { buildSignalConfig, settled };
64
+ //# sourceMappingURL=install.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install.js","names":["use","Signal","setupSignals","WatcherContext","tryConsumeContext","signal","logError","console","error","watcher","watch","pending","settled","buildSignalConfig","options","createSignal","obj","key","State","equals","notifySignal","set","get","consumeSignal","createMemo","object","fn","memo","Computed","waitFor","promise","willSyncFlushWatchers"],"sources":["../../../src/install.ts"],"sourcesContent":["/**\n * {@include ./install.md}\n * @module\n */\n\nimport { use } from 'react';\nimport { Signal } from 'signal-polyfill';\n\nimport { LOG_REACT_SIGNAL_INTEGRATION } from '@warp-drive/core/build-config/debugging';\nimport { DEBUG, TESTING } from '@warp-drive/core/build-config/env';\nimport { type HooksOptions, setupSignals, type SignalHooks } from '@warp-drive/core/configure';\n\nimport { WatcherContext } from './-private/reactive-context';\n\nfunction tryConsumeContext(signal: Signal.State<unknown> | Signal.Computed<unknown>): void {\n // eslint-disable-next-line no-console\n const logError = console.error;\n try {\n // eslint-disable-next-line no-console\n console.error = () => {};\n // ensure signals are watched by our closest watcher\n const watcher = use(WatcherContext);\n // eslint-disable-next-line no-console\n console.error = logError;\n watcher?.watcher.watch(signal);\n if (LOG_REACT_SIGNAL_INTEGRATION) {\n // eslint-disable-next-line no-console\n console.log(`[WarpDrive] Consumed Context Signal`, signal, watcher);\n }\n } catch {\n // eslint-disable-next-line no-console\n console.error = logError;\n // if we are not in a React context, we will Error\n // so we just ignore it.\n if (LOG_REACT_SIGNAL_INTEGRATION) {\n // eslint-disable-next-line no-console\n console.log(`[WarpDrive] No Context Available To Consume Signal`, signal);\n }\n }\n}\n\nlet pending: Promise<unknown>[];\n/**\n * Resolves once all pending requests started via WarpDrive's React signal\n * integration have settled. Only tracks requests while `TESTING` is enabled;\n * a no-op otherwise.\n *\n * @public\n */\nexport async function settled(): Promise<void> {\n if (TESTING) {\n // in testing mode we provide a test waiter integration\n if (!pending || !pending.length) return;\n const current = pending ?? [];\n pending = [];\n await Promise.allSettled(current);\n await Promise.resolve();\n await Promise.resolve();\n await Promise.resolve();\n\n return settled();\n }\n}\n\n/**\n * Builds the {@link SignalHooks} implementation backed by the\n * [Signal Polyfill](https://github.com/proposal-signals/signal-polyfill),\n * used to wire WarpDrive's reactivity primitives into React.\n *\n * @public\n */\nexport function buildSignalConfig(options: HooksOptions): SignalHooks {\n return {\n createSignal: (obj: object, key: string | symbol) =>\n new Signal.State(DEBUG ? { obj, key } : null, { equals: () => false }),\n\n notifySignal: (signal: Signal.State<unknown>) => {\n if (LOG_REACT_SIGNAL_INTEGRATION) {\n if (Signal.subtle.hasSinks(signal)) {\n // eslint-disable-next-line no-console\n console.log(`[WarpDrive] Notifying Signal`, signal);\n } else {\n // eslint-disable-next-line no-console\n console.log(`[WarpDrive] Notified Signal That Has No Watcher`, signal);\n }\n }\n signal.set(signal.get());\n },\n\n consumeSignal: (signal: Signal.State<unknown>) => {\n tryConsumeContext(signal);\n void signal.get();\n },\n\n createMemo: <F>(object: object, key: string | symbol, fn: () => F): (() => F) => {\n const memo = new Signal.Computed<F>(fn);\n return () => {\n tryConsumeContext(memo);\n\n return memo.get();\n };\n },\n\n waitFor: (promise) => {\n if (TESTING) {\n pending = pending || [];\n const newPromise = promise.finally(() => {\n pending = pending.filter((p) => p !== newPromise);\n });\n pending.push(newPromise);\n return newPromise;\n }\n return promise;\n },\n\n willSyncFlushWatchers: () => false,\n } as SignalHooks;\n}\n\nsetupSignals(buildSignalConfig);\n"],"mappings":";;;;;;;;;;AAcA,SAASI,kBAAkBC,QAAgE;CAEzF,MAAMC,WAAWC,QAAQC;CACzB,IAAI;EAEFD,QAAQC,cAAc,CAAC;EAEvB,MAAMC,UAAUT,IAAIG,cAAc;EAElCI,QAAQC,QAAQF;EAChBG,SAASA,QAAQC,MAAML,MAAM;CAK/B,QAAQ;EAENE,QAAQC,QAAQF;CAOlB;AACF;;;;;;;;AAUA,eAAsBM,UAAyB,CAa/C;;;;;;;;AASA,SAAgBC,kBAAkBC,SAAoC;CACpE,OAAO;EACLC,eAAeC,KAAaC,QAC1B,IAAIhB,OAAOiB,MAA6B,MAAM,EAAEC,cAAc,MAAM,CAAC;EAEvEC,eAAef,WAAkC;GAU/CA,OAAOgB,IAAIhB,OAAOiB,IAAI,CAAC;EACzB;EAEAC,gBAAgBlB,WAAkC;GAChDD,kBAAkBC,MAAM;GACxB,AAAKA,OAAOiB,IAAI;EAClB;EAEAE,aAAgBC,QAAgBR,KAAsBS,OAA2B;GAC/E,MAAMC,OAAO,IAAI1B,OAAO2B,SAAYF,EAAE;GACtC,aAAa;IACXtB,kBAAkBuB,IAAI;IAEtB,OAAOA,KAAKL,IAAI;GAClB;EACF;EAEAO,UAAUC,YAAY;GASpB,OAAOA;EACT;EAEAC,6BAA6B;CAC/B;AACF;AAEA7B,aAAaW,iBAAiB"}