@mstone6969/graph 0.0.0-stage → 0.2.0

package/dist/core/Context3D.js

@@ -0,0 +1,81 @@
+import { Color, Vector3 } from "three";
+import { CSS2DObject } from "three/addons/renderers/CSS2DRenderer.js";
+// src/core/Context3D.ts
+/** Everything a 3D chart needs while building. World coordinates fit the cube -1..1 on each axis. */
+var Context3D = class {
+	root;
+	theme;
+	palette;
+	animated;
+	fontScale;
+	opacity;
+	/** Per-frame callbacks; `t` is seconds since the chart was built. */
+	frames = [];
+	picks = /* @__PURE__ */ new Map();
+	#reveals = /* @__PURE__ */ new Set();
+	/** `fontScale` is `chartStyle.fontSize`. `opacity` is `chartStyle.opacity`: `onFrame` code that writes `material.opacity` multiplies by it. */
+	constructor(root, theme, palette, animated, fontScale = 1, opacity = 1) {
+		this.root = root;
+		this.theme = theme;
+		this.palette = palette;
+		this.animated = animated;
+		this.fontScale = fontScale;
+		this.opacity = opacity;
+	}
+	color(value) {
+		return new Color(value);
+	}
+	/** Run `fn` every frame while the chart is mounted. Never runs in headless signatures. */
+	onFrame(fn) {
+		if (this.animated) this.frames.push(fn);
+	}
+	/**
+	* Ease 0→1 over `duration` seconds after `delay`; `fn` is called immediately with 1 when animation
+	* is off, so geometry is always complete in headless signatures.
+	*/
+	reveal(fn, duration = .9, delay = 0) {
+		if (!this.animated) return fn(1);
+		fn(0);
+		let done = false;
+		const finish = () => {
+			done = true;
+			this.#reveals.delete(finish);
+			fn(1);
+		};
+		this.#reveals.add(finish);
+		this.onFrame((t) => {
+			if (done) return;
+			const x = Math.max(0, Math.min(1, (t - delay) / duration));
+			if (x === 1) return finish();
+			fn(1 - (1 - x) ** 3);
+		});
+	}
+	/** Jumps every running `reveal` to its end, for a picture of the finished chart. */
+	settle() {
+		for (const finish of [...this.#reveals]) finish();
+	}
+	/** Hover tooltip for a mesh; `index` is the instance id for InstancedMesh, otherwise 0. */
+	pick(object, content) {
+		this.picks.set(object, content);
+	}
+	/** Crisp HTML text anchored to a world position. */
+	label(text, position, tone = "secondary", size = 11, parent = this.root) {
+		const el = document.createElement("div");
+		el.textContent = text;
+		Object.assign(el.style, {
+			font: `${size * this.fontScale}px ${this.theme.fontFamily}`,
+			whiteSpace: "nowrap",
+			pointerEvents: "none",
+			color: {
+				ink: this.theme.ink,
+				secondary: this.theme.inkSecondary,
+				muted: this.theme.inkMuted
+			}[tone]
+		});
+		const label = new CSS2DObject(el);
+		label.position.copy(new Vector3(...position));
+		parent.add(label);
+		return label;
+	}
+};
+export { Context3D };

package/dist/core/ExcelWriter.js

@@ -0,0 +1,152 @@
+import { ChartExporter } from "./ChartExporter.js";
+import { ChartExportError, ExportErrorCode } from "./ChartExportError.js";
+import { ExportText } from "./ExportText.js";
+import { strToU8, zipSync } from "fflate";
+// src/core/ExcelWriter.ts
+var TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+var HEAD = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n";
+var MAIN = "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+var PACKAGE = "http://schemas.openxmlformats.org/package/2006";
+var LINKS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var CONTENT = "application/vnd.openxmlformats-officedocument";
+var MAX_COLUMNS = 16384;
+var MAX_ROWS = 1048576;
+var MAX_TEXT = 32767;
+var MAX_SERIAL = 2958465;
+var DAY = 864e5;
+/** Excel counts days from this date, and believes 1900 was a leap year, so its first 60 days read one too high. */
+var EPOCH = Date.UTC(1899, 11, 30);
+var LEAP_BUG = 61;
+var EMU_PER_PIXEL = 9525;
+var [MIN_WIDTH, MAX_WIDTH] = [8, 60];
+/** Column widths come from this many rows, so a million-row sheet is not measured cell by cell. */
+var MEASURED = 1e3;
+/** Indexes into `cellXfs`. */
+var Style = {
+	Date: 1,
+	DateTime: 2,
+	Header: 3,
+	Guarded: 4
+};
+/** A stored string is never run as a formula. The guarded style also keeps it text when someone edits the cell. */
+var FORMULA = /^[=+\-@\t\r\n]/;
+var STYLES = `${HEAD}<styleSheet xmlns="${MAIN}"><numFmts count="2"><numFmt numFmtId="164" formatCode="yyyy\\-mm\\-dd"/><numFmt numFmtId="165" formatCode="yyyy\\-mm\\-dd\\ hh:mm:ss"/></numFmts><fonts count="2"><font><sz val="11"/><name val="Calibri"/></font><font><b/><sz val="11"/><name val="Calibri"/></font></fonts><fills count="2"><fill><patternFill patternType="none"/></fill><fill><patternFill patternType="gray125"/></fill></fills><borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="5"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/><xf numFmtId="164" fontId="0" fillId="0" borderId="0" xfId="0" applyNumberFormat="1"/><xf numFmtId="165" fontId="0" fillId="0" borderId="0" xfId="0" applyNumberFormat="1"/><xf numFmtId="49" fontId="1" fillId="0" borderId="0" xfId="0" quotePrefix="1" applyNumberFormat="1" applyFont="1"/><xf numFmtId="49" fontId="0" fillId="0" borderId="0" xfId="0" quotePrefix="1" applyNumberFormat="1"/></cellXfs><cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>`;
+/** Writes an .xlsx file by hand: a workbook is a zip of XML parts. Text goes through the shared string table, and no cell ever holds a formula. */
+var ExcelWriter = class ExcelWriter {
+	#strings = /* @__PURE__ */ new Map();
+	#references = 0;
+	static async write(chart, { image, scale = 2 } = {}) {
+		const table = ExportText.rows(chart, "Excel export");
+		return ExcelWriter.file(table, image ? await chart.toPNG({ scale }) : null, scale);
+	}
+	/** `image` is a PNG drawn at `scale`, placed at the chart's own size on a second sheet. */
+	static async file(table, image, scale) {
+		if (table.rows.length >= MAX_ROWS || table.columns.length > MAX_COLUMNS) throw new ChartExportError(ExportErrorCode.Unsupported, `A worksheet holds ${MAX_ROWS} rows and ${MAX_COLUMNS} columns, and this table has ${table.rows.length} rows and ${table.columns.length} columns. Use CSV.`);
+		return new ExcelWriter().#workbook(table, image && new Uint8Array(await image.arrayBuffer()), scale);
+	}
+	#workbook(table, image, scale) {
+		const sheets = [["Data", this.#sheet(table)], ...image ? [["Chart", ExcelWriter.#pictureSheet()]] : []];
+		const parts = {
+			"[Content_Types].xml": ExcelWriter.#xml(ExcelWriter.#types(sheets.length)),
+			"_rels/.rels": ExcelWriter.#xml(ExcelWriter.#links([`${LINKS}/officeDocument`, "xl/workbook.xml"])),
+			"xl/workbook.xml": ExcelWriter.#xml(ExcelWriter.#book(sheets.map(([name]) => name))),
+			"xl/_rels/workbook.xml.rels": ExcelWriter.#xml(ExcelWriter.#links(...sheets.map((_, i) => [`${LINKS}/worksheet`, `worksheets/sheet${i + 1}.xml`]), [`${LINKS}/styles`, "styles.xml"], [`${LINKS}/sharedStrings`, "sharedStrings.xml"])),
+			"xl/styles.xml": ExcelWriter.#xml(STYLES),
+			"xl/sharedStrings.xml": ExcelWriter.#xml(this.#stringTable())
+		};
+		sheets.forEach(([, xml], i) => {
+			parts[`xl/worksheets/sheet${i + 1}.xml`] = ExcelWriter.#xml(xml);
+		});
+		if (image) {
+			parts["xl/worksheets/_rels/sheet2.xml.rels"] = ExcelWriter.#xml(ExcelWriter.#links([`${LINKS}/drawing`, "../drawings/drawing1.xml"]));
+			parts["xl/drawings/drawing1.xml"] = ExcelWriter.#xml(ExcelWriter.#drawing(image, scale));
+			parts["xl/drawings/_rels/drawing1.xml.rels"] = ExcelWriter.#xml(ExcelWriter.#links([`${LINKS}/image`, "../media/image1.png"]));
+			parts["xl/media/image1.png"] = [image, { level: 0 }];
+		}
+		return new Blob([zipSync(parts)], { type: TYPE });
+	}
+	static #xml(text) {
+		return [strToU8(text), { level: 6 }];
+	}
+	static #types(sheets) {
+		const override = (part, type) => `<Override PartName="/${part}" ContentType="${type}+xml"/>`;
+		const sheetParts = Array.from({ length: sheets }, (_, i) => override(`xl/worksheets/sheet${i + 1}.xml`, `${CONTENT}.spreadsheetml.worksheet`));
+		return `${HEAD}<Types xmlns="${PACKAGE}/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Default Extension="png" ContentType="image/png"/>` + override("xl/workbook.xml", `${CONTENT}.spreadsheetml.sheet.main`) + sheetParts.join("") + override("xl/styles.xml", `${CONTENT}.spreadsheetml.styles`) + override("xl/sharedStrings.xml", `${CONTENT}.spreadsheetml.sharedStrings`) + (sheets > 1 ? override("xl/drawings/drawing1.xml", `${CONTENT}.drawing`) : "") + "</Types>";
+	}
+	static #links(...targets) {
+		return `${HEAD}<Relationships xmlns="${PACKAGE}/relationships">${targets.map(([type, target], i) => `<Relationship Id="rId${i + 1}" Type="${type}" Target="${target}"/>`).join("")}</Relationships>`;
+	}
+	static #book(names) {
+		return `${HEAD}<workbook xmlns="${MAIN}" xmlns:r="${LINKS}"><bookViews><workbookView/></bookViews><sheets>${names.map((name, i) => `<sheet name="${name}" sheetId="${i + 1}" r:id="rId${i + 1}"/>`).join("")}</sheets></workbook>`;
+	}
+	static #pictureSheet() {
+		return `${HEAD}<worksheet xmlns="${MAIN}" xmlns:r="${LINKS}"><sheetData/><drawing r:id="rId1"/></worksheet>`;
+	}
+	/** The element order is fixed by the schema, and Excel calls a file corrupt when it differs. */
+	#sheet({ columns, rows }) {
+		const widths = columns.map((column) => column.length + 1);
+		const lines = [`<row r="1">${columns.map((column, c) => this.#textCell(ExcelWriter.#ref(c, 1), column, Style.Header)).join("")}</row>`];
+		rows.forEach((row, r) => {
+			const number = r + 2;
+			const cells = row.slice(0, MAX_COLUMNS).map((cell, c) => {
+				if (r < MEASURED) widths[c] = Math.max(widths[c] ?? 0, ExportText.of(cell).length);
+				return this.#cell(ExcelWriter.#ref(c, number), cell);
+			});
+			lines.push(`<row r="${number}">${cells.join("")}</row>`);
+		});
+		const pane = "<pane ySplit=\"1\" topLeftCell=\"A2\" activePane=\"bottomLeft\" state=\"frozen\"/><selection pane=\"bottomLeft\" activeCell=\"A2\" sqref=\"A2\"/>";
+		const cols = widths.map((width, c) => `<col min="${c + 1}" max="${c + 1}" width="${Math.min(MAX_WIDTH, Math.max(MIN_WIDTH, width + 2))}" customWidth="1"/>`).join("");
+		return `${HEAD}<worksheet xmlns="${MAIN}"><dimension ref="A1:${ExcelWriter.#ref(Math.max(widths.length, 1) - 1, rows.length + 1)}"/><sheetViews><sheetView tabSelected="1" workbookViewId="0">${pane}</sheetView></sheetViews><sheetFormatPr defaultRowHeight="15"/>${cols && `<cols>${cols}</cols>`}<sheetData>${lines.join("")}</sheetData></worksheet>`;
+	}
+	#cell(ref, cell) {
+		if (typeof cell === "number") return Number.isFinite(cell) ? `<c r="${ref}"><v>${cell}</v></c>` : Number.isNaN(cell) ? "" : this.#textCell(ref, String(cell));
+		if (typeof cell === "boolean") return `<c r="${ref}" t="b"><v>${+cell}</v></c>`;
+		if (cell instanceof Date && !Number.isNaN(+cell)) return ExcelWriter.#dateCell(ref, cell) ?? this.#textCell(ref, ExportText.stamp(cell));
+		const text = ChartExporter.text(cell);
+		return text ? this.#textCell(ref, text) : "";
+	}
+	/** A date outside the range Excel can show has no serial, so it stays text. */
+	static #dateCell(ref, date) {
+		const days = (ExportText.wall(date) - EPOCH) / DAY;
+		const serial = days < LEAP_BUG ? days - 1 : days;
+		if (serial < 1 || serial > MAX_SERIAL) return null;
+		return `<c r="${ref}" s="${Number.isInteger(serial) ? Style.Date : Style.DateTime}"><v>${serial}</v></c>`;
+	}
+	#textCell(ref, text, style) {
+		const shown = style ?? (FORMULA.test(text) ? Style.Guarded : void 0);
+		return `<c r="${ref}"${shown ? ` s="${shown}"` : ""} t="s"><v>${this.#string(text)}</v></c>`;
+	}
+	#string(text) {
+		this.#references++;
+		const known = this.#strings.get(text);
+		if (known !== void 0) return known;
+		const index = this.#strings.size;
+		this.#strings.set(text, index);
+		return index;
+	}
+	#stringTable() {
+		const items = [...this.#strings.keys()].map((text) => `<si><t xml:space="preserve">${ExcelWriter.#escape(text)}</t></si>`);
+		return `${HEAD}<sst xmlns="${MAIN}" count="${this.#references}" uniqueCount="${this.#strings.size}">${items.join("")}</sst>`;
+	}
+	/** Spreadsheets read `_x0041_` in a string as "A", so a literal one has its underscore escaped the same way. */
+	static #escape(text) {
+		return ChartExporter.writable(text.slice(0, MAX_TEXT)).replace(/_(?=x[0-9a-fA-F]{4}_)/g, "_x005F_").replace(/[&<>\r]/g, (char) => ({
+			"&": "&amp;",
+			"<": "&lt;",
+			">": "&gt;",
+			"\r": "&#13;"
+		})[char]);
+	}
+	static #ref(column, row) {
+		let letters = "";
+		for (let left = column + 1; left > 0; left = Math.floor((left - 1) / 26)) letters = String.fromCharCode(65 + (left - 1) % 26) + letters;
+		return `${letters}${row}`;
+	}
+	/** The size comes from the PNG's own header: width and height follow its 16-byte preamble. */
+	static #drawing(image, scale) {
+		const header = new DataView(image.buffer, image.byteOffset);
+		const cx = Math.round(header.getUint32(16) / scale * EMU_PER_PIXEL), cy = Math.round(header.getUint32(20) / scale * EMU_PER_PIXEL);
+		return `${HEAD}<xdr:wsDr xmlns:xdr="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="${LINKS}"><xdr:oneCellAnchor><xdr:from><xdr:col>0</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>0</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:from><xdr:ext cx="${cx}" cy="${cy}"/><xdr:pic><xdr:nvPicPr><xdr:cNvPr id="2" name="Chart"/><xdr:cNvPicPr><a:picLocks noChangeAspect="1"/></xdr:cNvPicPr></xdr:nvPicPr><xdr:blipFill><a:blip r:embed="rId1"/><a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="${cx}" cy="${cy}"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:oneCellAnchor></xdr:wsDr>`;
+	}
+};
+export { ExcelWriter };

package/dist/core/ExportText.js

@@ -0,0 +1,28 @@
+import { ChartExporter } from "./ChartExporter.js";
+import { ChartExportError, ExportErrorCode } from "./ChartExportError.js";
+// src/core/ExportText.ts
+/** Cells as people read them. Dates use local time, as chart axes do. */
+var ExportText = class ExportText {
+	/** `table()` with any rows still queued, or an error naming what needed them. A chart holding no data has no rows, whatever its override reads. */
+	static rows(chart, needed) {
+		chart.flush();
+		if (chart.data != null) {
+			const table = chart.table();
+			if (table.rows.length) return table;
+		}
+		throw new ChartExportError(ExportErrorCode.NoData, `${needed} needs rows, and this chart's data has no flat table view.`);
+	}
+	/** The local date and time as milliseconds on a UTC clock. Zone offsets are not whole minutes in old dates, so this reads the fields. */
+	static wall(date) {
+		const wall = /* @__PURE__ */ new Date(0);
+		wall.setUTCFullYear(date.getFullYear(), date.getMonth(), date.getDate());
+		return wall.setUTCHours(date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds());
+	}
+	static stamp(date) {
+		return new Date(ExportText.wall(date)).toISOString().slice(0, 19).replace("T", " ").replace(/ 00:00:00$/, "");
+	}
+	static of(cell) {
+		return cell instanceof Date && !Number.isNaN(+cell) ? ExportText.stamp(cell) : ChartExporter.text(cell);
+	}
+};
+export { ExportText };