@react-hive/honey-layout 9.15.0 → 10.0.0

package/dist/index.dev.cjs

@@ -7934,30 +7934,34 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* binding */ ne),
 /* harmony export */   assert: () => (/* binding */ t),
-/* harmony export */   blobToFile: () => (/* binding */ me),
+/* harmony export */   blobToFile: () => (/* binding */ Se),
 /* harmony export */   calculateEuclideanDistance: () => (/* binding */ ee),
 /* harmony export */   calculateMovingSpeed: () => (/* binding */ te),
 /* harmony export */   calculatePercentage: () => (/* binding */ re),
-/* harmony export */   camelToDashCase: () => (/* binding */ W),
+/* harmony export */   camelToDashCase: () => (/* binding */ q),
 /* harmony export */   camelToWords: () => (/* binding */ J),
-/* harmony export */   chunk: () => (/* binding */ P),
+/* harmony export */   chunk: () => (/* binding */ x),
 /* harmony export */   cloneBlob: () => (/* binding */ ie),
-/* harmony export */   compact: () => (/* binding */ k),
+/* harmony export */   compact: () => (/* binding */ _),
 /* harmony export */   compose: () => (/* binding */ C),
-/* harmony export */   definedProps: () => (/* binding */ Ae),
+/* harmony export */   definedProps: () => (/* binding */ ke),
 /* harmony export */   delay: () => (/* binding */ X),
 /* harmony export */   difference: () => (/* binding */ E),
-/* harmony export */   everyAsync: () => (/* binding */ Z),
-/* harmony export */   fileListToFiles: () => (/* binding */ ge),
+/* harmony export */   everyAsync: () => (/* binding */ W),
+/* harmony export */   fileListToFiles: () => (/* binding */ Ae),
 /* harmony export */   filterParallel: () => (/* binding */ D),
 /* harmony export */   filterSequential: () => (/* binding */ B),
-/* harmony export */   findAsync: () => (/* binding */ U),
+/* harmony export */   findAsync: () => (/* binding */ Z),
 /* harmony export */   getDOMRectIntersectionRatio: () => (/* binding */ oe),
 /* harmony export */   getElementOffsetRect: () => (/* binding */ se),
 /* harmony export */   getFocusableHtmlElements: () => (/* binding */ fe),
-/* harmony export */   getLocalStorageCapabilities: () => (/* binding */ ye),
+/* harmony export */   getLocalStorageCapabilities: () => (/* binding */ me),
+/* harmony export */   getXOverflowWidth: () => (/* binding */ ye),
+/* harmony export */   getYOverflowHeight: () => (/* binding */ ge),
+/* harmony export */   hasXOverflow: () => (/* binding */ he),
+/* harmony export */   hasYOverflow: () => (/* binding */ we),
 /* harmony export */   hashString: () => (/* binding */ Q),
-/* harmony export */   intersection: () => (/* binding */ x),
+/* harmony export */   intersection: () => (/* binding */ P),
 /* harmony export */   invokeIfFunction: () => (/* binding */ N),
 /* harmony export */   isAnchorHtmlElement: () => (/* binding */ le),
 /* harmony export */   isArray: () => (/* binding */ S),
@@ -7967,25 +7971,25 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isDate: () => (/* binding */ u),
 /* harmony export */   isDecimal: () => (/* binding */ A),
 /* harmony export */   isDefined: () => (/* binding */ a),
-/* harmony export */   isEmptyArray: () => (/* binding */ _),
+/* harmony export */   isEmptyArray: () => (/* binding */ M),
 /* harmony export */   isEmptyObject: () => (/* binding */ c),
 /* harmony export */   isError: () => (/* binding */ h),
-/* harmony export */   isFile: () => (/* binding */ we),
-/* harmony export */   isFiniteNumber: () => (/* binding */ d),
+/* harmony export */   isFile: () => (/* binding */ pe),
+/* harmony export */   isFiniteNumber: () => (/* binding */ p),
 /* harmony export */   isFunction: () => (/* binding */ v),
 /* harmony export */   isHtmlElementFocusable: () => (/* binding */ ue),
 /* harmony export */   isInteger: () => (/* binding */ b),
-/* harmony export */   isLocalStorageReadable: () => (/* binding */ he),
-/* harmony export */   isMap: () => (/* binding */ p),
+/* harmony export */   isLocalStorageReadable: () => (/* binding */ de),
+/* harmony export */   isMap: () => (/* binding */ g),
 /* harmony export */   isNil: () => (/* binding */ n),
-/* harmony export */   isNilOrEmptyString: () => (/* binding */ q),
+/* harmony export */   isNilOrEmptyString: () => (/* binding */ U),
 /* harmony export */   isNull: () => (/* binding */ r),
 /* harmony export */   isNumber: () => (/* binding */ o),
 /* harmony export */   isObject: () => (/* binding */ l),
 /* harmony export */   isPromise: () => (/* binding */ R),
 /* harmony export */   isRegExp: () => (/* binding */ w),
-/* harmony export */   isSet: () => (/* binding */ g),
-/* harmony export */   isString: () => (/* binding */ V),
+/* harmony export */   isSet: () => (/* binding */ d),
+/* harmony export */   isString: () => (/* binding */ G),
 /* harmony export */   isSymbol: () => (/* binding */ m),
 /* harmony export */   isUndefined: () => (/* binding */ i),
 /* harmony export */   isValidDate: () => (/* binding */ y),
@@ -7993,21 +7997,21 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   not: () => (/* binding */ F),
 /* harmony export */   once: () => (/* binding */ L),
 /* harmony export */   parse2DMatrix: () => (/* binding */ ae),
-/* harmony export */   parseFileName: () => (/* binding */ pe),
+/* harmony export */   parseFileName: () => (/* binding */ be),
 /* harmony export */   pipe: () => (/* binding */ T),
-/* harmony export */   readFilesFromDataTransfer: () => (/* binding */ be),
-/* harmony export */   reduceAsync: () => (/* binding */ G),
+/* harmony export */   readFilesFromDataTransfer: () => (/* binding */ _e),
+/* harmony export */   reduceAsync: () => (/* binding */ z),
 /* harmony export */   retry: () => (/* binding */ j),
 /* harmony export */   runParallel: () => (/* binding */ $),
 /* harmony export */   runSequential: () => (/* binding */ Y),
-/* harmony export */   someAsync: () => (/* binding */ z),
+/* harmony export */   someAsync: () => (/* binding */ H),
 /* harmony export */   splitStringIntoWords: () => (/* binding */ K),
 /* harmony export */   timeout: () => (/* binding */ I),
-/* harmony export */   toKebabCase: () => (/* binding */ H),
-/* harmony export */   traverseFileSystemDirectory: () => (/* binding */ de),
-/* harmony export */   unique: () => (/* binding */ M)
+/* harmony export */   toKebabCase: () => (/* binding */ V),
+/* harmony export */   traverseFileSystemDirectory: () => (/* binding */ Me),
+/* harmony export */   unique: () => (/* binding */ k)
 /* harmony export */ });
-var e={};function t(e,t){if(!e)throw new Error(t)}e.d=(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},e.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);const r=e=>null===e,n=e=>null==e,a=e=>null!=e,i=e=>void 0===e,o=e=>"number"==typeof e,s=e=>"boolean"==typeof e,l=e=>"object"==typeof e,c=e=>l(e)&&!r(e)&&0===Object.keys(e).length,u=e=>e instanceof Date,f=e=>e instanceof Blob,h=e=>e instanceof Error,y=e=>u(e)&&!isNaN(e.getTime()),w=e=>e instanceof RegExp,p=e=>e instanceof Map,g=e=>e instanceof Set,m=e=>"symbol"==typeof e,d=e=>o(e)&&isFinite(e),b=e=>o(e)&&Number.isInteger(e),A=e=>d(e)&&!Number.isInteger(e),S=e=>Array.isArray(e),_=e=>S(e)&&0===e.length,k=e=>e.filter(Boolean),M=e=>[...new Set(e)],P=(e,r)=>(t(r>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(e.length/r)},(t,n)=>e.slice(n*r,(n+1)*r))),x=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...r]=e;return M(t).filter(e=>r.every(t=>t.includes(e)))},E=(e,t)=>e.filter(e=>!t.includes(e)),T=(...e)=>t=>e.reduce((e,t)=>t(e),t),C=(...e)=>t=>e.reduceRight((e,t)=>t(e),t),O=()=>{},v=e=>"function"==typeof e,F=e=>(...t)=>!e(...t),N=(e,...t)=>"function"==typeof e?e(...t):e,X=e=>new Promise(t=>setTimeout(t,e)),I=async(e,t,r="Operation timed out")=>{try{return await Promise.race([e,X(t).then(()=>Promise.reject(new Error(r)))])}finally{}},j=(e,{maxAttempts:t=3,delayMs:r=300,backoff:n=!0,onRetry:a}={})=>async(...i)=>{let o;for(let s=1;s<=t;s++)try{return await e(...i)}catch(e){if(o=e,s<t){a?.(s,e);const t=n?r*2**(s-1):r;await X(t)}}throw o},L=e=>{let t,r=!1;return function(...n){return r||(r=!0,t=e.apply(this,n)),t}},R=e=>v(e?.then),Y=async(e,t)=>{const r=[];for(let n=0;n<e.length;n++)r.push(await t(e[n],n,e));return r},$=async(e,t)=>Promise.all(e.map(t)),B=async(e,t)=>{const r=[];for(let n=0;n<e.length;n++){const a=e[n];await t(a,n,e)&&r.push(a)}return r},D=async(e,t)=>{const r=await $(e,async(e,r,n)=>!!await t(e,r,n)&&e);return k(r)},z=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return!0;return!1},Z=async(e,t)=>{for(let r=0;r<e.length;r++)if(!await t(e[r],r,e))return!1;return!0},G=async(e,t,r)=>{let n=r;for(let r=0;r<e.length;r++)n=await t(n,e[r],r,e);return n},U=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return e[r];return null},V=e=>"string"==typeof e,q=e=>""===e||n(e),H=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),W=e=>{const t=e.charAt(0),r=e.slice(1);return t.toLowerCase()+r.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)},J=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1 $2"),K=e=>e.split(" ").filter(Boolean),Q=e=>{let t=5381;for(let r=0;r<e.length;r++)t=33*t^e.charCodeAt(r);return(t>>>0).toString(36)},ee=(e,t,r,n)=>{const a=r-e,i=n-t;return Math.hypot(a,i)},te=(e,t)=>Math.abs(e/t),re=(e,t)=>e*t/100,ne=["INPUT","SELECT","TEXTAREA","BUTTON","A"],ae=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0,scaleX:1,scaleY:1,skewX:0,skewY:0};const[r,n,a,i,o,s]=t[1].split(", ").map(parseFloat);return{translateX:o,translateY:s,scaleX:r,scaleY:i,skewX:a,skewY:n}},ie=e=>new Blob([e],{type:e.type}),oe=(e,t)=>Math.max(0,Math.min(e.right,t.right)-Math.max(e.left,t.left))*Math.max(0,Math.min(e.bottom,t.bottom)-Math.max(e.top,t.top))/(t.width*t.height),se=e=>new DOMRect(e.offsetLeft,e.offsetTop,e.clientWidth,e.clientHeight),le=e=>"A"===e.tagName,ce=e=>"true"===e.getAttribute("contenteditable"),ue=e=>{if(!e)return!1;const t=window.getComputedStyle(e);if("hidden"===t.visibility||"none"===t.display)return!1;if("disabled"in e&&e.disabled)return!1;const r=e.getAttribute("tabindex");return"-1"!==r&&(ne.includes(e.tagName)?!le(e)||""!==e.href:!!ce(e)||null!==r)},fe=e=>Array.from(e.querySelectorAll("*")).filter(ue),he=()=>{if("undefined"==typeof window||!window.localStorage)return!1;try{return window.localStorage.getItem("__non_existing_key__"),!0}catch{return!1}},ye=()=>{if(!he())return{readable:!1,writable:!1};try{const e="__test_write__";return window.localStorage.setItem(e,"1"),window.localStorage.removeItem(e),{readable:!0,writable:!0}}catch{}return{readable:!0,writable:!1}},we=e=>e instanceof File,pe=e=>{const t=e.lastIndexOf(".");return t<=0||t===e.length-1?[e,""]:[e.slice(0,t),e.slice(t+1).toLowerCase()]},ge=e=>{if(!e)return[];const t=[];for(let r=0;r<e.length;r++)t.push(e[r]);return t},me=(e,t)=>new File([e],t,{type:e.type}),de=async(e,{skipFiles:t=[".DS_Store","Thumbs.db","desktop.ini","ehthumbs.db",".Spotlight-V100",".Trashes",".fseventsd","__MACOSX"]}={})=>{const r=new Set(t),n=await(async e=>{const t=e.createReader(),r=async()=>new Promise((e,n)=>{t.readEntries(async t=>{if(t.length)try{const n=await r();e([...t,...n])}catch(e){n(e)}else e([])},n)});return r()})(e);return(await $(n,async e=>e.isDirectory?de(e,{skipFiles:t}):r.has(e.name)?[]:[await new Promise((t,r)=>{e.file(t,r)})])).flat()},be=async(e,t={})=>{const r=e?.items;if(!r)return[];const n=[];for(let e=0;e<r.length;e++){const a=r[e];if("webkitGetAsEntry"in a){const e=a.webkitGetAsEntry?.();if(e?.isDirectory){n.push(de(e,t));continue}if(e?.isFile){n.push(new Promise((t,r)=>e.file(e=>t([e]),r)));continue}}const i=a.getAsFile();i&&n.push(Promise.resolve([i]))}return(await Promise.all(n)).flat()},Ae=e=>Object.entries(e).reduce((e,[t,r])=>(void 0!==r&&(e[t]=r),e),{});
+var e={};function t(e,t){if(!e)throw new Error(t)}e.d=(t,r)=>{for(var n in r)e.o(r,n)&&!e.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:r[n]})},e.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);const r=e=>null===e,n=e=>null==e,a=e=>null!=e,i=e=>void 0===e,o=e=>"number"==typeof e,s=e=>"boolean"==typeof e,l=e=>"object"==typeof e,c=e=>l(e)&&!r(e)&&0===Object.keys(e).length,u=e=>e instanceof Date,f=e=>e instanceof Blob,h=e=>e instanceof Error,y=e=>u(e)&&!isNaN(e.getTime()),w=e=>e instanceof RegExp,g=e=>e instanceof Map,d=e=>e instanceof Set,m=e=>"symbol"==typeof e,p=e=>o(e)&&isFinite(e),b=e=>o(e)&&Number.isInteger(e),A=e=>p(e)&&!Number.isInteger(e),S=e=>Array.isArray(e),M=e=>S(e)&&0===e.length,_=e=>e.filter(Boolean),k=e=>[...new Set(e)],x=(e,r)=>(t(r>0,"Chunk size must be greater than 0"),Array.from({length:Math.ceil(e.length/r)},(t,n)=>e.slice(n*r,(n+1)*r))),P=(...e)=>{if(0===e.length)return[];if(1===e.length)return[...e[0]];const[t,...r]=e;return k(t).filter(e=>r.every(t=>t.includes(e)))},E=(e,t)=>e.filter(e=>!t.includes(e)),T=(...e)=>t=>e.reduce((e,t)=>t(e),t),C=(...e)=>t=>e.reduceRight((e,t)=>t(e),t),O=()=>{},v=e=>"function"==typeof e,F=e=>(...t)=>!e(...t),N=(e,...t)=>"function"==typeof e?e(...t):e,X=e=>new Promise(t=>setTimeout(t,e)),I=async(e,t,r="Operation timed out")=>{try{return await Promise.race([e,X(t).then(()=>Promise.reject(new Error(r)))])}finally{}},j=(e,{maxAttempts:t=3,delayMs:r=300,backoff:n=!0,onRetry:a}={})=>async(...i)=>{let o;for(let s=1;s<=t;s++)try{return await e(...i)}catch(e){if(o=e,s<t){a?.(s,e);const t=n?r*2**(s-1):r;await X(t)}}throw o},L=e=>{let t,r=!1;return function(...n){return r||(r=!0,t=e.apply(this,n)),t}},R=e=>v(e?.then),Y=async(e,t)=>{const r=[];for(let n=0;n<e.length;n++)r.push(await t(e[n],n,e));return r},$=async(e,t)=>Promise.all(e.map(t)),B=async(e,t)=>{const r=[];for(let n=0;n<e.length;n++){const a=e[n];await t(a,n,e)&&r.push(a)}return r},D=async(e,t)=>{const r=await $(e,async(e,r,n)=>!!await t(e,r,n)&&e);return _(r)},H=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return!0;return!1},W=async(e,t)=>{for(let r=0;r<e.length;r++)if(!await t(e[r],r,e))return!1;return!0},z=async(e,t,r)=>{let n=r;for(let r=0;r<e.length;r++)n=await t(n,e[r],r,e);return n},Z=async(e,t)=>{for(let r=0;r<e.length;r++)if(await t(e[r],r,e))return e[r];return null},G=e=>"string"==typeof e,U=e=>""===e||n(e),V=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),q=e=>{const t=e.charAt(0),r=e.slice(1);return t.toLowerCase()+r.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)},J=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1 $2"),K=e=>e.split(" ").filter(Boolean),Q=e=>{let t=5381;for(let r=0;r<e.length;r++)t=33*t^e.charCodeAt(r);return(t>>>0).toString(36)},ee=(e,t,r,n)=>{const a=r-e,i=n-t;return Math.hypot(a,i)},te=(e,t)=>Math.abs(e/t),re=(e,t)=>e*t/100,ne=["INPUT","SELECT","TEXTAREA","BUTTON","A"],ae=e=>{const t=window.getComputedStyle(e).getPropertyValue("transform").match(/^matrix\((.+)\)$/);if(!t)return{translateX:0,translateY:0,scaleX:1,scaleY:1,skewX:0,skewY:0};const[r,n,a,i,o,s]=t[1].split(", ").map(parseFloat);return{translateX:o,translateY:s,scaleX:r,scaleY:i,skewX:a,skewY:n}},ie=e=>new Blob([e],{type:e.type}),oe=(e,t)=>Math.max(0,Math.min(e.right,t.right)-Math.max(e.left,t.left))*Math.max(0,Math.min(e.bottom,t.bottom)-Math.max(e.top,t.top))/(t.width*t.height),se=e=>new DOMRect(e.offsetLeft,e.offsetTop,e.clientWidth,e.clientHeight),le=e=>"A"===e.tagName,ce=e=>"true"===e.getAttribute("contenteditable"),ue=e=>{if(!e)return!1;const t=window.getComputedStyle(e);if("hidden"===t.visibility||"none"===t.display)return!1;if("disabled"in e&&e.disabled)return!1;const r=e.getAttribute("tabindex");return"-1"!==r&&(ne.includes(e.tagName)?!le(e)||""!==e.href:!!ce(e)||null!==r)},fe=e=>Array.from(e.querySelectorAll("*")).filter(ue),he=e=>e.scrollWidth>e.clientWidth,ye=e=>Math.max(0,e.scrollWidth-e.clientWidth),we=e=>e.scrollHeight>e.clientHeight,ge=e=>Math.max(0,e.scrollHeight-e.clientHeight),de=()=>{if("undefined"==typeof window||!window.localStorage)return!1;try{return window.localStorage.getItem("__non_existing_key__"),!0}catch{return!1}},me=()=>{if(!de())return{readable:!1,writable:!1};try{const e="__test_write__";return window.localStorage.setItem(e,"1"),window.localStorage.removeItem(e),{readable:!0,writable:!0}}catch{}return{readable:!0,writable:!1}},pe=e=>e instanceof File,be=e=>{const t=e.lastIndexOf(".");return t<=0||t===e.length-1?[e,""]:[e.slice(0,t),e.slice(t+1).toLowerCase()]},Ae=e=>{if(!e)return[];const t=[];for(let r=0;r<e.length;r++)t.push(e[r]);return t},Se=(e,t)=>new File([e],t,{type:e.type}),Me=async(e,{skipFiles:t=[".DS_Store","Thumbs.db","desktop.ini","ehthumbs.db",".Spotlight-V100",".Trashes",".fseventsd","__MACOSX"]}={})=>{const r=new Set(t),n=await(async e=>{const t=e.createReader(),r=async()=>new Promise((e,n)=>{t.readEntries(async t=>{if(t.length)try{const n=await r();e([...t,...n])}catch(e){n(e)}else e([])},n)});return r()})(e);return(await $(n,async e=>e.isDirectory?Me(e,{skipFiles:t}):r.has(e.name)?[]:[await new Promise((t,r)=>{e.file(t,r)})])).flat()},_e=async(e,t={})=>{const r=e?.items;if(!r)return[];const n=[];for(let e=0;e<r.length;e++){const a=r[e];if("webkitGetAsEntry"in a){const e=a.webkitGetAsEntry?.();if(e?.isDirectory){n.push(Me(e,t));continue}if(e?.isFile){n.push(new Promise((t,r)=>e.file(e=>t([e]),r)));continue}}const i=a.getAsFile();i&&n.push(Promise.resolve([i]))}return(await Promise.all(n)).flat()},ke=e=>Object.entries(e).reduce((e,[t,r])=>(void 0!==r&&(e[t]=r),e),{});
 //# sourceMappingURL=index.mjs.map
 
 /***/ },
@@ -13691,6 +13695,7 @@ const mergeRefs = (...refs) => value => {
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   applyAxisScroll: () => (/* reexport safe */ _use_honey_synthetic_scroll__WEBPACK_IMPORTED_MODULE_8__.applyAxisScroll),
 /* harmony export */   useHoneyDocumentKeyUpHandler: () => (/* reexport safe */ _use_honey_document_key_up_handler__WEBPACK_IMPORTED_MODULE_3__.useHoneyDocumentKeyUpHandler),
 /* harmony export */   useHoneyDrag: () => (/* reexport safe */ _use_honey_drag__WEBPACK_IMPORTED_MODULE_2__.useHoneyDrag),
 /* harmony export */   useHoneyLayout: () => (/* reexport safe */ _use_honey_layout__WEBPACK_IMPORTED_MODULE_4__.useHoneyLayout),
@@ -14212,6 +14217,23 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var _use_honey_synthetic_scroll__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./use-honey-synthetic-scroll */ "./src/hooks/use-honey-synthetic-scroll.ts");
 
+/**
+ * Enables synthetic horizontal (X-axis) scrolling for a container element
+ * using pointer-based drag interactions.
+ *
+ * This is a convenience wrapper around {@link useHoneySyntheticScroll} with
+ * the axis fixed to `'x'`.
+ *
+ * All behavior, boundaries, and lifecycle guarantees are identical to the
+ * base hook, but limited to horizontal movement only.
+ *
+ * @template Element - The HTML element type of the scrollable container.
+ *
+ * @param options - Configuration options forwarded to
+ * {@link useHoneySyntheticScroll}, excluding the `axis` option.
+ *
+ * @returns A ref that must be attached to the scrollable container element.
+ */
 const useHoneySyntheticScrollX = (options) => (0,_use_honey_synthetic_scroll__WEBPACK_IMPORTED_MODULE_0__.useHoneySyntheticScroll)({
     ...options,
     axis: 'x',
@@ -14233,6 +14255,23 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ });
 /* harmony import */ var _use_honey_synthetic_scroll__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./use-honey-synthetic-scroll */ "./src/hooks/use-honey-synthetic-scroll.ts");
 
+/**
+ * Enables synthetic vertical (Y-axis) scrolling for a container element
+ * using pointer-based drag interactions.
+ *
+ * This is a convenience wrapper around {@link useHoneySyntheticScroll} with
+ * the axis fixed to `'y'`.
+ *
+ * All behavior, boundaries, and lifecycle guarantees are identical to the
+ * base hook, but limited to vertical movement only.
+ *
+ * @template Element - The HTML element type of the scrollable container.
+ *
+ * @param options - Configuration options forwarded to
+ * {@link useHoneySyntheticScroll}, excluding the `axis` option.
+ *
+ * @returns A ref that must be attached to the scrollable container element.
+ */
 const useHoneySyntheticScrollY = (options) => (0,_use_honey_synthetic_scroll__WEBPACK_IMPORTED_MODULE_0__.useHoneySyntheticScroll)({
     ...options,
     axis: 'y',
@@ -14250,6 +14289,7 @@ const useHoneySyntheticScrollY = (options) => (0,_use_honey_synthetic_scroll__WE
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   applyAxisScroll: () => (/* binding */ applyAxisScroll),
 /* harmony export */   useHoneySyntheticScroll: () => (/* binding */ useHoneySyntheticScroll)
 /* harmony export */ });
 /* harmony import */ var react__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! react */ "react");
@@ -14261,6 +14301,23 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+/**
+ * Calculates the next translate value for a single scroll axis
+ * and determines whether movement is allowed within bounds.
+ *
+ * @returns The next translate value, or `null` if movement is not allowed.
+ */
+const applyAxisScroll = ({ delta, currentTranslate, containerSize, overflowSize, overscrollPct, }) => {
+    if (overflowSize <= 0 || delta === 0) {
+        return null;
+    }
+    const threshold = containerSize * (overscrollPct / 100);
+    const candidate = currentTranslate + delta;
+    const min = -(overflowSize + threshold);
+    const max = threshold;
+    const isWithinBounds = (delta < 0 && candidate >= min) || (delta > 0 && candidate <= max);
+    return isWithinBounds ? candidate : null;
+};
 /**
  * Enables synthetic scrolling for a container using pointer-based drag gestures.
  *
@@ -14283,7 +14340,7 @@ __webpack_require__.r(__webpack_exports__);
  *
  * @returns A ref that must be attached to the scrollable container element.
  */
-const useHoneySyntheticScroll = ({ axis = 'both', availableWindowPct = 0, onStartDrag, onEndDrag, resetOnResize = true, } = {}) => {
+const useHoneySyntheticScroll = ({ axis = 'both', overscrollPct = 0, onStartDrag, onEndDrag, resetOnResize = true, } = {}) => {
     const scrollableContainerRef = (0,react__WEBPACK_IMPORTED_MODULE_0__.useRef)(null);
     /**
      * Handles drag movement and applies clamped translation along the enabled axis or axes.
@@ -14297,39 +14354,39 @@ const useHoneySyntheticScroll = ({ axis = 'both', availableWindowPct = 0, onStar
         const { translateX, translateY } = (0,_react_hive_honey_utils__WEBPACK_IMPORTED_MODULE_1__.parse2DMatrix)(scrollableContainer);
         let nextX = translateX;
         let nextY = translateY;
-        let handled = false;
+        let shouldScroll = false;
         if (axis === 'x' || axis === 'both') {
-            const overflowX = scrollableContainer.scrollWidth - scrollableContainer.clientWidth;
-            if (overflowX > 0) {
-                const thresholdX = scrollableContainer.clientWidth * (availableWindowPct / 100);
-                const candidateX = translateX + deltaX;
-                const minX = -(overflowX + thresholdX);
-                const maxX = thresholdX;
-                if ((deltaX < 0 && candidateX >= minX) || (deltaX > 0 && candidateX <= maxX)) {
-                    nextX = candidateX;
-                    handled = true;
-                }
+            const next = applyAxisScroll({
+                delta: deltaX,
+                currentTranslate: translateX,
+                containerSize: scrollableContainer.clientWidth,
+                overflowSize: (0,_react_hive_honey_utils__WEBPACK_IMPORTED_MODULE_1__.getXOverflowWidth)(scrollableContainer),
+                overscrollPct,
+            });
+            if (next !== null) {
+                nextX = next;
+                shouldScroll = true;
             }
         }
         if (axis === 'y' || axis === 'both') {
-            const overflowY = scrollableContainer.scrollHeight - scrollableContainer.clientHeight;
-            if (overflowY > 0) {
-                const thresholdY = scrollableContainer.clientHeight * (availableWindowPct / 100);
-                const candidateY = translateY + deltaY;
-                const minY = -(overflowY + thresholdY);
-                const maxY = thresholdY;
-                if ((deltaY < 0 && candidateY >= minY) || (deltaY > 0 && candidateY <= maxY)) {
-                    nextY = candidateY;
-                    handled = true;
-                }
+            const next = applyAxisScroll({
+                delta: deltaY,
+                currentTranslate: translateY,
+                containerSize: scrollableContainer.clientHeight,
+                overflowSize: (0,_react_hive_honey_utils__WEBPACK_IMPORTED_MODULE_1__.getYOverflowHeight)(scrollableContainer),
+                overscrollPct,
+            });
+            if (next !== null) {
+                nextY = next;
+                shouldScroll = true;
             }
         }
         // Apply transform only when at least one axis was updated
-        if (handled) {
+        if (shouldScroll) {
             scrollableContainer.style.transform = `translate(${nextX}px, ${nextY}px)`;
         }
-        return handled;
-    }, [availableWindowPct]);
+        return shouldScroll;
+    }, [overscrollPct]);
     (0,_use_honey_drag__WEBPACK_IMPORTED_MODULE_2__.useHoneyDrag)(scrollableContainerRef, {
         onStartDrag,
         onMoveDrag,
@@ -15090,6 +15147,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   HoneyPopupContext: () => (/* reexport safe */ _components__WEBPACK_IMPORTED_MODULE_3__.HoneyPopupContext),
 /* harmony export */   HoneyStatusContent: () => (/* reexport safe */ _components__WEBPACK_IMPORTED_MODULE_3__.HoneyStatusContent),
 /* harmony export */   __DEV__: () => (/* reexport safe */ _constants__WEBPACK_IMPORTED_MODULE_1__.__DEV__),
+/* harmony export */   applyAxisScroll: () => (/* reexport safe */ _hooks__WEBPACK_IMPORTED_MODULE_5__.applyAxisScroll),
 /* harmony export */   applyBreakpointStyles: () => (/* reexport safe */ _helpers__WEBPACK_IMPORTED_MODULE_7__.applyBreakpointStyles),
 /* harmony export */   bpMedia: () => (/* reexport safe */ _helpers__WEBPACK_IMPORTED_MODULE_7__.bpMedia),
 /* harmony export */   createStyles: () => (/* reexport safe */ _helpers__WEBPACK_IMPORTED_MODULE_7__.createStyles),