@warp-drive-mirror/react 5.9.0-beta.0 → 5.9.0-beta.2

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 (46) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/dist/index.d.ts +180 -0
  3. package/dist/index.d.ts.map +1 -0
  4. package/dist/index.js +216 -251
  5. package/dist/index.js.map +1 -0
  6. package/dist/install.d.ts +21 -0
  7. package/dist/install.d.ts.map +1 -0
  8. package/dist/install.js +90 -94
  9. package/dist/install.js.map +1 -0
  10. package/dist/reactive-context-DhUW_l--.js +122 -0
  11. package/dist/reactive-context-DhUW_l--.js.map +1 -0
  12. package/dist/unpkg/dev/index.js +260 -299
  13. package/dist/unpkg/dev/index.js.map +1 -0
  14. package/dist/unpkg/dev/install.js +82 -92
  15. package/dist/unpkg/dev/install.js.map +1 -0
  16. package/dist/unpkg/dev/reactive-context-Ax2U-96G.js +218 -0
  17. package/dist/unpkg/dev/reactive-context-Ax2U-96G.js.map +1 -0
  18. package/dist/unpkg/dev-deprecated/index.js +260 -299
  19. package/dist/unpkg/dev-deprecated/index.js.map +1 -0
  20. package/dist/unpkg/dev-deprecated/install.js +82 -92
  21. package/dist/unpkg/dev-deprecated/install.js.map +1 -0
  22. package/dist/unpkg/dev-deprecated/reactive-context-B-pn7tS7.js +218 -0
  23. package/dist/unpkg/dev-deprecated/reactive-context-B-pn7tS7.js.map +1 -0
  24. package/dist/unpkg/prod/index.js +199 -226
  25. package/dist/unpkg/prod/index.js.map +1 -0
  26. package/dist/unpkg/prod/install.js +56 -48
  27. package/dist/unpkg/prod/install.js.map +1 -0
  28. package/dist/unpkg/prod/reactive-context-eAEvPuqb.js +92 -0
  29. package/dist/unpkg/prod/reactive-context-eAEvPuqb.js.map +1 -0
  30. package/dist/unpkg/prod-deprecated/index.js +199 -226
  31. package/dist/unpkg/prod-deprecated/index.js.map +1 -0
  32. package/dist/unpkg/prod-deprecated/install.js +56 -48
  33. package/dist/unpkg/prod-deprecated/install.js.map +1 -0
  34. package/dist/unpkg/prod-deprecated/reactive-context-eAEvPuqb.js +92 -0
  35. package/dist/unpkg/prod-deprecated/reactive-context-eAEvPuqb.js.map +1 -0
  36. package/package.json +25 -33
  37. package/declarations/-private/reactive-context.d.ts +0 -18
  38. package/declarations/-private/request.d.ts +0 -142
  39. package/declarations/-private/store-provider.d.ts +0 -19
  40. package/declarations/index.d.ts +0 -7
  41. package/declarations/install.d.ts +0 -3
  42. package/dist/reactive-context-ClTRYXie.js +0 -154
  43. package/dist/unpkg/dev/reactive-context-B815u0_c.js +0 -290
  44. package/dist/unpkg/dev-deprecated/reactive-context-DMgQ7YV_.js +0 -290
  45. package/dist/unpkg/prod/reactive-context-DKimDkR3.js +0 -110
  46. package/dist/unpkg/prod-deprecated/reactive-context-DKimDkR3.js +0 -110
@@ -1,250 +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-mirror/core';
4
- import { useMemo, createContext, use, useRef, useEffect } from 'react';
5
- import { jsx, Fragment } from 'react/jsx-runtime';
6
- import { createRequestSubscription } from '@warp-drive-mirror/core/reactive';
7
- import { DISPOSE, signal } from '@warp-drive-mirror/core/signals/-leaked';
8
- import '@warp-drive-mirror/core/request';
9
- const StoreContext = /*#__PURE__*/createContext(null);
1
+ import { n as WatcherContext, t as ReactiveContext } from "./reactive-context-eAEvPuqb.js";
2
+ import { createContext, use, useEffect, useMemo, useRef } from "react";
3
+ import { Fragment, jsx } from "react/jsx-runtime";
4
+ import { createRequestSubscription } from "@warp-drive-mirror/core/reactive";
5
+ import { DISPOSE, signal } from "@warp-drive-mirror/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_5d4eca388601a94e7fbc656401b751d1/node_modules/decorator-transforms/dist/runtime--fcdnjmJ.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 = Object.getPrototypeOf(cursor);
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
- function Throw({
109
- error
110
- }) {
111
- throw error;
99
+ /**
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;
112
107
  }
113
-
114
108
  /**
115
- * The `<Request />` component is a powerful tool for managing data fetching and
116
- * state in your React application. It provides a declarative approach to reactive
117
- * control-flow for managing requests and state in your application.
118
- *
119
- * The `<Request />` component is ideal for handling "boundaries", outside which some
120
- * state is still allowed to be unresolved and within which it MUST be resolved.
121
- *
122
- * ## Request States
123
- *
124
- * `<Request />` has five states, only one of which will be active and rendered at a time.
125
- *
126
- * - `idle`: The component is waiting to be given a request to monitor
127
- * - `loading`: The request is in progress
128
- * - `error`: The request failed
129
- * - `content`: The request succeeded
130
- * - `cancelled`: The request was cancelled
131
- *
132
- * Additionally, the `content` state has a `refresh` method that can be used to
133
- * refresh the request in the background, which is available as a sub-state of
134
- * the `content` state.
135
- *
136
- * ### Example Usage
137
- *
138
- * ```tsx
139
- * import { Request } from "@warp-drive-mirror/react";
140
- *
141
- * export function UserPreview($props: { id: string | null }) {
142
- * return (
143
- * <Request
144
- * query={findRecord('user', $props.id)}
145
- * states={{
146
- * idle: () => <div>Waiting for User Selection</div>,
147
- * loading: ({ state }) => <div>Loading user data...</div>,
148
- * cancelled: ({ error, features }) => (
149
- * <div>
150
- * <p>Request Cancelled</p>
151
- * <p><button onClick={features.retry}>Start Again?</button></p>
152
- * </div>
153
- * ),
154
- * error: ({ error, features }) => (
155
- * <div>
156
- * <p>Error: {error.message}</p>
157
- * <p><button onClick={features.retry}>Try Again?</button></p>
158
- * </div>
159
- * ),
160
- * content: ({ result, features }) => (
161
- * <div>
162
- * <h2>User Details</h2>
163
- * <p>ID: {result.id}</p>
164
- * <p>Name: {result.name}</p>
165
- * </div>
166
- * ),
167
- * }}
168
- * />
169
- * );
170
- * }
171
- *
172
- * ```
173
- *
174
- * @category Components
175
- */
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-mirror/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
+ */
176
170
  function Request($props) {
177
- return /*#__PURE__*/jsx(ReactiveContext, {
178
- children: /*#__PURE__*/jsx(InternalRequest, {
179
- ...$props
180
- })
181
- });
171
+ return /*#__PURE__*/ jsx(ReactiveContext, { children: /*#__PURE__*/ jsx(InternalRequest, { ...$props }) });
182
172
  }
183
173
  function isStrictModeRender() {
184
- useRef(0);
185
-
186
- // in debug we need to skip every second invocation
187
-
188
- return false;
174
+ useRef(0);
175
+ return false;
189
176
  }
190
177
  function InternalRequest($props) {
191
- isStrictModeRender();
192
- const store = $props.store ?? useStore();
193
- const Chrome = $props.chrome ?? DefaultChrome;
194
- const sink = useRef(null);
195
- const args = useRef(null);
196
- if (!args.current) {
197
- args.current = new ReactiveArgs();
198
- }
199
- Object.assign(args.current, $props);
200
- if (sink.current && (sink.current.store !== store || $props.subscription)) {
201
- sink.current[DISPOSE]();
202
- sink.current = null;
203
- }
204
- if (!sink.current && !$props.subscription) {
205
- sink.current = createRequestSubscription(store, args.current);
206
- }
207
- const initialized = useRef(null);
208
- const effect = () => {
209
- if (sink.current && (!initialized.current || initialized.current.disposable !== sink.current)) {
210
- initialized.current = {
211
- disposable: sink.current,
212
- dispose: () => {
213
- sink.current?.[DISPOSE]();
214
- initialized.current = null;
215
- sink.current = null;
216
- }
217
- };
218
- }
219
- return sink.current ? initialized.current.dispose : undefined;
220
- };
221
- let maybeEffect = effect;
222
- useEffect(maybeEffect, [sink.current]);
223
- const state = $props.subscription ?? sink.current;
224
- const slots = $props.states;
225
- return /*#__PURE__*/jsx(Chrome, {
226
- state: state.isIdle ? null : state.reqState,
227
- features: state.contentFeatures,
228
- children:
229
- // prettier-ignore
230
- state.isIdle && slots.idle ? /*#__PURE__*/jsx(slots.idle, {}) : state.isIdle ? /*#__PURE__*/jsx(Throw, {
231
- error: IdleBlockMissingError
232
- }) : state.reqState.isLoading ? slots.loading ? /*#__PURE__*/jsx(slots.loading, {
233
- state: state.reqState.loadingState
234
- }) : '' : state.reqState.isCancelled && slots.cancelled ? /*#__PURE__*/jsx(slots.cancelled, {
235
- error: state.reqState.reason,
236
- features: state.errorFeatures
237
- }) : state.reqState.isError && slots.error ? /*#__PURE__*/jsx(slots.error, {
238
- error: state.reqState.reason,
239
- features: state.errorFeatures
240
- }) : state.reqState.isSuccess ? slots.content ? /*#__PURE__*/jsx(slots.content, {
241
- result: state.reqState.value,
242
- features: state.contentFeatures
243
- }) : /*#__PURE__*/jsx(Throw, {
244
- error: new Error('No content block provided for <Request> component.')
245
- }) : !state.reqState.isCancelled ? /*#__PURE__*/jsx(Throw, {
246
- error: state.reqState.reason
247
- }) : '' // never
248
- });
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
+ });
249
219
  }
250
- 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":["createContext","use","useMemo","jsx","_jsx","StoreContext","useStore","store","StoreProvider","$props","Store","value","children","useEffect","useRef","createRequestSubscription","DISPOSE","signal","ReactiveContext","useStore","g","i","Fragment","_Fragment","jsx","_jsx","IdleBlockMissingError","Error","ReactiveArgs","prototype","request","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_5d4eca388601a94e7fbc656401b751d1/node_modules/decorator-transforms/dist/runtime--fcdnjmJ.js","../../../src/-private/request.tsx"],"sourcesContent":["import type { JSX, ReactNode } from \"react\";\nimport { createContext, use, useMemo } from \"react\";\n\nimport type { Store } from \"@warp-drive-mirror/core\";\nimport { assert } from \"@warp-drive-mirror/core/build-config/macros\";\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 = Object.getPrototypeOf(cursor);\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 decorateFieldV1 as a,\n decorateFieldV2 as b,\n decorateMethodV1 as c,\n decorateClass as d,\n decorateMethodV2 as e,\n decoratePOJO as f,\n initializeDeferredDecorator as i,\n runtime as r\n};\n//# sourceMappingURL=runtime--fcdnjmJ.js.map\n","import type { JSX, ReactNode } from \"react\";\nimport { useEffect, useRef } from \"react\";\n\nimport type { StoreRequestInput } from \"@warp-drive-mirror/core\";\nimport { DEBUG } from \"@warp-drive-mirror/core/build-config/env\";\nimport {\n createRequestSubscription,\n type RequestLoadingState,\n type RequestState,\n type RequestSubscription,\n} from \"@warp-drive-mirror/core/reactive\";\nimport type { Future } from \"@warp-drive-mirror/core/request\";\nimport {\n type AutorefreshBehaviorCombos,\n DISPOSE,\n type RequestArgs,\n signal,\n type ContentFeatures,\n type RecoveryFeatures,\n type SubscriptionArgs,\n} from \"@warp-drive-mirror/core/signals/-leaked\";\nimport type { StructuredErrorDocument } from \"@warp-drive-mirror/core/types/request\";\n\nimport { ReactiveContext } from \"./reactive-context\";\nimport { useStore } from \"./store-provider\";\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<object>;\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-mirror/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,56 +1,64 @@
1
- import { use } from 'react';
2
- import { Signal } from 'signal-polyfill';
3
- import { setupSignals } from '@warp-drive-mirror/core/configure';
4
- import { W as WatcherContext } from "./reactive-context-DKimDkR3.js";
1
+ import { n as WatcherContext } from "./reactive-context-eAEvPuqb.js";
2
+ import { use } from "react";
3
+ import { Signal } from "signal-polyfill";
4
+ import { setupSignals } from "@warp-drive-mirror/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
  }
22
+ /**
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
+ */
29
29
  async function settled() {}
30
+ /**
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
+ */
30
37
  function buildSignalConfig(options) {
31
- return {
32
- createSignal: (obj, key) => new Signal.State(null, {
33
- equals: () => false
34
- }),
35
- notifySignal: signal => {
36
- signal.set(signal.get());
37
- },
38
- consumeSignal: signal => {
39
- tryConsumeContext(signal);
40
- void signal.get();
41
- },
42
- createMemo: (object, key, fn) => {
43
- const memo = new Signal.Computed(fn);
44
- return () => {
45
- tryConsumeContext(memo);
46
- return memo.get();
47
- };
48
- },
49
- waitFor: promise => {
50
- return promise;
51
- },
52
- willSyncFlushWatchers: () => false
53
- };
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
+ };
54
59
  }
55
60
  setupSignals(buildSignalConfig);
56
- 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-mirror/core/build-config/debugging';\nimport { DEBUG, TESTING } from '@warp-drive-mirror/core/build-config/env';\nimport { type HooksOptions, setupSignals, type SignalHooks } from '@warp-drive-mirror/core/configure';\n\nimport { WatcherContext } from './-private/reactive-context';\n\nfunction tryConsumeContext(signal: Signal.State<unknown> | Signal.Computed<unknown>): void {\n // oxlint-disable-next-line no-console\n const logError = console.error;\n try {\n // oxlint-disable-next-line no-console\n console.error = () => {};\n // ensure signals are watched by our closest watcher\n const watcher = use(WatcherContext);\n // oxlint-disable-next-line no-console\n console.error = logError;\n watcher?.watcher.watch(signal);\n if (LOG_REACT_SIGNAL_INTEGRATION) {\n // oxlint-disable-next-line no-console\n console.log(`[WarpDrive] Consumed Context Signal`, signal, watcher);\n }\n } catch {\n // oxlint-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 // oxlint-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 // oxlint-disable-next-line no-console\n console.log(`[WarpDrive] Notifying Signal`, signal);\n } else {\n // oxlint-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"}