@persona/design-system 0.10.12 → 0.10.14

package/dist/chartColors.d.mts

@@ -1,92 +0,0 @@
-import { t as ChartingTokens } from "./charting-C_WcP3tn.mjs";
-import { t as MaybeChartingTheme } from "./semanticColor-BKbCliyl.mjs";
-import { Color } from "@persona/design-tokens";
-
-//#region src/components/Chart/chartColors.d.ts
-/**
- * The charting palettes a chart may use. Each maps to a `ChartingColors` palette from
- * `@persona/design-tokens` (or its dark-mode twin under a PDS colour mode):
- *
- * - `qualitative` → `Qualitative` (12): distinct, unordered series. The default; its order is
- *   tuned for accessibility, so series take colours in this order.
- * - `sequentialMono` → `SequentialMono` (8): ordered magnitude in one hue.
- * - `sequentialDivergent` → `SequentialDivergent` (10): values diverging around a midpoint.
- *
- * The legacy `Sequential` and `Categorical` palettes are deliberately not offered.
- *
- * @experimental Part of the in-progress PDS charting components; the API may change.
- */
-type ChartPalette = 'qualitative' | 'sequentialMono' | 'sequentialDivergent';
-/** @experimental */
-declare const CHART_PALETTE_TOKENS: {
-  readonly qualitative: "Qualitative";
-  readonly sequentialMono: "SequentialMono";
-  readonly sequentialDivergent: "SequentialDivergent";
-};
-/** @experimental */
-declare const DEFAULT_CHART_PALETTE: ChartPalette;
-/** @experimental */
-type ChartColorMode = 'light' | 'dark';
-/**
- * A colour override for one series: a Persona `Color` token, or a light/dark pair of tokens.
- * `Color` is a string enum, so a raw hex string (`'#3F48FD'`) does not type-check.
- *
- * Wrap overrides in {@link chartColor} so the `pds/semantic-color` lint rule accepts the `Color.*`
- * reference.
- *
- * @experimental
- */
-type ChartColor = Color | {
-  readonly light: Color;
-  readonly dark: Color;
-};
-/**
- * Marks a series colour override as a deliberate chart colour. It returns its argument unchanged;
- * its job is to type-check the override (Persona tokens only, never hex) and to tell the
- * `pds/semantic-color` lint rule that the `Color.*` inside is intended.
- *
- * ```ts
- * { key: 'fraud', label: 'Fraud', color: chartColor(Color.CoreRed600) }
- * { key: 'fraud', label: 'Fraud', color: chartColor({ light: Color.CoreRed600, dark: Color.CoreRed400 }) }
- * ```
- *
- * @experimental
- */
-declare const chartColor: <C extends ChartColor>(color: C) => C;
-/** One series as far as colour resolution is concerned. @experimental */
-interface ChartSeriesColorInput<K extends string = string> {
-  key: K;
-  color?: ChartColor;
-}
-/** @experimental */
-interface ResolveSeriesColorsOptions {
-  /** Palettes for the active colour mode, e.g. `chartingColors(theme)`. Defaults to light. */
-  tokens?: ChartingTokens;
-  /** Defaults to `'qualitative'`. */
-  palette?: ChartPalette;
-  /** Picks the side of a light/dark override pair. Defaults to `'light'`. */
-  mode?: ChartColorMode;
-}
-/** The ordered colours of `palette` in `tokens`. @experimental */
-declare const chartPaletteColors: (tokens: ChartingTokens, palette?: ChartPalette) => readonly Color[];
-/** Resolves an override to the single token for `mode`. @experimental */
-declare const resolveChartColor: (color: ChartColor, mode: ChartColorMode) => Color;
-/** `'dark'` when `theme` carries the dark charting palettes, else `'light'`. @experimental */
-declare const chartColorModeOf: (theme: MaybeChartingTheme | undefined) => ChartColorMode;
-/**
- * Assigns each series a colour token, keyed by series key.
- *
- * Series without an override take the palette colour at their own index, so a series keeps its
- * colour when another is hidden or overridden. Past the end of the palette colours repeat and a
- * development warning suggests grouping the extra series (e.g. into "Other"): never invent colours.
- *
- * @experimental
- */
-declare function resolveSeriesColors<K extends string>(series: readonly ChartSeriesColorInput<K>[], {
-  tokens,
-  palette,
-  mode
-}?: ResolveSeriesColorsOptions): Record<K, Color>;
-//#endregion
-export { CHART_PALETTE_TOKENS, ChartColor, ChartColorMode, ChartPalette, ChartSeriesColorInput, DEFAULT_CHART_PALETTE, ResolveSeriesColorsOptions, chartColor, chartColorModeOf, chartPaletteColors, resolveChartColor, resolveSeriesColors };
-//# sourceMappingURL=chartColors.d.mts.map

package/dist/chartFrameLayout.d.mts

@@ -1,46 +0,0 @@
-import * as _$react from "react";
-
-//#region src/components/Chart/chartFrameLayout.d.ts
-/**
- * Where a `ChartFrame` places its legend:
- * - `'stack'` (default): left-aligned above the plot; legend items run in a wrapping row.
- * - `'right'`: inline to the right of the plot, top-aligned; legend items run in a column.
- *
- * @experimental Part of the in-progress PDS charting components; the API may change.
- */
-type ChartLegendPosition = 'stack' | 'right';
-/** @experimental */
-declare const DEFAULT_CHART_LEGEND_POSITION: ChartLegendPosition;
-/**
- * Plot height in px when a `ChartFrame` is given none. The plot always fills the frame's width.
- *
- * @experimental
- */
-declare const CHART_DEFAULT_HEIGHT = 300;
-/**
- * Opacity of a de-emphasised series: a hidden series' legend swatch, and the series a pointer is
- * not on (its popover row and its segment in the hovered bar).
- *
- * @experimental
- */
-declare const CHART_INACTIVE_OPACITY = 0.65;
-/**
- * Recharts margin for a plot inside a `ChartFrame`. The frame owns the spacing around the plot
- * (`Spacing[3]` between legend and plot) and lets axis labels overflow the SVG, so the chart adds
- * no margin of its own: `<BarChart margin={CHART_PLOT_MARGIN} ...>`.
- *
- * @experimental
- */
-declare const CHART_PLOT_MARGIN: {
-  readonly top: 0;
-  readonly right: 0;
-  readonly bottom: 0;
-  readonly left: 0;
-};
-/** Provided by `ChartFrame` so its `ChartLegend` lays its items out to match. */
-declare const ChartLegendPositionProvider: _$react.Provider<ChartLegendPosition | undefined>;
-/** The legend position of the enclosing `ChartFrame`, or `undefined` outside one. */
-declare const useChartLegendPosition: () => ChartLegendPosition | undefined;
-//#endregion
-export { CHART_DEFAULT_HEIGHT, CHART_INACTIVE_OPACITY, CHART_PLOT_MARGIN, ChartLegendPosition, ChartLegendPositionProvider, DEFAULT_CHART_LEGEND_POSITION, useChartLegendPosition };
-//# sourceMappingURL=chartFrameLayout.d.mts.map

package/dist/components/Chart/index.d.mts

@@ -1,9 +0,0 @@
-import { CHART_DEFAULT_HEIGHT, CHART_INACTIVE_OPACITY, CHART_PLOT_MARGIN, ChartLegendPosition, DEFAULT_CHART_LEGEND_POSITION } from "../../chartFrameLayout.mjs";
-import { ChartLegend, ChartLegendContent, ChartLegendGroup, ChartLegendItem, ChartLegendProps } from "../../ChartLegend.mjs";
-import { ChartFrame, ChartFrameProps } from "../../ChartFrame.mjs";
-import { ChartPopover, ChartPopoverPanel, ChartPopoverPanelProps, ChartPopoverPayloadEntry, ChartPopoverProps, ChartPopoverRow, ChartPopoverSeries, ChartPopoverSize, chartPopoverRows } from "../../ChartPopover.mjs";
-import { CHART_PALETTE_TOKENS, ChartColor, ChartColorMode, ChartPalette, ChartSeriesColorInput, DEFAULT_CHART_PALETTE, ResolveSeriesColorsOptions, chartColor, chartColorModeOf, chartPaletteColors, resolveChartColor, resolveSeriesColors } from "../../chartColors.mjs";
-import { ChartColors, useChartColors } from "../../useChartColors.mjs";
-import { ChartSeriesVisibility, useChartSeriesVisibility } from "../../useChartSeriesVisibility.mjs";
-import { ChartActiveSeries, ChartStyles, ChartTickStyle, useChartActiveSeries, useChartStyles } from "../../useChartStyles.mjs";
-export { CHART_DEFAULT_HEIGHT, CHART_INACTIVE_OPACITY, CHART_PALETTE_TOKENS, CHART_PLOT_MARGIN, type ChartActiveSeries, type ChartColor, type ChartColorMode, type ChartColors, ChartFrame, type ChartFrameProps, ChartLegend, type ChartLegendContent, type ChartLegendGroup, type ChartLegendItem, type ChartLegendPosition, type ChartLegendProps, type ChartPalette, ChartPopover, ChartPopoverPanel, type ChartPopoverPanelProps, type ChartPopoverPayloadEntry, type ChartPopoverProps, type ChartPopoverRow, type ChartPopoverSeries, type ChartPopoverSize, type ChartSeriesColorInput, type ChartSeriesVisibility, type ChartStyles, type ChartTickStyle, DEFAULT_CHART_LEGEND_POSITION, DEFAULT_CHART_PALETTE, type ResolveSeriesColorsOptions, chartColor, chartColorModeOf, chartPaletteColors, chartPopoverRows, resolveChartColor, resolveSeriesColors, useChartActiveSeries, useChartColors, useChartSeriesVisibility, useChartStyles };