kang-components 0.9.2 → 0.9.5

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';
@@ -25,6 +27,8 @@ export { BottomSheet } from './bottom-sheet.js';
 export type { BottomSheetProps } from './bottom-sheet.js';
 export { SearchField } from './search-field.js';
 export type { SearchFieldProps } from './search-field.js';
+export { SearchBar } from './search-bar.js';
+export type { SearchBarProps } from './search-bar.js';
 export { buildTheme, theme, hexToRgb } from './theme.js';
 export type { ThemeType } from './theme.js';
 export { lightPalette, darkPalette } from './palettes.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,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';
@@ -13,6 +14,7 @@ export { default as ToggleSwitch } from './toggle-switch.js';
 export { ConfirmDialog } from './confirm-dialog.js';
 export { BottomSheet } from './bottom-sheet.js';
 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 { ListItem, UnorderedListItemContainer } from './list-item.js';

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,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;AAS1D,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/search-bar.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SearchBar — a *composite*: a back button + the expanding {@link SearchField} +
+ * a slide-in reveal, wired together with their animation as one unit. This is
+ * the next tier above kang's primitives — a group of components that must work
+ * together — so apps (xunzi's native search, the Hua Wen Reader add-on) mount
+ * the same animated search bar rather than re-implementing it.
+ *
+ * Presentational + domain-free: the host controls `active` (drives the reveal),
+ * owns the `value`/`onChange`, and supplies an optional `onBack`. Positioning
+ * (e.g. over a shell/backstage) and any decoration (titles, watermarks) stay
+ * with the host, which can wrap this or pass a `title` slot.
+ *
+ * Composes kang's own `BackButton` + `SearchField`; `styled-components`, `react`
+ * and `@react-spring/web` are the only things it pulls in.
+ */
+import { type ReactElement, type ReactNode } from 'react';
+export interface SearchBarProps {
+    /** Drives the slide-in/out reveal (and whether the field is interactive). */
+    active: boolean;
+    value: string;
+    onChange: (value: string) => void;
+    /** Optional back/close button rendered before the field. */
+    onBack?: () => void;
+    backAriaLabel?: string;
+    placeholder?: string;
+    ariaLabel?: string;
+    /** Optional leading title/label rendered above the field row. */
+    title?: ReactNode;
+    className?: string;
+}
+export declare function SearchBar({ active, value, onChange, onBack, backAriaLabel, placeholder, ariaLabel, title, className, }: SearchBarProps): ReactElement;
+export default SearchBar;
+//# sourceMappingURL=search-bar.d.ts.map

package/dist/search-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-bar.d.ts","sourceRoot":"","sources":["../src/search-bar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMrE,MAAM,WAAW,cAAc;IAC9B,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAqBD,wBAAgB,SAAS,CAAC,EACzB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,aAAsB,EACtB,WAAW,EACX,SAAS,EACT,KAAK,EACL,SAAS,GACT,EAAE,cAAc,GAAG,YAAY,CA+C/B;AAED,eAAe,SAAS,CAAC"}

package/dist/search-bar.js

@@ -0,0 +1,65 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SearchBar — a *composite*: a back button + the expanding {@link SearchField} +
+ * a slide-in reveal, wired together with their animation as one unit. This is
+ * the next tier above kang's primitives — a group of components that must work
+ * together — so apps (xunzi's native search, the Hua Wen Reader add-on) mount
+ * the same animated search bar rather than re-implementing it.
+ *
+ * Presentational + domain-free: the host controls `active` (drives the reveal),
+ * owns the `value`/`onChange`, and supplies an optional `onBack`. Positioning
+ * (e.g. over a shell/backstage) and any decoration (titles, watermarks) stay
+ * with the host, which can wrap this or pass a `title` slot.
+ *
+ * Composes kang's own `BackButton` + `SearchField`; `styled-components`, `react`
+ * and `@react-spring/web` are the only things it pulls in.
+ */
+import { useEffect } from 'react';
+import { styled } from 'styled-components';
+import { animated, useSpring } from '@react-spring/web';
+import BackButton from './back-button.js';
+import { SearchField } from './search-field.js';
+const Reveal = styled(animated.div) `
+	display: flex;
+	flex-direction: column;
+	gap: 0.5rem;
+	will-change: transform, opacity;
+`;
+const Row = styled.div `
+	display: flex;
+	align-items: center;
+	gap: 0.5rem;
+`;
+/** Lets the (explicitly-width-animated) SearchField fill the row beside the back button. */
+const FieldWrap = styled.div `
+	flex: 1 1 auto;
+	min-width: 0;
+`;
+export function SearchBar({ active, value, onChange, onBack, backAriaLabel = 'Back', placeholder, ariaLabel, title, className, }) {
+    const [reveal, revealApi] = useSpring(() => ({
+        y: -16,
+        opacity: 0,
+        display: 'none',
+    }));
+    useEffect(() => {
+        const config = { tension: 300, friction: 30 };
+        if (active) {
+            revealApi.start({ y: 0, opacity: 1, display: 'flex', config });
+        }
+        else {
+            revealApi.start({
+                y: -16,
+                opacity: 0,
+                config,
+                onRest: () => revealApi.set({ display: 'none' }),
+            });
+        }
+    }, [active, revealApi]);
+    return (_jsxs(Reveal, { className: className, style: {
+            opacity: reveal.opacity,
+            display: reveal.display,
+            transform: reveal.y.to((v) => `translateY(${v}px)`),
+        }, children: [title, _jsxs(Row, { children: [onBack && _jsx(BackButton, { onClick: onBack, ariaLabel: backAriaLabel }), _jsx(FieldWrap, { children: _jsx(SearchField, { value: value, onChange: onChange, placeholder: placeholder, ariaLabel: ariaLabel, autoExpand: active }, active ? 'open' : 'closed') })] })] }));
+}
+export default SearchBar;
+//# sourceMappingURL=search-bar.js.map

package/dist/search-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-bar.js","sourceRoot":"","sources":["../src/search-bar.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAqC,MAAM,OAAO,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiBhD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;;;;;CAKlC,CAAC;AAEF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;;;;CAIrB,CAAC;AAEF,4FAA4F;AAC5F,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAA;;;CAG3B,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,EACzB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,aAAa,GAAG,MAAM,EACtB,WAAW,EACX,SAAS,EACT,KAAK,EACL,SAAS,GACO;IAChB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC,EAAE,CAAC,EAAE;QACN,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,MAAyB;KAClC,CAAC,CAAC,CAAC;IAEJ,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACZ,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,KAAK,CAAC;gBACf,CAAC,EAAE,CAAC,EAAE;gBACN,OAAO,EAAE,CAAC;gBACV,MAAM;gBACN,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAChD,CAAC,CAAC;QACJ,CAAC;IACF,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAExB,OAAO,CACN,MAAC,MAAM,IACN,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;SACnD,aAEA,KAAK,EACN,MAAC,GAAG,eACF,MAAM,IAAI,KAAC,UAAU,IAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAI,EACpE,KAAC,SAAS,cAET,KAAC,WAAW,IAEX,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,IALb,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAM9B,GACS,IACP,IACE,CACT,CAAC;AACH,CAAC;AAED,eAAe,SAAS,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.2",
+	"version": "0.9.5",
 	"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",