@aiquants/virtualscroll 1.20.0 → 1.22.1

package/dist/styles/virtualscroll.css

@@ -1,2 +1,2 @@
 /*! tailwindcss v4.3.0 | MIT License | https://tailwindcss.com */
-@layer components{.aqvs-scroll-pane{display:flex;position:relative}.aqvs-scroll-pane-content{flex:1;height:100%;position:relative;overflow:hidden}.aqvs-tap-scroll-circle{touch-action:none;-webkit-user-select:none;user-select:none;justify-content:center;align-items:center;transition-property:transform;transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1);display:flex;position:relative}.aqvs-tap-scroll-circle-visual-outer{border-radius:9999px;position:absolute;inset:0}.aqvs-tap-scroll-circle-gradient{background:linear-gradient(to bottom right,#1d4ed899,#60a5fa8c,#bfdbfe66);border-width:1px;border-color:#fff6;border-radius:9999px;position:absolute;inset:0;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-tap-scroll-circle-inner{border-radius:9999px;position:absolute;inset:18%}.aqvs-sample-visual-rod{background-color:#ffffffd9;border-width:1px;border-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-pupil{background-color:#fffc;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-highlight{background-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-scrollbar{z-index:50;cursor:default;-webkit-user-select:none;user-select:none;touch-action:none;background-color:#fff;position:relative}.aqvs-scrollbar-horizontal{flex-direction:row;align-items:stretch;display:flex}.aqvs-scrollbar-vertical{flex-direction:column;align-items:stretch;display:flex}.aqvs-scrollbar-tap-circle-wrapper{pointer-events:auto;transition-property:opacity;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);position:absolute}.aqvs-scrollbar-arrow-button{color:#313131;background-color:#e0e0e0;justify-content:center;align-items:center;font-size:.75rem;line-height:1rem;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);display:flex}.aqvs-scrollbar-arrow-button:focus{outline-offset:2px;outline:2px solid #0000}.aqvs-scrollbar-arrow-button:focus-visible{outline-offset:1px;outline:2px solid #60a5fa}.aqvs-scrollbar-arrow-button:disabled{cursor:not-allowed;opacity:.5}.aqvs-scrollbar-arrow-button:enabled:hover{background-color:#d4d4d4}.aqvs-scrollbar-track{background-color:#f5f5f5;flex:1;position:relative}.aqvs-scrollbar-overlay{pointer-events:none;position:absolute;inset:0}.aqvs-scrollbar-thumb-wrapper{touch-action:none;position:absolute}.aqvs-scrollbar-thumb{transform-origin:50%;background-color:#7f7f7f;transition:transform 80ms ease-out;position:absolute}.aqvs-scrollbar-thumb[data-thumb-state=disabled]{transition:none;transform:none}.aqvs-scrollbar-thumb[data-thumb-state=hover]{background-color:#5f5f5f}.aqvs-scrollbar-thumb[data-thumb-state=dragging]{background-color:#4f4f4f;transition:transform 60ms ease-out}.aqvs-scrollbar-thumb-horizontal{inset:1.5px 0}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=hover]{top:-.5px;bottom:-.5px;transform:scaleY(1.06)}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=dragging]{top:-.5px;bottom:-.5px;transform:scaleY(1.12)}.aqvs-scrollbar-thumb-vertical{inset:0 1.5px}.aqvs-scrollbar-thumb-vertical[data-thumb-state=hover]{left:-.5px;right:-.5px;transform:scaleX(1.06)}.aqvs-scrollbar-thumb-vertical[data-thumb-state=dragging]{left:-.5px;right:-.5px;transform:scaleX(1.12)}.aqvs-scroll-to-edge-button{pointer-events:auto;color:#fff;text-transform:uppercase;letter-spacing:.05em;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);background-color:#1f2937cc;border-radius:9999px;padding:.25rem 3rem;font-size:10px;font-weight:500;transition-property:transform,background-color;transition-duration:.15s;transform:none;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-scroll-to-edge-button:hover{background-color:#374151}.aqvs-scroll-to-edge-button:active{transform:scale(.95)}.aqvs-scroll-to-edge-overlay{pointer-events:none;z-index:10;transition-property:opacity;transition-duration:.5s;position:absolute;inset:0}.aqvs-scroll-to-edge-overlay[data-visible=true]{opacity:1}.aqvs-scroll-to-edge-overlay[data-visible=false]{opacity:0}.aqvs-scroll-to-edge-button-container{justify-content:center;display:flex;position:absolute;left:0;right:0}.aqvs-scroll-to-edge-button-container-top{top:.5rem}.aqvs-scroll-to-edge-button-container-bottom{bottom:.5rem}.aqvs-no-items-container{width:100%;position:absolute;top:0}.aqvs-no-items-text{text-align:center;color:#6b7280}.aqvs-item-container,.aqvs-bottom-inset,.aqvs-items-wrapper{width:100%;position:absolute}}
+@layer components{.aqvs-scroll-pane{display:flex;position:relative}.aqvs-scroll-pane-content{flex:1;height:100%;position:relative;overflow:hidden}.aqvs-tap-scroll-circle{touch-action:none;-webkit-user-select:none;user-select:none;justify-content:center;align-items:center;transition-property:transform;transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1);display:flex;position:relative}.aqvs-tap-scroll-circle-visual-outer{border-radius:9999px;position:absolute;inset:0}.aqvs-tap-scroll-circle-gradient{background:linear-gradient(to bottom right,#1d4ed899,#60a5fa8c,#bfdbfe66);border-width:1px;border-color:#fff6;border-radius:9999px;position:absolute;inset:0;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-tap-scroll-circle-inner{border-radius:9999px;position:absolute;inset:18%}.aqvs-sample-visual-pupil{background-color:#ffffffd9;border-width:1px;border-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-highlight{background-color:#fffc;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-rod{background-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-scrollbar{z-index:50;cursor:default;-webkit-user-select:none;user-select:none;touch-action:none;background-color:#fff;position:relative}.aqvs-scrollbar-horizontal{flex-direction:row;align-items:stretch;display:flex}.aqvs-scrollbar-vertical{flex-direction:column;align-items:stretch;display:flex}.aqvs-scrollbar-tap-circle-wrapper{pointer-events:auto;transition-property:opacity;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);position:absolute}.aqvs-scrollbar-arrow-button{color:#313131;background-color:#e0e0e0;justify-content:center;align-items:center;font-size:.75rem;line-height:1rem;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);display:flex}.aqvs-scrollbar-arrow-button:focus{outline-offset:2px;outline:2px solid #0000}.aqvs-scrollbar-arrow-button:focus-visible{outline-offset:1px;outline:2px solid #60a5fa}.aqvs-scrollbar-arrow-button:disabled{cursor:not-allowed;opacity:.5}.aqvs-scrollbar-arrow-button:enabled:hover{background-color:#d4d4d4}.aqvs-scrollbar-track{background-color:#f5f5f5;flex:1;position:relative}.aqvs-scrollbar-overlay{pointer-events:none;position:absolute;inset:0}.aqvs-scrollbar-thumb-wrapper{touch-action:none;position:absolute}.aqvs-scrollbar-thumb{transform-origin:50%;background-color:#7f7f7f;transition:transform 80ms ease-out;position:absolute}.aqvs-scrollbar-thumb[data-thumb-state=disabled]{transition:none;transform:none}.aqvs-scrollbar-thumb[data-thumb-state=hover]{background-color:#5f5f5f}.aqvs-scrollbar-thumb[data-thumb-state=dragging]{background-color:#4f4f4f;transition:transform 60ms ease-out}.aqvs-scrollbar-thumb-horizontal{inset:1.5px 0}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=hover]{top:-.5px;bottom:-.5px;transform:scaleY(1.06)}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=dragging]{top:-.5px;bottom:-.5px;transform:scaleY(1.12)}.aqvs-scrollbar-thumb-vertical{inset:0 1.5px}.aqvs-scrollbar-thumb-vertical[data-thumb-state=hover]{left:-.5px;right:-.5px;transform:scaleX(1.06)}.aqvs-scrollbar-thumb-vertical[data-thumb-state=dragging]{left:-.5px;right:-.5px;transform:scaleX(1.12)}.aqvs-scroll-to-edge-button{pointer-events:auto;color:#fff;text-transform:uppercase;letter-spacing:.05em;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);background-color:#1f2937cc;border-radius:9999px;padding:.25rem 3rem;font-size:10px;font-weight:500;transition-property:transform,background-color;transition-duration:.15s;transform:none;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-scroll-to-edge-button:hover{background-color:#374151}.aqvs-scroll-to-edge-button:active{transform:scale(.95)}.aqvs-scroll-to-edge-overlay{pointer-events:none;z-index:10;transition-property:opacity;transition-duration:.5s;position:absolute;inset:0}.aqvs-scroll-to-edge-overlay[data-visible=true]{opacity:1}.aqvs-scroll-to-edge-overlay[data-visible=false]{opacity:0}.aqvs-scroll-to-edge-button-container{justify-content:center;display:flex;position:absolute;left:0;right:0}.aqvs-scroll-to-edge-button-container-top{top:.5rem}.aqvs-scroll-to-edge-button-container-bottom{bottom:.5rem}.aqvs-no-items-container{width:100%;position:absolute;top:0}.aqvs-no-items-text{text-align:center;color:#6b7280}.aqvs-item-container,.aqvs-bottom-inset,.aqvs-items-wrapper{width:100%;position:absolute}}

package/dist/styles/virtualscroll.standalone.css

@@ -1,3 +1,3 @@
 /*! tailwindcss v4.3.0 | MIT License | https://tailwindcss.com */
 /*! @aiquants/virtualscroll standalone CSS — 非 Tailwind ホスト専用。ホストの Tailwind ビルドと混在させないこと */
-@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--spacing:.25rem;--ease-out:cubic-bezier(0, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1)}}@layer base;@layer components{.aqvs-scroll-pane{display:flex;position:relative}.aqvs-scroll-pane-content{flex:1;height:100%;position:relative;overflow:hidden}.aqvs-tap-scroll-circle{touch-action:none;-webkit-user-select:none;user-select:none;justify-content:center;align-items:center;transition-property:transform;transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1);display:flex;position:relative}.aqvs-tap-scroll-circle-visual-outer{border-radius:9999px;position:absolute;inset:0}.aqvs-tap-scroll-circle-gradient{background:linear-gradient(to bottom right,#1d4ed899,#60a5fa8c,#bfdbfe66);border-width:1px;border-color:#fff6;border-radius:9999px;position:absolute;inset:0;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-tap-scroll-circle-inner{border-radius:9999px;position:absolute;inset:18%}.aqvs-sample-visual-rod{background-color:#ffffffd9;border-width:1px;border-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-pupil{background-color:#fffc;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-highlight{background-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-scrollbar{z-index:50;cursor:default;-webkit-user-select:none;user-select:none;touch-action:none;background-color:#fff;position:relative}.aqvs-scrollbar-horizontal{flex-direction:row;align-items:stretch;display:flex}.aqvs-scrollbar-vertical{flex-direction:column;align-items:stretch;display:flex}.aqvs-scrollbar-tap-circle-wrapper{pointer-events:auto;transition-property:opacity;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);position:absolute}.aqvs-scrollbar-arrow-button{color:#313131;background-color:#e0e0e0;justify-content:center;align-items:center;font-size:.75rem;line-height:1rem;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);display:flex}.aqvs-scrollbar-arrow-button:focus{outline-offset:2px;outline:2px solid #0000}.aqvs-scrollbar-arrow-button:focus-visible{outline-offset:1px;outline:2px solid #60a5fa}.aqvs-scrollbar-arrow-button:disabled{cursor:not-allowed;opacity:.5}.aqvs-scrollbar-arrow-button:enabled:hover{background-color:#d4d4d4}.aqvs-scrollbar-track{background-color:#f5f5f5;flex:1;position:relative}.aqvs-scrollbar-overlay{pointer-events:none;position:absolute;inset:0}.aqvs-scrollbar-thumb-wrapper{touch-action:none;position:absolute}.aqvs-scrollbar-thumb{transform-origin:50%;background-color:#7f7f7f;transition:transform 80ms ease-out;position:absolute}.aqvs-scrollbar-thumb[data-thumb-state=disabled]{transition:none;transform:none}.aqvs-scrollbar-thumb[data-thumb-state=hover]{background-color:#5f5f5f}.aqvs-scrollbar-thumb[data-thumb-state=dragging]{background-color:#4f4f4f;transition:transform 60ms ease-out}.aqvs-scrollbar-thumb-horizontal{inset:1.5px 0}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=hover]{top:-.5px;bottom:-.5px;transform:scaleY(1.06)}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=dragging]{top:-.5px;bottom:-.5px;transform:scaleY(1.12)}.aqvs-scrollbar-thumb-vertical{inset:0 1.5px}.aqvs-scrollbar-thumb-vertical[data-thumb-state=hover]{left:-.5px;right:-.5px;transform:scaleX(1.06)}.aqvs-scrollbar-thumb-vertical[data-thumb-state=dragging]{left:-.5px;right:-.5px;transform:scaleX(1.12)}.aqvs-scroll-to-edge-button{pointer-events:auto;color:#fff;text-transform:uppercase;letter-spacing:.05em;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);background-color:#1f2937cc;border-radius:9999px;padding:.25rem 3rem;font-size:10px;font-weight:500;transition-property:transform,background-color;transition-duration:.15s;transform:none;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-scroll-to-edge-button:hover{background-color:#374151}.aqvs-scroll-to-edge-button:active{transform:scale(.95)}.aqvs-scroll-to-edge-overlay{pointer-events:none;z-index:10;transition-property:opacity;transition-duration:.5s;position:absolute;inset:0}.aqvs-scroll-to-edge-overlay[data-visible=true]{opacity:1}.aqvs-scroll-to-edge-overlay[data-visible=false]{opacity:0}.aqvs-scroll-to-edge-button-container{justify-content:center;display:flex;position:absolute;left:0;right:0}.aqvs-scroll-to-edge-button-container-top{top:.5rem}.aqvs-scroll-to-edge-button-container-bottom{bottom:.5rem}.aqvs-no-items-container{width:100%;position:absolute;top:0}.aqvs-no-items-text{text-align:center;color:#6b7280}.aqvs-item-container,.aqvs-bottom-inset,.aqvs-items-wrapper{width:100%;position:absolute}}@layer utilities{.pointer-events-none{pointer-events:none}.collapse{visibility:collapse}.visible{visibility:visible}.fixed{position:fixed}.relative{position:relative}.static{position:static}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.hidden{display:none}.inline{display:inline}.size-1{width:calc(var(--spacing) * 1);height:calc(var(--spacing) * 1)}.shrink{flex-shrink:1}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.resize{resize:both}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.border{border-style:var(--tw-border-style);border-width:1px}.opacity-0{opacity:0}.blur{--tw-blur:blur(8px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--spacing:.25rem;--ease-out:cubic-bezier(0, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1)}}@layer base;@layer components{.aqvs-scroll-pane{display:flex;position:relative}.aqvs-scroll-pane-content{flex:1;height:100%;position:relative;overflow:hidden}.aqvs-tap-scroll-circle{touch-action:none;-webkit-user-select:none;user-select:none;justify-content:center;align-items:center;transition-property:transform;transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1);display:flex;position:relative}.aqvs-tap-scroll-circle-visual-outer{border-radius:9999px;position:absolute;inset:0}.aqvs-tap-scroll-circle-gradient{background:linear-gradient(to bottom right,#1d4ed899,#60a5fa8c,#bfdbfe66);border-width:1px;border-color:#fff6;border-radius:9999px;position:absolute;inset:0;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-tap-scroll-circle-inner{border-radius:9999px;position:absolute;inset:18%}.aqvs-sample-visual-pupil{background-color:#ffffffd9;border-width:1px;border-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-highlight{background-color:#fffc;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-sample-visual-rod{background-color:#ffffff80;border-radius:9999px;position:absolute;top:50%;left:50%}.aqvs-scrollbar{z-index:50;cursor:default;-webkit-user-select:none;user-select:none;touch-action:none;background-color:#fff;position:relative}.aqvs-scrollbar-horizontal{flex-direction:row;align-items:stretch;display:flex}.aqvs-scrollbar-vertical{flex-direction:column;align-items:stretch;display:flex}.aqvs-scrollbar-tap-circle-wrapper{pointer-events:auto;transition-property:opacity;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);position:absolute}.aqvs-scrollbar-arrow-button{color:#313131;background-color:#e0e0e0;justify-content:center;align-items:center;font-size:.75rem;line-height:1rem;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1);display:flex}.aqvs-scrollbar-arrow-button:focus{outline-offset:2px;outline:2px solid #0000}.aqvs-scrollbar-arrow-button:focus-visible{outline-offset:1px;outline:2px solid #60a5fa}.aqvs-scrollbar-arrow-button:disabled{cursor:not-allowed;opacity:.5}.aqvs-scrollbar-arrow-button:enabled:hover{background-color:#d4d4d4}.aqvs-scrollbar-track{background-color:#f5f5f5;flex:1;position:relative}.aqvs-scrollbar-overlay{pointer-events:none;position:absolute;inset:0}.aqvs-scrollbar-thumb-wrapper{touch-action:none;position:absolute}.aqvs-scrollbar-thumb{transform-origin:50%;background-color:#7f7f7f;transition:transform 80ms ease-out;position:absolute}.aqvs-scrollbar-thumb[data-thumb-state=disabled]{transition:none;transform:none}.aqvs-scrollbar-thumb[data-thumb-state=hover]{background-color:#5f5f5f}.aqvs-scrollbar-thumb[data-thumb-state=dragging]{background-color:#4f4f4f;transition:transform 60ms ease-out}.aqvs-scrollbar-thumb-horizontal{inset:1.5px 0}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=hover]{top:-.5px;bottom:-.5px;transform:scaleY(1.06)}.aqvs-scrollbar-thumb-horizontal[data-thumb-state=dragging]{top:-.5px;bottom:-.5px;transform:scaleY(1.12)}.aqvs-scrollbar-thumb-vertical{inset:0 1.5px}.aqvs-scrollbar-thumb-vertical[data-thumb-state=hover]{left:-.5px;right:-.5px;transform:scaleX(1.06)}.aqvs-scrollbar-thumb-vertical[data-thumb-state=dragging]{left:-.5px;right:-.5px;transform:scaleX(1.12)}.aqvs-scroll-to-edge-button{pointer-events:auto;color:#fff;text-transform:uppercase;letter-spacing:.05em;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);background-color:#1f2937cc;border-radius:9999px;padding:.25rem 3rem;font-size:10px;font-weight:500;transition-property:transform,background-color;transition-duration:.15s;transform:none;box-shadow:0 4px 6px -1px #0000001a,0 2px 4px -1px #0000000f}.aqvs-scroll-to-edge-button:hover{background-color:#374151}.aqvs-scroll-to-edge-button:active{transform:scale(.95)}.aqvs-scroll-to-edge-overlay{pointer-events:none;z-index:10;transition-property:opacity;transition-duration:.5s;position:absolute;inset:0}.aqvs-scroll-to-edge-overlay[data-visible=true]{opacity:1}.aqvs-scroll-to-edge-overlay[data-visible=false]{opacity:0}.aqvs-scroll-to-edge-button-container{justify-content:center;display:flex;position:absolute;left:0;right:0}.aqvs-scroll-to-edge-button-container-top{top:.5rem}.aqvs-scroll-to-edge-button-container-bottom{bottom:.5rem}.aqvs-no-items-container{width:100%;position:absolute;top:0}.aqvs-no-items-text{text-align:center;color:#6b7280}.aqvs-item-container,.aqvs-bottom-inset,.aqvs-items-wrapper{width:100%;position:absolute}}@layer utilities{.pointer-events-none{pointer-events:none}.collapse{visibility:collapse}.visible{visibility:visible}.fixed{position:fixed}.relative{position:relative}.static{position:static}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.hidden{display:none}.inline{display:inline}.size-1{width:calc(var(--spacing) * 1);height:calc(var(--spacing) * 1)}.shrink{flex-shrink:1}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.resize{resize:both}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.border{border-style:var(--tw-border-style);border-width:1px}.opacity-0{opacity:0}.blur{--tw-blur:blur(8px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}

package/dist/tapScrollCircleSampleVisual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tapScrollCircleSampleVisual.d.ts","sourceRoot":"","sources":["../src/tapScrollCircleSampleVisual.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAA8B,MAAM,uBAAuB,CAAA;AAI7F,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAgEzF,CAAA"}
+{"version":3,"file":"tapScrollCircleSampleVisual.d.ts","sourceRoot":"","sources":["../src/tapScrollCircleSampleVisual.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAA8B,MAAM,uBAAuB,CAAA;AAI7F,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAgEzF,CAAA"}

package/dist/useFenwickMapTree.d.cts

@@ -298,6 +298,11 @@ export declare class FenwickMapTree {
      * @method calculateAccumulatedError
      * @description Compares the cached total sum with a theoretical total calculated directly from the source values (`deltas` and `baseValue`, or `valueFn`). This helps detect any discrepancy in the tree's cached state, which might be caused by floating-point errors or other inconsistencies.
      * @description キャッシュされている合計値と、元の値 (`deltas` と `baseValue`、または `valueFn`) から直接計算した理論上の合計値とを比較します。これにより、浮動小数点数の累積誤差やその他の不整合によって生じる可能性のある、ツリーのキャッシュ状態の不一致を検出できます。
+     *
+     * ❗ 集計対象は `[0, size)` の範囲内にある delta だけです。`changeSize(0)` は
+     * ロード中の一時クリアとみなして delta を温存する (再伸長時にキャッシュを再利用するため) ので、
+     * 範囲外の delta まで数えると**木は健全なのに空リストの間ずっと非ゼロ**が返り、
+     * この値を破損検知に使う利用者が毎回不要な復旧処理を走らせてしまいます。
      * @returns {number} The difference between the cached total and the theoretical total.
      */
     calculateAccumulatedError(): number;
@@ -315,6 +320,18 @@ export declare class FenwickMapTree {
      * サイズ差分のみを受け取りインデックスの対応表は受け取らないため、要素は末尾に追加/末尾から削除
      * されると仮定する。既存行は index↔高さ の対応を保つ。したがって中間挿入/削除は表現できず、その
      * ような構造変更の後は index↔高さ の対応が保存されず、木の delta が誤った行へ適用されてしまう。
+     * ❗ `changeSize(0)` は例外的に delta を消去しない。ロード中に一覧が一瞬空になるフローで
+     * 実測済みの行高を捨てないための特例で、`changeSize(N > 0)` で再伸長したときに範囲内の delta が
+     * そのまま復元される (範囲外の delta はそこで刈られる)。size が 0 に留まっている間、
+     * `get()` / `getTotal()` は 0 を返し、`calculateAccumulatedError()` は範囲内 delta だけを
+     * 集計するので 0 のままになる。**別データセットへ差し替える場合は温存が害になる**ため、
+     * `reset()` を呼ぶか新しい `key` で作り直すこと。
+     * ❗ `changeSize(0)` intentionally keeps its deltas so a list that briefly empties while loading
+     * does not lose measured row heights; growing back restores the in-range ones (out-of-range
+     * deltas are pruned then). While the size stays 0, `get()` / `getTotal()` return 0 and
+     * `calculateAccumulatedError()` stays 0 because it only sums in-range deltas. Replacing the
+     * dataset instead of reloading the same one must go through `reset()` or a fresh instance.
+     *
      * 中間で要素を挿入/削除する消費側は、代わりに木をリセットするか (`useFenwickMapTree` の
      * `resetOnValueFnChange`。VirtualScroll では `resetOnGetItemHeightChange` として公開) 、新しい
      * `key` でコンポーネントを再マウントすること。
@@ -363,6 +380,32 @@ export declare class FenwickMapTree {
      * @returns {number} The total number of items.
      */
     getSize(): number;
+    /**
+     * @description Gets the base value of the tree — the height every row starts from before
+     * its own delta is applied. `useFenwickMapTree` reads it to decide whether a `0 → N` growth
+     * should re-sample from scratch (`reset`) or reuse the measured heights kept across the
+     * empty state (`changeSize`), so removing or renaming it silently disables that cache
+     * preservation.
+     *
+     * ❗ This is NOT a "has the tree warmed up?" flag. `0` is a legitimate base — it is what a
+     * tree constructed with `new FenwickMapTree(n, 0)` has, and what sampling produces when the
+     * value function returns 0 for not-yet-measured rows (a common virtualization pattern).
+     * Such a tree can hold plenty of measured deltas while `base` stays `0`. The hook's
+     * `0 → N` guard therefore trades cache preservation for correctness in exactly that case:
+     * a base of `0` cannot be distinguished from "never established", and growing incrementally
+     * from a zero base would pin `total` at `0 × N = 0`.
+     * @description ツリーの基準値 (各行が自身の delta を適用される前の高さ) を取得。
+     * `useFenwickMapTree` は `0 → N` の伸長を再サンプリング (`reset`) と実測高さの温存 (`changeSize`) の
+     * どちらへ倒すかの判定にこの値を読むため、削除・改名するとキャッシュ温存が黙って無効化される。
+     *
+     * ❗ **「木が温まったか」のフラグではない。** `0` は正当な基準値であり、
+     * `new FenwickMapTree(n, 0)` や「未計測行に 0 を返す `getItemHeight`」(仮想化では定番) の
+     * サンプリング結果として普通に発生する。その木は実測 delta を大量に持っていても `base` は `0` のまま。
+     * フックの `0 → N` ガードは、まさにこの場合にキャッシュ温存より整合を優先する
+     * (基準値 0 は「未確立」と区別できず、0 のまま増分伸長すると `total = 0 × N = 0` で固着するため)。
+     * @returns {number} The base value. 基準値。
+     */
+    get base(): number;
     /**
      * @method findIndexAtOrAfter
      * @description Finds the first index where the cumulative sum is greater than or equal to a target value.

package/dist/useFenwickMapTree.d.ts

@@ -298,6 +298,11 @@ export declare class FenwickMapTree {
      * @method calculateAccumulatedError
      * @description Compares the cached total sum with a theoretical total calculated directly from the source values (`deltas` and `baseValue`, or `valueFn`). This helps detect any discrepancy in the tree's cached state, which might be caused by floating-point errors or other inconsistencies.
      * @description キャッシュされている合計値と、元の値 (`deltas` と `baseValue`、または `valueFn`) から直接計算した理論上の合計値とを比較します。これにより、浮動小数点数の累積誤差やその他の不整合によって生じる可能性のある、ツリーのキャッシュ状態の不一致を検出できます。
+     *
+     * ❗ 集計対象は `[0, size)` の範囲内にある delta だけです。`changeSize(0)` は
+     * ロード中の一時クリアとみなして delta を温存する (再伸長時にキャッシュを再利用するため) ので、
+     * 範囲外の delta まで数えると**木は健全なのに空リストの間ずっと非ゼロ**が返り、
+     * この値を破損検知に使う利用者が毎回不要な復旧処理を走らせてしまいます。
      * @returns {number} The difference between the cached total and the theoretical total.
      */
     calculateAccumulatedError(): number;
@@ -315,6 +320,18 @@ export declare class FenwickMapTree {
      * サイズ差分のみを受け取りインデックスの対応表は受け取らないため、要素は末尾に追加/末尾から削除
      * されると仮定する。既存行は index↔高さ の対応を保つ。したがって中間挿入/削除は表現できず、その
      * ような構造変更の後は index↔高さ の対応が保存されず、木の delta が誤った行へ適用されてしまう。
+     * ❗ `changeSize(0)` は例外的に delta を消去しない。ロード中に一覧が一瞬空になるフローで
+     * 実測済みの行高を捨てないための特例で、`changeSize(N > 0)` で再伸長したときに範囲内の delta が
+     * そのまま復元される (範囲外の delta はそこで刈られる)。size が 0 に留まっている間、
+     * `get()` / `getTotal()` は 0 を返し、`calculateAccumulatedError()` は範囲内 delta だけを
+     * 集計するので 0 のままになる。**別データセットへ差し替える場合は温存が害になる**ため、
+     * `reset()` を呼ぶか新しい `key` で作り直すこと。
+     * ❗ `changeSize(0)` intentionally keeps its deltas so a list that briefly empties while loading
+     * does not lose measured row heights; growing back restores the in-range ones (out-of-range
+     * deltas are pruned then). While the size stays 0, `get()` / `getTotal()` return 0 and
+     * `calculateAccumulatedError()` stays 0 because it only sums in-range deltas. Replacing the
+     * dataset instead of reloading the same one must go through `reset()` or a fresh instance.
+     *
      * 中間で要素を挿入/削除する消費側は、代わりに木をリセットするか (`useFenwickMapTree` の
      * `resetOnValueFnChange`。VirtualScroll では `resetOnGetItemHeightChange` として公開) 、新しい
      * `key` でコンポーネントを再マウントすること。
@@ -363,6 +380,32 @@ export declare class FenwickMapTree {
      * @returns {number} The total number of items.
      */
     getSize(): number;
+    /**
+     * @description Gets the base value of the tree — the height every row starts from before
+     * its own delta is applied. `useFenwickMapTree` reads it to decide whether a `0 → N` growth
+     * should re-sample from scratch (`reset`) or reuse the measured heights kept across the
+     * empty state (`changeSize`), so removing or renaming it silently disables that cache
+     * preservation.
+     *
+     * ❗ This is NOT a "has the tree warmed up?" flag. `0` is a legitimate base — it is what a
+     * tree constructed with `new FenwickMapTree(n, 0)` has, and what sampling produces when the
+     * value function returns 0 for not-yet-measured rows (a common virtualization pattern).
+     * Such a tree can hold plenty of measured deltas while `base` stays `0`. The hook's
+     * `0 → N` guard therefore trades cache preservation for correctness in exactly that case:
+     * a base of `0` cannot be distinguished from "never established", and growing incrementally
+     * from a zero base would pin `total` at `0 × N = 0`.
+     * @description ツリーの基準値 (各行が自身の delta を適用される前の高さ) を取得。
+     * `useFenwickMapTree` は `0 → N` の伸長を再サンプリング (`reset`) と実測高さの温存 (`changeSize`) の
+     * どちらへ倒すかの判定にこの値を読むため、削除・改名するとキャッシュ温存が黙って無効化される。
+     *
+     * ❗ **「木が温まったか」のフラグではない。** `0` は正当な基準値であり、
+     * `new FenwickMapTree(n, 0)` や「未計測行に 0 を返す `getItemHeight`」(仮想化では定番) の
+     * サンプリング結果として普通に発生する。その木は実測 delta を大量に持っていても `base` は `0` のまま。
+     * フックの `0 → N` ガードは、まさにこの場合にキャッシュ温存より整合を優先する
+     * (基準値 0 は「未確立」と区別できず、0 のまま増分伸長すると `total = 0 × N = 0` で固着するため)。
+     * @returns {number} The base value. 基準値。
+     */
+    get base(): number;
     /**
      * @method findIndexAtOrAfter
      * @description Finds the first index where the cumulative sum is greater than or equal to a target value.

package/dist/useFenwickMapTree.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/virtualscroll",
-  "version": "1.20.0",
+  "version": "1.22.1",
   "description": "High-performance virtual scrolling component for React with variable item heights",
   "sideEffects": [
     "**/*.css"
@@ -27,7 +27,10 @@
   "files": [
     "dist",
     "src",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "bin": {

package/src/ScrollBar.tsx

@@ -185,7 +185,22 @@ const ARROW_HOLD_DELAY = 250
 const ARROW_HOLD_INTERVAL = 60
 const MIN_ARROW_STEP = 20
 const ARROW_STEP_DIVISOR = 20
-const TAP_SCROLL_MAX_DISTANCE = 240
+/**
+ * Defaults `computeTapScrollSpeed` callers need to reproduce the shipped speed mapping.
+ * `computeTapScrollSpeed` の呼び出し側が出荷時の速度写像を再現するために必要な既定値。
+ *
+ * ❗ これらは `ScrollBar` が `tapScrollCircleOptions` を解決するときに使う値そのもの。
+ * 公開しないと、`computeTapScrollSpeed` を渡された消費側が「自分の設定で実際に何 px/s 出るか」を
+ * 事前に検証できない (必須フィールドの大半が内部リゾルバの出力になってしまう)。
+ */
+export const TAP_SCROLL_SPEED_DEFAULTS = {
+    /** 速度が最大に達する引き距離 (px)。`maxVisualDistance` の既定値。 */
+    maxDistance: 240,
+    /** 最小速度倍率 (ビューポート比)。 */
+    minSpeedMultiplier: 0.2,
+} as const
+
+const TAP_SCROLL_MAX_DISTANCE = TAP_SCROLL_SPEED_DEFAULTS.maxDistance
 const TAP_SCROLL_INITIAL_STATE: TapScrollCircleDragState = { active: false, offsetX: 0, offsetY: 0, distance: 0, direction: 0, pointerId: null }
 
 const TAP_SCROLL_AUTO_SPEED_BASE_MULTIPLIER = 2.2
@@ -205,7 +220,7 @@ const DEFAULT_TAP_SCROLL_CIRCLE_OPTIONS: ResolvedTapScrollCircleOptions = {
     className: undefined,
     maxVisualDistance: TAP_SCROLL_MAX_DISTANCE,
     maxSpeedMultiplier: TAP_SCROLL_AUTO_SPEED_BASE_MULTIPLIER,
-    minSpeedMultiplier: 0.2,
+    minSpeedMultiplier: TAP_SCROLL_SPEED_DEFAULTS.minSpeedMultiplier,
     opacity: 0.9,
     renderVisual: undefined,
     maxSpeedCurve: undefined,
@@ -377,12 +392,172 @@ const useArrowAutoRepeat = ({ canUseArrowButtons, enableArrowButtons, resetTapSc
     return { handleArrowPointerDown, handleArrowPointerUp, handleArrowKeyDown }
 }
 
+/**
+ * Upper bound applied to `exponentialSteepness` before it reaches `Math.expm1`.
+ * `exponentialSteepness` を `Math.expm1` へ渡す前に掛ける上限。
+ *
+ * ❗ `Math.expm1(x)` は x >= 709.783 で `Infinity` になる。分母が `Infinity` になると
+ * 引ききった瞬間だけ `Infinity / Infinity = NaN` になる**部分故障**が起きるため、
+ * 有限が保証される範囲へ丸める。この値でも形状は実質ステップ関数なので実害は無い。
+ */
+const MAX_EXPONENTIAL_STEEPNESS = 700
+
+/**
+ * Returns the value when it is a finite number, otherwise the fallback.
+ * 有限数ならその値を、そうでなければ代替値を返す処理。
+ *
+ * @param value The candidate number. 検査対象の数値。
+ * @param fallback Value used when the candidate is not finite. 非有限だった場合の代替値。
+ * @returns A finite number. 有限数。
+ */
+const finiteOr = (value: number | undefined, fallback: number): number => (typeof value === "number" && Number.isFinite(value) ? value : fallback)
+
+/**
+ * Input for `computeTapScrollSpeed`.
+ * `computeTapScrollSpeed` の入力。
+ */
+export type TapScrollSpeedInput = {
+    /** サークルを引いた距離 (px)。 */
+    distance: number
+    /** 速度が最大に達する引き距離 (px)。 */
+    maxDistance: number
+    /** ビューポートの長さ (px)。速度倍率の基準。 */
+    viewportSize: number
+    /** 最小速度倍率 (ビューポート比)。 */
+    minSpeedMultiplier: number
+    /** 最大速度倍率 (ビューポート比)。 */
+    maxSpeedMultiplier: number
+    /** `maxSpeedMultiplier` が消費側から明示されたか (件数由来の自動値ではないか)。 */
+    hasCustomMaxSpeedMultiplier: boolean
+    /** 速度の立ち上がり形状。未指定なら `normalized ** 1.1` の既定形状。 */
+    curve?: { exponentialSteepness: number; exponentialScale?: number; easedOffset?: number }
+}
+
+/**
+ * Maps the tap-circle drag distance onto a scroll speed (px/s).
+ * タップサークルの引き距離をスクロール速度 (px/s) へ写像する処理。
+ *
+ * ❗ **曲線は「速度の上限」ではなく「立ち上がりの形状」を決める。**
+ * かつては指数カーブを上限 (`maxSpeed`) 側へ適用し、その `maxSpeed` へさらに
+ * イージングを掛けていた (二重適用)。その結果、指数側の上限が最小速度を下回る区間で
+ * `maxSpeed === minSpeed` へ潰れ、**引いても速度がまったく変わらない死角**が生まれていた。
+ * 死角の境界は `shape(n) = minSpeed / (viewportSize × exponentialScale)` を満たす点で、
+ * その**幅を支配するのは `exponentialSteepness`** である (比が同じ 0.2/14 でも
+ * steepness 1 なら引き幅の 2.4%、3 なら 8.0%、7.5 なら 43.9%、12 なら 64.6%)。
+ * `easedOffset` も同区間では完全に無効化されていた。
+ *
+ * そこで曲線は形状にのみ適用し、上限は距離に依存しない定数として扱う。
+ * これにより**縮退設定を除いて**速度は引き距離に対して狭義単調になり、平坦域が発生しない。
+ *
+ * 縮退設定 (意図的に定速へ倒す設定であり、欠陥ではない)。いずれも `maxSpeed === minSpeed`
+ * または `offset === 1` に潰れるため、引き距離に依らず定速になる:
+ *
+ * 1. `minSpeedMultiplier >= maxSpeedMultiplier` → 全域で最小速度に固定。
+ *    `ScrollBar.spec.tsx` の `FIXED_SPEED_OPTIONS` がこれを利用している。
+ * 2. `easedOffset === 1` → 全域で最高速に固定。
+ * 3. `exponentialScale <= max(minSpeedMultiplier, 40 / viewportSize)` → 曲線側の上限が
+ *    最小速度以下に潰れるため全域で最小速度に固定。**旧実装の死角と同種の現象**だが、
+ *    こちらは距離に依存しないので「一部区間だけ平坦」にはならず、全域が定速になる。
+ *    曲線を使うなら `exponentialScale > minSpeedMultiplier` を満たすこと。
+ *
+ * 各パラメータ:
+ *
+ * - `exponentialSteepness`: 立ち上がりの鋭さ。大きいほど低速域が長い。0 で線形。
+ *   内部で `[0, 700]` へ丸める (`Math.expm1` が `Infinity` になるのを避けるため)。
+ * - `exponentialScale`: 曲線側の上限 (ビューポート比)。省略時は `maxSpeedMultiplier`。
+ *   実効上限は `min(viewportSize × exponentialScale, linearMaxSpeed)` (いずれも `minSpeed` で下支え)。
+ *   ❗ `maxSpeedMultiplier` を**明示した**場合は `linearMaxSpeed = viewportSize × maxSpeedMultiplier`
+ *   なので「実効上限は `min(exponentialScale, maxSpeedMultiplier)` 倍」と読んでよいが、
+ *   **省略した場合はそうならない**。自動倍率には 1,200 px/s の下限が掛かるため、
+ *   実効上限は `min(viewportSize × exponentialScale, max(viewportSize × 自動倍率, 1200))` になる
+ *   (例: ビューポート 200・自動倍率 0.1・scale 0.5 なら、倍率比では 0.1 倍のはずが実際は 100 px/s)。
+ * - `easedOffset`: **速度レンジ全体 `[minSpeed, maxSpeed]` に対する比率**として、
+ *   引き距離 0 の時点で履かせる下駄 (0〜1)。
+ *   ❗ **「微速の下駄」ではない。** `maxSpeedMultiplier` (特に件数由来の自動値) が
+ *   大きいほど絶対速度も比例して大きくなる。例: ビューポート 800px・実効上限 8 倍で
+ *   `easedOffset: 0.18` なら引き距離 0 の時点で 1,283 px/s (160px 行なら毎秒 8 行) 出る。
+ *   低速域の分解能をその分だけ失うので、微速の下限を上げたいだけなら
+ *   `minSpeedMultiplier` を上げる方が意図に忠実。
+ *   ❗ 旧実装では下駄が `shape` への加算だったうえ、低速域は死角に飲まれて実質無効だった。
+ *   同じ値でも意味と絶対速度が変わるため、旧実装から値を持ち越さないこと。
+ *
+ * `maxSpeedMultiplier` を省略した場合の下限 1,200 px/s はビューポート非依存の絶対値で、
+ * 小さいビューポートほどビューポート比では速くなる (200px なら 6 vp/s、800px なら 1.5 vp/s)。
+ * 既存挙動との互換のため意図的に据え置いている。
+ *
+ * すべての数値入力は非有限 (NaN / ±Infinity) を代替値へ落として消毒する。
+ * 速度が NaN になると `scrollTo` を経てスクロール位置そのものが NaN で汚染され、
+ * 以後の相対移動が連鎖的に壊れて「スクロールが完全に効かなくなる」復旧不能な状態になるため。
+ *
+ * 外部から呼ぶときは `TAP_SCROLL_SPEED_DEFAULTS` と `computeAutoTapScrollMaxSpeedMultiplier()` を
+ * 併せて使うと、`ScrollBar` が実際に解決する値を再現できる:
+ *
+ * ```ts
+ * const options = { maxSpeedCurve: { exponentialSteepness: 3, exponentialScale: 8 } }
+ * const speed = computeTapScrollSpeed({
+ *     distance,
+ *     maxDistance: options.maxVisualDistance ?? TAP_SCROLL_SPEED_DEFAULTS.maxDistance,
+ *     viewportSize,
+ *     minSpeedMultiplier: options.minSpeedMultiplier ?? TAP_SCROLL_SPEED_DEFAULTS.minSpeedMultiplier,
+ *     maxSpeedMultiplier: options.maxSpeedMultiplier ?? computeAutoTapScrollMaxSpeedMultiplier(itemCount),
+ *     hasCustomMaxSpeedMultiplier: options.maxSpeedMultiplier !== undefined,
+ *     curve: options.maxSpeedCurve,
+ * })
+ * ```
+ *
+ * @param input Drag distance and the resolved speed options. 引き距離と解決済みの速度設定。
+ * @returns Scroll speed in px/s (always finite, >= 40). px/s 単位のスクロール速度 (常に有限かつ 40 以上)。
+ */
+export const computeTapScrollSpeed = ({ distance, maxDistance, viewportSize, minSpeedMultiplier, maxSpeedMultiplier, hasCustomMaxSpeedMultiplier, curve }: TapScrollSpeedInput): number => {
+    // ❗ 非有限を 1 つでも素通しさせると戻り値が NaN になり、スクロール位置が恒久的に壊れる。
+    // 呼び出し側 (`resolveTapScrollCircleOptions`) の `Math.max(x, 0)` は NaN を通すため、
+    // ここが唯一の防波堤である。`maxDistance` が 0 以下 (0 除算) の場合は最大速度側へ倒す。
+    const safeDistance = Math.max(finiteOr(distance, 0), 0)
+    const safeMaxDistance = finiteOr(maxDistance, 0)
+    const normalized = safeMaxDistance > 0 ? Math.min(safeDistance, safeMaxDistance) / safeMaxDistance : 1
+
+    const safeViewportSize = Math.max(finiteOr(viewportSize, 0), 0)
+    const safeMinMultiplier = Math.max(finiteOr(minSpeedMultiplier, 0), 0)
+    const safeMaxMultiplier = Math.max(finiteOr(maxSpeedMultiplier, 0), 0)
+
+    const minSpeed = Math.max(safeViewportSize * safeMinMultiplier, 40)
+    // 自動倍率のときだけ下限を持ち上げる (件数由来の倍率が小さすぎても実用速度を確保するため)
+    const maxSpeedFloor = hasCustomMaxSpeedMultiplier ? minSpeed : 1200
+    const linearMaxSpeed = Math.max(safeViewportSize * safeMaxMultiplier, maxSpeedFloor)
+
+    // 上限は距離に依存しない定数。曲線があれば scale で頭打ちにする
+    const curveScale = curve ? Math.max(finiteOr(curve.exponentialScale, safeMaxMultiplier), 0) : 0
+    const ceiling = curve ? Math.min(linearMaxSpeed, Math.max(safeViewportSize * curveScale, minSpeed)) : linearMaxSpeed
+    const maxSpeed = Math.max(ceiling, minSpeed)
+
+    // 形状。曲線が無ければ従来どおり normalized ** 1.1
+    let shape = normalized ** 1.1
+    if (curve) {
+        const steepness = Math.min(Math.max(finiteOr(curve.exponentialSteepness, 0), 0), MAX_EXPONENTIAL_STEEPNESS)
+        if (steepness === 0) {
+            shape = normalized
+        } else {
+            const denominator = Math.expm1(steepness) || 1
+            shape = Math.min(Math.max(Math.expm1(steepness * normalized) / denominator, 0), 1)
+        }
+    }
+
+    // ❗ 下駄は加算ではなく**再写像**する。`min(1, shape + offset)` にすると
+    // shape が 1 - offset に達した時点で頭打ちになり、今度は**上端に平坦域**ができる
+    // (引ききる手前から速度が変わらなくなる)。[offset, 1] へ写せば端から端まで単調を保てる。
+    const offset = Math.min(Math.max(finiteOr(curve?.easedOffset, 0), 0), 1)
+    return minSpeed + (maxSpeed - minSpeed) * (offset + (1 - offset) * shape)
+}
+
 /**
  * Computes the auto-scroll speed multiplier based on item count.
  *
  * アイテム数に応じた自動スクロール速度倍率を算出。
+ *
+ * @param itemCount Total number of items. アイテムの総数。
+ * @returns Speed multiplier relative to the viewport size. ビューポート比の速度倍率。
  */
-const computeAutoTapScrollMaxSpeedMultiplier = (itemCount?: number) => {
+export const computeAutoTapScrollMaxSpeedMultiplier = (itemCount?: number) => {
     if (!itemCount || itemCount <= 0) {
         return TAP_SCROLL_AUTO_SPEED_BASE_MULTIPLIER
     }
@@ -668,36 +843,15 @@ export const ScrollBar = ({
                 return
             }
 
-            // Calculate normalized distance (0.0 to 1.0)
-            // 正規化された距離を計算 (0.0 から 1.0)
-            const normalized = Math.min(state.distance, metrics.effectiveTapMaxDistance) / metrics.effectiveTapMaxDistance
-            // Apply base non-linear easing
-            // 基準の非線形イージングを適用
-            const eased = normalized ** 1.1
-            const hasCustomMaxSpeedMultiplier = typeof metrics.tapScrollCircleOptions?.maxSpeedMultiplier === "number"
-            const minSpeed = Math.max(metrics.viewportSize * metrics.tapCircleMinSpeedMultiplier, 40)
-            const maxSpeedFloor = hasCustomMaxSpeedMultiplier ? minSpeed : 1200
-            const linearMaxSpeed = Math.max(metrics.viewportSize * metrics.tapCircleMaxSpeedMultiplier, maxSpeedFloor)
-
-            let cappedMaxSpeed = linearMaxSpeed
-            const curve = metrics.tapCircleMaxSpeedCurve
-
-            // Apply exponential curve scaling if configured
-            // 設定されている場合、指数関数曲線スケーリングを適用します
-            if (curve) {
-                const steepness = Math.max(curve.exponentialSteepness, 0)
-                const scale = Math.max(curve.exponentialScale ?? metrics.tapCircleMaxSpeedMultiplier, 0)
-                const expNumerator = steepness === 0 ? normalized : Math.expm1(steepness * normalized)
-                const expDenominator = steepness === 0 ? 1 : Math.expm1(steepness) || 1
-                const exponentialRatio = expDenominator === 0 ? normalized : Math.min(Math.max(expNumerator / expDenominator, 0), 1)
-                const exponentialMaxSpeed = metrics.viewportSize * scale * exponentialRatio
-                cappedMaxSpeed = Math.min(cappedMaxSpeed, Math.max(exponentialMaxSpeed, minSpeed))
-            }
-
-            const maxSpeed = Math.max(cappedMaxSpeed, minSpeed)
-            const easedOffset = Math.max(curve?.easedOffset ?? 0, 0)
-            const effectiveEased = Math.min(1, eased + easedOffset)
-            const speed = minSpeed + (maxSpeed - minSpeed) * effectiveEased
+            const speed = computeTapScrollSpeed({
+                distance: state.distance,
+                maxDistance: metrics.effectiveTapMaxDistance,
+                viewportSize: metrics.viewportSize,
+                minSpeedMultiplier: metrics.tapCircleMinSpeedMultiplier,
+                maxSpeedMultiplier: metrics.tapCircleMaxSpeedMultiplier,
+                hasCustomMaxSpeedMultiplier: typeof metrics.tapScrollCircleOptions?.maxSpeedMultiplier === "number",
+                curve: metrics.tapCircleMaxSpeedCurve,
+            })
 
             // 方向が転換したら逆向きの残差を破棄する。持ち越すと逆向き残差を燃焼し切るまで
             // スクロール反転が固着する (タップサークルはヒステリシス幅を超える 1 イベントで +1→-1 に反転し得る)。
@@ -733,6 +887,28 @@ export const ScrollBar = ({
         }
     }, [stepAutoScroll])
 
+    /**
+     * Re-arms the tap auto-scroll loop when the scrollable extent changes under a held finger.
+     * サークルを掴んだまま可動域が変わったときに自動スクロールを張り直す副作用。
+     *
+     * ❗ ループは境界到達 (およびスクロール不能) で自分を止め、`startAutoScroll()` は
+     * タップサークルのポインタイベントからしか呼ばれない。そのため、**末端まで送った状態で
+     * 指を離さずにいるとコンテンツが増えてもスクロールが再開しない** (無限スクロールや
+     * ストリーミング取得の一覧では、指を一度離すまで動かない状態に見える)。
+     * `startAutoScroll()` は既にフレームが予約済みなら何もしないので、多重起動にはならない。
+     *
+     * 目的: 可動域が広がったら止まっているループを再開する。
+     * 依存関係: [contentSize, viewportSize, startAutoScroll]
+     * クリーンアップ: 不要 (停止はループ自身とアンマウント時の副作用が担う)。
+     */
+    useEffect(() => {
+        const state = tapDragStateRef.current
+        if (!state.active || state.direction === 0) {
+            return
+        }
+        startAutoScroll()
+    }, [contentSize, viewportSize, startAutoScroll])
+
     /**
      * Cleanup auto-scroll on unmount.
      *
@@ -1234,6 +1410,13 @@ export const ScrollBar = ({
      * pointerup を待たずにドラッグ状態を破棄し、stale な pointerId の残留を防ぐ。
      */
     const handleLostPointerCaptureOnTrack = (event: React.PointerEvent<HTMLDivElement>) => {
+        // ❗ 発生源がトラック自身のときだけ反応する。`lostpointercapture` はバブリングするため、
+        // 子孫であるつまみやオーバーレイのキャプチャ遷移まで拾ってしまう。タッチ・ペンでは仕様
+        // (暗黙のポインタキャプチャ) により着地点の子孫が先にキャプチャを持つので、この取り違えは
+        // 実際に起こり得る。トラックのドラッグ状態を壊してよいのはトラック自身の喪失だけ。
+        if (event.target !== event.currentTarget) {
+            return
+        }
         if (trackDragStateRef.current.pointerId !== event.pointerId) {
             return
         }
@@ -1373,6 +1556,8 @@ export const ScrollBar = ({
                         key="thumb"
                         ref={thumbRef}
                         className={twMerge("aqvs-scrollbar-thumb", horizontal ? "aqvs-scrollbar-thumb-horizontal" : "aqvs-scrollbar-thumb-vertical")}
+                        // DOM フックはクラスセレクタでなく data-* 属性を使う (AGENTS.md 準拠)
+                        data-testid="aqvs-scrollbar-thumb"
                         data-thumb-state={thumbVisualState}
                         style={{
                             borderRadius: scrollBarWidth - 1,