ingred-ui 33.18.2-canary.2 → 33.19.0

package/dist/components/Chart/BarLineChart/BarLineChart.d.ts

@@ -0,0 +1,4 @@
+import * as React from "react";
+import { BarLineChartProps } from "./types";
+declare const BarLineChart: React.FC<BarLineChartProps>;
+export default BarLineChart;

package/dist/components/Chart/BarLineChart/index.d.ts

@@ -0,0 +1,2 @@
+export { default as BarLineChart } from "./BarLineChart";
+export type { BarLineChartProps } from "./types";

package/dist/components/Chart/BarLineChart/types.d.ts

@@ -0,0 +1,56 @@
+import { ChartReferenceLine, ChartSeries } from "../types";
+import { BarChartLayout } from "../BarChart/types";
+export type BarLineChartProps = {
+    /** X 軸のカテゴリラベル */
+    categories: string[];
+    /**
+     * 左軸に描画する棒系列。
+     * `label` が `lineSeries` と同じでも内部で区別する。
+     */
+    barSeries: ChartSeries[];
+    /**
+     * 右軸に描画する折れ線系列。
+     * `label` が `barSeries` と同じでも内部で区別する。
+     */
+    lineSeries: ChartSeries[];
+    /**
+     * 棒のレイアウト。凡例 OFF でも grouped / stacked は維持する。
+     * カテゴリ位置（折れ線）は動かさない。
+     * - single: 系列 1 本（デフォルト）
+     * - grouped: 系列を横並びで比較。非表示はフェード後に残りが詰まって幅を広げる
+     * - stacked: 系列を積み上げて構成比を比較。非表示はフェード後に滑って積み直す
+     */
+    barLayout?: BarChartLayout;
+    /**
+     * theme.palette.chart.colorSchemes のキー。
+     * 未指定時は palette.chart.series（デフォルト）を使う。
+     */
+    colorScheme?: string;
+    /** 左軸（棒）の数値表示。未指定時は toLocaleString() */
+    barValueFormatter?: (value: number) => string;
+    /** 右軸（折れ線）の数値表示。未指定時は toLocaleString() */
+    lineValueFormatter?: (value: number) => string;
+    /** 系列が 2 本以上のとき凡例を表示。デフォルト true */
+    showLegend?: boolean;
+    /** 折れ線のデータ点にマーカーを表示。デフォルト true */
+    showPoints?: boolean;
+    /** 凡例クリックで系列の表示/非表示を切り替え。デフォルト true */
+    interactiveLegend?: boolean;
+    /**
+     * 値軸上の参照線。
+     * `axis: "secondary"` は右軸（折れ線）スケールに乗せる。
+     */
+    referenceLines?: ChartReferenceLine[];
+    /**
+     * 棒の太さ（カテゴリスロット幅に対する比率 0–1）。
+     * BarChart の barWidthRatio と同じ。
+     */
+    barWidthRatio?: number;
+    /** true の間、チャートの代わりにローディング表示 */
+    loading?: boolean;
+    /** 描画可能なデータがないときのメッセージ。未指定時は「データがありません」 */
+    emptyMessage?: string;
+    "aria-label": string;
+    height?: number;
+    className?: string;
+};

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

@@ -4,6 +4,8 @@ export { LineChart } from "./LineChart";
 export type { LineChartProps } from "./LineChart";
 export { AreaChart } from "./AreaChart";
 export type { AreaChartLayout, AreaChartProps } from "./AreaChart";
+export { BarLineChart } from "./BarLineChart";
+export type { BarLineChartProps } from "./BarLineChart";
 export type { BarSegment, BarChartOrientation, ChartHoverState, ChartReferenceLine, ChartReferenceLineAxis, ChartSeries, ResolvedChartSeries, } from "./types";
 export type { LinePoint, LinePathSegment, LineSeriesGeometry, } from "./internal/getLineSeries";
 export { computeYTicks, computeMaxStackedTotal } from "./internal/utils";
@@ -20,3 +22,5 @@ export { computeAchievementPercent, formatAchievementPercent, getTooltipReferenc
 export type { ChartTooltipReferenceMetric } from "./internal/tooltipReferenceMetrics";
 export { computeAreaChartMaxValue, getAreaSegments, getOverlayAreaPath, getStackedAreaPath, toStackedLineSeries, } from "./internal/getAreaPath";
 export type { AreaPathSegment } from "./internal/getAreaPath";
+export { hasBarLineChartData } from "./internal/hasBarLineChartData";
+export { getBarLineChartAxisSeries, getBarLineChartDrawBarSeries, getBarLineChartReferenceLineLegendItems, getBarLineSeriesDisplayLabel, getBarLineSeriesKey, } from "./internal/getBarLineChartSeries";

package/dist/components/Chart/internal/ChartAxis.d.ts

@@ -13,6 +13,10 @@ type ChartValueAxisProps = {
     ticks: number[];
     maxValue: number;
     valueFormatter: (value: number) => string;
+    /** start: 左（または下）、end: 右軸。デフォルト start */
+    position?: "start" | "end";
+    /** グリッド線を描画するか。右軸では通常 false */
+    showGrid?: boolean;
 };
 export declare const ChartValueAxis: React.FC<ChartValueAxisProps>;
 type ChartCategoryLabelsProps = {

package/dist/components/Chart/internal/ChartBar.d.ts

@@ -7,8 +7,9 @@ type ChartBarProps = {
     enterIndex: number;
     durationMs: number;
     staggerMs: number;
-    onPointerMove: (event: React.PointerEvent<SVGRectElement>) => void;
-    onPointerLeave: () => void;
+    hidden?: boolean;
+    onPointerMove?: (event: React.PointerEvent<SVGRectElement>) => void;
+    onPointerLeave?: () => void;
 };
 export declare const ChartBar: React.FC<ChartBarProps>;
 export {};

package/dist/components/Chart/internal/ChartLegend.d.ts

@@ -1,5 +1,7 @@
 import * as React from "react";
 export type ChartLegendItem = {
+    /** 未指定時は label。棒と線で同名の系列を区別する */
+    id?: string;
     label: string;
     color: string;
     hidden: boolean;

package/dist/components/Chart/internal/ChartLineSeries.d.ts

@@ -29,6 +29,8 @@ type ChartCrosshairProps = {
     paddingTop: number;
     chartHeight: number;
     color: string;
+    strokeWidth?: number;
+    opacity?: number;
 };
 export declare const ChartCrosshair: React.FC<ChartCrosshairProps>;
 export {};

package/dist/components/Chart/internal/ChartTooltip.d.ts

@@ -1,9 +1,13 @@
 import * as React from "react";
 import { ResolvedChartSeries } from "../types";
 import { ChartTooltipReferenceMetric } from "./tooltipReferenceMetrics";
+export type ChartTooltipDataset = Pick<ResolvedChartSeries, "label" | "color" | "data"> & {
+    id?: string;
+    formatValue?: (value: number) => string;
+};
 type ChartTooltipProps = {
     label: string;
-    datasets: Pick<ResolvedChartSeries, "label" | "color" | "data">[];
+    datasets: ChartTooltipDataset[];
     categoryIndex: number;
     clientX: number;
     clientY: number;

package/dist/components/Chart/internal/clampTooltipPosition.d.ts

@@ -3,6 +3,7 @@ export type TooltipPosition = {
     top: number;
     transform: string;
 };
+export declare function isSameTooltipPosition(a: TooltipPosition, b: TooltipPosition): boolean;
 /**
  * カーソル追従 tooltip を viewport 内に収める。
  * 棒グラフの視認性のため左右を優先し、収まらない場合のみ上下に表示する。

package/dist/components/Chart/internal/filterVisibleSeries.d.ts

@@ -1,5 +1,6 @@
 import { ResolvedChartSeries } from "../types";
 export declare function filterVisibleSeries(series: ResolvedChartSeries[], hiddenLabels: ReadonlySet<string>): ResolvedChartSeries[];
-export declare function toggleSeriesVisibility(hiddenLabels: ReadonlySet<string>, label: string, seriesLabels: readonly string[]): ReadonlySet<string>;
+/** pendingLabels: exit アニメ中など、まだ hidden に入っていない非表示予定の系列 */
+export declare function toggleSeriesVisibility(hiddenLabels: ReadonlySet<string>, label: string, seriesLabels: readonly string[], pendingLabels?: ReadonlySet<string>): ReadonlySet<string>;
 /** exit アニメーション完了後に hidden 集合へ系列を追加する（既存の hidden を保持する） */
 export declare function commitHiddenSeriesLabel(hiddenLabels: ReadonlySet<string>, label: string): ReadonlySet<string>;

package/dist/components/Chart/internal/getAreaPath.d.ts

@@ -25,7 +25,7 @@ export declare function getStackedAreaPath(upperPoints: readonly {
     x: number;
     y: number;
 }[]): string;
-export declare function computeAreaChartMaxValue(series: readonly Pick<ResolvedChartSeries, "data">[], layout: AreaChartLayout): number;
+export declare function computeAreaChartMaxValue(series: readonly Pick<ResolvedChartSeries, "data">[], layout: AreaChartLayout, categoryCount?: number): number;
 export declare function toStackedLineSeries(series: readonly ResolvedChartSeries[]): ResolvedChartSeries[];
 export declare function getOverlayAreaSegments(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number): AreaPathSegment[];
 export declare function getStackedAreaSegments(series: readonly ResolvedChartSeries[], chartLayout: ChartLayout, maxValue: number, categoryCount?: number): AreaPathSegment[];

package/dist/components/Chart/internal/getBarLineChartSeries.d.ts

@@ -0,0 +1,21 @@
+import { BarChartLayout } from "../BarChart/types";
+import { ChartReferenceLine } from "../types";
+import { ReferenceLineLegendItem } from "./getReferenceLineGeometry";
+export type BarLineSeriesKind = "bar" | "line";
+export declare function getBarLineSeriesKey(kind: BarLineSeriesKind, label: string): string;
+export declare function getBarLineSeriesDisplayLabel(seriesKey: string): string;
+/**
+ * 軸スケール用の系列。
+ * BarLineChart は棒と線で「最後の 1 本」が別グループに残るため、
+ * 片方を全部隠しても空配列で max=1 にしない。
+ */
+export declare function getBarLineChartAxisSeries<T>(visible: readonly T[], all: readonly T[]): readonly T[];
+/**
+ * 棒の幾何計算に含める系列。
+ * 非表示は除く。grouped は残りが幅を分け合い、stacked は積み直す。
+ */
+export declare function getBarLineChartDrawBarSeries<T extends {
+    label: string;
+}>(series: readonly T[], hiddenLabels: ReadonlySet<string>, _layout: BarChartLayout): T[];
+/** BarLineChart は左右軸の参照線を両方凡例に出す */
+export declare function getBarLineChartReferenceLineLegendItems(lines: readonly ChartReferenceLine[] | undefined, primaryFormatter: (value: number) => string, secondaryFormatter: (value: number) => string, defaultColor: string): ReferenceLineLegendItem[];

package/dist/components/Chart/internal/getBarSegments.d.ts

@@ -1,5 +1,5 @@
 import { BarChartLayout } from "../BarChart/types";
 import { BarChartOrientation, BarSegment, ResolvedChartSeries } from "../types";
 import { ChartLayout } from "./getChartLayout";
-export declare function computeChartMaxValue(series: ResolvedChartSeries[], layout: BarChartLayout): number;
-export declare function getBarSegments(series: ResolvedChartSeries[], layout: BarChartLayout, chartLayout: ChartLayout, maxValue: number, orientation?: BarChartOrientation): BarSegment[];
+export declare function computeChartMaxValue(series: ResolvedChartSeries[], layout: BarChartLayout, categoryCount?: number): number;
+export declare function getBarSegments(series: ResolvedChartSeries[], layout: BarChartLayout, chartLayout: ChartLayout, maxValue: number, orientation?: BarChartOrientation, categoryCount?: number): BarSegment[];

package/dist/components/Chart/internal/getChartLayout.d.ts

@@ -15,6 +15,8 @@ export type ChartLayoutOptions = {
     layoutConfig?: ChartLayoutConfig;
     /** ResizeObserver で測定したコンテナ幅 */
     containerWidth?: number;
+    /** 右軸ラベル用に paddingRight を広げる（BarLineChart） */
+    endValueAxis?: boolean;
 };
 export type ChartLayout = {
     width: number;

package/dist/components/Chart/internal/getLineSeries.d.ts

@@ -19,10 +19,10 @@ export type LineSeriesGeometry = {
     points: LinePoint[];
 };
 /** Y 軸は 0 起点。負の値を含む場合のスケール調整は未対応。 */
-export declare function computeLineChartMaxValue(series: readonly Pick<ResolvedChartSeries, "data">[]): number;
+export declare function computeLineChartMaxValue(series: readonly Pick<ResolvedChartSeries, "data">[], categoryCount?: number): number;
 export declare function getCategoryCenterX(categoryIndex: number, chartLayout: Pick<ChartLayout, "paddingLeft" | "slotWidth">): number;
 export declare function getValueY(value: number, maxValue: number, chartLayout: Pick<ChartLayout, "paddingTop" | "chartHeight">): number;
 export declare function pathFromPoints(points: readonly LinePoint[]): string;
-export declare function getLinePathSegments(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number): LinePathSegment[];
-export declare function getLineSeriesGeometry(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number): LineSeriesGeometry;
-export declare function getLinePoints(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number): LinePoint[];
+export declare function getLinePathSegments(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number, categoryCount?: number): LinePathSegment[];
+export declare function getLineSeriesGeometry(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number, categoryCount?: number): LineSeriesGeometry;
+export declare function getLinePoints(item: ResolvedChartSeries, chartLayout: ChartLayout, maxValue: number, categoryCount?: number): LinePoint[];

package/dist/components/Chart/internal/getReferenceLineGeometry.d.ts

@@ -10,8 +10,15 @@ export declare function isReferenceLineInScale(value: number, maxValue: number):
 export declare function getValueX(value: number, maxValue: number, chartLayout: Pick<ChartLayout, "paddingLeft" | "chartWidth">): number;
 export declare function getReferenceLineGeometry(value: number, maxValue: number, chartLayout: Pick<ChartLayout, "paddingLeft" | "paddingTop" | "chartWidth" | "chartHeight">, orientation: BarChartOrientation, _axis?: ChartReferenceLineAxis): ChartReferenceLineGeometry | null;
 export type ReferenceLineLegendItem = {
+    /** 凡例の React key。label が重複しても一意にする */
+    id?: string;
     label: string;
     color: string;
 };
 /** 参照線を凡例用アイテムに変換する（スケール外でも凡例には残す） */
 export declare function getReferenceLineLegendItems(lines: readonly ChartReferenceLine[] | undefined, valueFormatter: (value: number) => string, defaultColor: string): ReferenceLineLegendItem[];
+/** SVG stroke-dasharray を凡例スウォッチの background に変換する */
+export declare function getReferenceLineSwatchBackground(color: string, dasharray: string): {
+    backgroundColor: string;
+    backgroundImage: string;
+};

package/dist/components/Chart/internal/hasBarLineChartData.d.ts

@@ -0,0 +1,2 @@
+import { ChartSeries } from "../types";
+export declare function hasBarLineChartData(categories: readonly string[], barSeries: readonly ChartSeries[], lineSeries: readonly ChartSeries[]): boolean;

package/dist/components/Chart/internal/hasChartData.d.ts

@@ -1,3 +1,3 @@
 import { ChartSeries } from "../types";
-/** categories / series に描画可能な値（null 以外かつ 0 より大）が存在するか */
+/** 表示中のカテゴリ範囲に描画可能な値（null 以外かつ 0 より大）があるか */
 export declare function hasChartData(categories: readonly string[], series: readonly ChartSeries[]): boolean;

package/dist/components/Chart/internal/hasLineChartData.d.ts

@@ -1,3 +1,3 @@
 import { ChartSeries } from "../types";
-/** categories / series に null 以外の値が存在するか（0 以下も有効） */
+/** 表示中のカテゴリ範囲に null 以外の値があるか（0 以下も有効） */
 export declare function hasLineChartData(categories: readonly string[], series: readonly ChartSeries[]): boolean;

package/dist/components/Chart/internal/utils/scale.d.ts

@@ -1,2 +1,2 @@
 export declare function computeYTicks(maxValue: number, tickCount: number): number[];
-export declare function computeMaxStackedTotal(datasets: (number | null)[][]): number;
+export declare function computeMaxStackedTotal(datasets: (number | null)[][], categoryCount?: number): number;

package/dist/components/Chart/types.d.ts

@@ -33,7 +33,7 @@ export type ChartReferenceLine = {
     label?: string;
     /** 未指定時は theme.palette.chart.referenceLine.color */
     color?: string;
-    /** ComboChart の右軸用。他チャートでは primary のみ有効。 */
+    /** BarLineChart の右軸用。他チャートでは primary のみ有効。 */
     axis?: ChartReferenceLineAxis;
     /**
      * tooltip に達成率（表示値合計 / 目標）を出す。