@fileverse-dev/dsheet 2.1.3-package-cleanup-2 → 2.1.3-rtc-debug-2

package/dist/sheet-engine/core/modules/formula-async-eval.d.ts

@@ -1,53 +0,0 @@
-/** Minimum formula count before deferring eval to chunked async (Step 1). */
-export declare const FORMULA_ASYNC_EVAL_THRESHOLD = 15;
-/** Formulas evaluated per animation frame during async recalc. */
-export declare const FORMULA_ASYNC_CHUNK_SIZE = 50;
-/** Use a Web Worker when the async job has at least this many formulas. */
-export declare const FORMULA_WORKER_THRESHOLD = 100;
-/** Formulas evaluated per worker message (larger — runs off main thread). */
-export declare const FORMULA_WORKER_CHUNK_SIZE = 300;
-/** Maximum time to wait for a worker chunk before falling back to the real engine. */
-export declare const FORMULA_WORKER_CHUNK_TIMEOUT_MS = 30000;
-/** localStorage key for the optional formula execution debug panel. */
-export declare const FORMULA_EXEC_DEBUG_STORAGE_KEY = "fortune-formula-execution-debug";
-export declare function isFormulaExecutionDebugEnabled(): boolean;
-export type FormulaEvalDebugMode = 'worker' | 'main-thread' | 'fallback';
-export type FormulaEvalDebug = {
-    mode: FormulaEvalDebugMode;
-    lastChunkMs: number;
-    lastChunkSize: number;
-    completedChunks: number;
-    fallbackChunks: number;
-    workerAvailable: boolean;
-    unsafeFormulaCount: number;
-    workerFormulaCount: number;
-    totalWorkerFormulas: number;
-    totalMainThreadFormulas: number;
-    lastError: string | null;
-};
-export type FormulaAsyncEvalJob = {
-    formulaRunList: Array<{
-        r: number;
-        c: number;
-        id: string;
-        calc_funcStr: string;
-        level?: number;
-    }>;
-    calcChainKeys: string[];
-    impactedByCircular: string[];
-    cycleNodes: string[];
-    workerSnapshotKey: string;
-    nextIndex: number;
-    total: number;
-    debug?: FormulaEvalDebug;
-};
-export declare function isFormulaEvalPending(ctx: {
-    isFormulaCalculating?: boolean;
-    formulaAsyncEval?: FormulaAsyncEvalJob | null;
-}): boolean;
-/**
- * The worker snapshot evaluator intentionally handles only scalar formulas that
- * mirror the main engine well. Dynamic/spill/range-indirection formulas stay on
- * the main thread so `spillSortResult` and special range logic remain authoritative.
- */
-export declare function isFormulaWorkerUnsafe(calcFuncStr: string): boolean;

package/dist/sheet-engine/core/modules/formula-eval.worker.d.ts

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

package/dist/sheet-engine/core/modules/formula-range-cache.d.ts

@@ -1,20 +0,0 @@
-export type RangePassCacheEntry = {
-    fragment: any[][];
-    cryptoDenomination: string;
-    cryptoDecimal: number;
-    globalDataKeysFingerprint: string;
-};
-export declare function makeRangePassCacheKey(sheetId: string, startRow: number, endRow: number, startCol: number, endCol: number): string;
-export declare function collectGlobalDataKeysInRange(execFunctionGlobalData: Record<string, unknown>, sheetId: string, startRow: number, endRow: number, startCol: number, endCol: number): string;
-/** Remove the formula origin cell from a full rectangular range fragment. */
-export declare function sliceRangeFragmentForOrigin(full: any[][], startRow: number, startCol: number, originRow: number | null | undefined, originCol: number | null | undefined): any[][];
-type RangeCacheHost = {
-    rangeValuePassCache?: Map<string, RangePassCacheEntry>;
-    rangeValuePassCacheStats?: {
-        hits: number;
-        misses: number;
-    };
-};
-export declare function beginRangeValuePassCache(cache: RangeCacheHost): void;
-export declare function clearRangeValuePassCache(cache: RangeCacheHost): void;
-export {};

package/dist/sheet-engine/core/modules/formula-snapshot-eval.d.ts

@@ -1,40 +0,0 @@
-import { CellMatrix } from '../types';
-
-export type SnapshotSheet = {
-    id: string;
-    name: string;
-    data: CellMatrix | null | undefined;
-};
-export type SnapshotFormulaCell = {
-    r: number;
-    c: number;
-    id: string;
-    calc_funcStr: string;
-};
-export type SnapshotFormulaResult = {
-    r: number;
-    c: number;
-    id: string;
-    v: unknown;
-    f: string;
-    spe?: unknown;
-    deps: string[];
-    isError: boolean;
-};
-export type SnapshotEvalInput = {
-    sheets: SnapshotSheet[];
-    execFunctionGlobalData: Record<string, {
-        v: unknown;
-        f: unknown;
-    }>;
-    formulas: SnapshotFormulaCell[];
-};
-export type SnapshotEvalOutput = {
-    execFunctionGlobalData: Record<string, {
-        v: unknown;
-        f: unknown;
-    }>;
-    results: SnapshotFormulaResult[];
-};
-/** Worker-safe formula evaluation against plain sheet snapshots (no React/immer). */
-export declare function evalFormulasInSnapshot(input: SnapshotEvalInput): SnapshotEvalOutput;

package/dist/sheet-engine/core/modules/formula-transitive-deps.d.ts

@@ -1,7 +0,0 @@
-/** Cell / formula key format used in depsByCell and revDepsByCell. */
-export declare function toFormulaDepCellKey(sheetId: string, r: number, c: number): string;
-/**
- * Walk revDepsByCell from a changed cell to collect every formula cell that
- * must recalculate (direct + transitive dependents).
- */
-export declare function collectTransitiveFormulaDependents(originCellKey: string, revDepsByCell: Map<string, Set<string>>): Set<string>;

package/dist/sheet-engine/core/modules/formula-worker-bridge.d.ts

@@ -1,16 +0,0 @@
-import { Context } from '../context';
-import { SnapshotEvalInput, SnapshotEvalOutput, SnapshotFormulaCell, evalFormulasInSnapshot } from './formula-snapshot-eval';
-import { FORMULA_WORKER_CHUNK_SIZE } from './formula-async-eval';
-
-export declare function buildSnapshotEvalInput(ctx: Context, formulas: SnapshotFormulaCell[]): SnapshotEvalInput;
-export declare function buildWorkerEvalInput(ctx: Context, formulas: SnapshotFormulaCell[]): Omit<SnapshotEvalInput, 'sheets'>;
-export declare function initFormulaWorkerSnapshot(ctx: Context, snapshotKey: string): boolean;
-/**
- * Evaluate a formula chunk off the critical UI path when possible.
- * Uses an inline Web Worker. Callers should fall back to the real engine on
- * rejection so the worker cannot silently leave a recalculation job hanging.
- */
-export declare function evalFormulasInBackground(snapshotKey: string, input: Omit<SnapshotEvalInput, 'sheets'>): Promise<SnapshotEvalOutput>;
-/** @deprecated Use evalFormulasInBackground */
-export declare const evalFormulasInWorker: typeof evalFormulasInBackground;
-export { FORMULA_WORKER_CHUNK_SIZE, evalFormulasInSnapshot };

package/dist/sheet-engine/core/modules/formula-worker-types.d.ts

@@ -1,24 +0,0 @@
-import { SnapshotEvalInput, SnapshotEvalOutput, SnapshotSheet } from './formula-snapshot-eval';
-
-export type WorkerInitSnapshotRequest = {
-    type: 'init-snapshot';
-    snapshotKey: string;
-    sheets: SnapshotSheet[];
-};
-export type WorkerEvalRequest = {
-    type: 'eval';
-    requestId: number;
-    snapshotKey: string;
-    input: Omit<SnapshotEvalInput, 'sheets'>;
-};
-export type WorkerRequest = WorkerInitSnapshotRequest | WorkerEvalRequest;
-export type WorkerEvalResponse = {
-    type: 'eval-result';
-    requestId: number;
-    output: SnapshotEvalOutput;
-};
-export type WorkerEvalError = {
-    type: 'eval-error';
-    requestId: number;
-    message: string;
-};

package/dist/sheet-engine/core/theme.d.ts

@@ -1,67 +0,0 @@
-/**
- * Grid (canvas) theming — the single source of truth for the JS-painted grid's per-theme colors.
- *
- * The chrome (toolbar, sidebars, comments) themes passively via `@fileverse/ui` `.color-*`
- * utilities + the `<html>` class. The canvas grid cannot read CSS variables, so `canvas.ts`
- * resolves its colors from `activePalette` here. On theme change the host threads a `theme` prop
- * to the engine, which calls `setActiveGridPalette` and repaints via `jfrefreshgrid`.
- *
- * `ThemeKey` is copied verbatim from `fileverse-ddoc` `package/types.ts` so the dsheet `theme`
- * prop is type-identical to ddoc's and a host app can pass the same value to both editors.
- *
- * See docs/superpowers/specs/2026-06-30-dsheet-canvas-theming-design.md
- */
-export type ThemeKey = 'light' | 'dark' | 'theme-sepia' | 'theme-pink' | 'theme-green';
-export declare const DEFAULT_THEME: ThemeKey;
-/**
- * dsheet selection-accent brand color. Constant across all five themes (readable on every
- * background) — intentionally NOT a per-theme palette slot. Used for the fill handle, selection
- * border, and marching ants.
- */
-export declare const SELECTION_ACCENT = "#EFC703";
-/**
- * One slot per neutral grid-chrome color role painted in `canvas.ts`. User-authored cell colors
- * (cell `bg`/`fc`/border, conditional-format colors) are NOT here — they render literally in every
- * theme and are read straight from cell data.
- */
-export interface GridPalette {
-    /** Unset cell background + main-area canvas clear (the `!fillStyle` fallback branch). */
-    cellBg: string;
-    /** Gridlines. */
-    gridLine: string;
-    /** Default cell text (cells with no user `fc`). */
-    cellText: string;
-    /** Row/column header background. */
-    headerBg: string;
-    /** Row/column header text. */
-    headerText: string;
-    /** Secondary fill for on-canvas chips (e.g. data-verification dropdown). */
-    secondaryFill: string;
-    /** Frozen-pane divider line. */
-    freezeLine: string;
-}
-/**
- * Per-theme grid palettes.
- *
- * `light` holds the EXACT pre-theming hex from `canvas.ts`, so the default theme renders
- * pixel-identical to before this change (regression guard).
- *
- * [Unverified] The four non-light palettes are reasonable design-guess values derived from each
- * theme's surface swatch — NOT final brand colors; they need design sign-off. The mechanism is
- * independent of the exact values.
- */
-export declare const GRID_THEMES: Record<ThemeKey, GridPalette>;
-export declare const resolveGridPalette: (theme?: ThemeKey) => GridPalette;
-/**
- * The palette the canvas paints from. Module-level so the imperative canvas reads it on every
- * repaint without prop threading inside the engine. `canvas.ts` imports this as a live binding and
- * reads `activePalette.<slot>` at paint time; reassigning it here updates every reader.
- *
- * NOTE: this is a module singleton — multiple workbooks with different themes on one page would
- * share it. dsheet renders one editor per page (like ddoc), so this is acceptable. If multi-instance
- * is ever needed, move the palette onto `sheetCtx`.
- */
-export declare let activePalette: GridPalette;
-/** Swap the active grid palette. Returns true if it actually changed (caller decides to repaint). */
-export declare const setActiveGridPalette: (theme?: ThemeKey) => boolean;
-export declare const getActiveTheme: () => ThemeKey;

package/dist/sheet-engine/react/components/SidebarPanelPortals/index.d.ts

@@ -1,17 +0,0 @@
-import { default as React } from 'react';
-import { Context } from '../../../core';
-import { default as WorkbookContext } from '../../context';
-
-export type SidebarPortalTargets = Record<string, HTMLElement | undefined>;
-export type SidebarPortalRegistryHandle = {
-    getTargets: () => SidebarPortalTargets;
-    subscribe: (onStoreChange: () => void) => () => void;
-};
-export type SidebarPortalRenderer = (workbook: React.ContextType<typeof WorkbookContext>) => React.ReactNode;
-interface SidebarPanelPortalsProps {
-    activePanel: string | null;
-    portalRegistry?: SidebarPortalRegistryHandle | null;
-    extraPortals?: Record<string, SidebarPortalRenderer>;
-}
-export declare function SidebarPanelPortals({ activePanel, portalRegistry, extraPortals, }: Readonly<SidebarPanelPortalsProps>): React.ReactPortal | null;
-export type { Context };