@casualoffice/sheets 0.12.0 → 0.14.0

package/dist/chrome.d.cts

@@ -7,8 +7,22 @@ import '@univerjs/core';
 interface ToolbarProps {
     /** Live API, or `null` until the editor is ready. */
     api: CasualSheetsAPI | null;
+    /**
+     * Per-control / per-group feature flags. A key set to `false` hides that
+     * control or group; omitted keys default to enabled. Keys:
+     *   history · clipboard · format-painter · font · font-style · color ·
+     *   borders · alignment · merge · number · autosum · clear-format ·
+     *   format-cells · insert-chart · pivot-table
+     */
+    features?: Record<string, boolean>;
+    /**
+     * Host hook for dialogs the SDK has no built-in UI for (Format Cells, Insert
+     * Chart, PivotTable). When provided, those controls render and call this with
+     * a `kind`; when omitted, they are not rendered (no fake dialog).
+     */
+    onDialogRequest?: (kind: string, context?: unknown) => void;
 }
-declare function Toolbar({ api }: ToolbarProps): react.JSX.Element;
+declare function Toolbar({ api, features, onDialogRequest }: ToolbarProps): react.JSX.Element;
 
 interface FormulaBarProps {
     /** Live API, or `null` until the editor is ready. */
@@ -61,11 +75,30 @@ interface AutoSumPickerProps {
 }
 declare function AutoSumPicker({ api }: AutoSumPickerProps): react.JSX.Element;
 
+/**
+ * Dialog kinds the host can choose to render via `onDialogRequest`. These are
+ * the actions the SDK chrome can't fulfil on its own (no built-in modal). The
+ * string is passed straight to the host hook; the `context` (when present)
+ * carries the pre-resolved A1 selection so the host doesn't have to re-read it.
+ */
+type MenuDialogKind = 'format-cells' | 'find-replace' | 'insert-cells' | 'delete-cells' | 'paste-special' | 'insert-chart' | 'insert-pivot' | 'insert-sparkline' | 'insert-function' | 'name-manager' | 'goal-seek' | 'data-validation' | 'conditional-formatting' | 'custom-sort' | 'properties' | 'about' | 'keyboard-shortcuts';
 interface MenuBarProps {
     /** Live API, or `null` until the editor is ready. */
     api: CasualSheetsAPI | null;
+    /**
+     * Per-feature toggles. A control / menu whose `feature` key is `false` is not
+     * rendered. Unknown / omitted keys default to enabled.
+     */
+    features?: Record<string, boolean>;
+    /**
+     * Host hook for actions the SDK can't render itself (Format Cells, Insert
+     * Chart, PivotTable, Find & Replace, Insert/Delete cells, …). Called with the
+     * dialog `kind` and an optional `context` (the active selection in A1 for
+     * range-seeded dialogs). When omitted, those items are not rendered.
+     */
+    onDialogRequest?: (kind: MenuDialogKind, context?: unknown) => void;
 }
-declare function MenuBar({ api }: MenuBarProps): react.JSX.Element;
+declare function MenuBar({ api, features, onDialogRequest }: MenuBarProps): react.JSX.Element;
 
 interface NameBoxProps {
     /** Live API, or `null` until the editor is ready. */

package/dist/chrome.d.ts

@@ -7,8 +7,22 @@ import '@univerjs/core';
 interface ToolbarProps {
     /** Live API, or `null` until the editor is ready. */
     api: CasualSheetsAPI | null;
+    /**
+     * Per-control / per-group feature flags. A key set to `false` hides that
+     * control or group; omitted keys default to enabled. Keys:
+     *   history · clipboard · format-painter · font · font-style · color ·
+     *   borders · alignment · merge · number · autosum · clear-format ·
+     *   format-cells · insert-chart · pivot-table
+     */
+    features?: Record<string, boolean>;
+    /**
+     * Host hook for dialogs the SDK has no built-in UI for (Format Cells, Insert
+     * Chart, PivotTable). When provided, those controls render and call this with
+     * a `kind`; when omitted, they are not rendered (no fake dialog).
+     */
+    onDialogRequest?: (kind: string, context?: unknown) => void;
 }
-declare function Toolbar({ api }: ToolbarProps): react.JSX.Element;
+declare function Toolbar({ api, features, onDialogRequest }: ToolbarProps): react.JSX.Element;
 
 interface FormulaBarProps {
     /** Live API, or `null` until the editor is ready. */
@@ -61,11 +75,30 @@ interface AutoSumPickerProps {
 }
 declare function AutoSumPicker({ api }: AutoSumPickerProps): react.JSX.Element;
 
+/**
+ * Dialog kinds the host can choose to render via `onDialogRequest`. These are
+ * the actions the SDK chrome can't fulfil on its own (no built-in modal). The
+ * string is passed straight to the host hook; the `context` (when present)
+ * carries the pre-resolved A1 selection so the host doesn't have to re-read it.
+ */
+type MenuDialogKind = 'format-cells' | 'find-replace' | 'insert-cells' | 'delete-cells' | 'paste-special' | 'insert-chart' | 'insert-pivot' | 'insert-sparkline' | 'insert-function' | 'name-manager' | 'goal-seek' | 'data-validation' | 'conditional-formatting' | 'custom-sort' | 'properties' | 'about' | 'keyboard-shortcuts';
 interface MenuBarProps {
     /** Live API, or `null` until the editor is ready. */
     api: CasualSheetsAPI | null;
+    /**
+     * Per-feature toggles. A control / menu whose `feature` key is `false` is not
+     * rendered. Unknown / omitted keys default to enabled.
+     */
+    features?: Record<string, boolean>;
+    /**
+     * Host hook for actions the SDK can't render itself (Format Cells, Insert
+     * Chart, PivotTable, Find & Replace, Insert/Delete cells, …). Called with the
+     * dialog `kind` and an optional `context` (the active selection in A1 for
+     * range-seeded dialogs). When omitted, those items are not rendered.
+     */
+    onDialogRequest?: (kind: MenuDialogKind, context?: unknown) => void;
 }
-declare function MenuBar({ api }: MenuBarProps): react.JSX.Element;
+declare function MenuBar({ api, features, onDialogRequest }: MenuBarProps): react.JSX.Element;
 
 interface NameBoxProps {
     /** Live API, or `null` until the editor is ready. */