@qoretechnologies/reqore 0.78.6-pr.715.gdfefa70 → 0.78.7-pr.717.gae33bdc

package/dist/helpers/surface.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCardHoverFill = exports.getCardMarkColor = exports.getDrawnEffectTextColor = exports.getUnpaintedSurface = void 0;
+var polished_1 = require("polished");
+var colors_1 = require("./colors");
+var Effect_1 = require("../components/Effect");
+/**
+ * `color` as the theme resolves it (a theme color, a shade of one, a hex), or undefined where it cannot: a CSS color
+ * name, a variable, a four-digit hex. Never throws: a color the theme cannot read is no reason to unmount the
+ * component that was given it.
+ */
+var resolveColor = function (theme, color) {
+    if (!color) {
+        return undefined;
+    }
+    try {
+        var resolved = (0, colors_1.getColorFromMaybeString)(theme, color);
+        return resolved && (0, colors_1.isValidSixCharHex)(resolved) ? resolved : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+/**
+ * What an element that paints nothing (`unpainted`: transparent, or drawn at no opacity) is drawn on. The surface a
+ * component around it hands down (`useReqoreSurface`) when one does; with none around it, the main of the
+ * `customTheme` it was given - how a consumer says what it painted under it (a band, a card of its own) - drawn over
+ * the page when it is translucent; undefined otherwise (the theme's surface, `getThemeSurface`). An intent is not a
+ * surface: an element in an intent with nothing around it is drawn on the page.
+ */
+var getUnpaintedSurface = function (theme, customTheme, surface, unpainted) {
+    if (surface || !unpainted) {
+        return surface;
+    }
+    var own = resolveColor(theme, customTheme === null || customTheme === void 0 ? void 0 : customTheme.main);
+    return own ? (0, colors_1.getDrawnColor)(own, (0, colors_1.getThemeSurface)(theme)) : undefined;
+};
+exports.getUnpaintedSurface = getUnpaintedSurface;
+/**
+ * The color a text effect draws `color` in on `backgrounds` (`getEffectTextColor`: a theme color in the shade of it
+ * that reads there, any other as given), or undefined where it draws none - a CSS color name, a variable, a
+ * four-digit hex, which its text does not take either: it keeps the color it inherits. Never throws.
+ */
+var getDrawnEffectTextColor = function (theme, color, backgrounds) {
+    if (!resolveColor(theme, color)) {
+        return undefined;
+    }
+    try {
+        var drawn = (0, Effect_1.getEffectTextColor)(theme, color, undefined, backgrounds);
+        return drawn && (0, colors_1.isValidSixCharHex)(drawn) ? drawn : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+exports.getDrawnEffectTextColor = getDrawnEffectTextColor;
+/**
+ * The color a card's own mark (an entity row's icon, a callout's icon, a testimonial's avatar and quote mark) is
+ * drawn in on `backgrounds`: its `own` color, moved to a shade that stands out by 3:1 there when it is a theme's;
+ * else its intent's shade that does; else the card's `text`.
+ */
+var getCardMarkColor = function (theme, backgrounds, text, own, intent) {
+    var _a;
+    if (own) {
+        return ((_a = (0, colors_1.getReadableIconLook)(theme, backgrounds, text, 1, own).color) !== null && _a !== void 0 ? _a : own);
+    }
+    if (intent) {
+        return (0, colors_1.getReadableIntentColor)(theme, intent, colors_1.READABLE_ICON_CONTRAST, backgrounds);
+    }
+    return text;
+};
+exports.getCardMarkColor = getCardMarkColor;
+/**
+ * The fill a clickable card paints while it is hovered: a wash of its intent (4% when it paints nothing at rest,
+ * else 10%), or else of the theme a step lighter (8% when it paints nothing at rest), or `opaque`, the card's own.
+ * What its styled rule paints, and what what it holds is read on as well as on its resting fill: a card's text and
+ * its fainter text were read on the resting fill only, and a hovered row's metadata fell to 4.2:1 (qorus#646).
+ */
+var getCardHoverFill = function (theme, intent, transparent, opaque) {
+    return intent
+        ? (0, polished_1.rgba)(theme.intents[intent], transparent ? 0.04 : 0.1)
+        : transparent
+            ? (0, polished_1.rgba)((0, colors_1.changeLightness)((0, colors_1.getMainBackgroundColor)(theme), 0.08), 0.08)
+            : opaque;
+};
+exports.getCardHoverFill = getCardHoverFill;
+//# sourceMappingURL=surface.js.map

package/dist/helpers/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/helpers/surface.ts"],"names":[],"mappings":";;;AAAA,qCAAgC;AAEhC,mCAWkB;AAClB,+CAA+F;AAE/F;;;;GAIG;AACH,IAAM,YAAY,GAAG,UACnB,KAAmB,EACnB,KAAqC;IAErC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,IAAM,QAAQ,GAAG,IAAA,gCAAuB,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAEvD,OAAO,QAAQ,IAAI,IAAA,0BAAiB,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,IAAM,mBAAmB,GAAG,UACjC,KAAmB,EACnB,WAA2C,EAC3C,OAAmC,EACnC,SAAkB;IAElB,IAAI,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,IAAI,CAAC,CAAC;IAEnD,OAAO,GAAG,CAAC,CAAC,CAAC,IAAA,sBAAa,EAAC,GAAG,EAAE,IAAA,wBAAe,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC,CAAC;AAbW,QAAA,mBAAmB,uBAa9B;AAEF;;;;GAIG;AACI,IAAM,uBAAuB,GAAG,UACrC,KAAmB,EACnB,KAAqC,EACrC,WAA8B;IAE9B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,IAAM,KAAK,GAAG,IAAA,2BAAkB,EAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAEvE,OAAO,KAAK,IAAI,IAAA,0BAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,uBAAuB,2BAgBlC;AAEF;;;;GAIG;AACI,IAAM,gBAAgB,GAAG,UAC9B,KAAmB,EACnB,WAA8B,EAC9B,IAAqB,EACrB,GAAwB,EACxB,MAAsB;;IAEtB,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,MAAA,IAAA,4BAAmB,EAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,mCAAI,GAAG,CAAuB,CAAC;IACpG,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAA,+BAAsB,EAAC,KAAK,EAAE,MAAM,EAAE,+BAAsB,EAAE,WAAW,CAAuB,CAAC;IAC1G,CAAC;IACD,OAAO,IAA0B,CAAC;AACpC,CAAC,CAAC;AAdW,QAAA,gBAAgB,oBAc3B;AAEF;;;;;GAKG;AACI,IAAM,gBAAgB,GAAG,UAC9B,KAAmB,EACnB,MAAiC,EACjC,WAAgC,EAChC,MAAc;IAEd,OAAA,MAAM;QACJ,CAAC,CAAC,IAAA,eAAI,EAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAW,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACjE,CAAC,CAAC,WAAW;YACX,CAAC,CAAC,IAAA,eAAI,EAAC,IAAA,wBAAe,EAAC,IAAA,+BAAsB,EAAC,KAAK,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;YAClE,CAAC,CAAC,MAAM;AAJZ,CAIY,CAAC;AAVF,QAAA,gBAAgB,oBAUd"}

package/dist/hooks/useAutoFocus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAutoFocus.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoFocus.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,YAAY,GACvB,SAAS,gBAAgB,GAAG,mBAAmB,EAC/C,QAAQ,qBAAqB,EAC7B,WAAW,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,SA4FhC,CAAC"}
+{"version":3,"file":"useAutoFocus.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoFocus.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,YAAY,GACvB,SAAS,gBAAgB,GAAG,mBAAmB,EAC/C,QAAQ,qBAAqB,EAC7B,WAAW,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,SAsGhC,CAAC"}

package/dist/hooks/useAutoFocus.js

@@ -6,6 +6,9 @@ var react_use_1 = require("react-use");
 var useAutoFocus = function (element, rules, onChange) {
     var isInViewport = (0, react_1.useRef)(false);
     var observer = (0, react_1.useRef)(null);
+    /** The element auto-focus has already settled on, so a changing reference to the SAME node is not taken
+     *  for a new one — see the effect below. */
+    var settledElement = (0, react_1.useRef)(null);
     var focus = (0, react_1.useCallback)(function () {
         if (!rules.viewportOnly || isInViewport.current) {
             if (rules.clearOnFocus) {
@@ -36,7 +39,14 @@ var useAutoFocus = function (element, rules, onChange) {
         }
     }, [rules === null || rules === void 0 ? void 0 : rules.shortcut, focus]);
     (0, react_use_1.useUpdateEffect)(function () {
-        if (element && rules) {
+        // Only when a genuinely new element appears — the field opening, or a different element taking its
+        // place. Not every time the element reference changes: a controlled input hands React a new ref callback
+        // on each render, so the SAME node arrives under a changing identity on every keystroke. Re-running this
+        // re-applied focus and moved the selection to the end mid-edit, which dropped a character being typed
+        // (qorus#646). React reconciles the same node, so once settled its identity here is stable across those
+        // re-renders.
+        if (element && rules && settledElement.current !== element) {
+            settledElement.current = element;
             if (rules.viewportOnly) {
                 observer.current = new IntersectionObserver(function (entries) {
                     entries.forEach(function (entry) {

package/dist/hooks/useAutoFocus.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAutoFocus.js","sourceRoot":"","sources":["../../src/hooks/useAutoFocus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useAutoFocus.js","sourceRoot":"","sources":["../../src/hooks/useAutoFocus.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useCloneThroughFragments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCloneThroughFragments.d.ts","sourceRoot":"","sources":["../../src/hooks/useCloneThroughFragments.ts"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAEpD,eAAO,MAAM,wBAAwB,GACnC,aAAa,CACX,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,KAClC,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,GAAG,EAAE;sBAIyB,KAAK,CAAC,SAAS,KAAG,KAAK,CAAC,SAAS;CA0BvE,CAAC"}
+{"version":3,"file":"useCloneThroughFragments.d.ts","sourceRoot":"","sources":["../../src/hooks/useCloneThroughFragments.ts"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAEpD,eAAO,MAAM,wBAAwB,GACnC,aAAa,CACX,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,KAClC,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,GAAG,EAAE;sBAEyB,KAAK,CAAC,SAAS,KAAG,KAAK,CAAC,SAAS;CAsDvE,CAAC"}

package/dist/hooks/useCloneThroughFragments.js

@@ -1,4 +1,15 @@
 "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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -36,26 +47,48 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCloneThroughFragments = void 0;
 var react_1 = __importStar(require("react"));
 var useCloneThroughFragments = function (propsMapper, deps) {
-    var realIndex = 0;
     var clone = (0, react_1.useCallback)(function (children) {
-        return react_1.default.Children.map(children, function (child, reactIndex) {
-            if (child && react_1.default.isValidElement(child)) {
-                if (child.type === react_1.default.Fragment) {
-                    return clone(child.props.children);
+        /* Counted per call, from the first child: the clone is kept between renders (`deps`), and a count kept with
+           it went on from where the last render left it - a group re-rendering by itself numbered its first child
+           the fourth. */
+        var realIndex = 0;
+        var cloneLevel = function (nodes) {
+            /* The keys given at this level of the children. A child keeps its own key, so React keeps it
+               (and its state) when another is added before it; a key given again is made unique (`#1`,
+               `#2`, ...), as the place a control group joined to every key used to make it. Children keyed
+               by what they say (a label, a name) can repeat it, and two children with one key are one to
+               React: it warns, and on an update drops or repeats one of them. A fragment's children are
+               keyed under the fragment, so each level counts its own. */
+            var given = new Map();
+            return react_1.default.Children.map(nodes, function (child, reactIndex) {
+                var _a;
+                if (child && react_1.default.isValidElement(child)) {
+                    if (child.type === react_1.default.Fragment) {
+                        return cloneLevel(child.props.children);
+                    }
+                    var props = propsMapper(child.props, reactIndex, realIndex, child.type);
+                    /*
+                     * Because of the way React.Children.map works, we have to
+                     * manually decrement the index for every child that is `null`
+                     * because react maps through null children and returns them in `Count`
+                     * We filter these children out in the `realChildCount` variable,
+                     * but the index is still incremented
+                     * */
+                    realIndex = realIndex + 1;
+                    // a key the mapper set (a control group's `reactKey`) is the caller's to keep unique
+                    if ((props === null || props === void 0 ? void 0 : props.key) === undefined && child.key !== null) {
+                        var times = (_a = given.get(child.key)) !== null && _a !== void 0 ? _a : 0;
+                        given.set(child.key, times + 1);
+                        if (times > 0) {
+                            return react_1.default.cloneElement(child, __assign(__assign({}, props), { key: "".concat(child.key, "#").concat(times) }));
+                        }
+                    }
+                    return react_1.default.cloneElement(child, props);
                 }
-                var props = propsMapper(child.props, reactIndex, realIndex, child.type);
-                /*
-                 * Because of the way React.Children.map works, we have to
-                 * manually decrement the index for every child that is `null`
-                 * because react maps through null children and returns them in `Count`
-                 * We filter these children out in the `realChildCount` variable,
-                 * but the index is still incremented
-                 * */
-                realIndex = realIndex + 1;
-                return react_1.default.cloneElement(child, props);
-            }
-            return child;
-        });
+                return child;
+            });
+        };
+        return cloneLevel(children);
     }, deps);
     return (0, react_1.useMemo)(function () { return ({ clone: clone }); }, [clone]);
 };

package/dist/hooks/useCloneThroughFragments.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCloneThroughFragments.js","sourceRoot":"","sources":["../../src/hooks/useCloneThroughFragments.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAoD;AAE7C,IAAM,wBAAwB,GAAG,UACtC,WAKiC,EACjC,IAAY;IAEZ,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,IAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,UAAC,QAAyB;QAClD,OAAO,eAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAC,KAAK,EAAE,UAAU;YACpD,IAAI,KAAK,IAAI,eAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAK,CAAC,QAAQ,EAAE,CAAC;oBAClC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACrC,CAAC;gBAED,IAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE1E;;;;;;qBAMK;gBACL,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;gBAE1B,OAAO,eAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,OAAO,IAAA,eAAO,EAAC,cAAM,OAAA,CAAC,EAAE,KAAK,OAAA,EAAE,CAAC,EAAX,CAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC;AArCW,QAAA,wBAAwB,4BAqCnC"}
+{"version":3,"file":"useCloneThroughFragments.js","sourceRoot":"","sources":["../../src/hooks/useCloneThroughFragments.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAoD;AAE7C,IAAM,wBAAwB,GAAG,UACtC,WAKiC,EACjC,IAAY;IAEZ,IAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,UAAC,QAAyB;QAClD;;yBAEiB;QACjB,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,IAAM,UAAU,GAAG,UAAC,KAAsB;YACxC;;;;;yEAK6D;YAC7D,IAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;YAE3C,OAAO,eAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,UAAC,KAAK,EAAE,UAAU;;gBACjD,IAAI,KAAK,IAAI,eAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAK,CAAC,QAAQ,EAAE,CAAC;wBAClC,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBAC1C,CAAC;oBAED,IAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBAE1E;;;;;;yBAMK;oBACL,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;oBAE1B,qFAAqF;oBACrF,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,GAAG,MAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;wBACnD,IAAM,KAAK,GAAG,MAAA,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mCAAI,CAAC,CAAC;wBAExC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;wBAEhC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;4BACd,OAAO,eAAK,CAAC,YAAY,CAAC,KAAK,wBAAO,KAAK,KAAE,GAAG,EAAE,UAAG,KAAK,CAAC,GAAG,cAAI,KAAK,CAAE,IAAG,CAAC;wBAC/E,CAAC;oBACH,CAAC;oBAED,OAAO,eAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC1C,CAAC;gBAED,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,OAAO,IAAA,eAAO,EAAC,cAAM,OAAA,CAAC,EAAE,KAAK,OAAA,EAAE,CAAC,EAAX,CAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC;AA/DW,QAAA,wBAAwB,4BA+DnC"}

package/dist/hooks/useCombinedRefs.d.ts

@@ -1,12 +1,22 @@
 import React from 'react';
 /**
- * It takes a list of refs and returns a single ref that can be used to reference the same underlying
- * DOM element
- * @param refs - An array of refs to combine.
- * @returns A ref object.
+ * One element, handed to several refs: the component's own (`targetRef`, to read) and those it is given
+ * (a forwarded ref, a ref of its parent's).
+ *
+ * `setRef` is the ref the element is drawn with. React calls it in the commit that attaches the element, so
+ * every ref has the element before the browser paints it. They used to be handed it in an effect, after the
+ * paint: a popover drawn around a button learnt of the button only then, and armed its click listener in
+ * the render after that - a click that landed on the button as soon as it was drawn opened nothing, and
+ * nothing on the page said when it would (qorus#646: the Qorus IDE's template selector kept a sleep for it).
+ * The effect also ran after every render, since the list of refs is new each time.
+ *
+ * A component that draws the element through a ref callback of its own calls `setRef` from it.
+ *
+ * @param refs - The refs to hand the element to, besides `targetRef`.
+ * @returns `targetRef`, holding the element, and `setRef`, the ref to draw it with.
  */
-export declare function useCombinedRefs<T = any>(...refs: any[]): {
-    _innerRef: any;
+export declare function useCombinedRefs<T = any>(...refs: Array<React.Ref<T> | undefined | null>): {
     targetRef: React.MutableRefObject<T>;
+    setRef: (node: T | null) => void;
 };
 //# sourceMappingURL=useCombinedRefs.d.ts.map

package/dist/hooks/useCombinedRefs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCombinedRefs.d.ts","sourceRoot":"","sources":["../../src/hooks/useCombinedRefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,IAAI,OAAA;;;EAiB/C"}
+{"version":3,"file":"useCombinedRefs.d.ts","sourceRoot":"","sources":["../../src/hooks/useCombinedRefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAe1B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;;mBAI7E,CAAC,GAAG,IAAI;EAUlB"}

package/dist/hooks/useCombinedRefs.js

@@ -1,44 +1,51 @@
 "use strict";
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCombinedRefs = useCombinedRefs;
 var react_1 = __importDefault(require("react"));
+/** Hands `node` to one ref: a callback is called with it, an object holds it. */
+var assignRef = function (ref, node) {
+    if (!ref) {
+        return;
+    }
+    if (typeof ref === 'function') {
+        ref(node);
+    }
+    else {
+        ref.current = node;
+    }
+};
 /**
- * It takes a list of refs and returns a single ref that can be used to reference the same underlying
- * DOM element
- * @param refs - An array of refs to combine.
- * @returns A ref object.
+ * One element, handed to several refs: the component's own (`targetRef`, to read) and those it is given
+ * (a forwarded ref, a ref of its parent's).
+ *
+ * `setRef` is the ref the element is drawn with. React calls it in the commit that attaches the element, so
+ * every ref has the element before the browser paints it. They used to be handed it in an effect, after the
+ * paint: a popover drawn around a button learnt of the button only then, and armed its click listener in
+ * the render after that - a click that landed on the button as soon as it was drawn opened nothing, and
+ * nothing on the page said when it would (qorus#646: the Qorus IDE's template selector kept a sleep for it).
+ * The effect also ran after every render, since the list of refs is new each time.
+ *
+ * A component that draws the element through a ref callback of its own calls `setRef` from it.
+ *
+ * @param refs - The refs to hand the element to, besides `targetRef`.
+ * @returns `targetRef`, holding the element, and `setRef`, the ref to draw it with.
  */
 function useCombinedRefs() {
     var refs = [];
     for (var _i = 0; _i < arguments.length; _i++) {
         refs[_i] = arguments[_i];
     }
-    var _a = react_1.default.useState(null), _innerRef = _a[0], setInnerRef = _a[1];
     var targetRef = react_1.default.useRef();
-    react_1.default.useEffect(function () {
-        __spreadArray(__spreadArray([], refs, true), [setInnerRef], false).forEach(function (ref) {
-            if (!ref)
-                return;
-            if (typeof ref === 'function') {
-                ref(targetRef.current);
-            }
-            else {
-                ref.current = targetRef.current;
-            }
-        });
-    }, [refs]);
-    return { _innerRef: _innerRef, targetRef: targetRef };
+    var setRef = react_1.default.useCallback(function (node) {
+        targetRef.current = node !== null && node !== void 0 ? node : undefined;
+        refs.forEach(function (ref) { return assignRef(ref, node); });
+    }, 
+    // A new ref given is handed the element the way React hands it to a new ref callback: this callback
+    // changes with it, so React calls the old one with null and this one with the element.
+    refs);
+    return { targetRef: targetRef, setRef: setRef };
 }
 //# sourceMappingURL=useCombinedRefs.js.map

package/dist/hooks/useCombinedRefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCombinedRefs.js","sourceRoot":"","sources":["../../src/hooks/useCombinedRefs.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAQA,0CAiBC;AAzBD,gDAA0B;AAE1B;;;;;GAKG;AACH,SAAgB,eAAe;IAAU,cAAO;SAAP,UAAO,EAAP,qBAAO,EAAP,IAAO;QAAP,yBAAO;;IACxC,IAAA,KAA2B,eAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAA9C,SAAS,QAAA,EAAE,WAAW,QAAwB,CAAC;IACtD,IAAM,SAAS,GAAG,eAAK,CAAC,MAAM,EAAK,CAAC;IAEpC,eAAK,CAAC,SAAS,CAAC;QACd,gCAAI,IAAI,UAAE,WAAW,UAAE,OAAO,CAAC,UAAC,GAAG;YACjC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEjB,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC9B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,EAAE,SAAS,WAAA,EAAE,SAAS,WAAA,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"useCombinedRefs.js","sourceRoot":"","sources":["../../src/hooks/useCombinedRefs.ts"],"names":[],"mappings":";;;;;AA+BA,0CAcC;AA7CD,gDAA0B;AAE1B,iFAAiF;AACjF,IAAM,SAAS,GAAG,UAAI,GAAoC,EAAE,IAAc;IACxE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,CAAC;IACZ,CAAC;SAAM,CAAC;QACL,GAAwC,CAAC,OAAO,GAAG,IAAI,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,eAAe;IAAU,cAA+C;SAA/C,UAA+C,EAA/C,qBAA+C,EAA/C,IAA+C;QAA/C,yBAA+C;;IACtF,IAAM,SAAS,GAAG,eAAK,CAAC,MAAM,EAAK,CAAC;IAEpC,IAAM,MAAM,GAAG,eAAK,CAAC,WAAW,CAC9B,UAAC,IAAc;QACb,SAAS,CAAC,OAAO,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,SAAS,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,UAAC,GAAG,IAAK,OAAA,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,EAApB,CAAoB,CAAC,CAAC;IAC9C,CAAC;IACD,oGAAoG;IACpG,uFAAuF;IACvF,IAAI,CACL,CAAC;IAEF,OAAO,EAAE,SAAS,WAAA,EAAE,MAAM,QAAA,EAAE,CAAC;AAC/B,CAAC"}

package/dist/hooks/useDragToScroll.d.ts

@@ -0,0 +1,58 @@
+import { RefObject } from 'react';
+/**
+ * How far the pointer must travel before a press becomes a drag.
+ *
+ * Zero would make every click a one-pixel drag and swallow it; too large and the
+ * row feels stuck before it moves. Four pixels is the usual hysteresis for
+ * distinguishing a click from a drag.
+ */
+export declare const DRAG_TO_SCROLL_THRESHOLD = 4;
+/**
+ * Elements a drag must never start on.
+ *
+ * Deliberately NOT "anything interactive". The surfaces this is built for are made
+ * OF interactive things - a rail of clickable KPI tiles, a table header of sort
+ * buttons - so excluding buttons would leave nowhere to grab and the feature would
+ * do nothing. Their clicks are protected instead by suppressing the click that
+ * follows a real drag, which is what makes press-and-release still activate a
+ * tile while press-and-pull scrolls past it.
+ *
+ * What IS excluded is text entry, where a press-and-move already means
+ * "select within this value" and there is no other way to ask for it, and anything
+ * marked `reqore-no-drag-scroll`: a grab handle of its own (a column's resize handle),
+ * where a press-and-move already means something else.
+ */
+export declare const NON_DRAGGABLE = "input, textarea, select, [contenteditable=\"\"], [contenteditable=\"true\"], .reqore-no-drag-scroll";
+export interface IUseDragToScrollOptions {
+    /** What scrolls sideways. */
+    scrollRef: RefObject<HTMLElement>;
+    /**
+     * Where the gesture is taken, when that is not the scroller itself: a table's
+     * header, which is scrolled with its body but is not a scroller of its own.
+     */
+    handleRef?: RefObject<HTMLElement>;
+    /** Mouse and pen: press and pull sideways to scroll. */
+    mouse?: boolean;
+    /**
+     * Touch: a sideways swipe on the handle scrolls the scroller. Only for a handle
+     * the browser cannot pan by itself (it does not overflow-scroll); on a real
+     * scroller touch already pans natively, and taking it over would replace that.
+     * The handle's own CSS must leave sideways panning to the page script
+     * (`touch-action: pan-y`), or the browser cancels the pointer before it moves.
+     */
+    touch?: boolean;
+    /** Set on the handle while a drag is engaged. */
+    draggingClass?: string;
+}
+/**
+ * Press and pull a sideways-scrolling surface to scroll it.
+ *
+ * `ReqoreTable`'s (`dragToScroll`, and its header's touch swipes). It binds to the
+ * elements themselves, not through handlers spread in render, because a table's body
+ * appears after mount and its header scrolls a body that is another element. The other
+ * drags in the library - a sheet, a modal, a toast, a tier stack, `ReqoreFadeScroller`'s
+ * `dragToScroll` - share `usePointerDrag`; a fix to the gesture belongs in both (a
+ * finger's implicit capture, for one).
+ */
+export declare const useDragToScroll: ({ scrollRef, handleRef, mouse, touch, draggingClass, }: IUseDragToScrollOptions) => void;
+//# sourceMappingURL=useDragToScroll.d.ts.map

package/dist/hooks/useDragToScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragToScroll.d.ts","sourceRoot":"","sources":["../../src/hooks/useDragToScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,OAAO,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,wGACyE,CAAC;AAEpG,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACnC,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,wDAM7B,uBAAuB,SA+CzB,CAAC"}