@expressive/react 0.81.0 → 0.83.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  <p align="center">
8
8
  <a href="https://www.npmjs.com/package/@expressive/react"><img alt="NPM" src="https://badge.fury.io/js/%40expressive%2Freact.svg"></a>
9
- <img src="https://img.shields.io/badge/Coverage-100%25-brightgreen.svg">
9
+ <a href="https://github.com/gabeklein/expressive-mvc/actions/workflows/coverage.yml"><img alt="Coverage" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fgabeklein%2Fexpressive-mvc%2Fbadges%2Fcoverage.json"></a>
10
10
  </p>
11
11
 
12
12
  ---
package/dist/adapter.d.ts CHANGED
@@ -51,6 +51,18 @@ declare module '@expressive/mvc' {
51
51
  * @param props Arguments passed to State.use().
52
52
  */
53
53
  use?(...props: any[]): Promise<void> | void;
54
+ /**
55
+ * Optional hook called once the host component commits. Return a function
56
+ * to run when it unmounts.
57
+ *
58
+ * Not called during server render, nor for an instance merely observed or
59
+ * placed: `.get()` and `{instance}` reach one a component does not own, and
60
+ * `State.new()` has no component at all.
61
+ *
62
+ * Client-only effects belong here - setup which must accompany the instance
63
+ * itself belongs in `new()`.
64
+ */
65
+ mount?(): (() => void) | void;
54
66
  }
55
67
  namespace State {
56
68
  type UseArgs<T extends State> = T extends {
@@ -82,7 +94,11 @@ declare namespace Consumer {
82
94
  }
83
95
  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
96
  declare namespace Provider {
85
- type ForEach<T> = (state: T) => void | (() => void);
97
+ /**
98
+ * Runs for each State registered by this Provider. Return value is ignored -
99
+ * to run teardown with a State, use `state.set(null, callback)`.
100
+ */
101
+ type ForEach<T> = (state: T) => void;
86
102
  interface SharedProps {
87
103
  /**
88
104
  * Children to render within this Provider.
@@ -106,11 +122,34 @@ declare namespace Provider {
106
122
  };
107
123
  type Props<T extends State$2 = State$2> = ForSingleProps<T> | ForMultipleProps<T>;
108
124
  }
109
- declare function Provider<T extends State$2>(props: Provider.Props<T>): any;
125
+ declare function Provider<T extends State$2>({
126
+ children,
127
+ fallback,
128
+ name,
129
+ ...props
130
+ }: Provider.Props<T>): any;
110
131
  //#endregion
111
132
  //#region src/component.d.ts
112
133
  declare module '@expressive/mvc' {
134
+ namespace Component {
135
+ /**
136
+ * Not available - a Component is rendered, not a hook.
137
+ * Render it with `<Component />` or `{component}`.
138
+ * For a bare instance use `Component.new()`.
139
+ */
140
+ const use: never;
141
+ }
113
142
  interface Component {
143
+ /**
144
+ * Optional hook called once this Component commits. Return a function to
145
+ * run when it unmounts.
146
+ *
147
+ * Not called during server render, nor for an instance placed as
148
+ * `{component}` - a placement does not own what it renders. Client-only
149
+ * effects belong here; setup which must accompany the instance itself
150
+ * belongs in `new()`.
151
+ */
152
+ mount?(): (() => void) | void;
114
153
  /** @deprecated Only to satisfy host JSX. Use `this.get(State)` instead. */
115
154
  readonly context: Context$1;
116
155
  /** @deprecated Only to satisfy host JSX. Use `this.get()` instead. */
@@ -121,6 +160,10 @@ declare module '@expressive/mvc' {
121
160
  forceUpdate: (callback?: () => void) => void;
122
161
  }
123
162
  }
163
+ /**
164
+ * Wrap a content element in its context provider, a Suspense boundary (unless
165
+ * `fallback` is `false`) and, when `catch` is set, the host error boundary.
166
+ */
124
167
  //#endregion
125
168
  //#region src/runtime.d.ts
126
169
  declare const Runtime: {
package/dist/adapter.js CHANGED
@@ -1,75 +1,7 @@
1
- import { Component, Context, Context as Context$1, State, State as State$1, unbind } from "@expressive/mvc";
2
- import { event, observer, watch } from "@expressive/mvc/observable";
1
+ import { a as Runtime, c as useHook, i as Provider, n as Consumer, o as use, s as useFactory } from "./component-fEqgY0Wy.js";
2
+ import { Context, State, State as State$1 } from "@expressive/mvc";
3
+ import { observer, watch } from "@expressive/mvc/observable";
3
4
 
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
5
  //#region src/state.get.ts
74
6
  State$1.get = function get(argument) {
75
7
  const next = Runtime.useState(0)[1];
@@ -100,13 +32,15 @@ State$1.get = function get(argument) {
100
32
  unwatch = () => {};
101
33
  return release;
102
34
  }
103
- unwatch = watch(next, (current, changed) => {
35
+ let first = true;
36
+ unwatch = watch(next, (current) => {
104
37
  if (typeof argument === "function") {
105
38
  const next = argument.call(current, current, refresh);
106
39
  if (next === value) return;
107
40
  value = next;
108
41
  } else value = current;
109
- if (changed.length) update();
42
+ if (!first) update();
43
+ first = false;
110
44
  }, argument === true);
111
45
  if (mounted) {
112
46
  pending = true;
@@ -136,8 +70,10 @@ State$1.get = function get(argument) {
136
70
  }
137
71
  return () => {
138
72
  pending = false;
139
- useReady(() => mounted = true);
140
- useHook(() => release);
73
+ useHook(() => () => {
74
+ mounted = true;
75
+ return release;
76
+ });
141
77
  return value === void 0 ? null : value;
142
78
  };
143
79
  })();
@@ -165,183 +101,22 @@ State$1.use = function use(...args) {
165
101
  ready = true;
166
102
  });
167
103
  }
168
- useReady(() => ready = true);
169
104
  return useHook((update) => {
170
105
  watch(instance, update);
171
106
  return () => {
172
- context.pop();
173
- instance.set(null);
107
+ ready = true;
108
+ const release = instance.mount?.();
109
+ return () => {
110
+ if (typeof release == "function") release();
111
+ context.pop();
112
+ instance.set(null);
113
+ };
174
114
  };
175
115
  });
176
116
  };
177
117
  })(args);
178
118
  };
179
119
 
180
- //#endregion
181
- //#region src/context.ts
182
- let shared;
183
- /**
184
- * Lazily-created context carrying the active {@link Context} down the tree.
185
- * Lazy because the framework's `createContext` arrives via {@link Runtime},
186
- * which an adapter's entry populates at load - after this module evaluates.
187
- */
188
- function Layers() {
189
- return shared || (shared = Runtime.createContext(Context$1.root));
190
- }
191
- /** Read the ambient {@link Context} from the nearest Layers provider. */
192
- function useAmbient() {
193
- return Runtime.useContext(Layers());
194
- }
195
- /** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */
196
- function provide(context, children) {
197
- return Runtime.createElement(Layers().Provider, {
198
- value: context,
199
- children
200
- });
201
- }
202
- Object.defineProperty(Component, "contextType", {
203
- configurable: true,
204
- get: Layers
205
- });
206
- const _get = Context$1.get;
207
- Context$1.get = (state) => {
208
- if (!state) try {
209
- return useAmbient();
210
- } catch {}
211
- return _get(state);
212
- };
213
- function Consumer(props) {
214
- return props.for.get((i) => props.children(i));
215
- }
216
- function Provider(props) {
217
- const { for: input, children, fallback, name, is, ...rest } = props;
218
- const ambient = useAmbient();
219
- const context = useHook((set) => {
220
- set(new Context$1(ambient));
221
- return () => context.pop();
222
- });
223
- context.set(input, is);
224
- if (Object.keys(rest).length) {
225
- const i = State$1.is(input) ? context.get(input) : input;
226
- if (i instanceof State$1) i.set(rest);
227
- }
228
- return provide(context, fallback !== void 0 ? Runtime.createElement(Runtime.Suspense, {
229
- fallback,
230
- name
231
- }, children) : children);
232
- }
233
-
234
- //#endregion
235
- //#region src/component.ts
236
- Object.defineProperties(Component.prototype, {
237
- state: {
238
- set() {},
239
- get: Component.prototype.get
240
- },
241
- context: { set: bootstrap }
242
- });
243
- /**
244
- * `State.on` handler that prepares a Component's prototype at bootstrap, before
245
- * mvc classifies its members:
246
- *
247
- * - On the root Component, host own-property keys are trapped so each lands as a
248
- * plain own property (out of observed state); each adapter assigns its own set.
249
- * - capitalized methods are rewritten into subcomponents as non-configurable
250
- * getters, so bootstrap skips them too.
251
- *
252
- * (Sealing `render` as the content-render seam is handled by core itself.)
253
- *
254
- * `before` covers the per-instance case: a capitalized function assigned as an
255
- * instance field (e.g. `Sidebar = Sidebar` to inject or override one), promoted
256
- * before `observe` so it is not mistaken for reactive state.
257
- */
258
- Component.on({
259
- type(type) {
260
- if (type === Component) for (const key of Runtime.ignore) Object.defineProperty(Component.prototype, key, { set(value) {
261
- Object.defineProperty(this, key, {
262
- value,
263
- writable: true
264
- });
265
- } });
266
- subcomponents(type.prototype);
267
- },
268
- before(self) {
269
- subcomponents(self, true);
270
- }
271
- });
272
- function bootstrap(context) {
273
- context = context.push();
274
- context.set(this, () => () => this.set(null));
275
- Object.defineProperties(this, {
276
- context: {
277
- get: () => context,
278
- set() {}
279
- },
280
- render: { value: render(this, context) }
281
- });
282
- this.set(null, () => {
283
- Object.defineProperty(this, "props", {
284
- value: this.props,
285
- writable: true
286
- });
287
- });
288
- }
289
- /**
290
- * Per-instance render host: subscribe the instance, render inside its context
291
- * provider, wrap pending in Suspense and (when `catch` is set) the host error
292
- * boundary. Host differences live behind `Runtime.dedupe`/`Runtime.ErrorBoundary`.
293
- */
294
- function render(from, context) {
295
- const { createElement: create } = Runtime;
296
- const { commit, remove } = Runtime.dedupe(from, context);
297
- const content = from.render;
298
- const Render = () => content.call(from, from.props);
299
- const Component = () => {
300
- from = useHook((refresh) => {
301
- if (observer(from) !== null) watch(from, refresh);
302
- return () => {
303
- remove();
304
- context.pop();
305
- };
306
- }) || from;
307
- useReady(commit);
308
- const rendered = create(Render);
309
- const children = provide(context, from.fallback === false ? rendered : create(Runtime.Suspense, {
310
- fallback: from.fallback,
311
- name: String(from)
312
- }, rendered));
313
- return from.catch ? create(Runtime.ErrorBoundary, {
314
- self: from,
315
- children
316
- }) : children;
317
- };
318
- return () => create(Component);
319
- }
320
- /** Rewrite each own capitalized function on `target` into a subcomponent. */
321
- function subcomponents(target, configurable) {
322
- for (const key of Object.getOwnPropertyNames(target)) {
323
- if (!/^[A-Z]/.test(key)) continue;
324
- const { value } = Object.getOwnPropertyDescriptor(target, key);
325
- if (typeof value != "function") continue;
326
- Object.defineProperty(target, key, {
327
- configurable,
328
- get() {
329
- const owner = this.is;
330
- let render = unbind(value);
331
- const Component = (props) => render.call(useHook((set) => watch(owner, set)) || owner, props);
332
- Object.defineProperty(owner, key, {
333
- configurable: true,
334
- get: () => Component,
335
- set(fn) {
336
- render = fn;
337
- }
338
- });
339
- return Component;
340
- }
341
- });
342
- }
343
- }
344
-
345
120
  //#endregion
346
121
  export { Consumer, Provider, Runtime, State, use };
347
122
  //# sourceMappingURL=adapter.js.map
@@ -1 +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/observable';\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 } from '@expressive/mvc';\nimport { observer, watch } from '@expressive/mvc/observable';\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 } from '@expressive/mvc';\nimport { watch } from '@expressive/mvc/observable';\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, unbind } from '@expressive/mvc';\nimport { watch, observer } from '@expressive/mvc/observable';\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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"}
1
+ {"version":3,"file":"adapter.js","names":[],"sources":["../src/state.get.ts","../src/state.use.ts"],"sourcesContent":["import { State, Context } from '@expressive/mvc';\nimport { observer, watch } from '@expressive/mvc/observable';\nimport { Runtime, useFactory, useHook } 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 let first = true;\n\n unwatch = watch(\n next,\n (current) => {\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 (!first) update();\n first = false;\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 useHook(() => () => {\n mounted = true;\n return release;\n });\n return value === undefined ? null : value;\n };\n });\n\n return render();\n};\n","import { State, Context } from '@expressive/mvc';\nimport type { UseState } from '@expressive/mvc';\nimport { watch } from '@expressive/mvc/observable';\nimport { useFactory, useHook } 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 * Optional hook called once the host component commits. Return a function\n * to run when it unmounts.\n *\n * Not called during server render, nor for an instance merely observed or\n * placed: `.get()` and `{instance}` reach one a component does not own, and\n * `State.new()` has no component at all.\n *\n * Client-only effects belong here - setup which must accompany the instance\n * itself belongs in `new()`.\n */\n mount?(): (() => 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 return useHook<T>((update) => {\n watch(instance, update);\n\n return () => {\n ready = true;\n\n const release = (instance as UseState).mount?.();\n\n return () => {\n if (typeof release == 'function') release();\n context.pop();\n instance.set(null);\n };\n };\n });\n };\n });\n\n return render(args);\n};\n"],"mappings":";;;;;AAwEA,QAAM,MAAM,SAAS,IAEnB,UACA;CACA,MAAM,OAAO,QAAQ,SAAS,EAAE,CAAC;CACjC,MAAM,QAAQ,QAAQ,KAAK;AAyG3B,QAxGe,iBAAiB;EAC9B,IAAI;EACJ,IAAI,UAAU;EACd,IAAI,UAAU;EACd,IAAI;EAEJ,SAAS,SAAS;AAChB,aAAU;AACV,SAAM,MAAM,IAAI,EAAE;;EAGpB,SAAS,QAAW,QAA+C;AACjE,OAAI,OAAO,UAAU,WAAY,UAAS,QAAQ;AAClD,WAAQ;AACR,OAAI,kBAAkB,QAAS,QAAO,OAAO,QAAQ,OAAO;;EAG9D,SAAS,UAAU;AACjB,gBAAa;AACb,cAAW;AACX,aAAU;;EAGZ,SAAS,OAAO,MAAS;AACvB,cAAW;AAEX,OAAI,SAAS,KAAK,KAAK,MAAM;AAC3B,YAAQ,OAAO,aAAa,aACxB,SAAS,KAAK,MAAM,MAAM,QAAQ,GAClC;AACJ,oBAAgB;AAChB,WAAO;;GAGT,IAAI,QAAQ;AAEZ,aAAU,MACR,OACC,YAAY;AACX,QAAI,OAAO,aAAa,YAAY;KAClC,MAAM,OAAO,SAAS,KAAK,SAAS,SAAS,QAAQ;AACrD,SAAI,SAAS,MAAO;AACpB,aAAQ;UAER,SAAQ;AAGV,QAAI,CAAC,MAAO,SAAQ;AACpB,YAAQ;MAEV,aAAa,KACd;AAED,OAAI,SAAS;AACX,cAAU;AACV,yBAAqB,WAAW,QAAQ,CAAC;;AAG3C,UAAO;;EAGT,MAAM,cAAc,MAAM,IAAI,MAAM,OAAO;AAE3C,MAAI,CAAC,SAAS;AACZ,gBAAa;AACb,OAAI,aAAa,MAAO,cAAa;AACrC,SAAM,IAAI,MAAM,kBAAkB,KAAK,cAAc;;AAGvD,MAAI,UAAU,MAAM;AAClB,YAAS;AACT,gBAAa;;AAGf,MAAI,iBAAiB,SAAS;GAC5B,IAAI;AAEJ,YAAS;AAET,SACG,MACE,MAAO,QAAQ,IACf,MAAO,QAAQ,EACjB,CACA,QAAQ,OAAO;AAElB,WAAQ;AAER,gBAAa;AACX,QAAI,MAAO,OAAM;AACjB,WAAO,UAAU,SAAY,OAAO;;;AAIxC,eAAa;AACX,aAAU;AACV,uBAAoB;AAClB,cAAU;AACV,WAAO;KACP;AACF,UAAO,UAAU,SAAY,OAAO;;GAEtC,EAEa;;;;;ACnIjB,QAAM,MAAM,SAAS,IAEnB,GAAG,MACH;CACA,MAAM,QAAQ,QAAQ,KAAK;AA6C3B,QA5Ce,iBAAiB;EAC9B,MAAM,OAAO,QACX,OAAO,OAAO,YAAY,SAAS,IAAI,IAAuB;EAEhE,IAAI,OAAO,GAAG,SAAwB,QAAQ,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;EAEvE,MAAM,WAAW,IAAI,MAAM,MAAM;AAC/B,OAAI,SAAS,KAAK,OAAO,EAAE,OAAO,YAAY;AAC5C,UAAM,EAAE,IAAI,KAAK,EAAE;AACnB,QAAI,GAAG,KAAK;SAET,QAAO;IACZ;EAEF,MAAM,UAAU,MAAM,KAAK,SAAS;EAEpC,IAAI,QAAQ;AAEZ,UAAQ,SAAwB;AAC9B,OAAI,OAAO;AACT,YAAQ;AACR,YAAQ,QAAQ,IAAI,GAAG,KAAK,CAAC,CAAC,cAAc;AAC1C,aAAQ;MACR;;AAGJ,UAAO,SAAY,WAAW;AAC5B,UAAM,UAAU,OAAO;AAEvB,iBAAa;AACX,aAAQ;KAER,MAAM,UAAW,SAAsB,SAAS;AAEhD,kBAAa;AACX,UAAI,OAAO,WAAW,WAAY,UAAS;AAC3C,cAAQ,KAAK;AACb,eAAS,IAAI,KAAK;;;KAGtB;;GAEJ,CAEY,KAAK"}
@@ -0,0 +1,281 @@
1
+ import { Component, Context as Context$1, State, unbind } from "@expressive/mvc";
2
+ import { event, observer, watch } from "@expressive/mvc/observable";
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
+ /**
11
+ * Mount-effect with a refreshable return value, safe under React StrictMode.
12
+ *
13
+ * @param callback Setup handler, run on creation; receives a setter and returns
14
+ * a mount handler, which in turn returns a cleanup. All three share this
15
+ * hook's render counter, so a StrictMode remount repeats none of them.
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.commit = 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.commit) {
31
+ current.release = current.commit();
32
+ current.commit = void 0;
33
+ }
34
+ if (current.pending) {
35
+ current.pending = false;
36
+ current.update((x) => x + 1);
37
+ }
38
+ return () => {
39
+ if (--current.rendered <= 0) current.release?.();
40
+ };
41
+ }, []);
42
+ return current.output;
43
+ }
44
+ /** Subscribe to an existing observable instance within a component. */
45
+ function use(subject) {
46
+ const { current } = Runtime.useRef({
47
+ mounted: 0,
48
+ proxy: subject
49
+ });
50
+ const update = Runtime.useState(() => current.mounted++)[1];
51
+ if (current.source !== subject) {
52
+ const status = observer(subject);
53
+ if (status === void 0) throw new Error("Provided object is not observable.");
54
+ current.unwatch?.();
55
+ current.source = subject;
56
+ if (status === null) {
57
+ current.unwatch = void 0;
58
+ current.proxy = subject;
59
+ } else {
60
+ if (!status.ready) event(subject);
61
+ let init = true;
62
+ current.unwatch = watch(subject, (next, changed) => {
63
+ current.proxy = next;
64
+ if (changed.length && !init) update((x) => x + 1);
65
+ });
66
+ init = false;
67
+ }
68
+ }
69
+ Runtime.useEffect(() => () => {
70
+ if (--current.mounted < 1) current.unwatch?.();
71
+ }, []);
72
+ return current.proxy;
73
+ }
74
+
75
+ //#endregion
76
+ //#region src/context.ts
77
+ let shared;
78
+ /**
79
+ * Lazily-created context carrying the active {@link Context} down the tree.
80
+ * Lazy because the framework's `createContext` arrives via {@link Runtime},
81
+ * which an adapter's entry populates at load - after this module evaluates.
82
+ */
83
+ function Layers() {
84
+ return shared || (shared = Runtime.createContext(Context$1.root));
85
+ }
86
+ /** Read the ambient {@link Context} from the nearest Layers provider. */
87
+ function useAmbient() {
88
+ return Runtime.useContext(Layers());
89
+ }
90
+ /** Wrap `children` in a {@link Layers} provider carrying `context` down the tree. */
91
+ function createProvider(context, children) {
92
+ return Runtime.createElement(Layers().Provider, {
93
+ value: context,
94
+ children
95
+ });
96
+ }
97
+ Object.defineProperty(Component, "contextType", {
98
+ configurable: true,
99
+ get: Layers
100
+ });
101
+ const _get = Context$1.get;
102
+ Context$1.get = (state) => {
103
+ if (!state) try {
104
+ return useAmbient();
105
+ } catch {}
106
+ return _get(state);
107
+ };
108
+ function Consumer(props) {
109
+ return props.for.get((i) => props.children(i));
110
+ }
111
+ function Provider({ children, fallback, name, ...props }) {
112
+ const ambient = useAmbient();
113
+ return createProvider(useHook((returns) => {
114
+ const context = new Context$1(ambient);
115
+ const fresh = [];
116
+ let applied;
117
+ let solo;
118
+ returns(({ is, for: input, ...rest }) => {
119
+ if (input !== applied) {
120
+ const single = State.is(input) || input instanceof State;
121
+ applied = input;
122
+ solo = void 0;
123
+ context.set(input, (state, owned) => {
124
+ if (single) solo = state;
125
+ if (owned) fresh.push(state);
126
+ if (is) is(state);
127
+ });
128
+ }
129
+ if (solo && Object.keys(rest).length) solo.set(rest);
130
+ return context;
131
+ });
132
+ return () => {
133
+ const release = fresh.map((state) => state.mount?.());
134
+ return () => {
135
+ for (const done of release) if (typeof done == "function") done();
136
+ context.pop();
137
+ };
138
+ };
139
+ })(props), fallback !== void 0 ? Runtime.createElement(Runtime.Suspense, {
140
+ fallback,
141
+ name
142
+ }, children) : children);
143
+ }
144
+
145
+ //#endregion
146
+ //#region src/component.ts
147
+ Object.defineProperties(Component.prototype, {
148
+ state: {
149
+ set() {},
150
+ get: Component.prototype.get
151
+ },
152
+ context: { set: bootstrap }
153
+ });
154
+ Object.defineProperty(Component, "use", {
155
+ configurable: true,
156
+ value() {
157
+ throw new Error(`${this} is a Component - render as an element instead of calling use().`);
158
+ }
159
+ });
160
+ /**
161
+ * `State.on` handler that prepares a Component's prototype at bootstrap, before
162
+ * mvc classifies its members:
163
+ *
164
+ * - On the root Component, host own-property keys are trapped so each lands as a
165
+ * plain own property (out of observed state); each adapter assigns its own set.
166
+ * - capitalized methods are rewritten into subcomponents as non-configurable
167
+ * getters, so bootstrap skips them too.
168
+ *
169
+ * (Sealing `render` as the content-render seam is handled by core itself.)
170
+ *
171
+ * `before` covers the per-instance case: a capitalized function assigned as an
172
+ * instance field (e.g. `Sidebar = Sidebar` to inject or override one), promoted
173
+ * before `observe` so it is not mistaken for reactive state.
174
+ */
175
+ Component.on({
176
+ type(type) {
177
+ if (type === Component) for (const key of Runtime.ignore) Object.defineProperty(Component.prototype, key, { set(value) {
178
+ Object.defineProperty(this, key, {
179
+ value,
180
+ writable: true
181
+ });
182
+ } });
183
+ subcomponents(type.prototype);
184
+ },
185
+ before(self) {
186
+ subcomponents(self, true);
187
+ }
188
+ });
189
+ function bootstrap(context) {
190
+ context = context.push();
191
+ context.set(this, () => () => this.set(null));
192
+ Object.defineProperties(this, {
193
+ context: {
194
+ get: () => context,
195
+ set() {}
196
+ },
197
+ render: { value: render(this, context) }
198
+ });
199
+ this.set(null, () => {
200
+ Object.defineProperty(this, "props", {
201
+ value: this.props,
202
+ writable: true
203
+ });
204
+ });
205
+ }
206
+ /**
207
+ * Wrap a content element in its context provider, a Suspense boundary (unless
208
+ * `fallback` is `false`) and, when `catch` is set, the host error boundary.
209
+ */
210
+ function createFrame(from, context, children) {
211
+ const { createElement } = Runtime;
212
+ if (from.fallback !== false) children = createElement(Runtime.Suspense, {
213
+ fallback: from.fallback,
214
+ name: String(from)
215
+ }, children);
216
+ children = createProvider(context, children);
217
+ return from.catch ? createElement(Runtime.ErrorBoundary, {
218
+ self: from,
219
+ children
220
+ }) : children;
221
+ }
222
+ /**
223
+ * Ownership host for `<Component/>`: React owns the instance, so its render
224
+ * threads the bootstrap-pushed context through `Runtime.dedupe` (React stacks
225
+ * render attempts) and tears that context down - destroying the instance - on
226
+ * unmount.
227
+ */
228
+ function render(from, context) {
229
+ const { createElement } = Runtime;
230
+ const { commit, remove } = Runtime.dedupe(from, context);
231
+ const self = from;
232
+ const content = from.render;
233
+ const Render = () => content.call(from, from.props);
234
+ const Component = () => {
235
+ from = useHook((refresh) => {
236
+ if (observer(from) !== null) watch(from, refresh);
237
+ return () => {
238
+ const release = self.mount?.();
239
+ commit();
240
+ return () => {
241
+ if (typeof release == "function") release();
242
+ remove();
243
+ context.pop();
244
+ };
245
+ };
246
+ }) || from;
247
+ return createFrame(from, context, createElement(Render));
248
+ };
249
+ return () => createElement(Component);
250
+ }
251
+ /** Rewrite each own capitalized function on `target` into a subcomponent. */
252
+ function subcomponents(target, configurable) {
253
+ for (const key of Object.getOwnPropertyNames(target)) {
254
+ if (!/^[A-Z]/.test(key)) continue;
255
+ const { value } = Object.getOwnPropertyDescriptor(target, key);
256
+ if (typeof value != "function") continue;
257
+ Object.defineProperty(target, key, {
258
+ configurable,
259
+ get() {
260
+ const owner = this.is;
261
+ let render = unbind(value);
262
+ const Component = (props) => render.call(useHook((set) => {
263
+ const release = watch(owner, set);
264
+ return () => release;
265
+ }) || owner, props);
266
+ Object.defineProperty(owner, key, {
267
+ configurable: true,
268
+ get: () => Component,
269
+ set(fn) {
270
+ render = fn;
271
+ }
272
+ });
273
+ return Component;
274
+ }
275
+ });
276
+ }
277
+ }
278
+
279
+ //#endregion
280
+ export { Runtime as a, useHook as c, Provider as i, Consumer as n, use as o, Context$1 as r, useFactory as s, createFrame as t };
281
+ //# sourceMappingURL=component-fEqgY0Wy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"component-fEqgY0Wy.js","names":["Context"],"sources":["../src/runtime.ts","../src/context.ts","../src/component.ts"],"sourcesContent":["import { event, watch, observer } from '@expressive/mvc/observable';\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\n/**\n * Mount-effect with a refreshable return value, safe under React StrictMode.\n *\n * @param callback Setup handler, run on creation; receives a setter and returns\n * a mount handler, which in turn returns a cleanup. All three share this\n * hook's render counter, so a StrictMode remount repeats none of them.\n * @returns Latest value published via the setter (`undefined` until set).\n */\nexport function useHook<T = void>(\n callback: (refresh: (next: T) => void) => () => (() => void) | void\n) {\n const { current } = Runtime.useRef(\n { rendered: 0 } as {\n rendered: number;\n mounted?: boolean;\n pending?: boolean;\n commit?: () => (() => void) | void;\n release?: (() => void) | 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.commit = 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\n if (current.commit) {\n current.release = current.commit();\n current.commit = undefined;\n }\n\n if (current.pending) {\n current.pending = false;\n current.update!((x) => x + 1);\n }\n\n return () => {\n if (--current.rendered <= 0) current.release?.();\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, Component } from '@expressive/mvc';\nimport type { UseState } 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 createProvider(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 /**\n * Runs for each State registered by this Provider. Return value is ignored -\n * to run teardown with a State, use `state.set(null, callback)`.\n */\n type ForEach<T> = (state: T) => 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\ntype Digest<T extends State> = (props: Provider.Props<T>) => Context;\n\nfunction Provider<T extends State>({\n children,\n fallback,\n name,\n ...props\n}: Provider.Props<T>) {\n const ambient = useAmbient();\n const digest: Digest<T> = useHook((returns) => {\n const context = new Context(ambient);\n const fresh: State[] = [];\n\n let applied: Context.Accept<T> | undefined;\n let solo: State | undefined;\n\n returns(({ is, for: input, ...rest }) => {\n if (input !== applied) {\n const single = State.is(input) || input instanceof State;\n\n applied = input;\n solo = undefined;\n\n context.set(input, (state, owned) => {\n if (single) solo = state;\n if (owned) fresh.push(state);\n if (is) is(state);\n });\n }\n\n if (solo && Object.keys(rest).length) solo.set(rest);\n\n return context;\n });\n\n return () => {\n const release = fresh.map((state) => (state as UseState).mount?.());\n\n return () => {\n for (const done of release) if (typeof done == 'function') done();\n context.pop();\n };\n };\n });\n\n return createProvider(\n digest(props),\n fallback !== undefined\n ? Runtime.createElement(Runtime.Suspense, { fallback, name }, children)\n : children\n );\n}\n\nexport { Consumer, Provider, Context, createProvider };\n","import { Component, unbind } from '@expressive/mvc';\nimport { watch, observer } from '@expressive/mvc/observable';\nimport { createProvider, type Context } from './context';\nimport { Runtime, useHook } from './runtime';\n\ndeclare module '@expressive/mvc' {\n namespace Component {\n /**\n * Not available - a Component is rendered, not a hook.\n * Render it with `<Component />` or `{component}`.\n * For a bare instance use `Component.new()`.\n */\n const use: never;\n }\n\n interface Component {\n /**\n * Optional hook called once this Component commits. Return a function to\n * run when it unmounts.\n *\n * Not called during server render, nor for an instance placed as\n * `{component}` - a placement does not own what it renders. Client-only\n * effects belong here; setup which must accompany the instance itself\n * belongs in `new()`.\n */\n mount?(): (() => void) | void;\n\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\nObject.defineProperty(Component, 'use', {\n configurable: true,\n value() {\n throw new Error(\n `${this} is a Component - render as an element instead of calling use().`\n );\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 * Wrap a content element in its context provider, a Suspense boundary (unless\n * `fallback` is `false`) and, when `catch` is set, the host error boundary.\n */\nfunction createFrame(from: Component, context: Context, children: unknown) {\n const { createElement } = Runtime;\n\n if(from.fallback !== false)\n children = createElement(\n Runtime.Suspense,\n { fallback: from.fallback, name: String(from) },\n children\n )\n\n children = createProvider(context, children);\n\n return from.catch\n ? createElement(Runtime.ErrorBoundary, { self: from, children })\n : children;\n}\n\n/**\n * Ownership host for `<Component/>`: React owns the instance, so its render\n * threads the bootstrap-pushed context through `Runtime.dedupe` (React stacks\n * render attempts) and tears that context down - destroying the instance - on\n * unmount.\n */\nfunction render(from: Component, context: Context) {\n const { createElement } = Runtime;\n const { commit, remove } = Runtime.dedupe(from, context);\n\n const self = from;\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) watch(from, refresh);\n\n return () => {\n const release = self.mount?.();\n\n commit();\n\n return () => {\n if (typeof release == 'function') release();\n remove();\n context.pop();\n };\n };\n }) || from;\n\n return createFrame(from, context, createElement(Render));\n };\n\n return () => createElement(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) => {\n const release = watch(owner, set);\n return () => release;\n }) || 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\nexport { createFrame };\n"],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ import { a as Runtime, c as useHook, r as Context$1, s as useFactory, t as createFrame } from "./component-fEqgY0Wy.js";
2
+ import { Component } from "@expressive/mvc";
3
+ import { observer, watch } from "@expressive/mvc/observable";
4
+
5
+ //#region src/element.ts
6
+ let template;
7
+ /**
8
+ * Borrow a host element's descriptors so `self` passes as a React element.
9
+ * `props` false keeps the target's own `props` (Component supplies its own);
10
+ * an object installs it as the element's props (collections have none).
11
+ */
12
+ function seam(self, props, type, key) {
13
+ if (!template) template = Runtime.createElement("template");
14
+ const descriptors = Object.getOwnPropertyDescriptors(template);
15
+ const store = descriptors._store?.value;
16
+ if (props === false) delete descriptors.props;
17
+ if (store) descriptors._store.value = Object.create(Object.getPrototypeOf(store), Object.getOwnPropertyDescriptors(store));
18
+ Object.defineProperties(self, {
19
+ ...descriptors,
20
+ $$typeof: { value: template.$$typeof },
21
+ ...props ? { props: { value: props } } : void 0,
22
+ key: { value: key },
23
+ type: { value: type }
24
+ });
25
+ return template.$$typeof;
26
+ }
27
+ Object.defineProperty(Component.prototype, "$$typeof", { get() {
28
+ const self = this.is;
29
+ return seam(self, false, Element.bind(self), self.key);
30
+ } });
31
+ function Element() {
32
+ const outer = Context$1.get();
33
+ return useFactory(() => {
34
+ let from = this;
35
+ const context = outer.push(this);
36
+ const Content = () => from.render(from.props);
37
+ return () => {
38
+ from = useHook((refresh) => {
39
+ if (observer(this) !== null) watch(this, refresh);
40
+ return () => () => context.pop();
41
+ }) || this;
42
+ return createFrame(from, context, Runtime.createElement(Content));
43
+ };
44
+ })();
45
+ }
46
+
47
+ //#endregion
48
+ export { seam as t };
49
+ //# sourceMappingURL=element-CLcyiJ09.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"element-CLcyiJ09.js","names":["Context"],"sources":["../src/element.ts"],"sourcesContent":["import { Component } from '@expressive/mvc';\nimport { watch, observer } from '@expressive/mvc/observable';\nimport { Context } from './context';\nimport { Runtime, useFactory, useHook } from './runtime';\nimport { createFrame } from './component';\n\ndeclare module '@expressive/mvc' {\n interface Component {\n /** @deprecated Only to satisfy host JSX. */\n readonly type: typeof Component;\n }\n}\n\nlet template: any;\n\n/**\n * Borrow a host element's descriptors so `self` passes as a React element.\n * `props` false keeps the target's own `props` (Component supplies its own);\n * an object installs it as the element's props (collections have none).\n */\nexport function seam(\n self: object,\n props: object | false,\n type: Function,\n key: unknown\n) {\n if (!template) template = Runtime.createElement('template');\n\n const descriptors = Object.getOwnPropertyDescriptors(template);\n const store = descriptors._store?.value;\n\n if (props === false) delete (descriptors as any).props;\n\n if (store)\n descriptors._store.value = Object.create(\n Object.getPrototypeOf(store),\n Object.getOwnPropertyDescriptors(store)\n );\n\n Object.defineProperties(self, {\n ...descriptors,\n $$typeof: { value: template.$$typeof },\n ...(props ? { props: { value: props } } : undefined),\n key: { value: key },\n type: { value: type }\n });\n\n return template.$$typeof;\n}\n\nObject.defineProperty(Component.prototype, '$$typeof', {\n get(this: Component) {\n const self = this.is;\n return seam(self, false, Element.bind(self), self.key);\n }\n});\n\nfunction Element(this: Component){\n const outer = Context.get();\n const render = useFactory(() => {\n let from = this;\n const context = outer.push(this);\n const Content = () => from.render(from.props);\n\n return () => {\n from = useHook<Component>((refresh) => {\n if (observer(this) !== null) watch(this, refresh);\n return () => () => context.pop();\n }) || this;\n\n return createFrame(from, context, Runtime.createElement(Content));\n };\n });\n\n return render();\n}\n"],"mappings":";;;;;AAaA,IAAI;;;;;;AAOJ,SAAgB,KACd,MACA,OACA,MACA,KACA;AACA,KAAI,CAAC,SAAU,YAAW,QAAQ,cAAc,WAAW;CAE3D,MAAM,cAAc,OAAO,0BAA0B,SAAS;CAC9D,MAAM,QAAQ,YAAY,QAAQ;AAElC,KAAI,UAAU,MAAO,QAAQ,YAAoB;AAEjD,KAAI,MACF,aAAY,OAAO,QAAQ,OAAO,OAChC,OAAO,eAAe,MAAM,EAC5B,OAAO,0BAA0B,MAAM,CACxC;AAEH,QAAO,iBAAiB,MAAM;EAC5B,GAAG;EACH,UAAU,EAAE,OAAO,SAAS,UAAU;EACtC,GAAI,QAAQ,EAAE,OAAO,EAAE,OAAO,OAAO,EAAE,GAAG;EAC1C,KAAK,EAAE,OAAO,KAAK;EACnB,MAAM,EAAE,OAAO,MAAM;EACtB,CAAC;AAEF,QAAO,SAAS;;AAGlB,OAAO,eAAe,UAAU,WAAW,YAAY,EACrD,MAAqB;CACnB,MAAM,OAAO,KAAK;AAClB,QAAO,KAAK,MAAM,OAAO,QAAQ,KAAK,KAAK,EAAE,KAAK,IAAI;GAEzD,CAAC;AAEF,SAAS,UAAwB;CAC/B,MAAM,QAAQA,UAAQ,KAAK;AAgB3B,QAfe,iBAAiB;EAC9B,IAAI,OAAO;EACX,MAAM,UAAU,MAAM,KAAK,KAAK;EAChC,MAAM,gBAAgB,KAAK,OAAO,KAAK,MAAM;AAE7C,eAAa;AACX,UAAO,SAAoB,YAAY;AACrC,QAAI,SAAS,KAAK,KAAK,KAAM,OAAM,MAAM,QAAQ;AACjD,uBAAmB,QAAQ,KAAK;KAChC,IAAI;AAEN,UAAO,YAAY,MAAM,SAAS,QAAQ,cAAc,QAAQ,CAAC;;GAEnE,EAEa"}
package/dist/has.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ import { has } from "@expressive/mvc";
2
+ export { has };
package/dist/has.js ADDED
@@ -0,0 +1,22 @@
1
+ import { o as use } from "./component-fEqgY0Wy.js";
2
+ import { t as seam } from "./element-CLcyiJ09.js";
3
+ import { has } from "@expressive/mvc";
4
+
5
+ //#region src/has.ts
6
+ for (const Collection of [has.List, has.Pool]) Object.defineProperty(Collection.prototype, "$$typeof", { get() {
7
+ const self = source(this);
8
+ return seam(self, {}, Members.bind(self), null);
9
+ } });
10
+ function Members() {
11
+ return [...use(this)];
12
+ }
13
+ /** Resolve a collection's canonical instance behind any subscriber proxies. */
14
+ function source(from) {
15
+ let self = from;
16
+ for (let proto = Object.getPrototypeOf(self); proto instanceof has.List || proto instanceof has.Pool; proto = Object.getPrototypeOf(self)) self = proto;
17
+ return self;
18
+ }
19
+
20
+ //#endregion
21
+ export { has };
22
+ //# sourceMappingURL=has.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"has.js","names":[],"sources":["../src/has.ts"],"sourcesContent":["import { has } from '@expressive/mvc';\nimport { use } from './runtime';\nimport { seam } from './element';\n\nfor (const Collection of [has.List, has.Pool])\n Object.defineProperty(Collection.prototype, '$$typeof', {\n get() {\n const self = source(this) as has.List<unknown>;\n return seam(self, {}, Members.bind(self), null);\n }\n });\n\nfunction Members(this: has.List<unknown> | has.Pool<unknown>) {\n return [...use(this)];\n}\n\n/** Resolve a collection's canonical instance behind any subscriber proxies. */\nfunction source(from: object) {\n let self = from;\n\n for (\n let proto = Object.getPrototypeOf(self);\n proto instanceof has.List || proto instanceof has.Pool;\n proto = Object.getPrototypeOf(self)\n )\n self = proto;\n\n return self;\n}\n\nexport { has };\n"],"mappings":";;;;;AAIA,KAAK,MAAM,cAAc,CAAC,IAAI,MAAM,IAAI,KAAK,CAC3C,QAAO,eAAe,WAAW,WAAW,YAAY,EACtD,MAAM;CACJ,MAAM,OAAO,OAAO,KAAK;AACzB,QAAO,KAAK,MAAM,EAAE,EAAE,QAAQ,KAAK,KAAK,EAAE,KAAK;GAElD,CAAC;AAEJ,SAAS,UAAqD;AAC5D,QAAO,CAAC,GAAG,IAAI,KAAK,CAAC;;;AAIvB,SAAS,OAAO,MAAc;CAC5B,IAAI,OAAO;AAEX,MACE,IAAI,QAAQ,OAAO,eAAe,KAAK,EACvC,iBAAiB,IAAI,QAAQ,iBAAiB,IAAI,MAClD,QAAQ,OAAO,eAAe,KAAK,CAEnC,QAAO;AAET,QAAO"}
package/dist/index.d.ts CHANGED
@@ -1,7 +1,22 @@
1
- import { Component, Context, def, get, hot, ref, set } from "@expressive/mvc";
1
+ import { has } from "./has.js";
2
+ import { map } from "./map.js";
3
+ import { Component as Component$1, Context, def, get, ref, set } from "@expressive/mvc";
2
4
  import { JSX, ReactNode } from "react";
3
5
  import { Consumer, Provider, State, State as adapter_default, use } from "./adapter";
4
6
 
7
+ //#region src/element.d.ts
8
+ declare module '@expressive/mvc' {
9
+ interface Component {
10
+ /** @deprecated Only to satisfy host JSX. */
11
+ readonly type: typeof Component;
12
+ }
13
+ }
14
+ /**
15
+ * Borrow a host element's descriptors so `self` passes as a React element.
16
+ * `props` false keeps the target's own `props` (Component supplies its own);
17
+ * an object installs it as the element's props (collections have none).
18
+ */
19
+ //#endregion
5
20
  //#region src/jsx-runtime.d.ts
6
21
  declare module '@expressive/mvc/jsx-runtime' {
7
22
  interface Host {
@@ -10,5 +25,5 @@ declare module '@expressive/mvc/jsx-runtime' {
10
25
  }
11
26
  }
12
27
  //#endregion
13
- export { Component, Consumer, Context, Provider, State, def, adapter_default as default, get, hot, ref, set, use };
28
+ export { Component$1 as Component, Consumer, Context, Provider, State, def, adapter_default as default, get, has, map, ref, set, use };
14
29
  //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -1,4 +1,7 @@
1
- import { Component, Component as Component$1, Context, def, get, hot, ref, set } from "@expressive/mvc";
1
+ import "./component-fEqgY0Wy.js";
2
+ import { has } from "./has.js";
3
+ import { map } from "./map.js";
4
+ import { Component, Component as Component$1, Context, def, get, ref, set } from "@expressive/mvc";
2
5
  import React, { Children, Suspense, createContext, createElement, isValidElement, useContext, useEffect, useRef, useState } from "react";
3
6
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
4
7
  import { host } from "@expressive/mvc/jsx-runtime";
@@ -105,5 +108,5 @@ Object.assign(Runtime, {
105
108
  });
106
109
 
107
110
  //#endregion
108
- export { Component, Consumer, Context, Provider, State, def, adapter_default as default, get, hot, ref, set, use };
111
+ export { Component, Consumer, Context, Provider, State, def, adapter_default as default, get, has, map, ref, set, use };
109
112
  //# 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 './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, 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"}
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 './element';\nimport './jsx-runtime';\n\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, def, get, ref, set } from '@expressive/mvc';\nexport { has } from './has';\nexport { map } from './map';\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;;;;;;ACrE3B,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/dist/map.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ import { map } from "@expressive/mvc";
2
+ export { map };
package/dist/map.js ADDED
@@ -0,0 +1,22 @@
1
+ import { o as use } from "./component-fEqgY0Wy.js";
2
+ import { t as seam } from "./element-CLcyiJ09.js";
3
+ import { map } from "@expressive/mvc";
4
+
5
+ //#region src/map.ts
6
+ Object.defineProperty(map.Managed.prototype, "$$typeof", { get() {
7
+ const self = source(this);
8
+ return seam(self, {}, Values.bind(self), null);
9
+ } });
10
+ function Values() {
11
+ return [...use(this).values()];
12
+ }
13
+ /** Resolve a map's canonical instance behind any subscriber proxies. */
14
+ function source(from) {
15
+ let self = from;
16
+ for (let proto = Object.getPrototypeOf(self); proto instanceof map.Managed; proto = Object.getPrototypeOf(self)) self = proto;
17
+ return self;
18
+ }
19
+
20
+ //#endregion
21
+ export { map };
22
+ //# sourceMappingURL=map.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"map.js","names":[],"sources":["../src/map.ts"],"sourcesContent":["import { map } from '@expressive/mvc';\nimport { use } from './runtime';\nimport { seam } from './element';\n\nObject.defineProperty(map.Managed.prototype, '$$typeof', {\n get() {\n const self = source(this) as map.Managed<unknown, unknown>;\n return seam(self, {}, Values.bind(self), null);\n }\n});\n\nfunction Values(this: map.Managed<unknown, unknown>) {\n return [...use(this).values()];\n}\n\n/** Resolve a map's canonical instance behind any subscriber proxies. */\nfunction source(from: object) {\n let self = from;\n\n for (\n let proto = Object.getPrototypeOf(self);\n proto instanceof map.Managed;\n proto = Object.getPrototypeOf(self)\n )\n self = proto;\n\n return self;\n}\n\nexport { map };\n"],"mappings":";;;;;AAIA,OAAO,eAAe,IAAI,QAAQ,WAAW,YAAY,EACvD,MAAM;CACJ,MAAM,OAAO,OAAO,KAAK;AACzB,QAAO,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,KAAK,EAAE,KAAK;GAEjD,CAAC;AAEF,SAAS,SAA4C;AACnD,QAAO,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC;;;AAIhC,SAAS,OAAO,MAAc;CAC5B,IAAI,OAAO;AAEX,MACE,IAAI,QAAQ,OAAO,eAAe,KAAK,EACvC,iBAAiB,IAAI,SACrB,QAAQ,OAAO,eAAe,KAAK,CAEnC,QAAO;AAET,QAAO"}
package/package.json CHANGED
@@ -1,11 +1,16 @@
1
1
  {
2
2
  "name": "@expressive/react",
3
- "version": "0.81.0",
4
- "description": "Use classes to define state in React!",
3
+ "version": "0.83.0",
4
+ "description": "Class-based reactive state for React. Define models as plain classes; components update when the values they read change.",
5
5
  "keywords": [
6
6
  "expressive",
7
+ "mvc",
7
8
  "react",
8
- "state"
9
+ "state",
10
+ "state-management",
11
+ "reactive",
12
+ "observable",
13
+ "model"
9
14
  ],
10
15
  "license": "MIT",
11
16
  "author": {
@@ -27,7 +32,9 @@
27
32
  "./src/jsx-runtime.ts",
28
33
  "./src/state.get.ts",
29
34
  "./src/state.use.ts",
30
- "./src/component.ts"
35
+ "./src/component.ts",
36
+ "./src/map.ts",
37
+ "./src/has.ts"
31
38
  ],
32
39
  "main": "dist/index.js",
33
40
  "types": "dist/index.d.ts",
@@ -52,7 +59,7 @@
52
59
  "test": "tsc --noEmit && bun test --coverage --only-failures"
53
60
  },
54
61
  "dependencies": {
55
- "@expressive/mvc": "^0.80.0"
62
+ "@expressive/mvc": "^0.82.0"
56
63
  },
57
64
  "devDependencies": {
58
65
  "@testing-library/react": "^16.3.0",