@qoretechnologies/reqore 0.78.5-pr.708.gbe112f0 → 0.78.6-pr.715.gdfefa70

package/dist/helpers/styled.d.ts

@@ -1,5 +1,4 @@
-import type { ComponentType, JSX } from 'react';
-import baseStyled from 'styled-components';
+import type { ComponentType } from 'react';
 /**
  * The default prop validator styled-components hands to `shouldForwardProp`. It answers
  * "is this a real HTML attribute?" — it knows nothing about the element being rendered.
@@ -12,17 +11,32 @@ export type TReqoreStyledPropValidator = (prop: string | number | symbol) => boo
  */
 export type TReqoreStyledTarget = string | ComponentType<any>;
 /**
- * Reqore prop names that are ALSO an HTML attribute — of some elements. `isPropValid`, which
- * styled-components uses to filter a DOM tag's props, only asks whether a name is an attribute
- * anywhere, so `size='normal'` (a Reqore size) reached every `div` and `span` it was handed to as
- * `size="normal"`, a checkbox's `checked` reached its `div`, a table cell's `selected` and
- * `disabled` theirs, and so on. Each name maps to the elements it is an attribute of; on any
- * other HTML element it is a styling prop and stays back. A name with no elements is not an
- * attribute of any HTML element (only of SVG ones, or of nothing current).
+ * Builds a `shouldForwardProp` predicate for `styled(...).withConfig({ ... })` that keeps the
+ * named props out of the rendered element while leaving every other prop alone.
+ *
+ * Reqore layout flags (`fill`, `wrap`, ...) are meaningful to a parent — a `ReqoreControlGroup`
+ * propagates `fill` through polymorphic children, a `ReqoreTable` threads `wrap` into rows and
+ * cells — but they are not valid HTML attributes. Without this filter React renders them as
+ * boolean attributes and logs a "received `true` for a non-boolean attribute" warning.
+ *
+ * IMPORTANT — why the target type is checked. Supplying `shouldForwardProp` *replaces*
+ * styled-components' built-in rule outright; it does not layer on top of it. That built-in rule
+ * is `isTargetTag ? isPropValid(prop) : true` — a DOM tag only receives real HTML attributes,
+ * but a **component** target receives everything, because a component's props are its own API
+ * and `isPropValid` knows nothing about them. Chaining `defaultValidatorFn` unconditionally
+ * therefore strips a component's entire prop surface: `styled(ReqoreIcon)` silently lost
+ * `icon` / `wrapperElement` / `wrapperSize` (the input clear button rendered as an empty span),
+ * `styled(StyledEffect) as={Resizable}` lost re-resizable's `enable` / size / handle config, and
+ * `ReqoreTextarea as={Editable}` lost Slate's `renderElement` / `renderLeaf` / `decorate`. Each
+ * was previously patched with a bespoke per-call-site allow-list; mirroring the built-in rule
+ * here fixes all of them at the source, so `styled(SomeComponent)` keeps working like plain
+ * styled-components while the explicitly-omitted props still never reach the DOM.
+ *
+ * @example
+ * const StyledPanel = styled(StyledEffect).withConfig({
+ *   shouldForwardProp: omitStyleProps('fill'),
+ * })<IStyledPanel>`...`;
  */
-export declare const REQORE_AMBIGUOUS_PROP_ELEMENTS: Readonly<Record<string, readonly (keyof JSX.IntrinsicElements)[]>>;
-/** Whether `prop` is an attribute of the element `tag`, as far as Reqore's names go. */
-export declare const isReqoreElementAttribute: (prop: string | number | symbol, tag: string) => boolean;
 export declare const omitStyleProps: (...propsToOmit: string[]) => (prop: string | number | symbol, defaultValidatorFn: TReqoreStyledPropValidator, elementToBeCreated?: TReqoreStyledTarget) => boolean;
 /**
  * The props `ReqoreControlGroup` clones onto every child that is a component (see the group's
@@ -32,31 +46,4 @@ export declare const omitStyleProps: (...propsToOmit: string[]) => (prop: string
  * them: `shouldForwardProp: omitStyleProps(...REQORE_CONTROL_GROUP_CHILD_PROPS)`.
  */
 export declare const REQORE_CONTROL_GROUP_CHILD_PROPS: string[];
-/**
- * The props of a styled component's prop interface `TProps` that only style it: every key that
- * is not one of `TTargetProps` — the attributes and props of what the component renders.
- *
- * `as`, `forwardedAs` and transient (`$`-prefixed) props are left out: styled-components consumes
- * those itself and never forwards them.
- */
-export type TReqoreStylePropKeys<TProps, TTargetProps> = Exclude<Extract<keyof TProps, string>, keyof TTargetProps | 'as' | 'forwardedAs' | `$${string}`>;
-/**
- * Lists a component's styling props for `omitStyleProps`, from a record the compiler checks
- * against the component's prop interface.
- *
- * A hand-written omit list goes stale: a prop added to the interface later reaches the rendered
- * element until someone remembers the list (ReqoreButton rendered `as` a router link handed its
- * `fluid`, `compact`, `maxWidth`, ... to the link, which wrote them onto its `<a>`; a resizable,
- * transparent ReqorePanel handed re-resizable `transparent`). Typed as
- * `Record<TReqoreStylePropKeys<...>, true>`, the record must name every such prop and nothing
- * else, so a new prop that is not added fails the build instead of leaking.
- *
- * @example
- * const BUTTON_STYLE_PROPS = listReqoreStyleProps<
- *   TReqoreStylePropKeys<IReqoreButtonStyle, React.ButtonHTMLAttributes<HTMLButtonElement>>
- * >({ fluid: true, compact: true, ... });
- */
-export declare const listReqoreStyleProps: <TKeys extends string>(props: Record<TKeys, true>) => TKeys[];
-declare const reqoreStyled: typeof baseStyled;
-export default reqoreStyled;
 //# sourceMappingURL=styled.d.ts.map

package/dist/helpers/styled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styled.d.ts","sourceRoot":"","sources":["../../src/helpers/styled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AA0D9D;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CACnD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,CA4CzD,CAAC;AAaF,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,MAAM,KAAG,OAQtF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,GAAG,aAAa,MAAM,EAAE,MAInD,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,EAC9B,oBAAoB,0BAA0B,EAC9C,qBAAqB,mBAAmB,KACvC,OAqBJ,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,UA0B5C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,MAAM,EAAE,YAAY,IAAI,OAAO,CAC9D,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,EAC7B,MAAM,YAAY,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI,MAAM,EAAE,CACzD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,MAAM,EAAE,OAAO,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAG,KAAK,EAC9D,CAAC;AAgBhC,QAAA,MAAM,YAAY,EAGZ,OAAO,UAAU,CAAC;AAExB,eAAe,YAAY,CAAC"}
+{"version":3,"file":"styled.d.ts","sourceRoot":"","sources":["../../src/helpers/styled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,aAAa,MAAM,EAAE,MAInD,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,EAC9B,oBAAoB,0BAA0B,EAC9C,qBAAqB,mBAAmB,KACvC,OAQJ,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,UA0B5C,CAAC"}

package/dist/helpers/styled.js

@@ -1,10 +1,6 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listReqoreStyleProps = exports.REQORE_CONTROL_GROUP_CHILD_PROPS = exports.omitStyleProps = exports.isReqoreElementAttribute = exports.REQORE_AMBIGUOUS_PROP_ELEMENTS = void 0;
-var styled_components_1 = __importDefault(require("styled-components"));
+exports.REQORE_CONTROL_GROUP_CHILD_PROPS = exports.omitStyleProps = void 0;
 /**
  * Builds a `shouldForwardProp` predicate for `styled(...).withConfig({ ... })` that keeps the
  * named props out of the rendered element while leaving every other prop alone.
@@ -32,106 +28,6 @@ var styled_components_1 = __importDefault(require("styled-components"));
  *   shouldForwardProp: omitStyleProps('fill'),
  * })<IStyledPanel>`...`;
  */
-/** The SVG elements: their presentation attributes (`fill`, `opacity`, `width`, ...) are real. */
-var SVG_TAGS = new Set([
-    'svg',
-    'g',
-    'path',
-    'circle',
-    'ellipse',
-    'line',
-    'polyline',
-    'polygon',
-    'rect',
-    'text',
-    'tspan',
-    'textPath',
-    'defs',
-    'symbol',
-    'use',
-    'image',
-    'marker',
-    'mask',
-    'pattern',
-    'clipPath',
-    'linearGradient',
-    'radialGradient',
-    'stop',
-    'foreignObject',
-    'filter',
-]);
-/**
- * Reqore prop names that are ALSO an HTML attribute — of some elements. `isPropValid`, which
- * styled-components uses to filter a DOM tag's props, only asks whether a name is an attribute
- * anywhere, so `size='normal'` (a Reqore size) reached every `div` and `span` it was handed to as
- * `size="normal"`, a checkbox's `checked` reached its `div`, a table cell's `selected` and
- * `disabled` theirs, and so on. Each name maps to the elements it is an attribute of; on any
- * other HTML element it is a styling prop and stays back. A name with no elements is not an
- * attribute of any HTML element (only of SVG ones, or of nothing current).
- */
-exports.REQORE_AMBIGUOUS_PROP_ELEMENTS = {
-    size: ['input', 'select'],
-    width: ['img', 'canvas', 'video', 'iframe', 'input', 'embed', 'object', 'col', 'colgroup'],
-    height: ['img', 'canvas', 'video', 'iframe', 'input', 'embed', 'object'],
-    wrap: ['textarea'],
-    color: [],
-    fill: [],
-    opacity: [],
-    direction: [],
-    offset: [],
-    spacing: [],
-    disabled: ['button', 'input', 'select', 'textarea', 'option', 'optgroup', 'fieldset'],
-    readOnly: ['input', 'textarea'],
-    checked: ['input'],
-    selected: ['option'],
-    placeholder: ['input', 'textarea'],
-    label: ['track', 'option', 'optgroup'],
-    type: [
-        'input',
-        'button',
-        'ol',
-        'li',
-        'a',
-        'source',
-        'embed',
-        'object',
-        'script',
-        'style',
-        'link',
-    ],
-    value: [
-        'input',
-        'button',
-        'select',
-        'textarea',
-        'option',
-        'li',
-        'meter',
-        'progress',
-        'param',
-        'data',
-        'output',
-    ],
-};
-/**
- * The state attributes a component's omit list may name for its default element but that are
- * the element's own when it is rendered `as` an element that has them (see `omitStyleProps`).
- */
-var REQORE_ELEMENT_STATE_PROPS = new Set([
-    'disabled',
-    'readOnly',
-    'checked',
-    'selected',
-]);
-/** Whether `prop` is an attribute of the element `tag`, as far as Reqore's names go. */
-var isReqoreElementAttribute = function (prop, tag) {
-    if (typeof prop !== 'string' || SVG_TAGS.has(tag)) {
-        return true;
-    }
-    var elements = exports.REQORE_AMBIGUOUS_PROP_ELEMENTS[prop];
-    return !elements || elements.includes(tag);
-};
-exports.isReqoreElementAttribute = isReqoreElementAttribute;
 var omitStyleProps = function () {
     var propsToOmit = [];
     for (var _i = 0; _i < arguments.length; _i++) {
@@ -140,19 +36,10 @@ var omitStyleProps = function () {
     var omitted = new Set(propsToOmit);
     return function (prop, defaultValidatorFn, elementToBeCreated) {
         if (omitted.has(prop)) {
-            // A component's omit list is built against its default element. Given `as` another tag
-            // that has the state attribute — `<ReqorePanel as='fieldset' disabled>`, `<ReqoreTag
-            // as='button' disabled>` — the attribute is that element's, so it goes through.
-            return (typeof elementToBeCreated === 'string' &&
-                REQORE_ELEMENT_STATE_PROPS.has(prop) &&
-                defaultValidatorFn(prop) &&
-                exports.REQORE_AMBIGUOUS_PROP_ELEMENTS[prop].includes(elementToBeCreated));
+            return false;
         }
-        // Mirror styled-components' own default — a component gets everything, a DOM tag what is an
-        // HTML attribute — except that a DOM tag only gets an attribute of ITS element.
-        return typeof elementToBeCreated === 'string'
-            ? defaultValidatorFn(prop) && (0, exports.isReqoreElementAttribute)(prop, elementToBeCreated)
-            : true;
+        // Mirror styled-components' own default so only the omitted props change behaviour.
+        return typeof elementToBeCreated === 'string' ? defaultValidatorFn(prop) : true;
     };
 };
 exports.omitStyleProps = omitStyleProps;
@@ -190,43 +77,4 @@ exports.REQORE_CONTROL_GROUP_CHILD_PROPS = [
     'isMasterGroupRounded',
     'rounded',
 ];
-/**
- * Lists a component's styling props for `omitStyleProps`, from a record the compiler checks
- * against the component's prop interface.
- *
- * A hand-written omit list goes stale: a prop added to the interface later reaches the rendered
- * element until someone remembers the list (ReqoreButton rendered `as` a router link handed its
- * `fluid`, `compact`, `maxWidth`, ... to the link, which wrote them onto its `<a>`; a resizable,
- * transparent ReqorePanel handed re-resizable `transparent`). Typed as
- * `Record<TReqoreStylePropKeys<...>, true>`, the record must name every such prop and nothing
- * else, so a new prop that is not added fails the build instead of leaking.
- *
- * @example
- * const BUTTON_STYLE_PROPS = listReqoreStyleProps<
- *   TReqoreStylePropKeys<IReqoreButtonStyle, React.ButtonHTMLAttributes<HTMLButtonElement>>
- * >({ fluid: true, compact: true, ... });
- */
-var listReqoreStyleProps = function (props) {
-    return Object.keys(props);
-};
-exports.listReqoreStyleProps = listReqoreStyleProps;
-/**
- * Reqore's `styled`: styled-components' own, except that every styled component it makes filters
- * its props with `omitStyleProps()` — so a DOM element only receives the attributes of ITS
- * element (see `REQORE_AMBIGUOUS_PROP_ELEMENTS`), whether or not its author remembered to filter.
- *
- * Every Reqore source file imports `styled` from here (an ESLint rule forbids the default import
- * of `styled-components`). A styled component's own `.withConfig({ shouldForwardProp })`
- * replaces this filter, and is built with `omitStyleProps`, which includes it.
- */
-var withReqoreProps = function (construct) {
-    return typeof (construct === null || construct === void 0 ? void 0 : construct.withConfig) === 'function'
-        ? construct.withConfig({ shouldForwardProp: (0, exports.omitStyleProps)() })
-        : construct;
-};
-var reqoreStyled = new Proxy(styled_components_1.default, {
-    apply: function (target, thisArg, args) { return withReqoreProps(Reflect.apply(target, thisArg, args)); },
-    get: function (target, key, receiver) { return withReqoreProps(Reflect.get(target, key, receiver)); },
-});
-exports.default = reqoreStyled;
 //# sourceMappingURL=styled.js.map

package/dist/helpers/styled.js.map

@@ -1 +1 @@
-{"version":3,"file":"styled.js","sourceRoot":"","sources":["../../src/helpers/styled.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"styled.js","sourceRoot":"","sources":["../../src/helpers/styled.ts"],"names":[],"mappings":";;;AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,IAAM,cAAc,GAAG;IAAC,qBAAwB;SAAxB,UAAwB,EAAxB,qBAAwB,EAAxB,IAAwB;QAAxB,gCAAwB;;IACrD,IAAM,OAAO,GAAG,IAAI,GAAG,CAA2B,WAAW,CAAC,CAAC;IAE/D,OAAO,UACL,IAA8B,EAC9B,kBAA8C,EAC9C,kBAAwC;QAExC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,oFAAoF;QACpF,OAAO,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,cAAc,kBAezB;AAEF;;;;;;GAMG;AACU,QAAA,gCAAgC,GAAG;IAC9C,aAAa;IACb,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;IACN,cAAc;IACd,OAAO;IACP,qBAAqB;IACrB,SAAS;IACT,eAAe;IACf,SAAS;IACT,SAAS;IACT,cAAc;IACd,oBAAoB;IACpB,oBAAoB;IACpB,uBAAuB;IACvB,QAAQ;IACR,aAAa;IACb,oBAAoB;IACpB,mBAAmB;IACnB,sBAAsB;IACtB,SAAS;CACV,CAAC"}

package/dist/hooks/usePointerDrag.d.ts

@@ -0,0 +1,77 @@
+/** The axis a drag is on. */
+export type TPointerDragAxis = 'x' | 'y' | 'both';
+/** Where a drag has got to. */
+export interface IPointerDragDelta {
+    /** How far the pointer is from where it was pressed, in px. */
+    dx: number;
+    dy: number;
+    /** How fast it moved last, in px per ms; `0` until it has moved twice. */
+    vx: number;
+    vy: number;
+}
+/**
+ * The controls a press belongs to rather than to the surface around them: a button (a close
+ * control, an action), a link, a field, and the control group actions sit in. For a `canStart`
+ * that leaves those alone, as the drawer's title bar and a notification do.
+ */
+export declare const DRAG_CONTROL_SELECTOR = "button, a, input, textarea, select, [role=\"button\"], [contenteditable], .reqore-control-group";
+export interface IUsePointerDragOptions {
+    /** Off, every handler is inert and a press is just a press. Default `true`. */
+    enabled?: boolean;
+    /**
+     * Along `'x'` or `'y'`, a press that first moves mostly along the OTHER axis is not a drag: it
+     * is left to whatever that axis belongs to, which is usually the page or the content
+     * scrolling. `'both'` takes any direction. Default `'both'`.
+     */
+    axis?: TPointerDragAxis;
+    /** How far a press moves, in px, before it is a drag and not a click. Default `SWIPE.slop`. */
+    slop?: number;
+    /**
+     * Whether `dragging` is kept as state, so the element re-renders as a drag starts and ends.
+     * `false` for a surface that must not re-render mid-gesture — a rail of memoized tiles — which
+     * then carries its own drag state in `onStart` / `onEnd`. Default `true`.
+     */
+    trackDragging?: boolean;
+    /** Whether a press on this target may become a drag. Default: any primary-button press. */
+    canStart?: (event: React.PointerEvent<HTMLElement>) => boolean;
+    /** The press on `element` has moved past `slop` along the axis and is now a drag. */
+    onStart?: (element: HTMLElement, event: PointerEvent) => void;
+    /** The pointer moved while dragging. */
+    onMove?: (delta: IPointerDragDelta, event: PointerEvent) => void;
+    /**
+     * The drag ended: `committed` when the pointer was let go, not when the browser cancelled it
+     * (a touch the system took over), the window lost focus, or a mouse was let go off-window.
+     */
+    onEnd?: (delta: IPointerDragDelta, committed: boolean) => void;
+}
+/** The handlers to spread onto the element that takes the drag. */
+export interface IPointerDragHandlers {
+    onPointerDown: (event: React.PointerEvent<HTMLElement>) => void;
+    /** Swallows the click a drag ends with, so it is not a click on whatever it ended over. */
+    onClickCapture: (event: React.MouseEvent<HTMLElement>) => void;
+    /** Keeps the browser's own drag-and-drop (an image, a link, selected text) out of a drag. */
+    onDragStart: (event: React.DragEvent<HTMLElement>) => void;
+}
+export interface IUsePointerDrag {
+    /** Whether a drag is under way (always `false` with `trackDragging: false`). */
+    dragging: boolean;
+    handlers: IPointerDragHandlers;
+}
+/**
+ * A pointer drag — mouse, touch or pen — on one element: a press becomes a drag once it has
+ * moved past `slop` along the right axis, every move reports the distance from the press and
+ * the latest velocity, and the click a drag would end with is swallowed. The one gesture a
+ * sheet is pushed away with, a modal moved by, a tier stack swiped and a scroller pulled.
+ *
+ * The live gesture is tracked on the WINDOW, not on the element. A pull leaves a thin handle
+ * at once and the release can land anywhere, including outside the browser window; an element
+ * listening only to itself would never see that release and would stay stuck to the pointer.
+ * Pointer capture alone does not cover it, because capture is taken only once the drag engages
+ * and a fast pull is past the element before the first qualifying move. The listeners are
+ * bound per gesture, so an idle element adds no global listener, and the gesture also ends on
+ * a move with no button held (a release the page never saw) and when the window loses focus.
+ *
+ * The handlers never change identity; the options are read as they are when an event arrives.
+ */
+export declare const usePointerDrag: (options: IUsePointerDragOptions) => IUsePointerDrag;
+//# sourceMappingURL=usePointerDrag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePointerDrag.d.ts","sourceRoot":"","sources":["../../src/hooks/usePointerDrag.ts"],"names":[],"mappings":"AAGA,6BAA6B;AAC7B,MAAM,MAAM,gBAAgB,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAElD,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,oGAC+D,CAAC;AAElG,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC;IAC/D,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9D,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjE;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAChE;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAChE,2FAA2F;IAC3F,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC/D,6FAA6F;IAC7F,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,sBAAsB,KAAG,eA2MhE,CAAC"}

package/dist/hooks/usePointerDrag.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePointerDrag = exports.DRAG_CONTROL_SELECTOR = void 0;
+var react_1 = require("react");
+var gestures_1 = require("../helpers/gestures");
+/**
+ * The controls a press belongs to rather than to the surface around them: a button (a close
+ * control, an action), a link, a field, and the control group actions sit in. For a `canStart`
+ * that leaves those alone, as the drawer's title bar and a notification do.
+ */
+exports.DRAG_CONTROL_SELECTOR = 'button, a, input, textarea, select, [role="button"], [contenteditable], .reqore-control-group';
+/**
+ * A pointer drag — mouse, touch or pen — on one element: a press becomes a drag once it has
+ * moved past `slop` along the right axis, every move reports the distance from the press and
+ * the latest velocity, and the click a drag would end with is swallowed. The one gesture a
+ * sheet is pushed away with, a modal moved by, a tier stack swiped and a scroller pulled.
+ *
+ * The live gesture is tracked on the WINDOW, not on the element. A pull leaves a thin handle
+ * at once and the release can land anywhere, including outside the browser window; an element
+ * listening only to itself would never see that release and would stay stuck to the pointer.
+ * Pointer capture alone does not cover it, because capture is taken only once the drag engages
+ * and a fast pull is past the element before the first qualifying move. The listeners are
+ * bound per gesture, so an idle element adds no global listener, and the gesture also ends on
+ * a move with no button held (a release the page never saw) and when the window loses focus.
+ *
+ * The handlers never change identity; the options are read as they are when an event arrives.
+ */
+var usePointerDrag = function (options) {
+    var optionsRef = (0, react_1.useRef)(options);
+    optionsRef.current = options;
+    var gestureRef = (0, react_1.useRef)(null);
+    var suppressClickRef = (0, react_1.useRef)(false);
+    // Takes down the live gesture's window listeners; `null` while none is live.
+    var stopTrackingRef = (0, react_1.useRef)(null);
+    var _a = (0, react_1.useState)(false), dragging = _a[0], setDragging = _a[1];
+    var finish = (0, react_1.useCallback)(function (committed) {
+        var _a, _b, _c, _d, _e;
+        var gesture = gestureRef.current;
+        gestureRef.current = null;
+        (_a = stopTrackingRef.current) === null || _a === void 0 ? void 0 : _a.call(stopTrackingRef);
+        stopTrackingRef.current = null;
+        if (!(gesture === null || gesture === void 0 ? void 0 : gesture.dragging)) {
+            return;
+        }
+        if ((_c = (_b = gesture.element).hasPointerCapture) === null || _c === void 0 ? void 0 : _c.call(_b, gesture.pointerId)) {
+            gesture.element.releasePointerCapture(gesture.pointerId);
+        }
+        // The click that ends a drag is not a click on whatever it ended over. A mouse's click
+        // follows its release at once; a touch drag produces none, so the flag is dropped on the
+        // next turn of the event loop rather than left armed for a later, unrelated click.
+        suppressClickRef.current = true;
+        setTimeout(function () {
+            suppressClickRef.current = false;
+        }, 0);
+        if (optionsRef.current.trackDragging !== false) {
+            setDragging(false);
+        }
+        (_e = (_d = optionsRef.current).onEnd) === null || _e === void 0 ? void 0 : _e.call(_d, {
+            dx: gesture.lastX - gesture.startX,
+            dy: gesture.lastY - gesture.startY,
+            vx: gesture.vx,
+            vy: gesture.vy,
+        }, committed);
+    }, []);
+    var track = (0, react_1.useCallback)(function () {
+        var onMove = function (event) {
+            var _a, _b, _c, _d;
+            var gesture = gestureRef.current;
+            if (!gesture || gesture.pointerId !== event.pointerId) {
+                return;
+            }
+            // Nothing is held, so the button came up somewhere this page could never observe it —
+            // off the edge of the window, the usual way. `buttons` is what is pressed RIGHT NOW, so
+            // during a real drag it can only be non-zero.
+            if (event.buttons === 0) {
+                finish(false);
+                return;
+            }
+            var dx = event.clientX - gesture.startX;
+            var dy = event.clientY - gesture.startY;
+            if (!gesture.dragging) {
+                var _e = optionsRef.current, _f = _e.axis, axis = _f === void 0 ? 'both' : _f, _g = _e.slop, slop = _g === void 0 ? gestures_1.SWIPE.slop : _g;
+                if (Math.abs(dx) < slop && Math.abs(dy) < slop) {
+                    return;
+                }
+                // Mostly along the other axis: whatever that axis belongs to takes the press.
+                if ((axis === 'x' && Math.abs(dy) >= Math.abs(dx)) ||
+                    (axis === 'y' && Math.abs(dx) >= Math.abs(dy))) {
+                    finish(false);
+                    return;
+                }
+                gesture.dragging = true;
+                // Capture keeps the moves addressed to the element while the pointer is over others;
+                // the window listeners are what make the drag survive leaving it.
+                try {
+                    gesture.element.setPointerCapture(event.pointerId);
+                }
+                catch (_h) {
+                    // Capture is a nicety, not the mechanism.
+                }
+                if (optionsRef.current.trackDragging !== false) {
+                    setDragging(true);
+                }
+                (_b = (_a = optionsRef.current).onStart) === null || _b === void 0 ? void 0 : _b.call(_a, gesture.element, event);
+            }
+            var elapsed = event.timeStamp - gesture.lastTime;
+            if (elapsed > 0) {
+                gesture.vx = (event.clientX - gesture.lastX) / elapsed;
+                gesture.vy = (event.clientY - gesture.lastY) / elapsed;
+            }
+            gesture.lastX = event.clientX;
+            gesture.lastY = event.clientY;
+            gesture.lastTime = event.timeStamp;
+            (_d = (_c = optionsRef.current).onMove) === null || _d === void 0 ? void 0 : _d.call(_c, { dx: dx, dy: dy, vx: gesture.vx, vy: gesture.vy }, event);
+        };
+        var onEnd = function (event) {
+            var _a;
+            if (((_a = gestureRef.current) === null || _a === void 0 ? void 0 : _a.pointerId) === event.pointerId) {
+                finish(event.type === 'pointerup');
+            }
+        };
+        // Alt-tabbing mid-drag: the release happens in another window.
+        var onBlur = function () { return finish(false); };
+        window.addEventListener('pointermove', onMove);
+        window.addEventListener('pointerup', onEnd);
+        window.addEventListener('pointercancel', onEnd);
+        window.addEventListener('lostpointercapture', onEnd);
+        window.addEventListener('blur', onBlur);
+        stopTrackingRef.current = function () {
+            window.removeEventListener('pointermove', onMove);
+            window.removeEventListener('pointerup', onEnd);
+            window.removeEventListener('pointercancel', onEnd);
+            window.removeEventListener('lostpointercapture', onEnd);
+            window.removeEventListener('blur', onBlur);
+        };
+    }, [finish]);
+    // A gesture live at unmount would otherwise leave its window listeners behind.
+    (0, react_1.useEffect)(function () { return function () {
+        var _a;
+        gestureRef.current = null;
+        (_a = stopTrackingRef.current) === null || _a === void 0 ? void 0 : _a.call(stopTrackingRef);
+        stopTrackingRef.current = null;
+    }; }, []);
+    var handlers = (0, react_1.useMemo)(function () { return ({
+        onPointerDown: function (event) {
+            // A fresh press ends a gesture whose release the page never saw, and makes its click
+            // moot — INCLUDING a press this handler goes on to decline: pressing a field must not
+            // inherit a swallow from a drag that ended somewhere the page did not see.
+            if (gestureRef.current) {
+                finish(false);
+            }
+            suppressClickRef.current = false;
+            var _a = optionsRef.current, _b = _a.enabled, enabled = _b === void 0 ? true : _b, canStart = _a.canStart;
+            if (!enabled ||
+                (event.pointerType === 'mouse' && event.button !== 0) ||
+                (canStart && !canStart(event))) {
+                return;
+            }
+            gestureRef.current = {
+                pointerId: event.pointerId,
+                element: event.currentTarget,
+                startX: event.clientX,
+                startY: event.clientY,
+                lastX: event.clientX,
+                lastY: event.clientY,
+                lastTime: event.timeStamp,
+                vx: 0,
+                vy: 0,
+                dragging: false,
+            };
+            track();
+        },
+        onClickCapture: function (event) {
+            if (suppressClickRef.current) {
+                suppressClickRef.current = false;
+                event.preventDefault();
+                event.stopPropagation();
+            }
+        },
+        // A native drag beats pointer events to the punch on links and images; one that starts
+        // after the press became a drag is ours.
+        onDragStart: function (event) {
+            var _a;
+            if ((_a = gestureRef.current) === null || _a === void 0 ? void 0 : _a.dragging) {
+                event.preventDefault();
+            }
+        },
+    }); }, [finish, track]);
+    return { dragging: dragging, handlers: handlers };
+};
+exports.usePointerDrag = usePointerDrag;
+//# sourceMappingURL=usePointerDrag.js.map

package/dist/hooks/usePointerDrag.js.map

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

package/dist/hooks/useReqoreMedia.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Whether this environment can answer a media query at all. Decided ONCE at
+ * module load, on purpose: `useReqoreMedia` calls `useMedia` only when this is
+ * true, and a hook that appears in one render and not the next is a React
+ * error — a test that defines `window.matchMedia` after the module loaded
+ * (several do, to drive their own hooks) must not be able to flip it.
+ *
+ * jsdom has no `matchMedia`, so unit tests get fixed defaults. A real browser —
+ * the app, the Storybook dev server AND the browser-mode story runner — gets
+ * live queries, which is what makes a mobile story able to prove a breakpoint
+ * branch. The previous guard keyed on `NODE_ENV === 'test'`, which Vitest also
+ * sets for browser-mode stories, so every width-dependent behaviour in the
+ * library was unprovable by a story.
+ */
+export declare const CAN_QUERY_MEDIA: boolean;
+/**
+ * `useMedia` that degrades to `defaultState` where media queries cannot be
+ * evaluated (jsdom, SSR) instead of throwing. Reqore owns the breakpoints:
+ * this is for Reqore's own components — the provider's `isMobile` /
+ * `isTablet` / `isHoverCapable` and the drawer's sheet breakpoint — not a
+ * licence for a consumer to hand-roll a query of its own.
+ */
+export declare const useReqoreMedia: (query: string, defaultState?: boolean) => boolean;
+//# sourceMappingURL=useReqoreMedia.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useReqoreMedia.d.ts","sourceRoot":"","sources":["../../src/hooks/useReqoreMedia.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,SAC8C,CAAC;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,sBAAoB,KAAG,OACL,CAAC"}

package/dist/hooks/useReqoreMedia.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReqoreMedia = exports.CAN_QUERY_MEDIA = void 0;
+var react_use_1 = require("react-use");
+/**
+ * Whether this environment can answer a media query at all. Decided ONCE at
+ * module load, on purpose: `useReqoreMedia` calls `useMedia` only when this is
+ * true, and a hook that appears in one render and not the next is a React
+ * error — a test that defines `window.matchMedia` after the module loaded
+ * (several do, to drive their own hooks) must not be able to flip it.
+ *
+ * jsdom has no `matchMedia`, so unit tests get fixed defaults. A real browser —
+ * the app, the Storybook dev server AND the browser-mode story runner — gets
+ * live queries, which is what makes a mobile story able to prove a breakpoint
+ * branch. The previous guard keyed on `NODE_ENV === 'test'`, which Vitest also
+ * sets for browser-mode stories, so every width-dependent behaviour in the
+ * library was unprovable by a story.
+ */
+exports.CAN_QUERY_MEDIA = typeof window !== 'undefined' && typeof window.matchMedia === 'function';
+/**
+ * `useMedia` that degrades to `defaultState` where media queries cannot be
+ * evaluated (jsdom, SSR) instead of throwing. Reqore owns the breakpoints:
+ * this is for Reqore's own components — the provider's `isMobile` /
+ * `isTablet` / `isHoverCapable` and the drawer's sheet breakpoint — not a
+ * licence for a consumer to hand-roll a query of its own.
+ */
+var useReqoreMedia = function (query, defaultState) {
+    if (defaultState === void 0) { defaultState = false; }
+    return exports.CAN_QUERY_MEDIA ? (0, react_use_1.useMedia)(query, defaultState) : defaultState;
+};
+exports.useReqoreMedia = useReqoreMedia;
+//# sourceMappingURL=useReqoreMedia.js.map

package/dist/hooks/useReqoreMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReqoreMedia.js","sourceRoot":"","sources":["../../src/hooks/useReqoreMedia.ts"],"names":[],"mappings":";;;AAAA,uCAAqC;AAErC;;;;;;;;;;;;;GAaG;AACU,QAAA,eAAe,GAC1B,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC;AAE3E;;;;;;GAMG;AACI,IAAM,cAAc,GAAG,UAAC,KAAa,EAAE,YAAoB;IAApB,6BAAA,EAAA,oBAAoB;IAChE,OAAA,uBAAe,CAAC,CAAC,CAAC,IAAA,oBAAQ,EAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY;AAA9D,CAA8D,CAAC;AADpD,QAAA,cAAc,kBACsC"}