@fileverse-dev/dsheet 4.1.22 → 4.1.23

package/dist/editor/components/editor-workbook.d.ts

@@ -21,6 +21,10 @@ interface EditorWorkbookProps {
     dsheetId: string;
     onDuneChartEmbed?: () => void;
     onSheetCountChange?: (sheetCount: number) => void;
+    onCopySheetLink?: (args: {
+        sheetId: string;
+        sheetName: string;
+    }) => void;
     sidebarActivePanel?: string | null;
     sidebarPortalRegistry?: SidebarPortalRegistryHandle | null;
     sidebarPortalRenderers?: Record<string, SidebarPortalRenderer>;
@@ -29,6 +33,8 @@ interface EditorWorkbookProps {
     onSignInToComment?: () => void;
     onViewerModeChange?: (mode: 'comment' | 'view') => void;
     theme?: ThemeKey;
+    showToolbar?: boolean;
+    showFormulaBar?: boolean;
 }
 export declare const EditorWorkbook: React.NamedExoticComponent<EditorWorkbookProps>;
 export {};

package/dist/editor/components/sidebar/editor-right-sidebar.d.ts

@@ -15,6 +15,8 @@ interface EditorRightSidebarProps {
     onClose: () => void;
     /** Read/preview mode hides the toolbar, so the sidebar starts higher. */
     isReadOnly?: boolean;
+    showNavbar?: boolean;
+    showToolbar?: boolean;
 }
-export declare const EditorRightSidebar: ({ isOpen, activePanelConfig, onClose, isReadOnly, }: EditorRightSidebarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const EditorRightSidebar: ({ isOpen, activePanelConfig, onClose, isReadOnly, showNavbar, showToolbar, }: EditorRightSidebarProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/editor/components/sidebar/sidebar-offsets.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Right sidebar position below the editor chrome. Read/preview mode keeps
+ * its existing offsets (the sidebar overlays the toolbar there).
+ */
+export declare const getRightSidebarOffsets: ({ isReadOnly, showNavbar, showToolbar, }: {
+    isReadOnly?: boolean;
+    showNavbar?: boolean;
+    showToolbar?: boolean;
+}) => {
+    top: string;
+    height: string;
+};

package/dist/editor/components/sidebar/sidebar-offsets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/editor/types.d.ts

@@ -7,6 +7,7 @@ import { SmartContractConfig } from './types/smart-contract';
 import { ApiKeyStorage } from './utils/api-key-storage';
 import { ThemeKey } from '../sheet-engine/core/theme';
 import { DSheetContentSnapshot } from '../persistence';
+import { NavigateToSheetOptions } from './utils/navigate-to-sheet';
 
 import * as Y from 'yjs';
 export type { ThemeKey } from '../sheet-engine/core/theme';
@@ -31,6 +32,7 @@ export type DSheetEditorHandle = WorkbookInstance & {
         encryptedTitle: string;
         documentTitle: string;
     }) => void;
+    navigateToSheet: (sheetId: string, opts?: NavigateToSheetOptions) => Promise<boolean>;
 };
 export interface PanelConfig {
     id: string;
@@ -68,6 +70,13 @@ export interface DsheetProps {
     setFetchingURLData?: (fetching: boolean) => void;
     setInputFetchURLDataBlock?: React.Dispatch<React.SetStateAction<string>>;
     renderNavbar?: (editorValues?: EditorValues) => JSX.Element;
+    /** Mount the navbar slot. `renderNavbar` still runs when hidden, so host
+     * side effects inside it keep working. Default true. */
+    showNavbar?: boolean;
+    /** Show the sheet toolbar. Default true. */
+    showToolbar?: boolean;
+    /** Show the formula bar. Default true. */
+    showFormulaBar?: boolean;
     enableIndexeddbSync?: boolean;
     dsheetId: string;
     /**
@@ -112,6 +121,10 @@ export interface DsheetProps {
     onDataBlockEvent?: (event: DataBlockEvent) => void;
     onDuneChartEmbed?: () => void;
     onSheetCountChange?: (sheetCount: number) => void;
+    onCopySheetLink?: (args: {
+        sheetId: string;
+        sheetName: string;
+    }) => void;
     /** Fires whenever local content-sync status changes. Host apps should gate
      * collab start/resume on 'synced' — starting before local content is fully
      * synced is what let the RTC layer bind to a stale doc in the past. */

package/dist/editor/utils/activate-sheet-for-link.d.ts

@@ -0,0 +1,3 @@
+import { Context } from '../../sheet-engine/core';
+
+export declare function activateSheetForLink(draft: Context, sheetId: string): void;

package/dist/editor/utils/active-sheet-keeper.d.ts

@@ -0,0 +1,21 @@
+import { WorkbookInstance } from '../../sheet-engine/react';
+
+export type ActiveSheetKeeper = {
+    /**
+     * Call on every Workbook ref attach. `mountKey` must change whenever the
+     * Workbook is remounted (i.e. mirror the Workbook's React `key`).
+     */
+    onAttach: (workbook: WorkbookInstance | null, mountKey: unknown) => void;
+};
+/**
+ * Fortune remounts the Workbook whenever the editor bumps its render key
+ * (collab rehydration, template apply, imports), and a fresh mount resets the
+ * active sheet to the first visible one. Remember the active sheet across
+ * attaches and restore it once per mount, as soon as the new mount has sheets.
+ *
+ * The restore runs synchronously inside the ref callback (React commit phase).
+ * That only enqueues a Workbook state update (same as setState in
+ * useLayoutEffect), and it goes through the same setContext path as clicking a
+ * sheet tab.
+ */
+export declare function createActiveSheetKeeper(): ActiveSheetKeeper;

package/dist/editor/utils/editor-handle.d.ts

@@ -2,7 +2,7 @@ import { Ref } from 'react';
 import { WorkbookInstance } from '../../sheet-engine/react';
 import { DSheetEditorHandle } from '../types';
 
-export type DSheetEditorMethods = Pick<DSheetEditorHandle, "refreshIndexedDB" | "terminateSession" | "updateCollaboratorName" | "updateSessionTitle">;
+export type DSheetEditorMethods = Pick<DSheetEditorHandle, "refreshIndexedDB" | "terminateSession" | "updateCollaboratorName" | "updateSessionTitle" | "navigateToSheet">;
 /**
  * Compose Fortune's regenerated imperative handle with dSheet lifecycle methods.
  * React callback refs invoke this again after every Workbook remount, so both

package/dist/editor/utils/navigate-to-sheet.d.ts

@@ -0,0 +1,22 @@
+export type NavigableContext = {
+    currentSheetId?: string;
+    luckysheetfile?: Array<{
+        id?: string;
+        hide?: number;
+    } | null | undefined>;
+};
+export type NavigableEditor = {
+    getWorkbookContext?: () => NavigableContext | null | undefined;
+    getWorkbookSetContext?: () => ((recipe: (draft: unknown) => void) => void) | null | undefined;
+};
+export type NavigateToSheetOptions = {
+    /** How long to wait for the workbook and sheet to load. Default 10s. */
+    timeoutMs?: number;
+};
+/**
+ * Wait until the workbook has loaded a sheet with `sheetId`, then switch to it.
+ * Resolves `false` (never throws) when the sheet is missing after the timeout,
+ * hidden, or the switch fails. `getEditor` must return the latest instance on
+ * every call because Fortune regenerates its handle on each context change.
+ */
+export declare function navigateToSheet<TDraft>(getEditor: () => NavigableEditor | null | undefined, sheetId: string, activate: (draft: TDraft, sheetId: string) => void, { timeoutMs }?: NavigateToSheetOptions): Promise<boolean>;

package/dist/{es-S4GKlN-t.js → es-BlDQ6jCL.js}

@@ -11198,6 +11198,7 @@ If the value is FALSE, return the accrued interest from the first interest accru
     cancelText: "Cancelar",
     chooseText: "Confirmar color",
     focus: "Enfocar",
+    copyLink: "Copiar enlace a la hoja",
     tipNameRepeat: "¡El nombre de la página de la pestaña no se puede repetir! Revísalo",
     noMoreSheet: "El libro de trabajo contiene al menos una hoja de trabajo visual. Para eliminar la hoja de trabajo seleccionada, inserta una nueva hoja de trabajo o muestra una hoja de trabajo oculta",
     confirmDelete: "¿Estás seguro de eliminar",

package/dist/{executeStringFunction-CQ922vEp.js → executeStringFunction-ZHYCWIpK.js}

@@ -30,10 +30,10 @@ function zg(e) {
 }
 const Tr = {}, Qa = {
   en: () => Promise.resolve().then(() => Af),
-  zh: () => import("./zh-Bv4KIDiJ.js"),
-  es: () => import("./es-S4GKlN-t.js"),
-  hi: () => import("./hi-DMMTDTxZ.js"),
-  "zh-TW": () => import("./zh_tw-BdpsK45h.js")
+  zh: () => import("./zh-CmOCFd5t.js"),
+  es: () => import("./es-BlDQ6jCL.js"),
+  hi: () => import("./hi-CP0ta0Yk.js"),
+  "zh-TW": () => import("./zh_tw-BqyRw1gX.js")
 };
 async function Wg(e) {
   const t = e in Qa ? e : e.split("-")[0], n = t in Qa ? t : "en";
@@ -12425,6 +12425,7 @@ If the value is FALSE, return the accrued interest from the first interest accru
     cancelText: "Cancel",
     chooseText: "Confirm color",
     focus: "Focus",
+    copyLink: "Copy link to sheet",
     tipNameRepeat: "The name of the tab page cannot be repeated! Please revise",
     noMoreSheet: "The workbook contains at least one visual worksheet. To delete the selected worksheet, please insert a new worksheet or show a hidden worksheet.",
     confirmDelete: "Are you sure you want to delete this sheet?",

package/dist/formula.js

@@ -1,5 +1,5 @@
 import { FLVURL as r } from "@fileverse-dev/formulajs";
-import { e as t, f } from "./executeStringFunction-CQ922vEp.js";
+import { e as t, f } from "./executeStringFunction-ZHYCWIpK.js";
 export {
   r as FLVURL,
   t as executeStringFunction,

package/dist/{hi-DMMTDTxZ.js → hi-CP0ta0Yk.js}

@@ -11248,6 +11248,7 @@ If the value is FALSE, return the accrued interest from the first interest accru
     cancelText: "रद्द करें",
     chooseText: "रंग की पुष्टि करें",
     focus: "फोकस करें",
+    copyLink: "शीट का लिंक कॉपी करें",
     tipNameRepeat: "टैब पृष्ठ का नाम दोहराया नहीं जा सकता! कृपया संशोधित करें",
     noMoreSheet: "वर्कबुक में कम से कम एक दृश्य वर्कशीट होनी चाहिए। चयनित वर्कशीट को हटाने के लिए, कृपया एक नई वर्कशीट जोड़ें या एक छुपी हुई वर्कशीट दिखाएं।",
     confirmDelete: "क्या आप वाकई हटाना चाहते हैं",