@progress/kendo-react-spreadsheet 7.2.4-develop.3 → 7.3.0-develop.1

package/tools/utils.mjs

@@ -0,0 +1,97 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2024 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use client";
+import * as r from "react";
+import { Button as v } from "@progress/kendo-react-buttons";
+import { ColorPicker as C } from "@progress/kendo-react-inputs";
+import { useLocalization as s } from "@progress/kendo-react-intl";
+import { messages as m } from "../messages.mjs";
+const x = ["Arial", "Courier New", "Georgia", "Times New Roman", "Trebuchet MS", "Verdana"], _ = "Arial", b = [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 22, 24, 26, 28, 36, 48, 72], h = 12, A = [
+  { text: "Automatic", value: null },
+  { text: "Text", value: "@" },
+  { text: "Number", value: "#,0.00" },
+  { text: "Percent", value: "0.00%" },
+  { text: "Financial", value: '_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)' },
+  { text: "Currency", value: "$#,##0.00;[Red]$#,##0.00" },
+  { text: "Date", value: "m/d/yyyy" },
+  { text: "Time", value: "h:mm:ss AM/PM" },
+  { text: "Date time", value: "m/d/yyyy h:mm" },
+  { text: "Duration", value: "[h]:mm:ss" }
+], F = (e) => (l) => {
+  const { property: t, icon: o, svgIcon: c, titleKey: a } = e, { spreadsheetRef: u, value: n } = l, i = r.useCallback(() => {
+    if (u.current) {
+      const y = {
+        command: "PropertyChangeCommand",
+        options: { property: t, value: !n }
+      };
+      u.current.executeCommand(y);
+    }
+  }, [n]);
+  return /* @__PURE__ */ r.createElement(
+    v,
+    {
+      type: "button",
+      icon: o,
+      svgIcon: c,
+      fillMode: "flat",
+      togglable: !0,
+      onClick: i,
+      selected: n,
+      title: s().toLanguageString(a, m[a])
+    }
+  );
+}, S = (e) => (l) => {
+  const { property: t, titleKey: o, ...c } = e, { spreadsheetRef: a, value: u } = l, n = r.useCallback(
+    (i) => {
+      if (a.current) {
+        const d = {
+          command: "PropertyChangeCommand",
+          options: { property: t, value: i.value || null }
+        };
+        a.current.executeCommand(d);
+      }
+    },
+    [t]
+  );
+  return /* @__PURE__ */ r.createElement(
+    C,
+    {
+      onChange: n,
+      onActiveColorClick: n,
+      fillMode: "flat",
+      ...c,
+      title: s().toLanguageString(o, m[o]),
+      value: u
+    }
+  );
+}, M = (e) => (l) => {
+  const { spreadsheetRef: t } = l, o = r.useCallback(() => {
+    t.current && t.current.workbook.undoRedoStack[e.action]();
+  }, []);
+  return /* @__PURE__ */ r.createElement(
+    v,
+    {
+      type: "button",
+      icon: e.icon,
+      svgIcon: e.svgIcon,
+      fillMode: "flat",
+      title: s().toLanguageString(e.titleKey, m[e.titleKey]),
+      onClick: o
+    }
+  );
+};
+export {
+  S as ColorTool,
+  _ as DEFAULT_FONT_FAMILY,
+  h as DEFAULT_FONT_SIZE,
+  x as FONT_FAMILIES,
+  b as FONT_SIZES,
+  A as FORMATS,
+  F as PropertyChangeTool,
+  M as UndoRedo
+};

package/FormulaInput.d.ts

@@ -1,9 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-/**
- * @hidden
- */
-export declare const FormulaInput: React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<any>>;

package/List.d.ts

@@ -1,9 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-/**
- * @hidden
- */
-export declare const List: React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<any>>;

package/NameBox.d.ts

@@ -1,9 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-/**
- * @hidden
- */
-export declare const NameBox: React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<any>>;

package/SheetsBar.d.ts

@@ -1,8 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-/**
- * @hidden
- */
-export declare const SheetsBar: (props: any) => import("react/jsx-runtime").JSX.Element;

package/Spreadsheet.d.ts

@@ -1,51 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import { SpreadsheetProps, SpreadsheetHandle } from './SpreadsheetProps';
-/**
- * Represents the [KendoReact Spreadsheet component]({% slug overview_spreadsheet %}).
- *
- * Accepts properties of type [SpreadsheetProps]({% slug api_spreadsheet_spreadsheetprops %}).
- * Obtaining the ref will give you an object of type [SpreadsheetHandle]({% slug api_spreadsheet_spreadsheethandle %}).
- *
- * @example
- * ```jsx
- * const sheets = [
- *   {
- *     name: 'Food Order',
- *     rows: [
- *       {
- *         cells: [
- *           {
- *             value: 216321,
- *             textAlign: 'center',
- *           },
- *         ],
- *       },
- *     ],
- *     columns: [
- *       {
- *         width: 100,
- *       },
- *     ],
- *   },
- * ];
- * const App = () => {
- *   return (
- *     <Spreadsheet
- *       style={{
- *         width: "100%",
- *         height: 680,
- *       }}
- *       defaultProps={{
- *         sheets,
- *       }}
- *     />
- *   );
- * };
- * ReactDOM.render(<App />, document.querySelector("my-app"));
- * ```
- */
-export declare const Spreadsheet: React.ForwardRefExoticComponent<SpreadsheetProps & React.RefAttributes<SpreadsheetHandle | null>>;

package/SpreadsheetProps.d.ts

@@ -1,192 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import { Workbook as OoxmlWorkbook } from '@progress/kendo-ooxml';
-import { type SpreadsheetOptions, SpreadsheetWidget, Range, type DocumentDescriptor, View, Sheet, type ExcelExportSettings, type CellDefaultStyle, type SheetColumn, type SheetRow, type Cell, type CellBorder, type SheetDescriptor, Workbook } from '@progress/kendo-spreadsheet-common';
-export { SpreadsheetWidget, SpreadsheetOptions, Range, DocumentDescriptor, View, Workbook, Sheet, SheetDescriptor, ExcelExportSettings, CellDefaultStyle, SheetColumn, SheetRow, Cell, CellBorder };
-interface SpreadsheetEvent {
-    /**
-     * The widget instance which fired the event.
-     */
-    sender: SpreadsheetWidget;
-}
-/**
- * Represents the `SpreadsheetSelectEvent` object.
- */
-export interface SpreadsheetSelectEvent extends SpreadsheetEvent {
-    /**
-     * The Range that is selected.
-     */
-    range: Range;
-}
-/**
- * Represents the `SpreadsheetChangeEvent` object.
- */
-export interface SpreadsheetChangeEvent extends SpreadsheetEvent, SpreadsheetSelectEvent {
-}
-/**
- * Represents the `SpreadsheetExcelImportEvent` object.
- */
-export interface SpreadsheetExcelImportEvent extends SpreadsheetEvent {
-    /**
-     * The file that is being imported.
-     */
-    file: Blob | File;
-    /**
-     * If invoked, the Spreadsheet will not import the file.
-     */
-    preventDefault: Function;
-}
-/**
- * Represents the `SpreadsheetExcelExportEvent` object.
- */
-export interface SpreadsheetExcelExportEvent extends SpreadsheetEvent {
-    /**
-     * The array of data items that is used to create the Excel workbook.
-     */
-    data: Array<any>;
-    /**
-     * The Excel workbook configuration object.
-     * Modifications of the workbook will reflect in the output Excel document.
-     */
-    workbook: OoxmlWorkbook;
-    /**
-     * If invoked, the Spreadsheet will not save the generated file.
-     */
-    preventDefault: Function;
-}
-/**
- * Represents the Spreadsheet tab configuration object.
- */
-export interface SpreadsheetTab {
-    /**
-     * The text of the tab.
-     */
-    text?: string;
-    /**
-     * The localization key of the tab's text.
-     */
-    textKey?: string;
-    /**
-     * Indicates if the tab to be selected initially.
-     */
-    selected?: boolean;
-    /**
-     * The toolbar configuration in the tab content.
-     */
-    tools: (React.ComponentType<any> | React.ComponentType<any>[])[];
-}
-export interface SpreadsheetProps {
-    /**
-     * Sets additional classes to the Spreadsheet.
-     */
-    className?: string;
-    /**
-     * Represents the default props of the Spreadsheet.
-     */
-    defaultProps?: SpreadsheetOptions;
-    /**
-     * A Boolean value which indicates if the toolbar will be displayed. It also allows to customize the tabs content
-     *
-     * @default true
-     */
-    toolbar?: boolean | SpreadsheetTab[];
-    /**
-     * Specifies the styles that will be applied to the wrapping element.
-     */
-    style?: React.CSSProperties;
-    /**
-     * Triggered when the Spreadsheet selection is changed.
-     */
-    onSelect?: (event: SpreadsheetSelectEvent) => void;
-    /**
-     * Triggered when a value in the Spreadsheet has been changed.
-     */
-    onChange?: (event: SpreadsheetChangeEvent) => void;
-    /**
-     * Triggered when the range format is changed from the UI.
-     */
-    onChangeFormat?: (event: SpreadsheetChangeEvent) => void;
-    /**
-     * Fired when the user clicks the Open toolbar button.
-     */
-    onExcelImport?: (event: SpreadsheetExcelImportEvent) => void;
-    /**
-     * Fires when the user clicks the Export to Excel toolbar button.
-     */
-    onExcelExport?: (event: SpreadsheetExcelExportEvent) => void;
-}
-/**
- * Represents the Spreadsheet handle object.
- */
-export interface SpreadsheetHandle {
-    /**
-     * The current element or `null` if there is no one.
-     */
-    element: HTMLDivElement | null;
-    /**
-     * The props values of the Spreadsheet.
-     */
-    props: SpreadsheetProps;
-    /**
-     * Represents the SpreadsheetWidget object, holding the core functionality of the Spreadsheet.
-     */
-    instance: SpreadsheetWidget | null;
-    /**
-     * Returns the `View` object of the Spreadsheet.
-     */
-    get view(): View;
-    /**
-     * Returns the `Workbook` object of the Spreadsheet.
-     */
-    get workbook(): Workbook;
-    /**
-     * Executes the passed command against the selected cell/range.
-     *
-     * @param options An object containing the command name and the required by it options.
-     */
-    executeCommand(options: any): void;
-    /**
-     * Loads the workbook data from an object with the format that is defined in the configuration.
-     *
-     * Note: All existing sheets and their data will be lost.
-     *
-     * @param json The object from where data will be loaded. This has to be the deserialized object, not the JSON string.
-     */
-    fromJSON(json: DocumentDescriptor): void;
-    /**
-     * Serializes the workbook.
-     */
-    toJSON(): DocumentDescriptor;
-    /**
-     * Serializes the workbook. This method does not return the JSON, but a Promise object which will yield the JSON data when it is available.
-     * The method is functionally similar to `toJSON`, but it is also able to save the embedded images (this is the reason why it must be asynchronous).
-     */
-    saveJSON(): Promise<DocumentDescriptor>;
-    /**
-     * Clears the Spreadsheet and populates it with data from the specified Excel (.xlsx) file.
-     *
-     * @param blob The file or blob that is usually obtained through a file input.
-     */
-    fromFile(file: File | Blob): void;
-    /**
-     * Initiates the Excel export. Also fires the excelExport event.
-     *
-     * Note: Calling this method may trigger the built-in popup blocker of the browser.
-     * To avoid that, always call it as a response to an end-user action, for example, a button click.
-     */
-    saveAsExcel(options: any): void;
-    /**
-     * Gets or sets the active sheet.
-     */
-    activeSheet(sheet?: Sheet): Sheet | void;
-    /**
-     * Returns an array with the sheets in the workbook.
-     */
-    sheets(): Sheet[];
-    /**
-     * Re-renders all data in the Spreadsheet.
-     */
-    refresh(): void;
-}

package/messages.d.ts

@@ -1,114 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-/**
- * @hidden
- */
-export declare const messages: {
-    "spreadsheet.bold": string;
-    "spreadsheet.italic": string;
-    "spreadsheet.underline": string;
-    "spreadsheet.undo": string;
-    "spreadsheet.redo": string;
-    "spreadsheet.fontSize": string;
-    "spreadsheet.fontSizeIncrease": string;
-    "spreadsheet.fontSizeDecrease": string;
-    "spreadsheet.fontName": string;
-    "spreadsheet.cleanFormatting": string;
-    "spreadsheet.format": string;
-    "spreadsheet.alignHorizontally": string;
-    "spreadsheet.alignVertically": string;
-    "spreadsheet.align": string;
-    "spreadsheet.alignLeft": string;
-    "spreadsheet.alignRight": string;
-    "spreadsheet.alignCenter": string;
-    "spreadsheet.alignJustify": string;
-    "spreadsheet.center": string;
-    "spreadsheet.justify": string;
-    "spreadsheet.alignTop": string;
-    "spreadsheet.alignMiddle": string;
-    "spreadsheet.alignBottom": string;
-    "spreadsheet.increaseDecimal": string;
-    "spreadsheet.decreaseDecimal": string;
-    "spreadsheet.textColor": string;
-    "spreadsheet.background": string;
-    "spreadsheet.addRowAbove": string;
-    "spreadsheet.addRowBelow": string;
-    "spreadsheet.addColumnLeft": string;
-    "spreadsheet.addColumnRight": string;
-    "spreadsheet.deleteRow": string;
-    "spreadsheet.deleteColumn": string;
-    "spreadsheet.openFile": string;
-    "spreadsheet.exportToExcel": string;
-    "spreadsheet.textWrap": string;
-    "spreadsheet.gridLines": string;
-    "spreadsheet.nameBox": string;
-    "spreadsheet.defaultSheetName": string;
-    "spreadsheet.home": string;
-    "spreadsheet.file": string;
-    "spreadsheet.insert": string;
-    "spreadsheet.addNewSheet": string;
-    "spreadsheet.formatTab": string;
-    "spreadsheet.modifyMerged": string;
-    "spreadsheet.cannotModifyDisabled": string;
-    "spreadsheet.openUnsupported": string;
-    "spreadsheet.duplicateSheetName": string;
-    "spreadsheet.error": string;
-    "spreadsheet.ok": string;
-};
-/**
- * @hidden
- */
-export declare const keys: {
-    bold: string;
-    italic: string;
-    underline: string;
-    undo: string;
-    redo: string;
-    fontSize: string;
-    fontSizeIncrease: string;
-    fontSizeDecrease: string;
-    fontName: string;
-    cleanFormatting: string;
-    format: string;
-    alignHorizontally: string;
-    alignVertically: string;
-    align: string;
-    alignLeft: string;
-    alignRight: string;
-    alignCenter: string;
-    center: string;
-    alignJustify: string;
-    justify: string;
-    alignTop: string;
-    alignMiddle: string;
-    alignBottom: string;
-    increaseDecimal: string;
-    decreaseDecimal: string;
-    textColor: string;
-    background: string;
-    addRowAbove: string;
-    addRowBelow: string;
-    addColumnLeft: string;
-    addColumnRight: string;
-    deleteRow: string;
-    deleteColumn: string;
-    open: string;
-    exportToExcel: string;
-    textWrap: string;
-    gridLines: string;
-    nameBox: string;
-    defaultSheetName: string;
-    file: string;
-    home: string;
-    insert: string;
-    addNewSheet: string;
-    error: string;
-    ok: string;
-    modifyMerged: string;
-    cannotModifyDisabled: string;
-    openUnsupported: string;
-    duplicateSheetName: string;
-    formatTab: string;
-};

package/package-metadata.d.ts

@@ -1,9 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import { PackageMetadata } from '@progress/kendo-licensing';
-/**
- * @hidden
- */
-export declare const packageMetadata: PackageMetadata;

package/tools/adjustDecimals.d.ts

@@ -1,24 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import { SpreadsheetToolProps } from './utils';
-/**
- * The props of the IncreaseDecimal tool component.
- */
-export interface IncreaseDecimalProps extends SpreadsheetToolProps {
-}
-/**
- * The IncreaseDecimal tool component.
- */
-export declare const IncreaseDecimal: React.FunctionComponent<IncreaseDecimalProps>;
-/**
- * The props of the DecreaseDecimal tool component.
- */
-export interface DecreaseDecimalProps extends SpreadsheetToolProps {
-}
-/**
- * The DecreaseDecimal tool component.
- */
-export declare const DecreaseDecimal: React.FunctionComponent<DecreaseDecimalProps>;

package/tools/align.d.ts

@@ -1,48 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import { SpreadsheetToolProps } from './utils';
-/**
- * The props of the Alignment tool component.
- */
-export interface AlignmentProps extends SpreadsheetToolProps {
-    /**
-     * The value of the tool.
-     */
-    value: {
-        textAlign?: string;
-        verticalAlign?: string;
-    };
-}
-/**
- * The Alignment tool component.
- */
-export declare const Alignment: React.FunctionComponent<AlignmentProps>;
-/**
- * The props of the AlignHorizontally tool component.
- */
-export interface AlignHorizontallyProps extends SpreadsheetToolProps {
-    /**
-     * The value of the tool.
-     */
-    value: string;
-}
-/**
- * The props of the AlignVertically tool component.
- */
-export interface AlignVerticallyProps extends SpreadsheetToolProps {
-    /**
-     * The value of the tool.
-     */
-    value: string;
-}
-/**
- * The AlignHorizontally tool component.
- */
-export declare const AlignHorizontally: React.FunctionComponent<AlignHorizontallyProps>;
-/**
- * The AlignVertically tool component.
- */
-export declare const AlignVertically: React.FunctionComponent<AlignVerticallyProps>;

package/tools/backgroundColor.d.ts

@@ -1,14 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import { ColorToolProps } from './utils';
-/**
- * The props of the BackgroundColor tool component.
- */
-export interface BackgroundColorProps extends ColorToolProps {
-}
-/**
- * The BackgroundColor tool component.
- */
-export declare const BackgroundColor: React.FunctionComponent<BackgroundColorProps>;

package/tools/bold.d.ts

@@ -1,14 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import { PropertyChangeToolProps } from './utils';
-/**
- * The props of the Bold tool component.
- */
-export interface BoldProps extends PropertyChangeToolProps {
-}
-/**
- * The Bold tool component.
- */
-export declare const Bold: React.FunctionComponent<BoldProps>;

package/tools/cleanFormat.d.ts

@@ -1,15 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import { PropertyChangeToolProps } from './utils';
-/**
- * @hidden
- */
-export interface CleanFormattingProps extends PropertyChangeToolProps {
-}
-/**
- * @hidden
- */
-export declare const CleanFormatting: React.FunctionComponent<CleanFormattingProps>;

package/tools/defaultTools.d.ts

@@ -1,9 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import { SpreadsheetTab } from '../SpreadsheetProps';
-/**
- * The default toolbar configuration.
- */
-export declare const defaultTabs: SpreadsheetTab[];

package/tools/export.d.ts

@@ -1,15 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import { SpreadsheetToolProps } from './utils';
-/**
- * The props of the ExcelExport tool component.
- */
-export interface ExcelExportProps extends SpreadsheetToolProps {
-}
-/**
- * The ExcelExport tool component.
- */
-export declare const ExcelExport: React.FunctionComponent<ExcelExportProps>;

package/tools/fontFamily.d.ts

@@ -1,15 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2024 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the package root for more information
-*-------------------------------------------------------------------------------------------*/
-import * as React from 'react';
-import { DropDownToolProps } from './utils';
-/**
- * The props of the FontFamily tool component.
- */
-export interface FontFamilyProps extends DropDownToolProps {
-}
-/**
- * The FontFamily tool component.
- */
-export declare const FontFamily: React.FunctionComponent<FontFamilyProps>;