@fileverse-dev/dsheet 4.1.18 → 4.1.20-subsheetLink-1

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>;

package/dist/editor/types/smart-contract.d.ts

@@ -33,7 +33,7 @@ export interface SmartContractConfig {
     contracts?: ContractConfig[];
     /** RPC URL per chain. Falls back to bundled defaults when omitted. */
     rpcConfig?: Partial<Record<SupportedChain, string>>;
-    /** Resolve ABI from stored reference (e.g. IPFS hash). Required for user-saved contracts with abiHash. */
+    /** Resolve ABI from stored reference (e.g. an IPFS CID or a Swarm reference — opaque to the package). Required for user-saved contracts with abiHash. */
     resolveAbi?: (abiHash: string) => Promise<Abi>;
     /** Persist a new contract. When omitted, package keeps it in session memory only. */
     onAddContract?: (input: NewContractInput) => Promise<void>;
@@ -52,7 +52,8 @@ export interface CallerParams {
 export interface FetchAbiParams {
     contractAddress: Hex;
     chain: import('viem').Chain;
-    ipfsHash?: string;
+    /** Stored ABI reference (`ContractConfig.abiHash`), resolved via `resolveAbi`. */
+    abiRef?: string;
 }
 export type ParsedFunction = {
     functionName: string;

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;
@@ -112,6 +114,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/editor/utils/smart-contract/reading-utils.test.d.ts

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

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-B1_kGelH.js → executeStringFunction-BVMdxpT1.js}

@@ -30,10 +30,10 @@ function Ug(e) {
 }
 const Tr = {}, Qa = {
   en: () => Promise.resolve().then(() => kf),
-  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 zg(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-B1_kGelH.js";
+import { e as t, f } from "./executeStringFunction-BVMdxpT1.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: "क्या आप वाकई हटाना चाहते हैं",