panelui-native 0.87.0 → 0.88.0

package/lib/typescript/src/components/bubble-chart/index.d.ts

@@ -127,19 +127,70 @@ export interface BubbleChartHandle {
     replay: () => void;
 }
 export interface BubbleChartGridProps {
-    /** Horizontal rules across the plot. */
+    /**
+     * Horizontal rules across the plot.
+     *
+     * Eight, which is twice the four intervals an axis is divided into by
+     * default, so every second line carries a number and the ones between it are
+     * halves of a labelled step rather than an unrelated rhythm. Squares this
+     * size recede behind the circles; the coarse grid a smaller number draws
+     * reads as blocks laid over the plot.
+     */
     rows?: number;
     /** Vertical rules up it. Both axes are measured, so both earn lines. */
     columns?: number;
+    /** Dash pattern for the rules. Pass `undefined` for solid ones. */
+    dashArray?: string;
     color?: string;
     opacity?: number;
 }
 /** Reference lines both ways, so a bubble can be placed against two numbers. */
-declare function BubbleChartGrid({ rows, columns, color, opacity, }: BubbleChartGridProps): import("react").JSX.Element;
+declare function BubbleChartGrid({ rows, columns, dashArray, color, opacity, }: BubbleChartGridProps): import("react").JSX.Element;
 declare namespace BubbleChartGrid {
     var displayName: string;
     var layer: Layer;
 }
+export interface BubbleChartTrendProps {
+    /**
+     * The line's slope and intercept, and how tightly the cloud sits on it, once
+     * they have been computed. `r` runs 0 to 1: 1 is every bubble on the line,
+     * 0 is a cloud with no direction at all.
+     *
+     * Given here rather than left for the caller to work out, because the fit is
+     * already being computed to draw the line and doing it twice invites the two
+     * answers to disagree.
+     *
+     * It fires when the numbers change, not on every render that produced the
+     * same ones, so putting the fit straight into state is safe.
+     */
+    onFit?: (fit: {
+        slope: number;
+        intercept: number;
+        r: number;
+    }) => void;
+    color?: string;
+    strokeWidth?: number;
+    /** Dash pattern. Dashed by default: the line is a reading, not a measurement. */
+    dashArray?: string;
+    opacity?: number;
+}
+/**
+ * The straight line that fits the cloud best, drawn across the plot.
+ *
+ * It is dashed and drawn under the circles, because it is not data — it is a
+ * summary of the data, and a solid rule through the middle of a field of
+ * bubbles reads as a value somebody plotted.
+ *
+ * The fit is least squares on the raw values, so it moves with the data rather
+ * than with the frame: resizing the chart never changes the line's meaning.
+ * Fewer than two bubbles, or every bubble on one vertical, has no line to draw
+ * and none is drawn.
+ */
+declare function BubbleChartTrend({ onFit, color, strokeWidth, dashArray, opacity, }: BubbleChartTrendProps): import("react").JSX.Element | null;
+declare namespace BubbleChartTrend {
+    var displayName: string;
+    var layer: Layer;
+}
 export interface BubbleChartBubblesProps {
     /**
      * Fill opacity. Below 1 by default so that overlapping bubbles read as
@@ -206,11 +257,86 @@ declare namespace BubbleChartLabels {
     var displayName: string;
     var layer: Layer;
 }
+export interface BubbleChartQuadrantsProps {
+    /** Where the vertical rule stands. Defaults to the mean of the x values. */
+    x?: number;
+    /** Where the horizontal rule lies. Defaults to the mean of the y values. */
+    y?: number;
+    /** A word for each corner, written in the corner it belongs to. */
+    labels?: {
+        topLeft?: string;
+        topRight?: string;
+        bottomLeft?: string;
+        bottomRight?: string;
+    };
+    /** Tint the high-high and low-low corners. On by default. */
+    tint?: boolean;
+    color?: string;
+    className?: string;
+}
+/**
+ * A crosshair splitting the plot into four, with a name for each corner.
+ *
+ * A field of bubbles is usually read as four groups rather than as a cloud —
+ * which of these is doing well on both counts, which on neither — and without
+ * a divider the reader draws that line by eye, in a different place each time.
+ * Putting it on the chart makes it one line everybody sees.
+ *
+ * It stands at the mean of each axis by default, because that is the split the
+ * data itself argues for. Pass `x` and `y` for a target, a budget or last
+ * year's number — a threshold somebody decided rather than one the data
+ * produced.
+ *
+ * The tint marks the two corners a reading usually ends at. Turn it off where
+ * all four corners matter equally.
+ */
+declare function BubbleChartQuadrants({ x, y, labels, tint, color, className, }: BubbleChartQuadrantsProps): import("react").JSX.Element | null;
+declare namespace BubbleChartQuadrants {
+    var displayName: string;
+    var layer: Layer;
+}
+export interface BubbleChartSizeKeyProps {
+    /** Which corner of the plot it sits in. */
+    placement?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /** Turn a value into its label. Defaults to a compact number. */
+    format?: (value: number) => string;
+    /** A word for what the area means — "people", "revenue". */
+    label?: string;
+    className?: string;
+}
+/**
+ * Three nested circles saying what a bubble's area is worth.
+ *
+ * A bubble chart's third quantity is the one it cannot state: position can be
+ * read off the axes, but area has no axis, so a reader can see that one circle
+ * is bigger than another and has no way to know by how much. This is the only
+ * part of the chart that answers that.
+ *
+ * Nested and sharing a baseline, which is how a difference in area is compared
+ * — three circles in a row are three sizes, three circles inside one another
+ * are one scale.
+ *
+ * It needs a `sizeKey` on the chart. Without one every bubble is the same size
+ * and there is no scale to key.
+ */
+declare function BubbleChartSizeKey({ placement, format, label, className, }: BubbleChartSizeKeyProps): import("react").JSX.Element | null;
+declare namespace BubbleChartSizeKey {
+    var displayName: string;
+    var layer: Layer;
+}
 export interface BubbleChartXAxisProps {
-    /** How many intervals to divide the axis into. Yields `ticks + 1` labels. */
+    /**
+     * How many intervals to divide the axis into. Yields `ticks + 1` labels.
+     *
+     * Four, and the domain is rounded out to four steps to match, so the numbers
+     * come out round. Fewer leaves most of the grid unnamed — a line with nothing
+     * beside it is a line the reader has to count their way to.
+     */
     ticks?: number;
     /** Turn a value into its label. Defaults to a compact number. */
     format?: (value: number) => string;
+    /** What the axis measures, written under the numbers. */
+    label?: string;
     className?: string;
 }
 /**
@@ -219,20 +345,34 @@ export interface BubbleChartXAxisProps {
  * Evenly spaced, because this axis is a continuous scale rather than a list of
  * rows. There is no bubble for a label to sit under.
  */
-declare function BubbleChartXAxis({ ticks, format, className }: BubbleChartXAxisProps): import("react").JSX.Element;
+declare function BubbleChartXAxis({ ticks, format, label, className }: BubbleChartXAxisProps): import("react").JSX.Element;
 declare namespace BubbleChartXAxis {
     var displayName: string;
     var layer: Layer;
+    var axis: "x";
 }
 export interface BubbleChartYAxisProps {
-    /** How many intervals to divide the axis into. Yields `ticks + 1` labels. */
+    /**
+     * How many intervals to divide the axis into. Yields `ticks + 1` labels.
+     *
+     * Four, matching the four steps the domain is rounded out to and every second
+     * line of the default grid.
+     */
     ticks?: number;
     /** Turn a value into its label. Defaults to a compact number. */
     format?: (value: number) => string;
+    /** What the axis measures, written up the side of it. */
+    label?: string;
     className?: string;
 }
-/** Value labels down the side, one per grid line. Reserves its own gutter. */
-declare function BubbleChartYAxis({ ticks, format, className }: BubbleChartYAxisProps): import("react").JSX.Element;
+/**
+ * Value labels down the side, evenly over the axis, and the gutter they sit in.
+ *
+ * They land on every second line of the default grid rather than on all of
+ * them: a number beside every line of a grid fine enough to read against is a
+ * column of numbers, and the reader stops seeing the chart.
+ */
+declare function BubbleChartYAxis({ ticks, format, label, className }: BubbleChartYAxisProps): import("react").JSX.Element;
 declare namespace BubbleChartYAxis {
     var displayName: string;
     var layer: Layer;
@@ -326,8 +466,11 @@ declare namespace BubbleChartHeader {
 export declare const BubbleChart: import("react").ForwardRefExoticComponent<BubbleChartProps & import("react").RefAttributes<BubbleChartHandle>> & {
     Header: typeof BubbleChartHeader;
     Grid: typeof BubbleChartGrid;
+    Quadrants: typeof BubbleChartQuadrants;
+    Trend: typeof BubbleChartTrend;
     Bubbles: typeof BubbleChartBubbles;
     Labels: typeof BubbleChartLabels;
+    SizeKey: typeof BubbleChartSizeKey;
     Skeleton: typeof BubbleChartSkeleton;
     XAxis: typeof BubbleChartXAxis;
     YAxis: typeof BubbleChartYAxis;

package/lib/typescript/src/components/bubble-chart/index.d.ts.map

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

package/lib/typescript/src/components/feedback-dialog/index.d.ts

@@ -0,0 +1,156 @@
+/**
+ * FeedbackDialog — a dialog whose body is something to write in, and whose
+ * actions sit in a band around it.
+ *
+ * ```tsx
+ * <FeedbackDialog open={open} onOpenChange={setOpen}>
+ *   <FeedbackDialog.Content>
+ *     <FeedbackDialog.Panel>
+ *       <FeedbackDialog.Title>Help us improve, Gabe!</FeedbackDialog.Title>
+ *       <FeedbackDialog.Close />
+ *       <FeedbackDialog.Field value={text} onChangeText={setText} />
+ *     </FeedbackDialog.Panel>
+ *     <FeedbackDialog.Footer>
+ *       <FeedbackDialog.Cancel />
+ *       <FeedbackDialog.Submit onPress={send} />
+ *     </FeedbackDialog.Footer>
+ *   </FeedbackDialog.Content>
+ * </FeedbackDialog>
+ * ```
+ *
+ * ## Why the panel is a panel and not the dialog
+ *
+ * A dialog that asks for a sentence has two jobs on screen at once: hold what
+ * is being written, and offer the two things to do with it. `Dialog` puts both
+ * on one surface, which is right when the body is a line of prose — nothing
+ * about it says "this is where you type".
+ *
+ * Here the writing surface is a well set into the dialog, and the buttons sit
+ * in the band around it. The recess is the whole affordance: it says the field
+ * is the page and everything else is the frame around it, before a word has
+ * been read. It is also why the field has no border of its own — an outline
+ * inside a well is two edges saying the same thing.
+ *
+ * ## The actions are equal, and one of them is not
+ *
+ * Cancel and Submit take the same width, because they are the same size of
+ * decision — this is a sentence somebody wrote, not a deletion. What separates
+ * them is weight: Submit is filled in the foreground colour and Cancel is a
+ * tint of it, so the difference is legible at a glance without either being
+ * hidden.
+ *
+ * ## Nothing is submitted empty
+ *
+ * `Submit` disables itself while the field is empty. A dialog that accepts an
+ * empty answer produces empty feedback, and the person who sent it believes
+ * they said something.
+ */
+import { type ReactElement, type ReactNode } from 'react';
+import { TextInput, View, type TextInputProps, type ViewProps } from 'react-native';
+import { type TextProps } from '../../primitives/text.js';
+export interface FeedbackDialogProps {
+    children: ReactNode;
+    /** Controlled open state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Initial state when uncontrolled. */
+    defaultOpen?: boolean;
+    /** The message, when the caller holds it. Leave unset to let the field keep it. */
+    value?: string;
+    /** Starting message for an uncontrolled field. Ignored once `value` is passed. */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+}
+declare function FeedbackDialogRoot({ children, open, onOpenChange, defaultOpen, value, defaultValue, onValueChange, }: FeedbackDialogProps): import("react").JSX.Element;
+declare namespace FeedbackDialogRoot {
+    var displayName: string;
+}
+interface FeedbackDialogTriggerProps {
+    children: ReactElement<{
+        onPress?: (...args: unknown[]) => void;
+    }>;
+}
+/** Wraps its child and opens the dialog on press. */
+declare function FeedbackDialogTrigger({ children }: FeedbackDialogTriggerProps): import("react").JSX.Element;
+declare namespace FeedbackDialogTrigger {
+    var displayName: string;
+}
+export interface FeedbackDialogContentProps extends ViewProps {
+    className?: string;
+    /** Whether tapping outside or pressing back closes it. */
+    dismissible?: boolean;
+    /** Frost the screen behind instead of dimming it. Needs `expo-blur`. */
+    blur?: boolean;
+    children?: ReactNode;
+}
+/** The shell: the recessed band, and everything laid in it. */
+declare function FeedbackDialogContent({ className, dismissible, blur, children, ...props }: FeedbackDialogContentProps): import("react").JSX.Element | null;
+declare namespace FeedbackDialogContent {
+    var displayName: string;
+}
+export interface FeedbackDialogPanelProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+export interface FeedbackDialogCloseProps extends ViewProps {
+    className?: string;
+    /** How the ✕ announces itself. */
+    label?: string;
+    /** Runs instead of closing. Call `onOpenChange` yourself if you pass this. */
+    onPress?: () => void;
+}
+/** The ✕ in the panel's corner. */
+declare function FeedbackDialogClose({ className, label, onPress, ...props }: FeedbackDialogCloseProps): import("react").JSX.Element;
+declare namespace FeedbackDialogClose {
+    var displayName: string;
+}
+export interface FeedbackDialogFieldProps extends Omit<TextInputProps, 'value' | 'onChangeText'> {
+    className?: string;
+    /** The message. Leave unset to let the dialog hold it. */
+    value?: string;
+    onChangeText?: (value: string) => void;
+    /** Room to write in before the field starts growing. */
+    minHeight?: number;
+}
+export interface FeedbackDialogFooterProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+export interface FeedbackDialogActionProps extends ViewProps {
+    className?: string;
+    labelClassName?: string;
+    disabled?: boolean;
+    onPress?: () => void;
+    children?: ReactNode;
+}
+/** Discards and closes. Give it `onPress` to do something else first. */
+declare function FeedbackDialogCancel({ children, onPress, ...props }: FeedbackDialogActionProps): import("react").JSX.Element;
+declare namespace FeedbackDialogCancel {
+    var displayName: string;
+}
+export interface FeedbackDialogSubmitProps extends FeedbackDialogActionProps {
+    /**
+     * Hand the message to the caller. The dialog does not close itself here —
+     * sending usually has to finish first, and a dialog that closed on the press
+     * would take its own error message with it.
+     */
+    onSubmit?: (value: string) => void;
+}
+/** Sends. Inert while the field is empty. */
+declare function FeedbackDialogSubmit({ children, disabled, onPress, onSubmit, ...props }: FeedbackDialogSubmitProps): import("react").JSX.Element;
+declare namespace FeedbackDialogSubmit {
+    var displayName: string;
+}
+export declare const FeedbackDialog: typeof FeedbackDialogRoot & {
+    Trigger: typeof FeedbackDialogTrigger;
+    Content: typeof FeedbackDialogContent;
+    Panel: import("react").ForwardRefExoticComponent<FeedbackDialogPanelProps & import("react").RefAttributes<View>>;
+    Title: import("react").ForwardRefExoticComponent<TextProps & import("react").RefAttributes<import("react-native").Text>>;
+    Close: typeof FeedbackDialogClose;
+    Field: import("react").ForwardRefExoticComponent<FeedbackDialogFieldProps & import("react").RefAttributes<TextInput>>;
+    Footer: import("react").ForwardRefExoticComponent<FeedbackDialogFooterProps & import("react").RefAttributes<View>>;
+    Cancel: typeof FeedbackDialogCancel;
+    Submit: typeof FeedbackDialogSubmit;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/feedback-dialog/index.d.ts.map

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

package/lib/typescript/src/components/scroll-blur/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ScrollBlur — blurs the edges of a scroll container.
+ *
+ * Content that runs past a boundary reads better receding than being cut off,
+ * and a receding edge doubles as an affordance: an edge that is going soft is
+ * an edge with more content behind it.
+ *
+ * A blur says that where a fade cannot: a fade takes the content towards the
+ * colour behind the scroller, so it only works where that colour is known and
+ * flat. A blur takes it out of focus instead, which is true over a photograph,
+ * a gradient, or a list of coloured cards. It is also what belongs under
+ * something laid *over* the scroller — a button, a header, a search field —
+ * because the content passing beneath stays visible as shape and colour while
+ * losing the detail that would compete with the thing on top.
+ *
+ * ```tsx
+ * <ScrollBlur>
+ *   <ScrollView>…</ScrollView>
+ * </ScrollBlur>
+ * ```
+ *
+ * ## The ramp is a stack and a wash, because neither alone is smooth
+ *
+ * A blur that goes from nothing to full across a band needs a per-pixel blur
+ * radius, and there is no such thing on either platform — a blur view has one
+ * strength for its whole rectangle.
+ *
+ * So the ramp is built out of several of them: each layer covers a shorter
+ * span than the last, measured from the edge, and each blurs what the layer
+ * under it has already blurred. The spans are spaced on a curve rather than
+ * evenly, which puts most of the layers in the outer third where the blur is
+ * changing fastest and the steps would otherwise be widest.
+ *
+ * That alone is not enough. Every layer has a hard edge, and a stack of hard
+ * edges is a stack of visible lines however many there are. So a gradient of
+ * `color` is washed over the top — opaque at the outer edge, clear at the
+ * inner one. It hides the seams, and it is what makes the band read as one
+ * material rather than as a pile of rectangles: the content goes soft and
+ * fades into the surface at the same time, which is what the eye expects an
+ * edge to do.
+ *
+ * That wash is why `color` matters even when the blur is drawn. Give it the
+ * surface the scrollable actually sits on — a sheet, a card, the page — or the
+ * band fades towards a colour that is not there.
+ *
+ * ## Where it cannot blur, it fades
+ *
+ * A real blur needs a native view. `expo-blur` is optional, and Reduce
+ * Transparency is a preference that outranks the design, so both cases fall
+ * back to a gradient towards `color` — the same thing `ScrollFade` draws. A
+ * blur you cannot draw is better shown as a fade than as a hard edge, and far
+ * better than as a crash.
+ *
+ * Because of that fallback, pass `color` whenever the scroller does not sit on
+ * the theme background. It is unused in the blurred case and the whole effect
+ * in the other one.
+ *
+ * Scroll position, content size and viewport size are held in shared values
+ * and read on the UI thread, so scrolling never re-renders React.
+ */
+import { type ReactNode } from 'react';
+import { type ViewProps } from 'react-native';
+/** Which way the material tints. `default` follows the app's theme. */
+export type ScrollBlurTint = 'light' | 'dark' | 'default';
+export interface ScrollBlurProps extends ViewProps {
+    className?: string;
+    /** Depth of the blurred band in pixels. */
+    size?: number;
+    /** Which edges blur. */
+    edges?: 'both' | 'start' | 'end' | 'none';
+    /**
+     * Scroll axis. Inferred from the child's `horizontal` prop when omitted —
+     * pass it explicitly for children that scroll horizontally without that prop
+     * (a `FlatList` with `horizontal` set through `contentContainerStyle`, say).
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * How many blur views make up the ramp. More is smoother and costs more; the
+     * band shows visible steps below four, and past eight nobody can tell.
+     */
+    layers?: number;
+    /** Blur strength at the very edge, 0–100. The layers share it between them. */
+    intensity?: number;
+    /**
+     * Which way the material tints. Defaults to the app's theme rather than the
+     * phone's, so an app running dark on a light phone does not blur light.
+     */
+    material?: ScrollBlurTint;
+    /**
+     * The colour the band fades towards — washed over the blur, and the whole
+     * effect where there is no blur to draw.
+     *
+     * Defaults to the theme's background. Pass the surface the scrollable
+     * actually sits on, or the band fades towards a colour that is not there.
+     */
+    color?: string;
+    /**
+     * How opaque that wash gets at the outer edge, 0 to 1. Lower it to let more
+     * of the content show through the far end of the band; `0` leaves the blur
+     * bare, along with the seams between its layers.
+     */
+    tint?: number;
+    /** Distance in pixels over which an edge comes in from clear to full. */
+    fadeInDistance?: number;
+    /** Set false to render the child with no bands at all. */
+    enabled?: boolean;
+    children?: ReactNode;
+}
+export declare function ScrollBlur({ className, size, edges, orientation, layers, intensity, material, tint, color, fadeInDistance, enabled, children, ...props }: ScrollBlurProps): import("react").JSX.Element;
+export declare namespace ScrollBlur {
+    var displayName: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/scroll-blur/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/scroll-blur/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAqCtB,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAUD,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,IAAS,EACT,KAAc,EACd,WAAW,EACX,MAAU,EACV,SAAc,EACd,QAAoB,EACpB,IAAW,EACX,KAAK,EACL,cAAyC,EACzC,OAAc,EACd,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,eAAe,+BA0HjB;yBAxIe,UAAU"}

package/lib/typescript/src/components/scroll-canvas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/scroll-canvas/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACrF,OAAiB,EAIf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAkBjC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,cAAc,EACd,MAAM,EACN,OAAO,EACP,MAAmB,EACnB,WAAqB,EACrB,QAAY,EACZ,KAAS,EACT,GAAS,EACT,QAAQ,EAAE,QAAQ,EAClB,OAAc,EACd,KAAK,EACL,GAAG,KAAK,EACT,EAAE,iBAAiB,+BAkFnB;yBAhGe,YAAY"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/scroll-canvas/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACrF,OAAiB,EAIf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAkBjC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,cAAc,EACd,MAAM,EACN,OAAO,EACP,MAAmB,EACnB,WAAqB,EACrB,QAAY,EACZ,KAAS,EACT,GAAS,EACT,QAAQ,EAAE,QAAQ,EAClB,OAAc,EACd,KAAK,EACL,GAAG,KAAK,EACT,EAAE,iBAAiB,+BAmFnB;yBAjGe,YAAY"}