@expressive/react 0.78.0 → 0.79.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{runtime.d.ts → adapter.d.ts} +61 -28
- package/dist/adapter.js +346 -0
- package/dist/adapter.js.map +1 -0
- package/dist/index.d.ts +2 -3
- package/dist/index.js +2 -3
- package/dist/index.js.map +1 -1
- package/package.json +9 -9
- package/dist/context-B-HNZeaN.d.ts +0 -49
- package/dist/context-BfeYQmAX.js +0 -59
- package/dist/context-BfeYQmAX.js.map +0 -1
- package/dist/runtime.js +0 -74
- package/dist/runtime.js.map +0 -1
|
@@ -1,20 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import
|
|
1
|
+
import { Component, Context as Context$1, State as State$1, State as State$2 } from "@expressive/mvc";
|
|
2
|
+
import * as react from "react";
|
|
3
3
|
|
|
4
|
-
//#region src/component.d.ts
|
|
5
|
-
declare module '@expressive/mvc' {
|
|
6
|
-
interface Component {
|
|
7
|
-
/** @deprecated Only to satisfy host JSX. Use `this.get(State)` instead. */
|
|
8
|
-
readonly context: Context;
|
|
9
|
-
/** @deprecated Only to satisfy host JSX. Use `this.get()` instead. */
|
|
10
|
-
readonly state: State.Values<this>;
|
|
11
|
-
/** @deprecated Only to satisfy host JSX. Use `this.set({})` instead. */
|
|
12
|
-
setState: (state: any, callback?: () => void) => void;
|
|
13
|
-
/** @deprecated Only to satisfy host JSX. Use `this.set(key)` instead. */
|
|
14
|
-
forceUpdate: (callback?: () => void) => void;
|
|
15
|
-
}
|
|
16
|
-
}
|
|
17
|
-
//#endregion
|
|
18
4
|
//#region src/state.get.d.ts
|
|
19
5
|
/** Type may not be undefined - instead will be null. */
|
|
20
6
|
type NoVoid<T> = T extends undefined | void ? null : T;
|
|
@@ -80,6 +66,62 @@ declare module '@expressive/mvc' {
|
|
|
80
66
|
}
|
|
81
67
|
}
|
|
82
68
|
//#endregion
|
|
69
|
+
//#region src/context.d.ts
|
|
70
|
+
declare namespace Consumer {
|
|
71
|
+
type Props<T extends State$2> = {
|
|
72
|
+
/** Type of controller to fetch from context. */for: State$2.Extends<T>;
|
|
73
|
+
/**
|
|
74
|
+
* Render function, will receive instance of desired controller.
|
|
75
|
+
*
|
|
76
|
+
* Called every render of parent component.
|
|
77
|
+
* Similar to `State.get()`, updates to properties accessed in
|
|
78
|
+
* this function will cause a refresh when they change.
|
|
79
|
+
*/
|
|
80
|
+
children: (value: T) => Component.Node | void;
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
declare function Consumer<T extends State$2>(props: Consumer.Props<T>): string | number | bigint | boolean | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | react.ReactPortal | null;
|
|
84
|
+
declare namespace Provider {
|
|
85
|
+
type ForEach<T> = (state: T) => void | (() => void);
|
|
86
|
+
interface SharedProps {
|
|
87
|
+
/**
|
|
88
|
+
* Children to render within this Provider.
|
|
89
|
+
*/
|
|
90
|
+
children?: Component.Node;
|
|
91
|
+
/** A fallback tree to show when suspended. */
|
|
92
|
+
fallback?: Component.Node;
|
|
93
|
+
/**
|
|
94
|
+
* A name for this Suspense boundary for instrumentation purposes.
|
|
95
|
+
* The name will help identify this boundary in React DevTools.
|
|
96
|
+
*/
|
|
97
|
+
name?: string | undefined;
|
|
98
|
+
}
|
|
99
|
+
type ForSingleProps<T extends State$2> = SharedProps & {
|
|
100
|
+
for: T | State$2.Type<T>;
|
|
101
|
+
is: (instance: T) => void;
|
|
102
|
+
} & { [K in State$2.Field<T>]?: T[K] };
|
|
103
|
+
type ForMultipleProps<T extends State$2> = SharedProps & {
|
|
104
|
+
for: Context$1.Accept<T>;
|
|
105
|
+
is?: ForEach<T>;
|
|
106
|
+
};
|
|
107
|
+
type Props<T extends State$2 = State$2> = ForSingleProps<T> | ForMultipleProps<T>;
|
|
108
|
+
}
|
|
109
|
+
declare function Provider<T extends State$2>(props: Provider.Props<T>): any;
|
|
110
|
+
//#endregion
|
|
111
|
+
//#region src/component.d.ts
|
|
112
|
+
declare module '@expressive/mvc' {
|
|
113
|
+
interface Component {
|
|
114
|
+
/** @deprecated Only to satisfy host JSX. Use `this.get(State)` instead. */
|
|
115
|
+
readonly context: Context$1;
|
|
116
|
+
/** @deprecated Only to satisfy host JSX. Use `this.get()` instead. */
|
|
117
|
+
readonly state: State.Values<this>;
|
|
118
|
+
/** @deprecated Only to satisfy host JSX. Use `this.set({})` instead. */
|
|
119
|
+
setState: (state: any, callback?: () => void) => void;
|
|
120
|
+
/** @deprecated Only to satisfy host JSX. Use `this.set(key)` instead. */
|
|
121
|
+
forceUpdate: (callback?: () => void) => void;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
//#endregion
|
|
83
125
|
//#region src/runtime.d.ts
|
|
84
126
|
declare const Runtime: {
|
|
85
127
|
/** Host own-property keys to trap out of observed state; assigned by each adapter. */ignore: string[];
|
|
@@ -91,24 +133,15 @@ declare const Runtime: {
|
|
|
91
133
|
useRef<T>(initial: T): {
|
|
92
134
|
current: T;
|
|
93
135
|
}; /** Per-render-attempt lifecycle, set by each adapter (React stacks attempts; others no-op). */
|
|
94
|
-
dedupe(from: Component, context: Context): {
|
|
136
|
+
dedupe(from: Component, context: Context$1): {
|
|
95
137
|
commit(): void;
|
|
96
138
|
remove(): void;
|
|
97
139
|
}; /** Host error-boundary component, wrapping a Component whose `catch` is set. */
|
|
98
140
|
ErrorBoundary: unknown;
|
|
99
141
|
Suspense: any;
|
|
100
142
|
};
|
|
101
|
-
declare function useFactory<T extends Function>(factory: () => T): T;
|
|
102
|
-
declare function useReady<T>(callback: () => void): void;
|
|
103
|
-
/**
|
|
104
|
-
* Mount-effect with a refreshable return value, safe under React StrictMode.
|
|
105
|
-
*
|
|
106
|
-
* @param callback Setup handler; receives a setter, must return a cleanup.
|
|
107
|
-
* @returns Latest value published via the setter (`undefined` until set).
|
|
108
|
-
*/
|
|
109
|
-
declare function useHook<T = void>(callback: (refresh: (next: T) => void) => () => void): T;
|
|
110
143
|
/** Subscribe to an existing observable instance within a component. */
|
|
111
144
|
declare function use<T extends object>(subject: T): T;
|
|
112
145
|
//#endregion
|
|
113
|
-
export { Consumer,
|
|
114
|
-
//# sourceMappingURL=
|
|
146
|
+
export { Consumer, Provider, Runtime, State$1 as State, use };
|
|
147
|
+
//# sourceMappingURL=adapter.d.ts.map
|
package/dist/adapter.js
ADDED
|
@@ -0,0 +1,346 @@
|
|
|
1
|
+
import { Component, Context, Context as Context$1, State, State as State$1, event, observer, unbind, watch } from "@expressive/mvc";
|
|
2
|
+
|
|
3
|
+
//#region src/runtime.ts
|
|
4
|
+
const Runtime = {};
|
|
5
|
+
function useFactory(factory) {
|
|
6
|
+
const ref = Runtime.useRef(null);
|
|
7
|
+
return ref.current || (ref.current = factory());
|
|
8
|
+
}
|
|
9
|
+
function useReady(callback) {
|
|
10
|
+
return Runtime.useEffect(() => void callback(), []);
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Mount-effect with a refreshable return value, safe under React StrictMode.
|
|
14
|
+
*
|
|
15
|
+
* @param callback Setup handler; receives a setter, must return a cleanup.
|
|
16
|
+
* @returns Latest value published via the setter (`undefined` until set).
|
|
17
|
+
*/
|
|
18
|
+
function useHook(callback) {
|
|
19
|
+
const { current } = Runtime.useRef({ rendered: 0 });
|
|
20
|
+
current.update = Runtime.useState(() => {
|
|
21
|
+
if (!current.rendered) current.unmount = callback((next) => {
|
|
22
|
+
current.output = next;
|
|
23
|
+
if (current.mounted) current.update?.((x) => x + 1);
|
|
24
|
+
else if (current.update) current.pending = true;
|
|
25
|
+
});
|
|
26
|
+
return current.rendered++;
|
|
27
|
+
})[1];
|
|
28
|
+
Runtime.useEffect(() => {
|
|
29
|
+
current.mounted = true;
|
|
30
|
+
if (current.pending) {
|
|
31
|
+
current.pending = false;
|
|
32
|
+
current.update((x) => x + 1);
|
|
33
|
+
}
|
|
34
|
+
return () => {
|
|
35
|
+
if (--current.rendered < 1) current.unmount();
|
|
36
|
+
};
|
|
37
|
+
}, []);
|
|
38
|
+
return current.output;
|
|
39
|
+
}
|
|
40
|
+
/** Subscribe to an existing observable instance within a component. */
|
|
41
|
+
function use(subject) {
|
|
42
|
+
const { current } = Runtime.useRef({
|
|
43
|
+
mounted: 0,
|
|
44
|
+
proxy: subject
|
|
45
|
+
});
|
|
46
|
+
const update = Runtime.useState(() => current.mounted++)[1];
|
|
47
|
+
if (current.source !== subject) {
|
|
48
|
+
const status = observer(subject);
|
|
49
|
+
if (status === void 0) throw new Error("Provided object is not observable.");
|
|
50
|
+
current.unwatch?.();
|
|
51
|
+
current.source = subject;
|
|
52
|
+
if (status === null) {
|
|
53
|
+
current.unwatch = void 0;
|
|
54
|
+
current.proxy = subject;
|
|
55
|
+
} else {
|
|
56
|
+
if (!status.ready) event(subject);
|
|
57
|
+
let init = true;
|
|
58
|
+
current.unwatch = watch(subject, (next, changed) => {
|
|
59
|
+
current.proxy = next;
|
|
60
|
+
if (changed.length && !init) update((x) => x + 1);
|
|
61
|
+
});
|
|
62
|
+
init = false;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
Runtime.useEffect(() => () => {
|
|
66
|
+
if (--current.mounted < 1) current.unwatch?.();
|
|
67
|
+
}, []);
|
|
68
|
+
return current.proxy;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
//#endregion
|
|
72
|
+
//#region src/state.get.ts
|
|
73
|
+
State$1.get = function get(argument) {
|
|
74
|
+
const next = Runtime.useState(0)[1];
|
|
75
|
+
const local = Context.get();
|
|
76
|
+
return useFactory(() => {
|
|
77
|
+
let unwatch;
|
|
78
|
+
let mounted = false;
|
|
79
|
+
let pending = false;
|
|
80
|
+
let value;
|
|
81
|
+
function update() {
|
|
82
|
+
pending = false;
|
|
83
|
+
next((x) => x + 1);
|
|
84
|
+
}
|
|
85
|
+
function refresh(action) {
|
|
86
|
+
if (typeof action == "function") action = action();
|
|
87
|
+
update();
|
|
88
|
+
if (action instanceof Promise) return action.finally(update);
|
|
89
|
+
}
|
|
90
|
+
function release() {
|
|
91
|
+
unsubscribe();
|
|
92
|
+
unwatch?.();
|
|
93
|
+
unwatch = void 0;
|
|
94
|
+
}
|
|
95
|
+
function attach(next) {
|
|
96
|
+
unwatch?.();
|
|
97
|
+
if (observer(next) === null) {
|
|
98
|
+
value = typeof argument === "function" ? argument.call(next, next, refresh) : next;
|
|
99
|
+
unwatch = () => {};
|
|
100
|
+
return release;
|
|
101
|
+
}
|
|
102
|
+
unwatch = watch(next, (current, changed) => {
|
|
103
|
+
if (typeof argument === "function") {
|
|
104
|
+
const next = argument.call(current, current, refresh);
|
|
105
|
+
if (next === value) return;
|
|
106
|
+
value = next;
|
|
107
|
+
} else value = current;
|
|
108
|
+
if (changed.length) update();
|
|
109
|
+
}, argument === true);
|
|
110
|
+
if (mounted) {
|
|
111
|
+
pending = true;
|
|
112
|
+
queueMicrotask(() => pending && update());
|
|
113
|
+
}
|
|
114
|
+
return release;
|
|
115
|
+
}
|
|
116
|
+
const unsubscribe = local.get(this, attach);
|
|
117
|
+
if (!unwatch) {
|
|
118
|
+
unsubscribe();
|
|
119
|
+
if (argument === false) return () => void 0;
|
|
120
|
+
throw new Error(`Could not find ${this} in context.`);
|
|
121
|
+
}
|
|
122
|
+
if (value === null) {
|
|
123
|
+
release();
|
|
124
|
+
return () => null;
|
|
125
|
+
}
|
|
126
|
+
if (value instanceof Promise) {
|
|
127
|
+
let error;
|
|
128
|
+
release();
|
|
129
|
+
value.then((x) => value = x, (e) => error = e).finally(update);
|
|
130
|
+
value = null;
|
|
131
|
+
return () => {
|
|
132
|
+
if (error) throw error;
|
|
133
|
+
return value === void 0 ? null : value;
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
return () => {
|
|
137
|
+
pending = false;
|
|
138
|
+
useReady(() => mounted = true);
|
|
139
|
+
useHook(() => release);
|
|
140
|
+
return value === void 0 ? null : value;
|
|
141
|
+
};
|
|
142
|
+
})();
|
|
143
|
+
};
|
|
144
|
+
|
|
145
|
+
//#endregion
|
|
146
|
+
//#region src/state.use.ts
|
|
147
|
+
State$1.use = function use(...args) {
|
|
148
|
+
const outer = Context.get();
|
|
149
|
+
return useFactory(() => {
|
|
150
|
+
const add = (arg) => typeof arg == "object" && instance.set(arg);
|
|
151
|
+
let use = (...args) => Promise.all(args.flat().map(add));
|
|
152
|
+
const instance = new this((x) => {
|
|
153
|
+
if ("use" in x && typeof x.use == "function") {
|
|
154
|
+
use = x.use.bind(x);
|
|
155
|
+
use(...args);
|
|
156
|
+
} else return args;
|
|
157
|
+
});
|
|
158
|
+
const context = outer.push(instance);
|
|
159
|
+
let ready = false;
|
|
160
|
+
return (args) => {
|
|
161
|
+
if (ready) {
|
|
162
|
+
ready = false;
|
|
163
|
+
Promise.resolve(use(...args)).finally(() => {
|
|
164
|
+
ready = true;
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
useReady(() => ready = true);
|
|
168
|
+
return useHook((update) => {
|
|
169
|
+
watch(instance, update);
|
|
170
|
+
return () => {
|
|
171
|
+
context.pop();
|
|
172
|
+
instance.set(null);
|
|
173
|
+
};
|
|
174
|
+
});
|
|
175
|
+
};
|
|
176
|
+
})(args);
|
|
177
|
+
};
|
|
178
|
+
|
|
179
|
+
//#endregion
|
|
180
|
+
//#region src/context.ts
|
|
181
|
+
let shared;
|
|
182
|
+
/**
|
|
183
|
+
* Lazily-created context carrying the active {@link Context} down the tree.
|
|
184
|
+
* Lazy because the framework's `createContext` arrives via {@link Runtime},
|
|
185
|
+
* which an adapter's entry populates at load - after this module evaluates.
|
|
186
|
+
*/
|
|
187
|
+
function Layers() {
|
|
188
|
+
return shared || (shared = Runtime.createContext(Context$1.root));
|
|
189
|
+
}
|
|
190
|
+
/** Read the ambient {@link Context} from the nearest Layers provider. */
|
|
191
|
+
function useAmbient() {
|
|
192
|
+
return Runtime.useContext(Layers());
|
|
193
|
+
}
|
|
194
|
+
/** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */
|
|
195
|
+
function provide(context, children) {
|
|
196
|
+
return Runtime.createElement(Layers().Provider, {
|
|
197
|
+
value: context,
|
|
198
|
+
children
|
|
199
|
+
});
|
|
200
|
+
}
|
|
201
|
+
Object.defineProperty(Component, "contextType", {
|
|
202
|
+
configurable: true,
|
|
203
|
+
get: Layers
|
|
204
|
+
});
|
|
205
|
+
const _get = Context$1.get;
|
|
206
|
+
Context$1.get = (state) => {
|
|
207
|
+
if (!state) try {
|
|
208
|
+
return useAmbient();
|
|
209
|
+
} catch {}
|
|
210
|
+
return _get(state);
|
|
211
|
+
};
|
|
212
|
+
function Consumer(props) {
|
|
213
|
+
return props.for.get((i) => props.children(i));
|
|
214
|
+
}
|
|
215
|
+
function Provider(props) {
|
|
216
|
+
const { for: input, children, fallback, name, is, ...rest } = props;
|
|
217
|
+
const ambient = useAmbient();
|
|
218
|
+
const context = useHook((set) => {
|
|
219
|
+
set(new Context$1(ambient));
|
|
220
|
+
return () => context.pop();
|
|
221
|
+
});
|
|
222
|
+
context.set(input, is);
|
|
223
|
+
if (Object.keys(rest).length) {
|
|
224
|
+
const i = State$1.is(input) ? context.get(input) : input;
|
|
225
|
+
if (i instanceof State$1) i.set(rest);
|
|
226
|
+
}
|
|
227
|
+
return provide(context, fallback !== void 0 ? Runtime.createElement(Runtime.Suspense, {
|
|
228
|
+
fallback,
|
|
229
|
+
name
|
|
230
|
+
}, children) : children);
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
//#endregion
|
|
234
|
+
//#region src/component.ts
|
|
235
|
+
Object.defineProperties(Component.prototype, {
|
|
236
|
+
state: {
|
|
237
|
+
set() {},
|
|
238
|
+
get: Component.prototype.get
|
|
239
|
+
},
|
|
240
|
+
context: { set: bootstrap }
|
|
241
|
+
});
|
|
242
|
+
/**
|
|
243
|
+
* `State.on` handler that prepares a Component's prototype at bootstrap, before
|
|
244
|
+
* mvc classifies its members:
|
|
245
|
+
*
|
|
246
|
+
* - On the root Component, host own-property keys are trapped so each lands as a
|
|
247
|
+
* plain own property (out of observed state); each adapter assigns its own set.
|
|
248
|
+
* - capitalized methods are rewritten into subcomponents as non-configurable
|
|
249
|
+
* getters, so bootstrap skips them too.
|
|
250
|
+
*
|
|
251
|
+
* (Sealing `render` as the content-render seam is handled by core itself.)
|
|
252
|
+
*
|
|
253
|
+
* `before` covers the per-instance case: a capitalized function assigned as an
|
|
254
|
+
* instance field (e.g. `Sidebar = Sidebar` to inject or override one), promoted
|
|
255
|
+
* before `observe` so it is not mistaken for reactive state.
|
|
256
|
+
*/
|
|
257
|
+
Component.on({
|
|
258
|
+
type(type) {
|
|
259
|
+
if (type === Component) for (const key of Runtime.ignore) Object.defineProperty(Component.prototype, key, { set(value) {
|
|
260
|
+
Object.defineProperty(this, key, {
|
|
261
|
+
value,
|
|
262
|
+
writable: true
|
|
263
|
+
});
|
|
264
|
+
} });
|
|
265
|
+
subcomponents(type.prototype);
|
|
266
|
+
},
|
|
267
|
+
before(self) {
|
|
268
|
+
subcomponents(self, true);
|
|
269
|
+
}
|
|
270
|
+
});
|
|
271
|
+
function bootstrap(context) {
|
|
272
|
+
context = context.push();
|
|
273
|
+
context.set(this, () => () => this.set(null));
|
|
274
|
+
Object.defineProperties(this, {
|
|
275
|
+
context: {
|
|
276
|
+
get: () => context,
|
|
277
|
+
set() {}
|
|
278
|
+
},
|
|
279
|
+
render: { value: render(this, context) }
|
|
280
|
+
});
|
|
281
|
+
this.set(null, () => {
|
|
282
|
+
Object.defineProperty(this, "props", {
|
|
283
|
+
value: this.props,
|
|
284
|
+
writable: true
|
|
285
|
+
});
|
|
286
|
+
});
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
* Per-instance render host: subscribe the instance, render inside its context
|
|
290
|
+
* provider, wrap pending in Suspense and (when `catch` is set) the host error
|
|
291
|
+
* boundary. Host differences live behind `Runtime.dedupe`/`Runtime.ErrorBoundary`.
|
|
292
|
+
*/
|
|
293
|
+
function render(from, context) {
|
|
294
|
+
const { createElement: create } = Runtime;
|
|
295
|
+
const { commit, remove } = Runtime.dedupe(from, context);
|
|
296
|
+
const content = from.render;
|
|
297
|
+
const Render = () => content.call(from, from.props);
|
|
298
|
+
const Component = () => {
|
|
299
|
+
from = useHook((refresh) => {
|
|
300
|
+
if (observer(from) !== null) watch(from, refresh);
|
|
301
|
+
return () => {
|
|
302
|
+
remove();
|
|
303
|
+
context.pop();
|
|
304
|
+
};
|
|
305
|
+
}) || from;
|
|
306
|
+
useReady(commit);
|
|
307
|
+
const rendered = create(Render);
|
|
308
|
+
const children = provide(context, from.fallback === false ? rendered : create(Runtime.Suspense, {
|
|
309
|
+
fallback: from.fallback,
|
|
310
|
+
name: String(from)
|
|
311
|
+
}, rendered));
|
|
312
|
+
return from.catch ? create(Runtime.ErrorBoundary, {
|
|
313
|
+
self: from,
|
|
314
|
+
children
|
|
315
|
+
}) : children;
|
|
316
|
+
};
|
|
317
|
+
return () => create(Component);
|
|
318
|
+
}
|
|
319
|
+
/** Rewrite each own capitalized function on `target` into a subcomponent. */
|
|
320
|
+
function subcomponents(target, configurable) {
|
|
321
|
+
for (const key of Object.getOwnPropertyNames(target)) {
|
|
322
|
+
if (!/^[A-Z]/.test(key)) continue;
|
|
323
|
+
const { value } = Object.getOwnPropertyDescriptor(target, key);
|
|
324
|
+
if (typeof value != "function") continue;
|
|
325
|
+
Object.defineProperty(target, key, {
|
|
326
|
+
configurable,
|
|
327
|
+
get() {
|
|
328
|
+
const owner = this.is;
|
|
329
|
+
let render = unbind(value);
|
|
330
|
+
const Component = (props) => render.call(useHook((set) => watch(owner, set)) || owner, props);
|
|
331
|
+
Object.defineProperty(owner, key, {
|
|
332
|
+
configurable: true,
|
|
333
|
+
get: () => Component,
|
|
334
|
+
set(fn) {
|
|
335
|
+
render = fn;
|
|
336
|
+
}
|
|
337
|
+
});
|
|
338
|
+
return Component;
|
|
339
|
+
}
|
|
340
|
+
});
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
//#endregion
|
|
345
|
+
export { Consumer, Provider, Runtime, State, use };
|
|
346
|
+
//# sourceMappingURL=adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adapter.js","names":["Context","State"],"sources":["../src/runtime.ts","../src/state.get.ts","../src/state.use.ts","../src/context.ts","../src/component.ts"],"sourcesContent":["import { event, watch, observer } from '@expressive/mvc';\nimport type { Component } from '@expressive/mvc';\nimport type { Context } from './context';\n\nexport const Runtime = {} as {\n /** Host own-property keys to trap out of observed state; assigned by each adapter. */\n ignore: string[];\n createElement(type: any, props?: any, ...children: any[]): any;\n createContext<T>(value: T): any;\n useContext(context: any): any;\n useState<S>(initial: S | (() => S)): [S, (next: (previous: S) => S) => void];\n useEffect(effect: () => (() => void) | void, deps?: any[]): void;\n useRef<T>(initial: T): { current: T };\n /** Per-render-attempt lifecycle, set by each adapter (React stacks attempts; others no-op). */\n dedupe(from: Component, context: Context): { commit(): void; remove(): void };\n /** Host error-boundary component, wrapping a Component whose `catch` is set. */\n ErrorBoundary: unknown;\n Suspense: any;\n};\n\nexport function useFactory<T extends Function>(factory: () => T) {\n const ref = Runtime.useRef<T | null>(null);\n return ref.current || (ref.current = factory());\n}\n\nexport function useReady<T>(callback: () => void) {\n return Runtime.useEffect(() => void callback(), []);\n}\n\n/**\n * Mount-effect with a refreshable return value, safe under React StrictMode.\n *\n * @param callback Setup handler; receives a setter, must return a cleanup.\n * @returns Latest value published via the setter (`undefined` until set).\n */\nexport function useHook<T = void>(\n callback: (refresh: (next: T) => void) => () => void\n) {\n const { current } = Runtime.useRef(\n { rendered: 0 } as {\n rendered: number;\n mounted?: boolean;\n pending?: boolean;\n unmount: () => void;\n update?: (next: (previous: number) => number) => void;\n output: T;\n }\n );\n\n current.update = Runtime.useState(() => {\n if (!current.rendered)\n current.unmount = callback((next) => {\n current.output = next;\n if (current.mounted) current.update?.((x) => x + 1);\n else if (current.update) current.pending = true;\n });\n\n return current.rendered++;\n })[1];\n\n Runtime.useEffect(() => {\n current.mounted = true;\n if (current.pending) {\n current.pending = false;\n current.update!((x) => x + 1);\n }\n return () => {\n if (--current.rendered < 1) current.unmount();\n }\n }, []);\n\n return current.output;\n}\n\n/** Subscribe to an existing observable instance within a component. */\nexport function use<T extends object>(subject: T) {\n const { current } = Runtime.useRef<{\n proxy: T;\n source?: T;\n mounted: number;\n unwatch?: () => void;\n }>({ mounted: 0, proxy: subject });\n\n const update = Runtime.useState(() => current.mounted++)[1];\n\n if (current.source !== subject) {\n const status = observer(subject);\n\n if (status === undefined)\n throw new Error('Provided object is not observable.');\n\n current.unwatch?.();\n current.source = subject;\n\n if (status === null) {\n current.unwatch = undefined;\n current.proxy = subject;\n } else {\n if (!status.ready) event(subject);\n\n let init = true;\n\n current.unwatch = watch(subject, (next, changed) => {\n current.proxy = next;\n if (changed.length && !init)\n update((x) => x + 1);\n });\n\n init = false;\n }\n }\n\n Runtime.useEffect(() => () => {\n if (--current.mounted < 1) current.unwatch?.();\n }, []);\n\n return current.proxy;\n}\n","import { State, Context, observer, watch } from '@expressive/mvc';\nimport { Runtime, useFactory, useHook, useReady } from './runtime';\n\n/** Type may not be undefined - instead will be null. */\ntype NoVoid<T> = T extends undefined | void ? null : T;\n\ndeclare module '@expressive/mvc' {\n namespace State {\n type ForceRefresh = {\n /** Request a refresh for current component. */\n (): void;\n\n /**\n * Request a refresh and again after promise either resolves or rejects.\n *\n * @param waitFor Promise to wait for.\n * @returns Promise which resolves, after refresh, to same value as `waitFor`.\n */\n <T = void>(waitFor: Promise<T>): Promise<T>;\n\n /**\n * Request refresh before and after async function.\n * A refresh will occur both before and after the given function.\n *\n * **Note:** Any actions performed before first `await` will occur prior to refresh.\n *\n * @param invoke Async function to invoke.\n * @returns Promise which resolves returned value after refresh.\n */\n <T = void>(invoke: () => Promise<T>): Promise<T>;\n };\n\n type GetFactory<T extends State, R> = (\n this: T,\n current: T,\n refresh: ForceRefresh\n ) => R;\n\n type GetEffect<T extends State> = (\n this: T,\n current: T,\n refresh: ForceRefresh\n ) => null;\n\n /** Fetch instance of this class from context. */\n function get<T extends State>(this: State.Extends<T>): T;\n\n /** Fetch instance of this class optionally. */\n function get<T extends State>(\n this: State.Extends<T>,\n required: false\n ): T | undefined;\n\n /** Fetch instance of this class from context. */\n function get<T extends State>(\n this: State.Extends<T>,\n requireValues: true\n ): Required<T>;\n\n function get<T extends State, R>(\n this: State.Extends<T>,\n factory: GetFactory<T, Promise<R> | R>\n ): NoVoid<R>;\n\n function get<T extends State>(\n this: State.Extends<T>,\n factory: GetEffect<T>\n ): null;\n }\n}\n\nState.get = function get<T extends State>(\n this: State.Extends<T>,\n argument?: boolean | State.GetFactory<T, unknown>\n) {\n const next = Runtime.useState(0)[1];\n const local = Context.get();\n const render = useFactory(() => {\n let unwatch: (() => void) | undefined;\n let mounted = false;\n let pending = false;\n let value: any;\n\n function update() {\n pending = false;\n next((x) => x + 1);\n }\n\n function refresh<T>(action?: Promise<T> | (() => Promise<T>)): any {\n if (typeof action == 'function') action = action();\n update();\n if (action instanceof Promise) return action.finally(update);\n }\n\n function release() {\n unsubscribe();\n unwatch?.();\n unwatch = undefined;\n }\n\n function attach(next: T) {\n unwatch?.();\n\n if (observer(next) === null) {\n value = typeof argument === 'function'\n ? argument.call(next, next, refresh)\n : next;\n unwatch = () => {};\n return release;\n }\n\n unwatch = watch(\n next,\n (current, changed) => {\n if (typeof argument === 'function') {\n const next = argument.call(current, current, refresh);\n if (next === value) return;\n value = next;\n } else {\n value = current;\n }\n\n if (changed.length) update();\n },\n argument === true\n );\n\n if (mounted) {\n pending = true;\n queueMicrotask(() => pending && update());\n }\n\n return release;\n }\n\n const unsubscribe = local.get(this, attach);\n\n if (!unwatch) {\n unsubscribe();\n if (argument === false) return () => undefined;\n throw new Error(`Could not find ${this} in context.`);\n }\n\n if (value === null) {\n release();\n return () => null;\n }\n\n if (value instanceof Promise) {\n let error: Error | undefined;\n\n release();\n\n value\n .then(\n (x) => (value = x),\n (e) => (error = e)\n )\n .finally(update);\n\n value = null;\n\n return () => {\n if (error) throw error;\n return value === undefined ? null : value;\n };\n }\n\n return () => {\n pending = false;\n useReady(() => mounted = true);\n useHook(() => release);\n return value === undefined ? null : value;\n };\n });\n\n return render();\n};\n","import { State, Context, watch } from '@expressive/mvc';\nimport { useFactory, useHook, useReady } from './runtime';\n\ndeclare module '@expressive/mvc' {\n interface UseState extends State {\n /**\n * Optional hook called when State.use() is invoked within a React component.\n *\n * This is called *every render* of the component, and will intercept\n * arguments which would otherwise be passed into the State constructor.\n *\n * @param props Arguments passed to State.use().\n */\n use?(...props: any[]): Promise<void> | void;\n }\n\n namespace State {\n type UseArgs<T extends State> = T extends {\n use(...props: infer P): any;\n }\n ? P\n : State.Args<T>;\n\n /**\n * Create and manage instance of this State within React component.\n *\n * @param args Arguments to pass to constructor or `use` method (if defined).\n * @returns Managed instance of this State.\n */\n function use<T extends UseState>(\n this: State.Type<T>,\n ...args: UseArgs<T>\n ): T;\n }\n}\n\nState.use = function use<T extends State>(\n this: State.Type<T>,\n ...args: State.UseArgs<T>\n) {\n const outer = Context.get();\n const render = useFactory(() => {\n const add = (arg: unknown) =>\n typeof arg == 'object' && instance.set(arg as State.Assign<T>);\n\n let use = (...args: State.Args<T>) => Promise.all(args.flat().map(add));\n\n const instance = new this((x) => {\n if ('use' in x && typeof x.use == 'function') {\n use = x.use.bind(x);\n use(...args);\n }\n else return args;\n });\n\n const context = outer.push(instance);\n\n let ready = false;\n\n return (args: State.Args<T>) => {\n if (ready) {\n ready = false;\n Promise.resolve(use(...args)).finally(() => {\n ready = true;\n });\n }\n\n useReady(() => ready = true);\n\n return useHook<T>((update) => {\n watch(instance, update);\n return () => {\n context.pop();\n instance.set(null);\n };\n });\n };\n });\n\n return render(args);\n};\n","import { State, Context, Component } from '@expressive/mvc';\nimport { Runtime, useHook } from './runtime';\n\nlet shared: any;\n\n/**\n * Lazily-created context carrying the active {@link Context} down the tree.\n * Lazy because the framework's `createContext` arrives via {@link Runtime},\n * which an adapter's entry populates at load - after this module evaluates.\n */\nfunction Layers() {\n return shared || (shared = Runtime.createContext(Context.root));\n}\n\n/** Read the ambient {@link Context} from the nearest Layers provider. */\nfunction useAmbient() {\n return Runtime.useContext(Layers());\n}\n\n/** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */\nfunction provide(context: Context, children: any) {\n return Runtime.createElement(Layers().Provider, { value: context, children });\n}\n\n// Class components consume the active Context through the host's `contextType`\nObject.defineProperty(Component, 'contextType', { configurable: true, get: Layers });\n\nconst _get = Context.get;\n\nContext.get = (state?: State) => {\n if (!state)\n try {\n return useAmbient();\n } catch { }\n\n return _get(state);\n};\n\ndeclare namespace Consumer {\n type Props<T extends State> = {\n /** Type of controller to fetch from context. */\n for: State.Extends<T>;\n\n /**\n * Render function, will receive instance of desired controller.\n *\n * Called every render of parent component.\n * Similar to `State.get()`, updates to properties accessed in\n * this function will cause a refresh when they change.\n */\n children: (value: T) => Component.Node | void;\n };\n}\n\nfunction Consumer<T extends State>(props: Consumer.Props<T>) {\n return props.for.get((i) => props.children(i));\n}\n\ndeclare namespace Provider {\n type ForEach<T> = (state: T) => void | (() => void);\n\n interface SharedProps {\n /**\n * Children to render within this Provider.\n */\n children?: Component.Node;\n\n /** A fallback tree to show when suspended. */\n fallback?: Component.Node;\n\n /**\n * A name for this Suspense boundary for instrumentation purposes.\n * The name will help identify this boundary in React DevTools.\n */\n name?: string | undefined;\n }\n\n type ForSingleProps<T extends State> = SharedProps & {\n for: T | State.Type<T>;\n is: (instance: T) => void;\n } & { [K in State.Field<T>]?: T[K] };\n\n type ForMultipleProps<T extends State> = SharedProps & {\n for: Context.Accept<T>;\n is?: ForEach<T>;\n };\n\n type Props<T extends State = State> = ForSingleProps<T> | ForMultipleProps<T>;\n}\n\nfunction Provider<T extends State>(props: Provider.Props<T>) {\n const {\n for: input,\n children,\n fallback,\n name,\n is,\n ...rest\n } = props as Provider.ForSingleProps<T> & Provider.ForMultipleProps<T>;\n\n const ambient = useAmbient();\n const context = useHook<Context>((set) => {\n set(new Context(ambient));\n return () => context.pop();\n });\n\n context.set(input, is);\n\n if (Object.keys(rest).length) {\n const i = State.is(input) ? context.get(input) : input;\n if (i instanceof State) i.set(rest);\n }\n\n return provide(context,\n fallback !== undefined\n ? Runtime.createElement(Runtime.Suspense, { fallback, name }, children)\n : children\n );\n}\n\nexport { Consumer, Provider, Context, provide };\n","import { Component, watch, unbind, observer } from '@expressive/mvc';\nimport { provide, type Context } from './context';\nimport { Runtime, useHook, useReady } from './runtime';\n\ndeclare module '@expressive/mvc' {\n interface Component {\n /** @deprecated Only to satisfy host JSX. Use `this.get(State)` instead. */\n readonly context: Context;\n /** @deprecated Only to satisfy host JSX. Use `this.get()` instead. */\n readonly state: State.Values<this>;\n /** @deprecated Only to satisfy host JSX. Use `this.set({})` instead. */\n setState: (state: any, callback?: () => void) => void;\n /** @deprecated Only to satisfy host JSX. Use `this.set(key)` instead. */\n forceUpdate: (callback?: () => void) => void;\n }\n}\n\n// Host-agnostic seams: `state` is a read-only values bag; `context`'s setter\n// pushes a child context, registers the instance for teardown, and installs its\n// per-instance render host. Host-specific descriptors stay in each adapter.\nObject.defineProperties(Component.prototype, {\n state: {\n set() {},\n get: Component.prototype.get\n },\n context: {\n set: bootstrap\n }\n});\n\n/**\n * `State.on` handler that prepares a Component's prototype at bootstrap, before\n * mvc classifies its members:\n *\n * - On the root Component, host own-property keys are trapped so each lands as a\n * plain own property (out of observed state); each adapter assigns its own set.\n * - capitalized methods are rewritten into subcomponents as non-configurable\n * getters, so bootstrap skips them too.\n *\n * (Sealing `render` as the content-render seam is handled by core itself.)\n *\n * `before` covers the per-instance case: a capitalized function assigned as an\n * instance field (e.g. `Sidebar = Sidebar` to inject or override one), promoted\n * before `observe` so it is not mistaken for reactive state.\n */\nComponent.on({\n type(type) {\n if (type === Component)\n for (const key of Runtime.ignore)\n Object.defineProperty(Component.prototype, key, {\n set(value) {\n Object.defineProperty(this, key, { value, writable: true });\n }\n });\n\n // capitalized methods into subcomponents\n subcomponents(type.prototype);\n },\n before(self){\n // capitalized instance fields into subcomponents\n subcomponents(self, true);\n }\n});\n\nfunction bootstrap(this: Component, context: Context){\n context = context.push();\n context.set(this, () => () => this.set(null));\n\n Object.defineProperties(this, {\n context: {\n get: () => context,\n set() {}\n },\n render: {\n value: render(this, context)\n }\n });\n\n this.set(null, () => {\n Object.defineProperty(this, 'props', {\n value: this.props,\n writable: true\n });\n })\n}\n\n/**\n * Per-instance render host: subscribe the instance, render inside its context\n * provider, wrap pending in Suspense and (when `catch` is set) the host error\n * boundary. Host differences live behind `Runtime.dedupe`/`Runtime.ErrorBoundary`.\n */\nfunction render(from: Component, context: Context) {\n const { createElement: create } = Runtime;\n const { commit, remove } = Runtime.dedupe(from, context);\n\n const content = from.render;\n const Render = () => content.call(from, from.props);\n const Component = () => {\n from = useHook<Component>((refresh) => {\n if (observer(from) !== null)\n watch(from, refresh);\n return () => {\n remove();\n context.pop();\n };\n }) || from;\n\n useReady(commit);\n\n const rendered = create(Render);\n const children = provide(context,\n from.fallback === false\n ? rendered\n : create(Runtime.Suspense,\n { fallback: from.fallback, name: String(from) },\n rendered)\n );\n\n return from.catch\n ? create(Runtime.ErrorBoundary, { self: from, children })\n : children;\n };\n\n return () => create(Component);\n}\n\n/** Rewrite each own capitalized function on `target` into a subcomponent. */\nfunction subcomponents(target: object, configurable?: boolean) {\n for (const key of Object.getOwnPropertyNames(target)) {\n if (!/^[A-Z]/.test(key)) continue;\n const { value } = Object.getOwnPropertyDescriptor(target, key)!;\n if (typeof value != 'function') continue;\n Object.defineProperty(target, key, {\n configurable,\n get(this: Component) {\n const owner = this.is;\n let render = unbind(value);\n const Component = (props: unknown) =>\n render.call(\n useHook<Component>((set) => watch(owner, set)) || owner,\n props\n );\n\n Object.defineProperty(owner, key, {\n configurable: true,\n get: () => Component,\n set(fn: Function) {\n render = fn;\n }\n });\n\n return Component;\n }\n });\n }\n}\n"],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
|
-
import { r as Provider, t as Consumer } from "./context-B-HNZeaN.js";
|
|
2
1
|
import { Component, Context, Observer, def, get, hot, ref, set } from "@expressive/mvc";
|
|
3
2
|
import { JSX, ReactNode } from "react";
|
|
4
|
-
import { State, State as
|
|
3
|
+
import { Consumer, Provider, State, State as adapter_default, use } from "./adapter";
|
|
5
4
|
|
|
6
5
|
//#region src/jsx-runtime.d.ts
|
|
7
6
|
declare module '@expressive/mvc/jsx-runtime' {
|
|
@@ -11,5 +10,5 @@ declare module '@expressive/mvc/jsx-runtime' {
|
|
|
11
10
|
}
|
|
12
11
|
}
|
|
13
12
|
//#endregion
|
|
14
|
-
export { Component, Consumer, Context, Observer, Provider, State, def,
|
|
13
|
+
export { Component, Consumer, Context, Observer, Provider, State, def, adapter_default as default, get, hot, ref, set, use };
|
|
15
14
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
import { r as Provider, t as Consumer } from "./context-BfeYQmAX.js";
|
|
2
1
|
import { Component, Component as Component$1, Context, Observer, def, get, hot, ref, set } from "@expressive/mvc";
|
|
3
2
|
import React, { Children, Suspense, createContext, createElement, isValidElement, useContext, useEffect, useRef, useState } from "react";
|
|
4
3
|
import { Fragment, jsx, jsxs } from "react/jsx-runtime";
|
|
5
4
|
import { host } from "@expressive/mvc/jsx-runtime";
|
|
6
|
-
import { Runtime, State, State as
|
|
5
|
+
import { Consumer, Provider, Runtime, State, State as adapter_default, use } from "./adapter";
|
|
7
6
|
|
|
8
7
|
//#region src/jsx-runtime.ts
|
|
9
8
|
host({
|
|
@@ -106,5 +105,5 @@ Object.assign(Runtime, {
|
|
|
106
105
|
});
|
|
107
106
|
|
|
108
107
|
//#endregion
|
|
109
|
-
export { Component, Consumer, Context, Observer, Provider, State, def,
|
|
108
|
+
export { Component, Consumer, Context, Observer, Provider, State, def, adapter_default as default, get, hot, ref, set, use };
|
|
110
109
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":["Component"],"sources":["../src/jsx-runtime.ts","../src/boundary.ts","../src/index.ts"],"sourcesContent":["import { Children, isValidElement } from 'react';\nimport { Fragment, jsx, jsxs } from 'react/jsx-runtime';\nimport { host } from '@expressive/mvc/jsx-runtime';\n\nimport type { Component } from '@expressive/mvc';\nimport type { JSX as ReactJSX, ReactNode } from 'react';\n\ndeclare module '@expressive/mvc/jsx-runtime' {\n interface Host {\n node: ReactNode;\n intrinsics: ReactJSX.IntrinsicElements;\n }\n}\n\nhost({\n jsx,\n jsxs,\n Fragment,\n isElement: isValidElement,\n childrenOf(children): Component.Node[] {\n return Children.toArray(children as React.ReactNode);\n },\n typeOf(node){\n return isValidElement(node) ? node.type : undefined;\n },\n propsOf(node){\n return isValidElement(node) ? node.props as Record<string, unknown> : {};\n }\n});\n","import { Component } from '@expressive/mvc';\nimport React from 'react';\nimport { Context } from './context';\n\ninterface Entry {\n committed?: boolean;\n context: Context;\n commit: () => void;\n remove: () => void;\n};\n\n/** In-flight render attempts by tree position, per ambient context.\n * When one commits, older uncommitted attempts at its slot are provably dead. */\nconst SLOTS = new WeakMap<Context, Map<string, Set<Entry>>>();\n\n/**\n * React's attempt lifecycle: fiber-keyed stacking so a superseded (uncommitted)\n * render attempt at a tree position is discarded when a later one commits.\n */\nexport function dedupe(on: Component, context: Context) {\n let slots = SLOTS.get(context.parent!);\n if (!slots) SLOTS.set(context.parent!, (slots = new Map()));\n\n // key/index path to root: stable across render attempts of this element\n let slot = '';\n for (let f = (on as any)._reactInternals; f; f = f.return)\n slot += (f.key ?? f.index) + '.';\n\n let list = slots.get(slot);\n if (!list) slots.set(slot, (list = new Set()));\n\n const entry: Entry = {\n context,\n commit() {\n entry.committed = true;\n\n for (const e of list) {\n if (e === entry) break;\n if (e.committed) continue;\n e.context.pop();\n list.delete(e);\n }\n },\n remove() {\n list.delete(entry);\n }\n };\n\n list.add(entry);\n return entry;\n};\n\nexport class ErrorBoundary extends React.Component<{\n self: Component;\n children: React.ReactNode;\n}> {\n state = {} as { error?: Error };\n recovering = false;\n\n constructor(props: ErrorBoundary['props']) {\n super(props);\n }\n\n static getDerivedStateFromError(error: Error) {\n return { error };\n }\n\n componentDidCatch(error: Error) {\n const { self } = this.props;\n const { fallback } = self;\n const reset = (error?: Error) => {\n this.recovering = true;\n this.setState({ error });\n };\n\n Promise.resolve(self.catch!(error))\n .then(() => reset(), reset)\n .finally(() => self.set({ fallback }, true));\n }\n\n componentDidUpdate() {\n this.recovering = false;\n }\n\n render() {\n if (!this.state.error) return this.props.children;\n if (this.recovering) throw this.state.error;\n return this.props.self.fallback;\n }\n};\n","import { Component } from '@expressive/mvc';\nimport {\n createContext,\n createElement,\n Suspense,\n useContext,\n useEffect,\n useRef,\n useState\n} from 'react';\n\nimport './jsx-runtime';\nimport { Runtime } from './
|
|
1
|
+
{"version":3,"file":"index.js","names":["Component"],"sources":["../src/jsx-runtime.ts","../src/boundary.ts","../src/index.ts"],"sourcesContent":["import { Children, isValidElement } from 'react';\nimport { Fragment, jsx, jsxs } from 'react/jsx-runtime';\nimport { host } from '@expressive/mvc/jsx-runtime';\n\nimport type { Component } from '@expressive/mvc';\nimport type { JSX as ReactJSX, ReactNode } from 'react';\n\ndeclare module '@expressive/mvc/jsx-runtime' {\n interface Host {\n node: ReactNode;\n intrinsics: ReactJSX.IntrinsicElements;\n }\n}\n\nhost({\n jsx,\n jsxs,\n Fragment,\n isElement: isValidElement,\n childrenOf(children): Component.Node[] {\n return Children.toArray(children as React.ReactNode);\n },\n typeOf(node){\n return isValidElement(node) ? node.type : undefined;\n },\n propsOf(node){\n return isValidElement(node) ? node.props as Record<string, unknown> : {};\n }\n});\n","import { Component } from '@expressive/mvc';\nimport React from 'react';\nimport { Context } from './context';\n\ninterface Entry {\n committed?: boolean;\n context: Context;\n commit: () => void;\n remove: () => void;\n};\n\n/** In-flight render attempts by tree position, per ambient context.\n * When one commits, older uncommitted attempts at its slot are provably dead. */\nconst SLOTS = new WeakMap<Context, Map<string, Set<Entry>>>();\n\n/**\n * React's attempt lifecycle: fiber-keyed stacking so a superseded (uncommitted)\n * render attempt at a tree position is discarded when a later one commits.\n */\nexport function dedupe(on: Component, context: Context) {\n let slots = SLOTS.get(context.parent!);\n if (!slots) SLOTS.set(context.parent!, (slots = new Map()));\n\n // key/index path to root: stable across render attempts of this element\n let slot = '';\n for (let f = (on as any)._reactInternals; f; f = f.return)\n slot += (f.key ?? f.index) + '.';\n\n let list = slots.get(slot);\n if (!list) slots.set(slot, (list = new Set()));\n\n const entry: Entry = {\n context,\n commit() {\n entry.committed = true;\n\n for (const e of list) {\n if (e === entry) break;\n if (e.committed) continue;\n e.context.pop();\n list.delete(e);\n }\n },\n remove() {\n list.delete(entry);\n }\n };\n\n list.add(entry);\n return entry;\n};\n\nexport class ErrorBoundary extends React.Component<{\n self: Component;\n children: React.ReactNode;\n}> {\n state = {} as { error?: Error };\n recovering = false;\n\n constructor(props: ErrorBoundary['props']) {\n super(props);\n }\n\n static getDerivedStateFromError(error: Error) {\n return { error };\n }\n\n componentDidCatch(error: Error) {\n const { self } = this.props;\n const { fallback } = self;\n const reset = (error?: Error) => {\n this.recovering = true;\n this.setState({ error });\n };\n\n Promise.resolve(self.catch!(error))\n .then(() => reset(), reset)\n .finally(() => self.set({ fallback }, true));\n }\n\n componentDidUpdate() {\n this.recovering = false;\n }\n\n render() {\n if (!this.state.error) return this.props.children;\n if (this.recovering) throw this.state.error;\n return this.props.self.fallback;\n }\n};\n","import { Component } from '@expressive/mvc';\nimport {\n createContext,\n createElement,\n Suspense,\n useContext,\n useEffect,\n useRef,\n useState\n} from 'react';\n\nimport './jsx-runtime';\nimport { Runtime } from './adapter';\nimport { ErrorBoundary, dedupe } from './boundary';\n\n// React detects class components by this brand (preact reads `prototype.render`).\nObject.defineProperty(Component.prototype, 'isReactComponent', {\n value: true\n});\n\nObject.assign(Runtime, {\n dedupe,\n ErrorBoundary,\n createElement,\n createContext,\n useContext,\n useEffect,\n useState,\n useRef,\n Suspense,\n ignore: [\n 'updater',\n 'refs',\n '_reactInternals',\n '_reactInternalInstance'\n ]\n});\n\nexport { State, State as default, use, Consumer, Provider } from './adapter';\nexport { Component, Context, Observer, def, get, ref, set, hot } from '@expressive/mvc';\n"],"mappings":";;;;;;;AAcA,KAAK;CACH;CACA;CACA;CACA,WAAW;CACX,WAAW,UAA4B;AACrC,SAAO,SAAS,QAAQ,SAA4B;;CAEtD,OAAO,MAAK;AACV,SAAO,eAAe,KAAK,GAAG,KAAK,OAAO;;CAE5C,QAAQ,MAAK;AACX,SAAO,eAAe,KAAK,GAAG,KAAK,QAAmC,EAAE;;CAE3E,CAAC;;;;;;ACfF,MAAM,wBAAQ,IAAI,SAA2C;;;;;AAM7D,SAAgB,OAAO,IAAe,SAAkB;CACtD,IAAI,QAAQ,MAAM,IAAI,QAAQ,OAAQ;AACtC,KAAI,CAAC,MAAO,OAAM,IAAI,QAAQ,QAAU,wBAAQ,IAAI,KAAK,CAAE;CAG3D,IAAI,OAAO;AACX,MAAK,IAAI,IAAK,GAAW,iBAAiB,GAAG,IAAI,EAAE,OACjD,UAAS,EAAE,OAAO,EAAE,SAAS;CAE/B,IAAI,OAAO,MAAM,IAAI,KAAK;AAC1B,KAAI,CAAC,KAAM,OAAM,IAAI,MAAO,uBAAO,IAAI,KAAK,CAAE;CAE9C,MAAM,QAAe;EACnB;EACA,SAAS;AACP,SAAM,YAAY;AAElB,QAAK,MAAM,KAAK,MAAM;AACpB,QAAI,MAAM,MAAO;AACjB,QAAI,EAAE,UAAW;AACjB,MAAE,QAAQ,KAAK;AACf,SAAK,OAAO,EAAE;;;EAGlB,SAAS;AACP,QAAK,OAAO,MAAM;;EAErB;AAED,MAAK,IAAI,MAAM;AACf,QAAO;;AAGT,IAAa,gBAAb,cAAmC,MAAM,UAGtC;CAID,YAAY,OAA+B;AACzC,QAAM,MAAM;eAJN,EAAE;oBACG;;CAMb,OAAO,yBAAyB,OAAc;AAC5C,SAAO,EAAE,OAAO;;CAGlB,kBAAkB,OAAc;EAC9B,MAAM,EAAE,SAAS,KAAK;EACtB,MAAM,EAAE,aAAa;EACrB,MAAM,SAAS,UAAkB;AAC/B,QAAK,aAAa;AAClB,QAAK,SAAS,EAAE,OAAO,CAAC;;AAG1B,UAAQ,QAAQ,KAAK,MAAO,MAAM,CAAC,CAChC,WAAW,OAAO,EAAE,MAAM,CAC1B,cAAc,KAAK,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC;;CAGhD,qBAAqB;AACnB,OAAK,aAAa;;CAGpB,SAAS;AACP,MAAI,CAAC,KAAK,MAAM,MAAO,QAAO,KAAK,MAAM;AACzC,MAAI,KAAK,WAAY,OAAM,KAAK,MAAM;AACtC,SAAO,KAAK,MAAM,KAAK;;;;;;ACvE3B,OAAO,eAAeA,YAAU,WAAW,oBAAoB,EAC7D,OAAO,MACR,CAAC;AAEF,OAAO,OAAO,SAAS;CACrB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,QAAQ;EACN;EACA;EACA;EACA;EACD;CACF,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@expressive/react",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.79.1",
|
|
4
4
|
"description": "Use classes to define state in React!",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"expressive",
|
|
@@ -23,11 +23,11 @@
|
|
|
23
23
|
"type": "module",
|
|
24
24
|
"sideEffects": [
|
|
25
25
|
"./dist/index.js",
|
|
26
|
-
"./dist/
|
|
27
|
-
"./
|
|
28
|
-
"./
|
|
29
|
-
"./
|
|
30
|
-
"./src/
|
|
26
|
+
"./dist/adapter.js",
|
|
27
|
+
"./src/jsx-runtime.ts",
|
|
28
|
+
"./src/state.get.ts",
|
|
29
|
+
"./src/state.use.ts",
|
|
30
|
+
"./src/component.ts"
|
|
31
31
|
],
|
|
32
32
|
"main": "dist/index.js",
|
|
33
33
|
"types": "dist/index.d.ts",
|
|
@@ -36,9 +36,9 @@
|
|
|
36
36
|
"types": "./dist/index.d.ts",
|
|
37
37
|
"default": "./dist/index.js"
|
|
38
38
|
},
|
|
39
|
-
"./
|
|
40
|
-
"types": "./dist/
|
|
41
|
-
"default": "./dist/
|
|
39
|
+
"./adapter": {
|
|
40
|
+
"types": "./dist/adapter.d.ts",
|
|
41
|
+
"default": "./dist/adapter.js"
|
|
42
42
|
}
|
|
43
43
|
},
|
|
44
44
|
"engines": {
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
import { Component, Context, State } from "@expressive/mvc";
|
|
2
|
-
import * as react from "react";
|
|
3
|
-
|
|
4
|
-
//#region src/context.d.ts
|
|
5
|
-
/** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */
|
|
6
|
-
declare function provide(context: Context, children: any): any;
|
|
7
|
-
declare namespace Consumer {
|
|
8
|
-
type Props<T extends State> = {
|
|
9
|
-
/** Type of controller to fetch from context. */for: State.Extends<T>;
|
|
10
|
-
/**
|
|
11
|
-
* Render function, will receive instance of desired controller.
|
|
12
|
-
*
|
|
13
|
-
* Called every render of parent component.
|
|
14
|
-
* Similar to `State.get()`, updates to properties accessed in
|
|
15
|
-
* this function will cause a refresh when they change.
|
|
16
|
-
*/
|
|
17
|
-
children: (value: T) => Component.Node | void;
|
|
18
|
-
};
|
|
19
|
-
}
|
|
20
|
-
declare function Consumer<T extends State>(props: Consumer.Props<T>): string | number | bigint | boolean | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | react.ReactPortal | null;
|
|
21
|
-
declare namespace Provider {
|
|
22
|
-
type ForEach<T> = (state: T) => void | (() => void);
|
|
23
|
-
interface SharedProps {
|
|
24
|
-
/**
|
|
25
|
-
* Children to render within this Provider.
|
|
26
|
-
*/
|
|
27
|
-
children?: Component.Node;
|
|
28
|
-
/** A fallback tree to show when suspended. */
|
|
29
|
-
fallback?: Component.Node;
|
|
30
|
-
/**
|
|
31
|
-
* A name for this Suspense boundary for instrumentation purposes.
|
|
32
|
-
* The name will help identify this boundary in React DevTools.
|
|
33
|
-
*/
|
|
34
|
-
name?: string | undefined;
|
|
35
|
-
}
|
|
36
|
-
type ForSingleProps<T extends State> = SharedProps & {
|
|
37
|
-
for: T | State.Type<T>;
|
|
38
|
-
is: (instance: T) => void;
|
|
39
|
-
} & { [K in State.Field<T>]?: T[K] };
|
|
40
|
-
type ForMultipleProps<T extends State> = SharedProps & {
|
|
41
|
-
for: Context.Accept<T>;
|
|
42
|
-
is?: ForEach<T>;
|
|
43
|
-
};
|
|
44
|
-
type Props<T extends State = State> = ForSingleProps<T> | ForMultipleProps<T>;
|
|
45
|
-
}
|
|
46
|
-
declare function Provider<T extends State>(props: Provider.Props<T>): any;
|
|
47
|
-
//#endregion
|
|
48
|
-
export { provide as i, Context as n, Provider as r, Consumer as t };
|
|
49
|
-
//# sourceMappingURL=context-B-HNZeaN.d.ts.map
|
package/dist/context-BfeYQmAX.js
DELETED
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
import { Component, Context, State } from "@expressive/mvc";
|
|
2
|
-
import { Runtime, useHook } from "./runtime";
|
|
3
|
-
|
|
4
|
-
//#region src/context.ts
|
|
5
|
-
let shared;
|
|
6
|
-
/**
|
|
7
|
-
* Lazily-created context carrying the active {@link Context} down the tree.
|
|
8
|
-
* Lazy because the framework's `createContext` arrives via {@link Runtime},
|
|
9
|
-
* which an adapter's entry populates at load - after this module evaluates.
|
|
10
|
-
*/
|
|
11
|
-
function Layers() {
|
|
12
|
-
return shared || (shared = Runtime.createContext(Context.root));
|
|
13
|
-
}
|
|
14
|
-
/** Read the ambient {@link Context} from the nearest Layers provider. */
|
|
15
|
-
function useAmbient() {
|
|
16
|
-
return Runtime.useContext(Layers());
|
|
17
|
-
}
|
|
18
|
-
/** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */
|
|
19
|
-
function provide(context, children) {
|
|
20
|
-
return Runtime.createElement(Layers().Provider, {
|
|
21
|
-
value: context,
|
|
22
|
-
children
|
|
23
|
-
});
|
|
24
|
-
}
|
|
25
|
-
Object.defineProperty(Component, "contextType", {
|
|
26
|
-
configurable: true,
|
|
27
|
-
get: Layers
|
|
28
|
-
});
|
|
29
|
-
const _get = Context.get;
|
|
30
|
-
Context.get = (state) => {
|
|
31
|
-
if (!state) try {
|
|
32
|
-
return useAmbient();
|
|
33
|
-
} catch {}
|
|
34
|
-
return _get(state);
|
|
35
|
-
};
|
|
36
|
-
function Consumer(props) {
|
|
37
|
-
return props.for.get((i) => props.children(i));
|
|
38
|
-
}
|
|
39
|
-
function Provider(props) {
|
|
40
|
-
const { for: input, children, fallback, name, is, ...rest } = props;
|
|
41
|
-
const ambient = useAmbient();
|
|
42
|
-
const context = useHook((set) => {
|
|
43
|
-
set(new Context(ambient));
|
|
44
|
-
return () => context.pop();
|
|
45
|
-
});
|
|
46
|
-
context.set(input, is);
|
|
47
|
-
if (Object.keys(rest).length) {
|
|
48
|
-
const i = State.is(input) ? context.get(input) : input;
|
|
49
|
-
if (i instanceof State) i.set(rest);
|
|
50
|
-
}
|
|
51
|
-
return provide(context, fallback !== void 0 ? Runtime.createElement(Runtime.Suspense, {
|
|
52
|
-
fallback,
|
|
53
|
-
name
|
|
54
|
-
}, children) : children);
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
//#endregion
|
|
58
|
-
export { provide as i, Context as n, Provider as r, Consumer as t };
|
|
59
|
-
//# sourceMappingURL=context-BfeYQmAX.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"context-BfeYQmAX.js","names":[],"sources":["../src/context.ts"],"sourcesContent":["import { State, Context, Component } from '@expressive/mvc';\nimport { Runtime, useHook } from './runtime';\n\nlet shared: any;\n\n/**\n * Lazily-created context carrying the active {@link Context} down the tree.\n * Lazy because the framework's `createContext` arrives via {@link Runtime},\n * which an adapter's entry populates at load - after this module evaluates.\n */\nfunction Layers() {\n return shared || (shared = Runtime.createContext(Context.root));\n}\n\n/** Read the ambient {@link Context} from the nearest Layers provider. */\nfunction useAmbient() {\n return Runtime.useContext(Layers());\n}\n\n/** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */\nfunction provide(context: Context, children: any) {\n return Runtime.createElement(Layers().Provider, { value: context, children });\n}\n\n// Class components consume the active Context through the host's `contextType`\nObject.defineProperty(Component, 'contextType', { configurable: true, get: Layers });\n\nconst _get = Context.get;\n\nContext.get = (state?: State) => {\n if (!state)\n try {\n return useAmbient();\n } catch { }\n\n return _get(state);\n};\n\ndeclare namespace Consumer {\n type Props<T extends State> = {\n /** Type of controller to fetch from context. */\n for: State.Extends<T>;\n\n /**\n * Render function, will receive instance of desired controller.\n *\n * Called every render of parent component.\n * Similar to `State.get()`, updates to properties accessed in\n * this function will cause a refresh when they change.\n */\n children: (value: T) => Component.Node | void;\n };\n}\n\nfunction Consumer<T extends State>(props: Consumer.Props<T>) {\n return props.for.get((i) => props.children(i));\n}\n\ndeclare namespace Provider {\n type ForEach<T> = (state: T) => void | (() => void);\n\n interface SharedProps {\n /**\n * Children to render within this Provider.\n */\n children?: Component.Node;\n\n /** A fallback tree to show when suspended. */\n fallback?: Component.Node;\n\n /**\n * A name for this Suspense boundary for instrumentation purposes.\n * The name will help identify this boundary in React DevTools.\n */\n name?: string | undefined;\n }\n\n type ForSingleProps<T extends State> = SharedProps & {\n for: T | State.Type<T>;\n is: (instance: T) => void;\n } & { [K in State.Field<T>]?: T[K] };\n\n type ForMultipleProps<T extends State> = SharedProps & {\n for: Context.Accept<T>;\n is?: ForEach<T>;\n };\n\n type Props<T extends State = State> = ForSingleProps<T> | ForMultipleProps<T>;\n}\n\nfunction Provider<T extends State>(props: Provider.Props<T>) {\n const {\n for: input,\n children,\n fallback,\n name,\n is,\n ...rest\n } = props as Provider.ForSingleProps<T> & Provider.ForMultipleProps<T>;\n\n const ambient = useAmbient();\n const context = useHook<Context>((set) => {\n set(new Context(ambient));\n return () => context.pop();\n });\n\n context.set(input, is);\n\n if (Object.keys(rest).length) {\n const i = State.is(input) ? context.get(input) : input;\n if (i instanceof State) i.set(rest);\n }\n\n return provide(context,\n fallback !== undefined\n ? Runtime.createElement(Runtime.Suspense, { fallback, name }, children)\n : children\n );\n}\n\nexport { Consumer, Provider, Context, provide };\n"],"mappings":";;;;AAGA,IAAI;;;;;;AAOJ,SAAS,SAAS;AAChB,QAAO,WAAW,SAAS,QAAQ,cAAc,QAAQ,KAAK;;;AAIhE,SAAS,aAAa;AACpB,QAAO,QAAQ,WAAW,QAAQ,CAAC;;;AAIrC,SAAS,QAAQ,SAAkB,UAAe;AAChD,QAAO,QAAQ,cAAc,QAAQ,CAAC,UAAU;EAAE,OAAO;EAAS;EAAU,CAAC;;AAI/E,OAAO,eAAe,WAAW,eAAe;CAAE,cAAc;CAAM,KAAK;CAAQ,CAAC;AAEpF,MAAM,OAAO,QAAQ;AAErB,QAAQ,OAAO,UAAkB;AAC/B,KAAI,CAAC,MACH,KAAI;AACF,SAAO,YAAY;SACb;AAEV,QAAO,KAAK,MAAM;;AAmBpB,SAAS,SAA0B,OAA0B;AAC3D,QAAO,MAAM,IAAI,KAAK,MAAM,MAAM,SAAS,EAAE,CAAC;;AAmChD,SAAS,SAA0B,OAA0B;CAC3D,MAAM,EACJ,KAAK,OACL,UACA,UACA,MACA,IACA,GAAG,SACD;CAEJ,MAAM,UAAU,YAAY;CAC5B,MAAM,UAAU,SAAkB,QAAQ;AACxC,MAAI,IAAI,QAAQ,QAAQ,CAAC;AACzB,eAAa,QAAQ,KAAK;GAC1B;AAEF,SAAQ,IAAI,OAAO,GAAG;AAEtB,KAAI,OAAO,KAAK,KAAK,CAAC,QAAQ;EAC5B,MAAM,IAAI,MAAM,GAAG,MAAM,GAAG,QAAQ,IAAI,MAAM,GAAG;AACjD,MAAI,aAAa,MAAO,GAAE,IAAI,KAAK;;AAGrC,QAAO,QAAQ,SACb,aAAa,SACT,QAAQ,cAAc,QAAQ,UAAU;EAAE;EAAU;EAAM,EAAE,SAAS,GACrE,SACL"}
|
package/dist/runtime.js
DELETED
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
import { i as provide, n as Context, r as Provider, t as Consumer } from "./context-BfeYQmAX.js";
|
|
2
|
-
import { State, event, observer, watch } from "@expressive/mvc";
|
|
3
|
-
|
|
4
|
-
//#region src/runtime.ts
|
|
5
|
-
const Runtime = {};
|
|
6
|
-
function useFactory(factory) {
|
|
7
|
-
const ref = Runtime.useRef(null);
|
|
8
|
-
return ref.current || (ref.current = factory());
|
|
9
|
-
}
|
|
10
|
-
function useReady(callback) {
|
|
11
|
-
return Runtime.useEffect(() => void callback(), []);
|
|
12
|
-
}
|
|
13
|
-
/**
|
|
14
|
-
* Mount-effect with a refreshable return value, safe under React StrictMode.
|
|
15
|
-
*
|
|
16
|
-
* @param callback Setup handler; receives a setter, must return a cleanup.
|
|
17
|
-
* @returns Latest value published via the setter (`undefined` until set).
|
|
18
|
-
*/
|
|
19
|
-
function useHook(callback) {
|
|
20
|
-
const { current } = Runtime.useRef({ rendered: 0 });
|
|
21
|
-
current.update = Runtime.useState(() => {
|
|
22
|
-
if (!current.rendered) current.unmount = callback((next) => {
|
|
23
|
-
current.output = next;
|
|
24
|
-
if (current.mounted) current.update?.((x) => x + 1);
|
|
25
|
-
else if (current.update) current.pending = true;
|
|
26
|
-
});
|
|
27
|
-
return current.rendered++;
|
|
28
|
-
})[1];
|
|
29
|
-
Runtime.useEffect(() => {
|
|
30
|
-
current.mounted = true;
|
|
31
|
-
if (current.pending) {
|
|
32
|
-
current.pending = false;
|
|
33
|
-
current.update((x) => x + 1);
|
|
34
|
-
}
|
|
35
|
-
return () => {
|
|
36
|
-
if (--current.rendered < 1) current.unmount();
|
|
37
|
-
};
|
|
38
|
-
}, []);
|
|
39
|
-
return current.output;
|
|
40
|
-
}
|
|
41
|
-
/** Subscribe to an existing observable instance within a component. */
|
|
42
|
-
function use(subject) {
|
|
43
|
-
const { current } = Runtime.useRef({
|
|
44
|
-
mounted: 0,
|
|
45
|
-
proxy: subject
|
|
46
|
-
});
|
|
47
|
-
const update = Runtime.useState(() => current.mounted++)[1];
|
|
48
|
-
if (current.source !== subject) {
|
|
49
|
-
const status = observer(subject);
|
|
50
|
-
if (status === void 0) throw new Error("Provided object is not observable.");
|
|
51
|
-
current.unwatch?.();
|
|
52
|
-
current.source = subject;
|
|
53
|
-
if (status === null) {
|
|
54
|
-
current.unwatch = void 0;
|
|
55
|
-
current.proxy = subject;
|
|
56
|
-
} else {
|
|
57
|
-
if (!status.ready) event(subject);
|
|
58
|
-
let init = true;
|
|
59
|
-
current.unwatch = watch(subject, (next, changed) => {
|
|
60
|
-
current.proxy = next;
|
|
61
|
-
if (changed.length && !init) update((x) => x + 1);
|
|
62
|
-
});
|
|
63
|
-
init = false;
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
Runtime.useEffect(() => () => {
|
|
67
|
-
if (--current.mounted < 1) current.unwatch?.();
|
|
68
|
-
}, []);
|
|
69
|
-
return current.proxy;
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
//#endregion
|
|
73
|
-
export { Consumer, Context, Provider, Runtime, State, provide, use, useFactory, useHook, useReady };
|
|
74
|
-
//# sourceMappingURL=runtime.js.map
|
package/dist/runtime.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import { event, watch, observer } from '@expressive/mvc';\nimport type { Component } from '@expressive/mvc';\nimport type { Context } from './context';\nimport './component';\nimport './state.get';\nimport './state.use';\n\nexport { State } from '@expressive/mvc';\nexport { Consumer, Provider, Context, provide } from './context';\n\nexport const Runtime = {} as {\n /** Host own-property keys to trap out of observed state; assigned by each adapter. */\n ignore: string[];\n createElement(type: any, props?: any, ...children: any[]): any;\n createContext<T>(value: T): any;\n useContext(context: any): any;\n useState<S>(initial: S | (() => S)): [S, (next: (previous: S) => S) => void];\n useEffect(effect: () => (() => void) | void, deps?: any[]): void;\n useRef<T>(initial: T): { current: T };\n /** Per-render-attempt lifecycle, set by each adapter (React stacks attempts; others no-op). */\n dedupe(from: Component, context: Context): { commit(): void; remove(): void };\n /** Host error-boundary component, wrapping a Component whose `catch` is set. */\n ErrorBoundary: unknown;\n Suspense: any;\n};\n\nexport function useFactory<T extends Function>(factory: () => T) {\n const ref = Runtime.useRef<T | null>(null);\n return ref.current || (ref.current = factory());\n}\n\nexport function useReady<T>(callback: () => void) {\n return Runtime.useEffect(() => void callback(), []);\n}\n\n/**\n * Mount-effect with a refreshable return value, safe under React StrictMode.\n *\n * @param callback Setup handler; receives a setter, must return a cleanup.\n * @returns Latest value published via the setter (`undefined` until set).\n */\nexport function useHook<T = void>(\n callback: (refresh: (next: T) => void) => () => void\n) {\n const { current } = Runtime.useRef(\n { rendered: 0 } as {\n rendered: number;\n mounted?: boolean;\n pending?: boolean;\n unmount: () => void;\n update?: (next: (previous: number) => number) => void;\n output: T;\n }\n );\n\n current.update = Runtime.useState(() => {\n if (!current.rendered)\n current.unmount = callback((next) => {\n current.output = next;\n if (current.mounted) current.update?.((x) => x + 1);\n else if (current.update) current.pending = true;\n });\n\n return current.rendered++;\n })[1];\n\n Runtime.useEffect(() => {\n current.mounted = true;\n if (current.pending) {\n current.pending = false;\n current.update!((x) => x + 1);\n }\n return () => {\n if (--current.rendered < 1) current.unmount();\n }\n }, []);\n\n return current.output;\n}\n\n/** Subscribe to an existing observable instance within a component. */\nexport function use<T extends object>(subject: T) {\n const { current } = Runtime.useRef<{\n proxy: T;\n source?: T;\n mounted: number;\n unwatch?: () => void;\n }>({ mounted: 0, proxy: subject });\n\n const update = Runtime.useState(() => current.mounted++)[1];\n\n if (current.source !== subject) {\n const status = observer(subject);\n\n if (status === undefined)\n throw new Error('Provided object is not observable.');\n\n current.unwatch?.();\n current.source = subject;\n\n if (status === null) {\n current.unwatch = undefined;\n current.proxy = subject;\n } else {\n if (!status.ready) event(subject);\n\n let init = true;\n\n current.unwatch = watch(subject, (next, changed) => {\n current.proxy = next;\n if (changed.length && !init)\n update((x) => x + 1);\n });\n\n init = false;\n }\n }\n\n Runtime.useEffect(() => () => {\n if (--current.mounted < 1) current.unwatch?.();\n }, []);\n\n return current.proxy;\n}\n"],"mappings":";;;;AAUA,MAAa,UAAU,EAAE;AAgBzB,SAAgB,WAA+B,SAAkB;CAC/D,MAAM,MAAM,QAAQ,OAAiB,KAAK;AAC1C,QAAO,IAAI,YAAY,IAAI,UAAU,SAAS;;AAGhD,SAAgB,SAAY,UAAsB;AAChD,QAAO,QAAQ,gBAAgB,KAAK,UAAU,EAAE,EAAE,CAAC;;;;;;;;AASrD,SAAgB,QACd,UACA;CACA,MAAM,EAAE,YAAY,QAAQ,OAC1B,EAAE,UAAU,GAAG,CAQhB;AAED,SAAQ,SAAS,QAAQ,eAAe;AACtC,MAAI,CAAC,QAAQ,SACX,SAAQ,UAAU,UAAU,SAAS;AACnC,WAAQ,SAAS;AACjB,OAAI,QAAQ,QAAS,SAAQ,UAAU,MAAM,IAAI,EAAE;YAC1C,QAAQ,OAAQ,SAAQ,UAAU;IAC3C;AAEJ,SAAO,QAAQ;GACf,CAAC;AAEH,SAAQ,gBAAgB;AACtB,UAAQ,UAAU;AAClB,MAAI,QAAQ,SAAS;AACnB,WAAQ,UAAU;AAClB,WAAQ,QAAS,MAAM,IAAI,EAAE;;AAE/B,eAAa;AACX,OAAI,EAAE,QAAQ,WAAW,EAAG,SAAQ,SAAS;;IAE9C,EAAE,CAAC;AAEN,QAAO,QAAQ;;;AAIjB,SAAgB,IAAsB,SAAY;CAChD,MAAM,EAAE,YAAY,QAAQ,OAKzB;EAAE,SAAS;EAAG,OAAO;EAAS,CAAC;CAElC,MAAM,SAAS,QAAQ,eAAe,QAAQ,UAAU,CAAC;AAEzD,KAAI,QAAQ,WAAW,SAAS;EAC9B,MAAM,SAAS,SAAS,QAAQ;AAEhC,MAAI,WAAW,OACb,OAAM,IAAI,MAAM,qCAAqC;AAEvD,UAAQ,WAAW;AACnB,UAAQ,SAAS;AAEjB,MAAI,WAAW,MAAM;AACnB,WAAQ,UAAU;AAClB,WAAQ,QAAQ;SACX;AACL,OAAI,CAAC,OAAO,MAAO,OAAM,QAAQ;GAEjC,IAAI,OAAO;AAEX,WAAQ,UAAU,MAAM,UAAU,MAAM,YAAY;AAClD,YAAQ,QAAQ;AAChB,QAAI,QAAQ,UAAU,CAAC,KACrB,SAAQ,MAAM,IAAI,EAAE;KACtB;AAEF,UAAO;;;AAIX,SAAQ,sBAAsB;AAC5B,MAAI,EAAE,QAAQ,UAAU,EAAG,SAAQ,WAAW;IAC7C,EAAE,CAAC;AAEN,QAAO,QAAQ"}
|