@washy-washy/core 1.1.0 → 1.3.0

package/README.md

@@ -4,6 +4,7 @@
 [![npm](https://img.shields.io/npm/v/%40washy-washy%2Fcore)](https://www.npmjs.com/package/@washy-washy/core)
 [![Codecov](https://codecov.io/gh/alrayyes/washy-washy-core/graph/badge.svg)](https://codecov.io/gh/alrayyes/washy-washy-core)
 [![license](https://img.shields.io/github/license/alrayyes/washy-washy-core)](LICENSE)
+[![docs](https://img.shields.io/badge/docs-typedoc-blue)](https://alrayyes.github.io/washy-washy-core/)
 
 Chart parsing, machine validation, and mixing rules for
 [washy-washy](https://github.com/alrayyes/washy-washy-cli), a laundry chart
@@ -61,6 +62,10 @@ const instructions = chartFromJson(jsonFromStorage, machine);
 
 ### What's in it
 
+- Every chart row carries an optional `referenceName`/`referenceLink` pair —
+  who to credit for a care instruction that isn't obvious from the garment
+  itself ("the manufacturer says wash these alone"), and a link backing it
+  up. Both are empty strings when there's nothing to cite.
 - **`parseMachine`** validates a machine description (washer programmes,
   temperatures, spins, options; iron thermostat positions) and hands back a
   typed `Machine`. Every failure names the field that's wrong.
@@ -70,14 +75,23 @@ const instructions = chartFromJson(jsonFromStorage, machine);
 - **`parseConfig`**/**`configFromJson`**/**`configToJson`** do the same for a
   machine and a chart together, as one `{ machine, chart }` object — the
   chart is always validated against the machine it's embedded with.
+  `configToJson`'s output leads with a `$schema` key
+  ([`schema/config.schema.json`](schema/config.schema.json), generated from
+  the `Config` type, so it can't drift) — an editor that reads it, VS Code
+  among them, validates and autocompletes the file with no setup. The output
+  is plain `JSON.stringify(..., null, 2)` — if you write it straight to a
+  file in a Biome- or Prettier-linted repo, run your own formatter over it
+  afterward, since a generic serializer can't match either tool's opinions.
 - **`mixBlocker`**/**`canMix`**/**`resolve`** decide whether two piles of
   laundry can share a drum, and why not when they can't.
 - **`cardGroups`**/**`washGroups`**/**`ironGroups`** group instructions the
   way a printed chart is laid out: one card per identical setup, a wash-only
   cut, an iron-only cut ordered by thermostat position.
 
-Every exported function and type carries a TSDoc comment — the full API
-reference is your editor's hover, not a separate generated site.
+Every exported function and type carries a TSDoc comment with a runnable
+example — that's your editor's hover, and it's also the generated
+[API reference](https://alrayyes.github.io/washy-washy-core/).
+[`@washy-washy/pdf`](https://alrayyes.github.io/washy-washy-pdf/) has the same.
 
 ## Development
 

package/dist/browser.d.mts

@@ -1,2 +1,2 @@
-import { A as variants, C as Instruction, D as colourGroups, E as Variant, F as formatTemperature, I as ironSetting, L as ironSettingKeys, M as IronSetting, N as Machine, O as durationsOf, P as Washer, R as parseMachine, S as ColourGroup, T as ResolvedInstruction, _ as washGroups, a as chartToJson, b as configToJson, c as Blocker, d as canMix, f as cardGroups, g as resolve, h as mixBlocker, i as chartFromJson, j as Iron, k as mixTags, 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 Config, w as MixTag, x as parseConfig, y as configFromJson } from "./rows-C-0YQE-w.mjs";
-export { Blocker, COLUMNS, ColourGroup, Config, Instruction, Iron, IronSetting, Machine, MixTag, ResolvedInstruction, Row, RowError, Variant, Washer, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, configFromJson, configToJson, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseConfig, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
+import { A as mixTags, C as ColourGroup, D as Variant, E as ResolvedInstruction, F as Washer, I as formatTemperature, L as ironSetting, M as Iron, N as IronSetting, O as colourGroups, P as Machine, R as ironSettingKeys, S as parseConfig, T as MixTag, _ as washGroups, a as chartToJson, b as configFromJson, c as Blocker, d as canMix, f as cardGroups, g as resolve, h as mixBlocker, i as chartFromJson, j as variants, k as durationsOf, 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 CONFIG_SCHEMA_URL, w as Instruction, x as configToJson, y as Config, z as parseMachine } from "./rows-Bn1LlIaD.mjs";
+export { Blocker, COLUMNS, CONFIG_SCHEMA_URL, ColourGroup, Config, Instruction, Iron, IronSetting, Machine, MixTag, ResolvedInstruction, Row, RowError, Variant, Washer, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, configFromJson, configToJson, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseConfig, parseMachine, resolve, rowsFromInstructions, variants, washGroups };

package/dist/browser.mjs

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

package/dist/index.d.mts

@@ -1,7 +1,14 @@
-import { A as variants, C as Instruction, D as colourGroups, E as Variant, F as formatTemperature, I as ironSetting, L as ironSettingKeys, M as IronSetting, N as Machine, O as durationsOf, P as Washer, R as parseMachine, S as ColourGroup, T as ResolvedInstruction, _ as washGroups, a as chartToJson, b as configToJson, c as Blocker, d as canMix, f as cardGroups, g as resolve, h as mixBlocker, i as chartFromJson, j as Iron, k as mixTags, 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 Config, w as MixTag, x as parseConfig, y as configFromJson } from "./rows-C-0YQE-w.mjs";
+import { A as mixTags, C as ColourGroup, D as Variant, E as ResolvedInstruction, F as Washer, I as formatTemperature, L as ironSetting, M as Iron, N as IronSetting, O as colourGroups, P as Machine, R as ironSettingKeys, S as parseConfig, T as MixTag, _ as washGroups, a as chartToJson, b as configFromJson, c as Blocker, d as canMix, f as cardGroups, g as resolve, h as mixBlocker, i as chartFromJson, j as variants, k as durationsOf, 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 CONFIG_SCHEMA_URL, w as Instruction, x as configToJson, y as Config, z as parseMachine } from "./rows-Bn1LlIaD.mjs";
 //#region src/csv.d.ts
-/** Parses the instruction CSV. See `instructionsFromRows` for the row rules. */
+/**
+ * Parses the instruction CSV. See `instructionsFromRows` for the row rules.
+ *
+ * @example
+ * ```ts
+ * const instructions = parseInstructions(csvFileContents, machine);
+ * ```
+ */
 declare function parseInstructions(source: string, machine: Machine): Instruction[];
 //#endregion
-export { Blocker, COLUMNS, ColourGroup, Config, Instruction, Iron, IronSetting, Machine, MixTag, ResolvedInstruction, Row, RowError, Variant, Washer, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, configFromJson, configToJson, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseConfig, parseInstructions, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
+export { Blocker, COLUMNS, CONFIG_SCHEMA_URL, ColourGroup, Config, Instruction, Iron, IronSetting, Machine, MixTag, ResolvedInstruction, Row, RowError, Variant, Washer, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, configFromJson, configToJson, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseConfig, parseInstructions, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,7 +1,14 @@
-import { C as formatTemperature, E as parseMachine, S as variants, T as ironSettingKeys, _ as instructionsFromRows, a as ironGroups, b as durationsOf, c as resolve, d as configToJson, f as parseConfig, g as chartToJson, h as chartFromJson, i as cardGroups, l as washGroups, m as RowError, n as blockerLegend, o as loadGroups, p as COLUMNS, r as canMix, s as mixBlocker, t as blockerCode, u as configFromJson, v as rowsFromInstructions, w as ironSetting, x as mixTags, y as colourGroups } from "./mixing-DzbYAriI.mjs";
+import { C as variants, D as parseMachine, E as ironSettingKeys, S as mixTags, T as ironSetting, _ as chartToJson, a as ironGroups, b as colourGroups, c as resolve, d as configFromJson, f as configToJson, g as chartFromJson, h as RowError, i as cardGroups, l as washGroups, m as COLUMNS, n as blockerLegend, o as loadGroups, p as parseConfig, r as canMix, s as mixBlocker, t as blockerCode, u as CONFIG_SCHEMA_URL, v as instructionsFromRows, w as formatTemperature, x as durationsOf, y as rowsFromInstructions } from "./mixing-Dt043zmh.mjs";
 import { parse } from "csv-parse/sync";
 //#region src/csv.ts
-/** Parses the instruction CSV. See `instructionsFromRows` for the row rules. */
+/**
+* Parses the instruction CSV. See `instructionsFromRows` for the row rules.
+*
+* @example
+* ```ts
+* const instructions = parseInstructions(csvFileContents, machine);
+* ```
+*/
 function parseInstructions(source, machine) {
 	const records = parse(source, {
 		columns: true,
@@ -13,6 +20,6 @@ function parseInstructions(source, machine) {
 	return instructionsFromRows(records, machine);
 }
 //#endregion
-export { COLUMNS, RowError, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, configFromJson, configToJson, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseConfig, parseInstructions, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
+export { COLUMNS, CONFIG_SCHEMA_URL, RowError, blockerCode, blockerLegend, canMix, cardGroups, chartFromJson, chartToJson, colourGroups, configFromJson, configToJson, durationsOf, formatTemperature, instructionsFromRows, ironGroups, ironSetting, ironSettingKeys, loadGroups, mixBlocker, mixTags, parseConfig, parseInstructions, parseMachine, resolve, rowsFromInstructions, variants, washGroups };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +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"}
+{"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/**\n * Parses the instruction CSV. See `instructionsFromRows` for the row rules.\n *\n * @example\n * ```ts\n * const instructions = parseInstructions(csvFileContents, machine);\n * ```\n */\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":";;;;;;;;;;;AAaA,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-DzbYAriI.mjs → mixing-Dt043zmh.mjs}

@@ -29,6 +29,12 @@ function parseIronSetting(value, index) {
 * 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.
+*
+* @example
+* ```ts
+* const machine = parseMachine(JSON.parse(machineFileContents));
+* machine.washer.programs; // ["Off", "Cottons", "Wool", ...]
+* ```
 */
 function parseMachine(value) {
 	if (typeof value !== "object" || value === null) fail("the file must contain an object");
@@ -56,6 +62,13 @@ function parseMachine(value) {
 		}
 	};
 }
+/**
+* @example
+* ```ts
+* ironSetting(machine, "2")?.label; // "••"
+* ironSetting(machine, "nope"); // undefined
+* ```
+*/
 function ironSetting(machine, key) {
 	return machine.iron.settings.find((setting) => setting.key === key);
 }
@@ -64,6 +77,11 @@ function ironSetting(machine, key) {
 *
 * 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.
+*
+* @example
+* ```ts
+* ironSettingKeys(machine); // ["min", "1", "2", "3"]
+* ```
 */
 function ironSettingKeys(machine) {
 	return machine.iron.settings.map((setting) => setting.key);
@@ -72,6 +90,12 @@ function ironSettingKeys(machine) {
 * `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.
+*
+* @example
+* ```ts
+* formatTemperature("40"); // "40°"
+* formatTemperature("cold"); // "cold"
+* ```
 */
 function formatTemperature(value) {
 	return /^\d+$/.test(value) ? `${value}°` : value;
@@ -102,6 +126,12 @@ const mixTags = [
 * 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.
+*
+* @example
+* ```ts
+* durationsOf([pile, pile]); // "~2:00"
+* durationsOf([pile, { ...pile, duration: "~1:10" }]); // "~2:00 / ~1:10"
+* ```
 */
 function durationsOf(group) {
 	return [...new Set(group.map((item) => item.duration).filter((value) => value !== ""))].join(" / ");
@@ -136,7 +166,9 @@ const COLUMNS = [
 	"drying",
 	"colour_group",
 	"mix_tags",
-	"notes"
+	"notes",
+	"reference_name",
+	"reference_link"
 ];
 var RowError = class extends Error {
 	constructor(row, column, message) {
@@ -175,6 +207,11 @@ function boolean(row, column, value) {
 * 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.
+*
+* @example
+* ```ts
+* const instructions = instructionsFromRows(JSON.parse(jsonFromStorage), machine);
+* ```
 */
 function instructionsFromRows(rows, machine) {
 	const { washer } = machine;
@@ -207,11 +244,20 @@ function instructionsFromRows(rows, machine) {
 			drying: record.drying ?? "",
 			colourGroup: oneOf(row, "colour_group", record.colour_group ?? "", colourGroups),
 			mixTags: tags,
-			notes: record.notes ?? ""
+			notes: record.notes ?? "",
+			referenceName: record.reference_name ?? "",
+			referenceLink: record.reference_link ?? ""
 		};
 	});
 }
-/** The reverse of `instructionsFromRows` — what a JSON export writes out. */
+/**
+* The reverse of `instructionsFromRows` — what a JSON export writes out.
+*
+* @example
+* ```ts
+* const rows = rowsFromInstructions(instructions);
+* ```
+*/
 function rowsFromInstructions(instructions) {
 	return instructions.map((instruction) => ({
 		clothing_type: instruction.clothingType,
@@ -228,18 +274,32 @@ function rowsFromInstructions(instructions) {
 		drying: instruction.drying,
 		colour_group: instruction.colourGroup,
 		mix_tags: instruction.mixTags.join("|"),
-		notes: instruction.notes
+		notes: instruction.notes,
+		reference_name: instruction.referenceName,
+		reference_link: instruction.referenceLink
 	}));
 }
 /**
 * 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.
+*
+* @example
+* ```ts
+* const json = chartToJson(instructions);
+* ```
 */
 function chartToJson(instructions) {
 	return `${JSON.stringify(rowsFromInstructions(instructions), null, 2)}\n`;
 }
-/** The other half of `chartToJson`. Throws the same errors `parseInstructions` does. */
+/**
+* The other half of `chartToJson`. Throws the same errors `parseInstructions` does.
+*
+* @example
+* ```ts
+* const instructions = chartFromJson(jsonFromStorage, machine);
+* ```
+*/
 function chartFromJson(source, machine) {
 	let rows;
 	try {
@@ -253,10 +313,25 @@ function chartFromJson(source, machine) {
 //#endregion
 //#region src/config.ts
 /**
+* Where `configToJson` points editors at the real JSON Schema (generated
+* from the `Config` type — see `schema/config.schema.json` and `bun run
+* schema`). Unpinned to the package's `latest` npm tag rather than the
+* running version, matching how most `$schema` URLs work: close enough,
+* without needing a build-time read of this package's own `package.json`.
+*/
+const CONFIG_SCHEMA_URL = "https://cdn.jsdelivr.net/npm/@washy-washy/core/schema/config.schema.json";
+/**
 * Validates a `{ machine, chart }` object, checking the chart against the
 * machine it's embedded with — never a different one. Every failure names
 * which half is wrong, same as `parseMachine` and `instructionsFromRows` do
 * on their own.
+*
+* @example
+* ```ts
+* const config = parseConfig(JSON.parse(configFileContents));
+* config.machine.washer.name; // "Generic front loader"
+* config.chart[0].clothingType; // "Dark"
+* ```
 */
 function parseConfig(value) {
 	if (typeof value !== "object" || value === null) throw new Error("config: the file must contain an object");
@@ -270,15 +345,34 @@ function parseConfig(value) {
 		chart: instructionsFromRows(raw.chart, machine)
 	};
 }
-/** The reverse of `parseConfig` — what a JSON export writes out. */
+/**
+* The reverse of `parseConfig` — what a JSON export writes out. Leads with a
+* `$schema` key so an editor that reads it (VS Code among them) validates
+* and autocompletes the file without the person editing it doing anything.
+* `parseConfig` ignores the key on the way back in — it never asks for
+* anything beyond `machine` and `chart`.
+*
+* @example
+* ```ts
+* const json = configToJson(config);
+* ```
+*/
 function configToJson(config) {
 	const rows = {
+		$schema: CONFIG_SCHEMA_URL,
 		machine: config.machine,
 		chart: rowsFromInstructions(config.chart)
 	};
 	return `${JSON.stringify(rows, null, 2)}\n`;
 }
-/** The other half of `configToJson`. Throws the same errors `parseConfig` does. */
+/**
+* The other half of `configToJson`. Throws the same errors `parseConfig` does.
+*
+* @example
+* ```ts
+* const config = configFromJson(configFileContents);
+* ```
+*/
 function configFromJson(source) {
 	let value;
 	try {
@@ -316,6 +410,12 @@ function compatibleColours(a, b) {
 * 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.
+*
+* @example
+* ```ts
+* mixBlocker(towels, socks); // "lint" — towels shed onto everything else
+* mixBlocker(socks, socks2); // null — nothing stops them sharing a drum
+* ```
 */
 function mixBlocker(a, b) {
 	if (a.mixTags.includes("solo") || b.mixTags.includes("solo")) return "solo";
@@ -324,10 +424,23 @@ function mixBlocker(a, b) {
 	if (!sameSettings(a, b)) return "settings";
 	return null;
 }
+/**
+* @example
+* ```ts
+* canMix(towels, socks); // false
+* ```
+*/
 function canMix(a, b) {
 	return mixBlocker(a, b) === null;
 }
-/** Annotates each instruction with the other piles it may share a load with. */
+/**
+* Annotates each instruction with the other piles it may share a load with.
+*
+* @example
+* ```ts
+* resolve(instructions)[0].mixesWith; // ["Socks", "Jeans"]
+* ```
+*/
 function resolve(instructions) {
 	return instructions.map((instruction) => ({
 		...instruction,
@@ -337,6 +450,11 @@ function resolve(instructions) {
 /**
 * Groups piles that can all be washed together — every member compatible with
 * every other, not merely with the first one it met.
+*
+* @example
+* ```ts
+* loadGroups(instructions); // [[towels], [socks, jeans], [wool]]
+* ```
 */
 function loadGroups(instructions) {
 	const groups = [];
@@ -377,6 +495,12 @@ function washFingerprint(item) {
 * 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.
+*
+* @example
+* ```ts
+* cardGroups(instructions).map((group) => group.map((item) => item.clothingType));
+* // [["Socks", "Jeans"], ["Towels"]]
+* ```
 */
 function cardGroups(instructions) {
 	return groupBy(instructions, (item) => JSON.stringify([
@@ -389,6 +513,11 @@ function cardGroups(instructions) {
 * 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.
+*
+* @example
+* ```ts
+* washGroups(instructions); // merges piles cardGroups would have split on iron settings alone
+* ```
 */
 function washGroups(instructions) {
 	return groupBy(instructions, washFingerprint);
@@ -402,6 +531,11 @@ function washGroups(instructions) {
 * 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.
+*
+* @example
+* ```ts
+* ironGroups(instructions, ironSettingKeys(machine));
+* ```
 */
 function ironGroups(instructions, order) {
 	const rank = (setting) => {
@@ -411,6 +545,6 @@ function ironGroups(instructions, order) {
 	return groupBy(instructions, (item) => item.ironSetting).sort((a, b) => rank(a[0].ironSetting) - rank(b[0].ironSetting));
 }
 //#endregion
-export { formatTemperature as C, parseMachine as E, variants as S, ironSettingKeys as T, instructionsFromRows as _, ironGroups as a, durationsOf as b, resolve as c, configToJson as d, parseConfig as f, chartToJson as g, chartFromJson as h, cardGroups as i, washGroups as l, RowError as m, blockerLegend as n, loadGroups as o, COLUMNS as p, canMix as r, mixBlocker as s, blockerCode as t, configFromJson as u, rowsFromInstructions as v, ironSetting as w, mixTags as x, colourGroups as y };
+export { variants as C, parseMachine as D, ironSettingKeys as E, mixTags as S, ironSetting as T, chartToJson as _, ironGroups as a, colourGroups as b, resolve as c, configFromJson as d, configToJson as f, chartFromJson as g, RowError as h, cardGroups as i, washGroups as l, COLUMNS as m, blockerLegend as n, loadGroups as o, parseConfig as p, canMix as r, mixBlocker as s, blockerCode as t, CONFIG_SCHEMA_URL as u, instructionsFromRows as v, formatTemperature as w, durationsOf as x, rowsFromInstructions as y };
 
-//# sourceMappingURL=mixing-DzbYAriI.mjs.map
+//# sourceMappingURL=mixing-Dt043zmh.mjs.map

package/dist/mixing-Dt043zmh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixing-Dt043zmh.mjs","names":[],"sources":["../src/machine.ts","../src/types.ts","../src/rows.ts","../src/config.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 *\n * @example\n * ```ts\n * const machine = parseMachine(JSON.parse(machineFileContents));\n * machine.washer.programs; // [\"Off\", \"Cottons\", \"Wool\", ...]\n * ```\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\n/**\n * @example\n * ```ts\n * ironSetting(machine, \"2\")?.label; // \"••\"\n * ironSetting(machine, \"nope\"); // undefined\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 *\n * @example\n * ```ts\n * ironSettingKeys(machine); // [\"min\", \"1\", \"2\", \"3\"]\n * ```\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 *\n * @example\n * ```ts\n * formatTemperature(\"40\"); // \"40°\"\n * formatTemperature(\"cold\"); // \"cold\"\n * ```\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   * Who to credit for a care instruction that isn't obvious from the garment\n   * itself — \"the label says 40°\" doesn't need one, \"the manufacturer says\n   * wash these alone\" might. Empty when there's nothing to cite.\n   */\n  referenceName: string;\n  /** A link backing up `referenceName`. Empty when there's nothing to cite. */\n  referenceLink: 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 *\n * @example\n * ```ts\n * durationsOf([pile, pile]); // \"~2:00\"\n * durationsOf([pile, { ...pile, duration: \"~1:10\" }]); // \"~2:00 / ~1:10\"\n * ```\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  \"reference_name\",\n  \"reference_link\",\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 *\n * @example\n * ```ts\n * const instructions = instructionsFromRows(JSON.parse(jsonFromStorage), machine);\n * ```\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      referenceName: record.reference_name ?? \"\",\n      referenceLink: record.reference_link ?? \"\",\n    };\n  });\n}\n\n/**\n * The reverse of `instructionsFromRows` — what a JSON export writes out.\n *\n * @example\n * ```ts\n * const rows = rowsFromInstructions(instructions);\n * ```\n */\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    reference_name: instruction.referenceName,\n    reference_link: instruction.referenceLink,\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 *\n * @example\n * ```ts\n * const json = chartToJson(instructions);\n * ```\n */\nexport function chartToJson(instructions: Instruction[]): string {\n  return `${JSON.stringify(rowsFromInstructions(instructions), null, 2)}\\n`;\n}\n\n/**\n * The other half of `chartToJson`. Throws the same errors `parseInstructions` does.\n *\n * @example\n * ```ts\n * const instructions = chartFromJson(jsonFromStorage, machine);\n * ```\n */\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 Machine, parseMachine } from \"./machine\";\nimport { instructionsFromRows, rowsFromInstructions } from \"./rows\";\nimport type { Instruction } from \"./types\";\n\n/**\n * Where `configToJson` points editors at the real JSON Schema (generated\n * from the `Config` type — see `schema/config.schema.json` and `bun run\n * schema`). Unpinned to the package's `latest` npm tag rather than the\n * running version, matching how most `$schema` URLs work: close enough,\n * without needing a build-time read of this package's own `package.json`.\n */\nexport const CONFIG_SCHEMA_URL =\n  \"https://cdn.jsdelivr.net/npm/@washy-washy/core/schema/config.schema.json\";\n\n/**\n * The washing machine and the chart that describes it, in one place. Both\n * halves are exactly what `parseMachine`/`instructionsFromRows` already\n * produce — this is a wrapper around the pair, not a third shape.\n */\nexport interface Config {\n  machine: Machine;\n  chart: Instruction[];\n}\n\n/**\n * Validates a `{ machine, chart }` object, checking the chart against the\n * machine it's embedded with — never a different one. Every failure names\n * which half is wrong, same as `parseMachine` and `instructionsFromRows` do\n * on their own.\n *\n * @example\n * ```ts\n * const config = parseConfig(JSON.parse(configFileContents));\n * config.machine.washer.name; // \"Generic front loader\"\n * config.chart[0].clothingType; // \"Dark\"\n * ```\n */\nexport function parseConfig(value: unknown): Config {\n  if (typeof value !== \"object\" || value === null) {\n    throw new Error(\"config: the file must contain an object\");\n  }\n  const raw = value as Record<string, unknown>;\n\n  if (!(\"machine\" in raw)) throw new Error(\"config: machine is missing\");\n  if (!(\"chart\" in raw)) throw new Error(\"config: chart is missing\");\n\n  const machine = parseMachine(raw.machine);\n\n  if (!Array.isArray(raw.chart)) throw new Error(\"config: chart must be an array of rows\");\n  const chart = instructionsFromRows(raw.chart as Record<string, string>[], machine);\n\n  return { machine, chart };\n}\n\n/**\n * The reverse of `parseConfig` — what a JSON export writes out. Leads with a\n * `$schema` key so an editor that reads it (VS Code among them) validates\n * and autocompletes the file without the person editing it doing anything.\n * `parseConfig` ignores the key on the way back in — it never asks for\n * anything beyond `machine` and `chart`.\n *\n * @example\n * ```ts\n * const json = configToJson(config);\n * ```\n */\nexport function configToJson(config: Config): string {\n  const rows = {\n    $schema: CONFIG_SCHEMA_URL,\n    machine: config.machine,\n    chart: rowsFromInstructions(config.chart),\n  };\n  return `${JSON.stringify(rows, null, 2)}\\n`;\n}\n\n/**\n * The other half of `configToJson`. Throws the same errors `parseConfig` does.\n *\n * @example\n * ```ts\n * const config = configFromJson(configFileContents);\n * ```\n */\nexport function configFromJson(source: string): Config {\n  let value: unknown;\n  try {\n    value = JSON.parse(source);\n  } catch (error) {\n    throw new Error(`config: not valid JSON: ${error instanceof Error ? error.message : error}`);\n  }\n  return parseConfig(value);\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 *\n * @example\n * ```ts\n * mixBlocker(towels, socks); // \"lint\" — towels shed onto everything else\n * mixBlocker(socks, socks2); // null — nothing stops them sharing a drum\n * ```\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\n/**\n * @example\n * ```ts\n * canMix(towels, socks); // false\n * ```\n */\nexport function canMix(a: Instruction, b: Instruction): boolean {\n  return mixBlocker(a, b) === null;\n}\n\n/**\n * Annotates each instruction with the other piles it may share a load with.\n *\n * @example\n * ```ts\n * resolve(instructions)[0].mixesWith; // [\"Socks\", \"Jeans\"]\n * ```\n */\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 *\n * @example\n * ```ts\n * loadGroups(instructions); // [[towels], [socks, jeans], [wool]]\n * ```\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 *\n * @example\n * ```ts\n * cardGroups(instructions).map((group) => group.map((item) => item.clothingType));\n * // [[\"Socks\", \"Jeans\"], [\"Towels\"]]\n * ```\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 *\n * @example\n * ```ts\n * washGroups(instructions); // merges piles cardGroups would have split on iron settings alone\n * ```\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 *\n * @example\n * ```ts\n * ironGroups(instructions, ironSettingKeys(machine));\n * ```\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-C-0YQE-w.d.mts → rows-Bn1LlIaD.d.mts}

@@ -39,20 +39,44 @@ interface Machine {
  * 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.
+ *
+ * @example
+ * ```ts
+ * const machine = parseMachine(JSON.parse(machineFileContents));
+ * machine.washer.programs; // ["Off", "Cottons", "Wool", ...]
+ * ```
  */
 declare function parseMachine(value: unknown): Machine;
+/**
+ * @example
+ * ```ts
+ * ironSetting(machine, "2")?.label; // "••"
+ * ironSetting(machine, "nope"); // undefined
+ * ```
+ */
 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.
+ *
+ * @example
+ * ```ts
+ * ironSettingKeys(machine); // ["min", "1", "2", "3"]
+ * ```
  */
 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.
+ *
+ * @example
+ * ```ts
+ * formatTemperature("40"); // "40°"
+ * formatTemperature("cold"); // "cold"
+ * ```
  */
 declare function formatTemperature(value: string): string;
 //#endregion
@@ -97,6 +121,14 @@ interface Instruction {
   colourGroup: ColourGroup;
   mixTags: MixTag[];
   notes: string;
+  /**
+   * Who to credit for a care instruction that isn't obvious from the garment
+   * itself — "the label says 40°" doesn't need one, "the manufacturer says
+   * wash these alone" might. Empty when there's nothing to cite.
+   */
+  referenceName: string;
+  /** A link backing up `referenceName`. Empty when there's nothing to cite. */
+  referenceLink: string;
 }
 /** An instruction plus the other piles it may share a drum with. */
 interface ResolvedInstruction extends Instruction {
@@ -108,6 +140,12 @@ interface ResolvedInstruction extends Instruction {
  * 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.
+ *
+ * @example
+ * ```ts
+ * durationsOf([pile, pile]); // "~2:00"
+ * durationsOf([pile, { ...pile, duration: "~1:10" }]); // "~2:00 / ~1:10"
+ * ```
  */
 declare function durationsOf(group: Instruction[]): string;
 /**
@@ -122,6 +160,14 @@ declare const variants: readonly ["full", "wash", "iron"];
 type Variant = (typeof variants)[number];
 //#endregion
 //#region src/config.d.ts
+/**
+ * Where `configToJson` points editors at the real JSON Schema (generated
+ * from the `Config` type — see `schema/config.schema.json` and `bun run
+ * schema`). Unpinned to the package's `latest` npm tag rather than the
+ * running version, matching how most `$schema` URLs work: close enough,
+ * without needing a build-time read of this package's own `package.json`.
+ */
+declare const CONFIG_SCHEMA_URL = "https://cdn.jsdelivr.net/npm/@washy-washy/core/schema/config.schema.json";
 /**
  * The washing machine and the chart that describes it, in one place. Both
  * halves are exactly what `parseMachine`/`instructionsFromRows` already
@@ -136,11 +182,36 @@ interface Config {
  * machine it's embedded with — never a different one. Every failure names
  * which half is wrong, same as `parseMachine` and `instructionsFromRows` do
  * on their own.
+ *
+ * @example
+ * ```ts
+ * const config = parseConfig(JSON.parse(configFileContents));
+ * config.machine.washer.name; // "Generic front loader"
+ * config.chart[0].clothingType; // "Dark"
+ * ```
  */
 declare function parseConfig(value: unknown): Config;
-/** The reverse of `parseConfig` — what a JSON export writes out. */
+/**
+ * The reverse of `parseConfig` — what a JSON export writes out. Leads with a
+ * `$schema` key so an editor that reads it (VS Code among them) validates
+ * and autocompletes the file without the person editing it doing anything.
+ * `parseConfig` ignores the key on the way back in — it never asks for
+ * anything beyond `machine` and `chart`.
+ *
+ * @example
+ * ```ts
+ * const json = configToJson(config);
+ * ```
+ */
 declare function configToJson(config: Config): string;
-/** The other half of `configToJson`. Throws the same errors `parseConfig` does. */
+/**
+ * The other half of `configToJson`. Throws the same errors `parseConfig` does.
+ *
+ * @example
+ * ```ts
+ * const config = configFromJson(configFileContents);
+ * ```
+ */
 declare function configFromJson(source: string): Config;
 //#endregion
 //#region src/mixing.d.ts
@@ -155,26 +226,61 @@ declare const blockerCode: Record<Blocker, string>;
  * 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.
+ *
+ * @example
+ * ```ts
+ * mixBlocker(towels, socks); // "lint" — towels shed onto everything else
+ * mixBlocker(socks, socks2); // null — nothing stops them sharing a drum
+ * ```
  */
 declare function mixBlocker(a: Instruction, b: Instruction): Blocker | null;
+/**
+ * @example
+ * ```ts
+ * canMix(towels, socks); // false
+ * ```
+ */
 declare function canMix(a: Instruction, b: Instruction): boolean;
-/** Annotates each instruction with the other piles it may share a load with. */
+/**
+ * Annotates each instruction with the other piles it may share a load with.
+ *
+ * @example
+ * ```ts
+ * resolve(instructions)[0].mixesWith; // ["Socks", "Jeans"]
+ * ```
+ */
 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.
+ *
+ * @example
+ * ```ts
+ * loadGroups(instructions); // [[towels], [socks, jeans], [wool]]
+ * ```
  */
 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.
+ *
+ * @example
+ * ```ts
+ * cardGroups(instructions).map((group) => group.map((item) => item.clothingType));
+ * // [["Socks", "Jeans"], ["Towels"]]
+ * ```
  */
 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.
+ *
+ * @example
+ * ```ts
+ * washGroups(instructions); // merges piles cardGroups would have split on iron settings alone
+ * ```
  */
 declare function washGroups<T extends Instruction>(instructions: T[]): T[][];
 /**
@@ -186,11 +292,16 @@ declare function washGroups<T extends Instruction>(instructions: T[]): T[][];
  * 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.
+ *
+ * @example
+ * ```ts
+ * ironGroups(instructions, ironSettingKeys(machine));
+ * ```
  */
 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"];
+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", "reference_name", "reference_link"];
 /** 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 {
@@ -203,18 +314,42 @@ declare class RowError extends Error {
  * 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.
+ *
+ * @example
+ * ```ts
+ * const instructions = instructionsFromRows(JSON.parse(jsonFromStorage), machine);
+ * ```
  */
 declare function instructionsFromRows(rows: Record<string, string>[], machine: Machine): Instruction[];
-/** The reverse of `instructionsFromRows` — what a JSON export writes out. */
+/**
+ * The reverse of `instructionsFromRows` — what a JSON export writes out.
+ *
+ * @example
+ * ```ts
+ * const rows = rowsFromInstructions(instructions);
+ * ```
+ */
 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.
+ *
+ * @example
+ * ```ts
+ * const json = chartToJson(instructions);
+ * ```
  */
 declare function chartToJson(instructions: Instruction[]): string;
-/** The other half of `chartToJson`. Throws the same errors `parseInstructions` does. */
+/**
+ * The other half of `chartToJson`. Throws the same errors `parseInstructions` does.
+ *
+ * @example
+ * ```ts
+ * const instructions = chartFromJson(jsonFromStorage, machine);
+ * ```
+ */
 declare function chartFromJson(source: string, machine: Machine): Instruction[];
 //#endregion
-export { variants as A, Instruction as C, colourGroups as D, Variant as E, formatTemperature as F, ironSetting as I, ironSettingKeys as L, IronSetting as M, Machine as N, durationsOf as O, Washer as P, parseMachine as R, ColourGroup as S, ResolvedInstruction as T, washGroups as _, chartToJson as a, configToJson as b, Blocker as c, canMix as d, cardGroups as f, resolve as g, mixBlocker as h, chartFromJson as i, Iron as j, mixTags 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, Config as v, MixTag as w, parseConfig as x, configFromJson as y };
-//# sourceMappingURL=rows-C-0YQE-w.d.mts.map
+export { mixTags as A, ColourGroup as C, Variant as D, ResolvedInstruction as E, Washer as F, formatTemperature as I, ironSetting as L, Iron as M, IronSetting as N, colourGroups as O, Machine as P, ironSettingKeys as R, parseConfig as S, MixTag as T, washGroups as _, chartToJson as a, configFromJson as b, Blocker as c, canMix as d, cardGroups as f, resolve as g, mixBlocker as h, chartFromJson as i, variants as j, durationsOf 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, CONFIG_SCHEMA_URL as v, Instruction as w, configToJson as x, Config as y, parseMachine as z };
+//# sourceMappingURL=rows-Bn1LlIaD.d.mts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@washy-washy/core",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Chart parsing, mixing rules and machine validation for washy-washy — a laundry chart generator.",
   "keywords": [
     "laundry",
@@ -27,12 +27,14 @@
   },
   "files": [
     "dist",
+    "schema",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "build": "tsdown",
-    "check": "bun run lint && bun run lint:md && bun run lint:yaml && bun run lint:package-json && bun run lint:prose && bun run typecheck && bun test",
+    "check": "bun run lint && bun run lint:md && bun run lint:yaml && bun run lint:package-json && bun run lint:prose && bun run lint:schema && bun run typecheck && bun test",
+    "docs": "typedoc",
     "format": "prettier --write .",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
@@ -40,9 +42,11 @@
     "lint:package-json": "sort-package-json --check",
     "lint:prose": ".tools/vale --glob='!{styles/**,CHANGELOG.md}' --minAlertLevel=error .",
     "lint:prose:advice": ".tools/vale --glob='!{styles/**,CHANGELOG.md}' .",
+    "lint:schema": "bun run schema && git diff --exit-code schema/",
     "lint:yaml": "prettier --check \"**/*.{yml,yaml}\"",
     "prepare": "lefthook install",
     "prose:sync": "bun run scripts/install-vale.ts && .tools/vale sync",
+    "schema": "ts-json-schema-generator --path src/config.ts --type Config --tsconfig tsconfig.json -o schema/config.schema.json && biome format --write schema/config.schema.json",
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   },
@@ -65,7 +69,9 @@
     "prettier": "3.9.6",
     "semantic-release": "25.0.9",
     "sort-package-json": "4.0.0",
+    "ts-json-schema-generator": "2.9.0",
     "tsdown": "0.22.14",
+    "typedoc": "0.28.20",
     "typescript": "5.9.3"
   },
   "engines": {

package/schema/config.schema.json

@@ -0,0 +1,210 @@
+{
+  "$ref": "#/definitions/Config",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "ColourGroup": {
+      "enum": ["white", "colour", "dark", "sport", "any"],
+      "type": "string"
+    },
+    "Config": {
+      "additionalProperties": false,
+      "description": "The washing machine and the chart that describes it, in one place. Both halves are exactly what `parseMachine`/`instructionsFromRows` already produce — this is a wrapper around the pair, not a third shape.",
+      "properties": {
+        "chart": {
+          "items": {
+            "$ref": "#/definitions/Instruction"
+          },
+          "type": "array"
+        },
+        "machine": {
+          "$ref": "#/definitions/Machine"
+        }
+      },
+      "required": ["machine", "chart"],
+      "type": "object"
+    },
+    "Instruction": {
+      "additionalProperties": false,
+      "description": "One CSV row: everything needed to wash, iron and dry one pile of laundry.\n\nThe 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.",
+      "properties": {
+        "clothingType": {
+          "type": "string"
+        },
+        "colourGroup": {
+          "$ref": "#/definitions/ColourGroup"
+        },
+        "detergent": {
+          "type": "string"
+        },
+        "drying": {
+          "type": "string"
+        },
+        "duration": {
+          "type": "string"
+        },
+        "fabricSoftener": {
+          "type": "boolean"
+        },
+        "ironSetting": {
+          "description": "Thermostat position. Empty when `ironing` is false.",
+          "type": "string"
+        },
+        "ironing": {
+          "description": "Whether this pile gets ironed at all.",
+          "type": "boolean"
+        },
+        "ironingNotes": {
+          "description": "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.",
+          "type": "string"
+        },
+        "mixTags": {
+          "items": {
+            "$ref": "#/definitions/MixTag"
+          },
+          "type": "array"
+        },
+        "notes": {
+          "type": "string"
+        },
+        "options": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "program": {
+          "type": "string"
+        },
+        "referenceLink": {
+          "description": "A link backing up `referenceName`. Empty when there's nothing to cite.",
+          "type": "string"
+        },
+        "referenceName": {
+          "description": "Who to credit for a care instruction that isn't obvious from the garment itself — \"the label says 40°\" doesn't need one, \"the manufacturer says wash these alone\" might. Empty when there's nothing to cite.",
+          "type": "string"
+        },
+        "spin": {
+          "type": "string"
+        },
+        "temperature": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "clothingType",
+        "detergent",
+        "fabricSoftener",
+        "temperature",
+        "spin",
+        "duration",
+        "program",
+        "options",
+        "ironing",
+        "ironingNotes",
+        "ironSetting",
+        "drying",
+        "colourGroup",
+        "mixTags",
+        "notes",
+        "referenceName",
+        "referenceLink"
+      ],
+      "type": "object"
+    },
+    "Iron": {
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "settings": {
+          "description": "Thermostat positions in order, coolest first.",
+          "items": {
+            "$ref": "#/definitions/IronSetting"
+          },
+          "type": "array"
+        }
+      },
+      "required": ["name", "settings"],
+      "type": "object"
+    },
+    "IronSetting": {
+      "additionalProperties": false,
+      "properties": {
+        "detail": {
+          "type": "string"
+        },
+        "dots": {
+          "type": "string"
+        },
+        "key": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "steam": {
+          "type": "boolean"
+        }
+      },
+      "required": ["key", "dots", "label", "detail", "steam"],
+      "type": "object"
+    },
+    "Machine": {
+      "additionalProperties": false,
+      "properties": {
+        "iron": {
+          "$ref": "#/definitions/Iron"
+        },
+        "washer": {
+          "$ref": "#/definitions/Washer"
+        }
+      },
+      "required": ["washer", "iron"],
+      "type": "object"
+    },
+    "MixTag": {
+      "enum": ["lint-shedder", "lint-magnet", "dye-bleeder", "solo"],
+      "type": "string"
+    },
+    "Washer": {
+      "additionalProperties": false,
+      "description": "The appliances a chart is drawn for, as data rather than code.\n\nEverything 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.",
+      "properties": {
+        "capacity": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "options": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "programs": {
+          "description": "Dial labels in physical order from twelve o'clock, clockwise. Index is the angle.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "spins": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "temperatures": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": ["name", "capacity", "programs", "temperatures", "spins", "options"],
+      "type": "object"
+    }
+  }
+}

package/dist/mixing-DzbYAriI.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mixing-DzbYAriI.mjs","names":[],"sources":["../src/machine.ts","../src/types.ts","../src/rows.ts","../src/config.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 Machine, parseMachine } from \"./machine\";\nimport { instructionsFromRows, rowsFromInstructions } from \"./rows\";\nimport type { Instruction } from \"./types\";\n\n/**\n * The washing machine and the chart that describes it, in one place. Both\n * halves are exactly what `parseMachine`/`instructionsFromRows` already\n * produce — this is a wrapper around the pair, not a third shape.\n */\nexport interface Config {\n  machine: Machine;\n  chart: Instruction[];\n}\n\n/**\n * Validates a `{ machine, chart }` object, checking the chart against the\n * machine it's embedded with — never a different one. Every failure names\n * which half is wrong, same as `parseMachine` and `instructionsFromRows` do\n * on their own.\n */\nexport function parseConfig(value: unknown): Config {\n  if (typeof value !== \"object\" || value === null) {\n    throw new Error(\"config: the file must contain an object\");\n  }\n  const raw = value as Record<string, unknown>;\n\n  if (!(\"machine\" in raw)) throw new Error(\"config: machine is missing\");\n  if (!(\"chart\" in raw)) throw new Error(\"config: chart is missing\");\n\n  const machine = parseMachine(raw.machine);\n\n  if (!Array.isArray(raw.chart)) throw new Error(\"config: chart must be an array of rows\");\n  const chart = instructionsFromRows(raw.chart as Record<string, string>[], machine);\n\n  return { machine, chart };\n}\n\n/** The reverse of `parseConfig` — what a JSON export writes out. */\nexport function configToJson(config: Config): string {\n  const rows = { machine: config.machine, chart: rowsFromInstructions(config.chart) };\n  return `${JSON.stringify(rows, null, 2)}\\n`;\n}\n\n/** The other half of `configToJson`. Throws the same errors `parseConfig` does. */\nexport function configFromJson(source: string): Config {\n  let value: unknown;\n  try {\n    value = JSON.parse(source);\n  } catch (error) {\n    throw new Error(`config: not valid JSON: ${error instanceof Error ? error.message : error}`);\n  }\n  return parseConfig(value);\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":";AAyCA,SAAS,KAAK,MAAqB;CACjC,MAAM,IAAI,MAAM,YAAY,MAAM;AACpC;AAEA,SAAS,WAAW,OAAgB,OAAe,SAA2B;CAC5E,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,UAAU,OAAO,UAAU,YAAY,UAAU,EAAE,GAC1F,KAAK,GAAG,MAAM,qCAAqC;CAErD,MAAM,OAAO;CACb,IAAI,KAAK,SAAS,SAChB,KAAK,GAAG,MAAM,kBAAkB,QAAQ,kBAAkB,KAAK,QAAQ;CACzE,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ,KAAK,GAAG,MAAM,iBAAiB;CACvE,OAAO;AACT;AAEA,SAAS,KAAK,OAAgB,OAAe,UAA2B;CACtE,IAAI,OAAO,UAAU,YAAY,UAAU,IAAI,OAAO;CACtD,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO,KAAK,GAAG,MAAM,4BAA4B;AACnD;AAEA,SAAS,iBAAiB,OAAgB,OAA4B;CACpE,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,KAAK,iBAAiB,MAAM,oBAAoB;CAClD,MAAM,MAAM;CAEZ,OAAO;EACL,KAFU,KAAK,IAAI,KAAK,iBAAiB,MAAM,MAE7C;EACF,MAAM,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO;EAChD,OAAO,KAAK,IAAI,OAAO,iBAAiB,MAAM,QAAQ;EACtD,QAAQ,KAAK,IAAI,QAAQ,iBAAiB,MAAM,WAAW,EAAE;EAC7D,OAAO,IAAI,UAAU;CACvB;AACF;;;;;;AAOA,SAAgB,aAAa,OAAyB;CACpD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,KAAK,iCAAiC;CACvF,MAAM,MAAM;CAEZ,IAAI,OAAO,IAAI,WAAW,YAAY,IAAI,WAAW,MAAM,KAAK,mBAAmB;CACnF,IAAI,OAAO,IAAI,SAAS,YAAY,IAAI,SAAS,MAAM,KAAK,iBAAiB;CAE7E,MAAM,YAAY,IAAI;CACtB,MAAM,UAAU,IAAI;CAEpB,MAAM,WAAW,MAAM,QAAQ,QAAQ,QAAQ,IAC3C,QAAQ,WACR,KAAK,0BAA0B;CACnC,IAAI,SAAS,SAAS,GAAG,KAAK,yDAAyD;CAEvF,MAAM,OAAO,SAAS,KAAK,SAAS,UAAU,iBAAiB,SAAS,KAAK,CAAC;CAC9E,IAAI,IAAI,IAAI,KAAK,KAAK,YAAY,QAAQ,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,QAC5D,KAAK,6BAA6B;CAGpC,OAAO;EACL,QAAQ;GACN,MAAM,KAAK,UAAU,MAAM,aAAa;GACxC,UAAU,KAAK,UAAU,UAAU,mBAAmB,EAAE;GACxD,UAAU,WAAW,UAAU,UAAU,mBAAmB,CAAC;GAC7D,cAAc,WAAW,UAAU,cAAc,uBAAuB,CAAC;GACzE,OAAO,WAAW,UAAU,OAAO,gBAAgB,CAAC;GACpD,SAAS,WAAW,UAAU,WAAW,CAAC,GAAG,kBAAkB,CAAC;EAClE;EACA,MAAM;GACJ,MAAM,KAAK,QAAQ,MAAM,WAAW;GACpC,UAAU;EACZ;CACF;AACF;AAEA,SAAgB,YAAY,SAAkB,KAAsC;CAClF,OAAO,QAAQ,KAAK,SAAS,MAAM,YAAY,QAAQ,QAAQ,GAAG;AACpE;;;;;;;AAQA,SAAgB,gBAAgB,SAA4B;CAC1D,OAAO,QAAQ,KAAK,SAAS,KAAK,YAAY,QAAQ,GAAG;AAC3D;;;;;;AAOA,SAAgB,kBAAkB,OAAuB;CACvD,OAAO,QAAQ,KAAK,KAAK,IAAI,GAAG,MAAM,KAAK;AAC7C;;;;ACzIA,MAAa,eAAe;CAAC;CAAS;CAAU;CAAQ;CAAS;AAAK;;;;;AAOtE,MAAa,UAAU;CAAC;CAAgB;CAAe;CAAe;AAAM;;;;;;;;AAgD5E,SAAgB,YAAY,OAA8B;CACxD,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,SAAS,KAAK,QAAQ,CAAC,CAAC,QAAQ,UAAU,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,KACtF,KACF;AACF;;;;;;;;;AAUA,MAAa,WAAW;CAAC;CAAQ;CAAQ;AAAM;;;AClE/C,MAAa,UAAU;CACrB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAKA,IAAa,WAAb,cAA8B,MAAM;CAClC,YAAY,KAAa,QAAgB,SAAiB;EACxD,MAAM,OAAO,IAAI,YAAY,OAAO,KAAK,SAAS;EAClD,KAAK,OAAO;CACd;AACF;;AAGA,SAAS,UAAU,OAAyB;CAC1C,OAAO,MACJ,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,QAAQ,SAAS,KAAK,SAAS,CAAC;AACrC;AAEA,SAAS,MACP,KACA,QACA,OACA,SACG;CACH,IAAI,CAAE,QAA8B,SAAS,KAAK,GAChD,MAAM,IAAI,SAAS,KAAK,QAAQ,IAAI,MAAM,kBAAkB,QAAQ,KAAK,IAAI,GAAG;CAElF,OAAO;AACT;AAEA,SAAS,QAAQ,KAAa,QAAgB,OAAwB;CACpE,MAAM,aAAa,MAAM,KAAK,CAAC,CAAC,YAAY;CAC5C,IAAI;EAAC;EAAO;EAAK;EAAQ;CAAG,CAAC,CAAC,SAAS,UAAU,GAAG,OAAO;CAC3D,IAAI;EAAC;EAAM;EAAK;EAAS;CAAG,CAAC,CAAC,SAAS,UAAU,GAAG,OAAO;CAC3D,MAAM,IAAI,SAAS,KAAK,QAAQ,IAAI,MAAM,wBAAwB;AACpE;;;;;;;;;AAUA,SAAgB,qBACd,MACA,SACe;CACf,MAAM,EAAE,WAAW;CAEnB,IAAI,KAAK,WAAW,GAAG,MAAM,IAAI,MAAM,uBAAuB;CAE9D,MAAM,SAAS,OAAO,KAAK,KAAK,EAA4B;CAC5D,MAAM,UAAU,QAAQ,QAAQ,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC;CACnE,IAAI,QAAQ,SAAS,GACnB,MAAM,IAAI,MAAM,mCAAmC,QAAQ,KAAK,IAAI,GAAG;CAGzE,OAAO,KAAK,KAAK,QAAQ,UAAU;EAIjC,MAAM,MAAM,QAAQ;EAEpB,MAAM,gBAAgB,OAAO,iBAAiB,GAAA,CAAI,KAAK;EACvD,IAAI,iBAAiB,IAAI,MAAM,IAAI,SAAS,KAAK,iBAAiB,mBAAmB;EAErF,MAAM,UAAU,UAAU,OAAO,WAAW,EAAE,CAAC,CAAC,KAAK,WACnD,MAAM,KAAK,WAAW,QAAQ,OAAO,OAAO,CAC9C;EAEA,MAAM,OAAO,UAAU,OAAO,YAAY,EAAE,CAAC,CAAC,KAAK,QACjD,MAAc,KAAK,YAAY,KAAK,OAAO,CAC7C;EAKA,MAAM,UAAU,QAAQ,KAAK,WAAW,OAAO,WAAW,EAAE;EAC5D,MAAM,cAAc,OAAO,gBAAgB,GAAA,CAAI,KAAK;EACpD,IAAI,CAAC,WAAW,eAAe,IAC7B,MAAM,IAAI,SACR,KACA,gBACA,4CAA4C,WAAW,EACzD;EAEF,MAAM,cAAc,UAChB,MAAM,KAAK,gBAAgB,YAAY,gBAAgB,OAAO,CAAC,IAC/D;EAEJ,OAAO;GACL;GACA,WAAW,OAAO,aAAa;GAC/B,gBAAgB,QAAQ,KAAK,mBAAmB,OAAO,mBAAmB,EAAE;GAC5E,aAAa,MAAM,KAAK,eAAe,OAAO,eAAe,IAAI,OAAO,YAAY;GACpF,MAAM,MAAM,KAAK,QAAQ,OAAO,QAAQ,IAAI,OAAO,KAAK;GACxD,UAAU,OAAO,YAAY;GAC7B,SAAS,MAAM,KAAK,WAAW,OAAO,WAAW,IAAI,OAAO,QAAQ;GACpE;GACA;GACA,cAAc,OAAO,iBAAiB;GACtC;GACA,QAAQ,OAAO,UAAU;GACzB,aAAa,MAAmB,KAAK,gBAAgB,OAAO,gBAAgB,IAAI,YAAY;GAC5F,SAAS;GACT,OAAO,OAAO,SAAS;EACzB;CACF,CAAC;AACH;;AAGA,SAAgB,qBAAqB,cAAoC;CACvE,OAAO,aAAa,KAAK,iBAAiB;EACxC,eAAe,YAAY;EAC3B,WAAW,YAAY;EACvB,iBAAiB,YAAY,iBAAiB,QAAQ;EACtD,aAAa,YAAY;EACzB,MAAM,YAAY;EAClB,UAAU,YAAY;EACtB,SAAS,YAAY;EACrB,SAAS,YAAY,QAAQ,KAAK,GAAG;EACrC,SAAS,YAAY,UAAU,QAAQ;EACvC,eAAe,YAAY;EAC3B,cAAc,YAAY;EAC1B,QAAQ,YAAY;EACpB,cAAc,YAAY;EAC1B,UAAU,YAAY,QAAQ,KAAK,GAAG;EACtC,OAAO,YAAY;CACrB,EAAE;AACJ;;;;;;AAOA,SAAgB,YAAY,cAAqC;CAC/D,OAAO,GAAG,KAAK,UAAU,qBAAqB,YAAY,GAAG,MAAM,CAAC,EAAE;AACxE;;AAGA,SAAgB,cAAc,QAAgB,SAAiC;CAC7E,IAAI;CACJ,IAAI;EACF,OAAO,KAAK,MAAM,MAAM;CAC1B,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,mBAAmB,iBAAiB,QAAQ,MAAM,UAAU,OAAO;CACrF;CACA,IAAI,CAAC,MAAM,QAAQ,IAAI,GAAG,MAAM,IAAI,MAAM,wCAAwC;CAClF,OAAO,qBAAqB,MAAkC,OAAO;AACvE;;;;;;;;;AC1JA,SAAgB,YAAY,OAAwB;CAClD,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,MAAM,IAAI,MAAM,yCAAyC;CAE3D,MAAM,MAAM;CAEZ,IAAI,EAAE,aAAa,MAAM,MAAM,IAAI,MAAM,4BAA4B;CACrE,IAAI,EAAE,WAAW,MAAM,MAAM,IAAI,MAAM,0BAA0B;CAEjE,MAAM,UAAU,aAAa,IAAI,OAAO;CAExC,IAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,GAAG,MAAM,IAAI,MAAM,wCAAwC;CAGvF,OAAO;EAAE;EAAS,OAFJ,qBAAqB,IAAI,OAAmC,OAEpD;CAAE;AAC1B;;AAGA,SAAgB,aAAa,QAAwB;CACnD,MAAM,OAAO;EAAE,SAAS,OAAO;EAAS,OAAO,qBAAqB,OAAO,KAAK;CAAE;CAClF,OAAO,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,EAAE;AAC1C;;AAGA,SAAgB,eAAe,QAAwB;CACrD,IAAI;CACJ,IAAI;EACF,QAAQ,KAAK,MAAM,MAAM;CAC3B,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,2BAA2B,iBAAiB,QAAQ,MAAM,UAAU,OAAO;CAC7F;CACA,OAAO,YAAY,KAAK;AAC1B;;;AC/CA,MAAa,gBAAyC;CACpD,MAAM;CACN,UAAU;CACV,QAAQ;CACR,MAAM;AACR;;AAGA,MAAa,cAAuC;CAClD,MAAM;CACN,UAAU;CACV,QAAQ;CACR,MAAM;AACR;AAEA,SAAS,aAAa,GAAgB,GAAyB;CAC7D,OACE,EAAE,YAAY,EAAE,WAChB,EAAE,gBAAgB,EAAE,eACpB,EAAE,SAAS,EAAE,QACb,EAAE,QAAQ,WAAW,EAAE,QAAQ,UAC/B,EAAE,QAAQ,OAAO,WAAW,EAAE,QAAQ,SAAS,MAAM,CAAC;AAE1D;AAEA,SAAS,kBAAkB,GAAgB,GAAyB;CAClE,IAAI,EAAE,gBAAgB,SAAS,EAAE,gBAAgB,OAAO,OAAO;CAC/D,OAAO,EAAE,gBAAgB,EAAE;AAC7B;;;;;;;;AASA,SAAgB,WAAW,GAAgB,GAAgC;CACzE,IAAI,EAAE,QAAQ,SAAS,MAAM,KAAK,EAAE,QAAQ,SAAS,MAAM,GAAG,OAAO;CAIrE,IADiB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,SAAS,KAAK,QAAQ,SAAS,cAAc,CAClE,CAAC,CAAC,WAAW,GAAG,OAAO;CAElC,IAAI,CAAC,kBAAkB,GAAG,CAAC,GAAG,OAAO;CACrC,IAAI,CAAC,aAAa,GAAG,CAAC,GAAG,OAAO;CAChC,OAAO;AACT;AAEA,SAAgB,OAAO,GAAgB,GAAyB;CAC9D,OAAO,WAAW,GAAG,CAAC,MAAM;AAC9B;;AAGA,SAAgB,QAAQ,cAAoD;CAC1E,OAAO,aAAa,KAAK,iBAAiB;EACxC,GAAG;EACH,WAAW,aACR,QAAQ,UAAU,UAAU,eAAe,OAAO,aAAa,KAAK,CAAC,CAAC,CACtE,KAAK,UAAU,MAAM,YAAY;CACtC,EAAE;AACJ;;;;;AAMA,SAAgB,WAAkC,cAA0B;CAC1E,MAAM,SAAgB,CAAC;CACvB,KAAK,MAAM,eAAe,cAAc;EACtC,MAAM,OAAO,OAAO,MAAM,UAAU,MAAM,OAAO,WAAW,OAAO,QAAQ,WAAW,CAAC,CAAC;EACxF,IAAI,MAAM,KAAK,KAAK,WAAW;OAC1B,OAAO,KAAK,CAAC,WAAW,CAAC;CAChC;CACA,OAAO;AACT;AAEA,SAAS,QAAW,OAAY,KAAiC;CAC/D,MAAM,yBAAS,IAAI,IAAiB;CACpC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,WAAW,OAAO,IAAI,IAAI,IAAI,CAAC;EACrC,IAAI,UAAU,SAAS,KAAK,IAAI;OAC3B,OAAO,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;CACnC;CACA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC;AAC5B;;;;;;;;;AAUA,SAAS,gBAAgB,MAA2B;CAClD,OAAO,KAAK,UAAU;EACpB,KAAK;EACL,KAAK;EACL,KAAK;EACL,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,KAAK;EACvB,KAAK;CACP,CAAC;AACH;;;;;;AAOA,SAAgB,WAAkC,cAA0B;CAC1E,OAAO,QAAQ,eAAe,SAC5B,KAAK,UAAU;EAAC,gBAAgB,IAAI;EAAG,KAAK;EAAS,KAAK;CAAW,CAAC,CACxE;AACF;;;;;;AAOA,SAAgB,WAAkC,cAA0B;CAC1E,OAAO,QAAQ,cAAc,eAAe;AAC9C;;;;;;;;;;;AAYA,SAAgB,WACd,cACA,OACO;CACP,MAAM,QAAQ,YAAoB;EAChC,MAAM,KAAK,MAAM,QAAQ,OAAO;EAChC,OAAO,KAAK,IAAI,MAAM,SAAS;CACjC;CACA,OAAO,QAAQ,eAAe,SAAS,KAAK,WAAW,CAAC,CAAC,MACtD,GAAG,MAAM,KAAM,EAAE,EAAE,CAAO,WAAW,IAAI,KAAM,EAAE,EAAE,CAAO,WAAW,CACxE;AACF"}