@hjmds/react 1.19.0 → 1.21.0

package/dist/chart.d.ts

@@ -0,0 +1,157 @@
+import { type ReactNode } from "react";
+import { type PieVisibilitySummary, type ChartBarLayout, type ChartCurve, type ChartOrientation, type ChartSeries, type ScatterDatum } from "@hjmds/design-contracts/components/chart";
+import type { HjmCompositionStyleProp } from "./composition-style.js";
+type FocusDetail = Readonly<{
+    scrubbing: boolean;
+}>;
+type FocusProps = Readonly<{
+    /** Controlled focused category; `null` shows no focus. */
+    focusIndex?: number | null;
+    defaultFocusIndex?: number | null;
+    onFocusChange?: (index: number | null, detail: FocusDetail) => void;
+    /** Keep the scrubbed point after release instead of returning to the default (Native parity, 2026-10-14). */
+    holdOnRelease?: boolean;
+}>;
+type ChartRootProps = Readonly<{
+    className?: string;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
+}>;
+type CartesianCommon = ChartRootProps & Readonly<{
+    categories: readonly string[];
+    series: readonly ChartSeries[];
+    /** Accessible name (Web `aria-label`). Product-localized. */
+    accessibilityLabel: string;
+    formatValue: (value: number) => string;
+    /** Spoken/written for a missing observation in the text alternative. */
+    missingLabel: string;
+    height?: number;
+    /** Width used on the server and before the first ResizeObserver measurement. */
+    width?: number;
+    domain?: readonly [number, number];
+    showAxis?: boolean;
+}>;
+export type LineChartProps = CartesianCommon & FocusProps & Readonly<{
+    curve?: ChartCurve;
+    /** Gradient area under each line. Defaults to on for a single series. */
+    area?: boolean;
+    stacked?: boolean;
+    /** Smallest value on top (ranks, ERA). */
+    invert?: boolean;
+    includeZero?: boolean;
+    /** Dashed horizontal reference line; `"first"` uses the first observation (previous close). */
+    referenceValue?: number | "first";
+    /** Labels for the first series' high/low markers, shown while not scrubbing. */
+    extremes?: Readonly<{
+        high: string;
+        low: string;
+    }>;
+    /** Bubble text above the cursor while scrubbing; defaults to the category. */
+    cursorLabel?: (index: number) => string;
+    /** Morph actual data changes; reduced motion snaps immediately. */
+    animateChanges?: boolean;
+    /** Keep the chosen side in series color; mute the other side. */
+    scrubEmphasis?: "before" | "after";
+    /** Value labels only (rank charts: "1위" at the top). */
+    valueAxis?: boolean;
+    /** Overrides grid/label ticks. */
+    ticks?: readonly number[];
+}>;
+export declare function LineChart({ categories, series, accessibilityLabel, formatValue, missingLabel, height, width: fallbackWidth, curve, area, stacked, invert, domain, includeZero, referenceValue, extremes, showAxis, valueAxis, ticks: tickOverride, cursorLabel, animateChanges, scrubEmphasis, className, layoutStyle, ...focusProps }: LineChartProps): import("react").JSX.Element;
+export type BarChartProps = CartesianCommon & FocusProps & Readonly<{
+    orientation?: ChartOrientation;
+    layout?: ChartBarLayout;
+    /** Value label at each bar end (the stack total for stacked bars). */
+    showValues?: boolean;
+    animateChanges?: boolean;
+}>;
+export declare function BarChart({ categories, series, accessibilityLabel, formatValue, missingLabel, height, width: fallbackWidth, orientation, layout, domain, showAxis, showValues, animateChanges, className, layoutStyle, ...focusProps }: BarChartProps): import("react").JSX.Element;
+export type ChartLegendItem = Readonly<{
+    id: string;
+    label: string;
+    color: string;
+    value?: string;
+}>;
+export type ChartLegendProps = ChartRootProps & Readonly<{
+    items: readonly ChartLegendItem[];
+    exclusion?: Readonly<{
+        excludedIds: readonly string[];
+        onToggle: (id: string) => void;
+        label: (item: ChartLegendItem, included: boolean) => string;
+    }>;
+    selectedId?: string | null;
+    /** When given, rows are toggle buttons; pressing the selected row clears the selection. */
+    onSelect?: (id: string | null) => void;
+}>;
+/** Swatch + label (+ value). Color is never the only encoding: every row carries its label. */
+export declare function ChartLegend({ items, selectedId, onSelect, exclusion, className, layoutStyle }: ChartLegendProps): import("react").JSX.Element;
+export type PieDatum = Readonly<{
+    id: string;
+    label: string;
+    value: number | null;
+    color?: string;
+}>;
+export type PieChartProps = ChartRootProps & Readonly<{
+    data: readonly PieDatum[];
+    accessibilityLabel: string;
+    formatValue: (value: number) => string;
+    donut?: boolean;
+    size?: number;
+    /** Rendered in the donut hole (ignored for a full pie). */
+    centerContent?: ReactNode | ((summary: PieVisibilitySummary) => ReactNode);
+    /** Controlled denominator filtering, independent of selectedId emphasis. */
+    exclusion?: Readonly<{
+        excludedIds: readonly string[];
+        onExcludedIdsChange: (ids: readonly string[]) => void;
+        label: (datum: PieDatum, included: boolean) => string;
+    }>;
+    selectedId?: string | null;
+    defaultSelectedId?: string | null;
+    onSelect?: (id: string | null) => void;
+    showLegend?: boolean;
+}>;
+export declare function PieChart({ data, accessibilityLabel, formatValue, donut, size, centerContent, selectedId, defaultSelectedId, onSelect, showLegend, exclusion, className, layoutStyle, }: PieChartProps): import("react").JSX.Element;
+export type RadarChartProps = ChartRootProps & Readonly<{
+    /** At least three axes. */
+    categories: readonly string[];
+    series: readonly ChartSeries[];
+    accessibilityLabel: string;
+    formatValue: (value: number) => string;
+    missingLabel: string;
+    /** One shared domain for every axis; defaults to 0..max. */
+    domain?: readonly [number, number];
+    levels?: number;
+    size?: number;
+    /** Defaults to on for more than one series. */
+    showLegend?: boolean;
+}>;
+export declare function RadarChart({ categories, series, accessibilityLabel, formatValue, missingLabel, domain, levels, size, showLegend, className, layoutStyle, }: RadarChartProps): import("react").JSX.Element;
+export type ScatterChartProps = ChartRootProps & Readonly<{
+    points: readonly ScatterDatum[];
+    accessibilityLabel: string;
+    xLabel: string;
+    yLabel: string;
+    formatX: (value: number) => string;
+    formatY: (value: number) => string;
+    height?: number;
+    /** Width used on the server and before the first ResizeObserver measurement. */
+    width?: number;
+    /** Legend labels by `seriesIndex`; the legend shows for two or more. */
+    seriesLabels?: readonly string[];
+    focusId?: string | null;
+    onFocusChange?: (id: string | null) => void;
+}>;
+export declare function ScatterChart({ points, accessibilityLabel, xLabel, yLabel, formatX, formatY, height, width: fallbackWidth, seriesLabels, focusId, onFocusChange, className, layoutStyle, }: ScatterChartProps): import("react").JSX.Element;
+export type SparklineProps = ChartRootProps & Readonly<{
+    values: readonly (number | null)[];
+    color?: string;
+    invert?: boolean;
+    domain?: readonly [number, number];
+    width?: number;
+    height?: number;
+    /** Omit when the adjacent text already states the value; the sparkline is then decorative. */
+    accessibilityLabel?: string;
+}>;
+export declare function Sparkline({ values, color, invert, domain, width, height, accessibilityLabel, className, layoutStyle, }: SparklineProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=chart.d.ts.map

package/dist/chart.d.ts.map

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