@expressive/react 0.94.1 → 0.94.3

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,12 +6,12 @@
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
- <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>
9
+ <a href="https://github.com/gabeklein/expressive/actions/workflows/coverage.yml"><img alt="Coverage" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fgabeklein%2Fexpressive%2Fbadges%2Fcoverage.json"></a>
10
10
  </p>
11
11
 
12
12
  ---
13
13
 
14
- The React adapter for [Expressive MVC](https://github.com/gabeklein/expressive-mvc). Define state as a class, render it as a component, and reads automatically subscribe - components re-render only when accessed values change.
14
+ The React adapter for [Expressive MVC](https://github.com/gabeklein/expressive). Define state as a class, render it as a component, and reads automatically subscribe - components re-render only when accessed values change.
15
15
 
16
16
  ```bash
17
17
  npm install @expressive/mvc @expressive/react
@@ -100,7 +100,7 @@ class DarkModeSwitch extends Toggle {
100
100
  }
101
101
  ```
102
102
 
103
- The base owns behavior and structure; subclasses author only the rendering. Override a subcomponent as a **method** when it takes no props, or as an **arrow field** when you want its props type inferred from the base - which is how `@expressive/router`'s [`NavLinks`](https://github.com/gabeklein/expressive-mvc/blob/main/packages/router/README.md#generated-navigation) exposes its overridable `Item` / `List` / `Group` members.
103
+ The base owns behavior and structure; subclasses author only the rendering. Override a subcomponent as a **method** when it takes no props, or as an **arrow field** when you want its props type inferred from the base - which is how `@expressive/router`'s [`NavLinks`](https://github.com/gabeklein/expressive/blob/main/packages/router/README.md#generated-navigation) exposes its overridable `Item` / `List` / `Group` members.
104
104
 
105
105
  A subclass `render()` replaces the base's like any method - `super.render(props)` wraps it.
106
106
 
@@ -207,7 +207,7 @@ function Profile() {
207
207
  - **`<Component for={Model}>`** - explicit hierarchical dependency injection.
208
208
  - **Suspense & error boundaries** - async values suspend; `catch()` handles child errors.
209
209
 
210
- Full guide and API reference → **[github.com/gabeklein/expressive-mvc](https://github.com/gabeklein/expressive-mvc)**
210
+ Full guide and API reference → **[github.com/gabeklein/expressive](https://github.com/gabeklein/expressive)**
211
211
 
212
212
  ## License
213
213
 
package/dist/adapter.js CHANGED
@@ -1,4 +1,4 @@
1
- import { r as Runtime } from "./chunk-state.get-Buie72pM.js";
1
+ import { r as Runtime } from "./chunk-state.get-DlBih7tL.js";
2
2
  import { Model } from "@expressive/mvc";
3
3
 
4
4
  export { Model, Runtime };
@@ -274,12 +274,23 @@ function render(from, context) {
274
274
  };
275
275
  return () => createElement(Component);
276
276
  }
277
- /** Rewrite each own capitalized function on `target` into a subcomponent. */
277
+ function wrappable(value) {
278
+ return typeof value == "function" && Object.getOwnPropertyDescriptor(value, "prototype")?.writable !== false;
279
+ }
280
+ function assign(target, key, value) {
281
+ Object.defineProperty(target, key, {
282
+ value,
283
+ writable: true,
284
+ enumerable: true,
285
+ configurable: true
286
+ });
287
+ }
288
+ /** Rewrite each own capitalized function on `target` into a subcomponent; a class renders as itself. */
278
289
  function subcomponents(target) {
279
290
  for (const key of Object.getOwnPropertyNames(target)) {
280
291
  if (!/^[A-Z]/.test(key)) continue;
281
292
  const { value } = Object.getOwnPropertyDescriptor(target, key);
282
- if (typeof value != "function") continue;
293
+ if (!wrappable(value)) continue;
283
294
  Object.defineProperty(target, key, {
284
295
  configurable: true,
285
296
  get() {
@@ -290,18 +301,14 @@ function subcomponents(target) {
290
301
  configurable: true,
291
302
  get: () => Component,
292
303
  set(fn) {
293
- render = fn;
304
+ if (wrappable(fn)) render = fn;
305
+ else assign(owner, key, fn);
294
306
  }
295
307
  });
296
308
  return Component;
297
309
  },
298
310
  set(value) {
299
- Object.defineProperty(this, key, {
300
- value,
301
- writable: true,
302
- enumerable: true,
303
- configurable: true
304
- });
311
+ assign(this, key, value);
305
312
  subcomponents(this);
306
313
  }
307
314
  });
@@ -402,4 +409,4 @@ function use(local, compute) {
402
409
 
403
410
  //#endregion
404
411
  export { useWatch as a, useFactory as i, useAmbient as n, weak as o, Runtime as r, createFrame as t };
405
- //# sourceMappingURL=chunk-state.get-Buie72pM.js.map
412
+ //# sourceMappingURL=chunk-state.get-DlBih7tL.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"chunk-state.get-Buie72pM.js","names":[],"sources":["../src/runtime.ts","../src/context.ts","../src/component.ts","../src/state.get.ts"],"sourcesContent":["import type { Component } from '@expressive/mvc';\nimport { watch } from '@expressive/mvc/observable';\nimport { pending } from '@expressive/mvc';\nimport type { Context } from './context';\n\ninterface Settle {\n waiting?: (() => void)[];\n claim(): void;\n release(): void;\n}\n\ninterface Setup {\n rendered: number;\n revision: number;\n mounted?: boolean;\n fresh?: boolean;\n getRevision?: () => number;\n lapsed?: boolean;\n commit?: () => (() => void) | void;\n release?: (() => void) | void;\n teardown?: () => void;\n}\n\ninterface Hook<T> extends Setup {\n queued?: boolean;\n update?: Weak<(next: (previous: number) => number) => void>;\n output: T;\n}\n\ninterface Weak<T> {\n deref(): T | undefined;\n}\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 /** Non-urgent bracket a subscriber replays through; absent where the host\n * cannot defer, which keeps normal timing. */\n startTransition?(work: () => void): void;\n /** Consumed for pre-commit revision validation; absent where commits\n * cannot interleave with writes. */\n useSyncExternalStore?(\n subscribe: (notify: () => void) => () => void,\n getSnapshot: () => number,\n getServerSnapshot?: () => number\n ): number;\n /** Per-render-attempt lifecycle; absent where render attempts do not stack. */\n dedupe?(from: Component, context: Context): { commit(): void; remove(): void };\n /** Whether the host is certainly not rendering, so a hook probe would only throw - and may log. `undefined` when the host cannot tell. */\n idle(): boolean | undefined;\n /** Host error-boundary component, wrapping a Component whose `catch` is set. */\n ErrorBoundary: unknown;\n Suspense: any;\n};\n\nconst noop = () => () => {};\n\nexport function useFactory<T extends object>(factory: () => T) {\n const ref = Runtime.useRef<T | null>(null);\n return ref.current || (ref.current = factory());\n}\n\n/**\n * Returns a claim on the update being replayed, held until this hook commits\n * carrying it - or until unmount, where it never will. Keyed on `tick` so an\n * urgent commit in the meantime, which leaves the deferred update queued, does\n * not release it.\n */\nexport function useSettle(tick: number) {\n const ref = Runtime.useRef<Settle | null>(null);\n const settle = ref.current || (ref.current = {\n claim() {\n const held = pending();\n\n if (held) (settle.waiting ||= []).push(held);\n },\n release() {\n const { waiting } = settle;\n\n if (!waiting) return;\n settle.waiting = undefined;\n\n for (const held of waiting) held();\n }\n });\n\n Runtime.useEffect(() => {\n settle.release();\n return settle.release;\n }, [tick]);\n\n return settle.claim;\n}\n\n/**\n * Run `init` once for the life of a hook and clean up when it unmounts, safe\n * under React StrictMode - a remount shares the render counter, so neither the\n * setup nor its cleanup repeats. A cleanup following a render not yet committed\n * - Fast Refresh re-running effects - defers a microtask, and is dropped if the\n * effect runs again. `reset` invalidates the rendered value so in-flight render\n * attempts revalidate.\n *\n * @returns The hook's own record, plus the render counter and its setter.\n */\nexport function useSetup<T extends Setup>(\n init: (self: T, reset: () => void) => () => (() => void) | void,\n teardown?: () => void\n) {\n const { current } = Runtime.useRef({ rendered: 0, revision: 0 } as T);\n\n const [tick, update] = Runtime.useState(() => {\n if (!current.rendered)\n current.commit = init(current, () => {\n current.revision++;\n });\n\n return current.rendered++;\n });\n\n useReap(current, teardown);\n\n const getRevision = (current.getRevision ||= () => current.revision);\n\n current.fresh = true;\n\n Runtime.useSyncExternalStore?.(noop, getRevision, getRevision);\n\n Runtime.useEffect(() => {\n current.fresh = false;\n });\n\n Runtime.useEffect(() => {\n current.mounted = true;\n current.lapsed = false;\n\n if (current.commit) {\n current.release = current.commit();\n current.commit = undefined;\n }\n\n return () => {\n if (!current.fresh) {\n if (--current.rendered <= 0) release(current);\n return;\n }\n\n current.lapsed = true;\n\n queueMicrotask(() => {\n if (current.lapsed) release(current);\n });\n }\n }, []);\n\n return [current, tick, update] as const;\n}\n\nfunction release(setup: Setup) {\n setup.release?.();\n setup.teardown?.();\n}\n\nlet reaper: FinalizationRegistry<Setup> | null | undefined;\n\nfunction useReap(setup: Setup, teardown?: () => void) {\n const token = Runtime.useRef<object | null>(null);\n\n if (!teardown || setup.teardown) return;\n\n setup.teardown = teardown;\n\n if (reaper === undefined)\n reaper = typeof FinalizationRegistry == 'function'\n ? new FinalizationRegistry((setup) => setup.mounted || setup.teardown!())\n : null;\n\n reaper?.register((token.current = {}), setup);\n}\n\nexport function weak<T extends object>(value: T): Weak<T> {\n return typeof WeakRef == 'function' ? new WeakRef(value) : { deref: () => value };\n}\n\nexport function useWeak<T extends object>(value: T) {\n const ref = Runtime.useRef<Weak<T> | null>(null);\n return (ref.current ||= weak(value));\n}\n\n/**\n * Mount-effect with a refreshable return value. Publishing a value before mount\n * defers the update to it, and one published after claims the update being\n * replayed until this hook commits carrying it.\n *\n * @returns Latest value published via the setter (`undefined` until set).\n */\nexport function useHook<T = void>(\n callback: (\n refresh: (next: T) => void,\n reset: () => void\n ) => () => (() => void) | void,\n teardown?: () => void\n) {\n const [current, tick, update] = useSetup<Hook<T>>((self, reset) => {\n const mount = callback((next) => {\n self.output = next;\n\n if (self.mounted) {\n claim();\n self.update?.deref()!((x) => x + 1);\n }\n else if (self.update) self.queued = true;\n }, reset);\n\n return () => {\n const cleanup = mount();\n\n if (self.queued) {\n self.queued = false;\n self.update!.deref()!((x) => x + 1);\n }\n\n return cleanup;\n };\n }, teardown);\n\n const claim = useSettle(tick);\n\n current.update ||= weak(update);\n\n return current.output;\n}\n\nexport function useWatch<T extends object>(\n from: T,\n mount?: () => (() => void) | void,\n teardown?: () => void\n) {\n return useHook<T>((refresh, reset) => {\n const release = watch(from, (current) => {\n refresh(current);\n\n return (update) => {\n if (update === true) reset();\n };\n }, undefined, Runtime.startTransition);\n\n return () => {\n const cleanup = mount?.();\n\n return () => {\n release();\n if (typeof cleanup == 'function') cleanup();\n };\n };\n }, teardown) ?? from;\n}\n","import { Context, Component } from '@expressive/mvc';\nimport { Runtime } 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\nexport { Context, createProvider, useAmbient };\n","import { Component, unbind } from '@expressive/mvc';\nimport { createProvider, type Context } from './context';\nimport { Runtime, useWatch } from './runtime';\n\ndeclare module '@expressive/mvc' {\n interface Component {\n /** @deprecated Only to satisfy host JSX. Use `this.get(Model)` instead. */\n readonly context: Context;\n /** @deprecated Only to satisfy host JSX. Use `this.get()` instead. */\n readonly state: {};\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.\nconst PLACING = new WeakMap<Component, { placed: Promise<void>; place(): void }>();\n\nObject.defineProperties(Component.prototype, {\n state: {\n set() {},\n get: Component.prototype.get\n },\n context: {\n set: bootstrap\n }\n});\n\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 */\nComponent.on({\n type(type) {\n const render = Object.getOwnPropertyDescriptor(type.prototype, 'render');\n\n if (typeof render?.value == 'function')\n Object.defineProperty(type.prototype, 'render', { ...render, configurable: false });\n\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 subcomponents(type.prototype);\n },\n setup(self) {\n subcomponents(self);\n return PLACING.get(self)?.placed;\n }\n});\n\nfunction bootstrap(this: Component, parent: Context){\n const placing = {} as { placed: Promise<void>; place(): void };\n\n placing.placed = new Promise((resolve) => (placing.place = resolve));\n PLACING.set(this, placing);\n\n const context = parent.push(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.props.catch || 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, dedupe } = Runtime;\n const attempt = dedupe?.(from, context);\n const { is: owner } = from;\n // Read before bootstrap shadows an instance `render` with this host.\n const own = Object.prototype.hasOwnProperty.call(owner, 'render') && owner.render;\n const teardown = () => {\n attempt?.remove();\n context.pop();\n };\n\n const Render = () => (own || Object.getPrototypeOf(owner).render).call(from, from.props);\n const Component = () => {\n from = useWatch(from, () => {\n PLACING.get(owner)!.place();\n attempt?.commit();\n }, teardown);\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) {\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: true,\n get(this: Component) {\n const owner = this.is;\n let render = unbind(value);\n const Component = (props: unknown) =>\n render.call(useWatch(owner), props);\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 set(this: Component, value: unknown) {\n Object.defineProperty(this, key, {\n value,\n writable: true,\n enumerable: true,\n configurable: true\n });\n\n subcomponents(this);\n }\n });\n }\n}\n\nexport { createFrame };\n","import { Model, Context } from '@expressive/mvc';\nimport { observer, watch } from '@expressive/mvc/observable';\nimport { resolver } from '@expressive/mvc/jsx-runtime';\nimport { useAmbient } from './context';\nimport { Runtime, useFactory, useSettle, useSetup, useWeak } from './runtime';\n\nconst normal = resolver((Type, compute) => {\n const idle = Runtime.idle();\n\n if (idle) return normal(Type, compute);\n\n let ambient: Context;\n\n if (idle === undefined)\n try {\n ambient = useAmbient();\n } catch {\n return normal(Type, compute);\n }\n else ambient = useAmbient();\n\n return Type ? use(ambient, compute) : compute(ambient);\n});\n\nfunction use(local: Context, compute: (context: Context) => unknown) {\n const [tick, next] = Runtime.useState(0);\n const claim = useSettle(tick);\n const dispatch = useWeak(next);\n const render = useFactory(() => {\n let latest = compute;\n let mounted = false;\n let pending = false;\n let force!: () => void;\n let target: unknown;\n let value: unknown;\n let unwatch: (() => void) | undefined;\n let thrown: [unknown] | undefined;\n\n function update() {\n pending = false;\n dispatch.deref()!((x) => x + 1);\n }\n\n function observed() {\n if (mounted) {\n claim();\n update();\n }\n else pending = true;\n }\n\n function follow(found: unknown) {\n if (found === target) return;\n\n unwatch?.();\n unwatch = undefined;\n target = value = found;\n\n if (found instanceof Model && observer(found) !== null) {\n let first = true;\n\n unwatch = watch(\n found,\n (current) => {\n value = current;\n\n if (!first) observed();\n first = false;\n\n return (update) => {\n if (update === true) force();\n };\n },\n false,\n Runtime.startTransition\n );\n }\n\n return true;\n }\n\n function release() {\n unfollow();\n unwatch?.();\n unwatch = target = undefined;\n }\n\n let first = true;\n\n const unfollow = watch(local, (ctx) => {\n try {\n if (follow(latest(ctx)) && !first) observed();\n } catch (error) {\n thrown = [error];\n if (!first) observed();\n }\n }, false);\n\n first = false;\n\n if (thrown) {\n unfollow();\n throw thrown[0];\n }\n\n let fresh = true;\n\n return (next: typeof compute) => {\n pending = false;\n useSetup((_self, reset) => {\n force = reset;\n\n return () => {\n mounted = true;\n if (pending) update();\n return release;\n };\n });\n\n if (!fresh) follow((latest = next)(local));\n\n fresh = false;\n\n return value;\n };\n });\n\n return render(compute);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"chunk-state.get-DlBih7tL.js","names":[],"sources":["../src/runtime.ts","../src/context.ts","../src/component.ts","../src/state.get.ts"],"sourcesContent":["import type { Component } from '@expressive/mvc';\nimport { watch } from '@expressive/mvc/observable';\nimport { pending } from '@expressive/mvc';\nimport type { Context } from './context';\n\ninterface Settle {\n waiting?: (() => void)[];\n claim(): void;\n release(): void;\n}\n\ninterface Setup {\n rendered: number;\n revision: number;\n mounted?: boolean;\n fresh?: boolean;\n getRevision?: () => number;\n lapsed?: boolean;\n commit?: () => (() => void) | void;\n release?: (() => void) | void;\n teardown?: () => void;\n}\n\ninterface Hook<T> extends Setup {\n queued?: boolean;\n update?: Weak<(next: (previous: number) => number) => void>;\n output: T;\n}\n\ninterface Weak<T> {\n deref(): T | undefined;\n}\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 /** Non-urgent bracket a subscriber replays through; absent where the host\n * cannot defer, which keeps normal timing. */\n startTransition?(work: () => void): void;\n /** Consumed for pre-commit revision validation; absent where commits\n * cannot interleave with writes. */\n useSyncExternalStore?(\n subscribe: (notify: () => void) => () => void,\n getSnapshot: () => number,\n getServerSnapshot?: () => number\n ): number;\n /** Per-render-attempt lifecycle; absent where render attempts do not stack. */\n dedupe?(from: Component, context: Context): { commit(): void; remove(): void };\n /** Whether the host is certainly not rendering, so a hook probe would only throw - and may log. `undefined` when the host cannot tell. */\n idle(): boolean | undefined;\n /** Host error-boundary component, wrapping a Component whose `catch` is set. */\n ErrorBoundary: unknown;\n Suspense: any;\n};\n\nconst noop = () => () => {};\n\nexport function useFactory<T extends object>(factory: () => T) {\n const ref = Runtime.useRef<T | null>(null);\n return ref.current || (ref.current = factory());\n}\n\n/**\n * Returns a claim on the update being replayed, held until this hook commits\n * carrying it - or until unmount, where it never will. Keyed on `tick` so an\n * urgent commit in the meantime, which leaves the deferred update queued, does\n * not release it.\n */\nexport function useSettle(tick: number) {\n const ref = Runtime.useRef<Settle | null>(null);\n const settle = ref.current || (ref.current = {\n claim() {\n const held = pending();\n\n if (held) (settle.waiting ||= []).push(held);\n },\n release() {\n const { waiting } = settle;\n\n if (!waiting) return;\n settle.waiting = undefined;\n\n for (const held of waiting) held();\n }\n });\n\n Runtime.useEffect(() => {\n settle.release();\n return settle.release;\n }, [tick]);\n\n return settle.claim;\n}\n\n/**\n * Run `init` once for the life of a hook and clean up when it unmounts, safe\n * under React StrictMode - a remount shares the render counter, so neither the\n * setup nor its cleanup repeats. A cleanup following a render not yet committed\n * - Fast Refresh re-running effects - defers a microtask, and is dropped if the\n * effect runs again. `reset` invalidates the rendered value so in-flight render\n * attempts revalidate.\n *\n * @returns The hook's own record, plus the render counter and its setter.\n */\nexport function useSetup<T extends Setup>(\n init: (self: T, reset: () => void) => () => (() => void) | void,\n teardown?: () => void\n) {\n const { current } = Runtime.useRef({ rendered: 0, revision: 0 } as T);\n\n const [tick, update] = Runtime.useState(() => {\n if (!current.rendered)\n current.commit = init(current, () => {\n current.revision++;\n });\n\n return current.rendered++;\n });\n\n useReap(current, teardown);\n\n const getRevision = (current.getRevision ||= () => current.revision);\n\n current.fresh = true;\n\n Runtime.useSyncExternalStore?.(noop, getRevision, getRevision);\n\n Runtime.useEffect(() => {\n current.fresh = false;\n });\n\n Runtime.useEffect(() => {\n current.mounted = true;\n current.lapsed = false;\n\n if (current.commit) {\n current.release = current.commit();\n current.commit = undefined;\n }\n\n return () => {\n if (!current.fresh) {\n if (--current.rendered <= 0) release(current);\n return;\n }\n\n current.lapsed = true;\n\n queueMicrotask(() => {\n if (current.lapsed) release(current);\n });\n }\n }, []);\n\n return [current, tick, update] as const;\n}\n\nfunction release(setup: Setup) {\n setup.release?.();\n setup.teardown?.();\n}\n\nlet reaper: FinalizationRegistry<Setup> | null | undefined;\n\nfunction useReap(setup: Setup, teardown?: () => void) {\n const token = Runtime.useRef<object | null>(null);\n\n if (!teardown || setup.teardown) return;\n\n setup.teardown = teardown;\n\n if (reaper === undefined)\n reaper = typeof FinalizationRegistry == 'function'\n ? new FinalizationRegistry((setup) => setup.mounted || setup.teardown!())\n : null;\n\n reaper?.register((token.current = {}), setup);\n}\n\nexport function weak<T extends object>(value: T): Weak<T> {\n return typeof WeakRef == 'function' ? new WeakRef(value) : { deref: () => value };\n}\n\nexport function useWeak<T extends object>(value: T) {\n const ref = Runtime.useRef<Weak<T> | null>(null);\n return (ref.current ||= weak(value));\n}\n\n/**\n * Mount-effect with a refreshable return value. Publishing a value before mount\n * defers the update to it, and one published after claims the update being\n * replayed until this hook commits carrying it.\n *\n * @returns Latest value published via the setter (`undefined` until set).\n */\nexport function useHook<T = void>(\n callback: (\n refresh: (next: T) => void,\n reset: () => void\n ) => () => (() => void) | void,\n teardown?: () => void\n) {\n const [current, tick, update] = useSetup<Hook<T>>((self, reset) => {\n const mount = callback((next) => {\n self.output = next;\n\n if (self.mounted) {\n claim();\n self.update?.deref()!((x) => x + 1);\n }\n else if (self.update) self.queued = true;\n }, reset);\n\n return () => {\n const cleanup = mount();\n\n if (self.queued) {\n self.queued = false;\n self.update!.deref()!((x) => x + 1);\n }\n\n return cleanup;\n };\n }, teardown);\n\n const claim = useSettle(tick);\n\n current.update ||= weak(update);\n\n return current.output;\n}\n\nexport function useWatch<T extends object>(\n from: T,\n mount?: () => (() => void) | void,\n teardown?: () => void\n) {\n return useHook<T>((refresh, reset) => {\n const release = watch(from, (current) => {\n refresh(current);\n\n return (update) => {\n if (update === true) reset();\n };\n }, undefined, Runtime.startTransition);\n\n return () => {\n const cleanup = mount?.();\n\n return () => {\n release();\n if (typeof cleanup == 'function') cleanup();\n };\n };\n }, teardown) ?? from;\n}\n","import { Context, Component } from '@expressive/mvc';\nimport { Runtime } 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\nexport { Context, createProvider, useAmbient };\n","import { Component, unbind } from '@expressive/mvc';\nimport { createProvider, type Context } from './context';\nimport { Runtime, useWatch } from './runtime';\n\ndeclare module '@expressive/mvc' {\n interface Component {\n /** @deprecated Only to satisfy host JSX. Use `this.get(Model)` instead. */\n readonly context: Context;\n /** @deprecated Only to satisfy host JSX. Use `this.get()` instead. */\n readonly state: {};\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.\nconst PLACING = new WeakMap<Component, { placed: Promise<void>; place(): void }>();\n\nObject.defineProperties(Component.prototype, {\n state: {\n set() {},\n get: Component.prototype.get\n },\n context: {\n set: bootstrap\n }\n});\n\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 */\nComponent.on({\n type(type) {\n const render = Object.getOwnPropertyDescriptor(type.prototype, 'render');\n\n if (typeof render?.value == 'function')\n Object.defineProperty(type.prototype, 'render', { ...render, configurable: false });\n\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 subcomponents(type.prototype);\n },\n setup(self) {\n subcomponents(self);\n return PLACING.get(self)?.placed;\n }\n});\n\nfunction bootstrap(this: Component, parent: Context){\n const placing = {} as { placed: Promise<void>; place(): void };\n\n placing.placed = new Promise((resolve) => (placing.place = resolve));\n PLACING.set(this, placing);\n\n const context = parent.push(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.props.catch || 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, dedupe } = Runtime;\n const attempt = dedupe?.(from, context);\n const { is: owner } = from;\n // Read before bootstrap shadows an instance `render` with this host.\n const own = Object.prototype.hasOwnProperty.call(owner, 'render') && owner.render;\n const teardown = () => {\n attempt?.remove();\n context.pop();\n };\n\n const Render = () => (own || Object.getPrototypeOf(owner).render).call(from, from.props);\n const Component = () => {\n from = useWatch(from, () => {\n PLACING.get(owner)!.place();\n attempt?.commit();\n }, teardown);\n\n return createFrame(from, context, createElement(Render));\n };\n\n return () => createElement(Component);\n}\n\nfunction wrappable(value: unknown): value is Function {\n return typeof value == 'function' && Object.getOwnPropertyDescriptor(value, 'prototype')?.writable !== false;\n}\n\nfunction assign(target: object, key: string, value: unknown) {\n Object.defineProperty(target, key, {\n value,\n writable: true,\n enumerable: true,\n configurable: true\n });\n}\n\n/** Rewrite each own capitalized function on `target` into a subcomponent; a class renders as itself. */\nfunction subcomponents(target: object) {\n for (const key of Object.getOwnPropertyNames(target)) {\n if (!/^[A-Z]/.test(key)) continue;\n const { value } = Object.getOwnPropertyDescriptor(target, key)!;\n if (!wrappable(value)) continue;\n Object.defineProperty(target, key, {\n configurable: true,\n get(this: Component) {\n const owner = this.is;\n let render = unbind(value);\n const Component = (props: unknown) =>\n render.call(useWatch(owner), props);\n\n Object.defineProperty(owner, key, {\n configurable: true,\n get: () => Component,\n set(fn: unknown) {\n if (wrappable(fn)) render = fn;\n else assign(owner, key, fn);\n }\n });\n\n return Component;\n },\n set(this: Component, value: unknown) {\n assign(this, key, value);\n subcomponents(this);\n }\n });\n }\n}\n\nexport { createFrame };\n","import { Model, Context } from '@expressive/mvc';\nimport { observer, watch } from '@expressive/mvc/observable';\nimport { resolver } from '@expressive/mvc/jsx-runtime';\nimport { useAmbient } from './context';\nimport { Runtime, useFactory, useSettle, useSetup, useWeak } from './runtime';\n\nconst normal = resolver((Type, compute) => {\n const idle = Runtime.idle();\n\n if (idle) return normal(Type, compute);\n\n let ambient: Context;\n\n if (idle === undefined)\n try {\n ambient = useAmbient();\n } catch {\n return normal(Type, compute);\n }\n else ambient = useAmbient();\n\n return Type ? use(ambient, compute) : compute(ambient);\n});\n\nfunction use(local: Context, compute: (context: Context) => unknown) {\n const [tick, next] = Runtime.useState(0);\n const claim = useSettle(tick);\n const dispatch = useWeak(next);\n const render = useFactory(() => {\n let latest = compute;\n let mounted = false;\n let pending = false;\n let force!: () => void;\n let target: unknown;\n let value: unknown;\n let unwatch: (() => void) | undefined;\n let thrown: [unknown] | undefined;\n\n function update() {\n pending = false;\n dispatch.deref()!((x) => x + 1);\n }\n\n function observed() {\n if (mounted) {\n claim();\n update();\n }\n else pending = true;\n }\n\n function follow(found: unknown) {\n if (found === target) return;\n\n unwatch?.();\n unwatch = undefined;\n target = value = found;\n\n if (found instanceof Model && observer(found) !== null) {\n let first = true;\n\n unwatch = watch(\n found,\n (current) => {\n value = current;\n\n if (!first) observed();\n first = false;\n\n return (update) => {\n if (update === true) force();\n };\n },\n false,\n Runtime.startTransition\n );\n }\n\n return true;\n }\n\n function release() {\n unfollow();\n unwatch?.();\n unwatch = target = undefined;\n }\n\n let first = true;\n\n const unfollow = watch(local, (ctx) => {\n try {\n if (follow(latest(ctx)) && !first) observed();\n } catch (error) {\n thrown = [error];\n if (!first) observed();\n }\n }, false);\n\n first = false;\n\n if (thrown) {\n unfollow();\n throw thrown[0];\n }\n\n let fresh = true;\n\n return (next: typeof compute) => {\n pending = false;\n useSetup((_self, reset) => {\n force = reset;\n\n return () => {\n mounted = true;\n if (pending) update();\n return release;\n };\n });\n\n if (!fresh) follow((latest = next)(local));\n\n fresh = false;\n\n return value;\n };\n });\n\n return render(compute);\n}\n"],"mappings":"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"}
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import { a as useWatch, i as useFactory, n as useAmbient, o as weak, r as Runtime, t as createFrame } from "./chunk-state.get-Buie72pM.js";
1
+ import { a as useWatch, i as useFactory, n as useAmbient, o as weak, r as Runtime, t as createFrame } from "./chunk-state.get-DlBih7tL.js";
2
2
  import "./adapter.js";
3
3
  import { Component } from "@expressive/mvc";
4
4
  import * as React$1 from "react";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expressive/react",
3
- "version": "0.94.1",
3
+ "version": "0.94.3",
4
4
  "description": "Class-based reactive state for React. Define state and logic as plain classes; components update when the values they read change.",
5
5
  "keywords": [
6
6
  "expressive",
@@ -22,10 +22,11 @@
22
22
  },
23
23
  "repository": {
24
24
  "type": "git",
25
- "url": "git+https://github.com/gabeklein/expressive-mvc.git"
25
+ "url": "git+https://github.com/gabeklein/expressive.git"
26
26
  },
27
27
  "files": [
28
- "dist"
28
+ "dist",
29
+ "skills"
29
30
  ],
30
31
  "type": "module",
31
32
  "sideEffects": [
@@ -63,7 +64,7 @@
63
64
  "test": "bun run typecheck && bun run coverage"
64
65
  },
65
66
  "devDependencies": {
66
- "@expressive/mvc": "^0.94.0",
67
+ "@expressive/mvc": "^0.94.3",
67
68
  "@testing-library/react": "^16.3.0",
68
69
  "@types/react": "^19",
69
70
  "@types/react-dom": "^19",
@@ -75,7 +76,7 @@
75
76
  "vite": "^7.3.1"
76
77
  },
77
78
  "peerDependencies": {
78
- "@expressive/mvc": "^0.94.0",
79
+ "@expressive/mvc": "^0.94.3",
79
80
  "react": ">=16.14.0 <20.0.0",
80
81
  "vite": ">=5"
81
82
  },
@@ -0,0 +1,14 @@
1
+ ---
2
+ name: expressive-react
3
+ description: React host for Expressive MVC (@expressive/react) - Component classes as React components, <Component for> providers, Model.get() in function components. Use when writing React views over Expressive state, migrating hooks (useState/useEffect/useMemo/useContext) to classes, fixing prop drilling, or reviewing such a refactor. Pair with the expressive-mvc skill for the core Model API.
4
+ ---
5
+
6
+ # Expressive MVC - React
7
+
8
+ `@expressive/react` is the React host. Ownership decisions, the golden-path summary and the core API are in `expressive-mvc` - read it first. **Read [refactor.md](refactor.md) in full before any hook-migration or refactor task.**
9
+
10
+ - [refactor.md](refactor.md) - the refactor algorithm expanded: ownership triage, mechanical-setter and prop-drilling anti-patterns, single-consumer getters, dependency snapshots and conditional subscriptions, presence boundaries, restrained `is`, subcomponent overuse, extract-then-consolidate, review checklist
11
+ - `expressive-mvc/style.md` - style profile: snapshot formatting, affirmative conditions, render fallthrough vs operational guards
12
+ - [react.md](react.md) - Model.get() (optional lookup, presence boundaries, custom lookup), effects at commit, providing state, transparent writes, SSR, React Native, Vite hot reload
13
+ - `expressive-mvc/component.md` - Component class, props, children, extending a base, subcomponent extension points, Suspense, transitions, error boundaries
14
+ - [patterns.md](patterns.md) - Recipes: forms, async, domain-row and form-chip pools, region controls, router bridge, host-agnostic domain model + view adapter, presence boundary, contextual children, debounce, async effects, awaiting a pending value, effects