@washy-washy/core 0.0.0 → 1.0.0

package/dist/browser.d.mts

@@ -0,0 +1,2 @@
+import { A as Washer, C as colourGroups, D as Iron, E as variants, M as ironSetting, N as ironSettingKeys, O as IronSetting, P as parseMachine, S as Variant, T as mixTags, _ as washGroups, a as chartToJson, b as MixTag, c as Blocker, d as canMix, f as cardGroups, g as resolve, h as mixBlocker, i as chartFromJson, j as formatTemperature, k as Machine, l as blockerCode, m as loadGroups, n as Row, o as instructionsFromRows, p as ironGroups, r as RowError, s as rowsFromInstructions, t as COLUMNS, u as blockerLegend, v as ColourGroup, w as durationsOf, x as ResolvedInstruction, y as Instruction } from "./rows-lRFNdyJh.mjs";
+export { Blocker, COLUMNS, ColourGroup, Instruction, Iron, IronSetting, Machine, MixTag, ResolvedInstruction, Row, RowError, Variant, Washer, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseMachine, resolve, rowsFromInstructions, variants, washGroups };

package/dist/browser.mjs

@@ -0,0 +1,2 @@
+import { C as parseMachine, S as ironSettingKeys, _ as durationsOf, a as ironGroups, b as formatTemperature, c as resolve, d as RowError, f as chartFromJson, g as colourGroups, h as rowsFromInstructions, i as cardGroups, l as washGroups, m as instructionsFromRows, n as blockerLegend, o as loadGroups, p as chartToJson, r as canMix, s as mixBlocker, t as blockerCode, u as COLUMNS, v as mixTags, x as ironSetting, y as variants } from "./mixing-CazkIyLl.mjs";
+export { COLUMNS, RowError, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseMachine, resolve, rowsFromInstructions, variants, washGroups };

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { A as Washer, C as colourGroups, D as Iron, E as variants, M as ironSetting, N as ironSettingKeys, O as IronSetting, P as parseMachine, S as Variant, T as mixTags, _ as washGroups, a as chartToJson, b as MixTag, c as Blocker, d as canMix, f as cardGroups, g as resolve, h as mixBlocker, i as chartFromJson, j as formatTemperature, k as Machine, l as blockerCode, m as loadGroups, n as Row, o as instructionsFromRows, p as ironGroups, r as RowError, s as rowsFromInstructions, t as COLUMNS, u as blockerLegend, v as ColourGroup, w as durationsOf, x as ResolvedInstruction, y as Instruction } from "./rows-lRFNdyJh.mjs";
+//#region src/csv.d.ts
+/** Parses the instruction CSV. See `instructionsFromRows` for the row rules. */
+declare function parseInstructions(source: string, machine: Machine): Instruction[];
+//#endregion
+export { Blocker, COLUMNS, ColourGroup, Instruction, Iron, IronSetting, Machine, MixTag, ResolvedInstruction, Row, RowError, Variant, Washer, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseInstructions, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,18 @@
+import { C as parseMachine, S as ironSettingKeys, _ as durationsOf, a as ironGroups, b as formatTemperature, c as resolve, d as RowError, f as chartFromJson, g as colourGroups, h as rowsFromInstructions, i as cardGroups, l as washGroups, m as instructionsFromRows, n as blockerLegend, o as loadGroups, p as chartToJson, r as canMix, s as mixBlocker, t as blockerCode, u as COLUMNS, v as mixTags, x as ironSetting, y as variants } from "./mixing-CazkIyLl.mjs";
+import { parse } from "csv-parse/sync";
+//#region src/csv.ts
+/** Parses the instruction CSV. See `instructionsFromRows` for the row rules. */
+function parseInstructions(source, machine) {
+	const records = parse(source, {
+		columns: true,
+		skip_empty_lines: true,
+		trim: true,
+		bom: true
+	});
+	if (records.length === 0) throw new Error("the CSV has a header but no rows");
+	return instructionsFromRows(records, machine);
+}
+//#endregion
+export { COLUMNS, RowError, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseInstructions, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/csv.ts"],"sourcesContent":["import { parse } from \"csv-parse/sync\";\nimport type { Machine } from \"./machine\";\nimport { instructionsFromRows } from \"./rows\";\nimport type { Instruction } from \"./types\";\n\n/** Parses the instruction CSV. See `instructionsFromRows` for the row rules. */\nexport function parseInstructions(source: string, machine: Machine): Instruction[] {\n  const records: Record<string, string>[] = parse(source, {\n    columns: true,\n    skip_empty_lines: true,\n    trim: true,\n    bom: true,\n  });\n  if (records.length === 0) throw new Error(\"the CSV has a header but no rows\");\n  return instructionsFromRows(records, machine);\n}\n"],"mappings":";;;;AAMA,SAAgB,kBAAkB,QAAgB,SAAiC;CACjF,MAAM,UAAoC,MAAM,QAAQ;EACtD,SAAS;EACT,kBAAkB;EAClB,MAAM;EACN,KAAK;CACP,CAAC;CACD,IAAI,QAAQ,WAAW,GAAG,MAAM,IAAI,MAAM,kCAAkC;CAC5E,OAAO,qBAAqB,SAAS,OAAO;AAC9C"}

package/dist/mixing-CazkIyLl.mjs

@@ -0,0 +1,378 @@
+//#region src/machine.ts
+function fail(what) {
+	throw new Error(`machine: ${what}`);
+}
+function stringList(value, field, minimum) {
+	if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string" || entry === "")) fail(`${field} must be a list of non-empty strings`);
+	const list = value;
+	if (list.length < minimum) fail(`${field} needs at least ${minimum} entries, found ${list.length}`);
+	if (new Set(list).size !== list.length) fail(`${field} repeats a value`);
+	return list;
+}
+function text(value, field, fallback) {
+	if (typeof value === "string" && value !== "") return value;
+	if (fallback !== void 0) return fallback;
+	return fail(`${field} must be a non-empty string`);
+}
+function parseIronSetting(value, index) {
+	if (typeof value !== "object" || value === null) fail(`iron.settings[${index}] must be an object`);
+	const raw = value;
+	return {
+		key: text(raw.key, `iron.settings[${index}].key`),
+		dots: typeof raw.dots === "string" ? raw.dots : "",
+		label: text(raw.label, `iron.settings[${index}].label`),
+		detail: text(raw.detail, `iron.settings[${index}].detail`, ""),
+		steam: raw.steam === true
+	};
+}
+/**
+* Checks a parsed machine file and hands back something the renderer can use.
+* Every failure names the field, because the fix is always an edit to that
+* line of JSON.
+*/
+function parseMachine(value) {
+	if (typeof value !== "object" || value === null) fail("the file must contain an object");
+	const raw = value;
+	if (typeof raw.washer !== "object" || raw.washer === null) fail("washer is missing");
+	if (typeof raw.iron !== "object" || raw.iron === null) fail("iron is missing");
+	const washerRaw = raw.washer;
+	const ironRaw = raw.iron;
+	const settings = Array.isArray(ironRaw.settings) ? ironRaw.settings : fail("iron.settings is missing");
+	if (settings.length < 2) fail("iron.settings needs at least 2 positions to draw a ring");
+	const keys = settings.map((setting, index) => parseIronSetting(setting, index));
+	if (new Set(keys.map((setting) => setting.key)).size !== keys.length) fail("iron.settings repeats a key");
+	return {
+		washer: {
+			name: text(washerRaw.name, "washer.name"),
+			capacity: text(washerRaw.capacity, "washer.capacity", ""),
+			programs: stringList(washerRaw.programs, "washer.programs", 2),
+			temperatures: stringList(washerRaw.temperatures, "washer.temperatures", 1),
+			spins: stringList(washerRaw.spins, "washer.spins", 1),
+			options: stringList(washerRaw.options ?? [], "washer.options", 0)
+		},
+		iron: {
+			name: text(ironRaw.name, "iron.name"),
+			settings: keys
+		}
+	};
+}
+function ironSetting(machine, key) {
+	return machine.iron.settings.find((setting) => setting.key === key);
+}
+/**
+* The keys a row may write in `iron_setting`, coolest first.
+*
+* There is no key for "do not iron". That is the `ironing` column's job, and
+* two places to say the same thing is two places to disagree.
+*/
+function ironSettingKeys(machine) {
+	return machine.iron.settings.map((setting) => setting.key);
+}
+/**
+* `40` becomes `40°`; `cold` stays `cold`. The machine file is free to use
+* whatever word its display shows for the cold wash, so the degree sign is
+* decided by whether the value is a number rather than by a list of exceptions.
+*/
+function formatTemperature(value) {
+	return /^\d+$/.test(value) ? `${value}°` : value;
+}
+//#endregion
+//#region src/types.ts
+/** Which pile a garment belongs to on colour grounds. `any` mixes with all. */
+const colourGroups = [
+	"white",
+	"colour",
+	"dark",
+	"sport",
+	"any"
+];
+/**
+* Reasons two piles might not belong together even when the machine settings
+* agree. See `canMix` in `mixing.ts` for how each one is applied.
+*/
+const mixTags = [
+	"lint-shedder",
+	"lint-magnet",
+	"dye-bleeder",
+	"solo"
+];
+/**
+* How long a card or a load is going to tie the machine up.
+*
+* Usually one figure. Piles sharing a load agree on every setting, so they
+* ought to agree on this too — but the chart is data somebody types, and
+* printing both is more honest than picking the first one and hoping.
+*/
+function durationsOf(group) {
+	return [...new Set(group.map((item) => item.duration).filter((value) => value !== ""))].join(" / ");
+}
+/**
+* Which sheet to draw.
+*
+* `full` is the whole chart. The other two are the same chart cut where the
+* work is: washing happens in front of the machine on a Sunday morning, ironing
+* happens at a board on a Wednesday evening, and neither job wants to read past
+* the other's advice to find its own.
+*/
+const variants = [
+	"full",
+	"wash",
+	"iron"
+];
+//#endregion
+//#region src/rows.ts
+const COLUMNS = [
+	"clothing_type",
+	"detergent",
+	"fabric_softener",
+	"temperature",
+	"spin",
+	"duration",
+	"program",
+	"options",
+	"ironing",
+	"ironing_notes",
+	"iron_setting",
+	"drying",
+	"colour_group",
+	"mix_tags",
+	"notes"
+];
+var RowError = class extends Error {
+	constructor(row, column, message) {
+		super(`row ${row}, column "${column}": ${message}`);
+		this.name = "RowError";
+	}
+};
+/** `a|b|c` -> `["a", "b", "c"]`, tolerating stray whitespace and empties. */
+function splitList(value) {
+	return value.split("|").map((part) => part.trim()).filter((part) => part.length > 0);
+}
+function oneOf(row, column, value, allowed) {
+	if (!allowed.includes(value)) throw new RowError(row, column, `"${value}" is not one of ${allowed.join(", ")}`);
+	return value;
+}
+function boolean(row, column, value) {
+	const normalised = value.trim().toLowerCase();
+	if ([
+		"yes",
+		"y",
+		"true",
+		"1"
+	].includes(normalised)) return true;
+	if ([
+		"no",
+		"n",
+		"false",
+		"0"
+	].includes(normalised)) return false;
+	throw new RowError(row, column, `"${value}" is not a yes/no value`);
+}
+/**
+* Checks rows shaped like the chart's schema — the same shape a CSV parses
+* into, or a JSON file round-tripped through `rowsFromInstructions` — against
+* what the appliances in the machine file can actually be set to. A typo in a
+* programme name fails here rather than producing a PDF that tells you to turn
+* the dial to a position that does not exist — and so does a chart written for
+* a different machine than the one you passed.
+*/
+function instructionsFromRows(rows, machine) {
+	const { washer } = machine;
+	if (rows.length === 0) throw new Error("the chart has no rows");
+	const header = Object.keys(rows[0]);
+	const missing = COLUMNS.filter((column) => !header.includes(column));
+	if (missing.length > 0) throw new Error(`the chart is missing column(s): ${missing.join(", ")}`);
+	return rows.map((record, index) => {
+		const row = index + 2;
+		const clothingType = (record.clothing_type ?? "").trim();
+		if (clothingType === "") throw new RowError(row, "clothing_type", "must not be empty");
+		const options = splitList(record.options ?? "").map((option) => oneOf(row, "options", option, washer.options));
+		const tags = splitList(record.mix_tags ?? "").map((tag) => oneOf(row, "mix_tags", tag, mixTags));
+		const ironing = boolean(row, "ironing", record.ironing ?? "");
+		const rawSetting = (record.iron_setting ?? "").trim();
+		if (!ironing && rawSetting !== "") throw new RowError(row, "iron_setting", `must be empty when ironing is no, found "${rawSetting}"`);
+		const ironSetting = ironing ? oneOf(row, "iron_setting", rawSetting, ironSettingKeys(machine)) : "";
+		return {
+			clothingType,
+			detergent: record.detergent ?? "",
+			fabricSoftener: boolean(row, "fabric_softener", record.fabric_softener ?? ""),
+			temperature: oneOf(row, "temperature", record.temperature ?? "", washer.temperatures),
+			spin: oneOf(row, "spin", record.spin ?? "", washer.spins),
+			duration: record.duration ?? "",
+			program: oneOf(row, "program", record.program ?? "", washer.programs),
+			options,
+			ironing,
+			ironingNotes: record.ironing_notes ?? "",
+			ironSetting,
+			drying: record.drying ?? "",
+			colourGroup: oneOf(row, "colour_group", record.colour_group ?? "", colourGroups),
+			mixTags: tags,
+			notes: record.notes ?? ""
+		};
+	});
+}
+/** The reverse of `instructionsFromRows` — what a JSON export writes out. */
+function rowsFromInstructions(instructions) {
+	return instructions.map((instruction) => ({
+		clothing_type: instruction.clothingType,
+		detergent: instruction.detergent,
+		fabric_softener: instruction.fabricSoftener ? "yes" : "no",
+		temperature: instruction.temperature,
+		spin: instruction.spin,
+		duration: instruction.duration,
+		program: instruction.program,
+		options: instruction.options.join("|"),
+		ironing: instruction.ironing ? "yes" : "no",
+		ironing_notes: instruction.ironingNotes,
+		iron_setting: instruction.ironSetting,
+		drying: instruction.drying,
+		colour_group: instruction.colourGroup,
+		mix_tags: instruction.mixTags.join("|"),
+		notes: instruction.notes
+	}));
+}
+/**
+* The JSON interchange format for a chart — the same row shape
+* a chart's JSON Schema describes, so a file written here validates against
+* it exactly as a CSV does.
+*/
+function chartToJson(instructions) {
+	return `${JSON.stringify(rowsFromInstructions(instructions), null, 2)}\n`;
+}
+/** The other half of `chartToJson`. Throws the same errors `parseInstructions` does. */
+function chartFromJson(source, machine) {
+	let rows;
+	try {
+		rows = JSON.parse(source);
+	} catch (error) {
+		throw new Error(`not valid JSON: ${error instanceof Error ? error.message : error}`);
+	}
+	if (!Array.isArray(rows)) throw new Error("the chart must be a JSON array of rows");
+	return instructionsFromRows(rows, machine);
+}
+//#endregion
+//#region src/mixing.ts
+const blockerLegend = {
+	solo: "Wash on its own",
+	settings: "Different programme, temperature, spin or options",
+	colour: "Colours would run into each other",
+	lint: "One sheds lint onto the other"
+};
+/** Short codes used in the compatibility matrix, so a cell stays one glyph. */
+const blockerCode = {
+	solo: "S",
+	settings: "P",
+	colour: "C",
+	lint: "L"
+};
+function sameSettings(a, b) {
+	return a.program === b.program && a.temperature === b.temperature && a.spin === b.spin && a.options.length === b.options.length && a.options.every((option) => b.options.includes(option));
+}
+function compatibleColours(a, b) {
+	if (a.colourGroup === "any" || b.colourGroup === "any") return true;
+	return a.colourGroup === b.colourGroup;
+}
+/**
+* Decides whether two piles can go in the drum together, and if not, why.
+*
+* The order matters: the reason reported is the one you would want to hear
+* first. "Wash it alone" beats "the spin speed differs", because changing the
+* spin speed would not help.
+*/
+function mixBlocker(a, b) {
+	if (a.mixTags.includes("solo") || b.mixTags.includes("solo")) return "solo";
+	if ([a, b].filter((item) => item.mixTags.includes("lint-shedder")).length === 1) return "lint";
+	if (!compatibleColours(a, b)) return "colour";
+	if (!sameSettings(a, b)) return "settings";
+	return null;
+}
+function canMix(a, b) {
+	return mixBlocker(a, b) === null;
+}
+/** Annotates each instruction with the other piles it may share a load with. */
+function resolve(instructions) {
+	return instructions.map((instruction) => ({
+		...instruction,
+		mixesWith: instructions.filter((other) => other !== instruction && canMix(instruction, other)).map((other) => other.clothingType)
+	}));
+}
+/**
+* Groups piles that can all be washed together — every member compatible with
+* every other, not merely with the first one it met.
+*/
+function loadGroups(instructions) {
+	const groups = [];
+	for (const instruction of instructions) {
+		const home = groups.find((group) => group.every((member) => canMix(member, instruction)));
+		if (home) home.push(instruction);
+		else groups.push([instruction]);
+	}
+	return groups;
+}
+function groupBy(items, key) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const existing = groups.get(key(item));
+		if (existing) existing.push(item);
+		else groups.set(key(item), [item]);
+	}
+	return [...groups.values()];
+}
+/**
+* Everything you physically set on the washing machine: the programme, what
+* the display reads, which buttons are lit, and whether softener goes in.
+*
+* Deliberately *not* the prose. Two piles can want the same five settings and
+* still want different detergent or a different drying rack, and those the card
+* lists per pile rather than splitting into two near-identical cards.
+*/
+function washFingerprint(item) {
+	return JSON.stringify([
+		item.program,
+		item.temperature,
+		item.spin,
+		[...item.options].sort(),
+		item.fabricSoftener
+	]);
+}
+/**
+* Piles you set the machine and the iron up for identically. Every dial
+* drawing on their cards would be the same drawing, so they get one card
+* listing all the names.
+*/
+function cardGroups(instructions) {
+	return groupBy(instructions, (item) => JSON.stringify([
+		washFingerprint(item),
+		item.ironing,
+		item.ironSetting
+	]));
+}
+/**
+* The same, for a sheet with no iron on it. Dark, Black Socks and Denim each
+* need their own card on the full chart only because they want three different
+* thermostat positions; standing at the machine they are one wash.
+*/
+function washGroups(instructions) {
+	return groupBy(instructions, washFingerprint);
+}
+/**
+* Piles by where the iron's thermostat points, coolest first.
+*
+* An ironing sheet is read the other way round from a washing one. You do not
+* fetch a pile and look up its setting — you set the iron once and work through
+* everything that goes at that heat, so the thermostat position is the heading
+* and the piles are the list under it. `order` is `ironSettingKeys`; a pile you
+* never iron has no position in it and sorts last, which is right — it is the
+* pile you never pick up.
+*/
+function ironGroups(instructions, order) {
+	const rank = (setting) => {
+		const at = order.indexOf(setting);
+		return at < 0 ? order.length : at;
+	};
+	return groupBy(instructions, (item) => item.ironSetting).sort((a, b) => rank(a[0].ironSetting) - rank(b[0].ironSetting));
+}
+//#endregion
+export { parseMachine as C, ironSettingKeys as S, durationsOf as _, ironGroups as a, formatTemperature as b, resolve as c, RowError as d, chartFromJson as f, colourGroups as g, rowsFromInstructions as h, cardGroups as i, washGroups as l, instructionsFromRows as m, blockerLegend as n, loadGroups as o, chartToJson as p, canMix as r, mixBlocker as s, blockerCode as t, COLUMNS as u, mixTags as v, ironSetting as x, variants as y };
+
+//# sourceMappingURL=mixing-CazkIyLl.mjs.map

package/dist/mixing-CazkIyLl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixing-CazkIyLl.mjs","names":[],"sources":["../src/machine.ts","../src/types.ts","../src/rows.ts","../src/mixing.ts"],"sourcesContent":["/**\n * The appliances a chart is drawn for, as data rather than code.\n *\n * Everything the PDFs render — dial angles, which chips exist, what a valid CSV\n * value is — comes from a machine file, so pointing this at a different washing\n * machine is editing JSON rather than editing TypeScript. The labels in that\n * file are copied off the fascia in whatever language it is printed in, and\n * nothing here ever translates them: a chart that says \"Cottons\" when the dial\n * says \"Katoen\" is worse than no chart, because you have to translate it back\n * while standing in front of the machine.\n */\n\nexport interface Washer {\n  name: string;\n  capacity: string;\n  /** Dial labels in physical order from twelve o'clock, clockwise. Index is the angle. */\n  programs: string[];\n  temperatures: string[];\n  spins: string[];\n  options: string[];\n}\n\nexport interface IronSetting {\n  key: string;\n  dots: string;\n  label: string;\n  detail: string;\n  steam: boolean;\n}\n\nexport interface Iron {\n  name: string;\n  /** Thermostat positions in order, coolest first. */\n  settings: IronSetting[];\n}\n\nexport interface Machine {\n  washer: Washer;\n  iron: Iron;\n}\n\nfunction fail(what: string): never {\n  throw new Error(`machine: ${what}`);\n}\n\nfunction stringList(value: unknown, field: string, minimum: number): string[] {\n  if (!Array.isArray(value) || value.some((entry) => typeof entry !== \"string\" || entry === \"\")) {\n    fail(`${field} must be a list of non-empty strings`);\n  }\n  const list = value as string[];\n  if (list.length < minimum)\n    fail(`${field} needs at least ${minimum} entries, found ${list.length}`);\n  if (new Set(list).size !== list.length) fail(`${field} repeats a value`);\n  return list;\n}\n\nfunction text(value: unknown, field: string, fallback?: string): string {\n  if (typeof value === \"string\" && value !== \"\") return value;\n  if (fallback !== undefined) return fallback;\n  return fail(`${field} must be a non-empty string`);\n}\n\nfunction parseIronSetting(value: unknown, index: number): IronSetting {\n  if (typeof value !== \"object\" || value === null)\n    fail(`iron.settings[${index}] must be an object`);\n  const raw = value as Record<string, unknown>;\n  const key = text(raw.key, `iron.settings[${index}].key`);\n  return {\n    key,\n    dots: typeof raw.dots === \"string\" ? raw.dots : \"\",\n    label: text(raw.label, `iron.settings[${index}].label`),\n    detail: text(raw.detail, `iron.settings[${index}].detail`, \"\"),\n    steam: raw.steam === true,\n  };\n}\n\n/**\n * Checks a parsed machine file and hands back something the renderer can use.\n * Every failure names the field, because the fix is always an edit to that\n * line of JSON.\n */\nexport function parseMachine(value: unknown): Machine {\n  if (typeof value !== \"object\" || value === null) fail(\"the file must contain an object\");\n  const raw = value as Record<string, unknown>;\n\n  if (typeof raw.washer !== \"object\" || raw.washer === null) fail(\"washer is missing\");\n  if (typeof raw.iron !== \"object\" || raw.iron === null) fail(\"iron is missing\");\n\n  const washerRaw = raw.washer as Record<string, unknown>;\n  const ironRaw = raw.iron as Record<string, unknown>;\n\n  const settings = Array.isArray(ironRaw.settings)\n    ? ironRaw.settings\n    : fail(\"iron.settings is missing\");\n  if (settings.length < 2) fail(\"iron.settings needs at least 2 positions to draw a ring\");\n\n  const keys = settings.map((setting, index) => parseIronSetting(setting, index));\n  if (new Set(keys.map((setting) => setting.key)).size !== keys.length) {\n    fail(\"iron.settings repeats a key\");\n  }\n\n  return {\n    washer: {\n      name: text(washerRaw.name, \"washer.name\"),\n      capacity: text(washerRaw.capacity, \"washer.capacity\", \"\"),\n      programs: stringList(washerRaw.programs, \"washer.programs\", 2),\n      temperatures: stringList(washerRaw.temperatures, \"washer.temperatures\", 1),\n      spins: stringList(washerRaw.spins, \"washer.spins\", 1),\n      options: stringList(washerRaw.options ?? [], \"washer.options\", 0),\n    },\n    iron: {\n      name: text(ironRaw.name, \"iron.name\"),\n      settings: keys,\n    },\n  };\n}\n\nexport function ironSetting(machine: Machine, key: string): IronSetting | undefined {\n  return machine.iron.settings.find((setting) => setting.key === key);\n}\n\n/**\n * The keys a row may write in `iron_setting`, coolest first.\n *\n * There is no key for \"do not iron\". That is the `ironing` column's job, and\n * two places to say the same thing is two places to disagree.\n */\nexport function ironSettingKeys(machine: Machine): string[] {\n  return machine.iron.settings.map((setting) => setting.key);\n}\n\n/**\n * `40` becomes `40°`; `cold` stays `cold`. The machine file is free to use\n * whatever word its display shows for the cold wash, so the degree sign is\n * decided by whether the value is a number rather than by a list of exceptions.\n */\nexport function formatTemperature(value: string): string {\n  return /^\\d+$/.test(value) ? `${value}°` : value;\n}\n","/** Which pile a garment belongs to on colour grounds. `any` mixes with all. */\nexport const colourGroups = [\"white\", \"colour\", \"dark\", \"sport\", \"any\"] as const;\nexport type ColourGroup = (typeof colourGroups)[number];\n\n/**\n * Reasons two piles might not belong together even when the machine settings\n * agree. See `canMix` in `mixing.ts` for how each one is applied.\n */\nexport const mixTags = [\"lint-shedder\", \"lint-magnet\", \"dye-bleeder\", \"solo\"] as const;\nexport type MixTag = (typeof mixTags)[number];\n\n/**\n * One CSV row: everything needed to wash, iron and dry one pile of laundry.\n *\n * The machine-facing fields are plain strings rather than unions, because what\n * counts as valid depends on the machine file you point this at. `csv.ts`\n * checks each of them against that machine as it parses, so nothing downstream\n * has to wonder whether a programme name exists.\n */\nexport interface Instruction {\n  clothingType: string;\n  detergent: string;\n  fabricSoftener: boolean;\n  temperature: string;\n  spin: string;\n  duration: string;\n  program: string;\n  options: string[];\n  /** Whether this pile gets ironed at all. */\n  ironing: boolean;\n  /**\n   * How to iron it, or why you don't. Free prose and often empty, because most\n   * of what there is to say about a pile nobody irons is already said by\n   * `ironing` being false.\n   */\n  ironingNotes: string;\n  /** Thermostat position. Empty when `ironing` is false. */\n  ironSetting: string;\n  drying: string;\n  colourGroup: ColourGroup;\n  mixTags: MixTag[];\n  notes: string;\n}\n\n/** An instruction plus the other piles it may share a drum with. */\nexport interface ResolvedInstruction extends Instruction {\n  mixesWith: string[];\n}\n\n/**\n * How long a card or a load is going to tie the machine up.\n *\n * Usually one figure. Piles sharing a load agree on every setting, so they\n * ought to agree on this too — but the chart is data somebody types, and\n * printing both is more honest than picking the first one and hoping.\n */\nexport function durationsOf(group: Instruction[]): string {\n  return [...new Set(group.map((item) => item.duration).filter((value) => value !== \"\"))].join(\n    \" / \",\n  );\n}\n\n/**\n * Which sheet to draw.\n *\n * `full` is the whole chart. The other two are the same chart cut where the\n * work is: washing happens in front of the machine on a Sunday morning, ironing\n * happens at a board on a Wednesday evening, and neither job wants to read past\n * the other's advice to find its own.\n */\nexport const variants = [\"full\", \"wash\", \"iron\"] as const;\nexport type Variant = (typeof variants)[number];\n","import { ironSettingKeys, type Machine } from \"./machine\";\nimport type { ColourGroup, Instruction, MixTag } from \"./types\";\nimport { colourGroups, mixTags } from \"./types\";\n\nexport const COLUMNS = [\n  \"clothing_type\",\n  \"detergent\",\n  \"fabric_softener\",\n  \"temperature\",\n  \"spin\",\n  \"duration\",\n  \"program\",\n  \"options\",\n  \"ironing\",\n  \"ironing_notes\",\n  \"iron_setting\",\n  \"drying\",\n  \"colour_group\",\n  \"mix_tags\",\n  \"notes\",\n] as const;\n\n/** One row, keyed the same way as a CSV column and the chart's JSON Schema. */\nexport type Row = Record<(typeof COLUMNS)[number], string>;\n\nexport class RowError extends Error {\n  constructor(row: number, column: string, message: string) {\n    super(`row ${row}, column \"${column}\": ${message}`);\n    this.name = \"RowError\";\n  }\n}\n\n/** `a|b|c` -> `[\"a\", \"b\", \"c\"]`, tolerating stray whitespace and empties. */\nfunction splitList(value: string): string[] {\n  return value\n    .split(\"|\")\n    .map((part) => part.trim())\n    .filter((part) => part.length > 0);\n}\n\nfunction oneOf<T extends string>(\n  row: number,\n  column: string,\n  value: string,\n  allowed: readonly T[],\n): T {\n  if (!(allowed as readonly string[]).includes(value)) {\n    throw new RowError(row, column, `\"${value}\" is not one of ${allowed.join(\", \")}`);\n  }\n  return value as T;\n}\n\nfunction boolean(row: number, column: string, value: string): boolean {\n  const normalised = value.trim().toLowerCase();\n  if ([\"yes\", \"y\", \"true\", \"1\"].includes(normalised)) return true;\n  if ([\"no\", \"n\", \"false\", \"0\"].includes(normalised)) return false;\n  throw new RowError(row, column, `\"${value}\" is not a yes/no value`);\n}\n\n/**\n * Checks rows shaped like the chart's schema — the same shape a CSV parses\n * into, or a JSON file round-tripped through `rowsFromInstructions` — against\n * what the appliances in the machine file can actually be set to. A typo in a\n * programme name fails here rather than producing a PDF that tells you to turn\n * the dial to a position that does not exist — and so does a chart written for\n * a different machine than the one you passed.\n */\nexport function instructionsFromRows(\n  rows: Record<string, string>[],\n  machine: Machine,\n): Instruction[] {\n  const { washer } = machine;\n\n  if (rows.length === 0) throw new Error(\"the chart has no rows\");\n\n  const header = Object.keys(rows[0] as Record<string, string>);\n  const missing = COLUMNS.filter((column) => !header.includes(column));\n  if (missing.length > 0) {\n    throw new Error(`the chart is missing column(s): ${missing.join(\", \")}`);\n  }\n\n  return rows.map((record, index) => {\n    // +2: one for the header row, one because humans count from 1. Kept even\n    // for a JSON source, so an error message reads the same regardless of\n    // which format the chart came from.\n    const row = index + 2;\n\n    const clothingType = (record.clothing_type ?? \"\").trim();\n    if (clothingType === \"\") throw new RowError(row, \"clothing_type\", \"must not be empty\");\n\n    const options = splitList(record.options ?? \"\").map((option) =>\n      oneOf(row, \"options\", option, washer.options),\n    );\n\n    const tags = splitList(record.mix_tags ?? \"\").map((tag) =>\n      oneOf<MixTag>(row, \"mix_tags\", tag, mixTags),\n    );\n\n    // `ironing` decides whether there is a thermostat position at all, so the\n    // two are checked together: a pile you never iron has nowhere to point the\n    // dial, and a pile you do iron has to say where.\n    const ironing = boolean(row, \"ironing\", record.ironing ?? \"\");\n    const rawSetting = (record.iron_setting ?? \"\").trim();\n    if (!ironing && rawSetting !== \"\") {\n      throw new RowError(\n        row,\n        \"iron_setting\",\n        `must be empty when ironing is no, found \"${rawSetting}\"`,\n      );\n    }\n    const ironSetting = ironing\n      ? oneOf(row, \"iron_setting\", rawSetting, ironSettingKeys(machine))\n      : \"\";\n\n    return {\n      clothingType,\n      detergent: record.detergent ?? \"\",\n      fabricSoftener: boolean(row, \"fabric_softener\", record.fabric_softener ?? \"\"),\n      temperature: oneOf(row, \"temperature\", record.temperature ?? \"\", washer.temperatures),\n      spin: oneOf(row, \"spin\", record.spin ?? \"\", washer.spins),\n      duration: record.duration ?? \"\",\n      program: oneOf(row, \"program\", record.program ?? \"\", washer.programs),\n      options,\n      ironing,\n      ironingNotes: record.ironing_notes ?? \"\",\n      ironSetting,\n      drying: record.drying ?? \"\",\n      colourGroup: oneOf<ColourGroup>(row, \"colour_group\", record.colour_group ?? \"\", colourGroups),\n      mixTags: tags,\n      notes: record.notes ?? \"\",\n    };\n  });\n}\n\n/** The reverse of `instructionsFromRows` — what a JSON export writes out. */\nexport function rowsFromInstructions(instructions: Instruction[]): Row[] {\n  return instructions.map((instruction) => ({\n    clothing_type: instruction.clothingType,\n    detergent: instruction.detergent,\n    fabric_softener: instruction.fabricSoftener ? \"yes\" : \"no\",\n    temperature: instruction.temperature,\n    spin: instruction.spin,\n    duration: instruction.duration,\n    program: instruction.program,\n    options: instruction.options.join(\"|\"),\n    ironing: instruction.ironing ? \"yes\" : \"no\",\n    ironing_notes: instruction.ironingNotes,\n    iron_setting: instruction.ironSetting,\n    drying: instruction.drying,\n    colour_group: instruction.colourGroup,\n    mix_tags: instruction.mixTags.join(\"|\"),\n    notes: instruction.notes,\n  }));\n}\n\n/**\n * The JSON interchange format for a chart — the same row shape\n * a chart's JSON Schema describes, so a file written here validates against\n * it exactly as a CSV does.\n */\nexport function chartToJson(instructions: Instruction[]): string {\n  return `${JSON.stringify(rowsFromInstructions(instructions), null, 2)}\\n`;\n}\n\n/** The other half of `chartToJson`. Throws the same errors `parseInstructions` does. */\nexport function chartFromJson(source: string, machine: Machine): Instruction[] {\n  let rows: unknown;\n  try {\n    rows = JSON.parse(source);\n  } catch (error) {\n    throw new Error(`not valid JSON: ${error instanceof Error ? error.message : error}`);\n  }\n  if (!Array.isArray(rows)) throw new Error(\"the chart must be a JSON array of rows\");\n  return instructionsFromRows(rows as Record<string, string>[], machine);\n}\n","import type { Instruction, ResolvedInstruction } from \"./types\";\n\n/** Why two piles cannot share a drum. `null` means they can. */\nexport type Blocker = \"solo\" | \"settings\" | \"colour\" | \"lint\";\n\nexport const blockerLegend: Record<Blocker, string> = {\n  solo: \"Wash on its own\",\n  settings: \"Different programme, temperature, spin or options\",\n  colour: \"Colours would run into each other\",\n  lint: \"One sheds lint onto the other\",\n};\n\n/** Short codes used in the compatibility matrix, so a cell stays one glyph. */\nexport const blockerCode: Record<Blocker, string> = {\n  solo: \"S\",\n  settings: \"P\",\n  colour: \"C\",\n  lint: \"L\",\n};\n\nfunction sameSettings(a: Instruction, b: Instruction): boolean {\n  return (\n    a.program === b.program &&\n    a.temperature === b.temperature &&\n    a.spin === b.spin &&\n    a.options.length === b.options.length &&\n    a.options.every((option) => b.options.includes(option))\n  );\n}\n\nfunction compatibleColours(a: Instruction, b: Instruction): boolean {\n  if (a.colourGroup === \"any\" || b.colourGroup === \"any\") return true;\n  return a.colourGroup === b.colourGroup;\n}\n\n/**\n * Decides whether two piles can go in the drum together, and if not, why.\n *\n * The order matters: the reason reported is the one you would want to hear\n * first. \"Wash it alone\" beats \"the spin speed differs\", because changing the\n * spin speed would not help.\n */\nexport function mixBlocker(a: Instruction, b: Instruction): Blocker | null {\n  if (a.mixTags.includes(\"solo\") || b.mixTags.includes(\"solo\")) return \"solo\";\n\n  // Terry sheds lint over everything, so towels only ever go with towels.\n  const shedders = [a, b].filter((item) => item.mixTags.includes(\"lint-shedder\"));\n  if (shedders.length === 1) return \"lint\";\n\n  if (!compatibleColours(a, b)) return \"colour\";\n  if (!sameSettings(a, b)) return \"settings\";\n  return null;\n}\n\nexport function canMix(a: Instruction, b: Instruction): boolean {\n  return mixBlocker(a, b) === null;\n}\n\n/** Annotates each instruction with the other piles it may share a load with. */\nexport function resolve(instructions: Instruction[]): ResolvedInstruction[] {\n  return instructions.map((instruction) => ({\n    ...instruction,\n    mixesWith: instructions\n      .filter((other) => other !== instruction && canMix(instruction, other))\n      .map((other) => other.clothingType),\n  }));\n}\n\n/**\n * Groups piles that can all be washed together — every member compatible with\n * every other, not merely with the first one it met.\n */\nexport function loadGroups<T extends Instruction>(instructions: T[]): T[][] {\n  const groups: T[][] = [];\n  for (const instruction of instructions) {\n    const home = groups.find((group) => group.every((member) => canMix(member, instruction)));\n    if (home) home.push(instruction);\n    else groups.push([instruction]);\n  }\n  return groups;\n}\n\nfunction groupBy<T>(items: T[], key: (item: T) => string): T[][] {\n  const groups = new Map<string, T[]>();\n  for (const item of items) {\n    const existing = groups.get(key(item));\n    if (existing) existing.push(item);\n    else groups.set(key(item), [item]);\n  }\n  return [...groups.values()];\n}\n\n/**\n * Everything you physically set on the washing machine: the programme, what\n * the display reads, which buttons are lit, and whether softener goes in.\n *\n * Deliberately *not* the prose. Two piles can want the same five settings and\n * still want different detergent or a different drying rack, and those the card\n * lists per pile rather than splitting into two near-identical cards.\n */\nfunction washFingerprint(item: Instruction): string {\n  return JSON.stringify([\n    item.program,\n    item.temperature,\n    item.spin,\n    [...item.options].sort(),\n    item.fabricSoftener,\n  ]);\n}\n\n/**\n * Piles you set the machine and the iron up for identically. Every dial\n * drawing on their cards would be the same drawing, so they get one card\n * listing all the names.\n */\nexport function cardGroups<T extends Instruction>(instructions: T[]): T[][] {\n  return groupBy(instructions, (item) =>\n    JSON.stringify([washFingerprint(item), item.ironing, item.ironSetting]),\n  );\n}\n\n/**\n * The same, for a sheet with no iron on it. Dark, Black Socks and Denim each\n * need their own card on the full chart only because they want three different\n * thermostat positions; standing at the machine they are one wash.\n */\nexport function washGroups<T extends Instruction>(instructions: T[]): T[][] {\n  return groupBy(instructions, washFingerprint);\n}\n\n/**\n * Piles by where the iron's thermostat points, coolest first.\n *\n * An ironing sheet is read the other way round from a washing one. You do not\n * fetch a pile and look up its setting — you set the iron once and work through\n * everything that goes at that heat, so the thermostat position is the heading\n * and the piles are the list under it. `order` is `ironSettingKeys`; a pile you\n * never iron has no position in it and sorts last, which is right — it is the\n * pile you never pick up.\n */\nexport function ironGroups<T extends Instruction>(\n  instructions: T[],\n  order: readonly string[],\n): T[][] {\n  const rank = (setting: string) => {\n    const at = order.indexOf(setting);\n    return at < 0 ? order.length : at;\n  };\n  return groupBy(instructions, (item) => item.ironSetting).sort(\n    (a, b) => rank((a[0] as T).ironSetting) - rank((b[0] as T).ironSetting),\n  );\n}\n"],"mappings":"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"}

package/dist/rows-lRFNdyJh.d.mts

@@ -0,0 +1,198 @@
+//#region src/machine.d.ts
+/**
+ * The appliances a chart is drawn for, as data rather than code.
+ *
+ * Everything the PDFs render — dial angles, which chips exist, what a valid CSV
+ * value is — comes from a machine file, so pointing this at a different washing
+ * machine is editing JSON rather than editing TypeScript. The labels in that
+ * file are copied off the fascia in whatever language it is printed in, and
+ * nothing here ever translates them: a chart that says "Cottons" when the dial
+ * says "Katoen" is worse than no chart, because you have to translate it back
+ * while standing in front of the machine.
+ */
+interface Washer {
+  name: string;
+  capacity: string;
+  /** Dial labels in physical order from twelve o'clock, clockwise. Index is the angle. */
+  programs: string[];
+  temperatures: string[];
+  spins: string[];
+  options: string[];
+}
+interface IronSetting {
+  key: string;
+  dots: string;
+  label: string;
+  detail: string;
+  steam: boolean;
+}
+interface Iron {
+  name: string;
+  /** Thermostat positions in order, coolest first. */
+  settings: IronSetting[];
+}
+interface Machine {
+  washer: Washer;
+  iron: Iron;
+}
+/**
+ * Checks a parsed machine file and hands back something the renderer can use.
+ * Every failure names the field, because the fix is always an edit to that
+ * line of JSON.
+ */
+declare function parseMachine(value: unknown): Machine;
+declare function ironSetting(machine: Machine, key: string): IronSetting | undefined;
+/**
+ * The keys a row may write in `iron_setting`, coolest first.
+ *
+ * There is no key for "do not iron". That is the `ironing` column's job, and
+ * two places to say the same thing is two places to disagree.
+ */
+declare function ironSettingKeys(machine: Machine): string[];
+/**
+ * `40` becomes `40°`; `cold` stays `cold`. The machine file is free to use
+ * whatever word its display shows for the cold wash, so the degree sign is
+ * decided by whether the value is a number rather than by a list of exceptions.
+ */
+declare function formatTemperature(value: string): string;
+//#endregion
+//#region src/types.d.ts
+/** Which pile a garment belongs to on colour grounds. `any` mixes with all. */
+declare const colourGroups: readonly ["white", "colour", "dark", "sport", "any"];
+type ColourGroup = (typeof colourGroups)[number];
+/**
+ * Reasons two piles might not belong together even when the machine settings
+ * agree. See `canMix` in `mixing.ts` for how each one is applied.
+ */
+declare const mixTags: readonly ["lint-shedder", "lint-magnet", "dye-bleeder", "solo"];
+type MixTag = (typeof mixTags)[number];
+/**
+ * One CSV row: everything needed to wash, iron and dry one pile of laundry.
+ *
+ * The machine-facing fields are plain strings rather than unions, because what
+ * counts as valid depends on the machine file you point this at. `csv.ts`
+ * checks each of them against that machine as it parses, so nothing downstream
+ * has to wonder whether a programme name exists.
+ */
+interface Instruction {
+  clothingType: string;
+  detergent: string;
+  fabricSoftener: boolean;
+  temperature: string;
+  spin: string;
+  duration: string;
+  program: string;
+  options: string[];
+  /** Whether this pile gets ironed at all. */
+  ironing: boolean;
+  /**
+   * How to iron it, or why you don't. Free prose and often empty, because most
+   * of what there is to say about a pile nobody irons is already said by
+   * `ironing` being false.
+   */
+  ironingNotes: string;
+  /** Thermostat position. Empty when `ironing` is false. */
+  ironSetting: string;
+  drying: string;
+  colourGroup: ColourGroup;
+  mixTags: MixTag[];
+  notes: string;
+}
+/** An instruction plus the other piles it may share a drum with. */
+interface ResolvedInstruction extends Instruction {
+  mixesWith: string[];
+}
+/**
+ * How long a card or a load is going to tie the machine up.
+ *
+ * Usually one figure. Piles sharing a load agree on every setting, so they
+ * ought to agree on this too — but the chart is data somebody types, and
+ * printing both is more honest than picking the first one and hoping.
+ */
+declare function durationsOf(group: Instruction[]): string;
+/**
+ * Which sheet to draw.
+ *
+ * `full` is the whole chart. The other two are the same chart cut where the
+ * work is: washing happens in front of the machine on a Sunday morning, ironing
+ * happens at a board on a Wednesday evening, and neither job wants to read past
+ * the other's advice to find its own.
+ */
+declare const variants: readonly ["full", "wash", "iron"];
+type Variant = (typeof variants)[number];
+//#endregion
+//#region src/mixing.d.ts
+/** Why two piles cannot share a drum. `null` means they can. */
+type Blocker = "solo" | "settings" | "colour" | "lint";
+declare const blockerLegend: Record<Blocker, string>;
+/** Short codes used in the compatibility matrix, so a cell stays one glyph. */
+declare const blockerCode: Record<Blocker, string>;
+/**
+ * Decides whether two piles can go in the drum together, and if not, why.
+ *
+ * The order matters: the reason reported is the one you would want to hear
+ * first. "Wash it alone" beats "the spin speed differs", because changing the
+ * spin speed would not help.
+ */
+declare function mixBlocker(a: Instruction, b: Instruction): Blocker | null;
+declare function canMix(a: Instruction, b: Instruction): boolean;
+/** Annotates each instruction with the other piles it may share a load with. */
+declare function resolve(instructions: Instruction[]): ResolvedInstruction[];
+/**
+ * Groups piles that can all be washed together — every member compatible with
+ * every other, not merely with the first one it met.
+ */
+declare function loadGroups<T extends Instruction>(instructions: T[]): T[][];
+/**
+ * Piles you set the machine and the iron up for identically. Every dial
+ * drawing on their cards would be the same drawing, so they get one card
+ * listing all the names.
+ */
+declare function cardGroups<T extends Instruction>(instructions: T[]): T[][];
+/**
+ * The same, for a sheet with no iron on it. Dark, Black Socks and Denim each
+ * need their own card on the full chart only because they want three different
+ * thermostat positions; standing at the machine they are one wash.
+ */
+declare function washGroups<T extends Instruction>(instructions: T[]): T[][];
+/**
+ * Piles by where the iron's thermostat points, coolest first.
+ *
+ * An ironing sheet is read the other way round from a washing one. You do not
+ * fetch a pile and look up its setting — you set the iron once and work through
+ * everything that goes at that heat, so the thermostat position is the heading
+ * and the piles are the list under it. `order` is `ironSettingKeys`; a pile you
+ * never iron has no position in it and sorts last, which is right — it is the
+ * pile you never pick up.
+ */
+declare function ironGroups<T extends Instruction>(instructions: T[], order: readonly string[]): T[][];
+//#endregion
+//#region src/rows.d.ts
+declare const COLUMNS: readonly ["clothing_type", "detergent", "fabric_softener", "temperature", "spin", "duration", "program", "options", "ironing", "ironing_notes", "iron_setting", "drying", "colour_group", "mix_tags", "notes"];
+/** One row, keyed the same way as a CSV column and the chart's JSON Schema. */
+type Row = Record<(typeof COLUMNS)[number], string>;
+declare class RowError extends Error {
+  constructor(row: number, column: string, message: string);
+}
+/**
+ * Checks rows shaped like the chart's schema — the same shape a CSV parses
+ * into, or a JSON file round-tripped through `rowsFromInstructions` — against
+ * what the appliances in the machine file can actually be set to. A typo in a
+ * programme name fails here rather than producing a PDF that tells you to turn
+ * the dial to a position that does not exist — and so does a chart written for
+ * a different machine than the one you passed.
+ */
+declare function instructionsFromRows(rows: Record<string, string>[], machine: Machine): Instruction[];
+/** The reverse of `instructionsFromRows` — what a JSON export writes out. */
+declare function rowsFromInstructions(instructions: Instruction[]): Row[];
+/**
+ * The JSON interchange format for a chart — the same row shape
+ * a chart's JSON Schema describes, so a file written here validates against
+ * it exactly as a CSV does.
+ */
+declare function chartToJson(instructions: Instruction[]): string;
+/** The other half of `chartToJson`. Throws the same errors `parseInstructions` does. */
+declare function chartFromJson(source: string, machine: Machine): Instruction[];
+//#endregion
+export { Washer as A, colourGroups as C, Iron as D, variants as E, ironSetting as M, ironSettingKeys as N, IronSetting as O, parseMachine as P, Variant as S, mixTags as T, washGroups as _, chartToJson as a, MixTag as b, Blocker as c, canMix as d, cardGroups as f, resolve as g, mixBlocker as h, chartFromJson as i, formatTemperature as j, Machine as k, blockerCode as l, loadGroups as m, Row as n, instructionsFromRows as o, ironGroups as p, RowError as r, rowsFromInstructions as s, COLUMNS as t, blockerLegend as u, ColourGroup as v, durationsOf as w, ResolvedInstruction as x, Instruction as y };
+//# sourceMappingURL=rows-lRFNdyJh.d.mts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@washy-washy/core",
-  "version": "0.0.0",
+  "version": "1.0.0",
   "description": "Chart parsing, mixing rules and machine validation for washy-washy — a laundry chart generator.",
   "keywords": [
     "laundry",