@damoqiongqiu/ice-chart 0.17.0

package/dist/types/layout/treemap.d.mts

@@ -0,0 +1,35 @@
+import type { Rect } from '../internal.mjs';
+import type { TreemapOption } from '../types.mjs';
+export interface TreemapInputNode {
+    name: string;
+    value?: number;
+    children?: TreemapInputNode[];
+    color?: string;
+}
+export interface TreemapNodeLayout {
+    /** 在扁平列表中的下标（命中判定返回它）。 */
+    id: number;
+    name: string;
+    depth: number;
+    parent: number;
+    /** 自身数值（有子节点时是子节点之和）。 */
+    value: number;
+    /** 占根总量比例（0~1）。 */
+    ratio: number;
+    rect: Rect;
+    /** 为「父节点标题带」预留的高度（0 表示没有标题带）。 */
+    header: number;
+    color: string;
+    hasChildren: boolean;
+}
+/**
+ * 矩形树图布局（squarified treemap）。
+ *
+ * 与 sankey 一样，这是「布局」而不是「坐标系」，因此做成纯函数：
+ * 输入层级数据与可用矩形，输出每个节点的矩形、颜色与层级；
+ * 绘制与命中判定消费同一份结果。
+ *
+ * squarified 的核心是「每一行都尽量接近正方形」：按数值降序贪心成行，
+ * 一旦加入下一个节点会让长宽比变差就换行，长宽比由此保持在可读范围内。
+ */
+export declare function layoutTreemap(data: TreemapInputNode[], rect: Rect, options?: TreemapOption, palette?: string[]): TreemapNodeLayout[];

package/dist/types/layout/treemap.d.ts

@@ -0,0 +1,35 @@
+import type { Rect } from '../internal';
+import type { TreemapOption } from '../types';
+export interface TreemapInputNode {
+    name: string;
+    value?: number;
+    children?: TreemapInputNode[];
+    color?: string;
+}
+export interface TreemapNodeLayout {
+    /** 在扁平列表中的下标（命中判定返回它）。 */
+    id: number;
+    name: string;
+    depth: number;
+    parent: number;
+    /** 自身数值（有子节点时是子节点之和）。 */
+    value: number;
+    /** 占根总量比例（0~1）。 */
+    ratio: number;
+    rect: Rect;
+    /** 为「父节点标题带」预留的高度（0 表示没有标题带）。 */
+    header: number;
+    color: string;
+    hasChildren: boolean;
+}
+/**
+ * 矩形树图布局（squarified treemap）。
+ *
+ * 与 sankey 一样，这是「布局」而不是「坐标系」，因此做成纯函数：
+ * 输入层级数据与可用矩形，输出每个节点的矩形、颜色与层级；
+ * 绘制与命中判定消费同一份结果。
+ *
+ * squarified 的核心是「每一行都尽量接近正方形」：按数值降序贪心成行，
+ * 一旦加入下一个节点会让长宽比变差就换行，长宽比由此保持在可读范围内。
+ */
+export declare function layoutTreemap(data: TreemapInputNode[], rect: Rect, options?: TreemapOption, palette?: string[]): TreemapNodeLayout[];

package/dist/types/option/normalize.d.mts

@@ -0,0 +1,68 @@
+import type { AxisOption, ChartOption } from '../types.mjs';
+import type { InternalSeries, NormalizedOption } from '../internal.mjs';
+/** 入场 / 更新 / 交互反馈三段动画的默认值。 */
+export declare const DEFAULT_ANIMATION_STAGES: {
+    enter: {
+        duration: number;
+        delay: number;
+        easing: string;
+        stagger: number;
+    };
+    update: {
+        duration: number;
+        delay: number;
+        easing: string;
+        stagger: number;
+    };
+    highlight: {
+        duration: number;
+        delay: number;
+        easing: string;
+        stagger: number;
+    };
+};
+/**
+ * 归一化动画配置：
+ * - 支持 `animation: false` 一键关闭；
+ * - 支持扁平写法（duration / easing / stagger）等价于 `enter` 的配置；
+ * - `enter / update / highlight` 三段可以分别配置或用 `false` 单独关闭。
+ */
+export declare function normalizeAnimation(input: any): any;
+export interface NormalizeContext {
+    hiddenIds?: Record<string, boolean>;
+    /** 被隐藏的扇区（饼图），key 为 `seriesId#dataIndex`。 */
+    hiddenSlices?: Record<string, boolean>;
+    /** 当前 x 数据域（数据缩放后）。不传表示自动。 */
+    xDomain?: [any, any] | null;
+    /** 主 y 轴的数据域（缩放后），等价于 yDomains[0]。 */
+    yDomain?: [number, number] | null;
+    /** 每个 y 轴的数据域（多轴时按 index 区分）。 */
+    yDomains?: Array<[number, number] | null>;
+}
+/**
+ * 把用户 option 归一化成内部结构：数据点、坐标轴类型、数据域、堆叠基线。
+ *
+ * 这一步是纯计算、无副作用、不依赖 DOM / ctx，因此可以被完整单测覆盖。
+ */
+export declare function normalizeOption(option: ChartOption, context?: NormalizeContext): NormalizedOption;
+/** 是否为横向排布：声明了类目 y 轴（type: 'category' 或给了 data），而 x 轴不是类目轴。 */
+export declare function isHorizontalLayout(xAxis: AxisOption, yAxis: AxisOption): boolean;
+/**
+ * 类目轴上的类目列表：
+ * 1. 轴自己声明的 data（ECharts 写法，横向柱状图常用）；
+ * 2. 否则从数据项推导 —— 对象数据的 name、或 xValue（我们内部统一用 xValue 存「类目」这一维）。
+ */
+export declare function buildCategoryValues(option: AxisOption, series: InternalSeries[]): any[];
+/**
+ * 把轴上声明的类目按**下标**回填到数据点。
+ *
+ * 只在「数据点没有自带类目」时回填（默认 xValue === index），
+ * 这样 `{name:'A', value:1}` 这类自带类目的数据不会被覆盖。
+ */
+export declare function applyAxisCategories(axis: AxisOption, series: InternalSeries[]): void;
+/** 箱线图：原始观测值 → [min, Q1, median, Q3, max]（五数概括）。 */
+/** 矩形树图节点的数值：有子节点时取子节点之和。 */
+export declare function treemapNodeValue(node: any): number;
+export declare function computeBoxplotSummary(values: number[]): [number, number, number, number, number];
+/** 从 option 里剔除函数与 undefined，得到可 JSON 序列化的配置。 */
+export declare function toSerializableOption(option: any): any;

package/dist/types/option/normalize.d.ts

@@ -0,0 +1,68 @@
+import type { AxisOption, ChartOption } from '../types';
+import type { InternalSeries, NormalizedOption } from '../internal';
+/** 入场 / 更新 / 交互反馈三段动画的默认值。 */
+export declare const DEFAULT_ANIMATION_STAGES: {
+    enter: {
+        duration: number;
+        delay: number;
+        easing: string;
+        stagger: number;
+    };
+    update: {
+        duration: number;
+        delay: number;
+        easing: string;
+        stagger: number;
+    };
+    highlight: {
+        duration: number;
+        delay: number;
+        easing: string;
+        stagger: number;
+    };
+};
+/**
+ * 归一化动画配置：
+ * - 支持 `animation: false` 一键关闭；
+ * - 支持扁平写法（duration / easing / stagger）等价于 `enter` 的配置；
+ * - `enter / update / highlight` 三段可以分别配置或用 `false` 单独关闭。
+ */
+export declare function normalizeAnimation(input: any): any;
+export interface NormalizeContext {
+    hiddenIds?: Record<string, boolean>;
+    /** 被隐藏的扇区（饼图），key 为 `seriesId#dataIndex`。 */
+    hiddenSlices?: Record<string, boolean>;
+    /** 当前 x 数据域（数据缩放后）。不传表示自动。 */
+    xDomain?: [any, any] | null;
+    /** 主 y 轴的数据域（缩放后），等价于 yDomains[0]。 */
+    yDomain?: [number, number] | null;
+    /** 每个 y 轴的数据域（多轴时按 index 区分）。 */
+    yDomains?: Array<[number, number] | null>;
+}
+/**
+ * 把用户 option 归一化成内部结构：数据点、坐标轴类型、数据域、堆叠基线。
+ *
+ * 这一步是纯计算、无副作用、不依赖 DOM / ctx，因此可以被完整单测覆盖。
+ */
+export declare function normalizeOption(option: ChartOption, context?: NormalizeContext): NormalizedOption;
+/** 是否为横向排布：声明了类目 y 轴（type: 'category' 或给了 data），而 x 轴不是类目轴。 */
+export declare function isHorizontalLayout(xAxis: AxisOption, yAxis: AxisOption): boolean;
+/**
+ * 类目轴上的类目列表：
+ * 1. 轴自己声明的 data（ECharts 写法，横向柱状图常用）；
+ * 2. 否则从数据项推导 —— 对象数据的 name、或 xValue（我们内部统一用 xValue 存「类目」这一维）。
+ */
+export declare function buildCategoryValues(option: AxisOption, series: InternalSeries[]): any[];
+/**
+ * 把轴上声明的类目按**下标**回填到数据点。
+ *
+ * 只在「数据点没有自带类目」时回填（默认 xValue === index），
+ * 这样 `{name:'A', value:1}` 这类自带类目的数据不会被覆盖。
+ */
+export declare function applyAxisCategories(axis: AxisOption, series: InternalSeries[]): void;
+/** 箱线图：原始观测值 → [min, Q1, median, Q3, max]（五数概括）。 */
+/** 矩形树图节点的数值：有子节点时取子节点之和。 */
+export declare function treemapNodeValue(node: any): number;
+export declare function computeBoxplotSummary(values: number[]): [number, number, number, number, number];
+/** 从 option 里剔除函数与 undefined，得到可 JSON 序列化的配置。 */
+export declare function toSerializableOption(option: any): any;

package/dist/types/scale/BandScale.d.mts

@@ -0,0 +1,36 @@
+import type { Scale } from './Scale.mjs';
+import type { CreateScaleOptions } from './Scale.mjs';
+/**
+ * 类目（band）比例尺。
+ *
+ * 单位约定：`map(category)` 返回 band 的**中心**（折线点 / 散点用），
+ * `bandStart(category)` 返回 band 起点（柱形用）。这与 d3.scaleBand + 手动取中心的写法一致，
+ * 但避免了「柱子和折线对不上」的经典偏移 bug。
+ */
+export declare class BandScale implements Scale {
+    readonly type: "category";
+    domain: any[];
+    range: [number, number];
+    private paddingInner;
+    private paddingOuter;
+    private _step;
+    constructor(domain: any[], range: [number, number], options?: CreateScaleOptions);
+    private computeStep;
+    private indexOf;
+    map(value: any): number;
+    bandStart(value: any, index?: number): number;
+    bandwidth(): number;
+    step(): number;
+    isBand(): boolean;
+    ticks(): any[];
+    indexAt(pixel: number): number;
+    /** 类目轴的反向查找：优先返回命中的类目，否则返回最近的类目（便于 axis 触发器的「最近列」语义）。 */
+    invert(pixel: number): any;
+    /** 最近类目下标：命中带内直接返回，否则返回最近的（轴提示器需要）。 */
+    nearestIndex(pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): any;
+    span(): number;
+    format(value: any): string;
+    clone(): BandScale;
+}

package/dist/types/scale/BandScale.d.ts

@@ -0,0 +1,36 @@
+import type { Scale } from './Scale';
+import type { CreateScaleOptions } from './Scale';
+/**
+ * 类目（band）比例尺。
+ *
+ * 单位约定：`map(category)` 返回 band 的**中心**（折线点 / 散点用），
+ * `bandStart(category)` 返回 band 起点（柱形用）。这与 d3.scaleBand + 手动取中心的写法一致，
+ * 但避免了「柱子和折线对不上」的经典偏移 bug。
+ */
+export declare class BandScale implements Scale {
+    readonly type: "category";
+    domain: any[];
+    range: [number, number];
+    private paddingInner;
+    private paddingOuter;
+    private _step;
+    constructor(domain: any[], range: [number, number], options?: CreateScaleOptions);
+    private computeStep;
+    private indexOf;
+    map(value: any): number;
+    bandStart(value: any, index?: number): number;
+    bandwidth(): number;
+    step(): number;
+    isBand(): boolean;
+    ticks(): any[];
+    indexAt(pixel: number): number;
+    /** 类目轴的反向查找：优先返回命中的类目，否则返回最近的类目（便于 axis 触发器的「最近列」语义）。 */
+    invert(pixel: number): any;
+    /** 最近类目下标：命中带内直接返回，否则返回最近的（轴提示器需要）。 */
+    nearestIndex(pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): any;
+    span(): number;
+    format(value: any): string;
+    clone(): BandScale;
+}

package/dist/types/scale/LinearScale.d.mts

@@ -0,0 +1,21 @@
+import type { Scale } from './Scale.mjs';
+/** 连续数值比例尺。 */
+export declare class LinearScale implements Scale {
+    readonly type: "linear";
+    domain: [number, number];
+    range: [number, number];
+    constructor(domain: [number, number], range: [number, number]);
+    map(value: any): number;
+    invert(pixel: number): number;
+    ticks(count?: number): number[];
+    bandwidth(): number;
+    bandStart(value: any): number;
+    step(): number;
+    isBand(): boolean;
+    indexAt(_pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): number;
+    span(): number;
+    format(value: any, _index: number): string;
+    clone(): LinearScale;
+}

package/dist/types/scale/LinearScale.d.ts

@@ -0,0 +1,21 @@
+import type { Scale } from './Scale';
+/** 连续数值比例尺。 */
+export declare class LinearScale implements Scale {
+    readonly type: "linear";
+    domain: [number, number];
+    range: [number, number];
+    constructor(domain: [number, number], range: [number, number]);
+    map(value: any): number;
+    invert(pixel: number): number;
+    ticks(count?: number): number[];
+    bandwidth(): number;
+    bandStart(value: any): number;
+    step(): number;
+    isBand(): boolean;
+    indexAt(_pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): number;
+    span(): number;
+    format(value: any, _index: number): string;
+    clone(): LinearScale;
+}

package/dist/types/scale/LogScale.d.mts

@@ -0,0 +1,24 @@
+import type { Scale } from './Scale.mjs';
+import type { CreateScaleOptions } from './Scale.mjs';
+/** 对数比例尺（数据域必须为正数）。 */
+export declare class LogScale implements Scale {
+    readonly type: "log";
+    domain: [number, number];
+    range: [number, number];
+    base: number;
+    constructor(domain: [number, number], range: [number, number], options?: CreateScaleOptions);
+    private log;
+    map(value: any): number;
+    invert(pixel: number): number;
+    ticks(count?: number): number[];
+    bandwidth(): number;
+    bandStart(value: any): number;
+    step(): number;
+    isBand(): boolean;
+    indexAt(_pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): number;
+    span(): number;
+    format(value: any, _index: number): string;
+    clone(): LogScale;
+}

package/dist/types/scale/LogScale.d.ts

@@ -0,0 +1,24 @@
+import type { Scale } from './Scale';
+import type { CreateScaleOptions } from './Scale';
+/** 对数比例尺（数据域必须为正数）。 */
+export declare class LogScale implements Scale {
+    readonly type: "log";
+    domain: [number, number];
+    range: [number, number];
+    base: number;
+    constructor(domain: [number, number], range: [number, number], options?: CreateScaleOptions);
+    private log;
+    map(value: any): number;
+    invert(pixel: number): number;
+    ticks(count?: number): number[];
+    bandwidth(): number;
+    bandStart(value: any): number;
+    step(): number;
+    isBand(): boolean;
+    indexAt(_pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): number;
+    span(): number;
+    format(value: any, _index: number): string;
+    clone(): LogScale;
+}

package/dist/types/scale/Scale.d.mts

@@ -0,0 +1,38 @@
+import type { ScaleType } from '../types.mjs';
+/**
+ * 比例尺：数据域 ↔ 像素域的唯一换算入口。
+ *
+ * 与 d3-scale 的取舍：只保留图表真正需要的部分（band / linear / time / log），
+ * 不引入运行时依赖。`fractionOf / valueAtFraction` 是**跨图联动**的基础：
+ * 不同图表尺寸不同，但同一个数值对应的 0~1 比例是稳定的。
+ */
+export interface Scale {
+    readonly type: ScaleType;
+    domain: any[];
+    range: [number, number];
+    map(value: any): number;
+    invert(pixel: number): any;
+    ticks(count?: number): any[];
+    bandwidth(): number;
+    /** 类目轴上单个类目带的起点；非类目轴返回 map(value)。 */
+    bandStart(value: any, index?: number): number;
+    step(): number;
+    isBand(): boolean;
+    /** 像素落在哪个类目带内；-1 表示不在任何带内。非类目轴恒为 -1。 */
+    indexAt(pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): any;
+    /** 数据域跨度（类目轴为类目数，数值轴为 max-min）。 */
+    span(): number;
+    /** 轴标签的默认格式化。 */
+    format(value: any, index: number): string;
+    clone(): Scale;
+}
+export interface CreateScaleOptions {
+    paddingInner?: number;
+    paddingOuter?: number;
+    logBase?: number;
+    /** 时间刻度的期望数量。 */
+    tickCount?: number;
+}
+export declare function createScale(type: ScaleType, domain: any[], range: [number, number], options?: CreateScaleOptions): Scale;

package/dist/types/scale/Scale.d.ts

@@ -0,0 +1,38 @@
+import type { ScaleType } from '../types';
+/**
+ * 比例尺：数据域 ↔ 像素域的唯一换算入口。
+ *
+ * 与 d3-scale 的取舍：只保留图表真正需要的部分（band / linear / time / log），
+ * 不引入运行时依赖。`fractionOf / valueAtFraction` 是**跨图联动**的基础：
+ * 不同图表尺寸不同，但同一个数值对应的 0~1 比例是稳定的。
+ */
+export interface Scale {
+    readonly type: ScaleType;
+    domain: any[];
+    range: [number, number];
+    map(value: any): number;
+    invert(pixel: number): any;
+    ticks(count?: number): any[];
+    bandwidth(): number;
+    /** 类目轴上单个类目带的起点；非类目轴返回 map(value)。 */
+    bandStart(value: any, index?: number): number;
+    step(): number;
+    isBand(): boolean;
+    /** 像素落在哪个类目带内；-1 表示不在任何带内。非类目轴恒为 -1。 */
+    indexAt(pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): any;
+    /** 数据域跨度（类目轴为类目数，数值轴为 max-min）。 */
+    span(): number;
+    /** 轴标签的默认格式化。 */
+    format(value: any, index: number): string;
+    clone(): Scale;
+}
+export interface CreateScaleOptions {
+    paddingInner?: number;
+    paddingOuter?: number;
+    logBase?: number;
+    /** 时间刻度的期望数量。 */
+    tickCount?: number;
+}
+export declare function createScale(type: ScaleType, domain: any[], range: [number, number], options?: CreateScaleOptions): Scale;

package/dist/types/scale/TimeScale.d.mts

@@ -0,0 +1,28 @@
+import type { Scale } from './Scale.mjs';
+import type { CreateScaleOptions } from './Scale.mjs';
+type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'mo' | 'y';
+/** 时间轴标签格式：粒度越粗，展示的单位越大。 */
+export declare function formatTime(timestamp: number, unit: TimeUnit, span: number): string;
+/** 时间比例尺：数据域用时间戳（number）表示。 */
+export declare class TimeScale implements Scale {
+    readonly type: "time";
+    domain: [number, number];
+    range: [number, number];
+    constructor(domain: [number, number], range: [number, number], _options?: CreateScaleOptions);
+    map(value: any): number;
+    invert(pixel: number): number;
+    private pickInterval;
+    ticks(count?: number): number[];
+    bandwidth(): number;
+    bandStart(value: any): number;
+    step(): number;
+    isBand(): boolean;
+    indexAt(_pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): number;
+    span(): number;
+    format(value: any, _index: number): string;
+    clone(): TimeScale;
+}
+export declare function toTimestamp(value: any): number;
+export {};

package/dist/types/scale/TimeScale.d.ts

@@ -0,0 +1,28 @@
+import type { Scale } from './Scale';
+import type { CreateScaleOptions } from './Scale';
+type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'mo' | 'y';
+/** 时间轴标签格式：粒度越粗，展示的单位越大。 */
+export declare function formatTime(timestamp: number, unit: TimeUnit, span: number): string;
+/** 时间比例尺：数据域用时间戳（number）表示。 */
+export declare class TimeScale implements Scale {
+    readonly type: "time";
+    domain: [number, number];
+    range: [number, number];
+    constructor(domain: [number, number], range: [number, number], _options?: CreateScaleOptions);
+    map(value: any): number;
+    invert(pixel: number): number;
+    private pickInterval;
+    ticks(count?: number): number[];
+    bandwidth(): number;
+    bandStart(value: any): number;
+    step(): number;
+    isBand(): boolean;
+    indexAt(_pixel: number): number;
+    fractionOf(value: any): number;
+    valueAtFraction(fraction: number): number;
+    span(): number;
+    format(value: any, _index: number): string;
+    clone(): TimeScale;
+}
+export declare function toTimestamp(value: any): number;
+export {};

package/dist/types/scale/format.d.mts

@@ -0,0 +1,5 @@
+import type { Scale } from './Scale.mjs';
+/** 数值轴的默认标签格式（按步长自适应精度）。 */
+export declare function formatNumberTick(value: number, step: number): string;
+/** 轴标签格式化：优先用用户的 formatter，其次按比例尺类型自适应。 */
+export declare function formatTick(value: any, scale: Scale, index: number, formatter?: (v: any, i: number) => string): string;

package/dist/types/scale/format.d.ts

@@ -0,0 +1,5 @@
+import type { Scale } from './Scale';
+/** 数值轴的默认标签格式（按步长自适应精度）。 */
+export declare function formatNumberTick(value: number, step: number): string;
+/** 轴标签格式化：优先用用户的 formatter，其次按比例尺类型自适应。 */
+export declare function formatTick(value: any, scale: Scale, index: number, formatter?: (v: any, i: number) => string): string;

package/dist/types/scale/index.d.mts

@@ -0,0 +1,7 @@
+export type { Scale, CreateScaleOptions } from './Scale.mjs';
+export { createScale } from './Scale.mjs';
+export { formatTick, formatNumberTick } from './format.mjs';
+export { LinearScale } from './LinearScale.mjs';
+export { BandScale } from './BandScale.mjs';
+export { TimeScale } from './TimeScale.mjs';
+export { LogScale } from './LogScale.mjs';

package/dist/types/scale/index.d.ts

@@ -0,0 +1,7 @@
+export type { Scale, CreateScaleOptions } from './Scale';
+export { createScale } from './Scale';
+export { formatTick, formatNumberTick } from './format';
+export { LinearScale } from './LinearScale';
+export { BandScale } from './BandScale';
+export { TimeScale } from './TimeScale';
+export { LogScale } from './LogScale';

package/dist/types/theme/chartTheme.d.mts

@@ -0,0 +1,54 @@
+import type { ChartTheme } from '../types.mjs';
+/**
+ * 主题基调：**Bootstrap 5**。
+ *
+ * 取的是 Bootstrap 官方调色板与设计变量（primary/secondary/success/danger/warning/info、
+ * gray-100~900、`$border-radius: .375rem`、系统字体栈），这样图表放在 Bootstrap 页面里
+ * 与按钮、卡片、表格是同一套视觉语言，不需要额外对齐色板。
+ *
+ * 说明：`colorPalette` 的前几位刻意排成「primary → success → danger → info → indigo」，
+ * 把低对比度的 `warning` 黄往后放 —— 折线/散点用黄色在浅色底上辨识度差，
+ * 但作为第 6 个系列色出现时是安全的。
+ */
+/** Bootstrap 5 调色板（官方 hex 值）。 */
+export declare const BOOTSTRAP_TOKENS: {
+    readonly primary: "#0D6EFD";
+    readonly secondary: "#6C757D";
+    readonly success: "#198754";
+    readonly danger: "#DC3545";
+    readonly warning: "#FFC107";
+    readonly info: "#0DCAF0";
+    readonly light: "#F8F9FA";
+    readonly dark: "#212529";
+    readonly indigo: "#6610F2";
+    readonly purple: "#6F42C1";
+    readonly pink: "#D63384";
+    readonly orange: "#FD7E14";
+    readonly teal: "#20C997";
+    readonly cyan: "#0DCAF0";
+    readonly gray: {
+        readonly 100: "#F8F9FA";
+        readonly 200: "#E9ECEF";
+        readonly 300: "#DEE2E6";
+        readonly 400: "#CED4DA";
+        readonly 500: "#ADB5BD";
+        readonly 600: "#6C757D";
+        readonly 700: "#495057";
+        readonly 800: "#343A40";
+        readonly 900: "#212529";
+    };
+    /** Bootstrap 的 --bs-body-font-family。 */
+    readonly fontFamily: "system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"PingFang SC\", \"Microsoft YaHei\", sans-serif";
+    /** --bs-border-radius */
+    readonly radius: 6;
+};
+/** 亮色主题（Bootstrap 默认外观）。 */
+export declare const BOOTSTRAP_CHART_THEME: ChartTheme;
+/** 暗色主题（Bootstrap 5 `data-bs-theme="dark"` 的中性灰基调）。 */
+export declare const BOOTSTRAP_DARK_CHART_THEME: ChartTheme;
+/** 兼容旧名字：light 主题现在就是 Bootstrap 主题。 */
+export declare const LIGHT_CHART_THEME: ChartTheme;
+/** 兼容旧名字：dark 主题。 */
+export declare const DARK_CHART_THEME: ChartTheme;
+/** 解析主题：'light'（默认，Bootstrap）/ 'dark' / 'auto' / 自定义片段（浅合并到亮色主题）。 */
+export declare function resolveChartTheme(theme: ChartTheme | 'light' | 'dark' | 'auto' | Partial<ChartTheme> | undefined): ChartTheme;

package/dist/types/theme/chartTheme.d.ts

@@ -0,0 +1,54 @@
+import type { ChartTheme } from '../types';
+/**
+ * 主题基调：**Bootstrap 5**。
+ *
+ * 取的是 Bootstrap 官方调色板与设计变量（primary/secondary/success/danger/warning/info、
+ * gray-100~900、`$border-radius: .375rem`、系统字体栈），这样图表放在 Bootstrap 页面里
+ * 与按钮、卡片、表格是同一套视觉语言，不需要额外对齐色板。
+ *
+ * 说明：`colorPalette` 的前几位刻意排成「primary → success → danger → info → indigo」，
+ * 把低对比度的 `warning` 黄往后放 —— 折线/散点用黄色在浅色底上辨识度差，
+ * 但作为第 6 个系列色出现时是安全的。
+ */
+/** Bootstrap 5 调色板（官方 hex 值）。 */
+export declare const BOOTSTRAP_TOKENS: {
+    readonly primary: "#0D6EFD";
+    readonly secondary: "#6C757D";
+    readonly success: "#198754";
+    readonly danger: "#DC3545";
+    readonly warning: "#FFC107";
+    readonly info: "#0DCAF0";
+    readonly light: "#F8F9FA";
+    readonly dark: "#212529";
+    readonly indigo: "#6610F2";
+    readonly purple: "#6F42C1";
+    readonly pink: "#D63384";
+    readonly orange: "#FD7E14";
+    readonly teal: "#20C997";
+    readonly cyan: "#0DCAF0";
+    readonly gray: {
+        readonly 100: "#F8F9FA";
+        readonly 200: "#E9ECEF";
+        readonly 300: "#DEE2E6";
+        readonly 400: "#CED4DA";
+        readonly 500: "#ADB5BD";
+        readonly 600: "#6C757D";
+        readonly 700: "#495057";
+        readonly 800: "#343A40";
+        readonly 900: "#212529";
+    };
+    /** Bootstrap 的 --bs-body-font-family。 */
+    readonly fontFamily: "system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"PingFang SC\", \"Microsoft YaHei\", sans-serif";
+    /** --bs-border-radius */
+    readonly radius: 6;
+};
+/** 亮色主题（Bootstrap 默认外观）。 */
+export declare const BOOTSTRAP_CHART_THEME: ChartTheme;
+/** 暗色主题（Bootstrap 5 `data-bs-theme="dark"` 的中性灰基调）。 */
+export declare const BOOTSTRAP_DARK_CHART_THEME: ChartTheme;
+/** 兼容旧名字：light 主题现在就是 Bootstrap 主题。 */
+export declare const LIGHT_CHART_THEME: ChartTheme;
+/** 兼容旧名字：dark 主题。 */
+export declare const DARK_CHART_THEME: ChartTheme;
+/** 解析主题：'light'（默认，Bootstrap）/ 'dark' / 'auto' / 自定义片段（浅合并到亮色主题）。 */
+export declare function resolveChartTheme(theme: ChartTheme | 'light' | 'dark' | 'auto' | Partial<ChartTheme> | undefined): ChartTheme;