kang-components 0.9.3 → 0.9.6

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { BOUNCE_CURVE, PRESS_SCALE_PRIMARY, PRESS_SCALE_SUBTLE, pressPrimary, pr
 export { useAnimatedAction } from './use-animated-action.js';
 export { useViewportSize } from './use-viewport-size.js';
 export type { ViewportSize } from './use-viewport-size.js';
+export { useHideOnScroll } from './use-hide-on-scroll.js';
+export type { UseHideOnScrollOptions } from './use-hide-on-scroll.js';
 export { actionSheetContainer, actionSheetList, actionSheetRow, } from './action-sheet.js';
 export { Ripple, rippleAnimation, useRipple } from './ripple.js';
 export type { RippleState } from './ripple.js';
@@ -31,6 +33,8 @@ export { buildTheme, theme, hexToRgb } from './theme.js';
 export type { ThemeType } from './theme.js';
 export { lightPalette, darkPalette } from './palettes.js';
 export type { ModeColorPalette } from './palettes.js';
+export { tilePalette, tileColorIndex, tileColorForKey } from './tile-palette.js';
+export type { TileColor } from './tile-palette.js';
 export type { DynamicLanguage, CharacterPreference, StaticLanguage, } from './language.js';
 export { ListItem, UnorderedListItemContainer } from './list-item.js';
 export type { ListItemProps, ListItemIconName, ListItemActionName, } from './list-item.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,cAAc,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,YAAY,EACX,eAAe,EACf,mBAAmB,EACnB,cAAc,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export { BOUNCE_CURVE, PRESS_SCALE_PRIMARY, PRESS_SCALE_SUBTLE, pressPrimary, pressSubtle, pressPrimaryScale, pressSubtleScale, } from './press.js';
 export { useAnimatedAction } from './use-animated-action.js';
 export { useViewportSize } from './use-viewport-size.js';
+export { useHideOnScroll } from './use-hide-on-scroll.js';
 export { actionSheetContainer, actionSheetList, actionSheetRow, } from './action-sheet.js';
 export { Ripple, rippleAnimation, useRipple } from './ripple.js';
 export { SPRING_COMFORTABLE, SPRING_COMFORTABLE_SLOW, SPRING_SNAPPY, SPRING_RESPONSIVE, SPRING_STAGGERED, SPRING_INSTANT, SPRING_GENTLE, SPRING_VERY_SLOW, SPRING_LANDING, SPRING_RISING, } from './spring.js';
@@ -16,5 +17,6 @@ export { SearchField } from './search-field.js';
 export { SearchBar } from './search-bar.js';
 export { buildTheme, theme, hexToRgb } from './theme.js';
 export { lightPalette, darkPalette } from './palettes.js';
+export { tilePalette, tileColorIndex, tileColorForKey } from './tile-palette.js';
 export { ListItem, UnorderedListItemContainer } from './list-item.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,cAAc,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS1D,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,cAAc,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASjF,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tile-palette.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Word-tile palette — the airy pastel fills used behind tappable word tiles,
+ * flashcards, browse-grid cells and celebratory confetti.
+ *
+ * These eight pastels are **mode-independent**: they read on both light and
+ * dark surfaces and always pair with near-black text, so they live here as a
+ * standalone constant rather than inside `ModeColorPalette` (which is per-mode).
+ *
+ * This is the single source of truth. It was previously copy-pasted across six
+ * xunzi surfaces; consumers should import `tilePalette` / `tileColorForKey`
+ * instead of redeclaring the hex values or the hashing logic. An app that needs
+ * a different look should compose an explicit override, not fork the palette.
+ */
+/** A tile fill paired with the text color that stays legible on it. */
+export interface TileColor {
+    bg: string;
+    text: string;
+}
+/** The eight airy pastels, in stable order (index is part of the contract). */
+export declare const tilePalette: readonly TileColor[];
+/**
+ * Deterministic index into {@link tilePalette} for an arbitrary key — the same
+ * key always maps to the same color, so a given word keeps its tile color
+ * everywhere it appears. Preserves the historical
+ * `(hash + charCodeAt) * 31` algorithm the xunzi copies used.
+ */
+export declare function tileColorIndex(key: string): number;
+/** Deterministic tile color for a key (see {@link tileColorIndex}). */
+export declare function tileColorForKey(key: string): TileColor;
+//# sourceMappingURL=tile-palette.d.ts.map

package/dist/tile-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-palette.d.ts","sourceRoot":"","sources":["../src/tile-palette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAS3C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAEtD"}

package/dist/tile-palette.js

@@ -0,0 +1,42 @@
+/**
+ * Word-tile palette — the airy pastel fills used behind tappable word tiles,
+ * flashcards, browse-grid cells and celebratory confetti.
+ *
+ * These eight pastels are **mode-independent**: they read on both light and
+ * dark surfaces and always pair with near-black text, so they live here as a
+ * standalone constant rather than inside `ModeColorPalette` (which is per-mode).
+ *
+ * This is the single source of truth. It was previously copy-pasted across six
+ * xunzi surfaces; consumers should import `tilePalette` / `tileColorForKey`
+ * instead of redeclaring the hex values or the hashing logic. An app that needs
+ * a different look should compose an explicit override, not fork the palette.
+ */
+/** The eight airy pastels, in stable order (index is part of the contract). */
+export const tilePalette = [
+    { bg: '#90CAF9', text: '#1A1A1A' }, // Soft blue
+    { bg: '#A5D6A7', text: '#1A1A1A' }, // Mint
+    { bg: '#CE93D8', text: '#1A1A1A' }, // Lavender
+    { bg: '#FFAB91', text: '#1A1A1A' }, // Peach
+    { bg: '#80DEEA', text: '#1A1A1A' }, // Light teal
+    { bg: '#FFF59D', text: '#1A1A1A' }, // Butter
+    { bg: '#B39DDB', text: '#1A1A1A' }, // Wisteria
+    { bg: '#81D4FA', text: '#1A1A1A' }, // Sky
+];
+/**
+ * Deterministic index into {@link tilePalette} for an arbitrary key — the same
+ * key always maps to the same color, so a given word keeps its tile color
+ * everywhere it appears. Preserves the historical
+ * `(hash + charCodeAt) * 31` algorithm the xunzi copies used.
+ */
+export function tileColorIndex(key) {
+    let hash = 0;
+    for (let i = 0; i < key.length; i++) {
+        hash = (hash + key.charCodeAt(i)) * 31;
+    }
+    return Math.abs(hash) % tilePalette.length;
+}
+/** Deterministic tile color for a key (see {@link tileColorIndex}). */
+export function tileColorForKey(key) {
+    return tilePalette[tileColorIndex(key)];
+}
+//# sourceMappingURL=tile-palette.js.map

package/dist/tile-palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-palette.js","sourceRoot":"","sources":["../src/tile-palette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAyB;IAChD,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,YAAY;IAChD,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO;IAC3C,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW;IAC/C,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,QAAQ;IAC5C,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,aAAa;IACjD,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS;IAC7C,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW;IAC/C,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACzC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,OAAO,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/use-hide-on-scroll.d.ts

@@ -0,0 +1,39 @@
+export interface UseHideOnScrollOptions {
+    /**
+     * Minimum downward movement (px) accumulated since the last direction flip
+     * before the chrome hides — and the upward movement before it reveals.
+     * Filters out jitter so the bar doesn't flicker. Default 8.
+     */
+    threshold?: number;
+    /**
+     * The chrome always stays visible while the scroll position is within this
+     * many px of the top, regardless of direction. Default 16.
+     */
+    topOffset?: number;
+    /**
+     * When false, the hook attaches no listener and always reports visible. Use
+     * to disable auto-hide on views where the bar should be pinned. Default true.
+     */
+    enabled?: boolean;
+    /**
+     * Optional specific scroll source to observe. When omitted the hook listens
+     * on `window` in the capture phase, so it catches scroll from any nested
+     * overflow container (scroll events don't bubble, but capture still sees them).
+     */
+    target?: Window | HTMLElement | null;
+}
+/**
+ * Auto-hiding chrome on scroll: returns `hidden = true` when the user scrolls
+ * down (so a floating header / nav bar can slide out of the way) and `false`
+ * when they scroll up or return near the top — a common, usability-friendly
+ * pattern that keeps content in view while leaving the chrome one flick away.
+ *
+ * Source-agnostic: by default it observes scroll globally via the capture phase,
+ * so a single instance reacts to whichever overflow container the user is
+ * scrolling. Changing scroll source (e.g. navigating to another view's list)
+ * re-baselines and reveals, so the chrome never gets stuck hidden across views.
+ *
+ * @returns `true` when the chrome should be hidden, `false` when visible.
+ */
+export declare function useHideOnScroll(options?: UseHideOnScrollOptions): boolean;
+//# sourceMappingURL=use-hide-on-scroll.d.ts.map

package/dist/use-hide-on-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hide-on-scroll.d.ts","sourceRoot":"","sources":["../src/use-hide-on-scroll.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CACrC;AAwCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CA+D7E"}

package/dist/use-hide-on-scroll.js

@@ -0,0 +1,96 @@
+import { useEffect, useRef, useState } from 'react';
+const isDocumentLevel = (t) => 
+// window / document / null aren't Elements; documentElement & body are
+// Elements but represent page scroll, so fold them in too. Page scroll fires
+// on different targets across browsers (document vs window) — this collapses
+// them all to one identity.
+!(t instanceof Element) || t === document.documentElement || t === document.body;
+/**
+ * Collapse the various document-level scroll targets (window / document /
+ * documentElement / body — browsers differ on which fires) to a single stable
+ * identity so source-change detection doesn't false-positive on the page itself.
+ */
+const normalizeSource = (t) => isDocumentLevel(t) ? document : t;
+const scrollTopOf = (target) => {
+    if (!isDocumentLevel(target) && typeof target.scrollTop === 'number') {
+        return target.scrollTop;
+    }
+    return window.scrollY ?? window.pageYOffset ?? 0;
+};
+const readScrollTop = (event) => {
+    // Transform/virtualized scrollers can't expose scrollTop, so they carry an
+    // explicit logical position on the event detail — prefer it when present.
+    const detailTop = event.detail?.scrollTop;
+    if (typeof detailTop === 'number')
+        return detailTop;
+    return scrollTopOf(event.target);
+};
+/**
+ * Auto-hiding chrome on scroll: returns `hidden = true` when the user scrolls
+ * down (so a floating header / nav bar can slide out of the way) and `false`
+ * when they scroll up or return near the top — a common, usability-friendly
+ * pattern that keeps content in view while leaving the chrome one flick away.
+ *
+ * Source-agnostic: by default it observes scroll globally via the capture phase,
+ * so a single instance reacts to whichever overflow container the user is
+ * scrolling. Changing scroll source (e.g. navigating to another view's list)
+ * re-baselines and reveals, so the chrome never gets stuck hidden across views.
+ *
+ * @returns `true` when the chrome should be hidden, `false` when visible.
+ */
+export function useHideOnScroll(options = {}) {
+    const { threshold = 8, topOffset = 16, enabled = true, target } = options;
+    const [hidden, setHidden] = useState(false);
+    const lastYRef = useRef(0);
+    const lastSourceRef = useRef(null);
+    useEffect(() => {
+        if (!enabled || typeof window === 'undefined') {
+            setHidden(false);
+            return;
+        }
+        // Seed the baseline at the current document scroll so the first gesture is
+        // measured rather than swallowed re-baselining a null source.
+        lastSourceRef.current = normalizeSource(target ?? null);
+        lastYRef.current = scrollTopOf(target ?? null);
+        const handleScroll = (event) => {
+            const source = normalizeSource(event.target);
+            const y = readScrollTop(event);
+            // New scroll source (e.g. a freshly-mounted view's list): re-baseline
+            // and reveal rather than carrying the previous view's hidden state over.
+            if (source !== lastSourceRef.current) {
+                lastSourceRef.current = source;
+                lastYRef.current = y;
+                setHidden(false);
+                return;
+            }
+            // Near the top → always visible (and keep the baseline current).
+            if (y <= topOffset) {
+                lastYRef.current = y;
+                setHidden(false);
+                return;
+            }
+            const delta = y - lastYRef.current;
+            // Only move the baseline on a committed direction change, so slow
+            // scrolls accumulate toward the threshold instead of being swallowed.
+            if (delta > threshold) {
+                lastYRef.current = y;
+                setHidden(true);
+            }
+            else if (delta < -threshold) {
+                lastYRef.current = y;
+                setHidden(false);
+            }
+        };
+        // Capture phase + window catches scroll from any nested overflow element,
+        // since scroll events don't bubble but do traverse the capture path. When a
+        // specific target is given, listen directly on it.
+        const listenTarget = target ?? window;
+        const useCapture = !target;
+        listenTarget.addEventListener('scroll', handleScroll, useCapture);
+        return () => {
+            listenTarget.removeEventListener('scroll', handleScroll, useCapture);
+        };
+    }, [enabled, threshold, topOffset, target]);
+    return hidden;
+}
+//# sourceMappingURL=use-hide-on-scroll.js.map

package/dist/use-hide-on-scroll.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "kang-components",
-	"version": "0.9.3",
+	"version": "0.9.6",
 	"description": "Generic, domain-free React UI primitives (CSS-first press feedback, delayed-action hook, spring presets, cross-fading text, circle icon button).",
 	"type": "module",
 	"license": "MIT",