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

package/dist/core/data.js

@@ -0,0 +1,118 @@
+// src/core/data.ts
+/** Kinds of values, in the order they sort in: numbers, text, false and true, errors. */
+function rankOf(value) {
+	if (typeof value === "number") return 0;
+	if (typeof value === "string") return 1;
+	if (typeof value === "boolean") return 2;
+	return 3;
+}
+/** Whether a value counts as empty: empty cells sort last, either way. */
+var isEmptyValue = (value) => value == null || value === "";
+var collators = /* @__PURE__ */ new Map();
+/** Compares text the way people of `lang` read it: numbers inside by size, case ignored. */
+function textCollator(lang) {
+	const key = lang ?? "";
+	let collator = collators.get(key);
+	if (!collator) {
+		collator = new Intl.Collator(lang, {
+			numeric: true,
+			sensitivity: "base"
+		});
+		collators.set(key, collator);
+	}
+	return collator;
+}
+/**
+* Compares two values for sorting from small to large: numbers first, then
+* text, then `FALSE` and `TRUE`, then errors. Empty values are not compared
+* here; they go last whatever the order.
+*/
+function compareForSort(a, b, collator = textCollator()) {
+	const ra = rankOf(a);
+	const rb = rankOf(b);
+	if (ra !== rb) return ra - rb;
+	if (ra === 0) return a - b;
+	if (ra === 1) return collator.compare(a, b);
+	if (ra === 2) return Number(a) - Number(b);
+	return 0;
+}
+/**
+* The order to put rows in, sorted by `keys`: a list of the given rows.
+* Equal rows keep their order; empty values go last in either order.
+*/
+function sortRows(rows, keys, valueAt, collator = textCollator()) {
+	const values = keys.map((key) => rows.map((row) => valueAt(row, key.col)));
+	const order = rows.map((_, i) => i);
+	order.sort((x, y) => {
+		for (const [k, key] of keys.entries()) {
+			const a = values[k][x];
+			const b = values[k][y];
+			const ea = isEmptyValue(a);
+			const eb = isEmptyValue(b);
+			if (ea || eb) {
+				if (ea !== eb) return ea ? 1 : -1;
+				continue;
+			}
+			const c = compareForSort(a, b, collator);
+			if (c) return key.order === "desc" ? -c : c;
+		}
+		return x - y;
+	});
+	return order.map((i) => rows[i]);
+}
+/** A number a filter condition can compare with, or `null`. */
+function numberOf(value) {
+	if (typeof value === "number") return value;
+	if (typeof value === "string" && value.trim() !== "") {
+		const n = Number(value.replace(/,/g, ""));
+		return Number.isFinite(n) ? n : null;
+	}
+	return null;
+}
+/** How a cell compares with a condition's operand: as numbers when both are, else as text. */
+function compareTo(value, text, target, collator) {
+	const a = typeof value === "number" ? value : null;
+	const b = numberOf(target);
+	return a != null && b != null ? a - b : collator.compare(text, String(target));
+}
+/** Whether a cell meets a condition, given what it comes to and how it shows. */
+function meetsCondition(condition, value, text, collator = textCollator()) {
+	const { op } = condition;
+	if (op === "blank") return isEmptyValue(value);
+	if (op === "notBlank") return !isEmptyValue(value);
+	const target = condition.value ?? "";
+	const shown = text.toLocaleLowerCase();
+	const wanted = String(target).toLocaleLowerCase();
+	switch (op) {
+		case "contains": return shown.includes(wanted);
+		case "notContains": return !shown.includes(wanted);
+		case "begins": return shown.startsWith(wanted);
+		case "ends": return shown.endsWith(wanted);
+	}
+	if (op === "between" || op === "notBetween") {
+		if (isEmptyValue(value)) return op === "notBetween";
+		const from = compareTo(value, text, target, collator);
+		const to = compareTo(value, text, condition.to ?? "", collator);
+		const inside = from >= 0 && to <= 0 || from <= 0 && to >= 0;
+		return op === "between" ? inside : !inside;
+	}
+	if (isEmptyValue(value)) return op === "ne" ? !isEmptyValue(target) : op === "eq" && isEmptyValue(target);
+	const c = compareTo(value, text, target, collator);
+	switch (op) {
+		case "eq": return c === 0;
+		case "ne": return c !== 0;
+		case "gt": return c > 0;
+		case "ge": return c >= 0;
+		case "lt": return c < 0;
+		case "le": return c <= 0;
+	}
+	return true;
+}
+/** Whether a cell is kept by a column's filter rule. */
+function meetsRule(rule, value, text, collator = textCollator()) {
+	if ("values" in rule) return rule.values.includes(isEmptyValue(value) ? "" : text);
+	return meetsCondition(rule.condition, value, text, collator);
+}
+export { compareForSort, isEmptyValue, meetsCondition, meetsRule, sortRows, textCollator };
+
+//# sourceMappingURL=data.js.map

package/dist/core/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","names":[],"sources":["../../src/core/data.ts"],"sourcesContent":["import type { SheetCondition, SheetFilterRule, SheetSortOrder } from './model'\n\n/*\n * Sorting and filtering rows by their values. The grid hands in what each\n * cell comes to (a formula's result) and how it shows; these only compare.\n */\n\n/** One column to sort by, the first deciding most. */\nexport interface SheetSortKey {\n  /** The column, by number. */\n  col: number\n  order?: SheetSortOrder\n}\n\n/** Kinds of values, in the order they sort in: numbers, text, false and true, errors. */\nfunction rankOf(value: unknown) {\n  if (typeof value === 'number') return 0\n  if (typeof value === 'string') return 1\n  if (typeof value === 'boolean') return 2\n  return 3\n}\n\n/** Whether a value counts as empty: empty cells sort last, either way. */\nexport const isEmptyValue = (value: unknown) => value == null || value === ''\n\nconst collators = new Map<string, Intl.Collator>()\n/** Compares text the way people of `lang` read it: numbers inside by size, case ignored. */\nexport function textCollator(lang?: string) {\n  const key = lang ?? ''\n  let collator = collators.get(key)\n  if (!collator) {\n    collator = new Intl.Collator(lang, { numeric: true, sensitivity: 'base' })\n    collators.set(key, collator)\n  }\n  return collator\n}\n\n/**\n * Compares two values for sorting from small to large: numbers first, then\n * text, then `FALSE` and `TRUE`, then errors. Empty values are not compared\n * here; they go last whatever the order.\n */\nexport function compareForSort(a: unknown, b: unknown, collator = textCollator()) {\n  const ra = rankOf(a)\n  const rb = rankOf(b)\n  if (ra !== rb) return ra - rb\n  if (ra === 0) return (a as number) - (b as number)\n  if (ra === 1) return collator.compare(a as string, b as string)\n  if (ra === 2) return Number(a) - Number(b)\n  return 0\n}\n\n/**\n * The order to put rows in, sorted by `keys`: a list of the given rows.\n * Equal rows keep their order; empty values go last in either order.\n */\nexport function sortRows(\n  rows: readonly number[],\n  keys: readonly SheetSortKey[],\n  valueAt: (row: number, col: number) => unknown,\n  collator = textCollator(),\n): number[] {\n  // read every value once\n  const values = keys.map((key) => rows.map((row) => valueAt(row, key.col)))\n  const order = rows.map((_, i) => i)\n  // oxlint-disable-next-line unicorn/no-array-sort -- sorts a fresh array\n  order.sort((x, y) => {\n    for (const [k, key] of keys.entries()) {\n      const a = values[k]![x]\n      const b = values[k]![y]\n      const ea = isEmptyValue(a)\n      const eb = isEmptyValue(b)\n      if (ea || eb) {\n        if (ea !== eb) return ea ? 1 : -1\n        continue\n      }\n      const c = compareForSort(a, b, collator)\n      if (c) return key.order === 'desc' ? -c : c\n    }\n    return x - y\n  })\n  return order.map((i) => rows[i]!)\n}\n\n/** A number a filter condition can compare with, or `null`. */\nfunction numberOf(value: unknown): number | null {\n  if (typeof value === 'number') return value\n  if (typeof value === 'string' && value.trim() !== '') {\n    const n = Number(value.replace(/,/g, ''))\n    return Number.isFinite(n) ? n : null\n  }\n  return null\n}\n\n/** How a cell compares with a condition's operand: as numbers when both are, else as text. */\nfunction compareTo(value: unknown, text: string, target: unknown, collator: Intl.Collator) {\n  const a = typeof value === 'number' ? value : null\n  const b = numberOf(target)\n  return a != null && b != null ? a - b : collator.compare(text, String(target))\n}\n\n/** Whether a cell meets a condition, given what it comes to and how it shows. */\nexport function meetsCondition(\n  condition: SheetCondition,\n  value: unknown,\n  text: string,\n  collator = textCollator(),\n) {\n  const { op } = condition\n  if (op === 'blank') return isEmptyValue(value)\n  if (op === 'notBlank') return !isEmptyValue(value)\n  const target = condition.value ?? ''\n  const shown = text.toLocaleLowerCase()\n  const wanted = String(target).toLocaleLowerCase()\n  switch (op) {\n    case 'contains':\n      return shown.includes(wanted)\n    case 'notContains':\n      return !shown.includes(wanted)\n    case 'begins':\n      return shown.startsWith(wanted)\n    case 'ends':\n      return shown.endsWith(wanted)\n  }\n  if (op === 'between' || op === 'notBetween') {\n    if (isEmptyValue(value)) return op === 'notBetween'\n    const from = compareTo(value, text, target, collator)\n    const to = compareTo(value, text, condition.to ?? '', collator)\n    // either end may be the larger\n    const inside = (from >= 0 && to <= 0) || (from <= 0 && to >= 0)\n    return op === 'between' ? inside : !inside\n  }\n  if (isEmptyValue(value))\n    return op === 'ne' ? !isEmptyValue(target) : op === 'eq' && isEmptyValue(target)\n  const c = compareTo(value, text, target, collator)\n  switch (op) {\n    case 'eq':\n      return c === 0\n    case 'ne':\n      return c !== 0\n    case 'gt':\n      return c > 0\n    case 'ge':\n      return c >= 0\n    case 'lt':\n      return c < 0\n    case 'le':\n      return c <= 0\n  }\n  return true\n}\n\n/** Whether a cell is kept by a column's filter rule. */\nexport function meetsRule(\n  rule: SheetFilterRule,\n  value: unknown,\n  text: string,\n  collator = textCollator(),\n) {\n  if ('values' in rule) return rule.values.includes(isEmptyValue(value) ? '' : text)\n  return meetsCondition(rule.condition, value, text, collator)\n}\n"],"mappings":"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"}

package/dist/core/document.js

@@ -0,0 +1,187 @@
+import { boundsOf, parseRange } from "./address.js";
+import { resolveSheetExtensions } from "./extension.js";
+import { overlaps } from "./merge.js";
+import { plainCellTypes } from "./plain-cell-types.js";
+// src/core/document.ts
+/** A workbook with no sheets, to start from when nothing is saved yet. */
+var emptyWorkbook = () => ({
+	version: 1,
+	sheets: []
+});
+/**
+* What is wrong with the shape itself: the workbook is not an object, or a
+* list in it is not an array. Nothing else can be checked until it is fixed.
+*/
+function shapeProblems(value, lists) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return [{
+		code: "shape",
+		path: "",
+		text: "",
+		message: "The workbook is not an object"
+	}];
+	return lists.filter((key) => !Array.isArray(value[key])).map((key) => ({
+		code: "shape",
+		path: key,
+		text: "",
+		message: `"${key}" is not a list`
+	}));
+}
+/**
+* The problems of a workbook, before it is saved or shown: an unknown
+* version, sheets without a name or sharing a name or id, cells using a
+* style or type nobody defined, and merges that are not ranges or overlap
+* another.
+*/
+function checkWorkbook(workbook, options = {}) {
+	const shape = shapeProblems(workbook, ["sheets"]);
+	if (shape.length) return shape;
+	const problems = [];
+	if (workbook.version !== 1) problems.push({
+		code: "version",
+		path: "version",
+		text: String(workbook.version),
+		message: `Version ${String(workbook.version)} is not known`
+	});
+	const cellTypes = new Set(plainCellTypes.map((type) => type.name));
+	for (const type of resolveSheetExtensions(options.extensions).cellTypes) cellTypes.add(type.name);
+	for (const [name, setup] of Object.entries(workbook.types ?? {})) if (!cellTypes.has(setup?.type)) problems.push({
+		code: "unknown-type",
+		path: `types.${name}`,
+		text: String(setup?.type),
+		message: `The type "${name}" sets up "${String(setup?.type)}", which no one defines`
+	});
+	const styles = new Set(Object.keys(workbook.styles ?? {}));
+	const types = /* @__PURE__ */ new Set([...cellTypes, ...Object.keys(workbook.types ?? {})]);
+	const names = /* @__PURE__ */ new Set();
+	const ids = /* @__PURE__ */ new Set();
+	workbook.sheets.forEach((sheet, i) => {
+		const path = `sheets[${i}]`;
+		if (!sheet.name) problems.push({
+			code: "missing-name",
+			path,
+			text: "",
+			message: `${path} has no name`
+		});
+		else if (names.has(sheet.name)) problems.push({
+			code: "duplicate-name",
+			sheet: sheet.name,
+			path,
+			text: sheet.name,
+			message: `The sheet name "${sheet.name}" is used more than once`
+		});
+		names.add(sheet.name);
+		if (sheet.id !== void 0) {
+			if (ids.has(sheet.id)) problems.push({
+				code: "duplicate-id",
+				sheet: sheet.name,
+				path,
+				text: sheet.id,
+				message: `The sheet id "${sheet.id}" is used more than once`
+			});
+			ids.add(sheet.id);
+		}
+		checkCells(sheet, path, styles, types, problems);
+		checkMerges(sheet, path, problems);
+	});
+	return problems;
+}
+function checkCells(sheet, path, styles, types, problems) {
+	sheet.cells.forEach((row, r) => row?.forEach((cell, c) => {
+		if (!cell || typeof cell !== "object") return;
+		const at = `${path}.cells[${r}][${c}]`;
+		if (cell.style !== void 0 && !styles.has(cell.style)) problems.push({
+			code: "unknown-style",
+			sheet: sheet.name,
+			path: at,
+			text: cell.style,
+			message: `No style "${cell.style}" is in the workbook's styles`
+		});
+		if (cell.type !== void 0 && !types.has(cell.type)) problems.push({
+			code: "unknown-type",
+			sheet: sheet.name,
+			path: at,
+			text: cell.type,
+			message: `No cell type "${cell.type}" is defined`
+		});
+	}));
+}
+function checkMerges(sheet, path, problems) {
+	const seen = [];
+	sheet.merges?.forEach((text, m) => {
+		const range = typeof text === "string" ? parseRange(text) : null;
+		const bounds = range && boundsOf(range);
+		const whole = bounds && Number.isFinite(bounds.bottom) && Number.isFinite(bounds.right);
+		const clash = whole && seen.some((other) => overlaps(other, bounds));
+		if (whole && !clash) {
+			seen.push(bounds);
+			return;
+		}
+		problems.push({
+			code: "bad-merge",
+			sheet: sheet.name,
+			path: `${path}.merges[${m}]`,
+			text: String(text),
+			message: clash ? `The merge "${text}" overlaps another one` : `The merge "${String(text)}" is not a range of cells`
+		});
+	});
+}
+/** The saved data as an object of version 1, or an error saying why it can't be. */
+function sourceOf(input) {
+	if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error(`[@dou-ui/sheet] a workbook must be an object, not ${Array.isArray(input) ? "an array" : JSON.stringify(input) ?? String(input)}`);
+	const source = input;
+	const version = source.version ?? 1;
+	if (version !== 1) throw new Error(`[@dou-ui/sheet] unknown document version ${JSON.stringify(version) ?? String(version)} (expected 1); data saved by a newer @dou-ui/sheet needs that version to open`);
+	return source;
+}
+/**
+* Brings a saved workbook up to the current version, and fills what an
+* older or hand-written one may lack (`version`, `sheets`, each sheet's
+* `cells`). Sheets that are not objects are dropped; anything else is kept
+* as it is. Throws for data that is not an object
+* (an array, `null`, a string) and for a version it does not know.
+*/
+function migrateWorkbook(input) {
+	const source = sourceOf(input);
+	const sheets = [];
+	for (const value of Array.isArray(source.sheets) ? source.sheets : []) {
+		if (!value || typeof value !== "object") continue;
+		const sheet = value;
+		sheets.push({
+			...sheet,
+			name: String(sheet.name ?? ""),
+			cells: Array.isArray(sheet.cells) ? sheet.cells : []
+		});
+	}
+	return {
+		...source,
+		version: 1,
+		sheets
+	};
+}
+var warned = /* @__PURE__ */ new Set();
+/**
+* The `v-model` as the sheet reads it. A workbook of the wrong shape (not
+* an object, without `sheets`, without a known `version`) gets a warning in
+* development and is read with what is missing left empty and the version
+* as 1, so the sheet still opens and what it writes back carries
+* `version: 1`.
+*/
+function readWorkbook(value) {
+	const plain = !!value && typeof value === "object" && !Array.isArray(value);
+	const source = plain ? value : {};
+	const sheets = Array.isArray(source.sheets);
+	const problem = !plain ? `is ${Array.isArray(value) ? "an array" : JSON.stringify(value) ?? String(value)}` : !sheets ? "has no sheets array" : source.version === void 0 ? "has no version" : source.version !== 1 ? `has version ${JSON.stringify(source.version)}` : "";
+	if (!problem) return value;
+	if (process.env.NODE_ENV !== "production" && !warned.has(problem)) {
+		warned.add(problem);
+		console.warn(`[@dou-ui/sheet] the v-model ${problem}; expected { version: 1, sheets: [...] }. What is missing is read as empty and the version as 1; read saved data with migrateWorkbook().`);
+	}
+	return {
+		...source,
+		version: 1,
+		sheets: sheets ? source.sheets : []
+	};
+}
+export { checkWorkbook, emptyWorkbook, migrateWorkbook, readWorkbook };
+
+//# sourceMappingURL=document.js.map

package/dist/core/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","names":[],"sources":["../../src/core/document.ts"],"sourcesContent":["import { boundsOf, parseRange } from './address'\nimport { resolveSheetExtensions, type SheetExtension } from './extension'\nimport { overlaps } from './merge'\nimport type { SheetBounds } from './address'\nimport type { SheetData, SheetWorkbook } from './model'\nimport { plainCellTypes } from './plain-cell-types'\n\n/** A workbook with no sheets, to start from when nothing is saved yet. */\nexport const emptyWorkbook = (): SheetWorkbook => ({ version: 1, sheets: [] })\n\nexport interface WorkbookProblem {\n  code:\n    | 'version'\n    | 'shape'\n    | 'missing-name'\n    | 'duplicate-name'\n    | 'duplicate-id'\n    | 'unknown-style'\n    | 'unknown-type'\n    | 'bad-merge'\n  /** The name of the sheet at fault; none for the workbook's own problems. */\n  sheet?: string\n  /**\n   * Where the problem is, as a path into the workbook, e.g. `sheets[1]`,\n   * `sheets[0].cells[3][2]` or `types.status`; `version` for the version.\n   */\n  path: string\n  /** The name, style, type or range at fault, for the editor's message. */\n  text: string\n  /** An English description, for logs. */\n  message: string\n}\n\nexport interface CheckWorkbookOptions {\n  /**\n   * The sheet's `extensions`, for the cell types they add. Without them only\n   * the built-in types (`date`, `select`, `checkbox`) and the workbook's own\n   * `types` are known.\n   */\n  extensions?: readonly (SheetExtension | readonly SheetExtension[])[]\n}\n\n/**\n * What is wrong with the shape itself: the workbook is not an object, or a\n * list in it is not an array. Nothing else can be checked until it is fixed.\n */\nfunction shapeProblems(value: unknown, lists: string[]): WorkbookProblem[] {\n  if (!value || typeof value !== 'object' || Array.isArray(value))\n    return [{ code: 'shape', path: '', text: '', message: 'The workbook is not an object' }]\n  return lists\n    .filter((key) => !Array.isArray((value as Record<string, unknown>)[key]))\n    .map((key) => ({ code: 'shape', path: key, text: '', message: `\"${key}\" is not a list` }))\n}\n\n/**\n * The problems of a workbook, before it is saved or shown: an unknown\n * version, sheets without a name or sharing a name or id, cells using a\n * style or type nobody defined, and merges that are not ranges or overlap\n * another.\n */\nexport function checkWorkbook(\n  workbook: SheetWorkbook,\n  options: CheckWorkbookOptions = {},\n): WorkbookProblem[] {\n  const shape = shapeProblems(workbook, ['sheets'])\n  if (shape.length) return shape\n  const problems: WorkbookProblem[] = []\n  if (workbook.version !== 1)\n    problems.push({\n      code: 'version',\n      path: 'version',\n      text: String(workbook.version),\n      message: `Version ${String(workbook.version)} is not known`,\n    })\n  const cellTypes = new Set(plainCellTypes.map((type) => type.name))\n  for (const type of resolveSheetExtensions(options.extensions).cellTypes) cellTypes.add(type.name)\n  for (const [name, setup] of Object.entries(workbook.types ?? {}))\n    if (!cellTypes.has(setup?.type))\n      problems.push({\n        code: 'unknown-type',\n        path: `types.${name}`,\n        text: String(setup?.type),\n        message: `The type \"${name}\" sets up \"${String(setup?.type)}\", which no one defines`,\n      })\n  const styles = new Set(Object.keys(workbook.styles ?? {}))\n  const types = new Set([...cellTypes, ...Object.keys(workbook.types ?? {})])\n\n  const names = new Set<string>()\n  const ids = new Set<string>()\n  workbook.sheets.forEach((sheet, i) => {\n    const path = `sheets[${i}]`\n    if (!sheet.name)\n      problems.push({ code: 'missing-name', path, text: '', message: `${path} has no name` })\n    else if (names.has(sheet.name))\n      problems.push({\n        code: 'duplicate-name',\n        sheet: sheet.name,\n        path,\n        text: sheet.name,\n        message: `The sheet name \"${sheet.name}\" is used more than once`,\n      })\n    names.add(sheet.name)\n    if (sheet.id !== undefined) {\n      if (ids.has(sheet.id))\n        problems.push({\n          code: 'duplicate-id',\n          sheet: sheet.name,\n          path,\n          text: sheet.id,\n          message: `The sheet id \"${sheet.id}\" is used more than once`,\n        })\n      ids.add(sheet.id)\n    }\n    checkCells(sheet, path, styles, types, problems)\n    checkMerges(sheet, path, problems)\n  })\n  return problems\n}\n\nfunction checkCells(\n  sheet: SheetData,\n  path: string,\n  styles: Set<string>,\n  types: Set<string>,\n  problems: WorkbookProblem[],\n) {\n  sheet.cells.forEach((row, r) =>\n    row?.forEach((cell, c) => {\n      if (!cell || typeof cell !== 'object') return\n      const at = `${path}.cells[${r}][${c}]`\n      if (cell.style !== undefined && !styles.has(cell.style))\n        problems.push({\n          code: 'unknown-style',\n          sheet: sheet.name,\n          path: at,\n          text: cell.style,\n          message: `No style \"${cell.style}\" is in the workbook's styles`,\n        })\n      if (cell.type !== undefined && !types.has(cell.type))\n        problems.push({\n          code: 'unknown-type',\n          sheet: sheet.name,\n          path: at,\n          text: cell.type,\n          message: `No cell type \"${cell.type}\" is defined`,\n        })\n    }),\n  )\n}\n\nfunction checkMerges(sheet: SheetData, path: string, problems: WorkbookProblem[]) {\n  const seen: SheetBounds[] = []\n  sheet.merges?.forEach((text, m) => {\n    const range = typeof text === 'string' ? parseRange(text) : null\n    const bounds = range && boundsOf(range)\n    const whole = bounds && Number.isFinite(bounds.bottom) && Number.isFinite(bounds.right)\n    const clash = whole && seen.some((other) => overlaps(other, bounds))\n    if (whole && !clash) {\n      seen.push(bounds)\n      return\n    }\n    problems.push({\n      code: 'bad-merge',\n      sheet: sheet.name,\n      path: `${path}.merges[${m}]`,\n      text: String(text),\n      message: clash\n        ? `The merge \"${text}\" overlaps another one`\n        : `The merge \"${String(text)}\" is not a range of cells`,\n    })\n  })\n}\n\n/** The saved data as an object of version 1, or an error saying why it can't be. */\nfunction sourceOf(input: unknown): Record<string, unknown> {\n  if (!input || typeof input !== 'object' || Array.isArray(input))\n    throw new Error(\n      `[@dou-ui/sheet] a workbook must be an object, not ${Array.isArray(input) ? 'an array' : (JSON.stringify(input) ?? String(input))}`,\n    )\n  const source = input as Record<string, unknown>\n  const version = source.version ?? 1\n  if (version !== 1)\n    throw new Error(\n      `[@dou-ui/sheet] unknown document version ${JSON.stringify(version) ?? String(version)} (expected 1); data saved by a newer @dou-ui/sheet needs that version to open`,\n    )\n  return source\n}\n\n/**\n * Brings a saved workbook up to the current version, and fills what an\n * older or hand-written one may lack (`version`, `sheets`, each sheet's\n * `cells`). Sheets that are not objects are dropped; anything else is kept\n * as it is. Throws for data that is not an object\n * (an array, `null`, a string) and for a version it does not know.\n */\nexport function migrateWorkbook(input: unknown): SheetWorkbook {\n  const source = sourceOf(input)\n  const sheets: SheetData[] = []\n  for (const value of Array.isArray(source.sheets) ? source.sheets : []) {\n    if (!value || typeof value !== 'object') continue\n    const sheet = value as Record<string, unknown>\n    sheets.push({\n      ...sheet,\n      name: String(sheet.name ?? ''),\n      cells: Array.isArray(sheet.cells) ? sheet.cells : [],\n    } as SheetData)\n  }\n  return { ...source, version: 1, sheets } as SheetWorkbook\n}\n\nconst warned = new Set<string>()\n\n/**\n * The `v-model` as the sheet reads it. A workbook of the wrong shape (not\n * an object, without `sheets`, without a known `version`) gets a warning in\n * development and is read with what is missing left empty and the version\n * as 1, so the sheet still opens and what it writes back carries\n * `version: 1`.\n */\nexport function readWorkbook(value: unknown): SheetWorkbook {\n  const plain = !!value && typeof value === 'object' && !Array.isArray(value)\n  const source = (plain ? value : {}) as Partial<SheetWorkbook>\n  const sheets = Array.isArray(source.sheets)\n  const problem = !plain\n    ? `is ${Array.isArray(value) ? 'an array' : (JSON.stringify(value) ?? String(value))}`\n    : !sheets\n      ? 'has no sheets array'\n      : source.version === undefined\n        ? 'has no version'\n        : source.version !== 1\n          ? `has version ${JSON.stringify(source.version)}`\n          : ''\n  if (!problem) return value as SheetWorkbook\n  if (process.env.NODE_ENV !== 'production' && !warned.has(problem)) {\n    warned.add(problem)\n    console.warn(\n      `[@dou-ui/sheet] the v-model ${problem}; expected { version: 1, sheets: [...] }. What is missing is read as empty and the version as 1; read saved data with migrateWorkbook().`,\n    )\n  }\n  return { ...source, version: 1, sheets: sheets ? source.sheets! : [] }\n}\n"],"mappings":"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"}

package/dist/core/extension.js

@@ -0,0 +1,60 @@
+// src/core/extension.ts
+/** Declares an extension; only gives it a type. */
+function defineSheetExtension(extension) {
+	return extension;
+}
+function flatten(list) {
+	const out = [];
+	for (const item of list) if (Array.isArray(item)) out.push(...flatten(item));
+	else out.push(item);
+	return out;
+}
+/** Sorts the extensions by priority and collects what they add. */
+function resolveSheetExtensions(list = []) {
+	const extensions = flatten(list).map((extension, index) => ({
+		extension,
+		index
+	})).sort((a, b) => (b.extension.priority ?? 100) - (a.extension.priority ?? 100) || a.index - b.index).map((entry) => entry.extension);
+	const names = /* @__PURE__ */ new Set();
+	for (const extension of extensions) {
+		if (names.has(extension.name)) throw new Error(`[@dou-ui/sheet] the extension "${extension.name}" is added twice`);
+		names.add(extension.name);
+	}
+	const pick = (key) => extensions.flatMap((e) => e[key] ? [e[key]] : []);
+	const keepers = extensions.filter((extension) => extension.comments);
+	if (keepers.length > 1) throw new Error("[@dou-ui/sheet] only one extension may keep the comment threads");
+	return {
+		extensions,
+		cellTypes: extensions.flatMap((e) => e.cellTypes ?? []),
+		functions: extensions.flatMap((e) => e.functions ?? []).reverse(),
+		commands: extensions.flatMap((e) => e.commands ? [{
+			extension: e.name,
+			commands: e.commands
+		}] : []),
+		exporters: extensions.flatMap((e) => (e.exporters ?? []).map((exporter) => ({
+			extension: e.name,
+			exporter
+		}))),
+		importers: extensions.flatMap((e) => (e.importers ?? []).map((importer) => ({
+			extension: e.name,
+			importer
+		}))),
+		keymaps: pick("keymap"),
+		toolbars: pick("toolbar"),
+		menus: pick("contextMenu"),
+		setups: pick("setup"),
+		transactions: pick("transaction"),
+		updates: pick("update"),
+		pasteTransforms: pick("transformPaste"),
+		overlays: extensions.flatMap((e) => e.overlays ?? []),
+		layers: {
+			below: extensions.flatMap((e) => e.layers?.below ?? []),
+			above: extensions.flatMap((e) => e.layers?.above ?? [])
+		},
+		history: extensions.find((e) => e.history)?.history,
+		comments: keepers[0]?.comments
+	};
+}
+export { defineSheetExtension, resolveSheetExtensions };
+
+//# sourceMappingURL=extension.js.map

package/dist/core/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","names":[],"sources":["../../src/core/extension.ts"],"sourcesContent":["import type { CommentAction, CommentThread } from 'dou-ui'\nimport type { Component, Ref } from 'vue'\nimport type { SheetContext } from '../context'\nimport type { SheetMenuContext, SheetMenuItem, SheetToolbarItem } from '../types'\nimport type { SheetCommand } from './commands'\nimport type { SheetExporter, SheetImporter } from './file'\nimport type { SheetFunction } from '../formula/functions'\nimport type { SheetCellType } from './cell-type'\nimport type { SheetClip } from './clipboard'\nimport type { SheetWorkbook } from './model'\nimport type { SheetTransaction } from './transaction'\n\n/** What an extension's hooks receive; the same as `useSheet()`. */\nexport type SheetExtensionContext = SheetContext\n\n/**\n * A key handler: return `false` to let the key through to the next handler\n * and the grid's own keys; anything else means it was handled.\n */\nexport type SheetKeyHandler = (event: KeyboardEvent) => boolean | void\n\n/** An undo history used instead of the grid's own, e.g. one that only takes back this user's changes. */\nexport interface SheetHistoryHandler {\n  /** `false` when there was nothing to undo. */\n  undo: () => boolean\n  redo: () => boolean\n  canUndo: () => boolean\n  canRedo: () => boolean\n}\n\n/** A change the grid has made, as an extension's `update` sees it. */\nexport interface SheetUpdate {\n  /** The workbook before the change. */\n  before: SheetWorkbook\n  /** The workbook now. */\n  doc: SheetWorkbook\n  /**\n   * The change: typing, commands, undo and redo, `transact` and other\n   * people's changes. `transaction.meta.action` says what made it, and\n   * other people's changes in collaboration have `meta.origin` `'remote'`.\n   * `null` when a new workbook came in through `v-model`.\n   */\n  transaction: SheetTransaction | null\n}\n\n/** Where the comment threads live, when not in `v-model:comments`. */\nexport interface SheetCommentsProvider {\n  /** The threads, kept up to date. */\n  threads: Readonly<Ref<readonly CommentThread[]>>\n  /** Make a change this user asked for. */\n  apply: (action: CommentAction) => void\n}\n\n/**\n * A piece of the sheet: cell types, keys, menu items, panels drawn over\n * the grid, and a say in every change.\n */\nexport interface SheetExtension {\n  name: string\n  /** Higher runs first: its keys and hooks come before others. Defaults to 100. */\n  priority?: number\n  /** Cell types cells can name with `type`; one with a built-in name replaces it. */\n  cellTypes?: SheetCellType[]\n  /**\n   * Functions formulas can call (see `defineSheetFunction`); one with a\n   * built-in name replaces it.\n   */\n  functions?: SheetFunction[]\n  /**\n   * Commands, by name: things toolbar items, menu items and keys can refer\n   * to. Start the names with the extension's, e.g. `xlsx.export`. A name the\n   * sheet already has replaces that command only with `override: true`.\n   */\n  commands?: Record<string, SheetCommand>\n  /**\n   * Ways to write files, offered in the toolbar's export menu and by\n   * `exportFile`. One with a built-in name (`csv`, `png`, `svg`) replaces it.\n   */\n  exporters?: SheetExporter[]\n  /**\n   * Ways to read files, for the toolbar's import button, `importFile` and\n   * dropped files. They are asked before the built-in CSV one.\n   */\n  importers?: SheetImporter[]\n  /**\n   * Keys, written as in `useHotkey` (e.g. `mod+b`, `alt+arrowdown`), while the\n   * grid has focus and no cell is being edited: a handler, or the name of a\n   * command to run. They come before the grid's own.\n   */\n  keymap?: (context: SheetExtensionContext) => Record<string, SheetKeyHandler | string>\n  /** Items for the right-click menu, put before the built-in ones. */\n  contextMenu?: (context: SheetExtensionContext, menu: SheetMenuContext) => SheetMenuItem[]\n  /**\n   * Items for `DouSheetToolbar`: after the built-in tools, or where its\n   * `tools` names them by `key`.\n   */\n  toolbar?: (context: SheetExtensionContext) => SheetToolbarItem[]\n  /**\n   * Components drawn over the grid, not scrolled with it, e.g. a panel or\n   * marks placed with `cellRect`. They can call `useSheet()`.\n   */\n  overlays?: Component[]\n  /**\n   * Components drawn over the cells, kept out of the headers: `below`\n   * under the grid's own marks, such as the copied range and formula\n   * references, `above` over them; the editor stays on top. They place marks with\n   * `useSheet()`'s `cellRect` and `rangeRect`, which follow the scroll, and\n   * take no clicks.\n   */\n  layers?: { below?: Component[]; above?: Component[] }\n  /**\n   * Keeps the comment threads somewhere else than `v-model:comments`, e.g.\n   * in a shared document; `v-model:comments` then only mirrors them. Only\n   * one extension may.\n   */\n  comments?: (context: SheetExtensionContext) => SheetCommentsProvider\n  /** Replaces the grid's undo history; the first extension that has one wins. */\n  history?: (context: SheetExtensionContext) => SheetHistoryHandler\n  /** Runs once the grid is mounted. Return a function to run when it unmounts. */\n  setup?: (context: SheetExtensionContext) => void | (() => void)\n  /**\n   * Sees every change made in the grid or with `transact` before it is\n   * applied, in priority order, and may add steps to it. Undo takes back\n   * the added steps with the rest.\n   */\n  transaction?: (tr: SheetTransaction, context: SheetExtensionContext) => void\n  /**\n   * Runs after every change, with the workbook already updated: changes in\n   * the grid, `transact`, undo and redo, other people's changes and a new\n   * `v-model` workbook. For keeping something else in step, such as a save\n   * reminder; to change the change itself use `transaction`.\n   */\n  update?: (update: SheetUpdate, context: SheetExtensionContext) => void\n  /**\n   * Rewrites cells before they are pasted, or imported at the active cell,\n   * in priority order; return `null` to stop it. A paste's `paste` event\n   * comes after, with what the extensions made of it; an import has none.\n   * Cut cells that come back rewritten still leave their place, in the\n   * same step, but formulas pointing at them don't follow.\n   */\n  transformPaste?: (clip: SheetClip, context: SheetExtensionContext) => SheetClip | null\n}\n\n/** Declares an extension; only gives it a type. */\nexport function defineSheetExtension(extension: SheetExtension): SheetExtension {\n  return extension\n}\n\n/** Everything the extensions contribute, gathered once per list. */\nexport interface ResolvedSheetExtensions {\n  extensions: SheetExtension[]\n  cellTypes: SheetCellType[]\n  functions: SheetFunction[]\n  commands: { extension: string; commands: Record<string, SheetCommand> }[]\n  exporters: { extension: string; exporter: SheetExporter }[]\n  importers: { extension: string; importer: SheetImporter }[]\n  keymaps: NonNullable<SheetExtension['keymap']>[]\n  toolbars: NonNullable<SheetExtension['toolbar']>[]\n  menus: NonNullable<SheetExtension['contextMenu']>[]\n  setups: NonNullable<SheetExtension['setup']>[]\n  transactions: NonNullable<SheetExtension['transaction']>[]\n  updates: NonNullable<SheetExtension['update']>[]\n  pasteTransforms: NonNullable<SheetExtension['transformPaste']>[]\n  overlays: Component[]\n  layers: { below: Component[]; above: Component[] }\n  history?: SheetExtension['history']\n  comments?: SheetExtension['comments']\n}\n\ntype ExtensionList = readonly (SheetExtension | readonly SheetExtension[])[]\n\nfunction flatten(list: ExtensionList): SheetExtension[] {\n  const out: SheetExtension[] = []\n  for (const item of list) {\n    if (Array.isArray(item)) out.push(...flatten(item))\n    else out.push(item as SheetExtension)\n  }\n  return out\n}\n\n/** Sorts the extensions by priority and collects what they add. */\nexport function resolveSheetExtensions(list: ExtensionList = []): ResolvedSheetExtensions {\n  const extensions = flatten(list)\n    .map((extension, index) => ({ extension, index }))\n    // oxlint-disable-next-line unicorn/no-array-sort -- sorts a fresh array\n    .sort(\n      (a, b) => (b.extension.priority ?? 100) - (a.extension.priority ?? 100) || a.index - b.index,\n    )\n    .map((entry) => entry.extension)\n\n  const names = new Set<string>()\n  for (const extension of extensions) {\n    if (names.has(extension.name))\n      throw new Error(`[@dou-ui/sheet] the extension \"${extension.name}\" is added twice`)\n    names.add(extension.name)\n  }\n\n  const pick = <K extends keyof SheetExtension>(key: K) =>\n    extensions.flatMap((e) => (e[key] ? [e[key]] : [])) as NonNullable<SheetExtension[K]>[]\n\n  const keepers = extensions.filter((extension) => extension.comments)\n  if (keepers.length > 1)\n    throw new Error('[@dou-ui/sheet] only one extension may keep the comment threads')\n\n  return {\n    extensions,\n    // the first (highest priority) extension to name a type wins\n    cellTypes: extensions.flatMap((e) => e.cellTypes ?? []),\n    // added in reverse, so the highest priority one is added last and wins\n    // oxlint-disable-next-line unicorn/no-array-reverse -- reverses a fresh array\n    functions: extensions.flatMap((e) => e.functions ?? []).reverse(),\n    commands: extensions.flatMap((e) =>\n      e.commands ? [{ extension: e.name, commands: e.commands }] : [],\n    ),\n    exporters: extensions.flatMap((e) =>\n      (e.exporters ?? []).map((exporter) => ({ extension: e.name, exporter })),\n    ),\n    importers: extensions.flatMap((e) =>\n      (e.importers ?? []).map((importer) => ({ extension: e.name, importer })),\n    ),\n    keymaps: pick('keymap'),\n    toolbars: pick('toolbar'),\n    menus: pick('contextMenu'),\n    setups: pick('setup'),\n    transactions: pick('transaction'),\n    updates: pick('update'),\n    pasteTransforms: pick('transformPaste'),\n    overlays: extensions.flatMap((e) => e.overlays ?? []),\n    layers: {\n      below: extensions.flatMap((e) => e.layers?.below ?? []),\n      above: extensions.flatMap((e) => e.layers?.above ?? []),\n    },\n    history: extensions.find((e) => e.history)?.history,\n    comments: keepers[0]?.comments,\n  }\n}\n"],"mappings":";;AAgJA,SAAgB,qBAAqB,WAA2C;CAC9E,OAAO;AACT;AAyBA,SAAS,QAAQ,MAAuC;CACtD,MAAM,MAAwB,CAAC;CAC/B,KAAK,MAAM,QAAQ,MACjB,IAAI,MAAM,QAAQ,IAAI,GAAG,IAAI,KAAK,GAAG,QAAQ,IAAI,CAAC;MAC7C,IAAI,KAAK,IAAsB;CAEtC,OAAO;AACT;;AAGA,SAAgB,uBAAuB,OAAsB,CAAC,GAA4B;CACxF,MAAM,aAAa,QAAQ,IAAI,CAAC,CAC7B,KAAK,WAAW,WAAW;EAAE;EAAW;CAAM,EAAE,CAAC,CAEjD,MACE,GAAG,OAAO,EAAE,UAAU,YAAY,QAAQ,EAAE,UAAU,YAAY,QAAQ,EAAE,QAAQ,EAAE,KACzF,CAAC,CACA,KAAK,UAAU,MAAM,SAAS;CAEjC,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,MAAM,IAAI,UAAU,IAAI,GAC1B,MAAM,IAAI,MAAM,kCAAkC,UAAU,KAAK,iBAAiB;EACpF,MAAM,IAAI,UAAU,IAAI;CAC1B;CAEA,MAAM,QAAwC,QAC5C,WAAW,SAAS,MAAO,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,CAAE;CAEpD,MAAM,UAAU,WAAW,QAAQ,cAAc,UAAU,QAAQ;CACnE,IAAI,QAAQ,SAAS,GACnB,MAAM,IAAI,MAAM,iEAAiE;CAEnF,OAAO;EACL;EAEA,WAAW,WAAW,SAAS,MAAM,EAAE,aAAa,CAAC,CAAC;EAGtD,WAAW,WAAW,SAAS,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ;EAChE,UAAU,WAAW,SAAS,MAC5B,EAAE,WAAW,CAAC;GAAE,WAAW,EAAE;GAAM,UAAU,EAAE;EAAS,CAAC,IAAI,CAAC,CAChE;EACA,WAAW,WAAW,SAAS,OAC5B,EAAE,aAAa,CAAC,EAAA,CAAG,KAAK,cAAc;GAAE,WAAW,EAAE;GAAM;EAAS,EAAE,CACzE;EACA,WAAW,WAAW,SAAS,OAC5B,EAAE,aAAa,CAAC,EAAA,CAAG,KAAK,cAAc;GAAE,WAAW,EAAE;GAAM;EAAS,EAAE,CACzE;EACA,SAAS,KAAK,QAAQ;EACtB,UAAU,KAAK,SAAS;EACxB,OAAO,KAAK,aAAa;EACzB,QAAQ,KAAK,OAAO;EACpB,cAAc,KAAK,aAAa;EAChC,SAAS,KAAK,QAAQ;EACtB,iBAAiB,KAAK,gBAAgB;EACtC,UAAU,WAAW,SAAS,MAAM,EAAE,YAAY,CAAC,CAAC;EACpD,QAAQ;GACN,OAAO,WAAW,SAAS,MAAM,EAAE,QAAQ,SAAS,CAAC,CAAC;GACtD,OAAO,WAAW,SAAS,MAAM,EAAE,QAAQ,SAAS,CAAC,CAAC;EACxD;EACA,SAAS,WAAW,MAAM,MAAM,EAAE,OAAO,CAAC,EAAE;EAC5C,UAAU,QAAQ,EAAE,EAAE;CACxB;AACF"}