@bilig/workbook 0.58.0 → 0.62.0

package/dist/features.js

@@ -0,0 +1,208 @@
+import { isCellRangeRef } from '@bilig/protocol';
+import { isWorkbookOp } from './guards.js';
+import { isWorkbookActionInput, isWorkbookActionInputDescription, normalizeWorkbookActionInput, } from './input.js';
+export function normalizeWorkbookFeatureId(value, label = 'Workbook feature id') {
+    const normalized = value.trim();
+    if (normalized === '') {
+        throw new Error(`${label} cannot be empty`);
+    }
+    if (normalized !== value) {
+        throw new Error(`${label} must not have leading or trailing whitespace`);
+    }
+    return normalized;
+}
+export function defineWorkbookFeaturePlugin(plugin) {
+    const id = normalizeWorkbookFeatureId(plugin.id);
+    const version = normalizeRequiredString(plugin.version, `Workbook feature ${id} version`);
+    const dependsOn = plugin.dependsOn?.map((dependency) => normalizeWorkbookFeatureId(dependency, `Workbook feature ${id} dependency`));
+    const commands = plugin.commands.map((command) => normalizeWorkbookCommandDescriptor(command, id));
+    const projectionInterceptors = plugin.projectionInterceptors.map((interceptor) => normalizeProjectionInterceptor(interceptor, id));
+    const uiContributions = plugin.uiContributions.map((contribution) => normalizeUiContribution(contribution, id));
+    return Object.freeze({
+        id,
+        version,
+        ...(dependsOn !== undefined ? { dependsOn: Object.freeze([...dependsOn]) } : {}),
+        commands: Object.freeze(commands),
+        projectionInterceptors: Object.freeze(projectionInterceptors),
+        uiContributions: Object.freeze(uiContributions),
+        ...(plugin.register !== undefined ? { register: plugin.register } : {}),
+        ...(plugin.activate !== undefined ? { activate: plugin.activate } : {}),
+        ...(plugin.dispose !== undefined ? { dispose: plugin.dispose } : {}),
+    });
+}
+export function normalizeWorkbookCommandDescriptor(descriptor, expectedFeatureId) {
+    const featureId = normalizeWorkbookFeatureId(descriptor.featureId, 'Workbook command feature id');
+    if (expectedFeatureId !== undefined && featureId !== expectedFeatureId) {
+        throw new Error(`Workbook command ${descriptor.id} feature id ${featureId} does not match plugin ${expectedFeatureId}`);
+    }
+    const id = normalizeRequiredString(descriptor.id, 'Workbook command id');
+    const label = normalizeRequiredString(descriptor.label, `Workbook command ${id} label`);
+    const description = descriptor.description === undefined ? undefined : normalizeRequiredString(descriptor.description, `Workbook command ${id} description`);
+    if (!isWorkbookCommandCategory(descriptor.category)) {
+        throw new Error(`Workbook command ${id} category is invalid`);
+    }
+    if (descriptor.input !== undefined && !isWorkbookActionInputDescription(descriptor.input)) {
+        throw new Error(`Workbook command ${id} input description is invalid`);
+    }
+    return Object.freeze({
+        id,
+        featureId,
+        category: descriptor.category,
+        label,
+        ...(description !== undefined ? { description } : {}),
+        ...(descriptor.input !== undefined ? { input: descriptor.input } : {}),
+    });
+}
+export function normalizeWorkbookCommandReceipt(receipt) {
+    const featureId = normalizeWorkbookFeatureId(receipt.featureId, 'Workbook command receipt feature id');
+    const commandId = normalizeRequiredString(receipt.commandId, 'Workbook command receipt command id');
+    if (!isWorkbookCommandCategory(receipt.category)) {
+        throw new Error(`Workbook command receipt ${commandId} category is invalid`);
+    }
+    if (!isWorkbookCommandReceiptStatus(receipt.status)) {
+        throw new Error(`Workbook command receipt ${commandId} status is invalid`);
+    }
+    const previewOps = receipt.previewOps?.map((op) => normalizeReceiptOp(commandId, op, 'preview'));
+    const appliedOps = receipt.appliedOps?.map((op) => normalizeReceiptOp(commandId, op, 'applied'));
+    const changedRanges = receipt.changedRanges?.map((range) => normalizeReceiptRange(commandId, range));
+    const proof = receipt.proof === undefined ? undefined : normalizeWorkbookActionInput(receipt.proof);
+    const metadata = receipt.metadata === undefined ? undefined : normalizeWorkbookActionInput(receipt.metadata);
+    const message = receipt.message === undefined ? undefined : normalizeRequiredString(receipt.message, `Workbook command receipt ${commandId} message`);
+    const errors = receipt.errors?.map((error) => normalizeRequiredString(error, `Workbook command receipt ${commandId} error`));
+    return Object.freeze({
+        status: receipt.status,
+        featureId,
+        commandId,
+        category: receipt.category,
+        ...(previewOps !== undefined ? { previewOps: Object.freeze(previewOps) } : {}),
+        ...(appliedOps !== undefined ? { appliedOps: Object.freeze(appliedOps) } : {}),
+        ...(receipt.undo !== undefined ? { undo: receipt.undo } : {}),
+        ...(changedRanges !== undefined ? { changedRanges: Object.freeze(changedRanges) } : {}),
+        ...(proof !== undefined ? { proof } : {}),
+        ...(message !== undefined ? { message } : {}),
+        ...(metadata !== undefined ? { metadata } : {}),
+        ...(errors !== undefined ? { errors: Object.freeze(errors) } : {}),
+    });
+}
+export function isWorkbookCommandReceipt(value) {
+    if (!isWorkbookCommandReceiptCandidate(value)) {
+        return false;
+    }
+    try {
+        normalizeWorkbookCommandReceipt(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function workbookCommandReceiptOpsMatch(receipt) {
+    if (receipt.previewOps === undefined || receipt.appliedOps === undefined) {
+        return null;
+    }
+    return JSON.stringify(receipt.previewOps) === JSON.stringify(receipt.appliedOps);
+}
+function normalizeProjectionInterceptor(interceptor, expectedFeatureId) {
+    const featureId = normalizeWorkbookFeatureId(interceptor.featureId, 'Workbook projection interceptor feature id');
+    if (featureId !== expectedFeatureId) {
+        throw new Error(`Workbook projection interceptor ${interceptor.id} feature id ${featureId} does not match plugin ${expectedFeatureId}`);
+    }
+    const id = normalizeRequiredString(interceptor.id, 'Workbook projection interceptor id');
+    if (!isWorkbookProjectionInterceptorPoint(interceptor.point)) {
+        throw new Error(`Workbook projection interceptor ${id} point is invalid`);
+    }
+    const label = interceptor.label === undefined ? undefined : normalizeRequiredString(interceptor.label, `Workbook projection interceptor ${id} label`);
+    if (interceptor.priority !== undefined && (!Number.isSafeInteger(interceptor.priority) || !Number.isFinite(interceptor.priority))) {
+        throw new Error(`Workbook projection interceptor ${id} priority is invalid`);
+    }
+    return Object.freeze({
+        id,
+        featureId,
+        point: interceptor.point,
+        ...(interceptor.priority !== undefined ? { priority: interceptor.priority } : {}),
+        ...(label !== undefined ? { label } : {}),
+    });
+}
+function normalizeUiContribution(contribution, expectedFeatureId) {
+    const featureId = normalizeWorkbookFeatureId(contribution.featureId, 'Workbook UI contribution feature id');
+    if (featureId !== expectedFeatureId) {
+        throw new Error(`Workbook UI contribution ${contribution.id} feature id ${featureId} does not match plugin ${expectedFeatureId}`);
+    }
+    const id = normalizeRequiredString(contribution.id, 'Workbook UI contribution id');
+    const label = normalizeRequiredString(contribution.label, `Workbook UI contribution ${id} label`);
+    if (!isWorkbookUiContributionSlot(contribution.slot)) {
+        throw new Error(`Workbook UI contribution ${id} slot is invalid`);
+    }
+    if (contribution.order !== undefined && (!Number.isSafeInteger(contribution.order) || !Number.isFinite(contribution.order))) {
+        throw new Error(`Workbook UI contribution ${id} order is invalid`);
+    }
+    if (contribution.metadata !== undefined && !isWorkbookActionInput(contribution.metadata)) {
+        throw new Error(`Workbook UI contribution ${id} metadata is invalid`);
+    }
+    return Object.freeze({
+        id,
+        featureId,
+        slot: contribution.slot,
+        label,
+        ...(contribution.order !== undefined ? { order: contribution.order } : {}),
+        ...(contribution.metadata !== undefined ? { metadata: normalizeWorkbookActionInput(contribution.metadata) } : {}),
+    });
+}
+function normalizeReceiptOp(commandId, op, label) {
+    if (!isWorkbookOp(op)) {
+        throw new Error(`Workbook command receipt ${commandId} ${label} op is invalid`);
+    }
+    return structuredClone(op);
+}
+function normalizeReceiptRange(commandId, range) {
+    if (!isCellRangeRef(range)) {
+        throw new Error(`Workbook command receipt ${commandId} changed range is invalid`);
+    }
+    return structuredClone(range);
+}
+function isWorkbookCommandReceiptCandidate(value) {
+    return (isRecord(value) &&
+        typeof value['featureId'] === 'string' &&
+        typeof value['commandId'] === 'string' &&
+        isWorkbookCommandCategory(value['category']) &&
+        isWorkbookCommandReceiptStatus(value['status']) &&
+        (value['previewOps'] === undefined || (Array.isArray(value['previewOps']) && value['previewOps'].every((op) => isWorkbookOp(op)))) &&
+        (value['appliedOps'] === undefined || (Array.isArray(value['appliedOps']) && value['appliedOps'].every((op) => isWorkbookOp(op)))) &&
+        (value['changedRanges'] === undefined ||
+            (Array.isArray(value['changedRanges']) && value['changedRanges'].every((range) => isCellRangeRef(range)))) &&
+        (value['proof'] === undefined || isWorkbookActionInput(value['proof'])) &&
+        (value['metadata'] === undefined || isWorkbookActionInput(value['metadata'])) &&
+        (value['message'] === undefined || typeof value['message'] === 'string') &&
+        (value['errors'] === undefined || (Array.isArray(value['errors']) && value['errors'].every((error) => typeof error === 'string'))));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizeRequiredString(value, label) {
+    const normalized = value.trim();
+    if (normalized === '') {
+        throw new Error(`${label} cannot be empty`);
+    }
+    if (normalized !== value) {
+        throw new Error(`${label} must not have leading or trailing whitespace`);
+    }
+    return normalized;
+}
+function isWorkbookCommandCategory(value) {
+    return value === 'command' || value === 'operation' || value === 'mutation';
+}
+function isWorkbookCommandReceiptStatus(value) {
+    return value === 'previewed' || value === 'applied' || value === 'rejected' || value === 'noop';
+}
+function isWorkbookProjectionInterceptorPoint(value) {
+    return (value === 'cellDisplay' ||
+        value === 'cellStyle' ||
+        value === 'rangeChrome' ||
+        value === 'rowVisibility' ||
+        value === 'beforeCommand' ||
+        value === 'commandMetadata');
+}
+function isWorkbookUiContributionSlot(value) {
+    return value === 'toolbar' || value === 'sidePanel' || value === 'floatingOverlay' || value === 'status';
+}
+//# sourceMappingURL=features.js.map

package/dist/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"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"}

package/dist/find.d.ts

@@ -51,10 +51,49 @@ export interface WorkbookRowsRef extends WorkbookBaseRef {
     readonly column: (name: string) => WorkbookColumnRef;
 }
 export type WorkbookRef = WorkbookRangeRef | WorkbookNameRef | WorkbookTableRef | WorkbookColumnRef | WorkbookRowsRef;
+export interface WorkbookBaseRefData {
+    readonly kind: WorkbookRefKind;
+    readonly id: string;
+    readonly label: string;
+}
+export interface WorkbookRangeRefData extends WorkbookBaseRefData {
+    readonly kind: 'range';
+    readonly range: CellRangeRef;
+}
+export interface WorkbookNameRefData extends WorkbookBaseRefData {
+    readonly kind: 'name';
+    readonly name: string;
+}
+export interface WorkbookTableRefData extends WorkbookBaseRefData {
+    readonly kind: 'table';
+    readonly name?: string;
+    readonly sheetName?: string;
+    readonly headers?: readonly string[];
+}
+export interface WorkbookColumnRefData extends WorkbookBaseRefData {
+    readonly kind: 'column';
+    readonly table: WorkbookTableRefData;
+    readonly rows?: WorkbookRowsRefData;
+    readonly name: string;
+}
+export interface WorkbookRowsRefData extends WorkbookBaseRefData {
+    readonly kind: 'rows';
+    readonly sheetName?: string;
+    readonly table?: WorkbookTableRefData;
+    readonly where: {
+        readonly column: string;
+        readonly op: WorkbookRowOperator;
+        readonly value: LiteralInput;
+    };
+}
+export type WorkbookRefData = WorkbookRangeRefData | WorkbookNameRefData | WorkbookTableRefData | WorkbookColumnRefData | WorkbookRowsRefData;
 export declare const workbookRefKinds: readonly ["range", "name", "table", "column", "rows"];
 export declare function isWorkbookRefKind(value: unknown): value is WorkbookRefKind;
 export declare function isWorkbookRef(value: unknown): value is WorkbookRef;
+export declare function isWorkbookRefData(value: unknown): value is WorkbookRefData;
 export declare function collectWorkbookRefs(value: unknown): readonly WorkbookRef[];
+export declare function toWorkbookRefData(ref: WorkbookRef | WorkbookRefData): WorkbookRefData;
+export declare function collectWorkbookRefData(value: unknown): readonly WorkbookRefData[];
 export interface FindTableOptions {
     readonly name?: string;
     readonly sheetName?: string;
@@ -106,6 +145,8 @@ export declare function createWorkbookColumnRef(options: FindColumnOptions): Wor
 export declare function createWorkbookRangeRef(input: FindRangeInput): WorkbookRangeRef;
 export declare function createWorkbookNameRef(name: string): WorkbookNameRef;
 export declare function createWorkbookRowsRef(options: FindRowsOptions): WorkbookRowsRef;
+export declare function hydrateWorkbookRef(data: WorkbookRefData): WorkbookRef;
+export declare function hydrateWorkbookRefs(value: unknown): unknown;
 export declare function findTable(options: FindTableOptions): WorkbookTableRef;
 export declare function findColumn(options: FindColumnOptions): WorkbookColumnRef;
 export declare function findRange(input: FindRangeInput): WorkbookRangeRef;

package/dist/find.js

@@ -53,17 +53,22 @@ function isCellRangeRef(value) {
         hasOwnString(value, 'endAddress'));
 }
 function isWorkbookTableRef(value) {
+    return isWorkbookTableRefData(value) && hasOwnFunction(value, 'column');
+}
+function isWorkbookTableRefData(value) {
     return (typeof value === 'object' &&
         value !== null &&
         hasValidBaseRef(value) &&
         value.kind === 'table' &&
         hasOptionalString(value, 'name') &&
         hasOptionalString(value, 'sheetName') &&
-        hasOptionalStringArray(value, 'headers') &&
-        hasOwnFunction(value, 'column'));
+        hasOptionalStringArray(value, 'headers'));
 }
 function isWorkbookRowsRef(value) {
-    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value) || value.kind !== 'rows' || !hasOwnFunction(value, 'column')) {
+    return isWorkbookRowsRefData(value) && hasOwnFunction(value, 'column');
+}
+function isWorkbookRowsRefData(value) {
+    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value) || value.kind !== 'rows') {
         return false;
     }
     const where = Object.getOwnPropertyDescriptor(value, 'where')?.value;
@@ -75,16 +80,24 @@ function isWorkbookRowsRef(value) {
         return false;
     }
     const table = Object.getOwnPropertyDescriptor(value, 'table')?.value;
-    return hasOptionalString(value, 'sheetName') && (table === undefined || isWorkbookTableRef(table));
+    return hasOptionalString(value, 'sheetName') && (table === undefined || isWorkbookTableRefData(table));
 }
 function isWorkbookColumnRef(value) {
-    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value) || value.kind !== 'column' || !hasOwnString(value, 'name')) {
+    if (!isWorkbookColumnRefData(value)) {
         return false;
     }
     const table = Object.getOwnPropertyDescriptor(value, 'table')?.value;
     const rows = Object.getOwnPropertyDescriptor(value, 'rows')?.value;
     return isWorkbookTableRef(table) && (rows === undefined || isWorkbookRowsRef(rows));
 }
+function isWorkbookColumnRefData(value) {
+    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value) || value.kind !== 'column' || !hasOwnString(value, 'name')) {
+        return false;
+    }
+    const table = Object.getOwnPropertyDescriptor(value, 'table')?.value;
+    const rows = Object.getOwnPropertyDescriptor(value, 'rows')?.value;
+    return isWorkbookTableRefData(table) && (rows === undefined || isWorkbookRowsRefData(rows));
+}
 export function isWorkbookRef(value) {
     if (typeof value !== 'object' || value === null || !hasValidBaseRef(value)) {
         return false;
@@ -102,6 +115,23 @@ export function isWorkbookRef(value) {
             return isWorkbookRowsRef(value);
     }
 }
+export function isWorkbookRefData(value) {
+    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value)) {
+        return false;
+    }
+    switch (value.kind) {
+        case 'range':
+            return isCellRangeRef(Object.getOwnPropertyDescriptor(value, 'range')?.value);
+        case 'name':
+            return hasOwnString(value, 'name');
+        case 'table':
+            return isWorkbookTableRefData(value);
+        case 'column':
+            return isWorkbookColumnRefData(value);
+        case 'rows':
+            return isWorkbookRowsRefData(value);
+    }
+}
 export function collectWorkbookRefs(value) {
     const refs = [];
     const seenRefs = new Set();
@@ -141,6 +171,108 @@ export function collectWorkbookRefs(value) {
     visit(value);
     return refs;
 }
+export function toWorkbookRefData(ref) {
+    if (!isWorkbookRefData(ref)) {
+        throw new Error('Workbook ref data is invalid');
+    }
+    switch (ref.kind) {
+        case 'range':
+            return {
+                kind: 'range',
+                id: ref.id,
+                label: ref.label,
+                range: { ...ref.range },
+            };
+        case 'name':
+            return {
+                kind: 'name',
+                id: ref.id,
+                label: ref.label,
+                name: ref.name,
+            };
+        case 'table':
+            return {
+                kind: 'table',
+                id: ref.id,
+                label: ref.label,
+                ...(ref.name !== undefined ? { name: ref.name } : {}),
+                ...(ref.sheetName !== undefined ? { sheetName: ref.sheetName } : {}),
+                ...(ref.headers !== undefined ? { headers: [...ref.headers] } : {}),
+            };
+        case 'column':
+            return {
+                kind: 'column',
+                id: ref.id,
+                label: ref.label,
+                table: toWorkbookTableRefData(ref.table),
+                ...(ref.rows !== undefined ? { rows: toWorkbookRowsRefData(ref.rows) } : {}),
+                name: ref.name,
+            };
+        case 'rows':
+            return {
+                kind: 'rows',
+                id: ref.id,
+                label: ref.label,
+                ...(ref.sheetName !== undefined ? { sheetName: ref.sheetName } : {}),
+                ...(ref.table !== undefined ? { table: toWorkbookTableRefData(ref.table) } : {}),
+                where: { ...ref.where },
+            };
+    }
+}
+function toWorkbookTableRefData(ref) {
+    const data = toWorkbookRefData(ref);
+    if (data.kind !== 'table') {
+        throw new Error('Workbook table ref data is invalid');
+    }
+    return data;
+}
+function toWorkbookRowsRefData(ref) {
+    const data = toWorkbookRefData(ref);
+    if (data.kind !== 'rows') {
+        throw new Error('Workbook rows ref data is invalid');
+    }
+    return data;
+}
+export function collectWorkbookRefData(value) {
+    const refs = [];
+    const seenRefs = new Set();
+    const seenObjects = new WeakSet();
+    function pushRef(ref) {
+        const key = `${ref.kind}:${ref.id}`;
+        if (!seenRefs.has(key)) {
+            seenRefs.add(key);
+            refs.push(ref);
+        }
+    }
+    function visit(current) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return;
+        }
+        if (seenObjects.has(current)) {
+            return;
+        }
+        seenObjects.add(current);
+        if (isWorkbookRefData(current)) {
+            const ref = toWorkbookRefData(current);
+            pushRef(ref);
+            if (ref.kind === 'column') {
+                visit(ref.rows);
+                visit(ref.table);
+            }
+            if (ref.kind === 'rows') {
+                visit(ref.table);
+            }
+            return;
+        }
+        if (Array.isArray(current)) {
+            current.forEach(visit);
+            return;
+        }
+        Object.values(current).forEach(visit);
+    }
+    visit(value);
+    return refs;
+}
 function cleanIdPart(value) {
     const cleaned = value
         .trim()
@@ -379,6 +511,119 @@ export function createWorkbookRowsRef(options) {
     hideHelper(rows, 'column');
     return Object.freeze(rows);
 }
+function refDataKey(ref) {
+    return `${ref.kind}:${ref.id}`;
+}
+function sameRefData(left, right) {
+    return left !== undefined && right !== undefined && refDataKey(left) === refDataKey(right);
+}
+function hydrateTableRefData(data) {
+    const table = {
+        kind: 'table',
+        id: data.id,
+        label: data.label,
+        ...(data.name !== undefined ? { name: data.name } : {}),
+        ...(data.sheetName !== undefined ? { sheetName: data.sheetName } : {}),
+        ...(data.headers !== undefined ? { headers: Object.freeze([...data.headers]) } : {}),
+        column(name) {
+            return createWorkbookColumnRef({ table, name });
+        },
+    };
+    hideHelper(table, 'column');
+    return Object.freeze(table);
+}
+function hydrateRowsRefData(data, sharedTable) {
+    const table = data.table === undefined ? undefined : sameRefData(data.table, sharedTable) ? sharedTable : hydrateTableRefData(data.table);
+    const rows = {
+        kind: 'rows',
+        id: data.id,
+        label: data.label,
+        ...(data.sheetName !== undefined ? { sheetName: data.sheetName } : {}),
+        ...(table !== undefined ? { table } : {}),
+        where: Object.freeze({ ...data.where }),
+        column(name) {
+            if (rows.table === undefined) {
+                throw new Error('Rows column selection requires a table-backed row selector');
+            }
+            return createWorkbookColumnRef({ table: rows.table, rows, name });
+        },
+    };
+    hideHelper(rows, 'column');
+    return Object.freeze(rows);
+}
+export function hydrateWorkbookRef(data) {
+    if (!isWorkbookRefData(data)) {
+        throw new Error('Workbook ref data is invalid');
+    }
+    switch (data.kind) {
+        case 'range':
+            return Object.freeze({
+                kind: 'range',
+                id: data.id,
+                label: data.label,
+                range: Object.freeze({ ...data.range }),
+            });
+        case 'name':
+            return Object.freeze({
+                kind: 'name',
+                id: data.id,
+                label: data.label,
+                name: data.name,
+            });
+        case 'table':
+            return hydrateTableRefData(data);
+        case 'column': {
+            const table = hydrateTableRefData(data.table);
+            const rows = data.rows === undefined ? undefined : hydrateRowsRefData(data.rows, table);
+            return Object.freeze({
+                kind: 'column',
+                id: data.id,
+                label: data.label,
+                table,
+                ...(rows !== undefined ? { rows } : {}),
+                name: data.name,
+            });
+        }
+        case 'rows':
+            return hydrateRowsRefData(data);
+    }
+}
+function isHydratableContainer(value) {
+    const prototype = Object.getPrototypeOf(value);
+    return Array.isArray(value) || prototype === Object.prototype || prototype === null;
+}
+function hydrateWorkbookRefsValue(value, seen) {
+    if (value === null || value === undefined || typeof value !== 'object') {
+        return value;
+    }
+    if (isWorkbookRefData(value)) {
+        return hydrateWorkbookRef(value);
+    }
+    if (!isHydratableContainer(value)) {
+        return value;
+    }
+    const cached = seen.get(value);
+    if (cached !== undefined) {
+        return cached;
+    }
+    if (Array.isArray(value)) {
+        const hydrated = [];
+        seen.set(value, hydrated);
+        value.forEach((entry) => {
+            hydrated.push(hydrateWorkbookRefsValue(entry, seen));
+        });
+        return Object.freeze(hydrated);
+    }
+    const hydrated = {};
+    seen.set(value, hydrated);
+    Object.entries(value).forEach(([key, entry]) => {
+        hydrated[key] = hydrateWorkbookRefsValue(entry, seen);
+    });
+    return Object.freeze(hydrated);
+}
+export function hydrateWorkbookRefs(value) {
+    return hydrateWorkbookRefsValue(value, new WeakMap());
+}
 export function findTable(options) {
     return createWorkbookTableRef(options);
 }