ingred-ui 33.13.0 → 33.14.0

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

@@ -1,3 +1,3 @@
 export { default as BarChart } from "./BarChart";
-export type { BarChartLayout, BarChartProps } from "./types";
+export type { BarChartLayout, BarChartProps, BarChartValueScale, } from "./types";
 export type { ChartSeries } from "../types";

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

@@ -1,5 +1,6 @@
 import { BarChartOrientation, ChartSeries } from "../types";
 export type BarChartLayout = "single" | "grouped" | "stacked";
+export type BarChartValueScale = "absolute" | "percent";
 export type BarChartProps = {
     /** X 軸のカテゴリラベル（horizontal 時は Y 軸） */
     categories: string[];
@@ -11,6 +12,11 @@ export type BarChartProps = {
      * - stacked: 系列を積み上げて構成比を比較
      */
     layout?: BarChartLayout;
+    /**
+     * stacked 時の値スケール。percent はカテゴリごとに系列を 100% 積み上げ表示する。
+     * grouped / single では無視され absolute として描画する。
+     */
+    valueScale?: BarChartValueScale;
     /** vertical: 棒が上向き / horizontal: 棒が右向き。デフォルト vertical */
     orientation?: BarChartOrientation;
     /**
@@ -18,7 +24,7 @@ export type BarChartProps = {
      * 未指定時は palette.chart.series（デフォルト）を使う。
      */
     colorScheme?: string;
-    /** 軸・tooltip の数値表示。未指定時は toLocaleString() */
+    /** 軸・tooltip の数値表示。未指定時は absolute なら toLocaleString()、percent なら `12.3%` 形式 */
     valueFormatter?: (value: number) => string;
     /** 系列が 2 本以上のとき凡例を表示。デフォルト true */
     showLegend?: boolean;

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

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

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

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

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

@@ -0,0 +1,27 @@
+import { ChartSeries } from "../types";
+export type LineChartProps = {
+    /** X 軸のカテゴリラベル */
+    categories: string[];
+    /** 1 本以上のデータ系列（BarChart / LineChart 共通） */
+    series: ChartSeries[];
+    /**
+     * theme.palette.chart.colorSchemes のキー。
+     * 未指定時は palette.chart.series（デフォルト）を使う。
+     */
+    colorScheme?: string;
+    /** 軸・tooltip の数値表示。未指定時は toLocaleString() */
+    valueFormatter?: (value: number) => string;
+    /** 系列が 2 本以上のとき凡例を表示。デフォルト true */
+    showLegend?: boolean;
+    /** データ点にマーカーを表示。デフォルト true */
+    showPoints?: boolean;
+    /** 凡例クリックで系列の表示/非表示を切り替え。デフォルト true */
+    interactiveLegend?: boolean;
+    /** true の間、チャートの代わりにローディング表示 */
+    loading?: boolean;
+    /** 描画可能なデータがないときのメッセージ。未指定時は「データがありません」 */
+    emptyMessage?: string;
+    "aria-label": string;
+    height?: number;
+    className?: string;
+};

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

@@ -1,8 +1,14 @@
 export { BarChart } from "./BarChart";
-export type { BarChartLayout, BarChartProps } from "./BarChart";
+export type { BarChartLayout, BarChartProps, BarChartValueScale, } from "./BarChart";
+export { LineChart } from "./LineChart";
+export type { LineChartProps } from "./LineChart";
 export type { BarSegment, BarChartOrientation, ChartHoverState, ChartSeries, ResolvedChartSeries, } from "./types";
+export type { LinePoint, LinePathSegment, LineSeriesGeometry, } from "./internal/getLineSeries";
 export { computeYTicks, computeMaxStackedTotal } from "./internal/utils";
+export { formatChartPercentValue, normalizeStackedSeriesToPercent, } from "./internal/utils";
 export { hasChartData } from "./internal/hasChartData";
+export { hasLineChartData } from "./internal/hasLineChartData";
+export { computeLineChartMaxValue, getLinePathSegments, getLineSeriesGeometry, pathFromPoints, } from "./internal/getLineSeries";
 export { formatDateAsMonthDay, mapTimeSeriesChartData, } from "./internal/mapTimeSeriesChartData";
 export type { TimeSeriesDataset, TimeSeriesPoint, } from "./internal/mapTimeSeriesChartData";
 export { CHART_DEFAULT_HEIGHT } from "./internal/getChartLayout";

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

@@ -0,0 +1,29 @@
+import * as React from "react";
+import { LinePathSegment, LinePoint } from "./getLineSeries";
+type ChartLineSeriesProps = {
+    segments: LinePathSegment[];
+    points: LinePoint[];
+    showPoints: boolean;
+    strokeWidth: number;
+    pointRadius: number;
+    hidden: boolean;
+};
+export declare const ChartLineSeries: React.FC<ChartLineSeriesProps>;
+type ChartCategoryHoverTargetsProps = {
+    categoryCount: number;
+    paddingLeft: number;
+    paddingTop: number;
+    slotWidth: number;
+    chartHeight: number;
+    onPointerMove: (event: React.PointerEvent<SVGRectElement>, categoryIndex: number) => void;
+    onPointerLeave: () => void;
+};
+export declare const ChartCategoryHoverTargets: React.FC<ChartCategoryHoverTargetsProps>;
+type ChartCrosshairProps = {
+    x: number;
+    paddingTop: number;
+    chartHeight: number;
+    color: string;
+};
+export declare const ChartCrosshair: React.FC<ChartCrosshairProps>;
+export {};

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

@@ -5,6 +5,6 @@ export type TooltipPosition = {
 };
 /**
  * カーソル追従 tooltip を viewport 内に収める。
- * 上方向に十分なスペースがなければ下方向に反転する。
+ * 棒グラフの視認性のため左右を優先し、収まらない場合のみ上下に表示する。
  */
 export declare function clampTooltipPosition(clientX: number, clientY: number, tooltipWidth: number, tooltipHeight: number, viewportWidth: number, viewportHeight: number, padding?: number, offset?: number): TooltipPosition;

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

@@ -0,0 +1,28 @@
+import { ResolvedChartSeries } from "../types";
+import { ChartLayout } from "./getChartLayout";
+export type LinePoint = {
+    seriesLabel: string;
+    color: string;
+    value: number;
+    x: number;
+    y: number;
+    categoryIndex: number;
+};
+export type LinePathSegment = {
+    seriesLabel: string;
+    color: string;
+    points: LinePoint[];
+    d: string;
+};
+export type LineSeriesGeometry = {
+    segments: LinePathSegment[];
+    points: LinePoint[];
+};
+/** Y 軸は 0 起点。負の値を含む場合のスケール調整は未対応。 */
+export declare function computeLineChartMaxValue(series: readonly Pick<ResolvedChartSeries, "data">[]): 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[];

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

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

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

@@ -1 +1,2 @@
 export { computeMaxStackedTotal, computeYTicks } from "./scale";
+export { formatChartPercentValue, getStackedPercentMaxValue, normalizeStackedSeriesToPercent, } from "./normalizeStackedSeries";

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

@@ -0,0 +1,9 @@
+import { ResolvedChartSeries } from "../../types";
+/** 軸・tooltip 用のパーセント表示。小数第 1 位まで。 */
+export declare function formatChartPercentValue(value: number): string;
+/**
+ * stacked 系列をカテゴリごとに 0–100% に正規化する。
+ * null は維持し、0 以下は null として扱う（BarChart の棒描画ルールに合わせる）。
+ */
+export declare function normalizeStackedSeriesToPercent(series: readonly Pick<ResolvedChartSeries, "label" | "color" | "data">[]): ResolvedChartSeries[];
+export declare function getStackedPercentMaxValue(): number;

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

@@ -1,8 +1,13 @@
 export type ChartSeries = {
     /** 系列ごとに一意のラベル（凡例・表示切替のキー） */
     label: string;
-    /** null および 0 以下の値は棒として描画しない */
+    /**
+     * - BarChart: null および 0 以下は棒として描画しない
+     * - LineChart: null で線を途切れさせる。0 は有効（Y 軸は 0 起点、負の値のスケールは未対応）
+     */
     data: (number | null)[];
+    /** 未指定時は theme.palette.chart の系列色を使う */
+    color?: string;
 };
 export type BarChartLayout = "single" | "grouped" | "stacked";
 /** vertical: カテゴリが X 軸 / horizontal: カテゴリが Y 軸 */