panelui-native 0.101.1 → 0.102.0

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

@@ -61,8 +61,10 @@
 import { type ReactNode } from 'react';
 import { type ViewProps } from 'react-native';
 import { type ChartAccessibilityProps } from '../../primitives/chart-accessibility.js';
-import { type SankeyAlign } from './sankey-layout.js';
-export type { SankeyAlign } from './sankey-layout.js';
+import { type SankeyAlign, type SankeyCollapse } from './sankey-layout.js';
+export type { SankeyAlign, SankeyCollapse } from './sankey-layout.js';
+/** Which way the flow runs. */
+export type SankeyOrientation = 'horizontal' | 'vertical';
 export type SankeyChartStatus = 'loading' | 'ready';
 export interface SankeyNode {
     /** Stable key the links name. Must be unique; a repeat is ignored. */
@@ -88,16 +90,44 @@ export interface SankeyLink {
     /** Explicit colour, instead of taking the source node's. */
     color?: string;
 }
+/** One end of a stream meeting the selected node. */
+export interface SankeyChartFlow {
+    /** The node at the other end. */
+    id: string;
+    /** Its name, already resolved. */
+    label: string;
+    /** What travels between the two. */
+    value: number;
+    /** That value as a fraction of the selected node's total, `0` to `1`. */
+    share: number;
+    /** The other node's colour, for a swatch beside its name. */
+    color: string;
+}
 /** The selected node and what runs through it, for something drawn inside the chart. */
 export declare function useSankeyChart(): {
+    activeId: null;
+    activeNode: null;
+    activeValue: number;
+    incoming: number;
+    outgoing: number;
+    sources: SankeyChartFlow[];
+    targets: SankeyChartFlow[];
+    collapsed: string[] | null;
+} | {
     activeId: string | null;
-    activeNode: SankeyNode | null;
+    activeNode: SankeyNode;
     /** What passes through it — what the bar's height is drawn from. */
     activeValue: number;
     /** What arrives. Zero at a node the flow starts from. */
     incoming: number;
     /** What leaves. Zero at a node the flow ends at. */
     outgoing: number;
+    /** Where it came from, largest first. */
+    sources: SankeyChartFlow[];
+    /** Where it went, largest first. */
+    targets: SankeyChartFlow[];
+    /** The ids `collapse` folded in, on a bucket. `null` on every other node. */
+    collapsed: string[] | null;
 };
 export interface SankeyChartProps extends ViewProps, ChartAccessibilityProps<SankeyNode> {
     className?: string;
@@ -106,7 +136,9 @@ export interface SankeyChartProps extends ViewProps, ChartAccessibilityProps<San
     /** What travels between them. */
     links: SankeyLink[];
     /**
-     * How tall the diagram is drawn, in points.
+     * How tall the diagram is drawn, in points. Under `orientation="vertical"`
+     * this is the length of the flow rather than the size of the bars, and left
+     * unset it is worked out from how many stages the flow turned out to need.
      *
      * The width is the card's, but nothing in a flow says how deep it should be:
      * a diagram of four nodes and one of forty are the same data at two heights,
@@ -122,6 +154,28 @@ export interface SankeyChartProps extends ViewProps, ChartAccessibilityProps<San
      * before it gives up the height of its bars, because the bar is the reading.
      */
     nodePadding?: number;
+    /**
+     * Which way the flow runs: `horizontal` from one side to the other,
+     * `vertical` from the top of the diagram down to the bottom.
+     *
+     * This is the axis the *stages* advance along, not the one the bars point
+     * along — a vertical flow draws its bars as horizontal rules and stacks them
+     * down the screen. Prefer it on a phone: the stages get the long side of the
+     * screen, and a name gets the whole width of the card instead of the gap
+     * between two columns.
+     */
+    orientation?: SankeyOrientation;
+    /**
+     * Folds each column's smallest nodes into one bucket, named `Other` unless
+     * you say otherwise.
+     *
+     * A ribbon carries its value in its thickness, so a column of thirty is
+     * thirty hairlines. `maxPerColumn` caps how many nodes a column keeps, the
+     * bucket included; `minShare` folds anything under that fraction of its own
+     * column. A column where fewer than two nodes would go in is left alone,
+     * because one node in a bucket is a rename rather than a simplification.
+     */
+    collapse?: SankeyCollapse;
     /** Which column a node goes in where the flow leaves a choice. */
     align?: SankeyAlign;
     /** Relaxation rounds spent untangling the ribbons. */
@@ -146,6 +200,15 @@ export interface SankeyChartProps extends ViewProps, ChartAccessibilityProps<San
      * so a banner can be shown and taken away from the same signal.
      */
     onDropLinks?: (count: number) => void;
+    /**
+     * Overrides what a screen reader says for one ribbon.
+     *
+     * The ribbons are the reading — a node's total says how much passed through
+     * it, never where it went — so each one is spoken in its own right, as
+     * "source to target, value". Only the rows that could be drawn are offered;
+     * a dropped row is reported through `onDropLinks` instead.
+     */
+    accessibilityLabelForLink?: (link: SankeyLink, index: number) => string;
     children?: ReactNode;
 }
 /** Imperative handle: re-run the entrance, for a "replay" control. */
@@ -182,6 +245,14 @@ export interface SankeyChartNodesProps {
     radius?: number;
     /** A bar's opacity when something else is selected. */
     dimOpacity?: number;
+    /**
+     * Whether pressing a bar selects its node.
+     *
+     * On by default, because the names are not always there to press. A bar
+     * below `SankeyChart.Labels`' `minHeight` has no name and, without this, no
+     * way to be selected at all.
+     */
+    interactive?: boolean;
 }
 /**
  * The bars the ribbons run between.
@@ -190,7 +261,7 @@ export interface SankeyChartNodesProps {
  * the diagram that is not crossing anything else — it is the edge the flow
  * arrives at, and it reads as an edge only if nothing shows through it.
  */
-declare function SankeyChartNodes({ radius, dimOpacity }: SankeyChartNodesProps): import("react").JSX.Element | null;
+declare function SankeyChartNodes({ radius, dimOpacity, interactive, }: SankeyChartNodesProps): import("react").JSX.Element | null;
 declare namespace SankeyChartNodes {
     var displayName: string;
     var slot: "svg";
@@ -255,6 +326,59 @@ declare namespace SankeyChartTooltip {
     var displayName: string;
     var slot: "overlay";
 }
+export interface SankeyChartBreakdownProps extends ViewProps {
+    className?: string;
+    /** Format the figures. Defaults to a compact number. */
+    formatValue?: (value: number) => string;
+    /** How many rows each side shows before stopping. */
+    maxRows?: number;
+    /**
+     * Fires with the node at the other end of a row, so a breakdown can be
+     * walked: press where a stream went and the chart follows it there.
+     */
+    onSelectNode?: (id: string) => void;
+    /** Shown in place of the rows when nothing is selected. */
+    placeholder?: string;
+}
+/**
+ * What the selected node carries, written out in full underneath the diagram.
+ *
+ * The names on a flow diagram live in the gaps between its stages, which on a
+ * phone is a few dozen points — wide enough to truncate almost anything. Here
+ * there is the whole width of the card, so a stream is read as the name of
+ * where it came from and the number it carried rather than as a ribbon whose
+ * label ran out of room.
+ *
+ * In and out are listed separately because they are only the same total when
+ * nothing was lost on the way through, and a node where they differ is the
+ * interesting one on the chart.
+ */
+declare function SankeyChartBreakdown({ className, formatValue, maxRows, onSelectNode, placeholder, ...props }: SankeyChartBreakdownProps): import("react").JSX.Element | null;
+declare namespace SankeyChartBreakdown {
+    var displayName: string;
+    var slot: "footer";
+}
+export interface SankeyChartLegendProps extends ViewProps {
+    className?: string;
+    /** How many names to show before stopping. */
+    limit?: number;
+    /** Show each node's share of the whole flow beside its name. */
+    showShare?: boolean;
+}
+/**
+ * Every stage named, under the diagram.
+ *
+ * The names on the chart are dropped wherever a bar is too short to carry one,
+ * which is the right call — forty names at that spacing overlap into a grey
+ * band that hides the flow behind them — but it leaves the smallest nodes with
+ * no name and nothing to press. Here each one gets its full name and a proper
+ * target, and pressing it selects the same node the bar would.
+ */
+declare function SankeyChartLegend({ className, limit, showShare, ...props }: SankeyChartLegendProps): import("react").JSX.Element | null;
+declare namespace SankeyChartLegend {
+    var displayName: string;
+    var slot: "footer";
+}
 export interface SankeyChartSkeletonProps {
     color?: string;
 }
@@ -297,6 +421,8 @@ declare namespace SankeyChartHeader {
     var slot: "header";
 }
 export declare const SankeyChart: import("react").ForwardRefExoticComponent<SankeyChartProps & import("react").RefAttributes<SankeyChartHandle>> & {
+    Breakdown: typeof SankeyChartBreakdown;
+    Legend: typeof SankeyChartLegend;
     Header: typeof SankeyChartHeader;
     Links: typeof SankeyChartLinks;
     Nodes: typeof SankeyChartNodes;

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

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

package/lib/typescript/src/components/sankey-chart/sankey-layout.d.ts

@@ -45,6 +45,20 @@ export interface SankeyLayoutLinkInput {
     target: string;
     value: number;
 }
+/** Which nodes get folded into one, and what the result is called. */
+export interface SankeyCollapse {
+    /**
+     * Keep at most this many nodes in a column, bucket included. A column with
+     * more folds its smallest until it fits.
+     */
+    maxPerColumn?: number;
+    /**
+     * Fold any node worth less than this share of its own column, `0` to `1`.
+     */
+    minShare?: number;
+    /** What the bucket is called. Defaults to `Other`. */
+    label?: string;
+}
 export interface SankeyLayoutOptions {
     width: number;
     height: number;
@@ -55,11 +69,29 @@ export interface SankeyLayoutOptions {
     align: SankeyAlign;
     /** Relaxation rounds. More is steadier and slower; six is the useful knee. */
     iterations: number;
+    /**
+     * Folds a column's smallest nodes into one bucket before laying it out.
+     *
+     * A ribbon carries its value in its thickness, so a column of thirty is
+     * thirty hairlines — present in the data and unreadable on the screen. This
+     * is the only option here that reduces what is drawn rather than rearranging
+     * it.
+     */
+    collapse?: SankeyCollapse;
 }
 export interface SankeyLayoutNode {
     id: string;
-    /** Position in the input array, so a caller can find its own datum again. */
+    /**
+     * Position in the input array, so a caller can find its own datum again.
+     * `-1` on a node the layout made up rather than was given — see `collapsed`.
+     */
     index: number;
+    /**
+     * The ids folded into this node, on the bucket `collapse` produced. Absent
+     * on every node that came from the caller's array, which is how the two are
+     * told apart without comparing ids against the input.
+     */
+    collapsed?: string[];
     /** Which column it landed in, counting from the left. */
     layer: number;
     /** What flows through it: the larger of what arrives and what leaves. */
@@ -83,7 +115,10 @@ export interface SankeyLayoutLink {
     value: number;
     /** How thick the ribbon is, in points. */
     width: number;
-    /** The ribbon's centre where it leaves the source, in points from the top. */
+    /**
+     * The ribbon's centre where it leaves the source, across the flow — points
+     * from the top of an upright layout, and from the left of a transposed one.
+     */
     y0: number;
     /** And where it meets the target. */
     y1: number;
@@ -97,11 +132,19 @@ export interface SankeyLayout {
     dropped: number;
 }
 /**
- * Lays out a flow diagram.
+ * The same arrangement, read down the screen instead of across it.
+ *
+ * A flow diagram has one axis carrying the order of the stages and another
+ * carrying the values, and which of them is horizontal is a question about the
+ * screen rather than about the data. So the layout is solved once, upright,
+ * and turned afterwards — the alternative is a second copy of the relaxation
+ * with every comparison reversed, which is the same maths maintained twice.
  *
- * Returns positions in points inside a `width` by `height` box. An input that
- * cannot be drawn — no nodes, no room, nothing carrying a value — comes back
- * empty rather than as a diagram of zeroes.
+ * Reflecting about the diagonal, so it is its own inverse: transposing twice
+ * returns the layout unchanged. Call `sankeyLayout` with `width` and `height`
+ * swapped and then pass the result through here, or the diagram comes back
+ * fitted to the wrong box.
  */
+export declare function transposeLayout(layout: SankeyLayout): SankeyLayout;
 export declare function sankeyLayout(nodeInput: readonly SankeyLayoutNodeInput[], linkInput: readonly SankeyLayoutLinkInput[], options: SankeyLayoutOptions): SankeyLayout;
 //# sourceMappingURL=sankey-layout.d.ts.map

package/lib/typescript/src/components/sankey-chart/sankey-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sankey-layout.d.ts","sourceRoot":"","sources":["../../../../../src/components/sankey-chart/sankey-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB;AAyQD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAwQd"}
+{"version":3,"file":"sankey-layout.d.ts","sourceRoot":"","sources":["../../../../../src/components/sankey-chart/sankey-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB;AA4bD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAclE;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CA4Sd"}

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

@@ -30,6 +30,23 @@ export interface SpinnerProps extends VariantProps<typeof spinnerVariants> {
      * the spinner is the only sign, or the wait passes in silence.
      */
     label?: string;
+    /**
+     * The colour of the turning arc. Any colour React Native accepts — a hex
+     * string, `rgb()`, a named colour. Leave it unset to follow the theme's
+     * primary colour.
+     *
+     * Set it where the spinner sits on a surface the theme did not choose for
+     * it: a spinner on a filled button, or over a photo, wants the colour of the
+     * text around it rather than the accent.
+     */
+    color?: string;
+    /**
+     * The colour of the faint ring the arc turns around. Leave it unset for the
+     * theme's muted colour. Worth setting alongside `color` on a dark or
+     * coloured surface, where the default ring can read as a second, fainter
+     * spinner rather than as a track.
+     */
+    trackColor?: string;
 }
 /**
  * Rotating ring for work of unknown length. The animation runs entirely on the
@@ -45,6 +62,6 @@ export interface SpinnerProps extends VariantProps<typeof spinnerVariants> {
  * single thing a spinner exists to rule out. Reduce motion asks for less
  * travel, not for less news.
  */
-export declare const Spinner: import("react").MemoExoticComponent<({ className, size, label, }: SpinnerProps) => import("react").JSX.Element>;
+export declare const Spinner: import("react").MemoExoticComponent<({ className, size, label, color, trackColor, }: SpinnerProps) => import("react").JSX.Element>;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/spinner/index.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAS1D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;kGAYnB,CAAC;AAEH,MAAM,WAAW,YAAa,SAAQ,YAAY,CAAC,OAAO,eAAe,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,oEAIjB,YAAY,iCAqDb,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/spinner/index.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAS1D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;kGAYnB,CAAC;AAEH,MAAM,WAAW,YAAa,SAAQ,YAAY,CAAC,OAAO,eAAe,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,uFAMjB,YAAY,iCA4Db,CAAC"}