tinybase 3.0.2 → 3.1.0-beta.1

package/lib/cjs-es6/tools.d.ts

@@ -272,26 +272,35 @@ export interface Tools {
   getStoreValuesSchema(): ValuesSchema;
 
   /**
-   * The getStoreApi method returns a code-generated .d.ts file and a .ts file
-   * that describe the schema of a Store in an ORM style.
+   * The getStoreApi method returns code-generated .d.ts and .ts(x) files that
+   * describe the schema of a Store and React bindings (since v3.1.0) in an ORM
+   * style.
    *
-   * If the Store does not already have an explicit TablesSchema associated with
-   * it, the data in the Store will be scanned to attempt to infer a new
-   * TablesSchema. The method returns two strings (which should be saved as
-   * files) though if no schema can be inferred, the strings will be empty.
+   * If the Store does not already have an explicit TablesSchema or ValuesSchema
+   * associated with it, the data in the Store will be scanned to attempt to
+   * infer new schemas. The method returns four strings (which should be saved
+   * as files) though if no schema can be inferred, the strings will be empty.
    *
    * The method takes a single argument which represents the name you want the
-   * generated store object to have in code. You are expected to save the files
-   * as `[storeName].d.ts` and `[storeName].ts`, and alongside each other so
-   * that the latter can import types from the former.
+   * generated store object to have in code. You are expected to save the four
+   * files yourself, as, respectively:
+   *
+   * - `[storeName].d.ts`
+   * - `[storeName].ts`
+   * - `[storeName]-ui-react.d.ts`
+   * - `[storeName]-ui-react.tsx`
+   *
+   * Also you should save these alongside each other so that the .ts(x) files
+   * can import types from the .d.ts files.
    *
-   * The .d.ts and .ts files that are generated are designed to resemble the
-   * main TinyBase `store.d.ts` and `store.ts` files, but provide named types
-   * and methods that describe the domain of the schema in the store.
+   * The .d.ts and .ts(x) files that are generated are designed to resemble the
+   * main TinyBase Store and React binding files, but provide named types and
+   * methods that describe the domain of the schema in the store.
    *
    * For example, from a Store that has a `pets` Table, you will get methods
-   * like `getPetsTable`, and types like `PetsRow`, that are more specific
-   * versions of the underlying getTable method or the Row type. For example:
+   * like `getPetsTable`, types like `PetsRow`, and hooks and components that
+   * are more specific versions of the underlying getTable method or the Row
+   * type, and so on. For example:
    *
    * |Store type|Equivalent generated type|
    * |-|-|
@@ -321,9 +330,9 @@ export interface Tools {
    * directly.
    *
    * @param storeName The name you want to provide to the generated Store, which
-   * should also be used to save the `.d.ts` and `.ts` files.
-   * @returns A pair of strings representing the contents of the `.d.ts` and
-   * `.ts` files.
+   * should also be used to save the `.d.ts`, `.ts`, and `.tsx` files.
+   * @returns A set of four strings representing the contents of the `.d.ts`,
+   * `.ts`, and `.tsx` files for the generated Store and React modules.
    * @example
    * This example creates a Tools object and generates code for a Store that
    * already has a TablesSchema.
@@ -333,7 +342,8 @@ export interface Tools {
    *     price: {type: 'number'},
    *   },
    * });
-   * const [dTs, ts] = createTools(store).getStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] =
+   *   createTools(store).getStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[3]);
@@ -342,7 +352,7 @@ export interface Tools {
    * // -> 'export type PetsRow = {\'price\'?: number;};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[41]);
+   * console.log(tsLines[39]);
    * // -> 'getPetsTable: (): PetsTable => store.getTable(PETS) as PetsTable,'
    * ```
    * @example
@@ -353,7 +363,8 @@ export interface Tools {
    *   fido: {price: 5},
    *   felix: {price: 4},
    * });
-   * const [dTs, ts] = createTools(store).getStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] =
+   *   createTools(store).getStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[3]);
@@ -362,18 +373,18 @@ export interface Tools {
    * // -> 'export type PetsRow = {\'price\': number;};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[43]);
+   * console.log(tsLines[41]);
    * // -> 'getPetsTable: (): PetsTable => store.getTable(PETS) as PetsTable,'
    * ```
    * @category Modelling
    * @since v2.2.0
    */
-  getStoreApi(storeName: string): [string, string];
+  getStoreApi(storeName: string): [string, string, string, string];
 
   /**
    * The getPrettyStoreApi method attempts to returns a prettified
-   * code-generated .d.ts file and a .ts file that describe the schema of a
-   * Store in an ORM style.
+   * code-generated .d.ts and .ts(x) files that describe the schema of a Store
+   * and React bindings (since v3.1.0) in an ORM style.
    *
    * This is simply a wrapper around the getStoreApi method that attempts to
    * invoke the `prettier` module (which it hopes you have installed) to format
@@ -384,17 +395,24 @@ export interface Tools {
    * the results as a promise.
    *
    * The method takes a single argument which represents the name you want the
-   * generated store object to have in code. You are expected to save the files
-   * as `[storeName].d.ts` and `[storeName].ts`, and alongside each other so
-   * that the latter can import types from the former.
+   * generated store object to have in code. You are expected to save the four
+   * files yourself, as, respectively:
+   *
+   * - `[storeName].d.ts`
+   * - `[storeName].ts`
+   * - `[storeName]-ui-react.d.ts`
+   * - `[storeName]-ui-react.tsx`
+   *
+   * Also you should save these alongside each other so that the .ts(x) files
+   * can import types from the .d.ts files.
    *
    * See the documentation for the getStoreApi method for details of the content
    * of the generated files.
    *
    * @param storeName The name you want to provide to the generated Store, which
-   * should also be used to save the `.d.ts` and `.ts` files.
-   * @returns A pair of strings representing the contents of the `.d.ts` and
-   * `.ts` files.
+   * should also be used to save the `.d.ts`, `.ts`, and `.tsx` files.
+   * @returns A set of four strings representing the contents of the `.d.ts`,
+   * `.ts`, and `.tsx` files for the generated Store and React modules.
    * @example
    * This example creates a Tools object and generates code for a Store that
    * already has a TablesSchema.
@@ -405,7 +423,9 @@ export interface Tools {
    *   },
    * });
    * const tools = createTools(store);
-   * const [dTs, ts] = await tools.getPrettyStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] = await createTools(
+   *   store,
+   * ).getPrettyStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[5]);
@@ -414,7 +434,7 @@ export interface Tools {
    * // -> 'export type PetsRow = {price?: number};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[72]);
+   * console.log(tsLines[75]);
    * // -> '    hasPetsTable: (): boolean => store.hasTable(PETS),'
    * ```
    * @example
@@ -426,7 +446,9 @@ export interface Tools {
    *   felix: {price: 4},
    * });
    * const tools = createTools(store);
-   * const [dTs, ts] = await tools.getPrettyStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] = await createTools(
+   *   store,
+   * ).getPrettyStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[5]);
@@ -435,13 +457,15 @@ export interface Tools {
    * // -> 'export type PetsRow = {price: number};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[74]);
+   * console.log(tsLines[77]);
    * // -> '    hasPetsTable: (): boolean => store.hasTable(PETS),'
    * ```
    * @category Modelling
    * @since v2.2.0
    */
-  getPrettyStoreApi(storeName: string): Promise<[string, string]>;
+  getPrettyStoreApi(
+    storeName: string,
+  ): Promise<[string, string, string, string]>;
 
   /**
    * The getStore method returns a reference to the underlying Store that is

package/lib/cjs-es6/ui-react.cjs

@@ -1 +1 @@
-"use strict";var e=require("react");const s=e=>typeof e,t=s(""),o=(e,s)=>e.map(s),r=e=>null==e,l=(e,s,t)=>r(e)?null==t?void 0:t():s(e),u=()=>{},{createContext:d,useContext:n}=e,a=d([]),i=(e,s)=>{const t=n(a);return r(e)?t[s]:((e,s)=>l(e,(e=>e[s])))(t[s+1],e)},p=(e,o)=>{const l=i(e,o);return r(e)||(e=>s(e)==t)(e)?l:e},c=e=>p(e,0),I=e=>p(e,2),x=e=>p(e,4),w=e=>p(e,6),b=e=>p(e,8),R=e=>p(e,10),{useCallback:C,useEffect:k,useMemo:v,useRef:g,useState:m}=e,V=(e,s,t=[])=>{const o=v((()=>s(e)),[e,...t]);return k((()=>()=>o.destroy()),[o]),o},h=(e,s,t,o=[],l)=>{const[,u]=m(),d=C((()=>{var r,l;return null!=(l=null==(r=null==s?void 0:s["get"+e])?void 0:r.call(s,...o))?l:t}),[s,...o]),[n]=m(d),a=g(n);return v((()=>a.current=d()),[d]),y(e,s,((...e)=>{a.current=r(l)?d():e[l],u([])}),[],o),a.current},y=(e,s,t,o=[],r=[],...l)=>k((()=>{var o;const u=null==(o=null==s?void 0:s["add"+e+"Listener"])?void 0:o.call(s,...r,t,...l);return()=>null==s?void 0:s.delListener(u)}),[s,...r,...o,...l]),L=(e,s,t,o=[],r=u,d=[],...n)=>{const a=c(e);return C((e=>l(a,(o=>l(t(e,o),(e=>r(o["set"+s](...n,e),e)))))),[a,s,...o,...d,...n])},S=(e,s,t=u,o=[],...r)=>{const l=c(e);return C((()=>t(null==l?void 0:l["del"+s](...r))),[l,s,...o,...r])},T=(e,s,t)=>{const o=R(e);return C((()=>null==o?void 0:o[s](t)),[o,s,t])},f=e=>h("TableIds",c(e),[],[]),P=(e,s)=>h("RowIds",c(s),[],[e]),q=(e,s,t,o=0,r,l)=>h("SortedRowIds",c(l),[],[e,s,t,o,r],6),O=(e,s,t)=>h("CellIds",c(t),[],[e,s]),B=(e,s,t,o)=>h("Cell",c(o),void 0,[e,s,t],4),M=e=>h("ValueIds",c(e),[],[]),D=(e,s)=>h("Value",c(s),void 0,[e]),j=(e,s)=>h("Metric",I(s),void 0,[e]),A=(e,s)=>h("SliceIds",x(s),[],[e]),E=(e,s,t)=>h("SliceRowIds",x(t),[],[e,s]),F=(e,s,t)=>h("RemoteRowId",w(t),void 0,[e,s]),G=(e,s,t)=>h("LocalRowIds",w(t),[],[e,s]),Q=(e,s,t)=>h("LinkedRowIds",w(t),[],[e,s]),U=(e,s)=>h("ResultRowIds",b(s),[],[e]),z=(e,s,t,o=0,r,l)=>h("ResultSortedRowIds",b(l),[],[e,s,t,o,r],6),H=(e,s,t)=>h("ResultCellIds",b(t),[],[e,s]),J=(e,s,t,o)=>h("ResultCell",b(o),void 0,[e,s,t]),K=e=>h("CheckpointIds",R(e),[[],void 0,[]]),N=(e,s)=>h("Checkpoint",R(s),void 0,[e]),W=e=>T(e,"goBackward"),X=e=>T(e,"goForward");var Y=Object.defineProperty,Z=Object.defineProperties,$=Object.getOwnPropertyDescriptors,_=Object.getOwnPropertySymbols,ee=Object.prototype.hasOwnProperty,se=Object.prototype.propertyIsEnumerable,te=(e,s,t)=>s in e?Y(e,s,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[s]=t,oe=(e,s)=>{for(var t in s||(s={}))ee.call(s,t)&&te(e,t,s[t]);if(_)for(var t of _(s))se.call(s,t)&&te(e,t,s[t]);return e},re=(e,s)=>Z(e,$(s)),le=(e,s)=>{var t={};for(var o in e)ee.call(e,o)&&s.indexOf(o)<0&&(t[o]=e[o]);if(null!=e&&_)for(var o of _(e))s.indexOf(o)<0&&se.call(e,o)&&(t[o]=e[o]);return t};const{createElement:ue,useMemo:de}=e,ne=({tableId:e,store:s,rowComponent:t=be,getRowComponentProps:r,separator:l,debugIds:u},d)=>xe(o(d,(o=>ue(t,re(oe({},Ie(r,o)),{key:o,tableId:e,rowId:o,store:s,debugIds:u})))),l,u,e),ae=({queryId:e,queries:s,resultRowComponent:t=ge,getResultRowComponentProps:r,separator:l,debugIds:u},d)=>xe(o(d,(o=>ue(t,re(oe({},Ie(r,o)),{key:o,queryId:e,rowId:o,queries:s,debugIds:u})))),l,u,e),ie=e=>{const s=w(e);return[s,null==s?void 0:s.getStore()]},pe=({relationshipId:e,relationships:s,rowComponent:t=be,getRowComponentProps:r,separator:l,debugIds:u},d,n)=>{const[a,i]=ie(s),p=null==a?void 0:a.getLocalTableId(e),c=d(e,n,a);return xe(o(c,(e=>ue(t,re(oe({},Ie(r,e)),{key:e,tableId:p,rowId:e,store:i,debugIds:u})))),l,u,n)},ce=e=>({checkpoints:s,checkpointComponent:t=me,getCheckpointComponentProps:r,separator:l,debugIds:u})=>{const d=R(s);return xe(o(e(K(d)),(e=>ue(t,re(oe({},Ie(r,e)),{key:e,checkpoints:d,checkpointId:e,debugIds:u})))),l)},Ie=(e,s)=>r(e)?{}:e(s),xe=(e,s,t,l)=>{const u=r(s)||!Array.isArray(e)?e:o(e,((e,t)=>t>0?[s,e]:e));return t?[l,":{",u,"}"]:u},we=({tableId:e,rowId:s,cellId:t,store:o,debugIds:r})=>{var l;return xe(""+(null!=(l=B(e,s,t,o))?l:""),void 0,r,t)},be=({tableId:e,rowId:s,store:t,cellComponent:r=we,getCellComponentProps:l,separator:u,debugIds:d})=>xe(o(O(e,s,t),(o=>ue(r,re(oe({},Ie(l,o)),{key:o,tableId:e,rowId:s,cellId:o,store:t,debugIds:d})))),u,d,s),Re=e=>ne(e,P(e.tableId,e.store)),Ce=({valueId:e,store:s,debugIds:t})=>{var o;return xe(""+(null!=(o=D(e,s))?o:""),void 0,t,e)},ke=({indexId:e,sliceId:s,indexes:t,rowComponent:r=be,getRowComponentProps:l,separator:u,debugIds:d})=>{const n=x(t),a=null==n?void 0:n.getStore(),i=null==n?void 0:n.getTableId(e),p=E(e,s,n);return xe(o(p,(e=>ue(r,re(oe({},Ie(l,e)),{key:e,tableId:i,rowId:e,store:a,debugIds:d})))),u,d,s)},ve=({queryId:e,rowId:s,cellId:t,queries:o,debugIds:r})=>{var l;return xe(""+(null!=(l=J(e,s,t,o))?l:""),void 0,r,t)},ge=({queryId:e,rowId:s,queries:t,resultCellComponent:r=ve,getResultCellComponentProps:l,separator:u,debugIds:d})=>xe(o(H(e,s,t),(o=>ue(r,re(oe({},Ie(l,o)),{key:o,queryId:e,rowId:s,cellId:o,queries:t,debugIds:d})))),u,d,s),me=({checkpoints:e,checkpointId:s,debugIds:t})=>{var o;return xe(null!=(o=N(s,e))?o:"",void 0,t,s)},Ve=ce((e=>e[0])),he=ce((e=>r(e[1])?[]:[e[1]])),ye=ce((e=>e[2]));exports.BackwardCheckpointsView=Ve,exports.CellView=we,exports.CheckpointView=me,exports.CurrentCheckpointView=he,exports.ForwardCheckpointsView=ye,exports.IndexView=({indexId:e,indexes:s,sliceComponent:t=ke,getSliceComponentProps:r,separator:l,debugIds:u})=>xe(o(A(e,s),(o=>ue(t,re(oe({},Ie(r,o)),{key:o,indexId:e,sliceId:o,indexes:s,debugIds:u})))),l,u,e),exports.LinkedRowsView=e=>pe(e,Q,e.firstRowId),exports.LocalRowsView=e=>pe(e,G,e.remoteRowId),exports.MetricView=({metricId:e,metrics:s,debugIds:t})=>{var o;return xe(null!=(o=j(e,s))?o:"",void 0,t,e)},exports.Provider=({store:s,storesById:t,metrics:o,metricsById:r,indexes:l,indexesById:u,relationships:d,relationshipsById:n,queries:i,queriesById:p,checkpoints:c,checkpointsById:I,children:x})=>{const w=e.useContext(a);return ue(a.Provider,{value:de((()=>[null!=s?s:w[0],oe(oe({},w[1]),t),null!=o?o:w[2],oe(oe({},w[3]),r),null!=l?l:w[4],oe(oe({},w[5]),u),null!=d?d:w[6],oe(oe({},w[7]),n),null!=i?i:w[8],oe(oe({},w[9]),p),null!=c?c:w[10],oe(oe({},w[11]),I)]),[s,t,o,r,l,u,d,n,i,p,c,I,w])},x)},exports.RemoteRowView=({relationshipId:e,localRowId:s,relationships:t,rowComponent:o=be,getRowComponentProps:l,debugIds:u})=>{const[d,n]=ie(t),a=null==d?void 0:d.getRemoteTableId(e),i=F(e,s,d);return xe(r(a)||r(i)?null:ue(o,re(oe({},Ie(l,i)),{key:i,tableId:a,rowId:i,store:n,debugIds:u})),void 0,u,s)},exports.ResultCellView=ve,exports.ResultRowView=ge,exports.ResultSortedTableView=e=>{var s=e,{cellId:t,descending:o,offset:r,limit:l}=s,u=le(s,["cellId","descending","offset","limit"]);return ae(u,z(u.queryId,t,o,r,l,u.queries))},exports.ResultTableView=e=>ae(e,U(e.queryId,e.queries)),exports.RowView=be,exports.SliceView=ke,exports.SortedTableView=e=>{var s=e,{cellId:t,descending:o,offset:r,limit:l}=s,u=le(s,["cellId","descending","offset","limit"]);return ne(u,q(u.tableId,t,o,r,l,u.store))},exports.TableView=Re,exports.TablesView=({store:e,tableComponent:s=Re,getTableComponentProps:t,separator:r,debugIds:l})=>xe(o(f(e),(o=>ue(s,re(oe({},Ie(t,o)),{key:o,tableId:o,store:e,debugIds:l})))),r),exports.ValueView=Ce,exports.ValuesView=({store:e,valueComponent:s=Ce,getValueComponentProps:t,separator:r,debugIds:l})=>xe(o(M(e),(o=>ue(s,re(oe({},Ie(t,o)),{key:o,valueId:o,store:e,debugIds:l})))),r),exports.tableView=ne,exports.useAddRowCallback=(e,s,t=[],o,r=u,d=[])=>{const n=c(o);return C((t=>l(n,(o=>l(s(t,o),(s=>r(o.addRow(e,s),o,s)))))),[n,e,...t,...d])},exports.useCell=B,exports.useCellIds=O,exports.useCellIdsListener=(e,s,t,o,r,l)=>y("CellIds",c(l),t,o,[e,s],r),exports.useCellListener=(e,s,t,o,r,l,u)=>y("Cell",c(u),o,r,[e,s,t],l),exports.useCheckpoint=N,exports.useCheckpointIds=K,exports.useCheckpointIdsListener=(e,s,t)=>y("CheckpointIds",R(t),e,s),exports.useCheckpointListener=(e,s,t,o)=>y("Checkpoint",R(o),s,t,[e]),exports.useCheckpoints=e=>i(e,10),exports.useCreateCheckpoints=(e,s,t)=>V(e,s,t),exports.useCreateIndexes=(e,s,t)=>V(e,s,t),exports.useCreateMetrics=(e,s,t)=>V(e,s,t),exports.useCreatePersister=(e,s,t=[],o,r=[])=>{const[,l]=m(),u=v((()=>s(e)),[e,...t]);return k((()=>{var e;return e=function*(){yield null==o?void 0:o(u),l(1)},new Promise(((s,t)=>{var o=s=>{try{l(e.next(s))}catch(e){t(e)}},r=s=>{try{l(e.throw(s))}catch(e){t(e)}},l=e=>e.done?s(e.value):Promise.resolve(e.value).then(o,r);l((e=e.apply(void 0,null)).next())})),()=>{u.destroy()}}),[u,...r]),u},exports.useCreateQueries=(e,s,t)=>V(e,s,t),exports.useCreateRelationships=(e,s,t)=>V(e,s,t),exports.useCreateStore=(e,s=[])=>v(e,s),exports.useDelCellCallback=(e,s,t,o,r,l,u)=>S(r,"Cell",l,u,e,s,t,o),exports.useDelRowCallback=(e,s,t,o,r)=>S(t,"Row",o,r,e,s),exports.useDelTableCallback=(e,s,t,o)=>S(s,"Table",t,o,e),exports.useDelTablesCallback=(e,s,t)=>S(e,"Tables",s,t),exports.useDelValueCallback=(e,s,t,o)=>S(s,"Value",t,o,e),exports.useDelValuesCallback=(e,s,t)=>S(e,"Values",s,t),exports.useGoBackwardCallback=W,exports.useGoForwardCallback=X,exports.useGoToCallback=(e,s=[],t,o=u,r=[])=>{const d=R(t);return C((s=>l(d,(t=>l(e(s),(e=>o(t.goTo(e),e)))))),[d,...s,...r])},exports.useIndexes=e=>i(e,4),exports.useLinkedRowIds=Q,exports.useLinkedRowIdsListener=(e,s,t,o,r)=>y("LinkedRowIds",w(r),t,o,[e,s]),exports.useLocalRowIds=G,exports.useLocalRowIdsListener=(e,s,t,o,r)=>y("LocalRowIds",w(r),t,o,[e,s]),exports.useMetric=j,exports.useMetricListener=(e,s,t,o)=>y("Metric",I(o),s,t,[e]),exports.useMetrics=e=>i(e,2),exports.useQueries=e=>i(e,8),exports.useRedoInformation=e=>{var s;const t=R(e),[,,[o]]=K(t);return[!r(o),X(t),o,null!=(s=l(o,(e=>null==t?void 0:t.getCheckpoint(e))))?s:""]},exports.useRelationships=e=>i(e,6),exports.useRemoteRowId=F,exports.useRemoteRowIdListener=(e,s,t,o,r)=>y("RemoteRowId",w(r),t,o,[e,s]),exports.useResultCell=J,exports.useResultCellIds=H,exports.useResultCellIdsListener=(e,s,t,o,r)=>y("ResultCellIds",b(r),t,o,[e,s]),exports.useResultCellListener=(e,s,t,o,r,l)=>y("ResultCell",b(l),o,r,[e,s,t]),exports.useResultRow=(e,s,t)=>h("ResultRow",b(t),{},[e,s]),exports.useResultRowIds=U,exports.useResultRowIdsListener=(e,s,t,o)=>y("ResultRowIds",b(o),s,t,[e]),exports.useResultRowListener=(e,s,t,o,r)=>y("ResultRow",b(r),t,o,[e,s]),exports.useResultSortedRowIds=z,exports.useResultSortedRowIdsListener=(e,s,t,o,r,l,u,d)=>y("ResultSortedRowIds",b(d),l,u,[e,s,t,o,r]),exports.useResultTable=(e,s)=>h("ResultTable",b(s),{},[e]),exports.useResultTableListener=(e,s,t,o)=>y("ResultTable",b(o),s,t,[e]),exports.useRow=(e,s,t)=>h("Row",c(t),{},[e,s]),exports.useRowIds=P,exports.useRowIdsListener=(e,s,t,o,r)=>y("RowIds",c(r),s,t,[e],o),exports.useRowListener=(e,s,t,o,r,l)=>y("Row",c(l),t,o,[e,s],r),exports.useSetCellCallback=(e,s,t,o,r,l,u,d)=>L(l,"Cell",o,r,u,d,e,s,t),exports.useSetCheckpointCallback=(e=u,s=[],t,o=u,r=[])=>{const d=R(t);return C((s=>l(d,(t=>{const r=e(s);o(t.addCheckpoint(r),t,r)}))),[d,...s,...r])},exports.useSetPartialRowCallback=(e,s,t,o,r,l,u)=>L(r,"PartialRow",t,o,l,u,e,s),exports.useSetPartialValuesCallback=(e,s,t,o,r)=>L(t,"PartialValues",e,s,o,r),exports.useSetRowCallback=(e,s,t,o,r,l,u)=>L(r,"Row",t,o,l,u,e,s),exports.useSetTableCallback=(e,s,t,o,r,l)=>L(o,"Table",s,t,r,l,e),exports.useSetTablesCallback=(e,s,t,o,r)=>L(t,"Tables",e,s,o,r),exports.useSetValueCallback=(e,s,t,o,r,l)=>L(o,"Value",s,t,r,l,e),exports.useSetValuesCallback=(e,s,t,o,r)=>L(t,"Values",e,s,o,r),exports.useSliceIds=A,exports.useSliceIdsListener=(e,s,t,o)=>y("SliceIds",x(o),s,t,[e]),exports.useSliceRowIds=E,exports.useSliceRowIdsListener=(e,s,t,o,r)=>y("SliceRowIds",x(r),t,o,[e,s]),exports.useSortedRowIds=q,exports.useSortedRowIdsListener=(e,s,t,o,r,l,u,d,n)=>y("SortedRowIds",c(n),l,u,[e,s,t,o,r],d),exports.useStore=e=>i(e,0),exports.useTable=(e,s)=>h("Table",c(s),{},[e]),exports.useTableIds=f,exports.useTableIdsListener=(e,s,t,o)=>y("TableIds",c(o),e,s,[],t),exports.useTableListener=(e,s,t,o,r)=>y("Table",c(r),s,t,[e],o),exports.useTables=e=>h("Tables",c(e),{}),exports.useTablesListener=(e,s,t,o)=>y("Tables",c(o),e,s,[],t),exports.useUndoInformation=e=>{var s;const t=R(e),[o,r]=K(t);return[(u=o,!(0==(e=>e.length)(u))),W(t),r,null!=(s=l(r,(e=>null==t?void 0:t.getCheckpoint(e))))?s:""];var u},exports.useValue=D,exports.useValueIds=M,exports.useValueIdsListener=(e,s,t,o)=>y("ValueIds",c(o),e,s,[],t),exports.useValueListener=(e,s,t,o,r)=>y("Value",c(r),s,t,[e],o),exports.useValues=e=>h("Values",c(e),{}),exports.useValuesListener=(e,s,t,o)=>y("Values",c(o),e,s,[],t);
+"use strict";var e=require("react");const s=e=>typeof e,t=s(""),o=(e,s)=>e.map(s),r=e=>null==e,l=(e,s,t)=>r(e)?null==t?void 0:t():s(e),u=e=>s(e)==t,d=()=>{},{createContext:n,useContext:a}=e,i=n([]),p=(e,s)=>{const t=a(i);return r(e)?t[s]:u(e)?((e,s)=>l(e,(e=>e[s])))(t[s+1],e):e},c=(e,s)=>{const t=p(e,s);return r(e)||u(e)?t:e},I=e=>c(e,0),x=e=>c(e,2),w=e=>c(e,4),b=e=>c(e,6),R=e=>c(e,8),C=e=>c(e,10),{useCallback:k,useEffect:v,useMemo:g,useRef:m,useState:V}=e,h=(e,s,t=[])=>{const o=g((()=>s(e)),[e,...t]);return v((()=>()=>o.destroy()),[o]),o},y=(e,s,t,o=[],l)=>{const[,u]=V(),d=k((()=>{var r,l;return null!=(l=null==(r=null==s?void 0:s["get"+e])?void 0:r.call(s,...o))?l:t}),[s,...o]),[n]=V(d),a=m(n);return g((()=>a.current=d()),[d]),L(e,s,((...e)=>{a.current=r(l)?d():e[l],u([])}),[],o),a.current},L=(e,s,t,o=[],r=[],...l)=>v((()=>{var o;const u=null==(o=null==s?void 0:s["add"+e+"Listener"])?void 0:o.call(s,...r,t,...l);return()=>null==s?void 0:s.delListener(u)}),[s,...r,...o,...l]),S=(e,s,t,o=[],r=d,u=[],...n)=>{const a=I(e);return k((e=>l(a,(o=>l(t(e,o),(e=>r(o["set"+s](...n,e),e)))))),[a,s,...o,...u,...n])},T=(e,s,t=d,o=[],...r)=>{const l=I(e);return k((()=>t(null==l?void 0:l["del"+s](...r))),[l,s,...o,...r])},f=(e,s,t)=>{const o=C(e);return k((()=>null==o?void 0:o[s](t)),[o,s,t])},P=e=>y("TableIds",I(e),[],[]),q=(e,s)=>y("RowIds",I(s),[],[e]),O=(e,s,t,o=0,r,l)=>y("SortedRowIds",I(l),[],[e,s,t,o,r],6),B=(e,s,t)=>y("CellIds",I(t),[],[e,s]),M=(e,s,t,o)=>y("Cell",I(o),void 0,[e,s,t],4),D=e=>y("ValueIds",I(e),[],[]),j=(e,s)=>y("Value",I(s),void 0,[e]),A=(e,s)=>y("Metric",x(s),void 0,[e]),E=(e,s)=>y("SliceIds",w(s),[],[e]),F=(e,s,t)=>y("SliceRowIds",w(t),[],[e,s]),G=(e,s,t)=>y("RemoteRowId",b(t),void 0,[e,s]),Q=(e,s,t)=>y("LocalRowIds",b(t),[],[e,s]),U=(e,s,t)=>y("LinkedRowIds",b(t),[],[e,s]),z=(e,s)=>y("ResultRowIds",R(s),[],[e]),H=(e,s,t,o=0,r,l)=>y("ResultSortedRowIds",R(l),[],[e,s,t,o,r],6),J=(e,s,t)=>y("ResultCellIds",R(t),[],[e,s]),K=(e,s,t,o)=>y("ResultCell",R(o),void 0,[e,s,t]),N=e=>y("CheckpointIds",C(e),[[],void 0,[]]),W=(e,s)=>y("Checkpoint",C(s),void 0,[e]),X=e=>f(e,"goBackward"),Y=e=>f(e,"goForward");var Z=Object.defineProperty,$=Object.defineProperties,_=Object.getOwnPropertyDescriptors,ee=Object.getOwnPropertySymbols,se=Object.prototype.hasOwnProperty,te=Object.prototype.propertyIsEnumerable,oe=(e,s,t)=>s in e?Z(e,s,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[s]=t,re=(e,s)=>{for(var t in s||(s={}))se.call(s,t)&&oe(e,t,s[t]);if(ee)for(var t of ee(s))te.call(s,t)&&oe(e,t,s[t]);return e},le=(e,s)=>$(e,_(s)),ue=(e,s)=>{var t={};for(var o in e)se.call(e,o)&&s.indexOf(o)<0&&(t[o]=e[o]);if(null!=e&&ee)for(var o of ee(e))s.indexOf(o)<0&&te.call(e,o)&&(t[o]=e[o]);return t};const{createElement:de,useMemo:ne}=e,ae=({tableId:e,store:s,rowComponent:t=Re,getRowComponentProps:r,separator:l,debugIds:u},d)=>we(o(d,(o=>de(t,le(re({},xe(r,o)),{key:o,tableId:e,rowId:o,store:s,debugIds:u})))),l,u,e),ie=({queryId:e,queries:s,resultRowComponent:t=me,getResultRowComponentProps:r,separator:l,debugIds:u},d)=>we(o(d,(o=>de(t,le(re({},xe(r,o)),{key:o,queryId:e,rowId:o,queries:s,debugIds:u})))),l,u,e),pe=e=>{const s=b(e);return[s,null==s?void 0:s.getStore()]},ce=({relationshipId:e,relationships:s,rowComponent:t=Re,getRowComponentProps:r,separator:l,debugIds:u},d,n)=>{const[a,i]=pe(s),p=null==a?void 0:a.getLocalTableId(e),c=d(e,n,a);return we(o(c,(e=>de(t,le(re({},xe(r,e)),{key:e,tableId:p,rowId:e,store:i,debugIds:u})))),l,u,n)},Ie=e=>({checkpoints:s,checkpointComponent:t=Ve,getCheckpointComponentProps:r,separator:l,debugIds:u})=>{const d=C(s);return we(o(e(N(d)),(e=>de(t,le(re({},xe(r,e)),{key:e,checkpoints:d,checkpointId:e,debugIds:u})))),l)},xe=(e,s)=>r(e)?{}:e(s),we=(e,s,t,l)=>{const u=r(s)||!Array.isArray(e)?e:o(e,((e,t)=>t>0?[s,e]:e));return t?[l,":{",u,"}"]:u},be=({tableId:e,rowId:s,cellId:t,store:o,debugIds:r})=>{var l;return we(""+(null!=(l=M(e,s,t,o))?l:""),void 0,r,t)},Re=({tableId:e,rowId:s,store:t,cellComponent:r=be,getCellComponentProps:l,separator:u,debugIds:d})=>we(o(B(e,s,t),(o=>de(r,le(re({},xe(l,o)),{key:o,tableId:e,rowId:s,cellId:o,store:t,debugIds:d})))),u,d,s),Ce=e=>ae(e,q(e.tableId,e.store)),ke=({valueId:e,store:s,debugIds:t})=>{var o;return we(""+(null!=(o=j(e,s))?o:""),void 0,t,e)},ve=({indexId:e,sliceId:s,indexes:t,rowComponent:r=Re,getRowComponentProps:l,separator:u,debugIds:d})=>{const n=w(t),a=null==n?void 0:n.getStore(),i=null==n?void 0:n.getTableId(e),p=F(e,s,n);return we(o(p,(e=>de(r,le(re({},xe(l,e)),{key:e,tableId:i,rowId:e,store:a,debugIds:d})))),u,d,s)},ge=({queryId:e,rowId:s,cellId:t,queries:o,debugIds:r})=>{var l;return we(""+(null!=(l=K(e,s,t,o))?l:""),void 0,r,t)},me=({queryId:e,rowId:s,queries:t,resultCellComponent:r=ge,getResultCellComponentProps:l,separator:u,debugIds:d})=>we(o(J(e,s,t),(o=>de(r,le(re({},xe(l,o)),{key:o,queryId:e,rowId:s,cellId:o,queries:t,debugIds:d})))),u,d,s),Ve=({checkpoints:e,checkpointId:s,debugIds:t})=>{var o;return we(null!=(o=W(s,e))?o:"",void 0,t,s)},he=Ie((e=>e[0])),ye=Ie((e=>r(e[1])?[]:[e[1]])),Le=Ie((e=>e[2]));exports.BackwardCheckpointsView=he,exports.CellView=be,exports.CheckpointView=Ve,exports.CurrentCheckpointView=ye,exports.ForwardCheckpointsView=Le,exports.IndexView=({indexId:e,indexes:s,sliceComponent:t=ve,getSliceComponentProps:r,separator:l,debugIds:u})=>we(o(E(e,s),(o=>de(t,le(re({},xe(r,o)),{key:o,indexId:e,sliceId:o,indexes:s,debugIds:u})))),l,u,e),exports.LinkedRowsView=e=>ce(e,U,e.firstRowId),exports.LocalRowsView=e=>ce(e,Q,e.remoteRowId),exports.MetricView=({metricId:e,metrics:s,debugIds:t})=>{var o;return we(null!=(o=A(e,s))?o:"",void 0,t,e)},exports.Provider=({store:s,storesById:t,metrics:o,metricsById:r,indexes:l,indexesById:u,relationships:d,relationshipsById:n,queries:a,queriesById:p,checkpoints:c,checkpointsById:I,children:x})=>{const w=e.useContext(i);return de(i.Provider,{value:ne((()=>[null!=s?s:w[0],re(re({},w[1]),t),null!=o?o:w[2],re(re({},w[3]),r),null!=l?l:w[4],re(re({},w[5]),u),null!=d?d:w[6],re(re({},w[7]),n),null!=a?a:w[8],re(re({},w[9]),p),null!=c?c:w[10],re(re({},w[11]),I)]),[s,t,o,r,l,u,d,n,a,p,c,I,w])},x)},exports.RemoteRowView=({relationshipId:e,localRowId:s,relationships:t,rowComponent:o=Re,getRowComponentProps:l,debugIds:u})=>{const[d,n]=pe(t),a=null==d?void 0:d.getRemoteTableId(e),i=G(e,s,d);return we(r(a)||r(i)?null:de(o,le(re({},xe(l,i)),{key:i,tableId:a,rowId:i,store:n,debugIds:u})),void 0,u,s)},exports.ResultCellView=ge,exports.ResultRowView=me,exports.ResultSortedTableView=e=>{var s=e,{cellId:t,descending:o,offset:r,limit:l}=s,u=ue(s,["cellId","descending","offset","limit"]);return ie(u,H(u.queryId,t,o,r,l,u.queries))},exports.ResultTableView=e=>ie(e,z(e.queryId,e.queries)),exports.RowView=Re,exports.SliceView=ve,exports.SortedTableView=e=>{var s=e,{cellId:t,descending:o,offset:r,limit:l}=s,u=ue(s,["cellId","descending","offset","limit"]);return ae(u,O(u.tableId,t,o,r,l,u.store))},exports.TableView=Ce,exports.TablesView=({store:e,tableComponent:s=Ce,getTableComponentProps:t,separator:r,debugIds:l})=>we(o(P(e),(o=>de(s,le(re({},xe(t,o)),{key:o,tableId:o,store:e,debugIds:l})))),r),exports.ValueView=ke,exports.ValuesView=({store:e,valueComponent:s=ke,getValueComponentProps:t,separator:r,debugIds:l})=>we(o(D(e),(o=>de(s,le(re({},xe(t,o)),{key:o,valueId:o,store:e,debugIds:l})))),r),exports.tableView=ae,exports.useAddRowCallback=(e,s,t=[],o,r=d,u=[])=>{const n=I(o);return k((t=>l(n,(o=>l(s(t,o),(s=>r(o.addRow(e,s),o,s)))))),[n,e,...t,...u])},exports.useCell=M,exports.useCellIds=B,exports.useCellIdsListener=(e,s,t,o,r,l)=>L("CellIds",I(l),t,o,[e,s],r),exports.useCellListener=(e,s,t,o,r,l,u)=>L("Cell",I(u),o,r,[e,s,t],l),exports.useCheckpoint=W,exports.useCheckpointIds=N,exports.useCheckpointIdsListener=(e,s,t)=>L("CheckpointIds",C(t),e,s),exports.useCheckpointListener=(e,s,t,o)=>L("Checkpoint",C(o),s,t,[e]),exports.useCheckpoints=e=>p(e,10),exports.useCreateCheckpoints=(e,s,t)=>h(e,s,t),exports.useCreateIndexes=(e,s,t)=>h(e,s,t),exports.useCreateMetrics=(e,s,t)=>h(e,s,t),exports.useCreatePersister=(e,s,t=[],o,r=[])=>{const[,l]=V(),u=g((()=>s(e)),[e,...t]);return v((()=>{var e;return e=function*(){yield null==o?void 0:o(u),l(1)},new Promise(((s,t)=>{var o=s=>{try{l(e.next(s))}catch(e){t(e)}},r=s=>{try{l(e.throw(s))}catch(e){t(e)}},l=e=>e.done?s(e.value):Promise.resolve(e.value).then(o,r);l((e=e.apply(void 0,null)).next())})),()=>{u.destroy()}}),[u,...r]),u},exports.useCreateQueries=(e,s,t)=>h(e,s,t),exports.useCreateRelationships=(e,s,t)=>h(e,s,t),exports.useCreateStore=(e,s=[])=>g(e,s),exports.useDelCellCallback=(e,s,t,o,r,l,u)=>T(r,"Cell",l,u,e,s,t,o),exports.useDelRowCallback=(e,s,t,o,r)=>T(t,"Row",o,r,e,s),exports.useDelTableCallback=(e,s,t,o)=>T(s,"Table",t,o,e),exports.useDelTablesCallback=(e,s,t)=>T(e,"Tables",s,t),exports.useDelValueCallback=(e,s,t,o)=>T(s,"Value",t,o,e),exports.useDelValuesCallback=(e,s,t)=>T(e,"Values",s,t),exports.useGoBackwardCallback=X,exports.useGoForwardCallback=Y,exports.useGoToCallback=(e,s=[],t,o=d,r=[])=>{const u=C(t);return k((s=>l(u,(t=>l(e(s),(e=>o(t.goTo(e),e)))))),[u,...s,...r])},exports.useIndexes=e=>p(e,4),exports.useLinkedRowIds=U,exports.useLinkedRowIdsListener=(e,s,t,o,r)=>L("LinkedRowIds",b(r),t,o,[e,s]),exports.useLocalRowIds=Q,exports.useLocalRowIdsListener=(e,s,t,o,r)=>L("LocalRowIds",b(r),t,o,[e,s]),exports.useMetric=A,exports.useMetricListener=(e,s,t,o)=>L("Metric",x(o),s,t,[e]),exports.useMetrics=e=>p(e,2),exports.useQueries=e=>p(e,8),exports.useRedoInformation=e=>{var s;const t=C(e),[,,[o]]=N(t);return[!r(o),Y(t),o,null!=(s=l(o,(e=>null==t?void 0:t.getCheckpoint(e))))?s:""]},exports.useRelationships=e=>p(e,6),exports.useRemoteRowId=G,exports.useRemoteRowIdListener=(e,s,t,o,r)=>L("RemoteRowId",b(r),t,o,[e,s]),exports.useResultCell=K,exports.useResultCellIds=J,exports.useResultCellIdsListener=(e,s,t,o,r)=>L("ResultCellIds",R(r),t,o,[e,s]),exports.useResultCellListener=(e,s,t,o,r,l)=>L("ResultCell",R(l),o,r,[e,s,t]),exports.useResultRow=(e,s,t)=>y("ResultRow",R(t),{},[e,s]),exports.useResultRowIds=z,exports.useResultRowIdsListener=(e,s,t,o)=>L("ResultRowIds",R(o),s,t,[e]),exports.useResultRowListener=(e,s,t,o,r)=>L("ResultRow",R(r),t,o,[e,s]),exports.useResultSortedRowIds=H,exports.useResultSortedRowIdsListener=(e,s,t,o,r,l,u,d)=>L("ResultSortedRowIds",R(d),l,u,[e,s,t,o,r]),exports.useResultTable=(e,s)=>y("ResultTable",R(s),{},[e]),exports.useResultTableListener=(e,s,t,o)=>L("ResultTable",R(o),s,t,[e]),exports.useRow=(e,s,t)=>y("Row",I(t),{},[e,s]),exports.useRowIds=q,exports.useRowIdsListener=(e,s,t,o,r)=>L("RowIds",I(r),s,t,[e],o),exports.useRowListener=(e,s,t,o,r,l)=>L("Row",I(l),t,o,[e,s],r),exports.useSetCellCallback=(e,s,t,o,r,l,u,d)=>S(l,"Cell",o,r,u,d,e,s,t),exports.useSetCheckpointCallback=(e=d,s=[],t,o=d,r=[])=>{const u=C(t);return k((s=>l(u,(t=>{const r=e(s);o(t.addCheckpoint(r),t,r)}))),[u,...s,...r])},exports.useSetPartialRowCallback=(e,s,t,o,r,l,u)=>S(r,"PartialRow",t,o,l,u,e,s),exports.useSetPartialValuesCallback=(e,s,t,o,r)=>S(t,"PartialValues",e,s,o,r),exports.useSetRowCallback=(e,s,t,o,r,l,u)=>S(r,"Row",t,o,l,u,e,s),exports.useSetTableCallback=(e,s,t,o,r,l)=>S(o,"Table",s,t,r,l,e),exports.useSetTablesCallback=(e,s,t,o,r)=>S(t,"Tables",e,s,o,r),exports.useSetValueCallback=(e,s,t,o,r,l)=>S(o,"Value",s,t,r,l,e),exports.useSetValuesCallback=(e,s,t,o,r)=>S(t,"Values",e,s,o,r),exports.useSliceIds=E,exports.useSliceIdsListener=(e,s,t,o)=>L("SliceIds",w(o),s,t,[e]),exports.useSliceRowIds=F,exports.useSliceRowIdsListener=(e,s,t,o,r)=>L("SliceRowIds",w(r),t,o,[e,s]),exports.useSortedRowIds=O,exports.useSortedRowIdsListener=(e,s,t,o,r,l,u,d,n)=>L("SortedRowIds",I(n),l,u,[e,s,t,o,r],d),exports.useStore=e=>p(e,0),exports.useTable=(e,s)=>y("Table",I(s),{},[e]),exports.useTableIds=P,exports.useTableIdsListener=(e,s,t,o)=>L("TableIds",I(o),e,s,[],t),exports.useTableListener=(e,s,t,o,r)=>L("Table",I(r),s,t,[e],o),exports.useTables=e=>y("Tables",I(e),{}),exports.useTablesListener=(e,s,t,o)=>L("Tables",I(o),e,s,[],t),exports.useUndoInformation=e=>{var s;const t=C(e),[o,r]=N(t);return[(u=o,!(0==(e=>e.length)(u))),X(t),r,null!=(s=l(r,(e=>null==t?void 0:t.getCheckpoint(e))))?s:""];var u},exports.useValue=j,exports.useValueIds=D,exports.useValueIdsListener=(e,s,t,o)=>L("ValueIds",I(o),e,s,[],t),exports.useValueListener=(e,s,t,o,r)=>L("Value",I(r),s,t,[e],o),exports.useValues=e=>y("Values",I(e),{}),exports.useValuesListener=(e,s,t,o)=>L("Values",I(o),e,s,[],t);

package/lib/debug/queries.js

@@ -12,12 +12,13 @@ const LISTENER = 'Listener';
 const RESULT = 'Result';
 const GET = 'get';
 const ADD = 'add';
+const IDS = 'Ids';
 const TABLE = 'Table';
-const ROW_IDS = 'RowIds';
-const SORTED_ROW_IDS = 'SortedRowIds';
 const ROW = 'Row';
-const CELL_IDS = 'CellIds';
+const ROW_IDS = ROW + IDS;
+const SORTED_ROW_IDS = 'Sorted' + ROW + IDS;
 const CELL = 'Cell';
+const CELL_IDS = CELL + IDS;
 
 const arrayEvery = (array, cb) => array.every(cb);
 const arrayIsEqual = (array1, array2) =>

package/lib/debug/store.js

@@ -8,16 +8,17 @@ const TYPE = 'type';
 const DEFAULT = 'default';
 const LISTENER = 'Listener';
 const ADD = 'add';
-const TABLES = 'Tables';
-const TABLE_IDS = 'TableIds';
+const IDS = 'Ids';
 const TABLE = 'Table';
-const ROW_IDS = 'RowIds';
+const TABLES = TABLE + 's';
+const TABLE_IDS = TABLE + IDS;
 const ROW = 'Row';
-const CELL_IDS = 'CellIds';
+const ROW_IDS = ROW + IDS;
 const CELL = 'Cell';
-const VALUES = 'Values';
-const VALUE_IDS = 'ValueIds';
+const CELL_IDS = CELL + IDS;
 const VALUE = 'Value';
+const VALUES = VALUE + 's';
+const VALUE_IDS = VALUE + IDS;
 const id = (key) => EMPTY_STRING + key;
 
 const arrayHas = (array, value) => array.includes(value);

package/lib/debug/tinybase.js

@@ -17,17 +17,18 @@ const LISTENER = 'Listener';
 const RESULT = 'Result';
 const GET = 'get';
 const ADD = 'add';
-const TABLES = 'Tables';
-const TABLE_IDS = 'TableIds';
+const IDS = 'Ids';
 const TABLE = 'Table';
-const ROW_IDS = 'RowIds';
-const SORTED_ROW_IDS = 'SortedRowIds';
+const TABLES = TABLE + 's';
+const TABLE_IDS = TABLE + IDS;
 const ROW = 'Row';
-const CELL_IDS = 'CellIds';
+const ROW_IDS = ROW + IDS;
+const SORTED_ROW_IDS = 'Sorted' + ROW + IDS;
 const CELL = 'Cell';
-const VALUES = 'Values';
-const VALUE_IDS = 'ValueIds';
+const CELL_IDS = CELL + IDS;
 const VALUE = 'Value';
+const VALUES = VALUE + 's';
+const VALUE_IDS = VALUE + IDS;
 const id = (key) => EMPTY_STRING + key;
 
 const arrayHas = (array, value) => array.includes(value);

package/lib/debug/tools.d.ts

@@ -272,26 +272,35 @@ export interface Tools {
   getStoreValuesSchema(): ValuesSchema;
 
   /**
-   * The getStoreApi method returns a code-generated .d.ts file and a .ts file
-   * that describe the schema of a Store in an ORM style.
+   * The getStoreApi method returns code-generated .d.ts and .ts(x) files that
+   * describe the schema of a Store and React bindings (since v3.1.0) in an ORM
+   * style.
    *
-   * If the Store does not already have an explicit TablesSchema associated with
-   * it, the data in the Store will be scanned to attempt to infer a new
-   * TablesSchema. The method returns two strings (which should be saved as
-   * files) though if no schema can be inferred, the strings will be empty.
+   * If the Store does not already have an explicit TablesSchema or ValuesSchema
+   * associated with it, the data in the Store will be scanned to attempt to
+   * infer new schemas. The method returns four strings (which should be saved
+   * as files) though if no schema can be inferred, the strings will be empty.
    *
    * The method takes a single argument which represents the name you want the
-   * generated store object to have in code. You are expected to save the files
-   * as `[storeName].d.ts` and `[storeName].ts`, and alongside each other so
-   * that the latter can import types from the former.
+   * generated store object to have in code. You are expected to save the four
+   * files yourself, as, respectively:
+   *
+   * - `[storeName].d.ts`
+   * - `[storeName].ts`
+   * - `[storeName]-ui-react.d.ts`
+   * - `[storeName]-ui-react.tsx`
+   *
+   * Also you should save these alongside each other so that the .ts(x) files
+   * can import types from the .d.ts files.
    *
-   * The .d.ts and .ts files that are generated are designed to resemble the
-   * main TinyBase `store.d.ts` and `store.ts` files, but provide named types
-   * and methods that describe the domain of the schema in the store.
+   * The .d.ts and .ts(x) files that are generated are designed to resemble the
+   * main TinyBase Store and React binding files, but provide named types and
+   * methods that describe the domain of the schema in the store.
    *
    * For example, from a Store that has a `pets` Table, you will get methods
-   * like `getPetsTable`, and types like `PetsRow`, that are more specific
-   * versions of the underlying getTable method or the Row type. For example:
+   * like `getPetsTable`, types like `PetsRow`, and hooks and components that
+   * are more specific versions of the underlying getTable method or the Row
+   * type, and so on. For example:
    *
    * |Store type|Equivalent generated type|
    * |-|-|
@@ -321,9 +330,9 @@ export interface Tools {
    * directly.
    *
    * @param storeName The name you want to provide to the generated Store, which
-   * should also be used to save the `.d.ts` and `.ts` files.
-   * @returns A pair of strings representing the contents of the `.d.ts` and
-   * `.ts` files.
+   * should also be used to save the `.d.ts`, `.ts`, and `.tsx` files.
+   * @returns A set of four strings representing the contents of the `.d.ts`,
+   * `.ts`, and `.tsx` files for the generated Store and React modules.
    * @example
    * This example creates a Tools object and generates code for a Store that
    * already has a TablesSchema.
@@ -333,7 +342,8 @@ export interface Tools {
    *     price: {type: 'number'},
    *   },
    * });
-   * const [dTs, ts] = createTools(store).getStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] =
+   *   createTools(store).getStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[3]);
@@ -342,7 +352,7 @@ export interface Tools {
    * // -> 'export type PetsRow = {\'price\'?: number;};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[41]);
+   * console.log(tsLines[39]);
    * // -> 'getPetsTable: (): PetsTable => store.getTable(PETS) as PetsTable,'
    * ```
    * @example
@@ -353,7 +363,8 @@ export interface Tools {
    *   fido: {price: 5},
    *   felix: {price: 4},
    * });
-   * const [dTs, ts] = createTools(store).getStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] =
+   *   createTools(store).getStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[3]);
@@ -362,18 +373,18 @@ export interface Tools {
    * // -> 'export type PetsRow = {\'price\': number;};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[43]);
+   * console.log(tsLines[41]);
    * // -> 'getPetsTable: (): PetsTable => store.getTable(PETS) as PetsTable,'
    * ```
    * @category Modelling
    * @since v2.2.0
    */
-  getStoreApi(storeName: string): [string, string];
+  getStoreApi(storeName: string): [string, string, string, string];
 
   /**
    * The getPrettyStoreApi method attempts to returns a prettified
-   * code-generated .d.ts file and a .ts file that describe the schema of a
-   * Store in an ORM style.
+   * code-generated .d.ts and .ts(x) files that describe the schema of a Store
+   * and React bindings (since v3.1.0) in an ORM style.
    *
    * This is simply a wrapper around the getStoreApi method that attempts to
    * invoke the `prettier` module (which it hopes you have installed) to format
@@ -384,17 +395,24 @@ export interface Tools {
    * the results as a promise.
    *
    * The method takes a single argument which represents the name you want the
-   * generated store object to have in code. You are expected to save the files
-   * as `[storeName].d.ts` and `[storeName].ts`, and alongside each other so
-   * that the latter can import types from the former.
+   * generated store object to have in code. You are expected to save the four
+   * files yourself, as, respectively:
+   *
+   * - `[storeName].d.ts`
+   * - `[storeName].ts`
+   * - `[storeName]-ui-react.d.ts`
+   * - `[storeName]-ui-react.tsx`
+   *
+   * Also you should save these alongside each other so that the .ts(x) files
+   * can import types from the .d.ts files.
    *
    * See the documentation for the getStoreApi method for details of the content
    * of the generated files.
    *
    * @param storeName The name you want to provide to the generated Store, which
-   * should also be used to save the `.d.ts` and `.ts` files.
-   * @returns A pair of strings representing the contents of the `.d.ts` and
-   * `.ts` files.
+   * should also be used to save the `.d.ts`, `.ts`, and `.tsx` files.
+   * @returns A set of four strings representing the contents of the `.d.ts`,
+   * `.ts`, and `.tsx` files for the generated Store and React modules.
    * @example
    * This example creates a Tools object and generates code for a Store that
    * already has a TablesSchema.
@@ -405,7 +423,9 @@ export interface Tools {
    *   },
    * });
    * const tools = createTools(store);
-   * const [dTs, ts] = await tools.getPrettyStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] = await createTools(
+   *   store,
+   * ).getPrettyStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[5]);
@@ -414,7 +434,7 @@ export interface Tools {
    * // -> 'export type PetsRow = {price?: number};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[72]);
+   * console.log(tsLines[75]);
    * // -> '    hasPetsTable: (): boolean => store.hasTable(PETS),'
    * ```
    * @example
@@ -426,7 +446,9 @@ export interface Tools {
    *   felix: {price: 4},
    * });
    * const tools = createTools(store);
-   * const [dTs, ts] = await tools.getPrettyStoreApi('shop');
+   * const [dTs, ts, dTsUiReact, tsUiReact] = await createTools(
+   *   store,
+   * ).getPrettyStoreApi('shop');
    *
    * const dTsLines = dTs.split('\n');
    * console.log(dTsLines[5]);
@@ -435,13 +457,15 @@ export interface Tools {
    * // -> 'export type PetsRow = {price: number};'
    *
    * const tsLines = ts.split('\n');
-   * console.log(tsLines[74]);
+   * console.log(tsLines[77]);
    * // -> '    hasPetsTable: (): boolean => store.hasTable(PETS),'
    * ```
    * @category Modelling
    * @since v2.2.0
    */
-  getPrettyStoreApi(storeName: string): Promise<[string, string]>;
+  getPrettyStoreApi(
+    storeName: string,
+  ): Promise<[string, string, string, string]>;
 
   /**
    * The getStore method returns a reference to the underlying Store that is