@compass-framework/worksheet-layout 1.0.81 → 1.0.83

package/@types/source/SheetSource.ts

@@ -0,0 +1,77 @@
+import { SheetSourceObserver } from "./SheetSourceObserver";
+import { SheetView } from "./SheetView";
+import { SheetStyle } from "./SheetStyle";
+
+/**
+ * 工作表数据源。
+ *
+ * 统一约定：
+ * - 行号、列号均从 0 开始；
+ * - 所有尺寸单位都是内容逻辑像素（会再经过 WorksheetLayout 的 zoom 缩放后显示），不是屏幕像素；
+ * - 带 start/end 的区间接口均为闭区间 [start, end]；
+ * - 带 index 的接口表示单个行/列的索引。
+ */
+export interface SheetSource {
+  /**
+   * 取消订阅工作表数据变化。
+   */
+  unsubscribe(obs: SheetSourceObserver): void;
+
+  /**
+   * 订阅工作表数据变化。
+   */
+  subscribe(obs: SheetSourceObserver): void;
+
+  /**
+   * 获取当前激活的工作表视图（包含冻结窗格等信息）。
+   */
+  getSheetView(): SheetView;
+
+  /**
+   * 获取工作表外观配置（背景色、冻结分割线样式等）。
+   * 未实现时使用 DEFAULT_WORKSHEET_STYLE。
+   */
+  getSheetStyle?(): SheetStyle;
+
+  /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+  /**
+   * 获取第 rowIndex 行顶部的 Y 偏移，即第 0 行到第 rowIndex - 1 行的高度之和。
+   * 等价于 getRowsHeight(0, rowIndex - 1)，rowIndex <= 0 时返回 0。
+   * @param rowIndex 行号（0 基）
+   */
+  getRowTop(rowIndex: number): number;
+
+  /**
+   * 获取第 columnIndex 列左侧的 X 偏移，即第 0 列到第 columnIndex - 1 列的宽度之和。
+   * 等价于 getColumnsWidth(0, columnIndex - 1)，columnIndex <= 0 时返回 0。
+   * @param columnIndex 列号（0 基）
+   */
+  getColumnLeft(columnIndex: number): number;
+
+  /**
+   * 获取指定行的高度。
+   * @param rowIndex 行号（0 基）
+   */
+  getRowHeight(rowIndex: number): number;
+
+  /**
+   * 获取指定列的宽度。
+   * @param columnIndex 列号（0 基）
+   */
+  getColumnWidth(columnIndex: number): number;
+
+  /**
+   * 获取 [startRow, endRow] 闭区间内所有行的高度之和。
+   * @param startRow 起始行号（包含）
+   * @param endRow 结束行号（包含）
+   */
+  getRowsHeight(startRow: number, endRow: number): number;
+
+  /**
+   * 获取 [startColumn, endColumn] 闭区间内所有列的宽度之和。
+   * @param startColumn 起始列号（包含）
+   * @param endColumn 结束列号（包含）
+   */
+  getColumnsWidth(startColumn: number, endColumn: number): number;
+}

package/@types/source/SheetSourceObserver.ts

@@ -0,0 +1,7 @@
+export class SheetSourceObserver {
+  onFreezePaneChanged(): void {}
+
+  onRowsHeighChanged(): void {}
+
+  onColumnsWidthChanged(): void {}
+}

package/@types/source/SheetStyle.ts

@@ -0,0 +1,63 @@
+/**
+ * 工作表外观配置。
+ *
+ * 所有颜色均为 ARGB 整数（如 Color.WHITE），尺寸单位为内容逻辑像素。
+ */
+export interface SheetStyle {
+  /**
+     * 分页视图的页面背景色。
+     */
+  pageColor?: number;
+
+  /**
+     * 页面背景色。
+     * 返回 Color.TRANSPARENT 表示不绘制背景。
+     */
+  backgroundColor?: number;
+
+  /**
+     * 页面宽度（内容逻辑像素）。
+     */
+  pageWidth?: number;
+
+  /**
+     * 页面高度（内容逻辑像素）。
+     */
+  pageHeight?: number;
+
+  /**
+     * 页面上边距。
+     */
+  pageMarginTop?: number;
+
+  /**
+     * 页面右边距。
+     */
+  pageMarginRight?: number;
+
+  /**
+     * 页面下边距。
+     */
+  pageMarginBottom?: number;
+
+  /**
+     * 页面左边距。
+     */
+  pageMarginLeft?: number;
+
+  /**
+     * 页面之间的间距。
+     */
+  pageGap?: number;
+
+  /**
+     * 冻结分割线颜色。
+     */
+  freezeDividerColor?: number;
+
+  /**
+     * 冻结分割线宽度。
+     * 小于等于 0 表示不绘制分割线。
+     */
+  freezeDividerStrokeWidth?: number;
+}

package/@types/source/SheetView.ts

@@ -0,0 +1,8 @@
+import { SheetViewPane } from "./SheetViewPane";
+
+export interface SheetView {
+  /**
+   * 获取当前工作表的窗格信息（冻结拆分、左上角单元格等）。
+   */
+  getPane(): SheetViewPane;
+}

package/@types/source/SheetViewPane.ts

@@ -0,0 +1,28 @@
+export interface XSplitPane {
+  getColumnCount(): number;
+}
+
+export interface YSplitPane {
+  getRowCount(): number;
+}
+
+export interface XYSplitPane {
+  getColumnCount(): number;
+  getRowCount(): number;
+}
+
+export interface SheetViewPane {
+  getTopLeftCell(): [number, number];
+
+  isXSplitPane(): boolean;
+
+  isYSplitPane(): boolean;
+
+  isXYSplitPane(): boolean;
+
+  getXSplitPane(): XSplitPane;
+
+  getYSplitPane(): YSplitPane;
+
+  getXYSplitPane(): XYSplitPane;
+}

package/@types/widget/WorksheetContent.d.ts

@@ -10,13 +10,13 @@ import {
   Drawable,
 } from "@compass-framework/core";
 
-import { WorksheetObserver } from "../source/WorksheetObserver";
 import { ViewMode } from "../content/ViewMode";
-import { WorksheetSource } from "../source/WorksheetSource";
 import { HorizontalSegment } from "../content/HorizontalSegment";
 import { VerticalSegment } from "../content/VerticalSegment";
+import { SheetSourceObserver } from "../source/SheetSourceObserver";
+import { SheetSource } from "../source/SheetSource";
 
-export declare class WorksheetContent extends AbsoluteLayout implements WorksheetObserver, View.OnGenericMotionListener {
+export declare class WorksheetContent extends AbsoluteLayout implements SheetSourceObserver, View.OnGenericMotionListener {
   constructor(context: Context);
   constructor(context: Context, attrs: AttributeSet);
   onGenericMotion(v: View, event: MotionEvent): boolean;
@@ -51,11 +51,11 @@ export declare class WorksheetContent extends AbsoluteLayout implements Workshee
   superGetBackground(): Drawable;
   superGetTargetOffsetScrollY(): number;
   superGetTargetOffsetScrollX(): number;
-  getWorksheetSource(): WorksheetSource;
+  getWorksheetSource(): SheetSource;
   getMotionEventCoords(event: MotionEvent): number[];
   getViewMode(): ViewMode;
   getVerticalSegment(): VerticalSegment[];
   getHorizontalSegment(): HorizontalSegment[];
   setViewMode(viewMode: ViewMode): void;
-  setWorksheetSource(worksheetSource: WorksheetSource): void;
+  setWorksheetSource(source: SheetSource): void;
 }

package/index.d.ts

@@ -13,10 +13,10 @@ export * from "./@types/drawable/WorksheetContentDrawable";
 
 export * from "./@types/layout/WorksheetLayout";
 
-export * from "./@types/source/WorksheetSource";
-export * from "./@types/source/WorksheetObserver";
-export * from "./@types/source/Pane";
+export * from "./@types/source/SheetSource";
+export * from "./@types/source/SheetSourceObserver";
+export * from "./@types/source/SheetStyle";
 export * from "./@types/source/SheetView";
-export * from "./@types/source/CellAddress";
+export * from "./@types/source/SheetViewPane";
 
 export * from "./@types/widget/WorksheetContent";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compass-framework/worksheet-layout",
-  "version": "1.0.81",
+  "version": "1.0.83",
   "description": "@compass-framework/worksheet-layout public api",
   "types": "./index.d.ts",
   "main": "./index.js",

package/@types/source/CellAddress.d.ts

@@ -1,4 +0,0 @@
-export interface CellAddress {
-  getRow(): number;
-  getColumn(): number;
-}

package/@types/source/Pane.d.ts

@@ -1,21 +0,0 @@
-import { CellAddress } from "./CellAddress";
-
-export interface XSplit {
-  getColumnCount(): number;
-}
-export interface YSplit {
-  getRowCount(): number;
-}
-export interface XYSplit {
-  getColumnCount(): number;
-  getRowCount(): number;
-}
-export interface Pane {
-  getTopLeftCell(): CellAddress;
-  isXSplit(): boolean;
-  isYSplit(): boolean;
-  isXYSplit(): boolean;
-  getXSplit(): XSplit;
-  getYSplit(): YSplit;
-  getXYSplit(): XYSplit;
-}

package/@types/source/SheetView.d.ts

@@ -1,12 +0,0 @@
-import { Pane } from "./Pane";
-
-export interface SheetView {
-  /**
-     * 获取当前工作表的窗格信息（冻结拆分、左上角单元格等）。
-     */
-  getPane(): Pane;
-}
-/**
- * 默认工作表视图：无列冻结，顶部冻结 5 行。
- */
-export declare const DEFAULT_SHEET_VIEW: SheetView;

package/@types/source/WorksheetObserver.d.ts

@@ -1,5 +0,0 @@
-export declare class WorksheetObserver {
-  onFreezePaneChanged(): void;
-  onRowsHeighChanged(): void;
-  onColumnsWidthChanged(): void;
-}

package/@types/source/WorksheetSource.d.ts

@@ -1,120 +0,0 @@
-import { SheetView } from "./SheetView";
-/**
- * 工作表外观配置。
- *
- * 所有颜色均为 ARGB 整数（如 Color.WHITE），尺寸单位为内容逻辑像素。
- */
-export interface WorksheetStyle {
-  /**
-     * 页面背景色。
-     * 返回 Color.TRANSPARENT 表示不绘制背景。
-     */
-  backgroundColor?: number;
-  /**
-     * 冻结分割线颜色。
-     */
-  freezeDividerColor?: number;
-  /**
-     * 冻结分割线宽度。
-     * 小于等于 0 表示不绘制分割线。
-     */
-  freezeDividerStrokeWidth?: number;
-  /**
-     * 分页视图的页面背景色。
-     */
-  pageColor?: number;
-  /**
-     * 页面宽度（内容逻辑像素）。
-     */
-  pageWidth?: number;
-  /**
-     * 页面高度（内容逻辑像素）。
-     */
-  pageHeight?: number;
-  /**
-     * 页面上边距。
-     */
-  pageMarginTop?: number;
-  /**
-     * 页面右边距。
-     */
-  pageMarginRight?: number;
-  /**
-     * 页面下边距。
-     */
-  pageMarginBottom?: number;
-  /**
-     * 页面左边距。
-     */
-  pageMarginLeft?: number;
-  /**
-     * 页面之间的间距。
-     */
-  pageGap?: number;
-}
-/**
- * 默认工作表外观配置。
- */
-export declare const DEFAULT_WORKSHEET_STYLE: WorksheetStyle;
-/**
- * 工作表数据源。
- *
- * 统一约定：
- * - 行号、列号均从 0 开始；
- * - 所有尺寸单位都是内容逻辑像素（会再经过 WorksheetLayout 的 zoom 缩放后显示），不是屏幕像素；
- * - 带 start/end 的区间接口均为闭区间 [start, end]；
- * - 带 index 的接口表示单个行/列的索引。
- */
-export interface WorksheetSource {
-  /**
-     * 订阅工作表数据变化。
-     */
-  subscribe(): void;
-  /**
-     * 取消订阅工作表数据变化。
-     */
-  unsubscribe(): void;
-  /**
-     * 获取当前激活的工作表视图（包含冻结窗格等信息）。
-     */
-  getActiveSheetView(): SheetView;
-  /**
-     * 获取工作表外观配置（背景色、冻结分割线样式等）。
-     * 未实现时使用 DEFAULT_WORKSHEET_STYLE。
-     */
-  getWorksheetStyle?(): WorksheetStyle;
-  /**
-     * 获取指定行的高度。
-     * @param rowIndex 行号（0 基）
-     */
-  getRowHeight(rowIndex: number): number;
-  /**
-     * 获取指定列的宽度。
-     * @param columnIndex 列号（0 基）
-     */
-  getColumnWidth(columnIndex: number): number;
-  /**
-     * 获取 [startRow, endRow] 闭区间内所有行的高度之和。
-     * @param startRow 起始行号（包含）
-     * @param endRow 结束行号（包含）
-     */
-  getRowsHeight(startRow: number, endRow: number): number;
-  /**
-     * 获取 [startColumn, endColumn] 闭区间内所有列的宽度之和。
-     * @param startColumn 起始列号（包含）
-     * @param endColumn 结束列号（包含）
-     */
-  getColumnsWidth(startColumn: number, endColumn: number): number;
-  /**
-     * 获取第 rowIndex 行顶部的 Y 偏移，即第 0 行到第 rowIndex - 1 行的高度之和。
-     * 等价于 getRowsHeight(0, rowIndex - 1)，rowIndex <= 0 时返回 0。
-     * @param rowIndex 行号（0 基）
-     */
-  getRowTop(rowIndex: number): number;
-  /**
-     * 获取第 columnIndex 列左侧的 X 偏移，即第 0 列到第 columnIndex - 1 列的宽度之和。
-     * 等价于 getColumnsWidth(0, columnIndex - 1)，columnIndex <= 0 时返回 0。
-     * @param columnIndex 列号（0 基）
-     */
-  getColumnLeft(columnIndex: number): number;
-}