@dou-ui/sheet 0.0.0-stage → 0.1.0-alpha.1

package/dist/core/file.js

@@ -0,0 +1,336 @@
+import { boundsOf, parseRange } from "./address.js";
+import { formatValue } from "./format.js";
+import { cellOf, colCountOf, rowCountOf, valueOf } from "./model.js";
+import { shownValue } from "../formula/values.js";
+import { dataBounds, readCSV, sheetToCSV } from "./csv.js";
+import { resolveSheetExtensions } from "./extension.js";
+import { resolveCellType } from "./cell-type.js";
+import { plainCellTypes } from "./plain-cell-types.js";
+import { labelOf } from "./commands.js";
+import { SheetLooks, layStyle } from "./conditional.js";
+import { sheetKey } from "./transaction.js";
+import { SheetFormulaEngine } from "../formula/engine.js";
+import { plainStyle } from "./paint.js";
+import { sheetMessagesFor } from "../locale.js";
+// src/core/file.ts
+/** Declares an exporter; only gives it a type. */
+function defineSheetExporter(exporter) {
+	return exporter;
+}
+var exporterInfo = (exporter, messages) => ({
+	name: exporter.name,
+	label: labelOf(exporter.label, messages),
+	icon: exporter.icon,
+	extension: exporter.extension,
+	mime: exporter.mime,
+	scopes: [...exporter.scopes ?? [
+		"workbook",
+		"sheet",
+		"selection"
+	]]
+});
+var importerInfo = (importer, messages) => ({
+	name: importer.name,
+	label: labelOf(importer.label, messages),
+	accept: [...importer.accept]
+});
+function defineSheetImporter(importer) {
+	return importer;
+}
+/**
+* An import or export that can't be done, for a reason people can be told:
+* the grid shows `reason` in its hint, while `message` is for developers.
+* `code` tells the cases apart, such as `'locked'`.
+*/
+var SheetFileError = class extends Error {
+	code;
+	reason;
+	name = "SheetFileError";
+	constructor(message, code, reason, options) {
+		super(message, options);
+		this.code = code;
+		this.reason = reason;
+	}
+};
+/** What to tell people of a failed import or export: an error's `reason` when it gives one. */
+function reasonOf(error) {
+	if (error instanceof Error) return "reason" in error && typeof error.reason === "string" ? error.reason : error.message;
+	return String(error);
+}
+/** Whether an importer takes a file, by its name, type or first bytes. */
+async function importerTakes(importer, file) {
+	const name = "name" in file ? String(file.name).toLowerCase() : "";
+	for (const accept of importer.accept) {
+		const want = accept.toLowerCase();
+		if (want.startsWith(".") ? name.endsWith(want) : matchType(file.type, want)) return true;
+	}
+	if (!importer.sniff) return false;
+	const head = new Uint8Array(await file.slice(0, 512).arrayBuffer());
+	return importer.sniff(head);
+}
+var matchType = (type, want) => !!type && (want.endsWith("/*") ? type.startsWith(want.slice(0, -1)) : type === want);
+/** The first importer that takes a file, or `undefined`. */
+async function findImporter(importers, file) {
+	for (const importer of importers) if (await importerTakes(importer, file)) return importer;
+}
+/** The cell types by name: the built-in ones, then these, the first named winning. */
+function cellTypeMap(added = []) {
+	const map = /* @__PURE__ */ new Map();
+	for (const type of plainCellTypes) map.set(type.name, type);
+	const seen = /* @__PURE__ */ new Set();
+	for (const type of added) {
+		if (seen.has(type.name)) continue;
+		seen.add(type.name);
+		map.set(type.name, type);
+	}
+	return map;
+}
+/** What exporters read: a workbook and how its cells show. */
+function createFileSource(book, options = {}) {
+	const scope = options.scope ?? "workbook";
+	const types = options.cellTypes ?? cellTypeMap();
+	const locale = options.locale;
+	let result = options.result;
+	let evaluate = options.evaluate;
+	if (!result || !evaluate) {
+		const engine = new SheetFormulaEngine(book, {
+			functions: options.functions,
+			locale
+		});
+		result ??= (key, row, col) => engine.result(key, row, col);
+		evaluate ??= (formula, key) => engine.evaluate(formula, key);
+	}
+	const read = result;
+	const work = evaluate;
+	const at = (sheet, row) => book.sheets[sheet]?.cells[row];
+	const input = (sheet, row, col) => at(sheet, row)?.[col];
+	const resultOf = (sheet, row, col) => {
+		const data = book.sheets[sheet];
+		if (!data) return null;
+		const value = valueOf(input(sheet, row, col));
+		if (typeof value !== "string" || !value.startsWith("=")) return value;
+		return read(sheetKey(data), row, col);
+	};
+	const shown = (sheet, row, col) => {
+		const data = book.sheets[sheet];
+		if (!data) return null;
+		const key = sheetKey(data);
+		const value = valueOf(input(sheet, row, col));
+		if (typeof value !== "string" || !value.startsWith("=")) return value;
+		return shownValue(value, (r, c) => read(key, r, c), row, col);
+	};
+	const typeOf = (sheet, row, col) => resolveCellType(cellOf(input(sheet, row, col)), book, types);
+	const textOf = (sheet, row, col) => {
+		const value = shown(sheet, row, col);
+		const typed = typeOf(sheet, row, col);
+		const own = typed?.definition.format?.(value, typed.setup);
+		if (own !== void 0) return own;
+		return formatValue(value, cellOf(input(sheet, row, col))?.format, locale);
+	};
+	const looks = /* @__PURE__ */ new Map();
+	const looksOf = (sheet) => {
+		let found = looks.get(sheet);
+		if (!found) {
+			const data = book.sheets[sheet];
+			const key = sheetKey(data);
+			found = new SheetLooks(data.conditionalFormats, {
+				valueAt: (row, col) => resultOf(sheet, row, col),
+				textAt: (row, col) => textOf(sheet, row, col),
+				evaluate: (formula) => work(formula, key),
+				styles: book.styles,
+				size: {
+					rows: rowCountOf(data),
+					cols: colCountOf(data)
+				},
+				lang: locale
+			});
+			looks.set(sheet, found);
+		}
+		return found;
+	};
+	const styleOf = (sheet, row, col) => {
+		if (!book.sheets[sheet]) return {};
+		const name = cellOf(input(sheet, row, col))?.style;
+		const own = name ? book.styles?.[name] : void 0;
+		const look = book.sheets[sheet].conditionalFormats?.length ? looksOf(sheet).lookAt(row, col)?.style : void 0;
+		const style = look ? layStyle(own, look) : own;
+		return style ? plainStyle(style) : {};
+	};
+	const index = options.sheet ?? 0;
+	const pick = (i) => {
+		const data = book.sheets[i];
+		return {
+			index: i,
+			data,
+			bounds: dataBounds(data)
+		};
+	};
+	let sheets;
+	if (scope === "workbook") sheets = book.sheets.map((_, i) => pick(i));
+	else {
+		if (!book.sheets[index]) throw new RangeError(`[@dou-ui/sheet] there is no sheet ${index}`);
+		const sheet = pick(index);
+		if (options.bounds) sheet.bounds = options.bounds;
+		sheets = [sheet];
+	}
+	return {
+		book,
+		scope,
+		sheets,
+		colWidth: options.colWidth ?? 96,
+		rowHeight: options.rowHeight ?? 28,
+		locale,
+		messages: options.messages ?? sheetMessagesFor(locale),
+		value: (sheet, row, col) => valueOf(input(sheet, row, col)),
+		result: resultOf,
+		text: textOf,
+		plain(sheet, row, col) {
+			const value = shown(sheet, row, col);
+			const typed = typeOf(sheet, row, col);
+			return typed?.definition.plain ? typed.definition.plain(value, typed.setup) : value;
+		},
+		style: styleOf,
+		format: (sheet, row, col) => cellOf(input(sheet, row, col))?.format,
+		cellType: typeOf,
+		signal: options.signal,
+		view: options.view
+	};
+}
+/** The scope an exporter writes: the one asked for when it can, otherwise its first. */
+function scopeFor(exporter, asked) {
+	const scopes = exporter.scopes ?? [
+		"workbook",
+		"sheet",
+		"selection"
+	];
+	if (asked && !scopes.includes(asked)) throw new RangeError(`[@dou-ui/sheet] the exporter "${exporter.name}" can't export a ${asked}; it exports ${scopes.join(", ")}`);
+	return asked ?? scopes[0];
+}
+/** An exporter's output as a `Blob`. */
+var toBlob = (out, mime) => typeof out === "string" ? new Blob([out], { type: mime }) : out;
+/**
+* Writes a workbook with an exporter, without a grid: in a script, a
+* worker or on a server. Formulas are worked out on the way.
+*/
+async function exportWorkbook(book, exporter, options = {}) {
+	if (exporter.needs === "view") throw new Error(`[@dou-ui/sheet] the exporter "${exporter.name}" draws the grid, so it only works in DouSheet`);
+	const resolved = resolveSheetExtensions(options.extensions);
+	const scope = scopeFor(exporter, options.scope);
+	let bounds;
+	if (options.range != null) {
+		const range = parseRange(options.range);
+		if (!range) throw new RangeError(`[@dou-ui/sheet] "${options.range}" isn't a range`);
+		bounds = boundsOf(range);
+	}
+	let sheet;
+	if (options.sheet != null) {
+		const ref = options.sheet;
+		sheet = typeof ref === "number" ? ref : book.sheets.findIndex((s) => s.id === ref || s.id == null && s.name === ref);
+		if (!book.sheets[sheet]) throw new RangeError(`[@dou-ui/sheet] there is no sheet "${ref}"`);
+	}
+	const source = createFileSource(book, {
+		scope,
+		sheet,
+		bounds,
+		cellTypes: cellTypeMap(resolved.cellTypes),
+		functions: resolved.functions,
+		locale: options.locale,
+		messages: options.messages,
+		colWidth: options.colWidth,
+		rowHeight: options.rowHeight,
+		signal: options.signal
+	});
+	return toBlob(await exporter.export(source, options.options), exporter.mime);
+}
+/** Reads a file with an importer, without a grid. */
+async function readWorkbook(file, importer, options = {}) {
+	const messages = options.messages ?? sheetMessagesFor(options.locale);
+	return await importer.import(file, {
+		messages,
+		locale: options.locale,
+		signal: options.signal
+	}, options.options);
+}
+/** The name of a file without its extension, for a sheet's name. */
+var baseName = (file) => {
+	return ("name" in file ? String(file.name) : "").replace(/\.[^.]*$/, "");
+};
+/** CSV: one sheet (or the selected cells), with the cells' values. */
+var csvExporter = defineSheetExporter({
+	name: "csv",
+	label: (m) => m.file.csv,
+	extension: "csv",
+	mime: "text/csv",
+	scopes: ["sheet", "selection"],
+	export(source, options = {}) {
+		const { index, data, bounds } = source.sheets[0];
+		if (!bounds) return options.bom === false ? "" : "";
+		return sheetToCSV(data, {
+			range: {
+				start: {
+					row: bounds.top,
+					col: bounds.left
+				},
+				end: {
+					row: bounds.bottom,
+					col: bounds.right
+				}
+			},
+			locale: source.locale,
+			result: (row, col) => source.result(index, row, col),
+			cellText: (_input, _value, row, col) => source.text(index, row, col),
+			cellPlain: (_input, _value, row, col) => source.plain(index, row, col),
+			delimiter: options.delimiter,
+			text: options.text,
+			formulas: options.formulas,
+			bom: options.bom,
+			newline: options.newline,
+			escapeFormulas: options.escapeFormulas
+		});
+	}
+});
+/** CSV and tab-separated text: a new sheet named after the file. */
+var csvImporter = defineSheetImporter({
+	name: "csv",
+	label: (m) => m.file.csv,
+	accept: [
+		".csv",
+		".tsv",
+		".txt",
+		"text/csv",
+		"text/tab-separated-values",
+		"text/plain"
+	],
+	async import(file) {
+		const text = await file.text();
+		return { book: {
+			version: 1,
+			sheets: [{
+				name: baseName(file) || "Sheet1",
+				cells: readCSV(text)
+			}]
+		} };
+	}
+});
+/**
+* Puts the built-in exporters (or importers) and the extensions' together,
+* by name: an extension's replaces a built-in one of the same name; two
+* extensions with the same name are an error.
+*/
+function mergeFileHandlers(builtin, added, kind) {
+	const owner = /* @__PURE__ */ new Map();
+	const own = [];
+	for (const { extension, handler } of added) {
+		const taken = owner.get(handler.name);
+		if (taken) throw new Error(`[@dou-ui/sheet] the ${kind} "${handler.name}" is added by both "${taken}" and "${extension}"`);
+		owner.set(handler.name, extension);
+		own.push(handler);
+	}
+	if (kind === "importer") return [...own, ...builtin.filter((handler) => !owner.has(handler.name))];
+	const byName = new Map(own.map((handler) => [handler.name, handler]));
+	const builtinNames = new Set(builtin.map((handler) => handler.name));
+	return [...builtin.map((handler) => byName.get(handler.name) ?? handler), ...own.filter((handler) => !builtinNames.has(handler.name))];
+}
+export { SheetFileError, baseName, cellTypeMap, createFileSource, csvExporter, csvImporter, defineSheetExporter, defineSheetImporter, exportWorkbook, exporterInfo, findImporter, importerInfo, importerTakes, mergeFileHandlers, readWorkbook, reasonOf, scopeFor, toBlob };
+
+//# sourceMappingURL=file.js.map

package/dist/core/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","names":[],"sources":["../../src/core/file.ts"],"sourcesContent":["import type { Component } from 'vue'\nimport { SheetFormulaEngine } from '../formula/engine'\nimport type { SheetFunction } from '../formula/functions'\nimport { shownValue, type SheetResult } from '../formula/values'\nimport { sheetMessagesFor, type SheetMessages } from '../locale'\nimport { boundsOf, parseRange, type SheetBounds } from './address'\nimport { resolveCellType, type SheetCellType, type SheetResolvedType } from './cell-type'\nimport { plainCellTypes } from './plain-cell-types'\nimport { dataBounds, readCSV, sheetToCSV } from './csv'\nimport type { SheetExtension } from './extension'\nimport { resolveSheetExtensions } from './extension'\nimport { formatValue } from './format'\nimport {\n  cellOf,\n  valueOf,\n  type SheetCellInput,\n  type SheetData,\n  type SheetStyle,\n  type SheetValue,\n  type SheetWorkbook,\n} from './model'\nimport { sheetKey, type SheetRef } from './transaction'\nimport { labelOf, type SheetLabel } from './commands'\nimport { layStyle, SheetLooks } from './conditional'\nimport { plainStyle } from './paint'\nimport { colCountOf, rowCountOf } from './model'\nimport type { SheetDrawing } from '../export/draw'\n\n/*\n * Files in and out. An exporter turns the workbook (or a sheet, or the\n * selection) into a file; an importer reads a file into a workbook. Both\n * only see data, so they also run outside the grid, e.g. on a server.\n */\n\n/** What is exported: every sheet, the sheet shown, or the selected cells. */\nexport type SheetExportScope = 'workbook' | 'sheet' | 'selection'\n\n/** A sheet to export, with the cells to write. */\nexport interface SheetFileSheet {\n  /** Its place in the workbook. */\n  index: number\n  data: SheetData\n  /** The cells to write: the selection, or from `A1` to the last cell with data; `null` when it is empty. */\n  bounds: SheetBounds | null\n}\n\n/** What an exporter reads: the workbook and how its cells show, without the grid. */\nexport interface SheetFileSource {\n  /** The workbook as it is stored. */\n  book: SheetWorkbook\n  /** What is being exported. */\n  scope: SheetExportScope\n  /** The sheets to write, in order: one, unless `scope` is `'workbook'`. */\n  sheets: SheetFileSheet[]\n  /** The language dates and numbers are written in. */\n  locale?: string\n  messages: SheetMessages\n  /** The grid's default column width and row height in px, for columns and rows without their own. */\n  colWidth: number\n  rowHeight: number\n  /** A cell's value as stored: for a formula, the formula. */\n  value: (sheet: number, row: number, col: number) => SheetValue\n  /** What a cell comes to: its formula's result (an error as a `SheetError`), or its value. */\n  result: (sheet: number, row: number, col: number) => SheetResult\n  /** The text a cell shows, with its format and cell type, as the grid draws it. */\n  text: (sheet: number, row: number, col: number) => string\n  /**\n   * The value to write into another spreadsheet program: the cell type's\n   * `plain`, or what the cell comes to (an error as its code, such as `#DIV/0!`).\n   */\n  plain: (sheet: number, row: number, col: number) => SheetValue\n  /**\n   * How the cell looks: its named style with what its conditional formats\n   * give it over it, `tone` and `fill` as the colors they are in the light\n   * theme (in `color` and `background`). `{}` for a plain cell.\n   */\n  style: (sheet: number, row: number, col: number) => SheetStyle\n  /** The cell's number or date format. */\n  format: (sheet: number, row: number, col: number) => string | undefined\n  /** The cell's type and its settings, or `undefined` for a plain cell. */\n  cellType: (sheet: number, row: number, col: number) => SheetResolvedType | undefined\n  /** Aborted when the export is called off. */\n  signal?: AbortSignal\n  /** Only for exporters with `needs: 'view'`, in the grid: the cells as the grid draws them. */\n  view?: SheetFileView\n}\n\n/** What an exporter with `needs: 'view'` gets of the grid. */\nexport interface SheetFileView {\n  /**\n   * The cells exported laid out as the grid draws them: column widths, row\n   * heights, text and looks in plain colors of the page's theme.\n   */\n  drawing: (options?: {\n    headers?: boolean\n    gridlines?: boolean\n    background?: boolean\n  }) => SheetDrawing\n}\n\n/** A way to write the workbook as a file, such as CSV; see `defineSheetExporter`. */\nexport interface SheetExporter<Options = any> {\n  /** Unique among the exporters; `exportFile` takes it. */\n  name: string\n  /** Its name in the toolbar's export menu. */\n  label: SheetLabel\n  /**\n   * Its icon in the toolbar's export menu; by default a file icon for its\n   * `extension`, so an exporter needn't load icons (and Vue), as in a Worker.\n   */\n  icon?: Component\n  /** The file name's extension, without the dot, e.g. `xlsx`. */\n  extension: string\n  /** The file's media type. */\n  mime: string\n  /** What it can export, the first being what the toolbar exports. Defaults to every scope. */\n  scopes?: SheetExportScope[]\n  /**\n   * `'view'` for an exporter that draws the cells as the grid shows them\n   * (sizes, the page's colors), which gets `source.view` and only works in\n   * the grid; `exportWorkbook` refuses it. Defaults to `'data'`.\n   */\n  needs?: 'data' | 'view'\n  /** Writes the file. A string is wrapped in a `Blob` of `mime`. */\n  export: (source: SheetFileSource, options?: Options) => Blob | string | Promise<Blob | string>\n}\n\n/**\n * The options an exporter or importer takes; for either of two, either's,\n * so one picked at run time, e.g. by a message, can be passed as it is.\n */\ntype OptionsOf<Handler> = Handler extends\n  SheetExporter<infer Options> | SheetImporter<infer Options, any>\n  ? Options\n  : never\n\n/** What an importer gives back, as it declares it. */\ntype ResultOf<Importer> =\n  Importer extends SheetImporter<any, infer Result> ? Result : SheetImportResult\n\n/** Declares an exporter; only gives it a type. */\nexport function defineSheetExporter<Options = any>(\n  exporter: SheetExporter<Options>,\n): SheetExporter<Options> {\n  return exporter\n}\n\n/** An exporter as menus show it, its label in the sheet's language. */\nexport interface SheetExporterInfo {\n  name: string\n  label: string\n  icon?: Component\n  extension: string\n  mime: string\n  /** What it can export, the first being what it exports by default. */\n  scopes: SheetExportScope[]\n}\n\n/** An importer as menus show it, its label in the sheet's language. */\nexport interface SheetImporterInfo {\n  name: string\n  label: string\n  accept: string[]\n}\n\nexport const exporterInfo = (\n  exporter: SheetExporter,\n  messages: SheetMessages,\n): SheetExporterInfo => ({\n  name: exporter.name,\n  label: labelOf(exporter.label, messages),\n  icon: exporter.icon,\n  extension: exporter.extension,\n  mime: exporter.mime,\n  scopes: [...(exporter.scopes ?? ['workbook', 'sheet', 'selection'])],\n})\n\nexport const importerInfo = (\n  importer: SheetImporter,\n  messages: SheetMessages,\n): SheetImporterInfo => ({\n  name: importer.name,\n  label: labelOf(importer.label, messages),\n  accept: [...importer.accept],\n})\n\n/** Something an importer couldn't bring over, such as images or borders. */\nexport interface SheetImportWarning {\n  /** A short name for what was lost, e.g. `'border'`. */\n  code: string\n  /** It in words, for people. */\n  message: string\n  /** How many times it came up. */\n  count?: number\n  /** The sheet it was on. */\n  sheet?: string\n}\n\n/** What an importer read. */\nexport interface SheetImportResult {\n  book: SheetWorkbook\n  warnings?: SheetImportWarning[]\n}\n\n/** What an importer gets besides the file. */\nexport interface SheetImportContext {\n  messages: SheetMessages\n  locale?: string\n  signal?: AbortSignal\n}\n\n/** A way to read a file into a workbook, such as CSV; see `defineSheetImporter`. */\nexport interface SheetImporter<\n  Options = any,\n  Result extends SheetImportResult = SheetImportResult,\n> {\n  /** Unique among the importers; `importFile`'s `importer` takes it. */\n  name: string\n  /**\n   * What the files it reads are called, such as “CSV 文件”: in the hints the\n   * grid shows about a file without a name, and in `useSheet().importers`\n   * for a menu of your own.\n   */\n  label: SheetLabel\n  /**\n   * The files it reads, as the file picker's `accept` takes them: extensions\n   * such as `.csv` and media types such as `text/csv`.\n   */\n  accept: string[]\n  /** Tells from the file's first bytes whether it reads it, for files whose name says nothing. */\n  sniff?: (head: Uint8Array) => boolean\n  import: (file: Blob, context: SheetImportContext, options?: Options) => Result | Promise<Result>\n}\n\n/**\n * Declares an importer; only gives it a type. `defineSheetImporter<Options, Result>`\n * also says what it gives back, such as warnings it always has.\n */\nexport function defineSheetImporter<Options = any>(\n  importer: SheetImporter<Options>,\n): SheetImporter<Options>\nexport function defineSheetImporter<Options, Result extends SheetImportResult>(\n  importer: SheetImporter<Options, Result>,\n): SheetImporter<Options, Result>\nexport function defineSheetImporter(importer: SheetImporter) {\n  return importer\n}\n\n/**\n * An import or export that can't be done, for a reason people can be told:\n * the grid shows `reason` in its hint, while `message` is for developers.\n * `code` tells the cases apart, such as `'locked'`.\n */\nexport class SheetFileError<Code extends string = string> extends Error {\n  override name = 'SheetFileError'\n  constructor(\n    message: string,\n    readonly code: Code,\n    readonly reason: string,\n    options?: ErrorOptions,\n  ) {\n    super(message, options)\n  }\n}\n\n/** What to tell people of a failed import or export: an error's `reason` when it gives one. */\nexport function reasonOf(error: unknown) {\n  if (error instanceof Error)\n    return 'reason' in error && typeof error.reason === 'string' ? error.reason : error.message\n  return String(error)\n}\n\n/** Whether an importer takes a file, by its name, type or first bytes. */\nexport async function importerTakes(importer: SheetImporter, file: Blob) {\n  const name = 'name' in file ? String((file as File).name).toLowerCase() : ''\n  for (const accept of importer.accept) {\n    const want = accept.toLowerCase()\n    if (want.startsWith('.') ? name.endsWith(want) : matchType(file.type, want)) return true\n  }\n  if (!importer.sniff) return false\n  const head = new Uint8Array(await file.slice(0, 512).arrayBuffer())\n  return importer.sniff(head)\n}\n\nconst matchType = (type: string, want: string) =>\n  !!type && (want.endsWith('/*') ? type.startsWith(want.slice(0, -1)) : type === want)\n\n/** The first importer that takes a file, or `undefined`. */\nexport async function findImporter(importers: readonly SheetImporter[], file: Blob) {\n  for (const importer of importers) if (await importerTakes(importer, file)) return importer\n  return undefined\n}\n\n/** How a source reads a workbook. */\nexport interface SheetFileSourceOptions {\n  scope?: SheetExportScope\n  /** The sheet for `'sheet'` and `'selection'`; the first by default. */\n  sheet?: number\n  /** For `'selection'` (or to write part of a sheet): the cells. */\n  bounds?: SheetBounds\n  /** What formulas come to, by sheet key; a new engine works them out by default. */\n  result?: (key: string, row: number, col: number) => SheetResult\n  cellTypes?: ReadonlyMap<string, SheetCellType>\n  functions?: readonly SheetFunction[]\n  locale?: string\n  messages?: SheetMessages\n  /** The grid's default column width in px; `96` by default. */\n  colWidth?: number\n  /** The grid's default row height in px; `28` by default. */\n  rowHeight?: number\n  /** Works out a formula as if it were in a cell of a sheet, by key, for conditional formats; with `result`. */\n  evaluate?: (formula: string, key: string) => unknown\n  signal?: AbortSignal\n  view?: SheetFileView\n}\n\n/** The cell types by name: the built-in ones, then these, the first named winning. */\nexport function cellTypeMap(added: readonly SheetCellType[] = []) {\n  const map = new Map<string, SheetCellType>()\n  for (const type of plainCellTypes) map.set(type.name, type)\n  const seen = new Set<string>()\n  for (const type of added) {\n    if (seen.has(type.name)) continue\n    seen.add(type.name)\n    map.set(type.name, type)\n  }\n  return map\n}\n\n/** What exporters read: a workbook and how its cells show. */\nexport function createFileSource(\n  book: SheetWorkbook,\n  options: SheetFileSourceOptions = {},\n): SheetFileSource {\n  const scope = options.scope ?? 'workbook'\n  const types = options.cellTypes ?? cellTypeMap()\n  const locale = options.locale\n  let result = options.result\n  let evaluate = options.evaluate\n  if (!result || !evaluate) {\n    const engine = new SheetFormulaEngine(book, {\n      functions: options.functions,\n      locale,\n    })\n    result ??= (key, row, col) => engine.result(key, row, col)\n    evaluate ??= (formula, key) => engine.evaluate(formula, key)\n  }\n  const read = result\n  const work = evaluate\n  const at = (sheet: number, row: number) => book.sheets[sheet]?.cells[row]\n  const input = (sheet: number, row: number, col: number): SheetCellInput => at(sheet, row)?.[col]\n  const resultOf = (sheet: number, row: number, col: number): SheetResult => {\n    const data = book.sheets[sheet]\n    if (!data) return null\n    const value = valueOf(input(sheet, row, col))\n    if (typeof value !== 'string' || !value.startsWith('=')) return value\n    return read(sheetKey(data), row, col)\n  }\n  const shown = (sheet: number, row: number, col: number): SheetValue => {\n    const data = book.sheets[sheet]\n    if (!data) return null\n    const key = sheetKey(data)\n    const value = valueOf(input(sheet, row, col))\n    if (typeof value !== 'string' || !value.startsWith('=')) return value\n    // errors as their code, as the grid shows them\n    return shownValue(value, (r, c) => read(key, r, c), row, col) as SheetValue\n  }\n  const typeOf = (sheet: number, row: number, col: number) =>\n    resolveCellType(cellOf(input(sheet, row, col)), book, types)\n  const textOf = (sheet: number, row: number, col: number) => {\n    const value = shown(sheet, row, col)\n    const typed = typeOf(sheet, row, col)\n    const own = typed?.definition.format?.(value, typed.setup)\n    if (own !== undefined) return own\n    return formatValue(value, cellOf(input(sheet, row, col))?.format, locale)\n  }\n  // conditional formats, worked out for a sheet the first time one of its cells is asked about\n  const looks = new Map<number, SheetLooks>()\n  const looksOf = (sheet: number) => {\n    let found = looks.get(sheet)\n    if (!found) {\n      const data = book.sheets[sheet]!\n      const key = sheetKey(data)\n      found = new SheetLooks(data.conditionalFormats, {\n        valueAt: (row, col) => resultOf(sheet, row, col),\n        textAt: (row, col) => textOf(sheet, row, col),\n        evaluate: (formula) => work(formula, key),\n        styles: book.styles,\n        size: { rows: rowCountOf(data), cols: colCountOf(data) },\n        lang: locale,\n      })\n      looks.set(sheet, found)\n    }\n    return found\n  }\n  const styleOf = (sheet: number, row: number, col: number) => {\n    if (!book.sheets[sheet]) return {}\n    const name = cellOf(input(sheet, row, col))?.style\n    const own = name ? book.styles?.[name] : undefined\n    const look = book.sheets[sheet]!.conditionalFormats?.length\n      ? looksOf(sheet).lookAt(row, col)?.style\n      : undefined\n    const style = look ? layStyle(own, look) : own\n    return style ? plainStyle(style) : {}\n  }\n\n  const index = options.sheet ?? 0\n  const pick = (i: number): SheetFileSheet => {\n    const data = book.sheets[i]!\n    return { index: i, data, bounds: dataBounds(data) }\n  }\n  let sheets: SheetFileSheet[]\n  if (scope === 'workbook') sheets = book.sheets.map((_, i) => pick(i))\n  else {\n    if (!book.sheets[index]) throw new RangeError(`[@dou-ui/sheet] there is no sheet ${index}`)\n    const sheet = pick(index)\n    if (options.bounds) sheet.bounds = options.bounds\n    sheets = [sheet]\n  }\n\n  return {\n    book,\n    scope,\n    sheets,\n    colWidth: options.colWidth ?? 96,\n    rowHeight: options.rowHeight ?? 28,\n    locale,\n    messages: options.messages ?? sheetMessagesFor(locale),\n    value: (sheet, row, col) => valueOf(input(sheet, row, col)),\n    result: resultOf,\n    text: textOf,\n    plain(sheet, row, col) {\n      const value = shown(sheet, row, col)\n      const typed = typeOf(sheet, row, col)\n      return typed?.definition.plain ? typed.definition.plain(value, typed.setup) : value\n    },\n    style: styleOf,\n    format: (sheet, row, col) => cellOf(input(sheet, row, col))?.format,\n    cellType: typeOf,\n    signal: options.signal,\n    view: options.view,\n  }\n}\n\n/** Options of `exportWorkbook`. */\nexport interface SheetExportWorkbookOptions<Options = any> {\n  /** The extensions whose cell types and functions the workbook uses. */\n  extensions?: (SheetExtension | SheetExtension[])[]\n  /** `'workbook'` by default, or the exporter's first scope when it can't. */\n  scope?: SheetExportScope\n  /** The sheet, by index, `id` or name, for `'sheet'` and `'selection'`; the first by default. */\n  sheet?: SheetRef\n  /** The cells, such as `'A1:D20'`, for `'selection'`. */\n  range?: string\n  locale?: string\n  messages?: SheetMessages\n  /** The default column width and row height in px the workbook is laid out with, as `DouSheet`'s `col-width` and `row-height`. */\n  colWidth?: number\n  rowHeight?: number\n  signal?: AbortSignal\n  /** Passed on to the exporter. */\n  options?: Options\n}\n\n/** The scope an exporter writes: the one asked for when it can, otherwise its first. */\nexport function scopeFor(exporter: SheetExporter, asked?: SheetExportScope) {\n  const scopes = exporter.scopes ?? ['workbook', 'sheet', 'selection']\n  if (asked && !scopes.includes(asked))\n    throw new RangeError(\n      `[@dou-ui/sheet] the exporter \"${exporter.name}\" can't export a ${asked}; it exports ${scopes.join(', ')}`,\n    )\n  return asked ?? scopes[0]!\n}\n\n/** An exporter's output as a `Blob`. */\nexport const toBlob = (out: Blob | string, mime: string) =>\n  typeof out === 'string' ? new Blob([out], { type: mime }) : out\n\n/**\n * Writes a workbook with an exporter, without a grid: in a script, a\n * worker or on a server. Formulas are worked out on the way.\n */\nexport async function exportWorkbook<Exporter extends SheetExporter>(\n  book: SheetWorkbook,\n  exporter: Exporter,\n  options: SheetExportWorkbookOptions<OptionsOf<Exporter>> = {},\n): Promise<Blob> {\n  if (exporter.needs === 'view')\n    throw new Error(\n      `[@dou-ui/sheet] the exporter \"${exporter.name}\" draws the grid, so it only works in DouSheet`,\n    )\n  const resolved = resolveSheetExtensions(options.extensions)\n  const scope = scopeFor(exporter, options.scope)\n  let bounds: SheetBounds | undefined\n  if (options.range != null) {\n    const range = parseRange(options.range)\n    if (!range) throw new RangeError(`[@dou-ui/sheet] \"${options.range}\" isn't a range`)\n    bounds = boundsOf(range)\n  }\n  let sheet: number | undefined\n  if (options.sheet != null) {\n    const ref = options.sheet\n    sheet =\n      typeof ref === 'number'\n        ? ref\n        : book.sheets.findIndex((s) => s.id === ref || (s.id == null && s.name === ref))\n    if (!book.sheets[sheet]) throw new RangeError(`[@dou-ui/sheet] there is no sheet \"${ref}\"`)\n  }\n  const source = createFileSource(book, {\n    scope,\n    sheet,\n    bounds,\n    cellTypes: cellTypeMap(resolved.cellTypes),\n    functions: resolved.functions,\n    locale: options.locale,\n    messages: options.messages,\n    colWidth: options.colWidth,\n    rowHeight: options.rowHeight,\n    signal: options.signal,\n  })\n  return toBlob(await exporter.export(source, options.options), exporter.mime)\n}\n\n/** Options of `readWorkbook`. */\nexport interface SheetReadWorkbookOptions<Options = any> {\n  locale?: string\n  messages?: SheetMessages\n  signal?: AbortSignal\n  /** Passed on to the importer. */\n  options?: Options\n}\n\n/** Reads a file with an importer, without a grid. */\nexport async function readWorkbook<Importer extends SheetImporter>(\n  file: Blob,\n  importer: Importer,\n  options: SheetReadWorkbookOptions<OptionsOf<Importer>> = {},\n): Promise<ResultOf<Importer>> {\n  const messages = options.messages ?? sheetMessagesFor(options.locale)\n  const result = await importer.import(\n    file,\n    { messages, locale: options.locale, signal: options.signal },\n    options.options,\n  )\n  return result as ResultOf<Importer>\n}\n\n/** The name of a file without its extension, for a sheet's name. */\nexport const baseName = (file: Blob) => {\n  const name = 'name' in file ? String((file as File).name) : ''\n  return name.replace(/\\.[^.]*$/, '')\n}\n\n/** Options of the CSV exporter. */\nexport interface SheetCSVExportOptions {\n  /** `,` by default. */\n  delimiter?: string\n  /** Starts with a byte order mark, so programs that guess the encoding read it as UTF-8. On by default. */\n  bom?: boolean\n  /**\n   * Writes what the cells show (`¥1,280.00`, `2026年3月5日`) instead of\n   * values a spreadsheet can sort and add up (`1280`, `2026-03-05`, what\n   * formulas come to). Off by default.\n   */\n  text?: boolean\n  /** Writes formulas as written instead of what they come to. Ignored with `text`. */\n  formulas?: boolean\n  /** Line breaks between rows; `\\r\\n` by default. */\n  newline?: string\n  /** Puts a `'` before text a spreadsheet program would run as a formula. On by default. */\n  escapeFormulas?: boolean\n}\n\n/** CSV: one sheet (or the selected cells), with the cells' values. */\nexport const csvExporter = defineSheetExporter<SheetCSVExportOptions>({\n  name: 'csv',\n  label: (m) => m.file.csv,\n  extension: 'csv',\n  mime: 'text/csv',\n  scopes: ['sheet', 'selection'],\n  export(source, options = {}) {\n    const { index, data, bounds } = source.sheets[0]!\n    if (!bounds) return options.bom === false ? '' : ''\n    return sheetToCSV(data, {\n      range: {\n        start: { row: bounds.top, col: bounds.left },\n        end: { row: bounds.bottom, col: bounds.right },\n      },\n      locale: source.locale,\n      result: (row, col) => source.result(index, row, col),\n      cellText: (_input, _value, row, col) => source.text(index, row, col),\n      cellPlain: (_input, _value, row, col) => source.plain(index, row, col),\n      delimiter: options.delimiter,\n      text: options.text,\n      formulas: options.formulas,\n      bom: options.bom,\n      newline: options.newline,\n      escapeFormulas: options.escapeFormulas,\n    })\n  },\n})\n\n/** CSV and tab-separated text: a new sheet named after the file. */\nexport const csvImporter = defineSheetImporter({\n  name: 'csv',\n  label: (m) => m.file.csv,\n  accept: ['.csv', '.tsv', '.txt', 'text/csv', 'text/tab-separated-values', 'text/plain'],\n  async import(file) {\n    const text = await file.text()\n    const name = baseName(file) || 'Sheet1'\n    return { book: { version: 1, sheets: [{ name, cells: readCSV(text) }] } }\n  },\n})\n\n/** A label as text. */\nexport const fileLabel = (label: SheetLabel, messages: SheetMessages) => labelOf(label, messages)\n\n/**\n * Puts the built-in exporters (or importers) and the extensions' together,\n * by name: an extension's replaces a built-in one of the same name; two\n * extensions with the same name are an error.\n */\nexport function mergeFileHandlers<T extends { name: string }>(\n  builtin: readonly T[],\n  added: readonly { extension: string; handler: T }[],\n  kind: 'exporter' | 'importer',\n) {\n  const owner = new Map<string, string>()\n  const own: T[] = []\n  for (const { extension, handler } of added) {\n    const taken = owner.get(handler.name)\n    if (taken)\n      throw new Error(\n        `[@dou-ui/sheet] the ${kind} \"${handler.name}\" is added by both \"${taken}\" and \"${extension}\"`,\n      )\n    owner.set(handler.name, extension)\n    own.push(handler)\n  }\n  if (kind === 'importer')\n    // importers ask the added ones first\n    return [...own, ...builtin.filter((handler) => !owner.has(handler.name))]\n  // exporters keep the built-in ones first, as the menu shows them, one replaced in its place\n  const byName = new Map(own.map((handler) => [handler.name, handler]))\n  const builtinNames = new Set(builtin.map((handler) => handler.name))\n  return [\n    ...builtin.map((handler) => byName.get(handler.name) ?? handler),\n    ...own.filter((handler) => !builtinNames.has(handler.name)),\n  ]\n}\n"],"mappings":"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"}

package/dist/core/fill.js

@@ -0,0 +1,153 @@
+// src/core/fill.ts
+var DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var TIME = /^(\d{2}):(\d{2})$/;
+var NUMBERED = /^(.*?)(\d+)(\D*)$/;
+var DAY = 864e5;
+function kindOf(value) {
+	if (typeof value === "number") return {
+		kind: "number",
+		n: value
+	};
+	if (typeof value !== "string" || value.startsWith("=")) return { kind: "other" };
+	const date = DATE.exec(value);
+	if (date) return {
+		kind: "date",
+		day: Date.UTC(+date[1], +date[2] - 1, +date[3]) / DAY
+	};
+	const time = TIME.exec(value);
+	if (time) return {
+		kind: "time",
+		minute: +time[1] * 60 + +time[2]
+	};
+	const numbered = NUMBERED.exec(value);
+	if (numbered && (numbered[1] || numbered[3]) && numbered[2].length <= 15) return {
+		kind: "numbered",
+		before: numbered[1],
+		n: Number(numbered[2]),
+		width: numbered[2].length,
+		after: numbered[3]
+	};
+	return { kind: "other" };
+}
+var round = (n) => Number(n.toPrecision(15));
+var pad = (n, width = 2) => String(n).padStart(width, "0");
+function dateText(day) {
+	const date = /* @__PURE__ */ new Date(day * DAY);
+	return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`;
+}
+/** The step between equal-spaced numbers, or `null` when they aren't. */
+function evenStep(list) {
+	const step = list[1] - list[0];
+	for (let i = 2; i < list.length; i++) if (round(list[i] - list[i - 1]) !== round(step)) return null;
+	return step;
+}
+/** The best straight line through the numbers, as a function of their place. */
+function trend(list) {
+	const n = list.length;
+	const even = evenStep(list);
+	if (even != null) return (i) => round(list[n - 1] + even * (i - n + 1));
+	const meanX = (n - 1) / 2;
+	const meanY = list.reduce((a, b) => a + b, 0) / n;
+	let top = 0;
+	let bottom = 0;
+	list.forEach((y, x) => {
+		top += (x - meanX) * (y - meanY);
+		bottom += (x - meanX) ** 2;
+	});
+	const slope = top / bottom;
+	return (i) => round(meanY + slope * (i - meanX));
+}
+/**
+* Months between dates, evenly: on the same day of each month, or each on
+* the last day of its month (`1-31`, `2-28` go on `3-31`, `4-30`). `null`
+* otherwise.
+*/
+function monthStep(days) {
+	const parts = days.map((day) => {
+		const date = /* @__PURE__ */ new Date(day * DAY);
+		const next = /* @__PURE__ */ new Date((day + 1) * DAY);
+		return {
+			month: date.getUTCFullYear() * 12 + date.getUTCMonth(),
+			date: date.getUTCDate(),
+			last: next.getUTCDate() === 1
+		};
+	});
+	const sameDay = parts.every((part) => part.date === parts[0].date);
+	const lastDays = parts.every((part) => part.last);
+	if (!sameDay && !lastDays) return null;
+	const step = evenStep(parts.map((part) => part.month));
+	if (!step) return null;
+	return {
+		step,
+		first: parts[0].month,
+		date: sameDay ? parts[0].date : 31
+	};
+}
+/** The `count` values that follow `values`, as the fill handle continues them. */
+function continueValues(values, count, options = {}) {
+	const { mode = "auto", back = false } = options;
+	const copy = mode === "copy";
+	const one = back ? -1 : 1;
+	const n = values.length;
+	const repeat = () => Array.from({ length: count }, (_, i) => values[(n + i) % n] ?? null);
+	if (n === 0 || count <= 0) return [];
+	const kinds = values.map(kindOf);
+	const first = kinds[0];
+	if (!kinds.every((kind) => kind.kind === first.kind) || first.kind === "other") return repeat();
+	const after = (i) => n + i;
+	switch (first.kind) {
+		case "number": {
+			const list = kinds.map((kind) => kind.n);
+			if (n === 1 && mode === "series") return Array.from({ length: count }, (_, i) => round(list[0] + one * (i + 1)));
+			if (n === 1 || copy) return repeat();
+			const at = trend(list);
+			return Array.from({ length: count }, (_, i) => at(after(i)));
+		}
+		case "date": {
+			if (copy) return repeat();
+			const days = kinds.map((kind) => kind.day);
+			const months = n > 1 ? monthStep(days) : null;
+			if (n > 1 && !months && evenStep(days) == null) return repeat();
+			if (months) return Array.from({ length: count }, (_, i) => {
+				const month = months.first + months.step * after(i);
+				const year = Math.floor(month / 12);
+				const last = new Date(Date.UTC(year, month % 12 + 1, 0)).getUTCDate();
+				return `${year}-${pad(month % 12 + 1)}-${pad(Math.min(months.date, last))}`;
+			});
+			const step = n === 1 ? one : days[1] - days[0];
+			return Array.from({ length: count }, (_, i) => dateText(days[n - 1] + step * (i + 1)));
+		}
+		case "time": {
+			if (copy) return repeat();
+			const minutes = kinds.map((kind) => kind.minute);
+			const step = n === 1 ? 60 * one : evenStep(minutes);
+			if (step == null) return repeat();
+			return Array.from({ length: count }, (_, i) => {
+				const m = ((minutes[n - 1] + step * (i + 1)) % 1440 + 1440) % 1440;
+				return `${pad(Math.floor(m / 60))}:${pad(m % 60)}`;
+			});
+		}
+		case "numbered": {
+			if (copy) return repeat();
+			const list = kinds;
+			if (list.some((kind) => kind.before !== first.before || kind.after !== first.after)) return repeat();
+			const numbers = list.map((kind) => kind.n);
+			const step = n === 1 ? one : evenStep(numbers);
+			if (step == null) return repeat();
+			return Array.from({ length: count }, (_, i) => {
+				const value = Math.max(0, numbers[n - 1] + step * (i + 1));
+				return `${first.before}${String(value).padStart(first.width, "0")}${first.after}`;
+			});
+		}
+	}
+}
+/**
+* Whether filling in `auto` mode continues the values rather than copying
+* them. Ctrl / ⌘ while dragging the fill handle does the other.
+*/
+function fillContinues(values) {
+	return continueValues(values, values.length).some((value, i) => value !== values[i]);
+}
+export { continueValues, fillContinues };
+
+//# sourceMappingURL=fill.js.map

package/dist/core/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","names":[],"sources":["../../src/core/fill.ts"],"sourcesContent":["import type { SheetValue } from './model'\n\n/*\n * Continuing a run of values, as dragging the fill handle does: numbers by\n * their trend, dates by days or months, times by hours, text ending in a\n * number (\"第 1 周\") by that number; anything else repeats.\n */\n\nconst DATE = /^(\\d{4})-(\\d{2})-(\\d{2})$/\nconst TIME = /^(\\d{2}):(\\d{2})$/\nconst NUMBERED = /^(.*?)(\\d+)(\\D*)$/\n\ntype Kind =\n  | { kind: 'number'; n: number }\n  | { kind: 'date'; day: number }\n  | { kind: 'time'; minute: number }\n  | { kind: 'numbered'; before: string; n: number; width: number; after: string }\n  | { kind: 'other' }\n\nconst DAY = 86_400_000\n\nfunction kindOf(value: SheetValue): Kind {\n  if (typeof value === 'number') return { kind: 'number', n: value }\n  if (typeof value !== 'string' || value.startsWith('=')) return { kind: 'other' }\n  const date = DATE.exec(value)\n  if (date) return { kind: 'date', day: Date.UTC(+date[1]!, +date[2]! - 1, +date[3]!) / DAY }\n  const time = TIME.exec(value)\n  if (time) return { kind: 'time', minute: +time[1]! * 60 + +time[2]! }\n  const numbered = NUMBERED.exec(value)\n  if (numbered && (numbered[1] || numbered[3]) && numbered[2]!.length <= 15)\n    return {\n      kind: 'numbered',\n      before: numbered[1]!,\n      n: Number(numbered[2]),\n      width: numbered[2]!.length,\n      after: numbered[3]!,\n    }\n  return { kind: 'other' }\n}\n\nconst round = (n: number) => Number(n.toPrecision(15))\n\nconst pad = (n: number, width = 2) => String(n).padStart(width, '0')\n\nfunction dateText(day: number) {\n  const date = new Date(day * DAY)\n  return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`\n}\n\n/** The step between equal-spaced numbers, or `null` when they aren't. */\nfunction evenStep(list: number[]) {\n  const step = list[1]! - list[0]!\n  for (let i = 2; i < list.length; i++)\n    if (round(list[i]! - list[i - 1]!) !== round(step)) return null\n  return step\n}\n\n/** The best straight line through the numbers, as a function of their place. */\nfunction trend(list: number[]) {\n  const n = list.length\n  const even = evenStep(list)\n  if (even != null) return (i: number) => round(list[n - 1]! + even * (i - n + 1))\n  const meanX = (n - 1) / 2\n  const meanY = list.reduce((a, b) => a + b, 0) / n\n  let top = 0\n  let bottom = 0\n  list.forEach((y, x) => {\n    top += (x - meanX) * (y - meanY)\n    bottom += (x - meanX) ** 2\n  })\n  const slope = top / bottom\n  return (i: number) => round(meanY + slope * (i - meanX))\n}\n\n/**\n * Months between dates, evenly: on the same day of each month, or each on\n * the last day of its month (`1-31`, `2-28` go on `3-31`, `4-30`). `null`\n * otherwise.\n */\nfunction monthStep(days: number[]) {\n  const parts = days.map((day) => {\n    const date = new Date(day * DAY)\n    const next = new Date((day + 1) * DAY)\n    return {\n      month: date.getUTCFullYear() * 12 + date.getUTCMonth(),\n      date: date.getUTCDate(),\n      last: next.getUTCDate() === 1,\n    }\n  })\n  const sameDay = parts.every((part) => part.date === parts[0]!.date)\n  const lastDays = parts.every((part) => part.last)\n  if (!sameDay && !lastDays) return null\n  const step = evenStep(parts.map((part) => part.month))\n  if (!step) return null\n  return { step, first: parts[0]!.month, date: sameDay ? parts[0]!.date : 31 }\n}\n\n/**\n * How the fill handle fills: `auto` continues runs it recognises and\n * copies a single number; `series` also counts a single number up by one;\n * `copy` only repeats.\n */\nexport type SheetFillMode = 'auto' | 'series' | 'copy'\n\nexport interface SheetFillOptions {\n  /** @default 'auto' */\n  mode?: SheetFillMode\n  /**\n   * The values are in reverse, filling up or left: a single value counts\n   * down.\n   */\n  back?: boolean\n}\n\n/** The `count` values that follow `values`, as the fill handle continues them. */\nexport function continueValues(\n  values: readonly SheetValue[],\n  count: number,\n  options: SheetFillOptions = {},\n): SheetValue[] {\n  const { mode = 'auto', back = false } = options\n  const copy = mode === 'copy'\n  const one = back ? -1 : 1\n  const n = values.length\n  const repeat = () => Array.from({ length: count }, (_, i) => values[(n + i) % n] ?? null)\n  if (n === 0 || count <= 0) return []\n  const kinds = values.map(kindOf)\n  const first = kinds[0]!\n  const same = kinds.every((kind) => kind.kind === first.kind)\n  if (!same || first.kind === 'other') return repeat()\n  const after = (i: number) => n + i\n  switch (first.kind) {\n    case 'number': {\n      const list = kinds.map((kind) => (kind as { n: number }).n)\n      // one number copies, unless asked for a series\n      if (n === 1 && mode === 'series')\n        return Array.from({ length: count }, (_, i) => round(list[0]! + one * (i + 1)))\n      if (n === 1 || copy) return repeat()\n      const at = trend(list)\n      return Array.from({ length: count }, (_, i) => at(after(i)))\n    }\n    case 'date': {\n      if (copy) return repeat()\n      const days = kinds.map((kind) => (kind as { day: number }).day)\n      // the same day of each month goes on by months, other even steps by days\n      const months = n > 1 ? monthStep(days) : null\n      if (n > 1 && !months && evenStep(days) == null) return repeat()\n      if (months) {\n        return Array.from({ length: count }, (_, i) => {\n          const month = months.first + months.step * after(i)\n          const year = Math.floor(month / 12)\n          const last = new Date(Date.UTC(year, (month % 12) + 1, 0)).getUTCDate()\n          return `${year}-${pad((month % 12) + 1)}-${pad(Math.min(months.date, last))}`\n        })\n      }\n      const step = n === 1 ? one : days[1]! - days[0]!\n      return Array.from({ length: count }, (_, i) => dateText(days[n - 1]! + step * (i + 1)))\n    }\n    case 'time': {\n      if (copy) return repeat()\n      const minutes = kinds.map((kind) => (kind as { minute: number }).minute)\n      const step = n === 1 ? 60 * one : evenStep(minutes)\n      if (step == null) return repeat()\n      return Array.from({ length: count }, (_, i) => {\n        const m = (((minutes[n - 1]! + step * (i + 1)) % 1440) + 1440) % 1440\n        return `${pad(Math.floor(m / 60))}:${pad(m % 60)}`\n      })\n    }\n    case 'numbered': {\n      if (copy) return repeat()\n      const list = kinds as Extract<Kind, { kind: 'numbered' }>[]\n      if (list.some((kind) => kind.before !== first.before || kind.after !== first.after))\n        return repeat()\n      const numbers = list.map((kind) => kind.n)\n      const step = n === 1 ? one : evenStep(numbers)\n      if (step == null) return repeat()\n      return Array.from({ length: count }, (_, i) => {\n        const value = Math.max(0, numbers[n - 1]! + step * (i + 1))\n        return `${first.before}${String(value).padStart(first.width, '0')}${first.after}`\n      })\n    }\n  }\n}\n\n/**\n * Whether filling in `auto` mode continues the values rather than copying\n * them. Ctrl / ⌘ while dragging the fill handle does the other.\n */\nexport function fillContinues(values: readonly SheetValue[]) {\n  const next = continueValues(values, values.length)\n  return next.some((value, i) => value !== values[i])\n}\n"],"mappings":"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"}

package/dist/core/find.js

@@ -0,0 +1,42 @@
+// src/core/find.ts
+var escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* Tells whether a cell's text matches the query; `null` when there is
+* nothing to look for.
+*/
+function cellMatcher(query) {
+	const { search } = query;
+	if (!search) return null;
+	if (query.caseSensitive) return query.wholeCell ? (text) => text === search : (text) => text.includes(search);
+	const lower = search.toLowerCase();
+	return query.wholeCell ? (text) => text.toLowerCase() === lower : (text) => text.toLowerCase().includes(lower);
+}
+/**
+* The text with every match of the query replaced; the text as it is when
+* nothing in it matches. With `wholeCell` the whole text is replaced.
+*/
+function replaceInText(text, query) {
+	const test = cellMatcher(query);
+	if (!test || !test(text)) return text;
+	const replace = query.replace ?? "";
+	if (query.wholeCell) return replace;
+	const re = new RegExp(escapeRegExp(query.search), query.caseSensitive ? "g" : "gi");
+	return text.replace(re, () => replace);
+}
+/** Whether `a` comes before `b`: by sheet, then row, then column. */
+var foundBefore = (a, b) => a.sheet !== b.sheet ? a.sheet < b.sheet : a.row !== b.row ? a.row < b.row : a.col < b.col;
+/** The index of the first match at or after `at` (wrapping round to the first); `-1` for none. */
+function foundFrom(list, at) {
+	if (!list.length) return -1;
+	let lo = 0;
+	let hi = list.length;
+	while (lo < hi) {
+		const mid = lo + hi >> 1;
+		if (foundBefore(list[mid], at)) lo = mid + 1;
+		else hi = mid;
+	}
+	return lo === list.length ? 0 : lo;
+}
+export { cellMatcher, foundBefore, foundFrom, replaceInText };
+
+//# sourceMappingURL=find.js.map

package/dist/core/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","names":[],"sources":["../../src/core/find.ts"],"sourcesContent":["/** What to look for in the cells, and how. */\nexport interface SheetSearchQuery {\n  /** The text to find. */\n  search: string\n  /** What `replace` puts in place of each match. */\n  replace?: string\n  /** Tells upper and lower case apart. */\n  caseSensitive?: boolean\n  /** A cell matches only when its whole text is the search, not when it contains it. */\n  wholeCell?: boolean\n  /**\n   * Where to look: `'values'` (the default) reads the text cells show, a\n   * formula's result included; `'formulas'` reads what was typed, so a\n   * formula is found by the formula itself.\n   */\n  lookIn?: 'values' | 'formulas'\n  /** Which cells: the sheet shown (the default) or every sheet of the workbook. */\n  scope?: 'sheet' | 'workbook'\n}\n\n/** A cell that matches, on the sheet with index `sheet`. */\nexport interface SheetMatch {\n  sheet: number\n  row: number\n  col: number\n}\n\nconst escapeRegExp = (text: string) => text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * Tells whether a cell's text matches the query; `null` when there is\n * nothing to look for.\n */\nexport function cellMatcher(query: SheetSearchQuery): ((text: string) => boolean) | null {\n  const { search } = query\n  if (!search) return null\n  if (query.caseSensitive)\n    return query.wholeCell ? (text) => text === search : (text) => text.includes(search)\n  const lower = search.toLowerCase()\n  return query.wholeCell\n    ? (text) => text.toLowerCase() === lower\n    : (text) => text.toLowerCase().includes(lower)\n}\n\n/**\n * The text with every match of the query replaced; the text as it is when\n * nothing in it matches. With `wholeCell` the whole text is replaced.\n */\nexport function replaceInText(text: string, query: SheetSearchQuery): string {\n  const test = cellMatcher(query)\n  if (!test || !test(text)) return text\n  const replace = query.replace ?? ''\n  if (query.wholeCell) return replace\n  const re = new RegExp(escapeRegExp(query.search), query.caseSensitive ? 'g' : 'gi')\n  // a function, so `$&` and the like in the replacement stay as typed\n  return text.replace(re, () => replace)\n}\n\n/** Whether `a` comes before `b`: by sheet, then row, then column. */\nexport const foundBefore = (a: SheetMatch, b: SheetMatch) =>\n  a.sheet !== b.sheet ? a.sheet < b.sheet : a.row !== b.row ? a.row < b.row : a.col < b.col\n\n/** The index of the first match at or after `at` (wrapping round to the first); `-1` for none. */\nexport function foundFrom(list: readonly SheetMatch[], at: SheetMatch): number {\n  if (!list.length) return -1\n  let lo = 0\n  let hi = list.length\n  while (lo < hi) {\n    const mid = (lo + hi) >> 1\n    if (foundBefore(list[mid]!, at)) lo = mid + 1\n    else hi = mid\n  }\n  return lo === list.length ? 0 : lo\n}\n"],"mappings":";AA2BA,IAAM,gBAAgB,SAAiB,KAAK,QAAQ,uBAAuB,MAAM;;;;;AAMjF,SAAgB,YAAY,OAA6D;CACvF,MAAM,EAAE,WAAW;CACnB,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,MAAM,eACR,OAAO,MAAM,aAAa,SAAS,SAAS,UAAU,SAAS,KAAK,SAAS,MAAM;CACrF,MAAM,QAAQ,OAAO,YAAY;CACjC,OAAO,MAAM,aACR,SAAS,KAAK,YAAY,MAAM,SAChC,SAAS,KAAK,YAAY,CAAC,CAAC,SAAS,KAAK;AACjD;;;;;AAMA,SAAgB,cAAc,MAAc,OAAiC;CAC3E,MAAM,OAAO,YAAY,KAAK;CAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,GAAG,OAAO;CACjC,MAAM,UAAU,MAAM,WAAW;CACjC,IAAI,MAAM,WAAW,OAAO;CAC5B,MAAM,KAAK,IAAI,OAAO,aAAa,MAAM,MAAM,GAAG,MAAM,gBAAgB,MAAM,IAAI;CAElF,OAAO,KAAK,QAAQ,UAAU,OAAO;AACvC;;AAGA,IAAa,eAAe,GAAe,MACzC,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;;AAGxF,SAAgB,UAAU,MAA6B,IAAwB;CAC7E,IAAI,CAAC,KAAK,QAAQ,OAAO;CACzB,IAAI,KAAK;CACT,IAAI,KAAK,KAAK;CACd,OAAO,KAAK,IAAI;EACd,MAAM,MAAO,KAAK,MAAO;EACzB,IAAI,YAAY,KAAK,MAAO,EAAE,GAAG,KAAK,MAAM;OACvC,KAAK;CACZ;CACA,OAAO,OAAO,KAAK,SAAS,IAAI;AAClC"}