@sheetxl/sdk 0.8.0-beta.11 → 0.8.0-beta.13

package/types/src/workbook/IWorkbook.d.ts

@@ -1,8 +1,10 @@
-import { Scalar, IRange, IRangeStats, IRuntime, LocaleProfileOverrides } from '@sheetxl/primitives';
+import { Scalar, IRange, IRangeStats, IRichType, IRuntime, LocaleProfileOverrides } from '@sheetxl/primitives';
 import { ITransaction } from '../transaction';
 import { IListener } from '../listener';
 import { IResourceCollection, IResource } from '../resource';
+import { IFetcher } from '../fetch';
 import { IStringCollection } from '../string';
+import { IRichDataCollection } from '../richData';
 import { ICalculation } from '../calculation';
 import { IFontCollection } from '../font';
 import { IScript, IModule, IModuleCollection } from '../scripting';
@@ -291,6 +293,34 @@ export interface IWorkbook extends ITransaction.ITransactional, IListener.ISourc
      * Returns the current shared resources.
      */
     getResources(): IResourceCollection;
+    /**
+     * The fetcher the workbook reaches outside itself with: the handlers per URL scheme a host
+     * registered, given as {@link IWorkbook.ConstructorOptions.fetcher}.
+     */
+    getFetcher(): IFetcher;
+    /**
+     * Fetches as the workbook does, with the standard `fetch` signature: what `IMAGE`, a web
+     * service function, and a renderer drawing a picture use.
+     *
+     * @remarks
+     * A resource with a `fetchedFrom` is the workbook's copy of that URL, and answers a fetch of it
+     * without a request. Anything else goes to {@link getFetcher}. The fetch saves nothing itself: a
+     * successful answer to a plain GET that is not a picture is cached until the workbook closes and
+     * answers later fetches of that URL. A response whose bytes are a picture says what they are,
+     * whatever the server called them. Plain GETs of one URL in flight together share one request;
+     * aborting one caller's signal does not stop it for the others. `cache: 'reload'` skips all of
+     * these and asks the source.
+     *
+     * The workbook saves a resource while a value holds it: `IMAGE` adds the picture it fetched for
+     * its values. A picture of the host's own goes in a cell the same way, under a URL the host mints:
+     *
+     * ```ts
+     * const source = `resource:${crypto.randomUUID()}`;
+     * const resource = workbook.getResources().add({ source: { buffer: bytes }, fetchedFrom: source });
+     * workbook.getRange('A1').setValue({ type: 'image', data: { source, resource } });
+     * ```
+     */
+    fetch(input: string, init?: RequestInit): Promise<Response>;
     /**
      * Returns the current shared resources.
      */
@@ -913,6 +943,10 @@ export declare namespace IWorkbook {
         styles?: IStyleCollection.JSON;
         resources?: IResource.JSON[];
         strings?: string[];
+        /** The rich values cells name by id (`{ t: 'r', v: id }`). */
+        richData?: IRichDataCollection.JSON[];
+        /** The kinds {@link richData} names that are not registered in code (a kind read from a file). */
+        richTypes?: IRichType.JSON[];
         /**
          * The people the workbook knows.
          *
@@ -1033,6 +1067,11 @@ export declare namespace IWorkbook {
          * A theme for the workbook.
          */
         theme?: ITheme;
+        /**
+         * How the workbook reaches outside itself: the handlers per URL scheme, with the host's
+         * authentication. Omitted, a {@link Fetcher} for `http:` and `https:`.
+         */
+        fetcher?: IFetcher;
         /**
          * Load from JSON.
          */

package/types/src/workbook/Workbook.d.ts

@@ -1,4 +1,4 @@
-import { Scalar, IRange, IRangeStats, IRuntime, LocaleProfileOverrides } from '@sheetxl/primitives';
+import { Scalar, IRange, IRangeStats, IRuntime, LocaleProfileOverrides, IFunction } from '@sheetxl/primitives';
 import { ITransaction } from '../transaction';
 import { IListener } from '../listener';
 import { INamedCollection } from '../named';
@@ -13,7 +13,10 @@ import { ICalculation } from '../calculation';
 import { IFontCollection } from '../font/IFontCollection';
 import { IScript, IModule, IModuleCollection } from '../scripting';
 import { IResourceCollection } from '../resource';
+import { IFetcher } from '../fetch';
+import { WorkbookFetch } from '../fetch/_WorkbookFetch';
 import { IStringCollection } from '../string';
+import { IRichDataCollection } from '../richData/IRichDataCollection';
 import { ITheme } from '../theme';
 import { ICell } from '../cell';
 import { ICellRange, ICellRanges, ICellRegions } from '../cellRange';
@@ -59,6 +62,8 @@ export declare class Workbook implements IWorkbook {
     protected _scripts: IScript;
     protected _theme: ITheme;
     protected _strings: IStringCollection;
+    /** The rich values every sheet's runs hold by id. */
+    protected _richValues: IRichDataCollection;
     protected _ownStrings: boolean;
     /**
      * The pivot caches, held as read until they have a model of their own. Not workbook state:
@@ -83,6 +88,7 @@ export declare class Workbook implements IWorkbook {
     protected _ownStyles: boolean;
     protected _resources: IResourceCollection;
     protected _ownResources: boolean;
+    protected _fetch: WorkbookFetch;
     protected _names: INamedCollection;
     protected _ownNames: boolean;
     /**
@@ -162,6 +168,10 @@ export declare class Workbook implements IWorkbook {
     getStyles(): IStyleCollection;
     /** {@inheritDoc IWorkbook.getResources} */
     getResources(): IResourceCollection;
+    /** {@inheritDoc IWorkbook.getFetcher} */
+    getFetcher(): IFetcher;
+    /** {@inheritDoc IWorkbook.fetch} */
+    fetch(input: string, init?: RequestInit): Promise<Response>;
     /** {@inheritDoc IWorkbook.getTransactions} */
     getTransactions(): ITransaction.IStore;
     /** {@inheritDoc IWorkbook.getChanges} */
@@ -320,16 +330,6 @@ export declare class Workbook implements IWorkbook {
     getCell(address?: ICell.Address): ICell;
     /** {@inheritDoc IWorkbook.getRanges} */
     getRanges(address: ICellRanges.Address, options?: ICellRange.GetRangeOptions): ICellRanges;
-    /**
-     * A calculation-graph answer: cell coords plus defined-name NODES, one `ICellRanges`.
-     *
-     * @remarks
-     * Backs `Calculation.ConstructorOptions.createGraphRanges` — the seam where the calculation
-     * layer's graph facts become ranges. Each node becomes a {@link NamedCellRange} anchored at the
-     * name's defining cell (DESIGN-NAMED-FORMULAS.md §4.1); a node whose anchor sheet cannot be
-     * resolved falls back to the selected sheet, which is the same self-consistent-but-arbitrary
-     * anchor its body was compiled against. Names lead, cells follow — the name is the heavier fact.
-     */
     protected _createGraphRanges(cells: readonly IRange.Coords[], names: readonly NamedNodeInfo[]): ICellRanges | null;
     /** {@inheritDoc IWorkbook.getAnomalies} */
     getAnomalies(options?: ICellRange.GetAnomaliesOptions): ICellRegions;
@@ -393,8 +393,12 @@ export declare class Workbook implements IWorkbook {
     protected _notifyAllChange(): void;
     /** {@inheritDoc IWorkbook.addListeners} */
     addListeners(listeners: IWorkbook.IListeners, options?: IListener.Options): IListener.Remove;
-    /** @internal */
-    protected _sheetToWBEvent(listenerWB: ICellRange.Listener): ICellRange.Listener;
+    /**
+     * Wrap a workbook range's listener so that what it is handed reads from the workbook: every
+     * range spelled with its sheet.
+     * @internal
+     */
+    protected _sheetToWBEvent(listenerWB: ICellRange.Listener<any>): ICellRange.Listener<any>;
     /**
      * Each pivot cache's source is held through the sheet it names, once the sheets exist, so an
      * insert above the source moves it (see `PivotCache`).
@@ -403,6 +407,14 @@ export declare class Workbook implements IWorkbook {
     protected _holdPivotCaches(): void;
     /** @internal */
     protected _fromJSON(json: IWorkbook.JSON, uids?: readonly string[]): void;
+    /**
+     * The formula functions of every module, for the calculation to register ahead of its first pass
+     * (`Calculation.ConstructorOptions.startFunctions`). Loads the modules without starting them.
+     * @internal
+     */
+    protected _startFunctions(): Promise<readonly IFunction[]>;
+    /** Modules whose functions a start registered: `onAdd` leaves them to it. */
+    protected _startModules: WeakSet<IModule>;
     /** @internal */
     protected _createScripts(json?: Record<string, IModule.JSON>): IScript;
     /** {@inheritDoc IWorkbook.toJSON} */

package/types/src/workbook/WorkbookRanges.d.ts

@@ -19,7 +19,7 @@ export declare class WorkbookRanges extends SheetRanges implements ICellRanges {
     /** {@inheritDoc ICellRanges.select} */
     select(options?: ICellRange.SelectOptions): Promise<this>;
     /** {@inheritDoc ICellRanges.addListener} */
-    addListener(listener: ICellRange.Listener, options?: ICellRange.ListenerOptions): IListener.Remove;
+    addListener(listener: ICellRange.Listener<ICellRanges>, options?: ICellRange.ListenerOptions): IListener.Remove;
     get [Symbol.toStringTag](): string;
     /**
      * {@inheritDoc ICellRanges.getAddress}

package/browser/esm/BGOFfpxr2jPIdqmV.mjs

@@ -1,40 +0,0 @@
-/**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.11
-*
-* (C) 2026-present SheetXL Inc. & Michael T. Ford
-* License: The license can be found at https://www.sheetxl.com/license.
-*/
-import { ScalarType as e } from "@sheetxl/primitives";
-function t(t, n, r) {
-	let i = (t) => {
-		let n = null;
-		t.s ? n = t.s : t.r || t.g || (n = e.Number);
-		let a = {
-			name: t.n,
-			scalar: n,
-			range: t.r ?? null,
-			arrayDepth: t.d ?? 0,
-			optional: t.m === "?",
-			rest: t.m === "..."
-		};
-		return t.e !== void 0 && (a.enum = r(t.e)), t.l && (a.lambda = t.l), t.a !== void 0 && (a.lambdaArity = t.a), t.ae && (a.acceptError = !0), t.v !== void 0 && (a.defaultValue = t.v), t.u && (a.omittable = !0), t.w !== void 0 && (a.omittedValue = t.w), t.nl && (a.noLift = !0), t.nf && (a.noFilter = !0), t.lz && (a.lazy = !0), t.rt && (a.reportType = !0), t.vr && (a.valueOrRange = !0), t.g && (a.repeating = t.g.map(i)), delete a.dim, a;
-	}, a = [], o = n.p;
-	if (o) for (let e = 0; e < o.length; e++) a.push(i(o[e]));
-	let s = null;
-	n.r && (s = {}, n.r.s && (s.scalar = n.r.s), n.r.r && (s.range = n.r.r === "p" || n.r.r === "r" || n.r.r === "m" ? n.r.r : null), n.r.d && (s.arrayDepth = n.r.d ?? 0), n.r.l && (s.lambda = n.r.l || null), n.r.k && (s.kind = n.r.k), n.r.vol && (s.volatile = !0));
-	let c = {
-		name: t,
-		parameters: a,
-		returnType: s,
-		context: n.c ? "calculation" : null,
-		maxArguments: n.mx
-	};
-	n.h && (c.hidden = !0);
-	let l = [];
-	for (let e of a) for (let t of [e, ...e.repeating ?? []]) t.enum && !l.includes(t.enum.id) && l.push(t.enum.id);
-	return {
-		decl: c,
-		enumIds: l
-	};
-}
-export { t };