flowerbi-react 1.21.0 → 3.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 Defines hooks for working with FlowerBI from React applications:
 
-- `useQuery` - the state of a query and the data it produces
+- `useFlowerBI` - the state of a query and the data it produces
 - `usePageFilters` - a shared set of filters that chart components can interact via
 
 Also some components:

package/dist/FlowerBITable.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { QueryValues, ExpandedQueryResult, QuerySelect } from "flowerbi";
 export declare type ColumnDefinition = string | [string, "left" | "right"];
 export declare type FlowerBITableProps<S extends QuerySelect> = {

package/dist/FlowerBITable.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowerBITable = void 0;
 var react_1 = __importDefault(require("react"));
 var flowerbi_1 = require("flowerbi");
 function renderCell(key, def) {

package/dist/FlowerBITable.js.map

@@ -1 +1 @@
-{"version":3,"file":"FlowerBITable.js","sourceRoot":"","sources":["../src/FlowerBITable.tsx"],"names":[],"mappings":";;;;;AAAA,gDAA0B;AAC1B,qCAA2G;AAI3G,SAAS,UAAU,CAAC,GAAW,EAAE,GAAqB;IAClD,IAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,IAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO,CACH,sCAAI,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,IACzB,KAAK,CACL,CACR,CAAC;AACN,CAAC;AASD,SAAgB,aAAa,CAAwB,EAAsC;QAArC,cAAI,EAAE,oBAAO;IAC/D,OAAO,CACH;QACI;YACI,0CACK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,CAClC,sCAAI,GAAG,EAAE,MAAM,IAAG,MAAM,CAAM,CACjC,EAFqC,CAErC,CAAC,CACD,CACD;QACR,6CACK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAC,MAAM,EAAE,CAAC;;YAAK,OAAA,CAC7B,sCAAI,GAAG,QAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAI,CAAC,IAEzC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,UAAU,CAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,yBAAc,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EADhC,CACgC,CAAC,CAErE,CACR,CAAA;SAAA,CAAC,CACE;QACP,IAAI,CAAC,MAAM,IAAI,CACZ;YACI,0CAEI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,UAAU,CAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,2BAAgB,CAAC,IAAI,CAAC,MAAO,CAAC,CAAC,CAAC,EAD3B,CAC2B,CAAC,CAEhE,CACD,CACX,CACG,CACX,CAAC;AACN,CAAC;AAhCD,sCAgCC"}
+{"version":3,"file":"FlowerBITable.js","sourceRoot":"","sources":["../src/FlowerBITable.tsx"],"names":[],"mappings":";;;;;;AAAA,gDAA0B;AAC1B,qCAA2G;AAI3G,SAAS,UAAU,CAAC,GAAW,EAAE,GAAqB;IAClD,IAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,IAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO,CACH,sCAAI,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,IACzB,KAAK,CACL,CACR,CAAC;AACN,CAAC;AASD,SAAgB,aAAa,CAAwB,EAAsC;QAArC,IAAI,UAAA,EAAE,OAAO,aAAA;IAC/D,OAAO,CACH;QACI;YACI,0CACK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,CAClC,sCAAI,GAAG,EAAE,MAAM,IAAG,MAAM,CAAM,CACjC,EAFqC,CAErC,CAAC,CACD,CACD;QACR,6CACK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAC,MAAM,EAAE,CAAC;;YAAK,OAAA,CAC7B,sCAAI,GAAG,EAAE,MAAA,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAI,CAAC,IAEzC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,UAAU,CAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,yBAAc,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EADhC,CACgC,CAAC,CAErE,CACR,CAAA;SAAA,CAAC,CACE;QACP,IAAI,CAAC,MAAM,IAAI,CACZ;YACI,0CAEI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,UAAU,CAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,2BAAgB,CAAC,IAAI,CAAC,MAAO,CAAC,CAAC,CAAC,EAD3B,CAC2B,CAAC,CAEhE,CACD,CACX,CACG,CACX,CAAC;AACN,CAAC;AAhCD,sCAgCC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * from "./FlowerBITable";
 export * from "./usePageFilters";
-export * from "./useQuery";
+export * from "./useFlowerBI";

package/dist/index.js

@@ -1,9 +1,20 @@
 "use strict";
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-__export(require("./FlowerBITable"));
-__export(require("./usePageFilters"));
-__export(require("./useQuery"));
+__exportStar(require("./FlowerBITable"), exports);
+__exportStar(require("./usePageFilters"), exports);
+__exportStar(require("./useFlowerBI"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAAA,qCAAgC;AAChC,sCAAiC;AACjC,gCAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,mDAAiC;AACjC,gDAA8B"}

package/dist/{useQuery.d.ts → useFlowerBI.d.ts}

@@ -43,4 +43,8 @@ export declare type QueryDependency = {
  * results are used to build this query, so we wait for them before executing,
  * and optionally short-circuit to an empty result if the dependency is empty.
  */
-export declare function useQuery<S extends QuerySelect>(fetch: QueryFetch, query: Query<S>, dependencies?: QueryDependency[]): UseQueryResult<S>;
+export declare function useFlowerBI<S extends QuerySelect>(fetch: QueryFetch, query: Query<S>, dependencies?: QueryDependency[]): UseQueryResult<S>;
+/**
+ * Alias of useFlowerBI for backward compatibility.
+ */
+export declare const useQuery: typeof useFlowerBI;

package/dist/useFlowerBI.js

@@ -0,0 +1,82 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQuery = exports.useFlowerBI = void 0;
+var react_1 = require("react");
+var flowerbi_1 = require("flowerbi");
+var json_stable_stringify_1 = __importDefault(require("json-stable-stringify"));
+/**
+ * A custom React hook that evaluates to the result of a
+ * [Query](../flowerbi/interfaces/query.html), making it easy to perform a
+ * query from within a component.
+ *
+ * The returned object has a strongly-typed `records` array, and optionally
+ * a `totals` object. It has a `state` of type {@link UseQueryState} that
+ * can be used to show a loading indicator.
+ *
+ * @param fetch The fetch function to use.
+ * @param query The [Query](../flowerbi/interfaces/query.html) specification.
+ * @param dependencies Optionally, a list of one or more other queries whose
+ * results are used to build this query, so we wait for them before executing,
+ * and optionally short-circuit to an empty result if the dependency is empty.
+ */
+function useFlowerBI(fetch, query, dependencies) {
+    var queryJson = (0, flowerbi_1.jsonifyQuery)(query);
+    var _a = (0, react_1.useState)("init"), state = _a[0], setState = _a[1];
+    var _b = (0, react_1.useState)({ records: [] }), result = _b[0], setResult = _b[1];
+    (0, react_1.useEffect)(function () {
+        var disposed = false; // discard stale results
+        if (dependencies === null || dependencies === void 0 ? void 0 : dependencies.length) {
+            // if any not ready, neither are we
+            if (dependencies.some(function (x) { return x.dependency.state !== "ready"; })) {
+                if (state !== "init") {
+                    setState("refresh");
+                }
+                return;
+            }
+            // if any with option nonEmpty produced empty result, so do we
+            if (dependencies.filter(function (x) { return !!x.nonEmpty; }).some(function (x) { return !x.dependency.records.length; })) {
+                setState("ready");
+                setResult({ records: [] });
+                return;
+            }
+        }
+        if (state !== "init") {
+            setState("refresh");
+        }
+        fetch(queryJson).then(function (x) {
+            if (!disposed) {
+                setState("ready");
+                setResult(x);
+            }
+        }, function () {
+            if (!disposed) {
+                setState("error");
+            }
+        });
+        return function () {
+            disposed = true;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [fetch, (0, json_stable_stringify_1.default)(queryJson)]);
+    return __assign(__assign({}, (0, flowerbi_1.expandQueryResult)(query.select, result)), { state: state });
+}
+exports.useFlowerBI = useFlowerBI;
+/**
+ * Alias of useFlowerBI for backward compatibility.
+ */
+exports.useQuery = useFlowerBI;
+//# sourceMappingURL=useFlowerBI.js.map

package/dist/useFlowerBI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlowerBI.js","sourceRoot":"","sources":["../src/useFlowerBI.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAAoD;AACpD,qCAAiI;AACjI,gFAAoD;AAkCpD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,WAAW,CAAwB,KAAiB,EAAE,KAAe,EAAE,YAAgC;IACnH,IAAM,SAAS,GAAG,IAAA,uBAAY,EAAC,KAAK,CAAC,CAAC;IAEhC,IAAA,KAAoB,IAAA,gBAAQ,EAAgB,MAAM,CAAC,EAAlD,KAAK,QAAA,EAAE,QAAQ,QAAmC,CAAC;IACpD,IAAA,KAAsB,IAAA,gBAAQ,EAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAA/D,MAAM,QAAA,EAAE,SAAS,QAA8C,CAAC;IAEvE,IAAA,iBAAS,EAAC;QACN,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,wBAAwB;QAE9C,IAAI,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,MAAM,EAAE;YACtB,mCAAmC;YACnC,IAAI,YAAY,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,OAAO,EAA9B,CAA8B,CAAC,EAAE;gBACxD,IAAI,KAAK,KAAK,MAAM,EAAE;oBAClB,QAAQ,CAAC,SAAS,CAAC,CAAC;iBACvB;gBACD,OAAO;aACV;YAED,8DAA8D;YAC9D,IAAI,YAAY,CAAC,MAAM,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAZ,CAAY,CAAC,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAA5B,CAA4B,CAAC,EAAE;gBAChF,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAClB,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3B,OAAO;aACV;SACJ;QAED,IAAI,KAAK,KAAK,MAAM,EAAE;YAClB,QAAQ,CAAC,SAAS,CAAC,CAAC;SACvB;QAED,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CACjB,UAAA,CAAC;YACG,IAAI,CAAC,QAAQ,EAAE;gBACX,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAClB,SAAS,CAAC,CAAC,CAAC,CAAC;aAChB;QACL,CAAC,EACD;YACI,IAAI,CAAC,QAAQ,EAAE;gBACX,QAAQ,CAAC,OAAO,CAAC,CAAC;aACrB;QACL,CAAC,CACJ,CAAC;QAEF,OAAO;YACH,QAAQ,GAAG,IAAI,CAAC;QACpB,CAAC,CAAC;QACF,uDAAuD;IAC3D,CAAC,EAAE,CAAC,KAAK,EAAE,IAAA,+BAAe,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAExC,6BAAY,IAAA,4BAAiB,EAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAE,KAAK,OAAA,IAAG;AACjE,CAAC;AAnDD,kCAmDC;AAED;;GAEG;AACU,QAAA,QAAQ,GAAG,WAAW,CAAC"}

package/dist/usePageFilters.js

@@ -10,17 +10,29 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePageFilters = void 0;
 var react_1 = require("react");
+var json_stable_stringify_1 = __importDefault(require("json-stable-stringify"));
 var clearedState = {
     global: [],
     interactions: [],
     interactionKey: "",
 };
 function usePageFilters() {
-    var _a = react_1.useState(clearedState), state = _a[0], set = _a[1];
+    var _a = (0, react_1.useState)(clearedState), state = _a[0], set = _a[1];
     function setInteraction(interactionKey, interactions) {
-        set(__assign(__assign({}, state), { interactionKey: interactionKey, interactions: interactions }));
+        console.log(interactionKey, state.interactionKey, state.interactionKey === interactionKey, interactions, state.interactions, (0, json_stable_stringify_1.default)(state.interactions), (0, json_stable_stringify_1.default)(interactions), (0, json_stable_stringify_1.default)(state.interactions) === (0, json_stable_stringify_1.default)(interactions));
+        if (state.interactionKey === interactionKey &&
+            (0, json_stable_stringify_1.default)(state.interactions) === (0, json_stable_stringify_1.default)(interactions)) {
+            clearInteraction();
+        }
+        else {
+            set(__assign(__assign({}, state), { interactionKey: interactionKey, interactions: interactions }));
+        }
     }
     function setGlobal(global) {
         set(__assign(__assign({}, state), { global: global }));

package/dist/usePageFilters.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePageFilters.js","sourceRoot":"","sources":["../src/usePageFilters.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,+BAAiC;AAkBjC,IAAM,YAAY,GAAqB;IACnC,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,EAAE;CACrB,CAAC;AAEF,SAAgB,cAAc;IACpB,IAAA,mCAAuD,EAAtD,aAAK,EAAE,WAA+C,CAAC;IAC9D,SAAS,cAAc,CAAC,cAAsB,EAAE,YAA0B;QACtE,GAAG,uBAAM,KAAK,KAAE,cAAc,gBAAA,EAAE,YAAY,cAAA,IAAG,CAAC;IACpD,CAAC;IACD,SAAS,SAAS,CAAC,MAAoB;QACnC,GAAG,uBAAM,KAAK,KAAE,MAAM,QAAA,IAAG,CAAC;IAC9B,CAAC;IACD,SAAS,gBAAgB;QACrB,GAAG,uBAAM,KAAK,KAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,IAAG,CAAC;IAC5D,CAAC;IACD,SAAS,WAAW;QAChB,GAAG,uBAAM,KAAK,KAAE,MAAM,EAAE,EAAE,IAAG,CAAC;IAClC,CAAC;IACD,SAAS,QAAQ;QACb,GAAG,CAAC,YAAY,CAAC,CAAC;IACtB,CAAC;IACD,SAAS,UAAU,CAAC,GAAW;QAC3B,IAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,OAAO,GAAG,KAAK,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrF,CAAC;IACD,6BAAY,KAAK,KAAE,cAAc,gBAAA,EAAE,SAAS,WAAA,EAAE,gBAAgB,kBAAA,EAAE,WAAW,aAAA,EAAE,QAAQ,UAAA,EAAE,UAAU,YAAA,IAAG;AACxG,CAAC;AAtBD,wCAsBC"}
+{"version":3,"file":"usePageFilters.js","sourceRoot":"","sources":["../src/usePageFilters.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAAiC;AAEjC,gFAAoD;AAiBpD,IAAM,YAAY,GAAqB;IACnC,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,EAAE;CACrB,CAAC;AAEF,SAAgB,cAAc;IACpB,IAAA,KAAe,IAAA,gBAAQ,EAAmB,YAAY,CAAC,EAAtD,KAAK,QAAA,EAAE,GAAG,QAA4C,CAAC;IAC9D,SAAS,cAAc,CAAC,cAAsB,EAAE,YAA0B;QACtE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,cAAc,EACrF,YAAY,EAAE,KAAK,CAAC,YAAY,EAChC,IAAA,+BAAe,EAAC,KAAK,CAAC,YAAY,CAAC,EAAE,IAAA,+BAAe,EAAC,YAAY,CAAC,EAClE,IAAA,+BAAe,EAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAA,+BAAe,EAAC,YAAY,CAAC,CAAC,CAAC;QAE3E,IAAI,KAAK,CAAC,cAAc,KAAK,cAAc;YACvC,IAAA,+BAAe,EAAC,KAAK,CAAC,YAAY,CAAC,KAAK,IAAA,+BAAe,EAAC,YAAY,CAAC,EAAE;YACvE,gBAAgB,EAAE,CAAC;SACtB;aAAM;YACH,GAAG,uBAAM,KAAK,KAAE,cAAc,gBAAA,EAAE,YAAY,cAAA,IAAG,CAAC;SACnD;IACL,CAAC;IACD,SAAS,SAAS,CAAC,MAAoB;QACnC,GAAG,uBAAM,KAAK,KAAE,MAAM,QAAA,IAAG,CAAC;IAC9B,CAAC;IACD,SAAS,gBAAgB;QACrB,GAAG,uBAAM,KAAK,KAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,IAAG,CAAC;IAC5D,CAAC;IACD,SAAS,WAAW;QAChB,GAAG,uBAAM,KAAK,KAAE,MAAM,EAAE,EAAE,IAAG,CAAC;IAClC,CAAC;IACD,SAAS,QAAQ;QACb,GAAG,CAAC,YAAY,CAAC,CAAC;IACtB,CAAC;IACD,SAAS,UAAU,CAAC,GAAW;QAC3B,IAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,OAAO,GAAG,KAAK,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrF,CAAC;IACD,6BAAY,KAAK,KAAE,cAAc,gBAAA,EAAE,SAAS,WAAA,EAAE,gBAAgB,kBAAA,EAAE,WAAW,aAAA,EAAE,QAAQ,UAAA,EAAE,UAAU,YAAA,IAAG;AACxG,CAAC;AAhCD,wCAgCC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flowerbi-react",
-    "version": "1.21.0",
+    "version": "3.0.0",
     "author": "Daniel Earwicker <dan@earwicker.com>",
     "license": "MIT",
     "description": "React helpers for FlowerBI",
@@ -9,22 +9,22 @@
     "dependencies": {
         "@types/json-stable-stringify": "^1.0.32",
         "@types/react": "^16.9.0",
-        "json-stable-stringify": "^1.0.1",
-        "flowerbi": "1.21.0"
+        "flowerbi": "3.0.0",
+        "json-stable-stringify": "^1.0.1"
     },
     "devDependencies": {
-        "prettier": "^2.0.5",
-        "react": "^16.13.1",
-        "typescript": "~3.8.3",
-        "typedoc": "^0.17.8"
+        "prettier": "^2.5.1",
+        "react": "^17.0.2",
+        "typedoc": "^0.22.11",
+        "typescript": "^4.5.5"
     },
     "peerDependencies": {
-        "react": "^16.13.1"
+        "react": "^16.13.1 || ^17.0.2"
     },
     "scripts": {
         "build": "tsc",
         "watch": "tsc -w",
-        "docs": "typedoc --mode file --out ../../../docs/typedoc/flowerbi-react src",
+        "docs": "typedoc --out ../../../docs/typedoc/flowerbi-react src",
         "prepare": "npm run build && npm run docs"
     }
 }

package/src/index.ts

@@ -1,3 +1,3 @@
 export * from "./FlowerBITable";
 export * from "./usePageFilters";
-export * from "./useQuery";
+export * from "./useFlowerBI";

package/src/{useQuery.ts → useFlowerBI.ts}

@@ -49,71 +49,60 @@ export type QueryDependency = {
  * results are used to build this query, so we wait for them before executing,
  * and optionally short-circuit to an empty result if the dependency is empty.
  */
-export function useQuery<S extends QuerySelect>(fetch: QueryFetch, query: Query<S>, dependencies?: QueryDependency[]): UseQueryResult<S> {
+export function useFlowerBI<S extends QuerySelect>(fetch: QueryFetch, query: Query<S>, dependencies?: QueryDependency[]): UseQueryResult<S> {
     const queryJson = jsonifyQuery(query);
 
     const [state, setState] = useState<UseQueryState>("init");
     const [result, setResult] = useState<QueryResultJson>({ records: [] });
 
-    const cache = useRef<{ timer?: number; queryString?: string }>({});
-
     useEffect(() => {
         let disposed = false; // discard stale results
 
-        if (cache.current.timer !== undefined) {
-            window.clearTimeout(cache.current.timer);
-        }
-
-        // de-bounce (later versions of React may do this for us)
-        cache.current.timer = window.setTimeout(() => {
-            if (dependencies?.length) {
-                // if any not ready, neither are we
-                if (dependencies.some(x => x.dependency.state !== "ready")) {
-                    if (state !== "init") {
-                        setState("refresh");
-                    }
-                    return;
-                }
-
-                // if any with option nonEmpty produced empty result, so do we
-                if (dependencies.filter(x => !!x.nonEmpty).some(x => !x.dependency.records.length)) {
-                    setState("ready");
-                    setResult({ records: [] });
-                    return;
+        if (dependencies?.length) {
+            // if any not ready, neither are we
+            if (dependencies.some(x => x.dependency.state !== "ready")) {
+                if (state !== "init") {
+                    setState("refresh");
                 }
+                return;
             }
 
-            const queryAsString = stableStringify(queryJson);
-            if (queryAsString === cache.current.queryString) {
-                // current state was produced from the same query, so assume its current
+            // if any with option nonEmpty produced empty result, so do we
+            if (dependencies.filter(x => !!x.nonEmpty).some(x => !x.dependency.records.length)) {
+                setState("ready");
+                setResult({ records: [] });
                 return;
             }
+        }
 
-            if (state !== "init") {
-                setState("refresh");
-            }
+        if (state !== "init") {
+            setState("refresh");
+        }
 
-            fetch(queryJson).then(
-                x => {
-                    if (!disposed) {
-                        cache.current.queryString = queryAsString;
-                        setState("ready");
-                        setResult(x);
-                    }
-                },
-                () => {
-                    if (!disposed) {
-                        cache.current.queryString = queryAsString;
-                        setState("error");
-                    }
+        fetch(queryJson).then(
+            x => {
+                if (!disposed) {
+                    setState("ready");
+                    setResult(x);
+                }
+            },
+            () => {
+                if (!disposed) {
+                    setState("error");
                 }
-            );
-        }, 100);
+            }
+        );
 
         return () => {
             disposed = true;
         };
-    }, [dependencies, fetch, queryJson, state]);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [fetch, stableStringify(queryJson)]);
 
     return { ...expandQueryResult(query.select, result), state };
 }
+
+/**
+ * Alias of useFlowerBI for backward compatibility.
+ */
+export const useQuery = useFlowerBI;

package/src/usePageFilters.ts

@@ -1,5 +1,6 @@
 import { useState } from "react";
 import { FilterJson } from "flowerbi";
+import stableStringify from "json-stable-stringify";
 
 export interface PageFiltersState {
     readonly global: FilterJson[];
@@ -25,7 +26,17 @@ const clearedState: PageFiltersState = {
 export function usePageFilters(): PageFilters {
     const [state, set] = useState<PageFiltersState>(clearedState);
     function setInteraction(interactionKey: string, interactions: FilterJson[]) {
-        set({ ...state, interactionKey, interactions });
+        console.log(interactionKey, state.interactionKey, state.interactionKey === interactionKey,
+            interactions, state.interactions,
+            stableStringify(state.interactions), stableStringify(interactions),
+            stableStringify(state.interactions) === stableStringify(interactions));
+
+        if (state.interactionKey === interactionKey &&
+            stableStringify(state.interactions) === stableStringify(interactions)) {
+            clearInteraction();
+        } else {
+            set({ ...state, interactionKey, interactions });
+        }
     }
     function setGlobal(global: FilterJson[]) {
         set({ ...state, global });

package/dist/useQuery.js

@@ -1,90 +0,0 @@
-"use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = require("react");
-var flowerbi_1 = require("flowerbi");
-var json_stable_stringify_1 = __importDefault(require("json-stable-stringify"));
-/**
- * A custom React hook that evaluates to the result of a
- * [Query](../flowerbi/interfaces/query.html), making it easy to perform a
- * query from within a component.
- *
- * The returned object has a strongly-typed `records` array, and optionally
- * a `totals` object. It has a `state` of type {@link UseQueryState} that
- * can be used to show a loading indicator.
- *
- * @param fetch The fetch function to use.
- * @param query The [Query](../flowerbi/interfaces/query.html) specification.
- * @param dependencies Optionally, a list of one or more other queries whose
- * results are used to build this query, so we wait for them before executing,
- * and optionally short-circuit to an empty result if the dependency is empty.
- */
-function useQuery(fetch, query, dependencies) {
-    var queryJson = flowerbi_1.jsonifyQuery(query);
-    var _a = react_1.useState("init"), state = _a[0], setState = _a[1];
-    var _b = react_1.useState({ records: [] }), result = _b[0], setResult = _b[1];
-    var cache = react_1.useRef({});
-    react_1.useEffect(function () {
-        var disposed = false; // discard stale results
-        if (cache.current.timer !== undefined) {
-            window.clearTimeout(cache.current.timer);
-        }
-        // de-bounce (later versions of React may do this for us)
-        cache.current.timer = window.setTimeout(function () {
-            if (dependencies === null || dependencies === void 0 ? void 0 : dependencies.length) {
-                // if any not ready, neither are we
-                if (dependencies.some(function (x) { return x.dependency.state !== "ready"; })) {
-                    if (state !== "init") {
-                        setState("refresh");
-                    }
-                    return;
-                }
-                // if any with option nonEmpty produced empty result, so do we
-                if (dependencies.filter(function (x) { return !!x.nonEmpty; }).some(function (x) { return !x.dependency.records.length; })) {
-                    setState("ready");
-                    setResult({ records: [] });
-                    return;
-                }
-            }
-            var queryAsString = json_stable_stringify_1.default(queryJson);
-            if (queryAsString === cache.current.queryString) {
-                // current state was produced from the same query, so assume its current
-                return;
-            }
-            if (state !== "init") {
-                setState("refresh");
-            }
-            fetch(queryJson).then(function (x) {
-                if (!disposed) {
-                    cache.current.queryString = queryAsString;
-                    setState("ready");
-                    setResult(x);
-                }
-            }, function () {
-                if (!disposed) {
-                    cache.current.queryString = queryAsString;
-                    setState("error");
-                }
-            });
-        }, 100);
-        return function () {
-            disposed = true;
-        };
-    }, [dependencies, fetch, queryJson, state]);
-    return __assign(__assign({}, flowerbi_1.expandQueryResult(query.select, result)), { state: state });
-}
-exports.useQuery = useQuery;
-//# sourceMappingURL=useQuery.js.map

package/dist/useQuery.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQuery.js","sourceRoot":"","sources":["../src/useQuery.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+BAAoD;AACpD,qCAAiI;AACjI,gFAAoD;AAkCpD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,QAAQ,CAAwB,KAAiB,EAAE,KAAe,EAAE,YAAgC;IAChH,IAAM,SAAS,GAAG,uBAAY,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAA,6BAAmD,EAAlD,aAAK,EAAE,gBAA2C,CAAC;IACpD,IAAA,sCAAgE,EAA/D,cAAM,EAAE,iBAAuD,CAAC;IAEvE,IAAM,KAAK,GAAG,cAAM,CAA2C,EAAE,CAAC,CAAC;IAEnE,iBAAS,CAAC;QACN,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,wBAAwB;QAE9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;YACnC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAC5C;QAED,yDAAyD;QACzD,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;YACpC,IAAI,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,MAAM,EAAE;gBACtB,mCAAmC;gBACnC,IAAI,YAAY,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,OAAO,EAA9B,CAA8B,CAAC,EAAE;oBACxD,IAAI,KAAK,KAAK,MAAM,EAAE;wBAClB,QAAQ,CAAC,SAAS,CAAC,CAAC;qBACvB;oBACD,OAAO;iBACV;gBAED,8DAA8D;gBAC9D,IAAI,YAAY,CAAC,MAAM,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAZ,CAAY,CAAC,CAAC,IAAI,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAA5B,CAA4B,CAAC,EAAE;oBAChF,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAClB,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC3B,OAAO;iBACV;aACJ;YAED,IAAM,aAAa,GAAG,+BAAe,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,aAAa,KAAK,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;gBAC7C,wEAAwE;gBACxE,OAAO;aACV;YAED,IAAI,KAAK,KAAK,MAAM,EAAE;gBAClB,QAAQ,CAAC,SAAS,CAAC,CAAC;aACvB;YAED,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CACjB,UAAA,CAAC;gBACG,IAAI,CAAC,QAAQ,EAAE;oBACX,KAAK,CAAC,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC;oBAC1C,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAClB,SAAS,CAAC,CAAC,CAAC,CAAC;iBAChB;YACL,CAAC,EACD;gBACI,IAAI,CAAC,QAAQ,EAAE;oBACX,KAAK,CAAC,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC;oBAC1C,QAAQ,CAAC,OAAO,CAAC,CAAC;iBACrB;YACL,CAAC,CACJ,CAAC;QACN,CAAC,EAAE,GAAG,CAAC,CAAC;QAER,OAAO;YACH,QAAQ,GAAG,IAAI,CAAC;QACpB,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAE5C,6BAAY,4BAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAE,KAAK,OAAA,IAAG;AACjE,CAAC;AAnED,4BAmEC"}