@opetope/react 0.13.0 → 0.14.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/CHANGELOG.md +12 -0
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/model-selection-snapshot.d.ts +3 -7
- package/package.json +5 -5
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @opetope/react
|
|
2
2
|
|
|
3
|
+
## 0.14.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 712352a: Use one model-selection `read` for ordinary readables and resource views. Reading a view carries its demand until the committed selection changes or unmounts; `read(view.observe())` remains passive. Remove the former selection `acquire` method.
|
|
8
|
+
|
|
9
|
+
### Patch Changes
|
|
10
|
+
|
|
11
|
+
- 712352a: Keep the whole `useModel` selection result referentially stable across committed renders when its exposed fields and ordered keys are unchanged. Inline selectors can pass the result directly to memoized children and effects; source subscriptions and resource demand still follow the committed selection.
|
|
12
|
+
- @opetope/core@0.14.0
|
|
13
|
+
- @opetope/runtime@0.14.0
|
|
14
|
+
|
|
3
15
|
## 0.13.0
|
|
4
16
|
|
|
5
17
|
### Minor Changes
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{useState as O,useInsertionEffect as E,useLayoutEffect as y,useMemo as l,useSyncExternalStore as S,useRef as k,useCallback as P,useEffect as J,createElement as N,Fragment as Q}from"react";import{CommandError as X,declarationId as Y}from"@opetope/core";import{compatibleAbortReason as Z,isCancellation as _,reportDetachedError as I,isCallTarget as ee,isResourceView as A,resourceViewDemands as K,resourceViewReadable as b,isReadable as te,createAggregateError as ne,acquireResourceDemand as se,createContributionTarget as ie}from"@opetope/core/internal";import{C as f}from"./contribution-isolation-Bzfbt4iM.js";import{u as C,r as re,i as oe,p as ce,c as ae,a as H,M as ue,b as de}from"./contribution-frame-Bh104T5Z.js";import{d as ht}from"./contribution-frame-Bh104T5Z.js";function q(t,e){var n;if(_(e))return{reason:e,kind:"cancelled"};try{const s=(n=t==null?void 0:t.onFailure)==null?void 0:n.call(t,e);s!==void 0&&Promise.resolve(s).catch(I)}catch(s){I(s)}return{error:e,kind:"failed"}}function fe(t){const e=t==null?void 0:t.onSuccess,n=t==null?void 0:t.signal;return e===void 0?n===void 0?void 0:{signal:n}:n===void 0?{onSuccess:e}:{onSuccess:e,signal:n}}function le(t,e){let n;const s=new Promise(i=>{n=i});return{input:t,options:e===void 0?void 0:{...e},promise:s,resolve:n}}function he(t,e){const n=t.resolve;t.input=void 0,t.options=void 0,t.resolve=void 0,n==null||n(e)}class h{invoker;run=((e,n)=>{if(this.notify===void 0)return Promise.resolve({reason:new f("inactive","Command consumer is not mounted."),kind:"cancelled"});const s=this.cancelledInput(n);if(s!==void 0)return Promise.resolve(s);const i=le(e,n);return this.start(i),i.promise});inFlight=0;notify;constructor(e){this.invoker=e}attach(e){return this.notify=e,()=>{this.notify===e&&(this.notify=void 0)}}synchronize(){var e;(e=this.notify)==null||e.call(this,this.inFlight>0)}aborted(e){return{reason:new X("cancelled","Command input was cancelled.",Z(e)),kind:"cancelled"}}cancelledInput(e){var n;return((n=e==null?void 0:e.signal)==null?void 0:n.aborted)===!0?this.aborted(e.signal):void 0}finish(e,n){var s;e.resolve!==void 0&&(this.inFlight-=1,he(e,n),(s=this.notify)==null||s.call(this,this.inFlight>0,n))}invoke(e){let n;try{n=this.invoker.run(e.input,fe(e.options)),e.input=void 0}catch(s){this.finish(e,q(e.options,s));return}n.then(s=>this.finish(e,{kind:"ok",value:s}),s=>this.finish(e,q(e.options,s)))}start(e){var n;this.inFlight+=1,(n=this.notify)==null||n.call(this,!0),this.invoke(e)}}const be={inFlight:!1,outcome:void 0};function pe(t){return t===void 0||t.kind==="cancelled"?void 0:t}function ge(t,e,n,s){return s===void 0&&t.slot===e&&t.inFlight===n}function me(t,e,n,s){const i=pe(s);if(ge(t,e,n,i))return t;const r=t.slot===e?t.outcome:void 0;return{inFlight:n,outcome:i??r,slot:e}}function we(t){const[e]=O(()=>new WeakMap);let n=e.get(t);return n===void 0&&(n=new h(t),e.set(t,n)),n}function p(t){const[e,n]=O(()=>({inFlight:!1,outcome:void 0,slot:t}));E(()=>t.attach((o,c)=>n(a=>me(a,t,o,c))),[t]),y(()=>t.synchronize(),[t]);const{inFlight:s,outcome:i}=e.slot===t?e:be,r=t.run;return l(()=>({inFlight:s,outcome:i,run:r}),[s,i,r])}function ye(t){const n=C().commandRecords.get(t);if(n===void 0)throw new f("missing",`Command ${t.id} is not bound in this contribution.`);return p(we(n.invoker))}const Se=()=>{},$=()=>Se,ke=()=>0,ve=Object.freeze({});function g(t){return"kind"in t}function m(t){const e=new h(t);return{detach:void 0,hook:{inFlight:!1,outcome:void 0,run:e.run},invoker:t,slot:e}}function Re(t,e){return t.inFlight===e.inFlight&&Object.is(t.outcome,e.outcome)}function Oe(t,e,n){const s=t.hook;if(n===void 0&&s.inFlight===e)return!1;const i=n===void 0||n.kind==="cancelled"?void 0:n,r={inFlight:e,outcome:i??s.outcome,run:s.run};return Re(s,r)?!1:(t.hook=r,!0)}function Ee(t,e){return t!==void 0&&!g(t)&&t.invoker===e?t:m(e)}function D(t,e){return{pagination:t.paginated?{loadNext:t.loadNext.hook,state:e.pagination}:void 0,refresh:t.refresh.hook,reset:t.reset.hook,retry:t.retry.hook,state:e.state}}function Ce(t,e){const n={kind:"resource",loadNext:m(t.loadNext),paginated:e.pagination!==void 0,refresh:m(t.refresh),reset:m(t.reset),retry:m(t.retry)};return{...n,hook:D(n,e)}}function Me(t){var n;const{hook:e}=t;return e.refresh===t.refresh.hook&&e.reset===t.reset.hook&&e.retry===t.retry.hook&&(!t.paginated||((n=e.pagination)==null?void 0:n.loadNext)===t.loadNext.hook)}function ze(t,e){var n;return Object.is(t.hook.state,e.state)&&Object.is((n=t.hook.pagination)==null?void 0:n.state,e.pagination)}function je(t,e){return Me(t)&&ze(t,e)}function xe(t,e,n){return t===void 0||!g(t)||t.refresh.invoker!==e.refresh?Ce(e,n):(je(t,n)||(t.hook=D(t,n)),t)}function Fe(t){return g(t)?[t.refresh,t.reset,t.retry,t.loadNext]:[t]}function T(t){var e;for(const n of Fe(t))(e=n.detach)==null||e.call(n),n.detach=void 0}function Pe(t){return t.hook}class Ne{entries=new Map;invokers=new WeakMap;listeners=new Set;revision=0;close(){for(const e of this.entries.values())T(e);this.entries.clear()}commit(e){for(const[n,s]of this.entries)e.get(n)!==s&&T(s);this.entries=e;for(const n of e.values())this.attachEntry(n)}attachEntry(e){if(g(e)){this.attachCommand(e.refresh),this.attachCommand(e.retry),this.attachCommand(e.reset),this.attachCommand(e.loadNext);return}this.attachCommand(e)}attachCommand(e){e.detach??(e.detach=e.slot.attach((n,s)=>{if(Oe(e,n,s)){this.revision+=1;for(const i of this.listeners)i()}}))}getSnapshot=()=>this.revision;prepare(e,n,s){const i=new Map;for(const r of Reflect.ownKeys(e)){if(!Object.prototype.propertyIsEnumerable.call(e,r))continue;const o=e[r],c=o===void 0?void 0:s.commandRecords.get(o);if(c===void 0)throw new f("missing",`Command at ${String(r)} is not bound in this contribution.`);i.set(r,Ee(this.entries.get(r),c.invoker))}for(const[r,o]of n){const c=re(o.resource,this.invokers);i.set(r,xe(this.entries.get(r),c,o))}return i}subscribe=e=>(this.listeners.add(e),()=>{this.listeners.delete(e)})}function Ie(t,e){const n=k(void 0);return e.size>0||Reflect.ownKeys(t).some(i=>Object.prototype.propertyIsEnumerable.call(t,i))?n.current??(n.current=new Ne):void 0}function Ae(t,e){const n=C(),s=Ie(t,e),i=(s==null?void 0:s.getSnapshot)??ke;S((s==null?void 0:s.subscribe)??$,i,i);const r=s==null?void 0:s.prepare(t,e,n);return E(()=>()=>s==null?void 0:s.close(),[s]),E(()=>{r!==void 0&&(s==null||s.commit(r))}),y(()=>{if(r!==void 0)for(const o of r.values())g(o)?(o.refresh.slot.synchronize(),o.retry.slot.synchronize(),o.reset.slot.synchronize(),o.loadNext.slot.synchronize()):o.slot.synchronize()}),r===void 0?ve:Object.fromEntries([...r].map(([o,c])=>[o,Pe(c)]))}const V=new Map,Ke=new Set;function He(t,e){if(!te(t))throw new f("binding-invalid","Model selection read requires a Readable.");if(e.has(t))return e.get(t);const n=t.getSnapshot();return e.set(t,n),n}function L(t,e){if(e.has(t))return e.get(t);const n=t.getSnapshot();return e.set(t,n),n}function qe(t,e,n,s){if(!oe(e))return;const i=e,r=i.pagination;n.set(t,{pagination:r===void 0?void 0:L(b(r),s),resource:i,state:L(b(i),s)})}function $e(t){return t.size===0?V:t}function De(t,e){for(const{resource:n}of t.values())if(A(n))for(const s of K(n))e.add(s);else e.add(n)}function Te(t,e){const n=new Set,s=(a,d)=>{const u=He(a,e);return d===void 0?u:d(u)},r=t({acquire:(a,d)=>{if(!A(a))throw new f("binding-invalid","Model selection acquire requires a ResourceView.");for(const u of K(a))n.add(u);return s(a.observe(),d)},read:s});if(typeof r!="object"||r===null||Array.isArray(r))throw new f("binding-invalid","Model selection requires a record.");const o=[],c=new Map;for(const a of Reflect.ownKeys(r)){if(!Object.prototype.propertyIsEnumerable.call(r,a))continue;const d=r[a];o.push([a,d]),qe(a,d,c,e)}return De(c,n),{leases:n,resources:$e(c),values:Object.fromEntries(o)}}function Ve(t,e){if(t.size!==e.size)return!1;for(const[n,s]of e){const i=t.get(n);if((i==null?void 0:i.resource)!==s.resource||!Object.is(i.state,s.state)||!Object.is(i.pagination,s.pagination))return!1}return!0}function U(t,e){if(t.size!==e.size)return!1;for(const n of e)if(!t.has(n))return!1;return!0}function Le(t,e,n,s,i){const r=Reflect.ownKeys(e),o=Reflect.ownKeys(t.values);return r.length!==o.length||!U(t.sources,n)||!U(t.leases,i)||!Ve(t.resources,s)?!1:r.every((c,a)=>o[a]===c&&Object.is(t.values[c],e[c]))}const v={commands:{},leases:Ke,resources:V,sources:new Set,values:{}};function Ue(t){return Object.fromEntries(Reflect.ownKeys(t).filter(e=>ee(t[e])).map(e=>[e,t[e]]))}function We(t){for(const[e,n]of t)if(!Object.is(e.getSnapshot(),n))return!1;return!0}function Ge(){return{model:void 0,observed:void 0,select:void 0,snapshot:v}}function Be(t,e,n){return n.model!==t&&(n.model=t,n.observed=void 0,n.select=void 0,n.snapshot=v),()=>{const s=e.current;if(s===void 0)return v;const i=n.observed;if(i!==void 0&&n.select===s&&We(i))return n.snapshot;const r=new Map,{leases:o,resources:c,values:a}=Te(u=>s(t,u),r),d=new Set(r.keys());return(i===void 0||!Le(n.snapshot,a,d,c,o))&&(n.snapshot={commands:Ue(a),leases:o,resources:c,sources:d,values:a}),n.observed=r,n.select=s,n.snapshot}}const M=new Set;function W(t,e=[]){for(const n of t){const s=n.dispose;n.dispose=void 0;try{s==null||s()}catch(i){e.push(i)}}if(e.length===1)throw e[0];if(e.length>1)throw ne(e,"Model selection sources failed to release.")}class Je{enabled=!1;leases=new Map;listeners=new Set;retained=M;sources=new Set;subscriptions=new Map;close(){this.enabled=!1,this.sources=new Set,this.retained=M,this.releaseAll()}commit(e,n=M){this.sources=e,this.retained=n,this.enabled=!0;try{this.synchronize()}catch(s){this.releaseAll([s])}}subscribe=e=>{const n={notify:e};this.listeners.add(n);try{this.synchronize()}catch(s){this.listeners.delete(n),this.releaseAll([s])}return()=>{this.listeners.delete(n),this.listeners.size===0&&this.releaseAll()}};add(e){const n={dispose:void 0};this.subscriptions.set(e,n);const s=e.subscribe(this.notify);if(typeof s!="function")throw new TypeError("Model selection source must return a disposer.");this.subscriptions.get(e)===n?n.dispose=s:s()}notify=()=>{for(const e of[...this.listeners])this.listeners.has(e)&&e.notify()};releaseAll(e){const n=[...this.subscriptions.values(),...this.leases.values()];this.subscriptions.clear(),this.leases.clear(),W(n,e)}removeUnselected(){const e=[];for(const[n,s]of this.subscriptions)this.sources.has(n)||(this.subscriptions.delete(n),e.push(s));for(const[n,s]of this.leases)this.retained.has(n)||(this.leases.delete(n),e.push(s));W(e)}retain(e){const n={dispose:void 0};this.leases.set(e,n);const s=e.acquire();if(typeof s!="function")throw new TypeError("Model selection resource must answer a release disposer.");this.leases.get(e)===n?n.dispose=s:s()}ready(){return this.enabled&&this.listeners.size>0}retainSelected(){for(const e of this.retained){if(!this.ready())return;this.retained.has(e)&&!this.leases.has(e)&&this.retain(e)}}subscribeSources(){for(const e of this.sources){if(!this.ready())return;this.sources.has(e)&&!this.subscriptions.has(e)&&this.add(e)}}synchronize(){this.removeUnselected(),this.subscribeSources(),this.retainSelected()}}const Qe=()=>v;function Xe(t){const e=k(void 0);return t?e.current??(e.current=new Je):void 0}function Ye(t,e){return Object.fromEntries(Reflect.ownKeys(t.values).map(n=>[n,Object.prototype.hasOwnProperty.call(e,n)?e[n]:t.values[n]]))}function Ze(t,e){const n=C();if(!n.models.has(t))throw new f("missing",`Model ${t.id} is not granted to this contribution.`);const s=n.models.get(t),i=Xe(e!==void 0),r=k(void 0);r.current=e;const o=e!==void 0,c=k(void 0),a=c.current??(c.current=Ge()),d=l(()=>o?Be(s,r,a):Qe,[a,s,o]),u=S((i==null?void 0:i.subscribe)??$,d,d),w=Ae(u.commands,u.resources);return y(()=>()=>i==null?void 0:i.close(),[i]),y(()=>i==null?void 0:i.commit(u.sources,u.leases),[u,i]),e===void 0?s:Ye(u,w)}function _e(t){const e=Object.freeze([...t]);return n=>{if(n.requires!==void 0)throw new f("duplicate","Component already declares the models it requires.");return Object.defineProperty(n,"requires",{enumerable:!1,value:e}),n}}function et(t){const[e]=O(()=>new WeakMap),n=e.get(t);if(n!==void 0)return n;const s=ae(t),i={loadNext:new h(s.loadNext),refresh:new h(s.refresh),reset:new h(s.reset),retry:new h(s.retry)};return e.set(t,i),i}const tt=Object.freeze({kind:"unavailable",reason:"resource-not-ready"}),nt=Object.freeze({getSnapshot:()=>tt,subscribe:()=>()=>{}});function st(t){const e=t,n=ce(e),s=P(R=>b(t).subscribe(R),[t]),i=l(()=>()=>b(t).getSnapshot(),[t]),r=S(s,i,i),o=n===void 0?nt:b(n),c=P(R=>o.subscribe(R),[o]),a=l(()=>()=>o.getSnapshot(),[o]),d=S(c,a,a);J(()=>se(t),[t]);const u=et(e),w=p(u.refresh),z=p(u.retry),j=p(u.reset),x=p(u.loadNext),F=l(()=>n===void 0?void 0:{loadNext:x,state:d},[n,x,d]);return l(()=>({pagination:F,refresh:w,reset:j,retry:z,state:r}),[F,w,j,z,r])}const G=Object.freeze({});function B(t){return ie(t,"slot")}function it(t){const e=Y(t),n=new Map,s=i=>{const r=n.get(i);if(r!==void 0)return r;const o=B(`${e}/${i}`);return n.set(i,o),o};return Object.defineProperty(s,"id",{enumerable:!0,value:e}),Object.freeze(s)}function rt(t){const e=H(t.target.entries),n="props"in t?t.props??G:G;return e.length===0?null:e.map(s=>N(Q,{key:s.id},N(ue,{authority:de(s),contribution:s.value,contributionId:s.id,slotProps:n,targetId:t.target.id})))}export{f as ContributionError,rt as Slot,B as defineSlot,it as defineSwitchSlot,_e as requiresModels,ye as useCommand,Ze as useModel,H as useReadable,st as useResource,ht as useSelector};
|
|
1
|
+
import{useState as E,useInsertionEffect as M,useLayoutEffect as w,useMemo as b,useSyncExternalStore as R,useRef as y,useCallback as F,useEffect as Q,createElement as P,Fragment as X}from"react";import{CommandError as Y,declarationId as Z}from"@opetope/core";import{compatibleAbortReason as _,isCancellation as ee,reportDetachedError as I,isCallTarget as te,isResourceView as A,resourceViewDemands as K,resourceViewReadable as S,isReadable as ne,createAggregateError as se,acquireResourceDemand as ie,createContributionTarget as re}from"@opetope/core/internal";import{C as f}from"./contribution-isolation-Bzfbt4iM.js";import{u as z,r as oe,i as ce,p as ae,c as ue,a as H,M as de,b as fe}from"./contribution-frame-Bh104T5Z.js";import{d as gt}from"./contribution-frame-Bh104T5Z.js";function $(t,e){var n;if(ee(e))return{reason:e,kind:"cancelled"};try{const s=(n=t==null?void 0:t.onFailure)==null?void 0:n.call(t,e);s!==void 0&&Promise.resolve(s).catch(I)}catch(s){I(s)}return{error:e,kind:"failed"}}function le(t){const e=t==null?void 0:t.onSuccess,n=t==null?void 0:t.signal;return e===void 0?n===void 0?void 0:{signal:n}:n===void 0?{onSuccess:e}:{onSuccess:e,signal:n}}function he(t,e){let n;const s=new Promise(i=>{n=i});return{input:t,options:e===void 0?void 0:{...e},promise:s,resolve:n}}function be(t,e){const n=t.resolve;t.input=void 0,t.options=void 0,t.resolve=void 0,n==null||n(e)}class p{invoker;run=((e,n)=>{if(this.notify===void 0)return Promise.resolve({reason:new f("inactive","Command consumer is not mounted."),kind:"cancelled"});const s=this.cancelledInput(n);if(s!==void 0)return Promise.resolve(s);const i=he(e,n);return this.start(i),i.promise});inFlight=0;notify;constructor(e){this.invoker=e}attach(e){return this.notify=e,()=>{this.notify===e&&(this.notify=void 0)}}synchronize(){var e;(e=this.notify)==null||e.call(this,this.inFlight>0)}aborted(e){return{reason:new Y("cancelled","Command input was cancelled.",_(e)),kind:"cancelled"}}cancelledInput(e){var n;return((n=e==null?void 0:e.signal)==null?void 0:n.aborted)===!0?this.aborted(e.signal):void 0}finish(e,n){var s;e.resolve!==void 0&&(this.inFlight-=1,be(e,n),(s=this.notify)==null||s.call(this,this.inFlight>0,n))}invoke(e){let n;try{n=this.invoker.run(e.input,le(e.options)),e.input=void 0}catch(s){this.finish(e,$(e.options,s));return}n.then(s=>this.finish(e,{kind:"ok",value:s}),s=>this.finish(e,$(e.options,s)))}start(e){var n;this.inFlight+=1,(n=this.notify)==null||n.call(this,!0),this.invoke(e)}}const pe={inFlight:!1,outcome:void 0};function ge(t){return t===void 0||t.kind==="cancelled"?void 0:t}function me(t,e,n,s){return s===void 0&&t.slot===e&&t.inFlight===n}function we(t,e,n,s){const i=ge(s);if(me(t,e,n,i))return t;const r=t.slot===e?t.outcome:void 0;return{inFlight:n,outcome:i??r,slot:e}}function ye(t){const[e]=E(()=>new WeakMap);let n=e.get(t);return n===void 0&&(n=new p(t),e.set(t,n)),n}function k(t){const[e,n]=E(()=>({inFlight:!1,outcome:void 0,slot:t}));M(()=>t.attach((o,c)=>n(a=>we(a,t,o,c))),[t]),w(()=>t.synchronize(),[t]);const{inFlight:s,outcome:i}=e.slot===t?e:pe,r=t.run;return b(()=>({inFlight:s,outcome:i,run:r}),[s,i,r])}function Se(t){const n=z().commandRecords.get(t);if(n===void 0)throw new f("missing",`Command ${t.id} is not bound in this contribution.`);return k(ye(n.invoker))}const ke=()=>{},V=()=>ke,ve=()=>0,Re=Object.freeze({});function l(t){return"kind"in t}function v(t){const e=new p(t);return{detach:void 0,hook:{inFlight:!1,outcome:void 0,run:e.run},invoker:t,slot:e}}function Oe(t,e){return t.inFlight===e.inFlight&&Object.is(t.outcome,e.outcome)}function Ce(t,e,n){const s=t.hook;if(n===void 0&&s.inFlight===e)return!1;const i=n===void 0||n.kind==="cancelled"?void 0:n,r={inFlight:e,outcome:i??s.outcome,run:s.run};return Oe(s,r)?!1:(t.hook=r,!0)}function Ee(t,e){return t!==void 0&&!l(t)&&t.invoker===e?t:v(e)}function D(t,e){return{pagination:t.paginated?{loadNext:t.loadNext.hook,state:e.pagination}:void 0,refresh:t.refresh.hook,reset:t.reset.hook,retry:t.retry.hook,state:e.state}}function Me(t,e){const n={kind:"resource",loadNext:v(t.loadNext),paginated:e.pagination!==void 0,refresh:v(t.refresh),reset:v(t.reset),retry:v(t.retry)};return{...n,hook:D(n,e)}}function ze(t){var n;const{hook:e}=t;return e.refresh===t.refresh.hook&&e.reset===t.reset.hook&&e.retry===t.retry.hook&&(!t.paginated||((n=e.pagination)==null?void 0:n.loadNext)===t.loadNext.hook)}function je(t,e){var n;return Object.is(t.hook.state,e.state)&&Object.is((n=t.hook.pagination)==null?void 0:n.state,e.pagination)}function xe(t,e){return ze(t)&&je(t,e)}function Ne(t,e,n){return t===void 0||!l(t)||t.refresh.invoker!==e.refresh?Me(e,n):xe(t,n)?t:{...t,hook:D(t,n)}}function Fe(t){return l(t)?[t.refresh,t.reset,t.retry,t.loadNext]:[t]}function T(t){var e;for(const n of Fe(t))(e=n.detach)==null||e.call(n),n.detach=void 0}function Pe(t,e){return t.refresh===e.refresh&&t.reset===e.reset&&t.retry===e.retry&&t.loadNext===e.loadNext}function Ie(t,e){return t===e?!0:e===void 0||!l(t)||!l(e)?!1:Pe(t,e)}function Ae(t){return t.hook}class Ke{entries=new Map;invokers=new WeakMap;listeners=new Set;revision=0;close(){for(const e of this.entries.values())T(e);this.entries.clear()}commit(e){for(const[n,s]of this.entries)Ie(s,e.get(n))||T(s);this.entries=e;for(const n of e.values())this.attachEntry(n)}attachEntry(e){if(l(e)){this.attachCommand(e.refresh),this.attachCommand(e.retry),this.attachCommand(e.reset),this.attachCommand(e.loadNext);return}this.attachCommand(e)}attachCommand(e){e.detach??(e.detach=e.slot.attach((n,s)=>{if(Ce(e,n,s)){this.revision+=1;for(const i of this.listeners)i()}}))}getSnapshot=()=>this.revision;prepare(e,n,s){const i=new Map;for(const r of Reflect.ownKeys(e)){if(!Object.prototype.propertyIsEnumerable.call(e,r))continue;const o=e[r],c=o===void 0?void 0:s.commandRecords.get(o);if(c===void 0)throw new f("missing",`Command at ${String(r)} is not bound in this contribution.`);i.set(r,Ee(this.entries.get(r),c.invoker))}for(const[r,o]of n){const c=oe(o.resource,this.invokers);i.set(r,Ne(this.entries.get(r),c,o))}return i}subscribe=e=>(this.listeners.add(e),()=>{this.listeners.delete(e)})}function He(t,e){const n=y(void 0);return e.size>0||Reflect.ownKeys(t).some(i=>Object.prototype.propertyIsEnumerable.call(t,i))?n.current??(n.current=new Ke):void 0}function $e(t,e){const n=z(),s=He(t,e),i=(s==null?void 0:s.getSnapshot)??ve;R((s==null?void 0:s.subscribe)??V,i,i);const r=s==null?void 0:s.prepare(t,e,n);return M(()=>()=>s==null?void 0:s.close(),[s]),M(()=>{r!==void 0&&(s==null||s.commit(r))}),w(()=>{if(r!==void 0)for(const o of r.values())l(o)?(o.refresh.slot.synchronize(),o.retry.slot.synchronize(),o.reset.slot.synchronize(),o.loadNext.slot.synchronize()):o.slot.synchronize()}),r===void 0?Re:Object.fromEntries([...r].map(([o,c])=>[o,Ae(c)]))}const L=new Map,Ve=new Set;function De(t,e){if(!ne(t))throw new f("binding-invalid","Model selection read requires a Readable or ResourceView.");if(e.has(t))return e.get(t);const n=t.getSnapshot();return e.set(t,n),n}function U(t,e){if(e.has(t))return e.get(t);const n=t.getSnapshot();return e.set(t,n),n}function Te(t,e,n,s){if(!ce(e))return;const i=e,r=i.pagination;n.set(t,{pagination:r===void 0?void 0:U(S(r),s),resource:i,state:U(S(i),s)})}function Le(t){return t.size===0?L:t}function Ue(t,e){for(const{resource:n}of t.values())if(A(n))for(const s of K(n))e.add(s);else e.add(n)}function We(t,e){const n=new Set,i=t({read:(c,a)=>{let d;if(A(c)){for(const h of K(c))n.add(h);d=c.observe()}else d=c;const u=De(d,e);return a===void 0?u:a(u)}});if(typeof i!="object"||i===null||Array.isArray(i))throw new f("binding-invalid","Model selection requires a record.");const r=[],o=new Map;for(const c of Reflect.ownKeys(i)){if(!Object.prototype.propertyIsEnumerable.call(i,c))continue;const a=i[c];r.push([c,a]),Te(c,a,o,e)}return Ue(o,n),{leases:n,resources:Le(o),values:Object.fromEntries(r)}}function qe(t,e){if(t.size!==e.size)return!1;for(const[n,s]of e){const i=t.get(n);if((i==null?void 0:i.resource)!==s.resource||!Object.is(i.state,s.state)||!Object.is(i.pagination,s.pagination))return!1}return!0}function W(t,e){if(t.size!==e.size)return!1;for(const n of e)if(!t.has(n))return!1;return!0}function Ge(t,e,n,s,i){const r=Reflect.ownKeys(e),o=Reflect.ownKeys(t.values);return r.length!==o.length||!W(t.sources,n)||!W(t.leases,i)||!qe(t.resources,s)?!1:r.every((c,a)=>o[a]===c&&Object.is(t.values[c],e[c]))}const O={commands:{},leases:Ve,resources:L,sources:new Set,values:{}};function Be(t){return Object.fromEntries(Reflect.ownKeys(t).filter(e=>te(t[e])).map(e=>[e,t[e]]))}function Je(t){for(const[e,n]of t)if(!Object.is(e.getSnapshot(),n))return!1;return!0}function Qe(){return{model:void 0,observed:void 0,select:void 0,snapshot:O}}function Xe(t,e,n){return n.model!==t&&(n.model=t,n.observed=void 0,n.select=void 0,n.snapshot=O),()=>{const s=e.current;if(s===void 0)return O;const i=n.observed;if(i!==void 0&&n.select===s&&Je(i))return n.snapshot;const r=new Map,{leases:o,resources:c,values:a}=We(u=>s(t,u),r),d=new Set(r.keys());return(i===void 0||!Ge(n.snapshot,a,d,c,o))&&(n.snapshot={commands:Be(a),leases:o,resources:c,sources:d,values:a}),n.observed=r,n.select=s,n.snapshot}}const j=new Set;function q(t,e=[]){for(const n of t){const s=n.dispose;n.dispose=void 0;try{s==null||s()}catch(i){e.push(i)}}if(e.length===1)throw e[0];if(e.length>1)throw se(e,"Model selection sources failed to release.")}class Ye{enabled=!1;leases=new Map;listeners=new Set;retained=j;sources=new Set;subscriptions=new Map;close(){this.enabled=!1,this.sources=new Set,this.retained=j,this.releaseAll()}commit(e,n=j){this.sources=e,this.retained=n,this.enabled=!0;try{this.synchronize()}catch(s){this.releaseAll([s])}}subscribe=e=>{const n={notify:e};this.listeners.add(n);try{this.synchronize()}catch(s){this.listeners.delete(n),this.releaseAll([s])}return()=>{this.listeners.delete(n),this.listeners.size===0&&this.releaseAll()}};add(e){const n={dispose:void 0};this.subscriptions.set(e,n);const s=e.subscribe(this.notify);if(typeof s!="function")throw new TypeError("Model selection source must return a disposer.");this.subscriptions.get(e)===n?n.dispose=s:s()}notify=()=>{for(const e of[...this.listeners])this.listeners.has(e)&&e.notify()};releaseAll(e){const n=[...this.subscriptions.values(),...this.leases.values()];this.subscriptions.clear(),this.leases.clear(),q(n,e)}removeUnselected(){const e=[];for(const[n,s]of this.subscriptions)this.sources.has(n)||(this.subscriptions.delete(n),e.push(s));for(const[n,s]of this.leases)this.retained.has(n)||(this.leases.delete(n),e.push(s));q(e)}retain(e){const n={dispose:void 0};this.leases.set(e,n);const s=e.acquire();if(typeof s!="function")throw new TypeError("Model selection resource must answer a release disposer.");this.leases.get(e)===n?n.dispose=s:s()}ready(){return this.enabled&&this.listeners.size>0}retainSelected(){for(const e of this.retained){if(!this.ready())return;this.retained.has(e)&&!this.leases.has(e)&&this.retain(e)}}subscribeSources(){for(const e of this.sources){if(!this.ready())return;this.sources.has(e)&&!this.subscriptions.has(e)&&this.add(e)}}synchronize(){this.removeUnselected(),this.subscribeSources(),this.retainSelected()}}const Ze=()=>O;function _e(t){const e=y(void 0);return t?e.current??(e.current=new Ye):void 0}function G(t,e,n){return Object.prototype.hasOwnProperty.call(e,n)?e[n]:t.values[n]}function et(t,e,n){const s=Reflect.ownKeys(t.values);if(n!==void 0){const i=Reflect.ownKeys(n);if(s.length===i.length&&s.every((r,o)=>r===i[o]&&Object.is(n[r],G(t,e,r))))return n}return Object.fromEntries(s.map(i=>[i,G(t,e,i)]))}function tt(t,e){const n=z();if(!n.models.has(t))throw new f("missing",`Model ${t.id} is not granted to this contribution.`);const s=n.models.get(t),i=_e(e!==void 0),r=y(void 0);r.current=e;const o=e!==void 0,c=y(void 0),a=c.current??(c.current=Qe()),d=b(()=>o?Xe(s,r,a):Ze,[a,s,o]),u=R((i==null?void 0:i.subscribe)??V,d,d),h=$e(u.commands,u.resources);w(()=>()=>i==null?void 0:i.close(),[i]),w(()=>i==null?void 0:i.commit(u.sources,u.leases),[u,i]);const g=y(void 0),m=o?et(u,h,g.current):void 0;return w(()=>{g.current=m}),e===void 0?s:m}function nt(t){const e=Object.freeze([...t]);return n=>{if(n.requires!==void 0)throw new f("duplicate","Component already declares the models it requires.");return Object.defineProperty(n,"requires",{enumerable:!1,value:e}),n}}function st(t){const[e]=E(()=>new WeakMap),n=e.get(t);if(n!==void 0)return n;const s=ue(t),i={loadNext:new p(s.loadNext),refresh:new p(s.refresh),reset:new p(s.reset),retry:new p(s.retry)};return e.set(t,i),i}const it=Object.freeze({kind:"unavailable",reason:"resource-not-ready"}),rt=Object.freeze({getSnapshot:()=>it,subscribe:()=>()=>{}});function ot(t){const e=t,n=ae(e),s=F(C=>S(t).subscribe(C),[t]),i=b(()=>()=>S(t).getSnapshot(),[t]),r=R(s,i,i),o=n===void 0?rt:S(n),c=F(C=>o.subscribe(C),[o]),a=b(()=>()=>o.getSnapshot(),[o]),d=R(c,a,a);Q(()=>ie(t),[t]);const u=st(e),h=k(u.refresh),g=k(u.retry),m=k(u.reset),x=k(u.loadNext),N=b(()=>n===void 0?void 0:{loadNext:x,state:d},[n,x,d]);return b(()=>({pagination:N,refresh:h,reset:m,retry:g,state:r}),[N,h,m,g,r])}const B=Object.freeze({});function J(t){return re(t,"slot")}function ct(t){const e=Z(t),n=new Map,s=i=>{const r=n.get(i);if(r!==void 0)return r;const o=J(`${e}/${i}`);return n.set(i,o),o};return Object.defineProperty(s,"id",{enumerable:!0,value:e}),Object.freeze(s)}function at(t){const e=H(t.target.entries),n="props"in t?t.props??B:B;return e.length===0?null:e.map(s=>P(X,{key:s.id},P(de,{authority:fe(s),contribution:s.value,contributionId:s.id,slotProps:n,targetId:t.target.id})))}export{f as ContributionError,at as Slot,J as defineSlot,ct as defineSwitchSlot,nt as requiresModels,Se as useCommand,tt as useModel,H as useReadable,ot as useResource,gt as useSelector};
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sources":["../src/command-hook-controller.ts","../src/command-hook.ts","../src/idle-subscription.ts","../src/selection-hooks.ts","../src/model-selection-snapshot.ts","../src/model-selection-store.ts","../src/model-hook.ts","../src/requires-models.ts","../src/resource-hook.ts","../src/slot.tsx"],"sourcesContent":["import { CommandError } from '@opetope/core';\nimport { compatibleAbortReason, isCancellation, reportDetachedError } from '@opetope/core/internal';\nimport type { CommandInputArgs, CallRunOptions } from '@opetope/core/internal';\n\nimport type { CommandOutcome } from './command';\nimport { ContributionError } from './errors';\n\ntype CommandRunOptions<Output> = Readonly<{\n onFailure?: (error: unknown) => PromiseLike<void> | void;\n onSuccess?: (value: Output) => PromiseLike<void> | void;\n signal?: AbortSignal;\n}>;\n\ntype CommandRun<Input, Output> = {\n (input: Input, options?: CommandRunOptions<Output>): Promise<CommandOutcome<Output>>;\n (...args: [...CommandInputArgs<Input>, options?: CommandRunOptions<Output>]): Promise<CommandOutcome<Output>>;\n};\n\ntype CommandInvoker = Readonly<{\n run: (input: never, options?: CallRunOptions<unknown>) => Promise<unknown>;\n}>;\n\ntype CommandNotification<Output> = (inFlight: boolean, outcome?: CommandOutcome<Output>) => void;\n\ntype CommandRequest<Input, Output> = {\n input: Input | undefined;\n options: CommandRunOptions<Output> | undefined;\n readonly promise: Promise<CommandOutcome<Output>>;\n resolve: ((outcome: CommandOutcome<Output>) => void) | undefined;\n};\n\nfunction failureOutcome<Output>(options: CommandRunOptions<Output> | undefined, error: unknown): CommandOutcome<never> {\n if (isCancellation(error)) return { reason: error, kind: 'cancelled' };\n\n try {\n const notification = options?.onFailure?.(error);\n\n if (notification !== undefined) void Promise.resolve(notification).catch(reportDetachedError);\n } catch (callbackError) {\n reportDetachedError(callbackError);\n }\n\n return { error, kind: 'failed' };\n}\n\nfunction runOptions<Output>(options: CommandRunOptions<Output> | undefined): CallRunOptions<Output> | undefined {\n const onSuccess = options?.onSuccess;\n const signal = options?.signal;\n\n if (onSuccess === undefined) return signal === undefined ? undefined : { signal };\n\n return signal === undefined ? { onSuccess } : { onSuccess, signal };\n}\n\nfunction requestOf<Input, Output>(\n input: Input,\n options: CommandRunOptions<Output> | undefined,\n): CommandRequest<Input, Output> {\n let resolve!: (outcome: CommandOutcome<Output>) => void;\n const promise = new Promise<CommandOutcome<Output>>(settle => {\n resolve = settle;\n });\n\n return { input, options: options === undefined ? undefined : { ...options }, promise, resolve };\n}\n\nfunction settle<Input, Output>(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n const resolve = request.resolve;\n request.input = undefined;\n request.options = undefined;\n request.resolve = undefined;\n resolve?.(outcome);\n}\n\n/**\n * D203: the consumer keeps a status, not a schedule. Every `run` reaches the command, and what the command was\n * declared with — `concurrency`, `memoize`, `dedupe` — decides what happens to it. What stays\n * local is what only this consumer knows: whether it is mounted, its own input signal, and the outcome it shows.\n */\nclass CommandHookController<Input, Output> {\n readonly run: CommandRun<Input, Output> = ((input: Input, options?: CommandRunOptions<Output>) => {\n if (this.notify === undefined) {\n return Promise.resolve({\n reason: new ContributionError('inactive', 'Command consumer is not mounted.'),\n kind: 'cancelled' as const,\n });\n }\n\n const aborted = this.cancelledInput(options);\n\n if (aborted !== undefined) return Promise.resolve(aborted);\n\n const request = requestOf(input, options);\n this.start(request);\n\n return request.promise;\n }) as CommandRun<Input, Output>;\n private inFlight = 0;\n private notify: CommandNotification<Output> | undefined;\n\n constructor(private readonly invoker: CommandInvoker) {}\n\n attach(notify: CommandNotification<Output>): () => void {\n this.notify = notify;\n\n return () => {\n if (this.notify !== notify) return;\n\n this.notify = undefined;\n };\n }\n\n synchronize(): void {\n this.notify?.(this.inFlight > 0);\n }\n\n private aborted(signal: AbortSignal): CommandOutcome<never> {\n return {\n reason: new CommandError('cancelled', 'Command input was cancelled.', compatibleAbortReason(signal)),\n kind: 'cancelled',\n };\n }\n\n private cancelledInput(options: CommandRunOptions<Output> | undefined): CommandOutcome<never> | undefined {\n return options?.signal?.aborted === true ? this.aborted(options.signal) : undefined;\n }\n\n private finish(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n if (request.resolve === undefined) return;\n\n this.inFlight -= 1;\n settle(request, outcome);\n this.notify?.(this.inFlight > 0, outcome);\n }\n\n private invoke(request: CommandRequest<Input, Output>): void {\n let invocation: Promise<Output>;\n\n try {\n invocation = this.invoker.run(request.input as never, runOptions(request.options) as never) as Promise<Output>;\n request.input = undefined;\n } catch (error) {\n this.finish(request, failureOutcome(request.options, error));\n\n return;\n }\n\n void invocation.then(\n value => this.finish(request, { kind: 'ok', value }),\n (error: unknown) => this.finish(request, failureOutcome(request.options, error)),\n );\n }\n\n private start(request: CommandRequest<Input, Output>): void {\n this.inFlight += 1;\n // Reserve the flight before publishing: a reentrant run must already see this consumer as busy.\n this.notify?.(true);\n this.invoke(request);\n }\n}\n\nexport { CommandHookController };\nexport type { CommandInvoker, CommandRun };\n","import { useInsertionEffect, useLayoutEffect, useMemo, useState } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker, CommandRun } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { useFrame } from './mount-context';\n\n/** D292: a cancellation is not an answer of the product, so it never settles into the outcome this hook shows. */\ntype SettledOutcome<Output> = Exclude<CommandOutcome<Output>, { readonly kind: 'cancelled' }>;\n\ninterface CommandHookStatus<Output> {\n readonly inFlight: boolean;\n readonly outcome: SettledOutcome<Output> | undefined;\n}\n\nconst emptyStatus: CommandHookStatus<never> = { inFlight: false, outcome: undefined };\n\ntype CommandHook<Input, Output> = CommandHookStatus<Output> & {\n readonly run: CommandRun<Input, Output>;\n};\n\ntype CommandHookState<Input, Output> = CommandHookStatus<Output> & {\n readonly slot: CommandHookController<Input, Output>;\n};\n\n/** D292: a cancellation moves nothing, so it is the same non-event as a notification without an outcome at all. */\nfunction settledOutcome<Output>(outcome: CommandOutcome<Output> | undefined): SettledOutcome<Output> | undefined {\n return outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n}\n\nfunction unchangedState<Input, Output>(\n current: CommandHookState<Input, Output>,\n slot: CommandHookController<Input, Output>,\n inFlight: boolean,\n settled: SettledOutcome<Output> | undefined,\n): boolean {\n return settled === undefined && current.slot === slot && current.inFlight === inFlight;\n}\n\nfunction nextState<Input, Output>(\n current: CommandHookState<Input, Output>,\n slot: CommandHookController<Input, Output>,\n inFlight: boolean,\n outcome?: CommandOutcome<Output>,\n): CommandHookState<Input, Output> {\n const settled = settledOutcome(outcome);\n\n if (unchangedState(current, slot, inFlight, settled)) return current;\n\n // A new run clears nothing: the previous answer stays readable while its retry is in flight.\n const previous = current.slot === slot ? current.outcome : undefined;\n\n return { inFlight, outcome: settled ?? previous, slot };\n}\n\nfunction useCommandSlot<Input, Output>(invoker: CommandInvoker): CommandHookController<Input, Output> {\n // Slots are inert until commit. An interrupted render cannot fence the committed source or admit its own work.\n const [slots] = useState(() => new WeakMap<object, CommandHookController<Input, Output>>());\n let slot = slots.get(invoker);\n\n if (slot === undefined) {\n slot = new CommandHookController(invoker);\n slots.set(invoker, slot);\n }\n\n return slot;\n}\n\n/**\n * The status half of a consumer, apart from what it is a consumer of. D321 gives a resource the same two verbs a\n * command has, so the same three React hooks answer for them: the state of this consumer, the attachment that moves\n * it, and the synchronisation of a slot that was already busy when this mount arrived.\n */\nfunction useCommandStatus<Input, Output>(\n currentSlot: CommandHookController<Input, Output>,\n): CommandHook<Input, Output> {\n const [hookState, setHookState] = useState<CommandHookState<Input, Output>>(() => ({\n inFlight: false,\n outcome: undefined,\n slot: currentSlot,\n }));\n useInsertionEffect(\n () =>\n currentSlot.attach((inFlight, outcome) =>\n setHookState(current => nextState(current, currentSlot, inFlight, outcome)),\n ),\n [currentSlot],\n );\n useLayoutEffect(() => currentSlot.synchronize(), [currentSlot]);\n const { inFlight, outcome } = hookState.slot === currentSlot ? hookState : emptyStatus;\n const run = currentSlot.run;\n\n return useMemo(() => ({ inFlight, outcome, run }), [inFlight, outcome, run]);\n}\n\nfunction useCommand<Input, Output>(command: Command<Input, Output>): CommandHook<Input, Output> {\n const frame = useFrame();\n const record = frame.commandRecords.get(command);\n\n if (record === undefined) {\n throw new ContributionError('missing', `Command ${command.id} is not bound in this contribution.`);\n }\n\n return useCommandStatus(useCommandSlot<Input, Output>(record.invoker));\n}\n\nexport { useCommand, useCommandStatus };\nexport type { CommandHook };\n","const idleRelease = (): void => undefined;\nconst subscribeIdle = (): (() => void) => idleRelease;\nconst idleRevision = (): number => 0;\n\nexport { idleRevision, subscribeIdle };\n","import { useInsertionEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport type { CommandHook } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { idleRevision, subscribeIdle } from './idle-subscription';\nimport type { SelectedResource } from './model-selection-snapshot';\nimport { useFrame } from './mount-context';\nimport type { Frame } from './mount-frame';\nimport { resourceInvokers } from './resource-command';\nimport type { ResourceInvokers } from './resource-command';\n\ntype CommandSelection = Readonly<Record<string, Command<never, unknown>>>;\ntype ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;\n/** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */\ntype SelectedResourceHook = Readonly<{\n pagination: Readonly<{ loadNext: CommandHook<never, unknown>; state: unknown }> | undefined;\n refresh: CommandHook<never, unknown>;\n reset: CommandHook<never, unknown>;\n retry: CommandHook<never, unknown>;\n state: unknown;\n}>;\ntype SelectionHooks = Readonly<Record<PropertyKey, CommandHook<never, unknown> | SelectedResourceHook>>;\n\nconst emptyHooks: SelectionHooks = Object.freeze({});\n\ntype CommandEntry = {\n detach: (() => void) | undefined;\n hook: CommandHook<never, unknown>;\n readonly invoker: CommandInvoker;\n readonly slot: CommandHookController<never, unknown>;\n};\n\n/** D359: one key of a selection, four consumers. The record is the value; `entries` still holds one entry per key. */\ntype ResourceEntry = {\n /** D359: the value this key hands the render, kept on the record so a still frame is the same object again. */\n hook: SelectedResourceHook;\n readonly kind: 'resource';\n readonly loadNext: CommandEntry;\n /** Whether the declaration carried the pagination capability at all. */\n readonly paginated: boolean;\n readonly refresh: CommandEntry;\n readonly reset: CommandEntry;\n readonly retry: CommandEntry;\n};\n\ntype SelectionEntry = CommandEntry | ResourceEntry;\n\nfunction isResourceEntry(entry: SelectionEntry): entry is ResourceEntry {\n return 'kind' in entry;\n}\n\nfunction createEntry(invoker: CommandInvoker): CommandEntry {\n const slot = new CommandHookController<never, unknown>(invoker);\n\n return { detach: undefined, hook: { inFlight: false, outcome: undefined, run: slot.run }, invoker, slot };\n}\n\nfunction unchangedHook(previous: CommandHook<never, unknown>, next: CommandHook<never, unknown>): boolean {\n return previous.inFlight === next.inFlight && Object.is(previous.outcome, next.outcome);\n}\n\nfunction updateEntry(entry: CommandEntry, inFlight: boolean, outcome?: CommandOutcome<unknown>): boolean {\n const previous = entry.hook;\n\n if (outcome === undefined && previous.inFlight === inFlight) return false;\n\n // D292: only a settled non-cancelled outcome replaces the one this key shows; a retry keeps the previous answer.\n const settled = outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n const next = { inFlight, outcome: settled ?? previous.outcome, run: previous.run };\n\n if (unchangedHook(previous, next)) return false;\n\n entry.hook = next;\n\n return true;\n}\n\nfunction selectEntry(previous: SelectionEntry | undefined, invoker: CommandInvoker): CommandEntry {\n return previous !== undefined && !isResourceEntry(previous) && previous.invoker === invoker\n ? previous\n : createEntry(invoker);\n}\n\nfunction resourceHook(entry: Omit<ResourceEntry, 'hook'>, selected: SelectedResource): SelectedResourceHook {\n return {\n pagination: entry.paginated ? { loadNext: entry.loadNext.hook, state: selected.pagination } : undefined,\n refresh: entry.refresh.hook,\n reset: entry.reset.hook,\n retry: entry.retry.hook,\n state: selected.state,\n };\n}\n\nfunction createResourceEntry(invokers: ResourceInvokers, selected: SelectedResource): ResourceEntry {\n const parts = {\n kind: 'resource' as const,\n loadNext: createEntry(invokers.loadNext),\n paginated: selected.pagination !== undefined,\n refresh: createEntry(invokers.refresh),\n reset: createEntry(invokers.reset),\n retry: createEntry(invokers.retry),\n };\n\n return { ...parts, hook: resourceHook(parts, selected) };\n}\n\n/** The four commands of a Resource: the three verbs every one has, and `loadNext` only where one was declared. */\nfunction unchangedResourceCommands(entry: ResourceEntry): boolean {\n const { hook } = entry;\n\n return (\n hook.refresh === entry.refresh.hook &&\n hook.reset === entry.reset.hook &&\n hook.retry === entry.retry.hook &&\n (!entry.paginated || hook.pagination?.loadNext === entry.loadNext.hook)\n );\n}\n\n/** What this selection read: the state of the Resource, and the state of its capability where it has one. */\nfunction unchangedResourceState(entry: ResourceEntry, selected: SelectedResource): boolean {\n return Object.is(entry.hook.state, selected.state) && Object.is(entry.hook.pagination?.state, selected.pagination);\n}\n\nfunction unchangedResourceHook(entry: ResourceEntry, selected: SelectedResource): boolean {\n return unchangedResourceCommands(entry) && unchangedResourceState(entry, selected);\n}\n\n/**\n * S6/D359: the same Resource that did not move answers the same object, so a child under `memo` is not re-rendered by\n * the mere act of reading it. Every part is a render input, so this is a memo and not a piece of state.\n */\nfunction selectResourceEntry(\n previous: SelectionEntry | undefined,\n invokers: ResourceInvokers,\n selected: SelectedResource,\n): ResourceEntry {\n if (previous === undefined || !isResourceEntry(previous) || previous.refresh.invoker !== invokers.refresh) {\n return createResourceEntry(invokers, selected);\n }\n\n if (!unchangedResourceHook(previous, selected)) previous.hook = resourceHook(previous, selected);\n\n return previous;\n}\n\nfunction commandEntries(entry: SelectionEntry): readonly CommandEntry[] {\n return isResourceEntry(entry) ? [entry.refresh, entry.reset, entry.retry, entry.loadNext] : [entry];\n}\n\nfunction detachEntry(entry: SelectionEntry): void {\n for (const command of commandEntries(entry)) {\n command.detach?.();\n command.detach = undefined;\n }\n}\n\nfunction hookOf(entry: SelectionEntry): CommandHook<never, unknown> | SelectedResourceHook {\n return entry.hook;\n}\n\n/** Selection is inert during render; only a committed selection can admit work or discard an old queue. */\nclass CommandGroup {\n private entries = new Map<PropertyKey, SelectionEntry>();\n /** One set of invokers per Resource identity, so `run` keeps its reference across renders (D359). */\n private readonly invokers = new WeakMap<object, ResourceInvokers>();\n private readonly listeners = new Set<() => void>();\n private revision = 0;\n\n close(): void {\n for (const entry of this.entries.values()) detachEntry(entry);\n\n this.entries.clear();\n }\n\n commit(selected: Map<PropertyKey, SelectionEntry>): void {\n for (const [key, entry] of this.entries) {\n if (selected.get(key) !== entry) detachEntry(entry);\n }\n\n this.entries = selected;\n\n for (const entry of selected.values()) this.attachEntry(entry);\n }\n\n /** S7: the attach runs on every commit, so the verbs are named rather than gathered into an array. */\n private attachEntry(entry: SelectionEntry): void {\n if (isResourceEntry(entry)) {\n this.attachCommand(entry.refresh);\n this.attachCommand(entry.retry);\n this.attachCommand(entry.reset);\n this.attachCommand(entry.loadNext);\n\n return;\n }\n\n this.attachCommand(entry);\n }\n\n private attachCommand(command: CommandEntry): void {\n command.detach ??= command.slot.attach((inFlight, outcome) => {\n if (!updateEntry(command, inFlight, outcome)) return;\n\n this.revision += 1;\n\n for (const listener of this.listeners) listener();\n });\n }\n\n getSnapshot = (): number => this.revision;\n\n /**\n * D321: two outcomes no longer, but two kinds. A command that is not bound is still a `ContributionError`; a\n * resource never appears in `frame.commandRecords`, so it is prepared from its own identity instead.\n */\n prepare(commands: CommandSelection, resources: ResourceSelection, frame: Frame): Map<PropertyKey, SelectionEntry> {\n const selected = new Map<PropertyKey, SelectionEntry>();\n\n for (const key of Reflect.ownKeys(commands)) {\n if (!Object.prototype.propertyIsEnumerable.call(commands, key)) continue;\n\n const command = (commands as Readonly<Record<PropertyKey, Command<never, unknown>>>)[key];\n const record = command === undefined ? undefined : frame.commandRecords.get(command);\n\n if (record === undefined) {\n throw new ContributionError('missing', `Command at ${String(key)} is not bound in this contribution.`);\n }\n\n selected.set(key, selectEntry(this.entries.get(key), record.invoker));\n }\n\n for (const [key, resource] of resources) {\n const invokers = resourceInvokers(resource.resource, this.invokers);\n\n selected.set(key, selectResourceEntry(this.entries.get(key), invokers, resource));\n }\n\n return selected;\n }\n\n subscribe = (listener: () => void): (() => void) => {\n this.listeners.add(listener);\n\n return () => {\n this.listeners.delete(listener);\n };\n };\n}\n\nfunction useCommandGroup(commands: CommandSelection, resources: ResourceSelection): CommandGroup | undefined {\n const groupRef = useRef<CommandGroup | undefined>(undefined);\n const populated =\n resources.size > 0 ||\n Reflect.ownKeys(commands).some(key => Object.prototype.propertyIsEnumerable.call(commands, key));\n\n return populated ? (groupRef.current ??= new CommandGroup()) : undefined;\n}\n\n/** The consumers of one selection: a command per key, and the two verbs of a resource per key (D321). */\nfunction useSelectionHooks(commands: CommandSelection, resources: ResourceSelection): SelectionHooks {\n const frame = useFrame();\n const group = useCommandGroup(commands, resources);\n const getSnapshot = group?.getSnapshot ?? idleRevision;\n useSyncExternalStore(group?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n const selected = group?.prepare(commands, resources, frame);\n useInsertionEffect(() => () => group?.close(), [group]);\n useInsertionEffect(() => {\n if (selected !== undefined) group?.commit(selected);\n });\n useLayoutEffect(() => {\n if (selected === undefined) return;\n\n // S7: the same branch as the attach — this runs after every commit, and the arrays were pure allocation.\n for (const entry of selected.values()) {\n if (isResourceEntry(entry)) {\n entry.refresh.slot.synchronize();\n entry.retry.slot.synchronize();\n entry.reset.slot.synchronize();\n entry.loadNext.slot.synchronize();\n } else entry.slot.synchronize();\n }\n });\n\n return selected === undefined\n ? emptyHooks\n : Object.fromEntries([...selected].map(([key, entry]) => [key, hookOf(entry)]));\n}\n\nexport { useSelectionHooks };\nexport type { SelectionHooks };\n","import type { Readable, ResourceView } from '@opetope/core';\nimport {\n isCallTarget,\n isReadable,\n isResourceView,\n resourceViewDemands,\n resourceViewReadable,\n} from '@opetope/core/internal';\nimport type { ResourceDemand } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\nimport type { AnyCommand } from './model-binding';\nimport { isResource } from './resource-command';\nimport type { AnyResource } from './resource-command';\n\ninterface SelectionRead {\n <Value>(source: Readable<Value>): Value;\n <Value, Selected>(source: Readable<Value>, select: (value: Value) => Selected): Selected;\n}\n\ninterface SelectionAcquire {\n <Value>(view: ResourceView<Value>): Value;\n <Value, Selected>(view: ResourceView<Value>, select: (value: Value) => Selected): Selected;\n}\n\ntype SelectionContext = Readonly<{ acquire: SelectionAcquire; read: SelectionRead }>;\ntype NonSelectionRecord =\n | readonly unknown[]\n | ((...arguments_: never[]) => unknown)\n | (abstract new (...arguments_: never[]) => unknown)\n | Date\n | PromiseLike<unknown>\n | ReadonlyMap<unknown, unknown>\n | ReadonlySet<unknown>\n | RegExp\n | WeakMap<object, unknown>\n | WeakSet<object>;\n/** A named interface needs no open index signature; container and callable results are not field selections. */\ntype SelectionShape<Selected extends object> = Selected extends NonSelectionRecord ? never : Selected;\ntype SelectionRecord = Readonly<Record<PropertyKey, unknown>>;\n/**\n * D359: the Resource a field selected, and what this selection read from it — its state, and the state of its\n * pagination capability when it has one. Both are read passively: a selection takes no lease by reading.\n */\ntype SelectedResource = Readonly<{ pagination: unknown; resource: AnyResource; state: unknown }>;\ntype SelectionSnapshot = Readonly<{\n commands: Readonly<Record<PropertyKey, AnyCommand>>;\n /** The set the mount leases; two keys naming one resource are one lease. */\n leases: ReadonlySet<ResourceDemand>;\n resources: ReadonlyMap<PropertyKey, SelectedResource>;\n sources: ReadonlySet<Readable<unknown>>;\n values: SelectionRecord;\n}>;\n\nconst noResources: ReadonlyMap<PropertyKey, SelectedResource> = new Map();\n\n/**\n * D363: what this mount read last and the snapshot it answered with. It belongs to the mount and not to the reader:\n * React may discard the `useMemo` that builds the reader, and a memory kept there would be empty exactly when it is\n * needed. D364: it no longer remembers which sources ended — a source whose owner retired stops instead of refusing,\n * so it answers its last value on every read and there is nothing to remember or to step around.\n */\ntype SelectionMemory = {\n model: unknown;\n observed: Map<Readable<unknown>, unknown> | undefined;\n select: unknown;\n snapshot: SelectionSnapshot;\n};\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction readSource<Value>(source: Readable<Value>, sources: Map<Readable<unknown>, unknown>): Value {\n if (!isReadable(source)) {\n throw new ContributionError('binding-invalid', 'Model selection read requires a Readable.');\n }\n\n if (sources.has(source)) return sources.get(source) as Value;\n\n // D364: a refusal here is the source's own failure and belongs to the render, because no lifetime ends in one.\n const value: unknown = source.getSnapshot();\n sources.set(source, value);\n\n return value as Value;\n}\n\nfunction readPassively(source: Readable<unknown>, sources: Map<Readable<unknown>, unknown>): unknown {\n if (sources.has(source)) return sources.get(source);\n\n const value: unknown = source.getSnapshot();\n sources.set(source, value);\n\n return value;\n}\n\n/** D359: the predicate that answers the question the type of the field asked, and the read that leases nothing. */\nfunction classifyResource(\n key: PropertyKey,\n value: unknown,\n resources: Map<PropertyKey, SelectedResource>,\n sources: Map<Readable<unknown>, unknown>,\n): void {\n if (!isResource(value)) return;\n\n const resource = value as AnyResource;\n const capability = (\n resource as { readonly pagination?: { readonly state: Readable<unknown> } | ResourceView<unknown> }\n ).pagination;\n\n resources.set(key, {\n pagination: capability === undefined ? undefined : readPassively(resourceViewReadable(capability), sources),\n resource,\n state: readPassively(resourceViewReadable(resource), sources),\n });\n}\n\nfunction selectedResources(resources: Map<PropertyKey, SelectedResource>): ReadonlyMap<PropertyKey, SelectedResource> {\n return resources.size === 0 ? noResources : resources;\n}\n\ntype CollectedSelection = Readonly<{\n leases: ReadonlySet<ResourceDemand>;\n resources: ReadonlyMap<PropertyKey, SelectedResource>;\n values: SelectionRecord;\n}>;\n\nfunction collectResourceDemands(\n resources: ReadonlyMap<PropertyKey, SelectedResource>,\n leases: Set<ResourceDemand>,\n): void {\n for (const { resource } of resources.values()) {\n if (isResourceView(resource)) {\n for (const demand of resourceViewDemands(resource)) leases.add(demand);\n } else {\n leases.add(resource);\n }\n }\n}\n\n/**\n * D359: recognition happens in the one pass that already walks the selection. `Resource` is a structural contract\n * (D199) and the type of a selected field promises `ResourceHook` for anything that satisfies it, so the predicate\n * this uses answers the same question the type asked. Reading the state here also puts it among `sources`, so its\n * publication invalidates the fast path of this reader exactly as a read source does.\n */\nfunction collectSelection(\n select: (context: SelectionContext) => object,\n sources: Map<Readable<unknown>, unknown>,\n): CollectedSelection {\n const leases = new Set<ResourceDemand>();\n const read = <Value, Selected>(source: Readable<Value>, project?: (value: Value) => Selected) => {\n const value = readSource(source, sources);\n\n return project === undefined ? value : project(value);\n };\n const acquire = <Value, Selected>(view: ResourceView<Value>, project?: (value: Value) => Selected) => {\n if (!isResourceView(view))\n throw new ContributionError('binding-invalid', 'Model selection acquire requires a ResourceView.');\n for (const demand of resourceViewDemands(view)) leases.add(demand);\n return read(view.observe(), project);\n };\n const selected = select({ acquire, read });\n\n if (typeof selected !== 'object' || selected === null || Array.isArray(selected)) {\n throw new ContributionError('binding-invalid', 'Model selection requires a record.');\n }\n\n const entries: (readonly [PropertyKey, unknown])[] = [];\n const resources = new Map<PropertyKey, SelectedResource>();\n\n for (const key of Reflect.ownKeys(selected)) {\n if (!Object.prototype.propertyIsEnumerable.call(selected, key)) continue;\n\n const value = (selected as SelectionRecord)[key];\n\n entries.push([key, value]);\n classifyResource(key, value, resources, sources);\n }\n\n // `__proto__` is a key like any other here, and only a defined property keeps it one (D214).\n collectResourceDemands(resources, leases);\n return { leases, resources: selectedResources(resources), values: Object.fromEntries(entries) };\n}\n\n/**\n * D359: `values` keeps the Resource itself — a stable reference — so a selection that holds one is compared by\n * `Object.is` exactly as before. What moves is the state behind it, and that is compared here: without this the\n * selection would be «equal», the previous state would be kept, and a published Resource would reach no render.\n */\nfunction equalResources(\n previous: ReadonlyMap<PropertyKey, SelectedResource>,\n next: ReadonlyMap<PropertyKey, SelectedResource>,\n): boolean {\n if (previous.size !== next.size) return false;\n\n for (const [key, selected] of next) {\n const before = previous.get(key);\n\n if (\n before?.resource !== selected.resource ||\n !Object.is(before.state, selected.state) ||\n !Object.is(before.pagination, selected.pagination)\n ) {\n return false;\n }\n }\n\n return true;\n}\n\nfunction equalMembers<Value>(previous: ReadonlySet<Value>, next: ReadonlySet<Value>): boolean {\n if (previous.size !== next.size) return false;\n for (const value of next) if (!previous.has(value)) return false;\n return true;\n}\n\nfunction equalSelection(\n previous: SelectionSnapshot,\n values: SelectionRecord,\n sources: ReadonlySet<Readable<unknown>>,\n resources: ReadonlyMap<PropertyKey, SelectedResource>,\n leases: ReadonlySet<ResourceDemand>,\n) {\n const keys = Reflect.ownKeys(values);\n const previousKeys = Reflect.ownKeys(previous.values);\n\n if (keys.length !== previousKeys.length) return false;\n if (!equalMembers(previous.sources, sources)) return false;\n if (!equalMembers(previous.leases, leases)) return false;\n\n if (!equalResources(previous.resources, resources)) return false;\n\n return keys.every((key, index) => previousKeys[index] === key && Object.is(previous.values[key], values[key]));\n}\n\ntype ModelSelector<Model> = (model: Model, context: SelectionContext) => object;\ntype SelectionReaderRef<Model> = { readonly current: ModelSelector<Model> | undefined };\n\nconst emptySelectionSnapshot: SelectionSnapshot = {\n commands: {},\n leases: noLeases,\n resources: noResources,\n sources: new Set(),\n values: {},\n};\n\nfunction selectionCommands(values: SelectionRecord): Readonly<Record<PropertyKey, AnyCommand>> {\n return Object.fromEntries(\n Reflect.ownKeys(values)\n .filter(key => isCallTarget(values[key]))\n .map(key => [key, values[key]]),\n ) as Readonly<Record<PropertyKey, AnyCommand>>;\n}\n\n/**\n * The fast path re-reads what it observed. D364: a source that stopped answers the same value it answered last, so\n * it compares equal and costs one read — there is no terminal source to record and step around any more.\n */\nfunction observedUnchanged(observed: Map<Readable<unknown>, unknown>): boolean {\n for (const [source, value] of observed) {\n if (!Object.is(source.getSnapshot(), value)) return false;\n }\n\n return true;\n}\n\n/** D363: the memory of one mount, empty until its first read and reset when the reader is built for another model. */\nfunction createSelectionMemory(): SelectionMemory {\n return { model: undefined, observed: undefined, select: undefined, snapshot: emptySelectionSnapshot };\n}\n\n/**\n * D214: one reader per model, not per render. The author's selector arrives through a ref, so an inline arrow does not\n * rebuild the reader; the fast path — nothing observed has moved — belongs to the selector that computed the snapshot,\n * so a new selector is always called again, its result compared field by field, and an equal selection keeps the\n * previous snapshot. A rejected or abandoned render still changes nothing: only a committed selection subscribes.\n *\n * D363: what the reader remembers lives in the mount's memory, so a reader React rebuilt — because it discarded the\n * memo — still knows what this selection read last.\n */\nfunction createSelectionSnapshot<Model>(\n model: Model,\n selectRef: SelectionReaderRef<Model>,\n memory: SelectionMemory,\n): () => SelectionSnapshot {\n if (memory.model !== model) {\n memory.model = model;\n memory.observed = undefined;\n memory.select = undefined;\n memory.snapshot = emptySelectionSnapshot;\n }\n\n return () => {\n const select = selectRef.current;\n\n if (select === undefined) return emptySelectionSnapshot;\n\n const observed = memory.observed;\n\n if (observed !== undefined && memory.select === select && observedUnchanged(observed)) {\n return memory.snapshot;\n }\n\n const nextObserved = new Map<Readable<unknown>, unknown>();\n const { leases, resources, values } = collectSelection(context => select(model, context), nextObserved);\n const sources = new Set(nextObserved.keys());\n\n if (observed === undefined || !equalSelection(memory.snapshot, values, sources, resources, leases)) {\n memory.snapshot = {\n commands: selectionCommands(values),\n leases,\n resources,\n sources,\n values,\n };\n }\n\n memory.observed = nextObserved;\n memory.select = select;\n\n return memory.snapshot;\n };\n}\n\nexport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot };\nexport type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionShape, SelectionSnapshot };\n","import type { Readable } from '@opetope/core';\nimport { createAggregateError } from '@opetope/core/internal';\n\nimport type { ResourceDemand } from '@opetope/core/internal';\n\ntype Subscription = { dispose: (() => void) | undefined };\ntype Listener = Readonly<{ notify: () => void }>;\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction releaseSubscriptions(subscriptions: Iterable<Subscription>, failures: unknown[] = []): void {\n for (const subscription of subscriptions) {\n const dispose = subscription.dispose;\n subscription.dispose = undefined;\n\n try {\n dispose?.();\n } catch (error) {\n failures.push(error);\n }\n }\n\n if (failures.length === 1) throw failures[0];\n\n if (failures.length > 1) throw createAggregateError(failures, 'Model selection sources failed to release.');\n}\n\n/** A subscription set, not a scheduler: source notifications use React's snapshot consistency check. */\nclass ModelSelectionStore {\n private enabled = false;\n /** D359: one lease per Resource identity, diffed like a subscription, so an unchanged selection takes none. */\n private readonly leases = new Map<ResourceDemand, Subscription>();\n private readonly listeners = new Set<Listener>();\n private retained: ReadonlySet<ResourceDemand> = noLeases;\n private sources: ReadonlySet<Readable<unknown>> = new Set();\n private readonly subscriptions = new Map<Readable<unknown>, Subscription>();\n\n close(): void {\n this.enabled = false;\n this.sources = new Set();\n this.retained = noLeases;\n this.releaseAll();\n }\n\n commit(sources: ReadonlySet<Readable<unknown>>, retained: ReadonlySet<ResourceDemand> = noLeases): void {\n this.sources = sources;\n this.retained = retained;\n this.enabled = true;\n\n try {\n this.synchronize();\n } catch (error) {\n this.releaseAll([error]);\n }\n }\n\n subscribe = (notify: () => void): (() => void) => {\n const listener = { notify };\n this.listeners.add(listener);\n\n try {\n this.synchronize();\n } catch (error) {\n this.listeners.delete(listener);\n this.releaseAll([error]);\n }\n\n return () => {\n this.listeners.delete(listener);\n\n if (this.listeners.size === 0) this.releaseAll();\n };\n };\n\n private add(source: Readable<unknown>): void {\n const subscription: Subscription = { dispose: undefined };\n // Reserve before foreign code: a synchronous notification may replace or close this selection.\n this.subscriptions.set(source, subscription);\n const dispose = source.subscribe(this.notify);\n\n if (typeof dispose !== 'function') throw new TypeError('Model selection source must return a disposer.');\n\n if (this.subscriptions.get(source) === subscription) subscription.dispose = dispose;\n else dispose();\n }\n\n private notify = (): void => {\n for (const listener of [...this.listeners]) {\n if (this.listeners.has(listener)) listener.notify();\n }\n };\n\n private releaseAll(failures?: unknown[]): void {\n const held = [...this.subscriptions.values(), ...this.leases.values()];\n this.subscriptions.clear();\n this.leases.clear();\n releaseSubscriptions(held, failures);\n }\n\n private removeUnselected(): void {\n const removed: Subscription[] = [];\n\n for (const [source, subscription] of this.subscriptions) {\n if (this.sources.has(source)) continue;\n\n this.subscriptions.delete(source);\n removed.push(subscription);\n }\n\n for (const [resource, lease] of this.leases) {\n if (this.retained.has(resource)) continue;\n\n this.leases.delete(resource);\n removed.push(lease);\n }\n\n releaseSubscriptions(removed);\n }\n\n /**\n * D321: `retain()` is reentrant — it reaches `activate()`, the target subscription, the first read and the\n * publication that follows, all synchronously — and a listener woken there may rebuild or close this selection.\n * The record is reserved first, the lease is taken second, and it is kept only if the record is still this one.\n */\n private retain(resource: ResourceDemand): void {\n const lease: Subscription = { dispose: undefined };\n this.leases.set(resource, lease);\n const release = resource.acquire();\n\n if (typeof release !== 'function') throw new TypeError('Model selection resource must answer a release disposer.');\n\n if (this.leases.get(resource) === lease) lease.dispose = release;\n else release();\n }\n\n /** Foreign code inside a subscription or a lease may replace this selection, so both loops ask again. */\n private ready(): boolean {\n return this.enabled && this.listeners.size > 0;\n }\n\n private retainSelected(): void {\n for (const resource of this.retained) {\n if (!this.ready()) return;\n\n if (this.retained.has(resource) && !this.leases.has(resource)) this.retain(resource);\n }\n }\n\n private subscribeSources(): void {\n for (const source of this.sources) {\n if (!this.ready()) return;\n\n if (this.sources.has(source) && !this.subscriptions.has(source)) this.add(source);\n }\n }\n\n private synchronize(): void {\n this.removeUnselected();\n this.subscribeSources();\n this.retainSelected();\n }\n}\n\nexport { ModelSelectionStore };\n","import { useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command, ModelOf, PaginatedResource, Resource } from '@opetope/core';\n\nimport type { CommandHook } from './command-hook';\nimport { useSelectionHooks } from './selection-hooks';\nimport type { SelectionHooks } from './selection-hooks';\nimport { ContributionError } from './errors';\nimport { subscribeIdle } from './idle-subscription';\nimport type { AnyModel } from './model-binding';\nimport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot } from './model-selection-snapshot';\nimport type {\n ModelSelector,\n SelectionContext,\n SelectionMemory,\n SelectionShape,\n SelectionSnapshot,\n} from './model-selection-snapshot';\nimport { ModelSelectionStore } from './model-selection-store';\nimport { useFrame } from './mount-context';\nimport type { PaginatedResourceHook, ResourceHook, ResourceKey } from './resource-command';\n\n/**\n * D359: a field whose value is a Resource answers the hook `useResource` answers, and the mount leases it exactly as\n * `useResource` does. `read(resource.state)` is unchanged — it hands out the state and leases nothing — so naming one\n * Resource both ways registers it twice: the subscription and the lease are independent.\n */\ntype SelectedValue<Value> =\n Value extends Command<infer Input, infer Output>\n ? CommandHook<Input, Output>\n : Value extends PaginatedResource<\n infer Data,\n infer Key extends ResourceKey,\n infer Cursor extends ResourceKey,\n 'consumers' | 'owner'\n >\n ? PaginatedResourceHook<Data, Key, Cursor>\n : Value extends Resource<infer Data, infer Key extends ResourceKey, 'consumers' | 'owner'>\n ? ResourceHook<Data, Key>\n : Value;\ntype ModelSelection<Selected> = { readonly [Key in keyof Selected]: SelectedValue<Selected[Key]> };\n\nconst readEmptySnapshot = () => emptySelectionSnapshot;\n\nfunction useSelectionStore(selected: boolean): ModelSelectionStore | undefined {\n const storeRef = useRef<ModelSelectionStore | undefined>(undefined);\n\n return selected ? (storeRef.current ??= new ModelSelectionStore()) : undefined;\n}\n\n/**\n * Two branches of one key: the consumer this selection prepared — a bound command, or the verbs, the state and the\n * capability of a selected Resource — and otherwise the value the selector wrote. S6/D359: the Resource branch is\n * assembled on the record and not here, so a key whose state did not move hands back the very same object.\n */\nfunction mergeSelection(snapshot: SelectionSnapshot, hooks: SelectionHooks): unknown {\n return Object.fromEntries(\n Reflect.ownKeys(snapshot.values).map(key => [\n key,\n Object.prototype.hasOwnProperty.call(hooks, key) ? hooks[key] : snapshot.values[key],\n ]),\n );\n}\n\n/** D205: resolve only a granted model, explicitly read data, and reuse the ordinary per-key command consumers. */\nfunction useModel<Declaration extends AnyModel>(declaration: Declaration): ModelOf<Declaration>;\nfunction useModel<Declaration extends AnyModel, const Selected extends object>(\n declaration: Declaration,\n select: (model: ModelOf<Declaration>, context: SelectionContext) => Selected & SelectionShape<Selected>,\n): ModelSelection<Selected>;\nfunction useModel<Declaration extends AnyModel>(\n declaration: Declaration,\n select?: (model: ModelOf<Declaration>, context: SelectionContext) => object,\n): unknown {\n const frame = useFrame();\n\n if (!frame.models.has(declaration)) {\n throw new ContributionError('missing', `Model ${declaration.id} is not granted to this contribution.`);\n }\n\n const model = frame.models.get(declaration) as ModelOf<Declaration>;\n const store = useSelectionStore(select !== undefined);\n // D214: the selector of this render, read by a reader that belongs to the model. Writing the latest callback into\n // a ref is what `useSyncExternalStoreWithSelector` does: the reader only reads it, and never writes to it.\n const selectRef = useRef<ModelSelector<ModelOf<Declaration>> | undefined>(undefined);\n selectRef.current = select;\n const selected = select !== undefined;\n // D363: the memory of this selection belongs to the mount, so a reader React rebuilt keeps what it read last.\n const memoryRef = useRef<SelectionMemory | undefined>(undefined);\n const memory = (memoryRef.current ??= createSelectionMemory());\n const getSnapshot = useMemo(\n () => (selected ? createSelectionSnapshot(model, selectRef, memory) : readEmptySnapshot),\n [memory, model, selected],\n );\n const snapshot = useSyncExternalStore(store?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n const hooks = useSelectionHooks(snapshot.commands, snapshot.resources);\n useLayoutEffect(() => () => store?.close(), [store]);\n // D359: a lease is taken in commit and never in a render, and the store diffs the set by identity.\n useLayoutEffect(() => store?.commit(snapshot.sources, snapshot.leases), [snapshot, store]);\n\n if (select === undefined) return model;\n\n return mergeSelection(snapshot, hooks);\n}\n\nexport { useModel };\n","import type { FunctionComponent } from 'react';\n\nimport type { ModelIdentity } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\n\ntype AnyModel = ModelIdentity;\n\n/**\n * The marker a component uses to state which UI models of its contribution it reads. `slot` checks by type that the\n * contribution grants every model of this list — it may grant more, because the mount serves its whole instance.\n *\n * The runtime authority is the mount frame, not this marker: `useModel` resolves against what the mount was given\n * and refuses anything else. The lint rule `opetope/require-declared-models` checks visible contribution sites and\n * each reader of a per-mount model within the same module. Imported implementations and dynamic declaration lists\n * remain unknown to this syntactic check (D85, D158, D250).\n */\ntype ComponentRequiringModels<Props, Models extends readonly AnyModel[]> = FunctionComponent<Props> & {\n readonly requires: Models;\n};\n\nfunction requiresModels<const Models extends readonly AnyModel[]>(\n models: Models,\n): <Props>(component: FunctionComponent<Props>) => ComponentRequiringModels<Props, Models> {\n const declared = Object.freeze([...models]) as unknown as Models;\n\n return <Props>(component: FunctionComponent<Props>): ComponentRequiringModels<Props, Models> => {\n const existing = (component as { readonly requires?: readonly AnyModel[] }).requires;\n\n if (existing !== undefined) {\n throw new ContributionError('duplicate', 'Component already declares the models it requires.');\n }\n\n Object.defineProperty(component, 'requires', { enumerable: false, value: declared });\n\n return component as ComponentRequiringModels<Props, Models>;\n };\n}\n\nexport { requiresModels };\n","import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from 'react';\n\nimport type { PaginatedResource, PaginationState, Readable, Resource } from '@opetope/core';\nimport type { ResourceKey } from '@opetope/core/internal';\nimport { acquireResourceDemand, resourceViewReadable } from '@opetope/core/internal';\n\nimport { useCommandStatus } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport { createResourceInvokers, paginationOf } from './resource-command';\nimport type { AnyResource, PaginatedResourceHook, ResourceHook, ResourcePaginationHook } from './resource-command';\n\ntype ResourceSlots = Readonly<{\n loadNext: CommandHookController<void, unknown>;\n refresh: CommandHookController<void, unknown>;\n reset: CommandHookController<void, unknown>;\n retry: CommandHookController<void, unknown>;\n}>;\n\n/**\n * D359: one set of controllers per Resource identity, exactly as `useCommandSlot` keeps one per invoker. The slots are\n * what the set of invokers is kept alive by, so one map answers for all four. Slots are inert until commit, so an\n * interrupted render neither admits work nor resets the status of the committed one.\n */\nfunction useResourceSlots(resource: AnyResource): ResourceSlots {\n const [cache] = useState(() => new WeakMap<object, ResourceSlots>());\n const existing = cache.get(resource);\n\n if (existing !== undefined) return existing;\n\n const invokers = createResourceInvokers(resource);\n const slots: ResourceSlots = {\n loadNext: new CommandHookController<void, unknown>(invokers.loadNext),\n refresh: new CommandHookController<void, unknown>(invokers.refresh),\n reset: new CommandHookController<void, unknown>(invokers.reset),\n retry: new CommandHookController<void, unknown>(invokers.retry),\n };\n cache.set(resource, slots);\n\n return slots;\n}\n\nconst unavailablePagination: PaginationState<ResourceKey> = Object.freeze({\n kind: 'unavailable',\n reason: 'resource-not-ready',\n});\nconst noPaginationSource: Readable<PaginationState<ResourceKey>> = Object.freeze({\n getSnapshot: () => unavailablePagination,\n subscribe: () => () => undefined,\n});\n\n/**\n * D359: the state of a Resource, the lease that keeps it open for as long as this component is mounted, and its verbs\n * as commands. The number of React hooks here does not depend on the Resource: a declaration without `pagination`\n * subscribes to a constant source and keeps a `loadNext` that answers `skipped`.\n */\nfunction useResource<Data, Key extends ResourceKey, Cursor extends ResourceKey>(\n resource: PaginatedResource<Data, Key, Cursor, 'consumers' | 'owner'>,\n): PaginatedResourceHook<Data, Key, Cursor>;\nfunction useResource<Data, Key extends ResourceKey>(\n resource: Resource<Data, Key, 'consumers' | 'owner'>,\n): ResourceHook<Data, Key>;\nfunction useResource<Data, Key extends ResourceKey>(\n resource: Resource<Data, Key, 'consumers' | 'owner'>,\n): ResourceHook<Data, Key> {\n const handle = resource as unknown as AnyResource;\n const capability = paginationOf(handle);\n const subscribe = useCallback(\n (listener: () => void) => resourceViewReadable(resource).subscribe(listener),\n [resource],\n );\n /*\n * D364: `resource.state` is a total `Readable` for the life of the object this hook holds — a retired one answers\n * `idle('retired')` — so the read needs no memory of its own. What it can still refuse is a producer failure, a\n * broken `nextCursor` among them (D356), and that belongs to the render (G13).\n */\n const getState = useMemo(() => () => resourceViewReadable(resource).getSnapshot(), [resource]);\n const state = useSyncExternalStore(subscribe, getState, getState);\n const paginationSource: Readable<PaginationState<ResourceKey>> =\n capability === undefined ? noPaginationSource : resourceViewReadable(capability);\n const subscribePagination = useCallback(\n (listener: () => void) => paginationSource.subscribe(listener),\n [paginationSource],\n );\n const getPaginationState = useMemo(() => () => paginationSource.getSnapshot(), [paginationSource]);\n const paginationState = useSyncExternalStore(subscribePagination, getPaginationState, getPaginationState);\n\n // D349: the lease is taken in a commit effect, so an interrupted render opens nothing.\n useEffect(() => acquireResourceDemand(resource), [resource]);\n\n const slots = useResourceSlots(handle);\n const refresh = useCommandStatus(slots.refresh);\n const retry = useCommandStatus(slots.retry);\n const reset = useCommandStatus(slots.reset);\n const loadNext = useCommandStatus(slots.loadNext);\n const pagination = useMemo(\n () =>\n capability === undefined\n ? undefined\n : ({ loadNext, state: paginationState } as unknown as ResourcePaginationHook<ResourceKey>),\n [capability, loadNext, paginationState],\n );\n\n return useMemo(\n () => ({ pagination, refresh, reset, retry, state }) as ResourceHook<Data, Key>,\n [pagination, refresh, reset, retry, state],\n );\n}\n\nexport { useResource };\n","import type { ComponentType, ReactNode } from 'react';\nimport { createElement, Fragment } from 'react';\n\nimport type { DeclarationId } from '@opetope/core';\nimport { declarationId } from '@opetope/core';\nimport type { ContributionTarget } from '@opetope/core/internal';\nimport { createContributionTarget } from '@opetope/core/internal';\nimport type { ContributionModel } from '@opetope/runtime/internal';\n\nimport { contributionAuthority, ContributionMount } from './contribution-frame';\nimport { useReadable } from './readable-hooks';\n\ntype SlotProperties = object | undefined;\ntype EmptySlotProperties = Readonly<Record<string, never>>;\ntype SlotComponentProperties<Props extends SlotProperties> = [Props] extends [undefined]\n ? EmptySlotProperties\n : Extract<Props, object>;\n\n/**\n * What a contribution publishes: the component, the optional props adapter and the optional UI models the mount\n * creates. Without an adapter the component takes the slot props; with one it takes exactly the adapter result (D85).\n */\ntype SlotContribution<Props extends SlotProperties = undefined> = {\n readonly Component: ComponentType<never>;\n readonly models?: readonly ContributionModel[];\n readonly props?: (slotProps: SlotComponentProperties<Props>) => object;\n};\n\ntype SlotTarget<Props extends SlotProperties = undefined> = ContributionTarget<SlotContribution<Props>>;\n\ntype SwitchSlotTarget<Route extends string, Props extends SlotProperties = undefined> = ((\n route: Route,\n) => SlotTarget<Props>) & {\n readonly id: DeclarationId;\n};\n\ntype SlotRenderProps<Props extends SlotProperties> = [Props] extends [undefined]\n ? {\n readonly props?: never;\n readonly target: SlotTarget<Props>;\n }\n : {\n readonly props: SlotComponentProperties<Props>;\n readonly target: SlotTarget<Props>;\n };\n\nconst emptySlotProperties: EmptySlotProperties = Object.freeze({});\n\n/** D280: a slot is a name, so it takes its id as the first argument. */\nfunction defineSlot<Props extends SlotProperties = undefined>(id: string): SlotTarget<Props> {\n return createContributionTarget<SlotContribution<Props>>(id, 'slot');\n}\n\nfunction defineSwitchSlot<Route extends string, Props extends SlotProperties = undefined>(\n id: string,\n): SwitchSlotTarget<Route, Props> {\n const declared = declarationId(id);\n const targets = new Map<Route, SlotTarget<Props>>();\n\n const switchSlot = (route: Route): SlotTarget<Props> => {\n const existing = targets.get(route);\n\n if (existing !== undefined) return existing;\n\n const target = defineSlot<Props>(`${declared}/${route}`);\n targets.set(route, target);\n\n return target;\n };\n\n Object.defineProperty(switchSlot, 'id', { enumerable: true, value: declared });\n\n return Object.freeze(switchSlot) as SwitchSlotTarget<Route, Props>;\n}\n\n/**\n * Every contribution renders inside its own mount: the models its generation owns plus the UI models it declared,\n * created on mount and closed on unmount (D70, D85).\n */\nfunction Slot<Props extends SlotProperties>(options: SlotRenderProps<Props>): ReactNode {\n const entries = useReadable(options.target.entries);\n const slotProps: object = 'props' in options ? (options.props ?? emptySlotProperties) : emptySlotProperties;\n\n if (entries.length === 0) return null;\n\n return entries.map(entry =>\n createElement(\n Fragment,\n { key: entry.id },\n createElement(ContributionMount, {\n authority: contributionAuthority(entry),\n contribution: entry.value,\n contributionId: entry.id,\n slotProps,\n targetId: options.target.id,\n }),\n ),\n );\n}\n\nexport { defineSlot, defineSwitchSlot, Slot };\nexport type { SlotComponentProperties, SlotContribution, SlotProperties, SlotTarget, SwitchSlotTarget };\n"],"names":["failureOutcome","options","error","isCancellation","notification","_a","reportDetachedError","callbackError","runOptions","onSuccess","signal","requestOf","input","resolve","promise","settle","request","outcome","CommandHookController","ContributionError","aborted","invoker","notify","CommandError","compatibleAbortReason","invocation","value","emptyStatus","settledOutcome","unchangedState","current","slot","inFlight","settled","nextState","previous","useCommandSlot","slots","useState","useCommandStatus","currentSlot","hookState","setHookState","useInsertionEffect","useLayoutEffect","run","useMemo","useCommand","command","record","useFrame","idleRelease","subscribeIdle","idleRevision","emptyHooks","isResourceEntry","entry","createEntry","unchangedHook","next","updateEntry","selectEntry","resourceHook","selected","createResourceEntry","invokers","parts","unchangedResourceCommands","hook","unchangedResourceState","unchangedResourceHook","selectResourceEntry","commandEntries","detachEntry","hookOf","CommandGroup","key","listener","commands","resources","frame","resource","resourceInvokers","useCommandGroup","groupRef","useRef","useSelectionHooks","group","getSnapshot","useSyncExternalStore","noResources","noLeases","readSource","source","sources","isReadable","readPassively","classifyResource","isResource","capability","resourceViewReadable","selectedResources","collectResourceDemands","leases","isResourceView","demand","resourceViewDemands","collectSelection","select","read","project","view","entries","equalResources","before","equalMembers","equalSelection","values","keys","previousKeys","index","emptySelectionSnapshot","selectionCommands","isCallTarget","observedUnchanged","observed","createSelectionMemory","createSelectionSnapshot","model","selectRef","memory","nextObserved","context","releaseSubscriptions","subscriptions","failures","subscription","dispose","createAggregateError","ModelSelectionStore","retained","held","removed","lease","release","readEmptySnapshot","useSelectionStore","storeRef","mergeSelection","snapshot","hooks","useModel","declaration","store","memoryRef","requiresModels","models","declared","component","useResourceSlots","cache","existing","createResourceInvokers","unavailablePagination","noPaginationSource","useResource","handle","paginationOf","subscribe","useCallback","getState","state","paginationSource","subscribePagination","getPaginationState","paginationState","useEffect","acquireResourceDemand","refresh","retry","reset","loadNext","pagination","emptySlotProperties","defineSlot","id","createContributionTarget","defineSwitchSlot","declarationId","targets","switchSlot","route","target","Slot","useReadable","slotProps","createElement","Fragment","ContributionMount","contributionAuthority"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../src/command-hook-controller.ts","../src/command-hook.ts","../src/idle-subscription.ts","../src/selection-hooks.ts","../src/model-selection-snapshot.ts","../src/model-selection-store.ts","../src/model-hook.ts","../src/requires-models.ts","../src/resource-hook.ts","../src/slot.tsx"],"sourcesContent":["import { CommandError } from '@opetope/core';\nimport { compatibleAbortReason, isCancellation, reportDetachedError } from '@opetope/core/internal';\nimport type { CommandInputArgs, CallRunOptions } from '@opetope/core/internal';\n\nimport type { CommandOutcome } from './command';\nimport { ContributionError } from './errors';\n\ntype CommandRunOptions<Output> = Readonly<{\n onFailure?: (error: unknown) => PromiseLike<void> | void;\n onSuccess?: (value: Output) => PromiseLike<void> | void;\n signal?: AbortSignal;\n}>;\n\ntype CommandRun<Input, Output> = {\n (input: Input, options?: CommandRunOptions<Output>): Promise<CommandOutcome<Output>>;\n (...args: [...CommandInputArgs<Input>, options?: CommandRunOptions<Output>]): Promise<CommandOutcome<Output>>;\n};\n\ntype CommandInvoker = Readonly<{\n run: (input: never, options?: CallRunOptions<unknown>) => Promise<unknown>;\n}>;\n\ntype CommandNotification<Output> = (inFlight: boolean, outcome?: CommandOutcome<Output>) => void;\n\ntype CommandRequest<Input, Output> = {\n input: Input | undefined;\n options: CommandRunOptions<Output> | undefined;\n readonly promise: Promise<CommandOutcome<Output>>;\n resolve: ((outcome: CommandOutcome<Output>) => void) | undefined;\n};\n\nfunction failureOutcome<Output>(options: CommandRunOptions<Output> | undefined, error: unknown): CommandOutcome<never> {\n if (isCancellation(error)) return { reason: error, kind: 'cancelled' };\n\n try {\n const notification = options?.onFailure?.(error);\n\n if (notification !== undefined) void Promise.resolve(notification).catch(reportDetachedError);\n } catch (callbackError) {\n reportDetachedError(callbackError);\n }\n\n return { error, kind: 'failed' };\n}\n\nfunction runOptions<Output>(options: CommandRunOptions<Output> | undefined): CallRunOptions<Output> | undefined {\n const onSuccess = options?.onSuccess;\n const signal = options?.signal;\n\n if (onSuccess === undefined) return signal === undefined ? undefined : { signal };\n\n return signal === undefined ? { onSuccess } : { onSuccess, signal };\n}\n\nfunction requestOf<Input, Output>(\n input: Input,\n options: CommandRunOptions<Output> | undefined,\n): CommandRequest<Input, Output> {\n let resolve!: (outcome: CommandOutcome<Output>) => void;\n const promise = new Promise<CommandOutcome<Output>>(settle => {\n resolve = settle;\n });\n\n return { input, options: options === undefined ? undefined : { ...options }, promise, resolve };\n}\n\nfunction settle<Input, Output>(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n const resolve = request.resolve;\n request.input = undefined;\n request.options = undefined;\n request.resolve = undefined;\n resolve?.(outcome);\n}\n\n/**\n * D203: the consumer keeps a status, not a schedule. Every `run` reaches the command, and what the command was\n * declared with — `concurrency`, `memoize`, `dedupe` — decides what happens to it. What stays\n * local is what only this consumer knows: whether it is mounted, its own input signal, and the outcome it shows.\n */\nclass CommandHookController<Input, Output> {\n readonly run: CommandRun<Input, Output> = ((input: Input, options?: CommandRunOptions<Output>) => {\n if (this.notify === undefined) {\n return Promise.resolve({\n reason: new ContributionError('inactive', 'Command consumer is not mounted.'),\n kind: 'cancelled' as const,\n });\n }\n\n const aborted = this.cancelledInput(options);\n\n if (aborted !== undefined) return Promise.resolve(aborted);\n\n const request = requestOf(input, options);\n this.start(request);\n\n return request.promise;\n }) as CommandRun<Input, Output>;\n private inFlight = 0;\n private notify: CommandNotification<Output> | undefined;\n\n constructor(private readonly invoker: CommandInvoker) {}\n\n attach(notify: CommandNotification<Output>): () => void {\n this.notify = notify;\n\n return () => {\n if (this.notify !== notify) return;\n\n this.notify = undefined;\n };\n }\n\n synchronize(): void {\n this.notify?.(this.inFlight > 0);\n }\n\n private aborted(signal: AbortSignal): CommandOutcome<never> {\n return {\n reason: new CommandError('cancelled', 'Command input was cancelled.', compatibleAbortReason(signal)),\n kind: 'cancelled',\n };\n }\n\n private cancelledInput(options: CommandRunOptions<Output> | undefined): CommandOutcome<never> | undefined {\n return options?.signal?.aborted === true ? this.aborted(options.signal) : undefined;\n }\n\n private finish(request: CommandRequest<Input, Output>, outcome: CommandOutcome<Output>): void {\n if (request.resolve === undefined) return;\n\n this.inFlight -= 1;\n settle(request, outcome);\n this.notify?.(this.inFlight > 0, outcome);\n }\n\n private invoke(request: CommandRequest<Input, Output>): void {\n let invocation: Promise<Output>;\n\n try {\n invocation = this.invoker.run(request.input as never, runOptions(request.options) as never) as Promise<Output>;\n request.input = undefined;\n } catch (error) {\n this.finish(request, failureOutcome(request.options, error));\n\n return;\n }\n\n void invocation.then(\n value => this.finish(request, { kind: 'ok', value }),\n (error: unknown) => this.finish(request, failureOutcome(request.options, error)),\n );\n }\n\n private start(request: CommandRequest<Input, Output>): void {\n this.inFlight += 1;\n // Reserve the flight before publishing: a reentrant run must already see this consumer as busy.\n this.notify?.(true);\n this.invoke(request);\n }\n}\n\nexport { CommandHookController };\nexport type { CommandInvoker, CommandRun };\n","import { useInsertionEffect, useLayoutEffect, useMemo, useState } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker, CommandRun } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { useFrame } from './mount-context';\n\n/** D292: a cancellation is not an answer of the product, so it never settles into the outcome this hook shows. */\ntype SettledOutcome<Output> = Exclude<CommandOutcome<Output>, { readonly kind: 'cancelled' }>;\n\ninterface CommandHookStatus<Output> {\n readonly inFlight: boolean;\n readonly outcome: SettledOutcome<Output> | undefined;\n}\n\nconst emptyStatus: CommandHookStatus<never> = { inFlight: false, outcome: undefined };\n\ntype CommandHook<Input, Output> = CommandHookStatus<Output> & {\n readonly run: CommandRun<Input, Output>;\n};\n\ntype CommandHookState<Input, Output> = CommandHookStatus<Output> & {\n readonly slot: CommandHookController<Input, Output>;\n};\n\n/** D292: a cancellation moves nothing, so it is the same non-event as a notification without an outcome at all. */\nfunction settledOutcome<Output>(outcome: CommandOutcome<Output> | undefined): SettledOutcome<Output> | undefined {\n return outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n}\n\nfunction unchangedState<Input, Output>(\n current: CommandHookState<Input, Output>,\n slot: CommandHookController<Input, Output>,\n inFlight: boolean,\n settled: SettledOutcome<Output> | undefined,\n): boolean {\n return settled === undefined && current.slot === slot && current.inFlight === inFlight;\n}\n\nfunction nextState<Input, Output>(\n current: CommandHookState<Input, Output>,\n slot: CommandHookController<Input, Output>,\n inFlight: boolean,\n outcome?: CommandOutcome<Output>,\n): CommandHookState<Input, Output> {\n const settled = settledOutcome(outcome);\n\n if (unchangedState(current, slot, inFlight, settled)) return current;\n\n // A new run clears nothing: the previous answer stays readable while its retry is in flight.\n const previous = current.slot === slot ? current.outcome : undefined;\n\n return { inFlight, outcome: settled ?? previous, slot };\n}\n\nfunction useCommandSlot<Input, Output>(invoker: CommandInvoker): CommandHookController<Input, Output> {\n // Slots are inert until commit. An interrupted render cannot fence the committed source or admit its own work.\n const [slots] = useState(() => new WeakMap<object, CommandHookController<Input, Output>>());\n let slot = slots.get(invoker);\n\n if (slot === undefined) {\n slot = new CommandHookController(invoker);\n slots.set(invoker, slot);\n }\n\n return slot;\n}\n\n/**\n * The status half of a consumer, apart from what it is a consumer of. D321 gives a resource the same two verbs a\n * command has, so the same three React hooks answer for them: the state of this consumer, the attachment that moves\n * it, and the synchronisation of a slot that was already busy when this mount arrived.\n */\nfunction useCommandStatus<Input, Output>(\n currentSlot: CommandHookController<Input, Output>,\n): CommandHook<Input, Output> {\n const [hookState, setHookState] = useState<CommandHookState<Input, Output>>(() => ({\n inFlight: false,\n outcome: undefined,\n slot: currentSlot,\n }));\n useInsertionEffect(\n () =>\n currentSlot.attach((inFlight, outcome) =>\n setHookState(current => nextState(current, currentSlot, inFlight, outcome)),\n ),\n [currentSlot],\n );\n useLayoutEffect(() => currentSlot.synchronize(), [currentSlot]);\n const { inFlight, outcome } = hookState.slot === currentSlot ? hookState : emptyStatus;\n const run = currentSlot.run;\n\n return useMemo(() => ({ inFlight, outcome, run }), [inFlight, outcome, run]);\n}\n\nfunction useCommand<Input, Output>(command: Command<Input, Output>): CommandHook<Input, Output> {\n const frame = useFrame();\n const record = frame.commandRecords.get(command);\n\n if (record === undefined) {\n throw new ContributionError('missing', `Command ${command.id} is not bound in this contribution.`);\n }\n\n return useCommandStatus(useCommandSlot<Input, Output>(record.invoker));\n}\n\nexport { useCommand, useCommandStatus };\nexport type { CommandHook };\n","const idleRelease = (): void => undefined;\nconst subscribeIdle = (): (() => void) => idleRelease;\nconst idleRevision = (): number => 0;\n\nexport { idleRevision, subscribeIdle };\n","import { useInsertionEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command } from '@opetope/core';\n\nimport type { CommandOutcome } from './command';\nimport type { CommandHook } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport type { CommandInvoker } from './command-hook-controller';\nimport { ContributionError } from './errors';\nimport { idleRevision, subscribeIdle } from './idle-subscription';\nimport type { SelectedResource } from './model-selection-snapshot';\nimport { useFrame } from './mount-context';\nimport type { Frame } from './mount-frame';\nimport { resourceInvokers } from './resource-command';\nimport type { ResourceInvokers } from './resource-command';\n\ntype CommandSelection = Readonly<Record<string, Command<never, unknown>>>;\ntype ResourceSelection = ReadonlyMap<PropertyKey, SelectedResource>;\n/** D359: what one selected Resource answers — its three verbs, its state, and the pagination capability if it has one. */\ntype SelectedResourceHook = Readonly<{\n pagination: Readonly<{ loadNext: CommandHook<never, unknown>; state: unknown }> | undefined;\n refresh: CommandHook<never, unknown>;\n reset: CommandHook<never, unknown>;\n retry: CommandHook<never, unknown>;\n state: unknown;\n}>;\ntype SelectionHooks = Readonly<Record<PropertyKey, CommandHook<never, unknown> | SelectedResourceHook>>;\n\nconst emptyHooks: SelectionHooks = Object.freeze({});\n\ntype CommandEntry = {\n detach: (() => void) | undefined;\n hook: CommandHook<never, unknown>;\n readonly invoker: CommandInvoker;\n readonly slot: CommandHookController<never, unknown>;\n};\n\n/** D359: one key of a selection, four consumers. The record is the value; `entries` still holds one entry per key. */\ntype ResourceEntry = {\n /** D359: the value this key hands the render, kept on the record so a still frame is the same object again. */\n readonly hook: SelectedResourceHook;\n readonly kind: 'resource';\n readonly loadNext: CommandEntry;\n /** Whether the declaration carried the pagination capability at all. */\n readonly paginated: boolean;\n readonly refresh: CommandEntry;\n readonly reset: CommandEntry;\n readonly retry: CommandEntry;\n};\n\ntype SelectionEntry = CommandEntry | ResourceEntry;\n\nfunction isResourceEntry(entry: SelectionEntry): entry is ResourceEntry {\n return 'kind' in entry;\n}\n\nfunction createEntry(invoker: CommandInvoker): CommandEntry {\n const slot = new CommandHookController<never, unknown>(invoker);\n\n return { detach: undefined, hook: { inFlight: false, outcome: undefined, run: slot.run }, invoker, slot };\n}\n\nfunction unchangedHook(previous: CommandHook<never, unknown>, next: CommandHook<never, unknown>): boolean {\n return previous.inFlight === next.inFlight && Object.is(previous.outcome, next.outcome);\n}\n\nfunction updateEntry(entry: CommandEntry, inFlight: boolean, outcome?: CommandOutcome<unknown>): boolean {\n const previous = entry.hook;\n\n if (outcome === undefined && previous.inFlight === inFlight) return false;\n\n // D292: only a settled non-cancelled outcome replaces the one this key shows; a retry keeps the previous answer.\n const settled = outcome === undefined || outcome.kind === 'cancelled' ? undefined : outcome;\n const next = { inFlight, outcome: settled ?? previous.outcome, run: previous.run };\n\n if (unchangedHook(previous, next)) return false;\n\n entry.hook = next;\n\n return true;\n}\n\nfunction selectEntry(previous: SelectionEntry | undefined, invoker: CommandInvoker): CommandEntry {\n return previous !== undefined && !isResourceEntry(previous) && previous.invoker === invoker\n ? previous\n : createEntry(invoker);\n}\n\nfunction resourceHook(entry: Omit<ResourceEntry, 'hook'>, selected: SelectedResource): SelectedResourceHook {\n return {\n pagination: entry.paginated ? { loadNext: entry.loadNext.hook, state: selected.pagination } : undefined,\n refresh: entry.refresh.hook,\n reset: entry.reset.hook,\n retry: entry.retry.hook,\n state: selected.state,\n };\n}\n\nfunction createResourceEntry(invokers: ResourceInvokers, selected: SelectedResource): ResourceEntry {\n const parts = {\n kind: 'resource' as const,\n loadNext: createEntry(invokers.loadNext),\n paginated: selected.pagination !== undefined,\n refresh: createEntry(invokers.refresh),\n reset: createEntry(invokers.reset),\n retry: createEntry(invokers.retry),\n };\n\n return { ...parts, hook: resourceHook(parts, selected) };\n}\n\n/** The four commands of a Resource: the three verbs every one has, and `loadNext` only where one was declared. */\nfunction unchangedResourceCommands(entry: ResourceEntry): boolean {\n const { hook } = entry;\n\n return (\n hook.refresh === entry.refresh.hook &&\n hook.reset === entry.reset.hook &&\n hook.retry === entry.retry.hook &&\n (!entry.paginated || hook.pagination?.loadNext === entry.loadNext.hook)\n );\n}\n\n/** What this selection read: the state of the Resource, and the state of its capability where it has one. */\nfunction unchangedResourceState(entry: ResourceEntry, selected: SelectedResource): boolean {\n return Object.is(entry.hook.state, selected.state) && Object.is(entry.hook.pagination?.state, selected.pagination);\n}\n\nfunction unchangedResourceHook(entry: ResourceEntry, selected: SelectedResource): boolean {\n return unchangedResourceCommands(entry) && unchangedResourceState(entry, selected);\n}\n\n/**\n * S6/D359: the same Resource that did not move answers the same object, so a child under `memo` is not re-rendered by\n * the mere act of reading it. Every part is a render input, so this is a memo and not a piece of state.\n */\nfunction selectResourceEntry(\n previous: SelectionEntry | undefined,\n invokers: ResourceInvokers,\n selected: SelectedResource,\n): ResourceEntry {\n if (previous === undefined || !isResourceEntry(previous) || previous.refresh.invoker !== invokers.refresh) {\n return createResourceEntry(invokers, selected);\n }\n\n // Preparing a suspended render must not replace the hook on the committed entry. The four command consumers are\n // still the same logical consumers; only the selected Resource wrapper is new until commit.\n return unchangedResourceHook(previous, selected) ? previous : { ...previous, hook: resourceHook(previous, selected) };\n}\n\nfunction commandEntries(entry: SelectionEntry): readonly CommandEntry[] {\n return isResourceEntry(entry) ? [entry.refresh, entry.reset, entry.retry, entry.loadNext] : [entry];\n}\n\nfunction detachEntry(entry: SelectionEntry): void {\n for (const command of commandEntries(entry)) {\n command.detach?.();\n command.detach = undefined;\n }\n}\n\nfunction sameResourceConsumers(previous: ResourceEntry, next: ResourceEntry): boolean {\n return (\n previous.refresh === next.refresh &&\n previous.reset === next.reset &&\n previous.retry === next.retry &&\n previous.loadNext === next.loadNext\n );\n}\n\nfunction sameConsumers(previous: SelectionEntry, next: SelectionEntry | undefined): boolean {\n if (previous === next) return true;\n if (next === undefined || !isResourceEntry(previous) || !isResourceEntry(next)) return false;\n\n return sameResourceConsumers(previous, next);\n}\n\nfunction hookOf(entry: SelectionEntry): CommandHook<never, unknown> | SelectedResourceHook {\n return entry.hook;\n}\n\n/** Selection is inert during render; only a committed selection can admit work or discard an old queue. */\nclass CommandGroup {\n private entries = new Map<PropertyKey, SelectionEntry>();\n /** One set of invokers per Resource identity, so `run` keeps its reference across renders (D359). */\n private readonly invokers = new WeakMap<object, ResourceInvokers>();\n private readonly listeners = new Set<() => void>();\n private revision = 0;\n\n close(): void {\n for (const entry of this.entries.values()) detachEntry(entry);\n\n this.entries.clear();\n }\n\n commit(selected: Map<PropertyKey, SelectionEntry>): void {\n for (const [key, entry] of this.entries) {\n if (!sameConsumers(entry, selected.get(key))) detachEntry(entry);\n }\n\n this.entries = selected;\n\n for (const entry of selected.values()) this.attachEntry(entry);\n }\n\n /** S7: the attach runs on every commit, so the verbs are named rather than gathered into an array. */\n private attachEntry(entry: SelectionEntry): void {\n if (isResourceEntry(entry)) {\n this.attachCommand(entry.refresh);\n this.attachCommand(entry.retry);\n this.attachCommand(entry.reset);\n this.attachCommand(entry.loadNext);\n\n return;\n }\n\n this.attachCommand(entry);\n }\n\n private attachCommand(command: CommandEntry): void {\n command.detach ??= command.slot.attach((inFlight, outcome) => {\n if (!updateEntry(command, inFlight, outcome)) return;\n\n this.revision += 1;\n\n for (const listener of this.listeners) listener();\n });\n }\n\n getSnapshot = (): number => this.revision;\n\n /**\n * D321: two outcomes no longer, but two kinds. A command that is not bound is still a `ContributionError`; a\n * resource never appears in `frame.commandRecords`, so it is prepared from its own identity instead.\n */\n prepare(commands: CommandSelection, resources: ResourceSelection, frame: Frame): Map<PropertyKey, SelectionEntry> {\n const selected = new Map<PropertyKey, SelectionEntry>();\n\n for (const key of Reflect.ownKeys(commands)) {\n if (!Object.prototype.propertyIsEnumerable.call(commands, key)) continue;\n\n const command = (commands as Readonly<Record<PropertyKey, Command<never, unknown>>>)[key];\n const record = command === undefined ? undefined : frame.commandRecords.get(command);\n\n if (record === undefined) {\n throw new ContributionError('missing', `Command at ${String(key)} is not bound in this contribution.`);\n }\n\n selected.set(key, selectEntry(this.entries.get(key), record.invoker));\n }\n\n for (const [key, resource] of resources) {\n const invokers = resourceInvokers(resource.resource, this.invokers);\n\n selected.set(key, selectResourceEntry(this.entries.get(key), invokers, resource));\n }\n\n return selected;\n }\n\n subscribe = (listener: () => void): (() => void) => {\n this.listeners.add(listener);\n\n return () => {\n this.listeners.delete(listener);\n };\n };\n}\n\nfunction useCommandGroup(commands: CommandSelection, resources: ResourceSelection): CommandGroup | undefined {\n const groupRef = useRef<CommandGroup | undefined>(undefined);\n const populated =\n resources.size > 0 ||\n Reflect.ownKeys(commands).some(key => Object.prototype.propertyIsEnumerable.call(commands, key));\n\n return populated ? (groupRef.current ??= new CommandGroup()) : undefined;\n}\n\n/** The consumers of one selection: a command per key, and the two verbs of a resource per key (D321). */\nfunction useSelectionHooks(commands: CommandSelection, resources: ResourceSelection): SelectionHooks {\n const frame = useFrame();\n const group = useCommandGroup(commands, resources);\n const getSnapshot = group?.getSnapshot ?? idleRevision;\n useSyncExternalStore(group?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n const selected = group?.prepare(commands, resources, frame);\n useInsertionEffect(() => () => group?.close(), [group]);\n useInsertionEffect(() => {\n if (selected !== undefined) group?.commit(selected);\n });\n useLayoutEffect(() => {\n if (selected === undefined) return;\n\n // S7: the same branch as the attach — this runs after every commit, and the arrays were pure allocation.\n for (const entry of selected.values()) {\n if (isResourceEntry(entry)) {\n entry.refresh.slot.synchronize();\n entry.retry.slot.synchronize();\n entry.reset.slot.synchronize();\n entry.loadNext.slot.synchronize();\n } else entry.slot.synchronize();\n }\n });\n\n return selected === undefined\n ? emptyHooks\n : Object.fromEntries([...selected].map(([key, entry]) => [key, hookOf(entry)]));\n}\n\nexport { useSelectionHooks };\nexport type { SelectionHooks };\n","import type { Readable, ResourceView } from '@opetope/core';\nimport {\n isCallTarget,\n isReadable,\n isResourceView,\n resourceViewDemands,\n resourceViewReadable,\n} from '@opetope/core/internal';\nimport type { ResourceDemand } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\nimport type { AnyCommand } from './model-binding';\nimport { isResource } from './resource-command';\nimport type { AnyResource } from './resource-command';\n\ntype SelectionValue<Source> =\n Source extends ResourceView<infer Value> ? Value : Source extends Readable<infer Value> ? Value : never;\n\ninterface SelectionRead {\n <Source extends Readable<unknown> | ResourceView<unknown>>(source: Source): SelectionValue<Source>;\n <Source extends Readable<unknown> | ResourceView<unknown>, Selected>(\n source: Source,\n select: (value: SelectionValue<Source>) => Selected,\n ): Selected;\n}\n\ntype SelectionContext = Readonly<{ read: SelectionRead }>;\ntype NonSelectionRecord =\n | readonly unknown[]\n | ((...arguments_: never[]) => unknown)\n | (abstract new (...arguments_: never[]) => unknown)\n | Date\n | PromiseLike<unknown>\n | ReadonlyMap<unknown, unknown>\n | ReadonlySet<unknown>\n | RegExp\n | WeakMap<object, unknown>\n | WeakSet<object>;\n/** A named interface needs no open index signature; container and callable results are not field selections. */\ntype SelectionShape<Selected extends object> = Selected extends NonSelectionRecord ? never : Selected;\ntype SelectionRecord = Readonly<Record<PropertyKey, unknown>>;\n/**\n * D359: the Resource a field selected, and what this selection read from it — its state, and the state of its\n * pagination capability when it has one. Both are read passively: a selection takes no lease by reading.\n */\ntype SelectedResource = Readonly<{ pagination: unknown; resource: AnyResource; state: unknown }>;\ntype SelectionSnapshot = Readonly<{\n commands: Readonly<Record<PropertyKey, AnyCommand>>;\n /** The set the mount leases; two keys naming one resource are one lease. */\n leases: ReadonlySet<ResourceDemand>;\n resources: ReadonlyMap<PropertyKey, SelectedResource>;\n sources: ReadonlySet<Readable<unknown>>;\n values: SelectionRecord;\n}>;\n\nconst noResources: ReadonlyMap<PropertyKey, SelectedResource> = new Map();\n\n/**\n * D363: what this mount read last and the snapshot it answered with. It belongs to the mount and not to the reader:\n * React may discard the `useMemo` that builds the reader, and a memory kept there would be empty exactly when it is\n * needed. D364: it no longer remembers which sources ended — a source whose owner retired stops instead of refusing,\n * so it answers its last value on every read and there is nothing to remember or to step around.\n */\ntype SelectionMemory = {\n model: unknown;\n observed: Map<Readable<unknown>, unknown> | undefined;\n select: unknown;\n snapshot: SelectionSnapshot;\n};\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction readSource<Value>(source: Readable<Value>, sources: Map<Readable<unknown>, unknown>): Value {\n if (!isReadable(source)) {\n throw new ContributionError('binding-invalid', 'Model selection read requires a Readable or ResourceView.');\n }\n\n if (sources.has(source)) return sources.get(source) as Value;\n\n // D364: a refusal here is the source's own failure and belongs to the render, because no lifetime ends in one.\n const value: unknown = source.getSnapshot();\n sources.set(source, value);\n\n return value as Value;\n}\n\nfunction readPassively(source: Readable<unknown>, sources: Map<Readable<unknown>, unknown>): unknown {\n if (sources.has(source)) return sources.get(source);\n\n const value: unknown = source.getSnapshot();\n sources.set(source, value);\n\n return value;\n}\n\n/** D359: the predicate that answers the question the type of the field asked, and the read that leases nothing. */\nfunction classifyResource(\n key: PropertyKey,\n value: unknown,\n resources: Map<PropertyKey, SelectedResource>,\n sources: Map<Readable<unknown>, unknown>,\n): void {\n if (!isResource(value)) return;\n\n const resource = value as AnyResource;\n const capability = (\n resource as { readonly pagination?: { readonly state: Readable<unknown> } | ResourceView<unknown> }\n ).pagination;\n\n resources.set(key, {\n pagination: capability === undefined ? undefined : readPassively(resourceViewReadable(capability), sources),\n resource,\n state: readPassively(resourceViewReadable(resource), sources),\n });\n}\n\nfunction selectedResources(resources: Map<PropertyKey, SelectedResource>): ReadonlyMap<PropertyKey, SelectedResource> {\n return resources.size === 0 ? noResources : resources;\n}\n\ntype CollectedSelection = Readonly<{\n leases: ReadonlySet<ResourceDemand>;\n resources: ReadonlyMap<PropertyKey, SelectedResource>;\n values: SelectionRecord;\n}>;\n\nfunction collectResourceDemands(\n resources: ReadonlyMap<PropertyKey, SelectedResource>,\n leases: Set<ResourceDemand>,\n): void {\n for (const { resource } of resources.values()) {\n if (isResourceView(resource)) {\n for (const demand of resourceViewDemands(resource)) leases.add(demand);\n } else {\n leases.add(resource);\n }\n }\n}\n\n/**\n * D359: recognition happens in the one pass that already walks the selection. `Resource` is a structural contract\n * (D199) and the type of a selected field promises `ResourceHook` for anything that satisfies it, so the predicate\n * this uses answers the same question the type asked. Reading the state here also puts it among `sources`, so its\n * publication invalidates the fast path of this reader exactly as a read source does.\n */\nfunction collectSelection(\n select: (context: SelectionContext) => object,\n sources: Map<Readable<unknown>, unknown>,\n): CollectedSelection {\n const leases = new Set<ResourceDemand>();\n const read = <Value, Selected>(\n source: Readable<Value> | ResourceView<Value>,\n project?: (value: Value) => Selected,\n ) => {\n let readable: Readable<Value>;\n if (isResourceView(source)) {\n for (const demand of resourceViewDemands(source)) leases.add(demand);\n readable = source.observe();\n } else {\n readable = source;\n }\n const value = readSource(readable, sources);\n\n return project === undefined ? value : project(value);\n };\n const selected = select({ read });\n\n if (typeof selected !== 'object' || selected === null || Array.isArray(selected)) {\n throw new ContributionError('binding-invalid', 'Model selection requires a record.');\n }\n\n const entries: (readonly [PropertyKey, unknown])[] = [];\n const resources = new Map<PropertyKey, SelectedResource>();\n\n for (const key of Reflect.ownKeys(selected)) {\n if (!Object.prototype.propertyIsEnumerable.call(selected, key)) continue;\n\n const value = (selected as SelectionRecord)[key];\n\n entries.push([key, value]);\n classifyResource(key, value, resources, sources);\n }\n\n // `__proto__` is a key like any other here, and only a defined property keeps it one (D214).\n collectResourceDemands(resources, leases);\n return { leases, resources: selectedResources(resources), values: Object.fromEntries(entries) };\n}\n\n/**\n * D359: `values` keeps the Resource itself — a stable reference — so a selection that holds one is compared by\n * `Object.is` exactly as before. What moves is the state behind it, and that is compared here: without this the\n * selection would be «equal», the previous state would be kept, and a published Resource would reach no render.\n */\nfunction equalResources(\n previous: ReadonlyMap<PropertyKey, SelectedResource>,\n next: ReadonlyMap<PropertyKey, SelectedResource>,\n): boolean {\n if (previous.size !== next.size) return false;\n\n for (const [key, selected] of next) {\n const before = previous.get(key);\n\n if (\n before?.resource !== selected.resource ||\n !Object.is(before.state, selected.state) ||\n !Object.is(before.pagination, selected.pagination)\n ) {\n return false;\n }\n }\n\n return true;\n}\n\nfunction equalMembers<Value>(previous: ReadonlySet<Value>, next: ReadonlySet<Value>): boolean {\n if (previous.size !== next.size) return false;\n for (const value of next) if (!previous.has(value)) return false;\n return true;\n}\n\nfunction equalSelection(\n previous: SelectionSnapshot,\n values: SelectionRecord,\n sources: ReadonlySet<Readable<unknown>>,\n resources: ReadonlyMap<PropertyKey, SelectedResource>,\n leases: ReadonlySet<ResourceDemand>,\n) {\n const keys = Reflect.ownKeys(values);\n const previousKeys = Reflect.ownKeys(previous.values);\n\n if (keys.length !== previousKeys.length) return false;\n if (!equalMembers(previous.sources, sources)) return false;\n if (!equalMembers(previous.leases, leases)) return false;\n\n if (!equalResources(previous.resources, resources)) return false;\n\n return keys.every((key, index) => previousKeys[index] === key && Object.is(previous.values[key], values[key]));\n}\n\ntype ModelSelector<Model> = (model: Model, context: SelectionContext) => object;\ntype SelectionReaderRef<Model> = { readonly current: ModelSelector<Model> | undefined };\n\nconst emptySelectionSnapshot: SelectionSnapshot = {\n commands: {},\n leases: noLeases,\n resources: noResources,\n sources: new Set(),\n values: {},\n};\n\nfunction selectionCommands(values: SelectionRecord): Readonly<Record<PropertyKey, AnyCommand>> {\n return Object.fromEntries(\n Reflect.ownKeys(values)\n .filter(key => isCallTarget(values[key]))\n .map(key => [key, values[key]]),\n ) as Readonly<Record<PropertyKey, AnyCommand>>;\n}\n\n/**\n * The fast path re-reads what it observed. D364: a source that stopped answers the same value it answered last, so\n * it compares equal and costs one read — there is no terminal source to record and step around any more.\n */\nfunction observedUnchanged(observed: Map<Readable<unknown>, unknown>): boolean {\n for (const [source, value] of observed) {\n if (!Object.is(source.getSnapshot(), value)) return false;\n }\n\n return true;\n}\n\n/** D363: the memory of one mount, empty until its first read and reset when the reader is built for another model. */\nfunction createSelectionMemory(): SelectionMemory {\n return { model: undefined, observed: undefined, select: undefined, snapshot: emptySelectionSnapshot };\n}\n\n/**\n * D214: one reader per model, not per render. The author's selector arrives through a ref, so an inline arrow does not\n * rebuild the reader; the fast path — nothing observed has moved — belongs to the selector that computed the snapshot,\n * so a new selector is always called again, its result compared field by field, and an equal selection keeps the\n * previous snapshot. A rejected or abandoned render still changes nothing: only a committed selection subscribes.\n *\n * D363: what the reader remembers lives in the mount's memory, so a reader React rebuilt — because it discarded the\n * memo — still knows what this selection read last.\n */\nfunction createSelectionSnapshot<Model>(\n model: Model,\n selectRef: SelectionReaderRef<Model>,\n memory: SelectionMemory,\n): () => SelectionSnapshot {\n if (memory.model !== model) {\n memory.model = model;\n memory.observed = undefined;\n memory.select = undefined;\n memory.snapshot = emptySelectionSnapshot;\n }\n\n return () => {\n const select = selectRef.current;\n\n if (select === undefined) return emptySelectionSnapshot;\n\n const observed = memory.observed;\n\n if (observed !== undefined && memory.select === select && observedUnchanged(observed)) {\n return memory.snapshot;\n }\n\n const nextObserved = new Map<Readable<unknown>, unknown>();\n const { leases, resources, values } = collectSelection(context => select(model, context), nextObserved);\n const sources = new Set(nextObserved.keys());\n\n if (observed === undefined || !equalSelection(memory.snapshot, values, sources, resources, leases)) {\n memory.snapshot = {\n commands: selectionCommands(values),\n leases,\n resources,\n sources,\n values,\n };\n }\n\n memory.observed = nextObserved;\n memory.select = select;\n\n return memory.snapshot;\n };\n}\n\nexport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot };\nexport type { ModelSelector, SelectedResource, SelectionContext, SelectionMemory, SelectionShape, SelectionSnapshot };\n","import type { Readable } from '@opetope/core';\nimport { createAggregateError } from '@opetope/core/internal';\n\nimport type { ResourceDemand } from '@opetope/core/internal';\n\ntype Subscription = { dispose: (() => void) | undefined };\ntype Listener = Readonly<{ notify: () => void }>;\n\nconst noLeases: ReadonlySet<ResourceDemand> = new Set();\n\nfunction releaseSubscriptions(subscriptions: Iterable<Subscription>, failures: unknown[] = []): void {\n for (const subscription of subscriptions) {\n const dispose = subscription.dispose;\n subscription.dispose = undefined;\n\n try {\n dispose?.();\n } catch (error) {\n failures.push(error);\n }\n }\n\n if (failures.length === 1) throw failures[0];\n\n if (failures.length > 1) throw createAggregateError(failures, 'Model selection sources failed to release.');\n}\n\n/** A subscription set, not a scheduler: source notifications use React's snapshot consistency check. */\nclass ModelSelectionStore {\n private enabled = false;\n /** D359: one lease per Resource identity, diffed like a subscription, so an unchanged selection takes none. */\n private readonly leases = new Map<ResourceDemand, Subscription>();\n private readonly listeners = new Set<Listener>();\n private retained: ReadonlySet<ResourceDemand> = noLeases;\n private sources: ReadonlySet<Readable<unknown>> = new Set();\n private readonly subscriptions = new Map<Readable<unknown>, Subscription>();\n\n close(): void {\n this.enabled = false;\n this.sources = new Set();\n this.retained = noLeases;\n this.releaseAll();\n }\n\n commit(sources: ReadonlySet<Readable<unknown>>, retained: ReadonlySet<ResourceDemand> = noLeases): void {\n this.sources = sources;\n this.retained = retained;\n this.enabled = true;\n\n try {\n this.synchronize();\n } catch (error) {\n this.releaseAll([error]);\n }\n }\n\n subscribe = (notify: () => void): (() => void) => {\n const listener = { notify };\n this.listeners.add(listener);\n\n try {\n this.synchronize();\n } catch (error) {\n this.listeners.delete(listener);\n this.releaseAll([error]);\n }\n\n return () => {\n this.listeners.delete(listener);\n\n if (this.listeners.size === 0) this.releaseAll();\n };\n };\n\n private add(source: Readable<unknown>): void {\n const subscription: Subscription = { dispose: undefined };\n // Reserve before foreign code: a synchronous notification may replace or close this selection.\n this.subscriptions.set(source, subscription);\n const dispose = source.subscribe(this.notify);\n\n if (typeof dispose !== 'function') throw new TypeError('Model selection source must return a disposer.');\n\n if (this.subscriptions.get(source) === subscription) subscription.dispose = dispose;\n else dispose();\n }\n\n private notify = (): void => {\n for (const listener of [...this.listeners]) {\n if (this.listeners.has(listener)) listener.notify();\n }\n };\n\n private releaseAll(failures?: unknown[]): void {\n const held = [...this.subscriptions.values(), ...this.leases.values()];\n this.subscriptions.clear();\n this.leases.clear();\n releaseSubscriptions(held, failures);\n }\n\n private removeUnselected(): void {\n const removed: Subscription[] = [];\n\n for (const [source, subscription] of this.subscriptions) {\n if (this.sources.has(source)) continue;\n\n this.subscriptions.delete(source);\n removed.push(subscription);\n }\n\n for (const [resource, lease] of this.leases) {\n if (this.retained.has(resource)) continue;\n\n this.leases.delete(resource);\n removed.push(lease);\n }\n\n releaseSubscriptions(removed);\n }\n\n /**\n * D321: `retain()` is reentrant — it reaches `activate()`, the target subscription, the first read and the\n * publication that follows, all synchronously — and a listener woken there may rebuild or close this selection.\n * The record is reserved first, the lease is taken second, and it is kept only if the record is still this one.\n */\n private retain(resource: ResourceDemand): void {\n const lease: Subscription = { dispose: undefined };\n this.leases.set(resource, lease);\n const release = resource.acquire();\n\n if (typeof release !== 'function') throw new TypeError('Model selection resource must answer a release disposer.');\n\n if (this.leases.get(resource) === lease) lease.dispose = release;\n else release();\n }\n\n /** Foreign code inside a subscription or a lease may replace this selection, so both loops ask again. */\n private ready(): boolean {\n return this.enabled && this.listeners.size > 0;\n }\n\n private retainSelected(): void {\n for (const resource of this.retained) {\n if (!this.ready()) return;\n\n if (this.retained.has(resource) && !this.leases.has(resource)) this.retain(resource);\n }\n }\n\n private subscribeSources(): void {\n for (const source of this.sources) {\n if (!this.ready()) return;\n\n if (this.sources.has(source) && !this.subscriptions.has(source)) this.add(source);\n }\n }\n\n private synchronize(): void {\n this.removeUnselected();\n this.subscribeSources();\n this.retainSelected();\n }\n}\n\nexport { ModelSelectionStore };\n","import { useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';\n\nimport type { Command, ModelOf, PaginatedResource, Resource } from '@opetope/core';\n\nimport type { CommandHook } from './command-hook';\nimport { useSelectionHooks } from './selection-hooks';\nimport type { SelectionHooks } from './selection-hooks';\nimport { ContributionError } from './errors';\nimport { subscribeIdle } from './idle-subscription';\nimport type { AnyModel } from './model-binding';\nimport { createSelectionMemory, createSelectionSnapshot, emptySelectionSnapshot } from './model-selection-snapshot';\nimport type {\n ModelSelector,\n SelectionContext,\n SelectionMemory,\n SelectionShape,\n SelectionSnapshot,\n} from './model-selection-snapshot';\nimport { ModelSelectionStore } from './model-selection-store';\nimport { useFrame } from './mount-context';\nimport type { PaginatedResourceHook, ResourceHook, ResourceKey } from './resource-command';\n\n/**\n * D359: a field whose value is a Resource answers the hook `useResource` answers, and the mount leases it exactly as\n * `useResource` does. `read(resource.state)` is unchanged — it hands out the state and leases nothing — so naming one\n * Resource both ways registers it twice: the subscription and the lease are independent.\n */\ntype SelectedValue<Value> =\n Value extends Command<infer Input, infer Output>\n ? CommandHook<Input, Output>\n : Value extends PaginatedResource<\n infer Data,\n infer Key extends ResourceKey,\n infer Cursor extends ResourceKey,\n 'consumers' | 'owner'\n >\n ? PaginatedResourceHook<Data, Key, Cursor>\n : Value extends Resource<infer Data, infer Key extends ResourceKey, 'consumers' | 'owner'>\n ? ResourceHook<Data, Key>\n : Value;\ntype ModelSelection<Selected> = { readonly [Key in keyof Selected]: SelectedValue<Selected[Key]> };\n\nconst readEmptySnapshot = () => emptySelectionSnapshot;\n\nfunction useSelectionStore(selected: boolean): ModelSelectionStore | undefined {\n const storeRef = useRef<ModelSelectionStore | undefined>(undefined);\n\n return selected ? (storeRef.current ??= new ModelSelectionStore()) : undefined;\n}\n\n/**\n * Two branches of one key: the consumer this selection prepared — a bound command, or the verbs, the state and the\n * capability of a selected Resource — and otherwise the value the selector wrote. S6/D359: the Resource branch is\n * assembled on the record and not here, so a key whose state did not move hands back the very same object.\n */\ntype SelectionResult = Readonly<Record<PropertyKey, unknown>>;\n\nfunction selectedValue(snapshot: SelectionSnapshot, hooks: SelectionHooks, key: PropertyKey): unknown {\n return Object.prototype.hasOwnProperty.call(hooks, key) ? hooks[key] : snapshot.values[key];\n}\n\nfunction mergeSelection(\n snapshot: SelectionSnapshot,\n hooks: SelectionHooks,\n committed: SelectionResult | undefined,\n): SelectionResult {\n const keys = Reflect.ownKeys(snapshot.values);\n\n if (committed !== undefined) {\n const oldKeys = Reflect.ownKeys(committed);\n\n if (\n keys.length === oldKeys.length &&\n keys.every(\n (key, index) => key === oldKeys[index] && Object.is(committed[key], selectedValue(snapshot, hooks, key)),\n )\n ) {\n return committed;\n }\n }\n\n return Object.fromEntries(keys.map(key => [key, selectedValue(snapshot, hooks, key)]));\n}\n\n/** D205: resolve only a granted model, explicitly read data, and reuse the ordinary per-key command consumers. */\nfunction useModel<Declaration extends AnyModel>(declaration: Declaration): ModelOf<Declaration>;\nfunction useModel<Declaration extends AnyModel, const Selected extends object>(\n declaration: Declaration,\n select: (model: ModelOf<Declaration>, context: SelectionContext) => Selected & SelectionShape<Selected>,\n): ModelSelection<Selected>;\nfunction useModel<Declaration extends AnyModel>(\n declaration: Declaration,\n select?: (model: ModelOf<Declaration>, context: SelectionContext) => object,\n): unknown {\n const frame = useFrame();\n\n if (!frame.models.has(declaration)) {\n throw new ContributionError('missing', `Model ${declaration.id} is not granted to this contribution.`);\n }\n\n const model = frame.models.get(declaration) as ModelOf<Declaration>;\n const store = useSelectionStore(select !== undefined);\n // D214: the selector of this render, read by a reader that belongs to the model. Writing the latest callback into\n // a ref is what `useSyncExternalStoreWithSelector` does: the reader only reads it, and never writes to it.\n const selectRef = useRef<ModelSelector<ModelOf<Declaration>> | undefined>(undefined);\n selectRef.current = select;\n const selected = select !== undefined;\n // D363: the memory of this selection belongs to the mount, so a reader React rebuilt keeps what it read last.\n const memoryRef = useRef<SelectionMemory | undefined>(undefined);\n const memory = (memoryRef.current ??= createSelectionMemory());\n const getSnapshot = useMemo(\n () => (selected ? createSelectionSnapshot(model, selectRef, memory) : readEmptySnapshot),\n [memory, model, selected],\n );\n const snapshot = useSyncExternalStore(store?.subscribe ?? subscribeIdle, getSnapshot, getSnapshot);\n const hooks = useSelectionHooks(snapshot.commands, snapshot.resources);\n useLayoutEffect(() => () => store?.close(), [store]);\n // D359: a lease is taken in commit and never in a render, and the store diffs the set by identity.\n useLayoutEffect(() => store?.commit(snapshot.sources, snapshot.leases), [snapshot, store]);\n\n // An abandoned render may prepare another record, but only a committed render replaces the comparison baseline.\n const committedResult = useRef<SelectionResult | undefined>(undefined);\n const result = selected ? mergeSelection(snapshot, hooks, committedResult.current) : undefined;\n useLayoutEffect(() => {\n committedResult.current = result;\n });\n\n if (select === undefined) return model;\n\n return result;\n}\n\nexport { useModel };\n","import type { FunctionComponent } from 'react';\n\nimport type { ModelIdentity } from '@opetope/core/internal';\n\nimport { ContributionError } from './errors';\n\ntype AnyModel = ModelIdentity;\n\n/**\n * The marker a component uses to state which UI models of its contribution it reads. `slot` checks by type that the\n * contribution grants every model of this list — it may grant more, because the mount serves its whole instance.\n *\n * The runtime authority is the mount frame, not this marker: `useModel` resolves against what the mount was given\n * and refuses anything else. The lint rule `opetope/require-declared-models` checks visible contribution sites and\n * each reader of a per-mount model within the same module. Imported implementations and dynamic declaration lists\n * remain unknown to this syntactic check (D85, D158, D250).\n */\ntype ComponentRequiringModels<Props, Models extends readonly AnyModel[]> = FunctionComponent<Props> & {\n readonly requires: Models;\n};\n\nfunction requiresModels<const Models extends readonly AnyModel[]>(\n models: Models,\n): <Props>(component: FunctionComponent<Props>) => ComponentRequiringModels<Props, Models> {\n const declared = Object.freeze([...models]) as unknown as Models;\n\n return <Props>(component: FunctionComponent<Props>): ComponentRequiringModels<Props, Models> => {\n const existing = (component as { readonly requires?: readonly AnyModel[] }).requires;\n\n if (existing !== undefined) {\n throw new ContributionError('duplicate', 'Component already declares the models it requires.');\n }\n\n Object.defineProperty(component, 'requires', { enumerable: false, value: declared });\n\n return component as ComponentRequiringModels<Props, Models>;\n };\n}\n\nexport { requiresModels };\n","import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from 'react';\n\nimport type { PaginatedResource, PaginationState, Readable, Resource } from '@opetope/core';\nimport type { ResourceKey } from '@opetope/core/internal';\nimport { acquireResourceDemand, resourceViewReadable } from '@opetope/core/internal';\n\nimport { useCommandStatus } from './command-hook';\nimport { CommandHookController } from './command-hook-controller';\nimport { createResourceInvokers, paginationOf } from './resource-command';\nimport type { AnyResource, PaginatedResourceHook, ResourceHook, ResourcePaginationHook } from './resource-command';\n\ntype ResourceSlots = Readonly<{\n loadNext: CommandHookController<void, unknown>;\n refresh: CommandHookController<void, unknown>;\n reset: CommandHookController<void, unknown>;\n retry: CommandHookController<void, unknown>;\n}>;\n\n/**\n * D359: one set of controllers per Resource identity, exactly as `useCommandSlot` keeps one per invoker. The slots are\n * what the set of invokers is kept alive by, so one map answers for all four. Slots are inert until commit, so an\n * interrupted render neither admits work nor resets the status of the committed one.\n */\nfunction useResourceSlots(resource: AnyResource): ResourceSlots {\n const [cache] = useState(() => new WeakMap<object, ResourceSlots>());\n const existing = cache.get(resource);\n\n if (existing !== undefined) return existing;\n\n const invokers = createResourceInvokers(resource);\n const slots: ResourceSlots = {\n loadNext: new CommandHookController<void, unknown>(invokers.loadNext),\n refresh: new CommandHookController<void, unknown>(invokers.refresh),\n reset: new CommandHookController<void, unknown>(invokers.reset),\n retry: new CommandHookController<void, unknown>(invokers.retry),\n };\n cache.set(resource, slots);\n\n return slots;\n}\n\nconst unavailablePagination: PaginationState<ResourceKey> = Object.freeze({\n kind: 'unavailable',\n reason: 'resource-not-ready',\n});\nconst noPaginationSource: Readable<PaginationState<ResourceKey>> = Object.freeze({\n getSnapshot: () => unavailablePagination,\n subscribe: () => () => undefined,\n});\n\n/**\n * D359: the state of a Resource, the lease that keeps it open for as long as this component is mounted, and its verbs\n * as commands. The number of React hooks here does not depend on the Resource: a declaration without `pagination`\n * subscribes to a constant source and keeps a `loadNext` that answers `skipped`.\n */\nfunction useResource<Data, Key extends ResourceKey, Cursor extends ResourceKey>(\n resource: PaginatedResource<Data, Key, Cursor, 'consumers' | 'owner'>,\n): PaginatedResourceHook<Data, Key, Cursor>;\nfunction useResource<Data, Key extends ResourceKey>(\n resource: Resource<Data, Key, 'consumers' | 'owner'>,\n): ResourceHook<Data, Key>;\nfunction useResource<Data, Key extends ResourceKey>(\n resource: Resource<Data, Key, 'consumers' | 'owner'>,\n): ResourceHook<Data, Key> {\n const handle = resource as unknown as AnyResource;\n const capability = paginationOf(handle);\n const subscribe = useCallback(\n (listener: () => void) => resourceViewReadable(resource).subscribe(listener),\n [resource],\n );\n /*\n * D364: `resource.state` is a total `Readable` for the life of the object this hook holds — a retired one answers\n * `idle('retired')` — so the read needs no memory of its own. What it can still refuse is a producer failure, a\n * broken `nextCursor` among them (D356), and that belongs to the render (G13).\n */\n const getState = useMemo(() => () => resourceViewReadable(resource).getSnapshot(), [resource]);\n const state = useSyncExternalStore(subscribe, getState, getState);\n const paginationSource: Readable<PaginationState<ResourceKey>> =\n capability === undefined ? noPaginationSource : resourceViewReadable(capability);\n const subscribePagination = useCallback(\n (listener: () => void) => paginationSource.subscribe(listener),\n [paginationSource],\n );\n const getPaginationState = useMemo(() => () => paginationSource.getSnapshot(), [paginationSource]);\n const paginationState = useSyncExternalStore(subscribePagination, getPaginationState, getPaginationState);\n\n // D349: the lease is taken in a commit effect, so an interrupted render opens nothing.\n useEffect(() => acquireResourceDemand(resource), [resource]);\n\n const slots = useResourceSlots(handle);\n const refresh = useCommandStatus(slots.refresh);\n const retry = useCommandStatus(slots.retry);\n const reset = useCommandStatus(slots.reset);\n const loadNext = useCommandStatus(slots.loadNext);\n const pagination = useMemo(\n () =>\n capability === undefined\n ? undefined\n : ({ loadNext, state: paginationState } as unknown as ResourcePaginationHook<ResourceKey>),\n [capability, loadNext, paginationState],\n );\n\n return useMemo(\n () => ({ pagination, refresh, reset, retry, state }) as ResourceHook<Data, Key>,\n [pagination, refresh, reset, retry, state],\n );\n}\n\nexport { useResource };\n","import type { ComponentType, ReactNode } from 'react';\nimport { createElement, Fragment } from 'react';\n\nimport type { DeclarationId } from '@opetope/core';\nimport { declarationId } from '@opetope/core';\nimport type { ContributionTarget } from '@opetope/core/internal';\nimport { createContributionTarget } from '@opetope/core/internal';\nimport type { ContributionModel } from '@opetope/runtime/internal';\n\nimport { contributionAuthority, ContributionMount } from './contribution-frame';\nimport { useReadable } from './readable-hooks';\n\ntype SlotProperties = object | undefined;\ntype EmptySlotProperties = Readonly<Record<string, never>>;\ntype SlotComponentProperties<Props extends SlotProperties> = [Props] extends [undefined]\n ? EmptySlotProperties\n : Extract<Props, object>;\n\n/**\n * What a contribution publishes: the component, the optional props adapter and the optional UI models the mount\n * creates. Without an adapter the component takes the slot props; with one it takes exactly the adapter result (D85).\n */\ntype SlotContribution<Props extends SlotProperties = undefined> = {\n readonly Component: ComponentType<never>;\n readonly models?: readonly ContributionModel[];\n readonly props?: (slotProps: SlotComponentProperties<Props>) => object;\n};\n\ntype SlotTarget<Props extends SlotProperties = undefined> = ContributionTarget<SlotContribution<Props>>;\n\ntype SwitchSlotTarget<Route extends string, Props extends SlotProperties = undefined> = ((\n route: Route,\n) => SlotTarget<Props>) & {\n readonly id: DeclarationId;\n};\n\ntype SlotRenderProps<Props extends SlotProperties> = [Props] extends [undefined]\n ? {\n readonly props?: never;\n readonly target: SlotTarget<Props>;\n }\n : {\n readonly props: SlotComponentProperties<Props>;\n readonly target: SlotTarget<Props>;\n };\n\nconst emptySlotProperties: EmptySlotProperties = Object.freeze({});\n\n/** D280: a slot is a name, so it takes its id as the first argument. */\nfunction defineSlot<Props extends SlotProperties = undefined>(id: string): SlotTarget<Props> {\n return createContributionTarget<SlotContribution<Props>>(id, 'slot');\n}\n\nfunction defineSwitchSlot<Route extends string, Props extends SlotProperties = undefined>(\n id: string,\n): SwitchSlotTarget<Route, Props> {\n const declared = declarationId(id);\n const targets = new Map<Route, SlotTarget<Props>>();\n\n const switchSlot = (route: Route): SlotTarget<Props> => {\n const existing = targets.get(route);\n\n if (existing !== undefined) return existing;\n\n const target = defineSlot<Props>(`${declared}/${route}`);\n targets.set(route, target);\n\n return target;\n };\n\n Object.defineProperty(switchSlot, 'id', { enumerable: true, value: declared });\n\n return Object.freeze(switchSlot) as SwitchSlotTarget<Route, Props>;\n}\n\n/**\n * Every contribution renders inside its own mount: the models its generation owns plus the UI models it declared,\n * created on mount and closed on unmount (D70, D85).\n */\nfunction Slot<Props extends SlotProperties>(options: SlotRenderProps<Props>): ReactNode {\n const entries = useReadable(options.target.entries);\n const slotProps: object = 'props' in options ? (options.props ?? emptySlotProperties) : emptySlotProperties;\n\n if (entries.length === 0) return null;\n\n return entries.map(entry =>\n createElement(\n Fragment,\n { key: entry.id },\n createElement(ContributionMount, {\n authority: contributionAuthority(entry),\n contribution: entry.value,\n contributionId: entry.id,\n slotProps,\n targetId: options.target.id,\n }),\n ),\n );\n}\n\nexport { defineSlot, defineSwitchSlot, Slot };\nexport type { SlotComponentProperties, SlotContribution, SlotProperties, SlotTarget, SwitchSlotTarget };\n"],"names":["failureOutcome","options","error","isCancellation","notification","_a","reportDetachedError","callbackError","runOptions","onSuccess","signal","requestOf","input","resolve","promise","settle","request","outcome","CommandHookController","ContributionError","aborted","invoker","notify","CommandError","compatibleAbortReason","invocation","value","emptyStatus","settledOutcome","unchangedState","current","slot","inFlight","settled","nextState","previous","useCommandSlot","slots","useState","useCommandStatus","currentSlot","hookState","setHookState","useInsertionEffect","useLayoutEffect","run","useMemo","useCommand","command","record","useFrame","idleRelease","subscribeIdle","idleRevision","emptyHooks","isResourceEntry","entry","createEntry","unchangedHook","next","updateEntry","selectEntry","resourceHook","selected","createResourceEntry","invokers","parts","unchangedResourceCommands","hook","unchangedResourceState","unchangedResourceHook","selectResourceEntry","commandEntries","detachEntry","sameResourceConsumers","sameConsumers","hookOf","CommandGroup","key","listener","commands","resources","frame","resource","resourceInvokers","useCommandGroup","groupRef","useRef","useSelectionHooks","group","getSnapshot","useSyncExternalStore","noResources","noLeases","readSource","source","sources","isReadable","readPassively","classifyResource","isResource","capability","resourceViewReadable","selectedResources","collectResourceDemands","leases","isResourceView","demand","resourceViewDemands","collectSelection","select","project","readable","entries","equalResources","before","equalMembers","equalSelection","values","keys","previousKeys","index","emptySelectionSnapshot","selectionCommands","isCallTarget","observedUnchanged","observed","createSelectionMemory","createSelectionSnapshot","model","selectRef","memory","nextObserved","context","releaseSubscriptions","subscriptions","failures","subscription","dispose","createAggregateError","ModelSelectionStore","retained","held","removed","lease","release","readEmptySnapshot","useSelectionStore","storeRef","selectedValue","snapshot","hooks","mergeSelection","committed","oldKeys","useModel","declaration","store","memoryRef","committedResult","result","requiresModels","models","declared","component","useResourceSlots","cache","existing","createResourceInvokers","unavailablePagination","noPaginationSource","useResource","handle","paginationOf","subscribe","useCallback","getState","state","paginationSource","subscribePagination","getPaginationState","paginationState","useEffect","acquireResourceDemand","refresh","retry","reset","loadNext","pagination","emptySlotProperties","defineSlot","id","createContributionTarget","defineSwitchSlot","declarationId","targets","switchSlot","route","target","Slot","useReadable","slotProps","createElement","Fragment","ContributionMount","contributionAuthority"],"mappings":"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"}
|
|
@@ -2,16 +2,12 @@ import type { Readable, ResourceView } from '@opetope/core';
|
|
|
2
2
|
import type { ResourceDemand } from '@opetope/core/internal';
|
|
3
3
|
import type { AnyCommand } from './model-binding.js';
|
|
4
4
|
import type { AnyResource } from './resource-command.js';
|
|
5
|
+
type SelectionValue<Source> = Source extends ResourceView<infer Value> ? Value : Source extends Readable<infer Value> ? Value : never;
|
|
5
6
|
interface SelectionRead {
|
|
6
|
-
<
|
|
7
|
-
<
|
|
8
|
-
}
|
|
9
|
-
interface SelectionAcquire {
|
|
10
|
-
<Value>(view: ResourceView<Value>): Value;
|
|
11
|
-
<Value, Selected>(view: ResourceView<Value>, select: (value: Value) => Selected): Selected;
|
|
7
|
+
<Source extends Readable<unknown> | ResourceView<unknown>>(source: Source): SelectionValue<Source>;
|
|
8
|
+
<Source extends Readable<unknown> | ResourceView<unknown>, Selected>(source: Source, select: (value: SelectionValue<Source>) => Selected): Selected;
|
|
12
9
|
}
|
|
13
10
|
type SelectionContext = Readonly<{
|
|
14
|
-
acquire: SelectionAcquire;
|
|
15
11
|
read: SelectionRead;
|
|
16
12
|
}>;
|
|
17
13
|
type NonSelectionRecord = readonly unknown[] | ((...arguments_: never[]) => unknown) | (abstract new (...arguments_: never[]) => unknown) | Date | PromiseLike<unknown> | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> | RegExp | WeakMap<object, unknown> | WeakSet<object>;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@opetope/react",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.14.0",
|
|
4
4
|
"engines": {
|
|
5
5
|
"node": ">=20.19.0"
|
|
6
6
|
},
|
|
@@ -49,16 +49,16 @@
|
|
|
49
49
|
}
|
|
50
50
|
],
|
|
51
51
|
"devDependencies": {
|
|
52
|
-
"@opetope/core": "0.
|
|
53
|
-
"@opetope/runtime": "0.
|
|
52
|
+
"@opetope/core": "0.14.0",
|
|
53
|
+
"@opetope/runtime": "0.14.0",
|
|
54
54
|
"@testing-library/react": "16.3.3",
|
|
55
55
|
"@types/react": "19.2.18",
|
|
56
56
|
"react": "19.2.8",
|
|
57
57
|
"react-dom": "19.2.8"
|
|
58
58
|
},
|
|
59
59
|
"peerDependencies": {
|
|
60
|
-
"@opetope/core": "0.
|
|
61
|
-
"@opetope/runtime": "0.
|
|
60
|
+
"@opetope/core": "0.14.0",
|
|
61
|
+
"@opetope/runtime": "0.14.0",
|
|
62
62
|
"react": ">=19.0.0 <20"
|
|
63
63
|
},
|
|
64
64
|
"sideEffects": false,
|