panelui-native 0.13.0 → 0.14.0

package/lib/typescript/src/hooks/use-reveal-progress.d.ts

@@ -0,0 +1,56 @@
+/**
+ * useRevealProgress — how far an element has travelled through the viewport.
+ *
+ * The number every scroll-driven effect is really made of: `0` before the
+ * element has arrived, `1` once it has passed, and a smooth scrub between the
+ * two. What an effect *does* with it — recolour, fade, zoom, step through
+ * frames — is the only part that differs.
+ *
+ * The window is set the way a scroll-trigger's is: `start` and `end` are
+ * positions down the viewport, as fractions of its height. Progress is `0`
+ * while the element's **top** is still below `start`, and reaches `1` when its
+ * **bottom** passes `end` — so a tall block scrubs across its own height rather
+ * than snapping the moment its first line appears.
+ *
+ * ```tsx
+ * const { ref, progress } = useRevealProgress({ start: 0.9, end: 0.5 });
+ *
+ * <Animated.View ref={ref} style={useAnimatedStyle(() => ({
+ *   opacity: progress.value,
+ * }))} />
+ * ```
+ *
+ * The element is measured on the UI thread whenever the scroll position
+ * changes — not every frame, and not once at layout. Once is wrong the moment
+ * anything above it resizes; every frame is a measurement pass for a value that
+ * only changes when the scroller moves.
+ */
+import { type View } from 'react-native';
+import { type AnimatedRef, type SharedValue } from 'react-native-reanimated';
+export interface UseRevealProgressOptions {
+    /**
+     * Where down the viewport the element's top sits when progress is `0`, as a
+     * fraction of the viewport height. `0.9` starts it just before it appears.
+     */
+    start?: number;
+    /**
+     * Where down the viewport the element's bottom sits when progress reaches
+     * `1`. Smaller values mean a longer scrub.
+     */
+    end?: number;
+    /**
+     * Drive the effect from a value of your own instead of from the scroll
+     * position. Anything passed here is used as-is and nothing is measured.
+     */
+    progress?: SharedValue<number>;
+    /** Set false to hold progress at `1`, as though the element had passed. */
+    enabled?: boolean;
+}
+export interface UseRevealProgressResult {
+    /** Attach to the element whose travel drives the effect. */
+    ref: AnimatedRef<View>;
+    /** `0` before, `1` after, scrubbed between. */
+    progress: SharedValue<number>;
+}
+export declare function useRevealProgress({ start, end, progress: external, enabled, }?: UseRevealProgressOptions): UseRevealProgressResult;
+//# sourceMappingURL=use-reveal-progress.d.ts.map

package/lib/typescript/src/hooks/use-reveal-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-reveal-progress.d.ts","sourceRoot":"","sources":["../../../../src/hooks/use-reveal-progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,KAAW,EACX,GAAS,EACT,QAAQ,EAAE,QAAQ,EAClB,OAAc,GACf,GAAE,wBAA6B,GAAG,uBAAuB,CAoCzD"}

package/lib/typescript/src/index.d.ts

@@ -4,6 +4,7 @@ export { Portal, PortalHost, PortalProvider } from './primitives/portal.js';
 export { Text, type TextProps } from './primitives/text.js';
 export { KeyboardAvoider, type KeyboardAvoiderProps, } from './primitives/keyboard-avoider.js';
 export { AnimatedPressable, type AnimatedPressableProps, } from './primitives/animated-pressable.js';
+export { ScrollProgress, useScrollProgress, type ScrollProgressProps, type ScrollProgressValue, } from './primitives/scroll-progress.js';
 export { hasNativeUI } from './native/index.js';
 export { hasHaptics, selectionTick } from './utils/haptics.js';
 export { Accordion, type AccordionProps, type AccordionItemProps, type AccordionTriggerProps, type AccordionIndicatorProps, type AccordionContentProps, type AccordionVariant, type AccordionSelectionMode, } from './components/accordion/index.js';
@@ -16,11 +17,13 @@ export { Button, type ButtonProps } from './components/button/index.js';
 export { ToggleButton, ToggleButtonGroup, useToggleButton, type ToggleButtonProps, type ToggleButtonGroupProps, type ToggleButtonLabelProps, type ToggleButtonSize, type ToggleButtonVariant, type ToggleSelectionMode, } from './components/toggle-button/index.js';
 export { Dialog, type DialogProps, type DialogContentProps, } from './components/dialog/index.js';
 export { Frame, type FrameProps, type FrameRootProps, type FramePanelProps, type FrameRowProps, type FrameSectionProps, type FrameVariant, } from './components/frame/index.js';
+export { HeatmapChart, useHeatmapChart, buildHeatmapCalendar, type HeatmapChartProps, type HeatmapCellsProps, type HeatmapSeparatorProps, type HeatmapXAxisProps, type HeatmapYAxisProps, type HeatmapTooltipProps, type HeatmapLegendProps, type HeatmapColumn, type HeatmapBin, type HeatmapCell, type HeatmapLayout, } from './components/heatmap-chart/index.js';
 export { Select, type SelectProps, type SelectItemProps, type SelectPresentation, } from './components/select/index.js';
 export { SectionRail, type SectionRailProps, type SectionRailTriggerProps, type SectionRailBarProps, type SectionRailContentProps, type SectionRailItemProps, type SectionRailPlacement, type SectionRailAlign, } from './components/section-rail/index.js';
 export { Tabs, type TabsProps, type TabsListProps, type TabsTriggerProps, type TabsContentProps, } from './components/tabs/index.js';
 export { Card, type CardProps } from './components/card/index.js';
 export { Checkbox, type CheckboxProps } from './components/checkbox/index.js';
+export { Chip, useChip, type ChipProps, type ChipLabelProps, type ChipVariant, type ChipSize, } from './components/chip/index.js';
 export { EmptyState, type EmptyStateProps, type EmptyStateMediaProps, } from './components/empty-state/index.js';
 export { Input, type InputProps } from './components/input/index.js';
 export { InputGroup, type InputGroupProps, type InputGroupInputProps, type InputGroupDecoratorProps, } from './components/input-group/index.js';
@@ -36,6 +39,9 @@ export { RadioGroup, type RadioGroupProps, type RadioGroupItemProps, } from './c
 export { ScrollFade, type ScrollFadeProps, } from './components/scroll-fade/index.js';
 export { Separator, type SeparatorProps } from './components/separator/index.js';
 export { Shimmer, type ShimmerProps } from './components/shimmer/index.js';
+export { ScrollText, type ScrollTextProps, type ScrollTextEffect, type ScrollTextSplit, } from './components/scroll-text/index.js';
+export { ScrollCanvas, type ScrollCanvasProps, type ScrollCanvasEffect, } from './components/scroll-canvas/index.js';
+export { ThinkingOrb, type ThinkingOrbProps, type ThinkingOrbState, } from './components/thinking-orb/index.js';
 export { Skeleton, type SkeletonProps } from './components/skeleton/index.js';
 export { Slider, type SliderProps } from './components/slider/index.js';
 export { Spinner, type SpinnerProps } from './components/spinner/index.js';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,kCAA+B,CAAC;AAG3F,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,sBAAmB,CAAC;AAG3B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAqB,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAmB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,kCAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,oCAAiC,CAAC;AACzC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,iCAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAU,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAiB,CAAC;AAG5D,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,iCAAwB,CAAC;AAChC,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,mBAAmB,GACzB,MAAM,6BAAoB,CAAC;AAC5B,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,8BAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,kCAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,6BAAoB,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,oCAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,8BAAqB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,qCAA4B,CAAC;AACpC,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,8BAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,6BAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,qCAA4B,CAAC;AACpC,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,8BAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,oCAA2B,CAAC;AACnC,OAAO,EACL,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,4BAAmB,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,4BAAmB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAuB,CAAC;AACrE,OAAO,EACL,IAAI,EACJ,OAAO,EACP,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,4BAAmB,CAAC;AAC3B,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,mCAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,6BAAoB,CAAC;AAC5D,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,mCAA0B,CAAC;AAClC,OAAO,EACL,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,4BAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,6BAAoB,CAAC;AACjF,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,kCAAyB,CAAC;AACjC,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,8BAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,wCAA+B,CAAC;AACvC,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,+BAAsB,CAAC;AAC9B,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,+BAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAuB,CAAC;AACrE,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,mCAA0B,CAAC;AAClC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,mCAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iCAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAAsB,CAAC;AAClE,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,mCAA0B,CAAC;AAClC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,qCAA4B,CAAC;AACpC,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,oCAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAuB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,8BAAqB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAAsB,CAAC;AAClE,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,6BAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAAsB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,8BAAqB,CAAC;AAC/D,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,gCAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,EACL,aAAa,EACb,KAAK,EACL,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,6BAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,kCAAyB,CAAC;AAGjC,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,EACX,UAAU,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,EACf,OAAO,EACP,KAAK,EACL,YAAY,EACZ,KAAK,SAAS,GACf,MAAM,kBAAS,CAAC;AAGjB,cAAc,kBAAS,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,MAAM,eAAY,CAAC"}

package/lib/typescript/src/native/index.d.ts

@@ -5,13 +5,15 @@ interface NativeUIModule {
         /**
          * Whether the host resizes itself to the platform content.
          *
-         * Every control here gives the host an explicit height instead, and takes
-         * its width from ordinary layout. The measurement arrives a frame late and
-         * again whenever the platform's content changes, so a host left to work
-         * its own size out renders at nothing and then jumps — on first paint, and
-         * again on first press. The per-axis form does not help; the answer is not
-         * to ask. Only the natively-presented sheet still uses it, where the host
-         * is a zero-size anchor rather than the control itself.
+         * This is on for every control here, and it is the whole answer to the
+         * jump. Sizing the *host* and leaving the control unsized inside it hands
+         * the platform a box it never agreed to: it lays out against its own
+         * intrinsic size, and settles into the box on the first thing that forces
+         * a second pass — which for a button is the first press.
+         *
+         * The per-axis form is for a control with no intrinsic width, like a
+         * slider or a picker: the width comes from ordinary layout and only the
+         * height is reported back.
          */
         matchContents?: boolean | {
             vertical?: boolean;
@@ -30,6 +32,12 @@ interface NativeUIModule {
         matchContents?: boolean;
         style?: unknown;
     }>;
+    /**
+     * `style` here is not a React Native style — it is the small portable subset
+     * (`width`, `height`, padding, `backgroundColor`, `borderRadius`, `opacity`)
+     * that the toolkit compiles into real SwiftUI and Compose modifiers. It is
+     * how a control is given a definite size without the host having to guess.
+     */
     Button: ComponentType<Record<string, unknown>>;
     Switch: ComponentType<Record<string, unknown>>;
     Slider: ComponentType<Record<string, unknown>>;

package/lib/typescript/src/native/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/native/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,UAAU,cAAc;IACtB,IAAI,EAAE,aAAa,CAAC;QAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB;;;;;;;;;;WAUG;QACH,aAAa,CAAC,EAAE,OAAO,GAAG;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QACvE,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;IACH;;;;OAIG;IACH,UAAU,EAAE,aAAa,CAAC;QACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;QAC/C,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC9C,CAAC;IACF,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,cAAc,GAAG,IAAI,CAgBnD;AAED,gEAAgE;AAChE,wBAAgB,WAAW,IAAI,OAAO,CAErC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/native/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,UAAU,cAAc;IACtB,IAAI,EAAE,aAAa,CAAC;QAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB;;;;;;;;;;;;WAYG;QACH,aAAa,CAAC,EAAE,OAAO,GAAG;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QACvE,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;IACH;;;;OAIG;IACH,UAAU,EAAE,aAAa,CAAC;QACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH;;;;;OAKG;IACH,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;QAC/C,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC9C,CAAC;IACF,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,cAAc,GAAG,IAAI,CAgBnD;AAED,gEAAgE;AAChE,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/lib/typescript/src/primitives/keyboard-avoider.d.ts

@@ -1,12 +1,28 @@
 /**
- * KeyboardAvoider — a view that lifts itself just clear of the keyboard.
+ * KeyboardAvoider — a view that keeps itself clear of the keyboard.
  *
  * A thin wrapper over `useKeyboardAvoidance` for the common case of "keep this
  * box visible", so a form does not have to wire the ref, layout handler and
  * animated style by hand.
+ *
+ * ```tsx
+ * // In the flow of a scrolling page: lifts by the overlap, follows the scroll.
+ * <KeyboardAvoider active={focused}>…</KeyboardAvoider>
+ *
+ * // Pinned to the bottom edge: rides the keyboard up and back down.
+ * <KeyboardAvoider
+ *   mode="dock"
+ *   bottomInset={insets.bottom}
+ *   className="absolute left-0 right-0"
+ *   style={{ bottom: insets.bottom + 16 }}
+ * >
+ *   …
+ * </KeyboardAvoider>
+ * ```
  */
 import type { ReactNode } from 'react';
 import type { ViewProps } from 'react-native';
+import { type KeyboardAvoidanceMode } from '../hooks/use-keyboard-avoidance.js';
 export interface KeyboardAvoiderProps extends ViewProps {
     className?: string;
     /** Set false to leave the content where it is. */
@@ -18,11 +34,22 @@ export interface KeyboardAvoiderProps extends ViewProps {
      * screen stay put.
      */
     active?: boolean;
-    /** Gap to keep between the content's bottom edge and the keyboard. */
+    /**
+     * `lift` moves in-flow content up by its overlap with the keyboard and keeps
+     * tracking it as the page scrolls. `dock` travels with the keyboard, for a
+     * bar already pinned near the bottom edge.
+     */
+    mode?: KeyboardAvoidanceMode;
+    /** Gap to keep between the content's bottom edge and the keyboard. `lift` only. */
     offset?: number;
+    /**
+     * How far above the bottom edge the bar already sits — usually the safe area
+     * inset it is positioned by. `dock` only.
+     */
+    bottomInset?: number;
     children?: ReactNode;
 }
-export declare function KeyboardAvoider({ className, enabled, active, offset, children, style, onLayout, ...props }: KeyboardAvoiderProps): import("react").JSX.Element;
+export declare function KeyboardAvoider({ className, enabled, active, mode, offset, bottomInset, children, style, onLayout, ...props }: KeyboardAvoiderProps): import("react").JSX.Element;
 export declare namespace KeyboardAvoider {
     var displayName: string;
 }

package/lib/typescript/src/primitives/keyboard-avoider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard-avoider.d.ts","sourceRoot":"","sources":["../../../../src/primitives/keyboard-avoider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,OAAc,EACd,MAAa,EACb,MAAW,EACX,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,oBAAoB,+BAiBtB;yBA1Be,eAAe"}
+{"version":3,"file":"keyboard-avoider.d.ts","sourceRoot":"","sources":["../../../../src/primitives/keyboard-avoider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,oCAAiC,CAAC;AAEzC,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,OAAc,EACd,MAAa,EACb,IAAa,EACb,MAAW,EACX,WAAe,EACf,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,oBAAoB,+BAuBtB;yBAlCe,eAAe"}

package/lib/typescript/src/primitives/scroll-progress.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ScrollProgress — publishes a scroll container's position so children can
+ * animate against it.
+ *
+ * Scroll-driven effects all need the same two numbers: where the scroller is,
+ * and how tall its viewport is. Every component that wanted them measuring for
+ * itself would mean one scroll listener per effect and one measurement pass per
+ * effect per frame, for two values that are the same for all of them.
+ *
+ * It wraps the scroll view you already have rather than replacing it — the
+ * child is cloned with an animated scroll handler composed onto it, the same
+ * way `ScrollFade` does — so a `FlatList`, a `SectionList` or your own
+ * scrollable all work, and nothing has to be rewritten to adopt it.
+ *
+ * ```tsx
+ * <ScrollProgress>
+ *   <ScrollView>
+ *     <ScrollText>…</ScrollText>
+ *   </ScrollView>
+ * </ScrollProgress>
+ * ```
+ *
+ * Both values are shared values, so the whole chain from scroll event to
+ * animated style stays on the UI thread and nothing re-renders as you scroll.
+ */
+import { type ReactNode } from 'react';
+import { type ViewProps } from 'react-native';
+import { type SharedValue } from 'react-native-reanimated';
+export interface ScrollProgressValue {
+    /** Distance scrolled, in pixels. */
+    offset: SharedValue<number>;
+    /** Height of the visible area. */
+    viewport: SharedValue<number>;
+    /** Total height of the content. */
+    content: SharedValue<number>;
+    /**
+     * Window-space top edge of the scroller. What turns an element's measured
+     * `pageY` into a position inside *this* viewport rather than the screen's —
+     * they differ by whatever sits above the scroller, and assuming they do not
+     * is why scroll effects drift under a header.
+     */
+    top: SharedValue<number>;
+}
+/**
+ * The nearest enclosing scroll container's position, or `null` outside one.
+ *
+ * It returns null rather than throwing because every consumer of this also
+ * takes an explicit `progress` prop — a component that can be driven by hand
+ * should not insist on a provider it does not need.
+ */
+export declare function useScrollProgress(): ScrollProgressValue | null;
+export interface ScrollProgressProps extends ViewProps {
+    className?: string;
+    /** Exactly one scrollable — a ScrollView, FlatList, or anything like them. */
+    children?: ReactNode;
+}
+export declare function ScrollProgress({ className, children, ...props }: ScrollProgressProps): import("react").JSX.Element;
+export declare namespace ScrollProgress {
+    var displayName: string;
+}
+//# sourceMappingURL=scroll-progress.d.ts.map

package/lib/typescript/src/primitives/scroll-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-progress.d.ts","sourceRoot":"","sources":["../../../../src/primitives/scroll-progress.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EASL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAiB,EAKf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,mCAAmC;IACnC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1B;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,GAAG,IAAI,CAE9D;AASD,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,+BA6EpF;yBA7Ee,cAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panelui-native",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "High-performance React Native UI components for Expo. Semantic design tokens, powered by Uniwind (Tailwind v4) and Reanimated.",
   "main": "./lib/module/index.js",
   "module": "./lib/module/index.js",

package/src/components/button/index.tsx

@@ -115,22 +115,23 @@ export interface ButtonProps
    * `primary`/`destructive` → filled, `outline` → outlined, everything else
    * → text; `size` sets the height.
    *
-   * A native button **fills the width it is given**, because the host is told
-   * its size rather than left to measure the platform's content — which is
-   * what made it collapse and then jump on first press. Put it in a row to
-   * share the width, or in a narrower parent to shrink it.
+   * A native button **sizes itself to its label**, the way a platform button
+   * is supposed to. It does not stretch to fill its container, and `fullWidth`
+   * has no effect on it.
    */
   native?: boolean;
 }
 
 /**
- * Height given to the native host, matching the styled scale above.
+ * Height given to the platform button, matching the styled scale above.
  *
- * The host is told its size rather than asked to work it out. `matchContents`
- * measures the platform's own content a frame late and again when that content
- * changes — so the button renders at nothing, collapses against whatever sits
- * above it, and jolts into place on the first press. Width comes from ordinary
- * layout instead, which is why a native button fills its container.
+ * It goes on the button rather than on the host, and that distinction is the
+ * whole fix for the jump. A host sized to a number with an unsized control
+ * inside it hands the platform a box the control never agreed to: SwiftUI and
+ * Compose both lay out against their own intrinsic size and only settle into
+ * the box when something forces a second pass — which for a button is the
+ * first press. Given a definite height of its own, the button has nothing left
+ * to recompute, and the host follows it with `matchContents`.
  */
 const NATIVE_HEIGHT: Record<NonNullable<ButtonVariantProps['size']>, number> = {
   sm: 36,
@@ -199,11 +200,12 @@ export const Button = forwardRef<View, ButtonProps>(
       const isStringLabel = typeof children === 'string';
 
       return (
-        <Host style={{ height: NATIVE_HEIGHT[size ?? 'md'] }}>
+        <Host matchContents>
           <NativeButton
             label={isStringLabel ? children : undefined}
             variant={NATIVE_VARIANT[variant ?? 'primary']}
             disabled={isDisabled}
+            style={{ height: NATIVE_HEIGHT[size ?? 'md'] }}
             onPress={props.onPress}
           >
             {/* Non-string children are React Native views, and the native

package/src/components/frame/index.tsx

@@ -1,23 +1,29 @@
 /**
- * Frame — a widget shell: a titled surface wrapping an inset panel of rows,
- * with an optional action on the header row and a caption underneath.
+ * Frame — a widget shell: a card of rows sitting in a tray, with the tray's
+ * one exposed strip along the top carrying the title.
  *
- * Layout follows the nested-radius rule (inner radius = outer radius minus the
- * gap between them), which is why the panel is `rounded-xl` inside a
- * `rounded-2xl` shell. Since v0.4.0 the radius scale is theme-scoped, so this
- * relationship holds while the absolute values change per theme.
+ * The two surfaces are nested rather than stacked, and only one edge of the
+ * outer one is ever visible. The panel is flush to the shell's left, right and
+ * bottom, so the shell reads as something the card is *sitting in* rather than
+ * as a border around it — and the strip left at the top is the header, which
+ * is why the header needs no rule under it and no background of its own.
+ *
+ * The shell's radius is the larger of the two, and the panel's top corners are
+ * tighter. That is the reverse of the usual nested-radius rule, and it is
+ * deliberate: with only the top corners free, matching them would make the two
+ * surfaces read as one misdrawn shape. The panel's bottom corners are not set
+ * at all — the shell clips them, so they take its radius exactly.
  *
  * ```tsx
  * <Frame>
  *   <Frame.Header>
- *     <Frame.Title>Usage Type</Frame.Title>
- *     <Frame.Action>Amount</Frame.Action>
+ *     <Frame.Title>Agent monitor</Frame.Title>
+ *     <Frame.Action>All agents under 25% token limit</Frame.Action>
  *   </Frame.Header>
  *   <Frame.Panel>
  *     <Frame.Row>…</Frame.Row>
  *     <Frame.Row>…</Frame.Row>
  *   </Frame.Panel>
- *   <Frame.Footer>Updated 2 minutes ago</Frame.Footer>
  * </Frame>
  * ```
  *
@@ -41,15 +47,24 @@ import { cn } from '../../utils/cn';
 const frameVariants = tv({
   slots: {
     root: '',
-    panel: 'overflow-hidden rounded-xl border border-border bg-card',
+    // Flush left, right and bottom: no side or bottom border, because the
+    // shell's own edge is already there, and no bottom radius, because the
+    // shell clips it. Only the top corners and the rule under the header are
+    // the panel's to draw.
+    panel: 'overflow-hidden rounded-t-2xl border-t border-border bg-card',
   },
   variants: {
     variant: {
-      default: { root: 'rounded-2xl border border-border bg-surface p-1.5' },
+      // `overflow-hidden` is load-bearing — it is what makes the panel's
+      // bottom corners take the shell's radius instead of squaring off
+      // against it.
+      default: {
+        root: 'overflow-hidden rounded-3xl border border-border bg-surface',
+      },
       // No shell: the panel is the whole widget. For a Frame nested inside a
       // card that already draws a border, where the shell's own edge sitting
       // just inside it reads as a double line.
-      plain: { root: '', panel: 'rounded-2xl' },
+      plain: { root: '', panel: 'rounded-3xl border border-border' },
     },
   },
   defaultVariants: {
@@ -83,15 +98,16 @@ export interface FrameHeaderProps extends FrameProps {
 }
 
 /**
- * The header row: title on the left, `Frame.Action` on the right. Add
- * `className="flex-col items-start"` when you want a description underneath.
+ * The header row — the strip of shell left exposed above the panel. Title on
+ * the left, `Frame.Action` on the right. Add `className="flex-col items-start"`
+ * when you want a description underneath.
  */
 const FrameHeader = forwardRef<View, FrameHeaderProps>(
   ({ className, ...props }, ref) => (
     <View
       ref={ref}
       className={cn(
-        'flex-row items-center justify-between gap-3 px-3 pb-2.5 pt-2',
+        'flex-row items-center justify-between gap-3 px-4 pb-3 pt-2.5',
         className
       )}
       {...props}
@@ -100,14 +116,12 @@ const FrameHeader = forwardRef<View, FrameHeaderProps>(
 );
 FrameHeader.displayName = 'Frame.Header';
 
+/**
+ * Muted by default. The header is a caption on the tray the card sits in, not
+ * a heading over a section — the card's own rows carry the weight.
+ */
 const FrameTitle = forwardRef<RNText, TextProps>(({ className, ...props }, ref) => (
-  <Text
-    ref={ref}
-    size="base"
-    weight="medium"
-    className={cn('text-foreground', className)}
-    {...props}
-  />
+  <Text ref={ref} size="sm" muted className={className} {...props} />
 ));
 FrameTitle.displayName = 'Frame.Title';
 
@@ -123,7 +137,7 @@ const FrameAction = forwardRef<View, FrameActionProps>(
   ({ className, children, ...props }, ref) => (
     <View ref={ref} className={cn('flex-row items-center gap-2', className)} {...props}>
       {typeof children === 'string' ? (
-        <Text size="base" muted>
+        <Text size="sm" muted>
           {children}
         </Text>
       ) : (
@@ -177,8 +191,8 @@ export interface FramePanelProps extends FrameProps {
 }
 
 /**
- * The inset card holding the frame's content — the raised surface sitting in
- * from the shell's edges, with its own smaller radius.
+ * The card holding the frame's content — flush to the shell on three sides,
+ * with the header strip above it.
  */
 const FramePanel = forwardRef<View, FramePanelProps>(
   ({ className, dividers = true, children, ...props }, ref) => (
@@ -284,30 +298,6 @@ FrameSection.displayName = 'Frame.Section';
 /** Parts the panel divides. Declared after them, since it holds references. */
 const DIVIDABLE = new Set<unknown>([FrameRow, FrameSection]);
 
-export interface FrameFooterProps extends FrameProps {
-  children?: ReactNode;
-}
-
-/** Muted caption under the panel. Strings are wrapped for you. */
-const FrameFooter = forwardRef<View, FrameFooterProps>(
-  ({ className, children, ...props }, ref) => (
-    <View
-      ref={ref}
-      className={cn('flex-row items-center gap-2 px-3 pb-1.5 pt-2.5', className)}
-      {...props}
-    >
-      {typeof children === 'string' ? (
-        <Text size="sm" muted>
-          {children}
-        </Text>
-      ) : (
-        children
-      )}
-    </View>
-  )
-);
-FrameFooter.displayName = 'Frame.Footer';
-
 export const Frame = Object.assign(FrameRoot, {
   Header: FrameHeader,
   Title: FrameTitle,
@@ -316,5 +306,4 @@ export const Frame = Object.assign(FrameRoot, {
   Panel: FramePanel,
   Section: FrameSection,
   Row: FrameRow,
-  Footer: FrameFooter,
 });