@canvas-components/utils 0.2.3 → 0.2.4

package/dist/index.d.cts

@@ -4,3 +4,35 @@ export { ValueDataIndex, getValueByDataIndex, isSameDataIndex, stringifyDataInde
 export { formatDateTimeValue, isDateTimeFormatPattern, resolveDateValue } from './date/index.cjs';
 export { clamp, isPointInRect } from './geometry/index.cjs';
 export { ChineseNumberStyle, NumberFormatOptions, PreciseNumberInput, PreciseRoundingMode, addPreciseNumbers, comparePreciseNumbers, dividePreciseNumber, formatChineseNumber, formatCustomNumberPattern, formatNumberValue, formatPercentValue, formatPreciseNumber, formatScientificValue, normalizeDecimalPlaces, parseChineseNumber, parseNumberValue, roundPreciseNumber, sumPreciseNumbers } from './number/index.cjs';
+
+/** 单轴 Canvas 滚动条样式。尺寸单位均为 CSS 像素。 */
+interface CanvasScrollbarAxisOptions {
+    /** 是否显示；隐藏不禁用滚轮或程序滚动。 */
+    visible?: boolean;
+    /** 横向高度 / 纵向宽度，默认 10，最小 6。 */
+    thickness?: number;
+    /** 滑块填充颜色。 */
+    thumbColor?: string;
+    /** 滚动槽背景颜色，不传时保持表格背景。 */
+    trackColor?: string;
+    /** 两端箭头颜色。 */
+    buttonColor?: string;
+    /** 滑块圆角；不传时保持胶囊形状。 */
+    thumbRadius?: number;
+}
+/** 通用样式由单轴配置覆盖；全局 visible: false 隐藏两个方向。 */
+interface CanvasScrollbarOptions extends CanvasScrollbarAxisOptions {
+    horizontal?: CanvasScrollbarAxisOptions | false;
+    vertical?: CanvasScrollbarAxisOptions | false;
+}
+/** 合并通用与单轴配置，并归一化无效尺寸。 */
+declare function resolveCanvasScrollbarAxis(options: CanvasScrollbarOptions | undefined, axis: "horizontal" | "vertical"): {
+    visible: boolean;
+    thickness: number;
+    thumbColor: string;
+    trackColor: string | undefined;
+    buttonColor: string;
+    thumbRadius: number | undefined;
+};
+
+export { type CanvasScrollbarAxisOptions, type CanvasScrollbarOptions, resolveCanvasScrollbarAxis };

package/dist/index.d.ts

@@ -4,3 +4,35 @@ export { ValueDataIndex, getValueByDataIndex, isSameDataIndex, stringifyDataInde
 export { formatDateTimeValue, isDateTimeFormatPattern, resolveDateValue } from './date/index.js';
 export { clamp, isPointInRect } from './geometry/index.js';
 export { ChineseNumberStyle, NumberFormatOptions, PreciseNumberInput, PreciseRoundingMode, addPreciseNumbers, comparePreciseNumbers, dividePreciseNumber, formatChineseNumber, formatCustomNumberPattern, formatNumberValue, formatPercentValue, formatPreciseNumber, formatScientificValue, normalizeDecimalPlaces, parseChineseNumber, parseNumberValue, roundPreciseNumber, sumPreciseNumbers } from './number/index.js';
+
+/** 单轴 Canvas 滚动条样式。尺寸单位均为 CSS 像素。 */
+interface CanvasScrollbarAxisOptions {
+    /** 是否显示；隐藏不禁用滚轮或程序滚动。 */
+    visible?: boolean;
+    /** 横向高度 / 纵向宽度，默认 10，最小 6。 */
+    thickness?: number;
+    /** 滑块填充颜色。 */
+    thumbColor?: string;
+    /** 滚动槽背景颜色，不传时保持表格背景。 */
+    trackColor?: string;
+    /** 两端箭头颜色。 */
+    buttonColor?: string;
+    /** 滑块圆角；不传时保持胶囊形状。 */
+    thumbRadius?: number;
+}
+/** 通用样式由单轴配置覆盖；全局 visible: false 隐藏两个方向。 */
+interface CanvasScrollbarOptions extends CanvasScrollbarAxisOptions {
+    horizontal?: CanvasScrollbarAxisOptions | false;
+    vertical?: CanvasScrollbarAxisOptions | false;
+}
+/** 合并通用与单轴配置，并归一化无效尺寸。 */
+declare function resolveCanvasScrollbarAxis(options: CanvasScrollbarOptions | undefined, axis: "horizontal" | "vertical"): {
+    visible: boolean;
+    thickness: number;
+    thumbColor: string;
+    trackColor: string | undefined;
+    buttonColor: string;
+    thumbRadius: number | undefined;
+};
+
+export { type CanvasScrollbarAxisOptions, type CanvasScrollbarOptions, resolveCanvasScrollbarAxis };

package/dist/index.js

@@ -753,6 +753,21 @@ function isPointInRect(x, y, rect) {
   return x >= rect.x && x <= rect.x + rect.width && y >= rect.y && y <= rect.y + rect.height;
 }
 
+// src/canvas-scrollbar.ts
+function resolveCanvasScrollbarAxis(options, axis) {
+  const override = options?.[axis];
+  const merged = { ...options, ...override };
+  const thickness = Number.isFinite(merged.thickness) ? Math.max(merged.thickness, 6) : 10;
+  return {
+    visible: options?.visible !== false && override !== false && merged.visible !== false,
+    thickness,
+    thumbColor: merged.thumbColor ?? "rgba(100, 116, 139, 0.8)",
+    trackColor: merged.trackColor,
+    buttonColor: merged.buttonColor ?? "rgba(71, 85, 105, 0.88)",
+    thumbRadius: Number.isFinite(merged.thumbRadius) ? Math.max(merged.thumbRadius, 0) : void 0
+  };
+}
+
 // src/number/precise.ts
 function addPreciseNumbers(left, right) {
   const leftParts = parseDecimal(left);
@@ -1134,6 +1149,6 @@ function resolveThousandsSeparator(separator) {
   return ",";
 }
 
-export { addPreciseNumbers, buildCsvContent, buildTxtContent, clamp, comparePreciseNumbers, copyJson, copyRows, copyText, copyTextSync, dividePreciseNumber, downloadJsonFile, exportTableToCsv, exportTableToTxt, exportTableToXlsx, formatChineseNumber, formatCustomNumberPattern, formatDateTimeValue, formatNumberValue, formatPercentValue, formatPreciseNumber, formatRowsForClipboard, formatScientificValue, getValueByDataIndex, isDateTimeFormatPattern, isPointInRect, isSameDataIndex, mapRowsToExportRecords, normalizeDecimalPlaces, parseChineseNumber, parseNumberValue, resolveDateValue, roundPreciseNumber, serializeCsvRows, stringifyDataIndex, sumPreciseNumbers };
+export { addPreciseNumbers, buildCsvContent, buildTxtContent, clamp, comparePreciseNumbers, copyJson, copyRows, copyText, copyTextSync, dividePreciseNumber, downloadJsonFile, exportTableToCsv, exportTableToTxt, exportTableToXlsx, formatChineseNumber, formatCustomNumberPattern, formatDateTimeValue, formatNumberValue, formatPercentValue, formatPreciseNumber, formatRowsForClipboard, formatScientificValue, getValueByDataIndex, isDateTimeFormatPattern, isPointInRect, isSameDataIndex, mapRowsToExportRecords, normalizeDecimalPlaces, parseChineseNumber, parseNumberValue, resolveCanvasScrollbarAxis, resolveDateValue, roundPreciseNumber, serializeCsvRows, stringifyDataIndex, sumPreciseNumbers };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map