@univerjs-pro/sheets-chart 0.24.0 → 0.25.0

package/lib/types/facade/chart-builder/chart-builder-base.d.ts

@@ -311,7 +311,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -341,7 +342,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell F3 and offset 20 pixels to the right and down.
@@ -364,7 +366,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is (100, 200) pixels from the top left-hand corner of the sheet.
@@ -386,7 +389,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -418,7 +422,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -442,7 +447,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -467,7 +473,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorkSheet = fWorkbook.getActiveSheet();
+     * const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorkSheet) return;
      * const chartBuilder = fWorkSheet.newChart().asPieChart();
      * const chartBuilderInfo1 = chartBuilder
      *   .addRange('A1:D6')
@@ -510,7 +517,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -534,7 +542,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // register your theme
      * const theme = { // your theme object
@@ -587,7 +596,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -610,7 +620,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -633,7 +644,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -656,7 +668,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -683,7 +696,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -710,7 +724,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -738,7 +753,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -766,7 +782,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -814,7 +831,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -848,7 +866,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.
@@ -880,7 +899,8 @@ export declare class FChartBuilderBase extends FBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6
      * // The starting position is upper-left corner of cell B2.

package/lib/types/facade/chart-builder/line-chart-builder.d.ts

@@ -32,7 +32,8 @@ export declare class LineChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart builder with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -55,7 +56,8 @@ export declare class LineChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -80,7 +82,8 @@ export declare class LineChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -105,7 +108,8 @@ export declare class LineChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -132,7 +136,8 @@ export declare class LineChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.

package/lib/types/facade/chart-builder/pie-chart-builder.d.ts

@@ -21,7 +21,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -44,7 +45,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -67,7 +69,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -90,7 +93,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -113,7 +117,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -136,7 +141,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -159,7 +165,8 @@ export declare class PieChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a pie chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.

package/lib/types/facade/chart-builder/radar-chart-builder.d.ts

@@ -24,7 +24,8 @@ export declare class RadarChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a radar chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -48,7 +49,8 @@ export declare class RadarChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a radar chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -72,7 +74,8 @@ export declare class RadarChartBuilder extends FChartBuilderBase {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a radar chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.

package/lib/types/facade/f-chart.d.ts

@@ -28,7 +28,8 @@ export declare class FChart {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const charts = fWorksheet.getCharts();
      * console.log(charts[0]?.getChartId());
      * ```
@@ -41,7 +42,8 @@ export declare class FChart {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const charts = fWorksheet.getCharts();
      * console.log(charts[0]?.getRange());
      * ```
@@ -59,7 +61,8 @@ export declare class FChart {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Get all charts on the active sheet.
      * const charts = fWorksheet.getCharts();
@@ -86,7 +89,8 @@ export declare class FChart {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const charts = fWorksheet.getCharts();
      * if (charts.length > 0){
      *   const seriesData = charts[0].getSeriesData();
@@ -110,7 +114,8 @@ export declare class FChart {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      * const charts = fWorksheet.getCharts();
      * if (charts.length > 0){
      *   const categoryData = charts[0].getCategoryData();

package/lib/types/facade/f-enum.d.ts

@@ -10,7 +10,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -30,7 +31,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -52,7 +54,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -74,7 +77,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -102,7 +106,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -128,7 +133,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -151,7 +157,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a line chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -177,7 +184,8 @@ export interface IFSheetsChartEnumMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a radar chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.

package/lib/types/facade/f-worksheet.d.ts

@@ -15,7 +15,8 @@ export interface IFWorksheetChartMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -35,7 +36,8 @@ export interface IFWorksheetChartMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -69,7 +71,8 @@ export interface IFWorksheetChartMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -92,7 +95,8 @@ export interface IFWorksheetChartMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Get all charts on the active sheet.
      * const charts = fWorksheet.getCharts();
@@ -107,7 +111,8 @@ export interface IFWorksheetChartMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // Create a column chart with data source A1:D6.
      * // The starting position is upper-left corner of cell B2.
@@ -138,7 +143,8 @@ export interface IFWorksheetChartMixin {
      * @example
      * ```ts
      * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+     * if (!fWorksheet) return;
      *
      * // register your theme
      * const theme = { // your theme object

package/lib/types/locale/ar-SA.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/locale/ca-ES.d.ts

@@ -1,3 +1,3 @@
-import enUS from './en-US';
+import type enUS from './en-US';
 declare const locale: typeof enUS;
 export default locale;

package/lib/types/locale/de-DE.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/locale/en-US.d.ts

@@ -1,7 +1,39 @@
 declare const locale: {
-    chart: {
+    'sheets-chart': {
         category: string;
         series: string;
+        seriesDefaultName: string;
+        categoryDefaultName: string;
+        blank: string;
+        msg: {
+            emptyTips: string;
+            sankeyCircularTips: string;
+        };
+        bubble: {
+            emptyTips: string;
+        };
+        relation: {
+            emptyTips: string;
+        };
+        cloud: {
+            word: string;
+            frequency: string;
+        };
+        waterfall: {
+            positive: string;
+            negative: string;
+            subtotal: string;
+        };
+        pareto: {
+            lineName: string;
+        };
+        boxplot: {
+            min: string;
+            q1: string;
+            median: string;
+            q3: string;
+            max: string;
+        };
     };
 };
 export default locale;

package/lib/types/locale/es-ES.d.ts

@@ -1,3 +1,3 @@
-import enUS from './en-US';
+import type enUS from './en-US';
 declare const locale: typeof enUS;
 export default locale;

package/lib/types/locale/fa-IR.d.ts

@@ -1,3 +1,3 @@
-import enUS from './en-US';
+import type enUS from './en-US';
 declare const locale: typeof enUS;
 export default locale;

package/lib/types/locale/fr-FR.d.ts

@@ -1,3 +1,3 @@
-import enUS from './en-US';
+import type enUS from './en-US';
 declare const locale: typeof enUS;
 export default locale;

package/lib/types/locale/id-ID.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/locale/it-IT.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/locale/pl-PL.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/locale/pt-BR.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/locale/ru-RU.d.ts

@@ -1,3 +1,3 @@
-import enUS from './en-US';
+import type enUS from './en-US';
 declare const locale: typeof enUS;
 export default locale;

package/lib/types/locale/zh-HK.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US';
+declare const locale: typeof enUS;
+export default locale;

package/lib/types/models/chart-model.d.ts

@@ -1,15 +1,18 @@
-import type { ChartStyle, ChartTypeBits, IChartContext, IChartDataAggregation } from '@univerjs-pro/engine-chart';
+import type { ChartStyle, ChartTypeBits, IChartContext, IChartDataAggregation, IChartLocaleTexts } from '@univerjs-pro/engine-chart';
 import type { Injector } from '@univerjs/core';
 import type { ChartDataSourceSingle } from '../chart-source/chart-source';
 import type { ISheetChartDataSource } from './types';
 import { ChartModel } from '@univerjs-pro/engine-chart';
+import { LocaleService } from '@univerjs/core';
 export interface IChartModelInit {
     chartType?: ChartTypeBits;
     dataSource: ISheetChartDataSource;
     dataAggregation?: IChartDataAggregation;
     context?: Pick<IChartContext, 'categoryIndex' | 'seriesIndexes' | 'transform'>;
     style?: ChartStyle;
+    localeTexts?: IChartLocaleTexts;
 }
+export declare function buildLocaleTexts(localeService: LocaleService): IChartLocaleTexts;
 export declare class SheetChartModel extends ChartModel {
     _dataSource: ChartDataSourceSingle;
     get dataSource(): ChartDataSourceSingle;